@farthershore/farthershore-js 0.0.0 → 0.1.1

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                                                                 |
@@ -39,15 +83,11 @@ scoping headers Core needs.
 | `fs.product`                           | (bootstrap)           | `get()`                                                                 |
 | `fs.auth`                              | Core                  | `getSession()`, `signIn({apiKey})` (persona), `signOut()`, `setToken()` |
 | `fs.keys`                              | Core                  | `list()`, `create()`, `revoke()`, `rotate()`                            |
-| `fs.usage`                             | Core                  | `summary()`, `events()`, ~~`timeseries()`~~                             |
-| `fs.billing`                           | Core                  | `subscription()`, `openBillingPortal()`, ~~`invoices()`~~               |
-| `fs.analytics`                         | Core                  | ~~`requests()`~~                                                        |
+| `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)`                                             |
 
-Struck-through methods have **no platform endpoint yet** and throw
-`FartherShoreNotImplementedError` (the SDK never silently no-ops a missing
-capability) — see Deferred.
-
 ## Auth
 
 - **Core** calls use the consumer **session token** as `Authorization: Bearer`.
@@ -76,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,17 +180,33 @@ client. They're thin wrappers over the client — no duplicated logic.
 
 ## Deferred (no platform endpoint yet)
 
-- `usage.timeseries()` — Core exposes `summary` + recent `events` only; derive a
-  series client-side or add a Core timeseries route.
-- `billing.invoices()` — invoices are viewed through `billing.openBillingPortal()`
-  (Stripe-hosted); there's no JSON invoice list.
-- `analytics.requests()` — no consumer analytics endpoint; closest is
-  `usage.events()` + audit logs.
 - **Clerk browser sign-in** is host-app-driven (pass `getToken`); the SDK doesn't
   bundle `@clerk/clerk-js`.
 - 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/catalog.d.ts

@@ -1,4 +1,4 @@
-import type { Grant, Meter, Plan, PlanMeter } from "./types.js";
+import type { Grant, Meter, Plan, PlanMeter, UsageBillingBasis } from "./types.js";
 export type PlanKind = "free" | "pay_as_you_go" | "subscription" | "hybrid" | "prepaid" | "trial" | "custom";
 /**
  * Classify a plan into a single canonical kind — mirrors the shared
@@ -77,5 +77,5 @@ export type MeterUsageRow = {
  * `meters` is the product-level meter catalog (for labels/units); when empty,
  * the summary keys are used directly.
  */
-export declare function buildMeterUsageRows(plan: Plan | null, summary: Record<string, number>, meters: Meter[]): MeterUsageRow[];
+export declare function buildMeterUsageRows(plan: Plan | null, summary: Record<string, number>, meters: Meter[], billingBasis?: UsageBillingBasis): MeterUsageRow[];
 //# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAS3E,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,eAAe,GACf,cAAc,GACd,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,CAAC;AAUb;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAQjD;AAED;8EAC8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAO9C;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEpD;AAID;;;2CAG2C;AAC3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO7E;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAI5D;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAoB3D;AAID,MAAM,MAAM,QAAQ,GAAG;IACrB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAsBF;;uCAEuC;AACvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,CAMnD;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,EAAE,CAMrD;AAwED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAKf;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;CAAE,CAIrD;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,KAAK,EAAE,GACd,aAAa,EAAE,CA+BjB"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EACL,IAAI,EAEJ,SAAS,EACT,iBAAiB,EAClB,MAAM,YAAY,CAAC;AASpB,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,eAAe,GACf,cAAc,GACd,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,CAAC;AAUb;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAQjD;AAED;8EAC8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAO9C;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEpD;AAID;;;2CAG2C;AAC3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO7E;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAI5D;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAoB3D;AAID,MAAM,MAAM,QAAQ,GAAG;IACrB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAsBF;;uCAEuC;AACvC,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,CAMnD;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,EAAE,CAMrD;AAwED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAKf;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAA;CAAE,CAIrD;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,KAAK,EAAE,EACf,YAAY,CAAC,EAAE,iBAAiB,GAC/B,aAAa,EAAE,CA0CjB"}

package/dist/catalog.js

@@ -244,14 +244,20 @@ export function computeProgressBar(used, total) {
  * `meters` is the product-level meter catalog (for labels/units); when empty,
  * the summary keys are used directly.
  */
-export function buildMeterUsageRows(plan, summary, meters) {
-    // Union of catalog dimensions and any dimension present in the summary.
+export function buildMeterUsageRows(plan, summary, meters, billingBasis) {
+    // Union of catalog dimensions and any builder-metered dimension present in the
+    // summary. The built-in `dollars` credit/cost dimension the gateway records is
+    // NOT a product meter — only surface it if the builder explicitly defined a
+    // meter for it (then it's already in the catalog above). (`bandwidth_bytes`
+    // was removed from the meter model — `requests` is the only native meter.)
+    const TELEMETRY_DIMENSIONS = new Set(["dollars"]);
     const byKey = new Map();
     for (const m of meters)
         byKey.set(m.key, m);
     for (const key of Object.keys(summary)) {
-        if (!byKey.has(key))
-            byKey.set(key, { key, display: key });
+        if (byKey.has(key) || TELEMETRY_DIMENSIONS.has(key))
+            continue;
+        byKey.set(key, { key, display: key });
     }
     const rows = [];
     for (const meter of byKey.values()) {
@@ -260,7 +266,11 @@ export function buildMeterUsageRows(plan, summary, meters) {
         if (quota != null || used > 0) {
             rows.push({
                 key: meter.key,
-                label: meter.display,
+                // A weighted/usage-billed product relabels the bare `requests` count as
+                // "Usage" (a call can cost >1 unit); every other meter keeps its name.
+                label: meter.key === "requests" && billingBasis === "usage"
+                    ? "Usage"
+                    : meter.display,
                 used,
                 quota,
                 ...(meter.unit ? { unit: meter.unit } : {}),

package/dist/catalog.js.map

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

package/dist/client.d.ts

@@ -1,11 +1,11 @@
 import { type FartherShoreConfig } from "./config.js";
+import { type CoreRequest } from "./http.js";
 import { type ProductResource } from "./resources/product.js";
 import { type AuthResource } from "./resources/auth.js";
 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 AnalyticsResource } from "./resources/analytics.js";
 import { type FeatureHandle, type GatewayRequestInit } from "./resources/feature.js";
 import type { Bootstrap } from "./types.js";
 export interface FartherShoreClient {
@@ -16,18 +16,78 @@ 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;
+    /** 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;
-    readonly analytics: AnalyticsResource;
     /** A handle to a builder-defined feature, routed through the Gateway. */
     feature(name: string): FeatureHandle;
     /** Generic Gateway call (alias for `feature("…").fetch`). */
     invoke(path: string, init?: GatewayRequestInit): Promise<Response>;
+    /**
+     * Generic authenticated Core call — the escape hatch for platform endpoints
+     * the typed resources don't model yet (e.g. a product's `/me/team`,
+     * `/me/audit-logs`, `/me/addons`). The Core counterpart to {@link invoke}:
+     * it attaches the session bearer + the host/env/org scoping headers and maps
+     * non-2xx to {@link FartherShoreApiError}, exactly like the typed resources —
+     * the caller only supplies the path and the response type. Prefer a typed
+     * resource (`fs.usage`, `fs.keys`, …) when one exists.
+     */
+    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;AAGrB,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,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,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;IAC9B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAEtC,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;CACpE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAwCpB"}
+{"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"}

package/dist/client.js

@@ -4,15 +4,62 @@
 // vs Gateway, auth, host/env scoping.
 import { buildContext, } from "./config.js";
 import { resolveBootstrap } from "./bootstrap.js";
-import { gatewayFetch } from "./http.js";
+import { coreFetch, gatewayFetch } from "./http.js";
 import { createProductResource, } from "./resources/product.js";
 import { createAuthResource } 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 { createAnalyticsResource, } from "./resources/analytics.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);
     let cached = null;
@@ -48,9 +95,9 @@ export function createFartherShoreClient(config) {
         usage: createUsageResource(ctx),
         billing: createBillingResource(ctx),
         plans: createPlansResource(ctx, ensureBootstrap),
-        analytics: createAnalyticsResource(),
         feature: (name) => createFeature(ctx, name),
         invoke: (path, init) => gatewayFetch(ctx, path, init),
+        core: (req) => coreFetch(ctx, req),
     };
 }
 //# sourceMappingURL=client.js.map

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,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,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,uBAAuB,GAExB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,aAAa,GAGd,MAAM,wBAAwB,CAAC;AA2BhC,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,SAAS,EAAE,uBAAuB,EAAE;QACpC,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;KACtD,CAAC;AACJ,CAAC"}
+{"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"}

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC;+EAC+E;AAC/E,MAAM,MAAM,aAAa,GAAG,MACxB,MAAM,GACN,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC;oEACgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uBACmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;4CACwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+CAC2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;kEAE8D;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,iFAAiF;IACjF,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;8EAC8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;0CACsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAgCtE;AAED;4DAC4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC;+EAC+E;AAC/E,MAAM,MAAM,aAAa,GAAG,MACxB,MAAM,GACN,IAAI,GACJ,SAAS,GACT,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC;oEACgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uBACmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;4CACwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;qDACiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;+CAC2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;kEAE8D;IAC9D,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,iFAAiF;IACjF,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;8EAC8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;0CACsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAkCtE;AAED;4DAC4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7E"}

package/dist/config.js

@@ -4,12 +4,13 @@
 // endpoints, or routing rules. It configures the client ONCE (usually just a
 // coreUrl) and expresses intent (`fs.usage.summary()`); the SDK owns where the
 // request goes and how it's authenticated.
+import { FartherShoreConfigError } from "./errors.js";
 function trimTrailingSlash(u) {
     return u.replace(/\/+$/, "");
 }
 export function buildContext(config) {
     if (!config.coreUrl) {
-        throw new Error("createFartherShoreClient: `coreUrl` is required");
+        throw new FartherShoreConfigError("createFartherShoreClient: `coreUrl` is required");
     }
     const portalHost = config.portalHost ??
         (typeof globalThis !== "undefined" &&
@@ -19,7 +20,7 @@ export function buildContext(config) {
     const fetchImpl = config.fetch ??
         (typeof fetch !== "undefined" ? fetch.bind(globalThis) : undefined);
     if (!fetchImpl) {
-        throw new Error("createFartherShoreClient: no global fetch; pass `fetch` in the config");
+        throw new FartherShoreConfigError("createFartherShoreClient: no global fetch; pass `fetch` in the config");
     }
     return {
         coreUrl: trimTrailingSlash(config.coreUrl),

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AA0D3C,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,UAAU,GACd,MAAM,CAAC,UAAU;QACjB,CAAC,OAAO,UAAU,KAAK,WAAW;YACjC,UAA+C,CAAC,QAAQ,EAAE,IAAI;YAC7D,CAAC,CAAE,UAA6C,CAAC,QAAQ,CAAC,IAAI;YAC9D,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,SAAS,GACb,MAAM,CAAC,KAAK;QACZ,CAAC,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QACxD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;QAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;4DAC4D;AAC5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAkB;IACnD,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC;IAC9C,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,2CAA2C;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AA0DtD,SAAS,iBAAiB,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,uBAAuB,CAC/B,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,MAAM,CAAC,UAAU;QACjB,CAAC,OAAO,UAAU,KAAK,WAAW;YACjC,UAA+C,CAAC,QAAQ,EAAE,IAAI;YAC7D,CAAC,CAAE,UAA6C,CAAC,QAAQ,CAAC,IAAI;YAC9D,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,SAAS,GACb,MAAM,CAAC,KAAK;QACZ,CAAC,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,uBAAuB,CAC/B,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC1C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QACxD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;QAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED;4DAC4D;AAC5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAkB;IACnD,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC;IAC9C,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/errors.d.ts

@@ -1,8 +1,27 @@
 export declare class FartherShoreError extends Error {
     constructor(message: string);
 }
-/** A non-2xx response from Core or the Gateway. Carries the platform error
- *  envelope `{ error: { code, message } }` when present. */
+/**
+ * A non-2xx response from Core or the Gateway. Exposes:
+ * - `.status` — the HTTP status code;
+ * - `.code` — the platform error code from the `{ error: { code, message } }`
+ *   envelope (or a fallback when the envelope is absent);
+ * - `.body` — the parsed response body, for richer error detail.
+ *
+ * Callers commonly branch on `.status` — e.g. `401`/`403` (re-auth), `404`
+ * (treat as absent), `409` (conflict/retry) — rather than parsing the message.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await fs.keys.list();
+ * } catch (err) {
+ *   if (err instanceof FartherShoreApiError && err.status === 401) {
+ *     // session expired — prompt re-auth
+ *   } else throw err;
+ * }
+ * ```
+ */
 export declare class FartherShoreApiError extends FartherShoreError {
     readonly status: number;
     readonly code: string;
@@ -14,14 +33,19 @@ export declare class FartherShoreNetworkError extends FartherShoreError {
     readonly cause?: unknown;
     constructor(message: string, cause?: unknown);
 }
-/** Thrown when calling a surface that has no platform endpoint yet (an honest
- *  stub — the SDK never silently no-ops a missing capability). */
-export declare class FartherShoreNotImplementedError extends FartherShoreError {
-    constructor(message: string);
+/** Thrown when a request was aborted (e.g. a React hook unmounted or its deps
+ *  changed before the request resolved). Callers/hooks should ignore it. */
+export declare class FartherShoreAbortError extends FartherShoreError {
+    constructor(message?: string);
 }
 /** Thrown when the client is used before `bootstrap()` has resolved the product
  *  it needs (e.g. a per-product call with no configured productId). */
 export declare class FartherShoreNotReadyError extends FartherShoreError {
     constructor(message: string);
 }
+/** Thrown at client construction for invalid/missing config (e.g. no `coreUrl`,
+ *  no global `fetch`). */
+export declare class FartherShoreConfigError extends FartherShoreError {
+    constructor(message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;4DAC4D;AAC5D,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBACX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAOzE;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;kEACkE;AAClE,qBAAa,+BAAgC,SAAQ,iBAAiB;gBACxD,OAAO,EAAE,MAAM;CAI5B;AAED;uEACuE;AACvE,qBAAa,yBAA0B,SAAQ,iBAAiB;gBAClD,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBACX,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAOzE;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,SAAQ,iBAAiB;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;4EAC4E;AAC5E,qBAAa,sBAAuB,SAAQ,iBAAiB;gBAC/C,OAAO,SAAoB;CAIxC;AAED;uEACuE;AACvE,qBAAa,yBAA0B,SAAQ,iBAAiB;gBAClD,OAAO,EAAE,MAAM;CAI5B;AAED;0BAC0B;AAC1B,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,OAAO,EAAE,MAAM;CAI5B"}