@farthershore/farthershore-js 0.1.1 → 0.1.2

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,6 +17,14 @@ 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. */
@@ -28,6 +37,18 @@ export interface FartherShoreClient {
     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`). */

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,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,kFAAkF;IAClF,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAEpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,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,11 +6,12 @@ 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
@@ -62,6 +63,9 @@ export function createServerClient(config) {
  */
 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() {
@@ -81,6 +85,7 @@ export function createFartherShoreClient(config) {
         }
         return inflight;
     }
+    const account = createAccountSurface(ctx);
     return {
         bootstrap: ensureBootstrap,
         setApiKey(key) {
@@ -89,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;AAyChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA0B;IAE1B,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,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"}

package/dist/components/auth.js

@@ -0,0 +1,260 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Managed auth — the SDK owns the whole sign-in story so a host app never
+// writes auth glue. `<FartherShoreRoot>` mounts <FsAuth> with the environment's
+// strategy (from bootstrap):
+//
+//  - "clerk": dynamically loads `@clerk/clerk-react` (an OPTIONAL peer — only
+//    Clerk-strategy portals pay for it), mounts ClerkProvider in satellite mode
+//    (one shared Clerk instance serves every product host; sign-in happens on
+//    the primary domain and the session propagates back via the
+//    `__clerk_synced` handshake), and installs Clerk's `getToken` as the
+//    client's per-request token source. Nothing else to wire.
+//  - "test-personas": the SDK's own persona session (`fs.auth.signIn` with an
+//    `fsk_test_…` key) — persisted/restored automatically by the client.
+//
+// Consumers read ONE surface: `useFsAuth()` → { strategy, loaded, signedIn,
+// signIn(), signOut(), user }. `<FsUserButton/>` renders the right control for
+// the strategy (Clerk's avatar menu, or nothing in persona mode — persona
+// chrome is host-specific).
+import { createContext, useContext, useEffect, useMemo, useState, } from "react";
+import { useFartherShore, useSession } from "../react/index.js";
+import { useFsTheme } from "./theme.js";
+const Ctx = createContext(null);
+export function useFsAuth() {
+    const ctx = useContext(Ctx);
+    if (!ctx)
+        throw new Error("useFsAuth must be used within <FartherShoreRoot>");
+    return ctx;
+}
+/** Like {@link useFsAuth} but null outside the managed auth layer — lets
+ *  components degrade instead of throwing when mounted without a Root. */
+export function useOptionalFsAuth() {
+    return useContext(Ctx);
+}
+/* ── Control components (the Clerk-style integration surface) ──── */
+/** Renders children only when a user is signed in. */
+export function SignedIn({ children }) {
+    const auth = useFsAuth();
+    return auth.loaded && auth.signedIn ? _jsx(_Fragment, { children: children }) : null;
+}
+/** Renders children only when signed out (and auth has finished loading —
+ *  nothing flashes during init). */
+export function SignedOut({ children }) {
+    const auth = useFsAuth();
+    return auth.loaded && !auth.signedIn ? _jsx(_Fragment, { children: children }) : null;
+}
+/** Renders children only while the auth layer is initializing. */
+export function AuthLoading({ children }) {
+    const auth = useFsAuth();
+    return auth.loaded ? null : _jsx(_Fragment, { children: children });
+}
+/** 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 function FsSignInButton({ className = "fs-btn fs-btn--cta fs-btn--sm", children = "Sign in", }) {
+    const auth = useFsAuth();
+    return (_jsx("button", { type: "button", className: className, onClick: () => auth.signIn(), children: children }));
+}
+/** A managed sign-out button (any strategy). */
+export function FsSignOutButton({ className = "fs-btn fs-btn--outline fs-btn--sm", children = "Sign out", }) {
+    const auth = useFsAuth();
+    return (_jsx("button", { type: "button", className: className, onClick: () => void auth.signOut(), children: children }));
+}
+let clerkModulePromise = null;
+function loadClerk() {
+    if (!clerkModulePromise) {
+        clerkModulePromise = import(
+        /* @vite-ignore */ "@clerk/clerk-react").then((m) => m, () => {
+            console.warn("[farthershore] Clerk-strategy environment but @clerk/clerk-react is not installed — sign-in disabled. `npm i @clerk/clerk-react` to enable it.");
+            return null;
+        });
+    }
+    return clerkModulePromise;
+}
+let darkThemePromise = null;
+function loadDarkTheme() {
+    if (!darkThemePromise) {
+        darkThemePromise = import(/* @vite-ignore */ "@clerk/themes").then((m) => m.dark ?? null, () => null);
+    }
+    return darkThemePromise;
+}
+function defaultSatelliteDomain() {
+    if (typeof window === "undefined")
+        return undefined;
+    const parts = window.location.hostname.split(".");
+    return parts.length > 2 ? parts.slice(1).join(".") : undefined;
+}
+// Port of the SSR portal's satellite-auto-sync: on a public page Clerk doesn't
+// handshake with the primary domain by itself, so a visitor already signed in
+// on the primary looks signed out here. One sessionStorage-guarded redirect
+// with `?__clerk_synced=false` makes Clerk handshake and propagate the session.
+const HANDSHAKE_FLAG = "__fs_clerk_handshake_attempted";
+function SatelliteAutoSync({ clerk }) {
+    const { isLoaded, isSignedIn } = clerk.useAuth();
+    useEffect(() => {
+        if (!isLoaded || isSignedIn)
+            return;
+        if (typeof window === "undefined")
+            return;
+        const w = window;
+        if (!w.Clerk?.isSatellite)
+            return;
+        const url = new URL(window.location.href);
+        if (url.searchParams.has("__clerk_synced"))
+            return;
+        if (window.sessionStorage.getItem(HANDSHAKE_FLAG) === "true")
+            return;
+        window.sessionStorage.setItem(HANDSHAKE_FLAG, "true");
+        url.searchParams.set("__clerk_synced", "false");
+        window.location.href = url.toString();
+    }, [isLoaded, isSignedIn]);
+    return null;
+}
+/** Installs Clerk's getToken as the client's token source (synchronously on
+ *  render, so data hooks mounted alongside resolve tokens on first fetch) and
+ *  publishes the FsAuth surface. */
+function ClerkAuthBridge({ clerk, children, }) {
+    const fs = useFartherShore();
+    const { isLoaded, isSignedIn, getToken } = clerk.useAuth();
+    const { user } = clerk.useUser();
+    const clerkApi = clerk.useClerk();
+    fs.setTokenProvider(() => getToken());
+    useEffect(() => {
+        fs.setTokenProvider(() => getToken());
+        return () => fs.setTokenProvider(null);
+    }, [fs, getToken]);
+    const value = useMemo(() => ({
+        strategy: "clerk",
+        loaded: isLoaded,
+        signedIn: Boolean(isSignedIn),
+        signIn: () => {
+            void clerkApi.redirectToSignIn({
+                signInForceRedirectUrl: window.location.href,
+                signUpForceRedirectUrl: window.location.href,
+            });
+        },
+        signOut: () => clerkApi.signOut(),
+        user: user ?? null,
+        refresh: () => {
+            /* Clerk session state is push-based. */
+        },
+    }), [isLoaded, isSignedIn, user, clerkApi]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+function ClerkAuth({ config, children, }) {
+    const { mode } = useFsTheme();
+    const [mod, setMod] = useState(null);
+    const [failed, setFailed] = useState(false);
+    const [darkTheme, setDarkTheme] = useState(null);
+    useEffect(() => {
+        let alive = true;
+        void loadClerk().then((m) => {
+            if (!alive)
+                return;
+            if (m)
+                setMod(m);
+            else
+                setFailed(true);
+        });
+        void loadDarkTheme().then((d) => {
+            if (alive)
+                setDarkTheme(d);
+        });
+        return () => {
+            alive = false;
+        };
+    }, []);
+    if (failed) {
+        // Peer not installed: portal renders signed-out, data still works.
+        return _jsx(SignedOutFallback, { strategy: "clerk", children: children });
+    }
+    if (!mod) {
+        // Clerk JS still loading — expose loaded:false so hosts show skeletons.
+        return _jsx(LoadingAuth, { strategy: "clerk", children: children });
+    }
+    const domain = config.satelliteDomain ?? defaultSatelliteDomain();
+    const satelliteProps = config.signInUrl && domain
+        ? { isSatellite: true, domain, signInUrl: config.signInUrl }
+        : {};
+    const Provider = mod.ClerkProvider;
+    return (_jsxs(Provider, { publishableKey: config.publishableKey, appearance: { baseTheme: mode === "dark" && darkTheme ? darkTheme : undefined }, ...satelliteProps, children: [_jsx(SatelliteAutoSync, { clerk: mod }), _jsx(ClerkAuthBridge, { clerk: mod, children: children })] }));
+}
+/* ── Persona (SDK-managed sessions) ────────────────────────────── */
+function PersonaAuth({ children }) {
+    const fs = useFartherShore();
+    const session = useSession();
+    const value = useMemo(() => ({
+        strategy: "test-personas",
+        loaded: !session.loading,
+        signedIn: Boolean(session.data?.authenticated),
+        signIn: () => {
+            // Persona sign-in is a form (an access key) — hosts render FsSignIn /
+            // their own form and call useSession().signIn. Scroll to it if present.
+            document.getElementById("signin")?.scrollIntoView({ behavior: "smooth" });
+        },
+        signOut: async () => {
+            await session.signOut();
+        },
+        user: fs.auth.personaView()?.user ?? null,
+        refresh: session.refresh,
+    }), [session, fs]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+/* ── Shared fallbacks + the strategy switch ────────────────────── */
+function staticAuth(strategy, loaded) {
+    return {
+        strategy,
+        loaded,
+        signedIn: false,
+        signIn: () => { },
+        signOut: async () => { },
+        user: null,
+        refresh: () => { },
+    };
+}
+function LoadingAuth({ strategy, children, }) {
+    const value = useMemo(() => staticAuth(strategy, false), [strategy]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+function SignedOutFallback({ strategy, children, }) {
+    const value = useMemo(() => staticAuth(strategy, true), [strategy]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+/** The managed auth layer — mounted by `<FartherShoreRoot>`; mountable directly
+ *  by custom roots. Picks the implementation from the environment's strategy. */
+export function FsAuthProvider({ strategy, clerk, children, }) {
+    if (strategy === "clerk") {
+        if (!clerk?.publishableKey) {
+            console.warn("[farthershore] Clerk-strategy environment but no publishable key configured (FartherShoreRoot `clerk` prop / VITE_CLERK_PUBLISHABLE_KEY) — sign-in disabled.");
+            return _jsx(SignedOutFallback, { strategy: "clerk", children: children });
+        }
+        return _jsx(ClerkAuth, { config: clerk, children: children });
+    }
+    return _jsx(PersonaAuth, { children: children });
+}
+/* ── FsUserButton ──────────────────────────────────────────────── */
+/** 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 function FsUserButton() {
+    const auth = useFsAuth();
+    const [mod, setMod] = useState(null);
+    useEffect(() => {
+        if (auth.strategy === "clerk") {
+            void loadClerk().then((m) => setMod(m));
+        }
+    }, [auth.strategy]);
+    if (auth.strategy !== "clerk")
+        return null;
+    if (!auth.loaded || !mod) {
+        return (_jsx("div", { "aria-hidden": true, style: {
+                height: 32,
+                width: 32,
+                borderRadius: 999,
+                background: "var(--fs-color-input)",
+            } }));
+    }
+    const UserButton = mod.UserButton;
+    return _jsx(UserButton, {});
+}
+//# sourceMappingURL=auth.js.map