@rustra/react 0.7.0 → 0.7.1

package/README.md

@@ -19,5 +19,33 @@ function Item({ id }: { id: string }) {
 ```
 
 The package provides `RustraProvider`, `useRustraEngine`, `useCommand`,
-`useMutation`, and `useEvent`. React is a peer dependency; configure the
-platform-specific Rustra engine before rendering the provider.
+`useMutation`, `useEvent`, and `useSuspenseCommand`. React is a peer dependency;
+configure the platform-specific Rustra engine before rendering the provider.
+
+`useSuspenseCommand(commandFn, input?, options?)` is the Suspense-compatible read:
+it suspends by throwing the in-flight promise until the command resolves, then
+returns the value directly (a rejection is re-thrown to the nearest error
+boundary). Results live in a module-level cache keyed by command name + serialized
+input for the whole session — there is no eviction — so call
+`invalidateCommands(commandName?)` to drop one command's entries (or, with no
+argument, the whole cache) and make the next render re-invoke.
+
+```tsx
+import { Suspense } from 'react';
+import { invalidateCommands, useSuspenseCommand } from '@rustra/react';
+import { getItem, saveItem } from './generated/commands.js';
+
+function Item({ id }: { id: string }) {
+  const item = useSuspenseCommand(getItem, { id }); // suspends until resolved
+  return <span>{item.name}</span>;
+}
+
+async function rename(id: string, name: string) {
+  await saveItem({ id, name });
+  invalidateCommands('getItem'); // next render of <Item> re-fetches
+}
+
+<Suspense fallback={<span>Loading...</span>}>
+  <Item id="item-1" />
+</Suspense>;
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rustra/react",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "React and React Native bindings and hooks for rustra-bridge",
   "license": "MIT",
   "type": "module",
@@ -30,7 +30,7 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@rustra/types": "^0.8.0"
+    "@rustra/types": "^0.9.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",