@laboverwire/stitch 0.6.5 → 0.7.1

package/CHANGELOG.md

@@ -2,10 +2,25 @@
 
 ## Unreleased
 
-### Added
-
 - _Nothing yet._
 
+## 0.7.1
+
+### Fixed
+
+- **A scope opened by a second viewer no longer comes up empty on a cold load.** A viewer that opened a scope it did not create — via `replaceScope` while the transport was already `connected` — received the scope's children only intermittently (roughly 40% of cold opens stayed empty until a full page reload). The root cause was engine-side and wasm-specific: `replace_scope`'s server-open branch, which fetches the scope's root and children from the broker, was compiled out on `wasm32`, so a connected `replaceScope` in the browser only read local persistence — empty for a viewer with nothing cached — while the sole wasm server-open path (backfill-on-connect, added in 0.6.1) raced the open and usually no-opped. Fixed in the engine (stitch-rs#92, closing stitch-rs#91) and shipped as `@laboverwire/stitch-wasm` 0.6.2: the connected server-open branch now runs on all targets, so a connected `replaceScope` reconciles the scope's root and children itself and the scoped read hooks (`useScopedEntities`, `useEntitySnapshot`, and their Vue equivalents) converge with no reload. Regression-tested upstream (`connected_replace_scope_delivers_children_to_a_second_viewer`, native broker, plus a broker-gated wasm test); this repo adds no wrapper test, as the path cannot be exercised without a live broker. This supersedes the partial 0.6.1 improvement (stitch-rs#85) and resolves the empty-scope symptom tracked in this repo as #67; the React `useSyncScope` latch was ruled out as the cause and is unchanged.
+
+### Changed
+
+- Raised the `@laboverwire/stitch-wasm` floor to `^0.6.2`, which delivers the connected-open fix above. 0.6.2 is a patch over 0.6.0/0.6.1 and additive to the `Store` surface this adapter consumes, so there are no `@laboverwire/stitch` type or signature changes.
+
+## 0.7.0
+
+### Changed
+
+- **Raised the minimum Node version to `>=22.22.1` (dropped Node 20).** `engines.node` moves from `>=20` to `>=22.22.1`; installing on Node 20 (EOL April 2026) or any Node below 22.22.1 now emits an `EBADENGINE` warning, a hard failure under `engine-strict` or pnpm. Two dev-toolchain upgrades drove the floor: vitest 5 (floor Node `^22.12.0 || ^24 || >=26`) and lint-staged 17 (floor Node `>=22.22.1`, the binding constraint); the pre-commit pipeline is unchanged (`prettier --write` then `oxlint --fix` on staged `src` files). CI now runs Node 22 and 24 instead of 20 and 22. No `@laboverwire/stitch` runtime or type surface changed.
+- **Upgraded the build compiler to TypeScript 7 and replaced the ESLint toolchain with oxlint.** `typescript` moves from `^6.0.3` to `^7.0.2`, and `eslint`, `@eslint/js`, `typescript-eslint`, `eslint-plugin-react-hooks`, `eslint-config-prettier`, and `globals` are replaced by a single `oxlint` dev dependency (`eslint.config.js` → `.oxlintrc.json`). oxlint reproduces the prior lint coverage: its `correctness` rules plus the typescript-eslint `recommended` syntactic rules enforced as errors (`no-explicit-any`, `ban-ts-comment`, `no-namespace`, and the rest), and the `react-hooks` rules — `rules-of-hooks` (error) and `exhaustive-deps` (warn) — scoped to the React bindings under `src/react`. No type-aware rules were in use, so none are lost. The published `.d.ts` are unchanged from the previous TypeScript 6 build (verified by diffing both outputs), so there is no consumer-facing type or runtime change. Prettier remains the formatter. Trims 115 transitive dev dependencies.
+
 ## 0.6.5
 
 ### Added

package/dist/index.js

@@ -1,2 +1,2 @@
-export { createStore } from "./store.js";
+export { createStore } from './store.js';
 //# sourceMappingURL=index.js.map

package/dist/internal-list-apply.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-list-apply.js","sourceRoot":"","sources":["../src/internal-list-apply.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,MAAe,EACf,EAAkC;IAElC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAkB,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["export type ListItem = Record<string, unknown> & { id: string };\n\nexport function applyEvent(\n  prev: ListItem[],\n  entity: unknown,\n  op: 'insert' | 'update' | 'delete'\n): ListItem[] {\n  if (!entity || typeof entity !== 'object' || !('id' in entity)) return prev;\n  const item = entity as ListItem;\n  const idx = prev.findIndex((d) => d.id === item.id);\n  switch (op) {\n    case 'insert': {\n      if (idx < 0) return [...prev, item];\n      const next = prev.slice();\n      next[idx] = item;\n      return next;\n    }\n    case 'update': {\n      if (idx < 0) return prev;\n      const next = prev.slice();\n      next[idx] = item;\n      return next;\n    }\n    case 'delete': {\n      if (idx < 0) return prev;\n      return [...prev.slice(0, idx), ...prev.slice(idx + 1)];\n    }\n    default:\n      return prev;\n  }\n}\n"]}
+{"version":3,"file":"internal-list-apply.js","sourceRoot":"","sources":["../src/internal-list-apply.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CACxB,IAAgB,EAChB,MAAe,EACf,EAAkC;IAElC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,MAAM,IAAI,GAAG,MAAkB,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ,EAAE,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["export type ListItem = Record<string, unknown> & { id: string };\n\nexport function applyEvent(\n  prev: ListItem[],\n  entity: unknown,\n  op: 'insert' | 'update' | 'delete'\n): ListItem[] {\n  if (!entity || typeof entity !== 'object' || !('id' in entity)) return prev;\n  const item = entity as ListItem;\n  const idx = prev.findIndex((d) => d.id === item.id);\n  switch (op) {\n    case 'insert': {\n      if (idx < 0) return [...prev, item];\n      const next = prev.slice();\n      next[idx] = item;\n      return next;\n    }\n    case 'update': {\n      if (idx < 0) return prev;\n      const next = prev.slice();\n      next[idx] = item;\n      return next;\n    }\n    case 'delete': {\n      if (idx < 0) return prev;\n      return [...prev.slice(0, idx), ...prev.slice(idx + 1)];\n    }\n    default:\n      return prev;\n  }\n}\n"]}

package/dist/react/hooks/useRootEntityList.js

@@ -1,5 +1,5 @@
 import { useEffect, useState, useCallback } from 'react';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useRootEntityList(store) {
     const rootEntity = store.config.scope.rootEntity;
     const [items, setItems] = useState([]);

package/dist/react/hooks/useScopedEntities.js

@@ -1,5 +1,5 @@
 import { useEffect, useState, useCallback } from 'react';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useScopedEntities(store, scopeId, entity) {
     const effectiveScopeField = store.config.scope.scopeField;
     const [data, setData] = useState([]);

package/dist/react/hooks/useTopLevelEntities.js

@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useTopLevelEntities(store, entity) {
     const [items, setItems] = useState([]);
     const [loading, setLoading] = useState(true);

package/dist/react/index.js

@@ -1,10 +1,10 @@
-export { StoreContext, useStore } from "./context.js";
-export { StoreProvider, AuthProvider } from "./provider.js";
-export { useEntitySnapshot, useEntitySnapshotAsMap } from "./hooks/useEntitySnapshot.js";
-export { useConnectionStatus } from "./hooks/useConnectionStatus.js";
-export { useScopedEntities } from "./hooks/useScopedEntities.js";
-export { useRootEntityList } from "./hooks/useRootEntityList.js";
-export { useTopLevelEntities } from "./hooks/useTopLevelEntities.js";
-export { useChildCounts } from "./hooks/useChildCounts.js";
-export { useSyncScope } from "./hooks/useSyncScope.js";
+export { StoreContext, useStore } from './context.js';
+export { StoreProvider, AuthProvider } from './provider.js';
+export { useEntitySnapshot, useEntitySnapshotAsMap } from './hooks/useEntitySnapshot.js';
+export { useConnectionStatus } from './hooks/useConnectionStatus.js';
+export { useScopedEntities } from './hooks/useScopedEntities.js';
+export { useRootEntityList } from './hooks/useRootEntityList.js';
+export { useTopLevelEntities } from './hooks/useTopLevelEntities.js';
+export { useChildCounts } from './hooks/useChildCounts.js';
+export { useSyncScope } from './hooks/useSyncScope.js';
 //# sourceMappingURL=index.js.map

package/dist/react/provider.js

@@ -1,6 +1,6 @@
-import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useState, useMemo } from 'react';
-import { StoreContext } from "./context.js";
+import { StoreContext } from './context.js';
 /**
  * Store lifecycle only — initializes the store, tracks connection status, and
  * handles visibility-change reconnection. Authentication concerns (userId, session

package/dist/vue/StitchAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StitchAuth.d.ts","sourceRoot":"","sources":["../../src/vue/StitchAuth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,UAAU;;cAIM,QAAQ,CAAC,KAAK,CAAC;;;;;;;;;;;;cAGF,QAAQ,CAAC,MAAM,IAAI,CAAC;;;;cACjB,QAAQ,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;;;cAJ7C,QAAQ,CAAC,KAAK,CAAC;;;;;;;;;;;;cAGF,QAAQ,CAAC,MAAM,IAAI,CAAC;;;;cACjB,QAAQ,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;;4BADjB,IAAI;+BACD,OAAO,CAAC,IAAI,CAAC;4EA4BvE,CAAC"}
+{"version":3,"file":"StitchAuth.d.ts","sourceRoot":"","sources":["../../src/vue/StitchAuth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,UAAU;;cAIM,QAAQ,CAAC,KAAK,CAAC;;;;QAC9B,IAAI;QAAU,OAAO;;;QACd,IAAI;QAAW,OAAO;;;QACnB,IAAI,EAAc,QAAQ,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO;;;QAC5C,IAAI,EAAc,QAAQ,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAD1B,IAAI;+BACD,OAAO,CAAC,IAAI,CAAC;4EA4BvE,CAAC"}

package/dist/vue/StoreRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StoreRoot.d.ts","sourceRoot":"","sources":["../../src/vue/StoreRoot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAoB,KAAK,EAAE,MAAM,aAAa,CAAC;AAG3D;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;cAIO,QAAQ,CAAC,KAAK,CAAC;;;;;;;;cAET,QAAQ,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;;;;;;;cAFrC,QAAQ,CAAC,KAAK,CAAC;;;;;;;;cAET,QAAQ,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;;;;;qBAAhB,OAAO,CAAC,MAAM,CAAC;4EAkG/D,CAAC"}
+{"version":3,"file":"StoreRoot.d.ts","sourceRoot":"","sources":["../../src/vue/StoreRoot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAoB,KAAK,EAAE,MAAM,aAAa,CAAC;AAG3D;;;;;GAKG;AACH,eAAO,MAAM,SAAS;;cAIO,QAAQ,CAAC,KAAK,CAAC;;;;QAC3B,IAAI;QAAU,OAAO;;;QACrB,IAAI,EAAc,QAAQ,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO;;;;;;;;;;;;;;;;;;;qBAAzB,OAAO,CAAC,MAAM,CAAC;4EAkG/D,CAAC"}

package/dist/vue/StoreRoot.js

@@ -1,5 +1,5 @@
 import { defineComponent, provide, shallowRef, onMounted, onUnmounted, watch } from 'vue';
-import { STITCH_KEY } from "./injection-key.js";
+import { STITCH_KEY } from './injection-key.js';
 /**
  * Store lifecycle component. Initializes the store, tracks connection status, and
  * handles visibility-change reconnection. Authentication concerns (userId, session

package/dist/vue/composables/useRootEntityList.js

@@ -1,5 +1,5 @@
 import { shallowRef, watch, onBeforeUnmount } from 'vue';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useRootEntityList(store) {
     const rootEntity = store.config.scope.rootEntity;
     const items = shallowRef([]);

package/dist/vue/composables/useScopedEntities.js

@@ -1,5 +1,5 @@
 import { shallowRef, watch, toValue, onBeforeUnmount } from 'vue';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useScopedEntities(store, scopeId, entity) {
     const effectiveScopeField = store.config.scope.scopeField;
     const data = shallowRef([]);

package/dist/vue/composables/useStore.js

@@ -1,5 +1,5 @@
 import { inject } from 'vue';
-import { STITCH_KEY } from "../injection-key.js";
+import { STITCH_KEY } from '../injection-key.js';
 export function useStore() {
     const ctx = inject(STITCH_KEY);
     if (!ctx)

package/dist/vue/composables/useTopLevelEntities.js

@@ -1,5 +1,5 @@
 import { shallowRef, watch, onBeforeUnmount } from 'vue';
-import { applyEvent } from "../../internal-list-apply.js";
+import { applyEvent } from '../../internal-list-apply.js';
 export function useTopLevelEntities(store, entity) {
     const items = shallowRef([]);
     const loading = shallowRef(true);

package/dist/vue/index.js

@@ -1,12 +1,12 @@
-export { STITCH_KEY } from "./injection-key.js";
-export { StoreRoot } from "./StoreRoot.js";
-export { StitchAuth } from "./StitchAuth.js";
-export { useStore } from "./composables/useStore.js";
-export { useEntitySnapshot, useEntitySnapshotAsMap } from "./composables/useEntitySnapshot.js";
-export { useConnectionStatus } from "./composables/useConnectionStatus.js";
-export { useSyncScope } from "./composables/useSyncScope.js";
-export { useRootEntityList } from "./composables/useRootEntityList.js";
-export { useScopedEntities } from "./composables/useScopedEntities.js";
-export { useChildCounts } from "./composables/useChildCounts.js";
-export { useTopLevelEntities } from "./composables/useTopLevelEntities.js";
+export { STITCH_KEY } from './injection-key.js';
+export { StoreRoot } from './StoreRoot.js';
+export { StitchAuth } from './StitchAuth.js';
+export { useStore } from './composables/useStore.js';
+export { useEntitySnapshot, useEntitySnapshotAsMap } from './composables/useEntitySnapshot.js';
+export { useConnectionStatus } from './composables/useConnectionStatus.js';
+export { useSyncScope } from './composables/useSyncScope.js';
+export { useRootEntityList } from './composables/useRootEntityList.js';
+export { useScopedEntities } from './composables/useScopedEntities.js';
+export { useChildCounts } from './composables/useChildCounts.js';
+export { useTopLevelEntities } from './composables/useTopLevelEntities.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laboverwire/stitch",
-  "version": "0.6.5",
+  "version": "0.7.1",
   "description": "Reactive state synchronization library bridging an in-memory store, IndexedDB persistence, and MQTT-based remote sync.",
   "license": "Apache-2.0",
   "author": "LabOverWire",
@@ -9,7 +9,7 @@
   "types": "./dist/index.d.ts",
   "sideEffects": false,
   "engines": {
-    "node": ">=20"
+    "node": ">=22.22.1"
   },
   "repository": {
     "type": "git",
@@ -39,8 +39,8 @@
   ],
   "scripts": {
     "type-check": "tsc --noEmit",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix .",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
     "format": "prettier --write 'src/**/*.{ts,tsx}'",
     "format:check": "prettier --check 'src/**/*.{ts,tsx}'",
     "test": "vitest run",
@@ -56,7 +56,7 @@
   "lint-staged": {
     "src/**/*.{ts,tsx}": [
       "prettier --write",
-      "eslint --fix"
+      "oxlint --fix"
     ]
   },
   "exports": {
@@ -74,7 +74,7 @@
     }
   },
   "dependencies": {
-    "@laboverwire/stitch-wasm": "^0.6.0"
+    "@laboverwire/stitch-wasm": "^0.6.2"
   },
   "peerDependencies": {
     "react": "^19.0.0",
@@ -89,29 +89,25 @@
     }
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.18",
-    "@vitest/browser": "^4.1.11",
-    "@vitest/browser-playwright": "^4.1.11",
-    "@vitest/ui": "^4.1.11",
+    "@vitest/browser": "^5.0.5",
+    "@vitest/browser-playwright": "^5.0.5",
+    "@vitest/ui": "^5.0.5",
     "esbuild": "^0.28.1",
-    "eslint": "^10.8.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-react-hooks": "^7.1.1",
-    "globals": "^17.9.0",
     "husky": "^9.1.7",
-    "lint-staged": "^16.4.0",
+    "lint-staged": "^17.6.0",
+    "oxlint": "^1.89.0",
     "playwright": "^1.62.1",
     "prettier": "^3.9.6",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "rollup": "^4.62.4",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.66.0",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
     "vite-plugin-top-level-await": "^1.6.0",
     "vite-plugin-wasm": "^3.6.0",
-    "vitest": "^4.1.11",
+    "vitest": "^5.0.5",
     "vue": "^3.5.42"
   },
   "overrides": {