@farthershore/farthershore-js 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -5,6 +5,35 @@ This project adheres to Semantic Versioning (pre-1.0: minors may break).
 
 ## [Unreleased]
 
+## [0.8.2] - 2026-06-24
+
+### Changed
+
+- Lockstep family bump `0.8.1` → `0.8.2`, republishing the SDK family in sync
+  with the branch HEAD. This release lands the CLI-complete product lifecycle
+  (first-class `product publish` with auto-semver, `product status`, operate
+  `plan migrate`), the migration→operate refactor (the declarative `@Migration`
+  decorator was removed from `@farthershore/product`), and the BYO-backend V1
+  simplification (two transport modes `direct` + `tunnel`; mTLS removed).
+  `@farthershore/farthershore-js` itself is unchanged behaviourally; the bump
+  keeps the published family versions equal (REL-1 lockstep).
+
+## [0.8.1] - 2026-06-23
+
+### Fixed
+
+- **`startOnboarding` cache/token bust.** The onboarding helper now invalidates
+  the cached session/token after kicking off onboarding, so the next call sees
+  the freshly-provisioned state instead of a stale read.
+
+### Changed
+
+- Lockstep family bump `0.8.0` → `0.8.1` to republish shipped drift since the
+  `0.8.0` cut. Companion SDK fixes in this family release:
+  `@farthershore/backend` route-canon `{rest}` → `{__fs_rest}` parity plus
+  HEAD-route reflection; `@farthershore/product` inherited-decorator-config
+  guard. Pin all three to `0.8.1`.
+
 ## [0.8.0] - 2026-06-22
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@ 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.
 
-> **Status: `0.8.0` (lockstep SDK family).** Published to npm. Versioned in
+> **Status: `0.8.2` (lockstep SDK family).** Published to npm. Versioned in
 > lockstep with `@farthershore/product` and `@farthershore/backend` — pin the
 > three to the SAME version. Pre-1.0, so minor versions may include breaking
 > changes while the API stabilizes against the dev portal, managed template, and
@@ -240,14 +240,14 @@ import { FsManifestNav } from "@farthershore/farthershore-js/components";
 
 This package is **pre-1.0 (`0.x`)** and ships as part of a **lockstep SDK
 family**: `@farthershore/farthershore-js`, `@farthershore/product`, and
-`@farthershore/backend` are published at the SAME version (currently `0.8.0`).
+`@farthershore/backend` are published at the SAME version (currently `0.8.1`).
 Pin all three to the same version. Under SemVer's 0.x rules a **minor** bump
 (`0.8.x` → `0.9.0`) may include **breaking changes**, so the usual caret range is
 unsafe here:
 
-- ❌ `^0.8` / `^0.8.0` — caret does **not** lock the minor across `0.x`; it would
+- ❌ `^0.8` / `^0.8.1` — caret does **not** lock the minor across `0.x`; it would
   silently accept a breaking `0.9.0`.
-- ✅ Pin **exact** (`0.8.0`) or use a patch-only tilde (`~0.8.0`) until `1.0.0`.
+- ✅ Pin **exact** (`0.8.1`) or use a patch-only tilde (`~0.8.1`) until `1.0.0`.
 
 Breaking changes within `0.x` are recorded in [`CHANGELOG.md`](./CHANGELOG.md)
 (Keep a Changelog format) — read it before bumping.

package/dist/generated/version.d.ts

@@ -1,5 +1,5 @@
 /** This SDK's published version (from package.json). */
-export declare const SDK_VERSION = "0.8.0";
+export declare const SDK_VERSION = "0.8.2";
 /** Compat fingerprint over the canonical `@farthershore/contracts` DTO set. */
-export declare const CONTRACTS_FP = "af8995b9467842b6";
+export declare const CONTRACTS_FP = "5beebf042c7ce96d";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -12,7 +12,7 @@
 // bump or contracts edit that wasn't regenerated fails CI.
 // ---------------------------------------------------------------------------
 /** This SDK's published version (from package.json). */
-export const SDK_VERSION = "0.8.0";
+export const SDK_VERSION = "0.8.2";
 /** Compat fingerprint over the canonical `@farthershore/contracts` DTO set. */
-export const CONTRACTS_FP = "af8995b9467842b6";
+export const CONTRACTS_FP = "5beebf042c7ce96d";
 //# sourceMappingURL=version.js.map

package/dist/resources/plans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/resources/plans.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,IAAI,EACL,MAAM,aAAa,CAAC;AAGrB;6BAC6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB;4CACwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iEAEiE;AACjE,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;0EACsE;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAUD,MAAM,WAAW,aAAa;IAC5B;sDACkD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB;iDAC6C;IAC7C,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3D;;;6DAGyD;IACzD,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,eAAe,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GACxC,aAAa,CAiFf"}
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/resources/plans.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,IAAI,EACL,MAAM,aAAa,CAAC;AAGrB;6BAC6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB;4CACwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iEAEiE;AACjE,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;0EACsE;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAUD,MAAM,WAAW,aAAa;IAC5B;sDACkD;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB;iDAC6C;IAC7C,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3D;;;6DAGyD;IACzD,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,eAAe,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GACxC,aAAa,CAkFf"}

package/dist/resources/plans.js

@@ -70,6 +70,7 @@ export function createPlansResource(ctx, ensureBootstrap) {
                 },
             });
             const autoApiKey = raw?.autoApiKey ?? null;
+            bustEntitlementCaches(ctx);
             // M6 — auto-stash for <AutoKeyBanner/> (the onboarding path, symmetric with
             // subscribe()). normalizeAutoApiKey inside the store handles the
             // string | { secret } shapes; a null is a no-op.

package/dist/resources/plans.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farthershore/farthershore-js",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Farther Shore Frontend SDK — the browser integration layer between static frontends and the Farther Shore platform (Core + Gateway).",
   "publishConfig": {
     "access": "public"