@rustra/react 0.7.1 → 0.8.1

package/README.ko.md

@@ -0,0 +1,86 @@
+[English](./README.md) | 한국어
+
+# @rustra/react
+
+Rustra 명령 클라이언트를 위한 React 훅과 컨텍스트다. `RustraProvider`,
+`useRustraEngine`, `useCommand`, `useMutation`, `useEvent`, `useSuspenseCommand`,
+`invalidateCommands`, `configureSuspenseCache`를 제공한다. React는 peer dependency이며,
+Provider를 렌더링하기 전에 플랫폼별 엔진을 설정한다.
+
+```tsx
+import { RustraProvider, useCommand } from '@rustra/react';
+import { getItem } from './generated/commands.js';
+
+function Item({ id }: { id: string }) {
+  const { data, loading, error } = useCommand(getItem, { id });
+  if (loading) return <span>Loading...</span>;
+  if (error) return <span>{error.message}</span>;
+  return <span>{data?.name}</span>;
+}
+
+<RustraProvider engine={engine}>
+  <Item id="item-1" />
+</RustraProvider>;
+```
+
+`useSuspenseCommand(commandFn, input?, options?)`는 대기 중 Promise를 던지고 완료 값을
+직접 반환한다. 실패는 가장 가까운 오류 경계로 전달한다. 캐시는 Provider의
+`EngineClient` 객체, 명령 이름, 구조화된 입력을 키로 삼는다. SSR 요청이나 계정마다
+별도 Provider 엔진을 사용한다. 하나의 엔진을 공유하면 캐시도 의도적으로 공유한다.
+Provider가 없으면 현재 전역 등록 범위를 공유하며, 등록 교체·해제 후 다음 렌더링은
+새 범위를 사용한다. 이전 콜백은 교체된 엔진을 호출할 수 없다. 동시 SSR 사용자에게는
+요청별 Provider가 필요하다.
+
+엔진당 최대 **256개** 항목을 유지한다. 완료 후 **5분**이 지나면 만료하고, 용량에
+도달하면 완료 항목 중 가장 오래 접근하지 않은 항목을 제거한다. 대기 Promise는
+Suspense 재시도를 위해 유지한다. 모든 슬롯이 대기 중이면 새 키 요청은 용량 오류를
+오류 경계로 전달한다. 대기 항목은 **30초** 후 reject되어 제거·만료할 수 있다.
+대기 제한은 엔진 작업 자체를 취소하지 않는다. 호출 옵션은 항목을 생성할 때만 적용한다.
+
+`configureSuspenseCache({ maxEntries, ttlMs, pendingTimeoutMs }, engine?)`는 한 엔진의
+정책을 바꾸고 기존 항목을 비운다. 엔진을 생략하면 전역 기본 범위를 설정한다. 값은
+양의 안전한 정수여야 하며, 시간 값은 2,147,483,647 ms 이하여야 한다. 대기 중 항목을
+무효화해도 기존 호출자의 Promise는 유지되지만, 늦은 완료가 캐시를 다시 채우지 않는다.
+
+- `invalidateCommands('getItem', engine)`: 해당 엔진의 정확한 명령 이름만 비운다.
+- `invalidateCommands(undefined, engine)`: 해당 엔진의 전체 캐시를 비운다.
+- `invalidateCommands('getItem')`: 살아 있는 모든 엔진에서 해당 명령을 비운다.
+- `invalidateCommands()`: 살아 있는 모든 캐시를 비운다.
+
+무효화와 만료는 다음 렌더링에 반영되며 스스로 렌더링을 발생시키지 않는다. 엔진은 약한
+참조로 유지하고, 캐시 결과에도 유한 보관 기간을 적용한다.
+
+```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 });
+  return <span>{item.name}</span>;
+}
+
+async function rename(id: string, name: string) {
+  await saveItem({ id, name });
+  invalidateCommands('getItem'); // 다음 렌더링에서 다시 조회
+}
+
+<Suspense fallback={<span>Loading...</span>}>
+  <Item id="item-1" />
+</Suspense>;
+```
+
+`useCommand`와 `useSuspenseCommand`는 일반 객체, 배열, bigint, Set, Map, Date,
+ArrayBuffer, 타입 지정 바이너리 뷰를 포함한 구조화된 입력을 지원한다. 키는 값의 타입과
+바이너리 내용을 구분한다. 일반 객체의 필드 순서는 무시하지만 Set/Map 반복 순서와
+바이너리 뷰 타입은 보존한다. 함수·symbol·순환 참조·미지원 클래스 인스턴스는
+TypeError로 거부한다. 엔진에는 원래 입력을 전달한다.
+
+`useMutation`은 엔진 또는 결정된 명령이 바뀌면 표시 상태를 초기화한다. 진행 중 호출은
+호출자에게 결과를 반환할 수 있지만 교체된 범위나 초기화·언마운트된 훅의 상태는
+갱신하지 않는다. 성공·오류·완료 콜백은 호출 시작 시 캡처하고, 초기화나 범위 변경 후
+완료하더라도 해당 호출에 귀속되어 실행한다. 중첩 호출은 현재 범위의 모든 호출이
+끝날 때까지 `loading`을 유지하고, 마지막 호출만 data/error를 갱신한다.
+
+`useEvent`는 동기·비동기 구독 해제 등록을 지원한다. 이벤트·구독자 교체 또는 언마운트 시
+이전 구독의 전달을 즉시 차단하며, 늦게 도착한 정리 함수는 한 번 실행한다.

package/README.md

@@ -1,3 +1,5 @@
+English | [한국어](./README.ko.md)
+
 # @rustra/react
 
 React hooks and context bindings for Rustra command clients.
@@ -19,16 +21,41 @@ function Item({ id }: { id: string }) {
 ```
 
 The package provides `RustraProvider`, `useRustraEngine`, `useCommand`,
-`useMutation`, `useEvent`, and `useSuspenseCommand`. React is a peer dependency;
+`useMutation`, `useEvent`, `useSuspenseCommand`, `invalidateCommands`, and
+`configureSuspenseCache`. 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.
+boundary). Results are keyed by the provider's `EngineClient` identity, command
+name, and structural input. Use a separate provider engine for every SSR request
+or account; sharing one engine intentionally shares its cache. Without a provider,
+all components share the current global registration scope. Replacing or disposing
+the registration creates a fresh scope on the next render; stale retained callbacks
+cannot invoke the replacement engine. Use a request-specific Provider for concurrent SSR users.
+
+Each engine keeps at most **256 entries**. Completed entries expire **5 minutes**
+after settlement; insertion at capacity evicts the least recently accessed settled
+entry. Pending promises are protected from eviction so Suspense retries reuse the
+same work. If all slots are pending, a new key throws a capacity error to the error
+boundary. A pending entry rejects after **30 seconds** and can then be evicted or
+expire. The cache deadline stops waiting; it does not cancel the underlying engine
+operation. Invocation options apply only when creating the entry.
+
+`configureSuspenseCache({ maxEntries, ttlMs, pendingTimeoutMs }, engine?)` changes
+one engine's policy and clears its existing entries; omit the engine to configure
+the global default scope. Values must be positive safe integers (time values at
+most 2,147,483,647 ms). Explicitly invalidating pending work leaves its promise
+intact for current callers, but late completion never repopulates the cache.
+
+- `invalidateCommands('getItem', engine)` clears that exact command in one engine.
+- `invalidateCommands(undefined, engine)` clears one engine's entire cache.
+- `invalidateCommands('getItem')` clears that exact command across live engines.
+- `invalidateCommands()` clears every live cache.
+
+Invalidation and expiry take effect on the next render; neither triggers a render
+by itself. Engines are weakly held, and cached results also have finite retention.
 
 ```tsx
 import { Suspense } from 'react';
@@ -49,3 +76,21 @@ async function rename(id: string, name: string) {
   <Item id="item-1" />
 </Suspense>;
 ```
+
+`useCommand` and `useSuspenseCommand` accept structural inputs containing plain
+records, arrays, bigint, Set, Map, Date, ArrayBuffer, and typed binary views. Keys
+include value types and binary contents; plain-record field order is ignored,
+while Set/Map iteration order and binary view types are preserved. Functions,
+symbols, cyclic structures, and unsupported class instances are rejected with a
+TypeError instead of silently colliding. The engine receives the original input.
+
+`useMutation` resets visible state when its engine or resolved command changes.
+An in-flight call can still settle and return to its caller, but it cannot update
+a replacement scope or a reset/unmounted hook. Success/error/settled callbacks
+are captured at invocation time and still belong to that invocation, including
+when it settles after a reset or scope change. Overlapping calls keep `loading`
+true until all current-scope calls settle; only the latest call updates data/error.
+
+`useEvent` accepts synchronous or asynchronous unsubscribe registration. Replacing
+an event/subscriber or unmounting immediately disables delivery from the old
+subscription. A cleanup function that arrives afterward is invoked once.

package/dist/context.d.ts

@@ -9,6 +9,8 @@ export interface RustraProviderProps {
  * Provides a scoped Rustra `EngineClient` to component subtree.
  */
 export declare function RustraProvider({ engine, children }: RustraProviderProps): React.ReactElement;
+/** Shared by components and Suspense retries within one global registration. */
+export declare function getDefaultEngine(): EngineClient;
 /**
  * Returns the currently active `EngineClient`, either from `<RustraProvider>` or
  * a default engine invoking the global `invoke` singleton.

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAKjE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAE5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAS9C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAKjE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAE5F;AAKD,gFAAgF;AAChF,wBAAgB,gBAAgB,IAAI,YAAY,CAmB/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}

package/dist/context.js

@@ -1,5 +1,5 @@
-import React, { createContext, useContext, useMemo } from 'react';
-import { invoke } from '@rustra/types';
+import React, { createContext, useContext } from 'react';
+import { getEngineRegistrationToken, invoke, RustraCommandError } from '@rustra/types';
 const RustraContext = createContext(null);
 /**
  * Provides a scoped Rustra `EngineClient` to component subtree.
@@ -7,18 +7,29 @@ const RustraContext = createContext(null);
 export function RustraProvider({ engine, children }) {
     return React.createElement(RustraContext.Provider, { value: engine }, children);
 }
+let defaultEngine;
+let defaultRegistration;
+/** Shared by components and Suspense retries within one global registration. */
+export function getDefaultEngine() {
+    const registration = getEngineRegistrationToken();
+    if (!defaultEngine || registration !== defaultRegistration) {
+        defaultRegistration = registration;
+        defaultEngine = {
+            invoke: (command, args, options) => {
+                if (registration !== getEngineRegistrationToken()) {
+                    return Promise.reject(new RustraCommandError('transport.unavailable', 'The global engine was replaced; render with the current engine before invoking'));
+                }
+                return invoke(command, args, options);
+            },
+        };
+    }
+    return defaultEngine;
+}
 /**
  * Returns the currently active `EngineClient`, either from `<RustraProvider>` or
  * a default engine invoking the global `invoke` singleton.
  */
 export function useRustraEngine() {
-    const contextEngine = useContext(RustraContext);
-    return useMemo(() => {
-        if (contextEngine)
-            return contextEngine;
-        return {
-            invoke: (command, args, options) => invoke(command, args, options),
-        };
-    }, [contextEngine]);
+    return useContext(RustraContext) ?? getDefaultEngine();
 }
 //# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAElF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,aAAa,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAC;AAQ/D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAuB;IACtE,OAAO,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,aAAa;YAAE,OAAO,aAAa,CAAC;QACxC,OAAO;YACL,MAAM,EAAE,CAAI,OAAe,EAAE,IAAc,EAAE,OAAuB,EAAc,EAAE,CAClF,MAAM,CAAI,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;SACpC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;AACtB,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAEzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,aAAa,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAC;AAQ/D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAuB;IACtE,OAAO,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED,IAAI,aAAuC,CAAC;AAC5C,IAAI,mBAAuC,CAAC;AAE5C,gFAAgF;AAChF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,YAAY,GAAG,0BAA0B,EAAE,CAAC;IAClD,IAAI,CAAC,aAAa,IAAI,YAAY,KAAK,mBAAmB,EAAE,CAAC;QAC3D,mBAAmB,GAAG,YAAY,CAAC;QACnC,aAAa,GAAG;YACd,MAAM,EAAE,CAAI,OAAe,EAAE,IAAc,EAAE,OAAuB,EAAc,EAAE;gBAClF,IAAI,YAAY,KAAK,0BAA0B,EAAE,EAAE,CAAC;oBAClD,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,kBAAkB,CACpB,uBAAuB,EACvB,gFAAgF,CACjF,CACF,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,CAAI,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,aAAa,CAAC,IAAI,gBAAgB,EAAE,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -26,8 +26,8 @@ export { useCommand } from './useCommand.js';
 export type { UseCommandOptions, UseCommandResult, CommandFn, VoidCommandFn, } from './useCommand.js';
 export { useMutation } from './useMutation.js';
 export type { UseMutationOptions, UseMutationResult } from './useMutation.js';
-export { useSuspenseCommand, invalidateCommands } from './useSuspenseCommand.js';
-export type { SuspenseEntry } from './useSuspenseCommand.js';
+export { useSuspenseCommand, invalidateCommands, configureSuspenseCache, } from './useSuspenseCommand.js';
+export type { SuspenseEntry, SuspenseCacheOptions } from './useSuspenseCommand.js';
 export { useEvent } from './useEvent.js';
 export type { EventCallback, UnsubscribeFn, SubscribeResult, SubscribeFn } from './useEvent.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -23,6 +23,6 @@
 export { RustraProvider, useRustraEngine } from './context.js';
 export { useCommand } from './useCommand.js';
 export { useMutation } from './useMutation.js';
-export { useSuspenseCommand, invalidateCommands } from './useSuspenseCommand.js';
+export { useSuspenseCommand, invalidateCommands, configureSuspenseCache, } from './useSuspenseCommand.js';
 export { useEvent } from './useEvent.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGjF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/input-key.d.ts

@@ -1,9 +1,8 @@
 /**
- * Creates a render-stable key for command inputs.
- *
- * JSON.stringify throws for bigint values, which are a normal generated type
- * for Rust i64/u64 fields. The tagged representation also avoids conflating a
- * bigint with the same decimal string.
+ * Structural, type-tagged identity for supported command inputs. Tags are outside
+ * user objects, so a record cannot impersonate a bigint, Set, or binary value.
+ * Object keys are canonicalized; Map/Set iteration order and binary view type
+ * are preserved because the original input is passed unchanged to the engine.
  */
 export declare function inputKey(value: unknown): string;
 //# sourceMappingURL=input-key.d.ts.map

package/dist/input-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-key.d.ts","sourceRoot":"","sources":["../src/input-key.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C"}
+{"version":3,"file":"input-key.d.ts","sourceRoot":"","sources":["../src/input-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2D/C"}

package/dist/input-key.js

@@ -1,11 +1,69 @@
 /**
- * Creates a render-stable key for command inputs.
- *
- * JSON.stringify throws for bigint values, which are a normal generated type
- * for Rust i64/u64 fields. The tagged representation also avoids conflating a
- * bigint with the same decimal string.
+ * Structural, type-tagged identity for supported command inputs. Tags are outside
+ * user objects, so a record cannot impersonate a bigint, Set, or binary value.
+ * Object keys are canonicalized; Map/Set iteration order and binary view type
+ * are preserved because the original input is passed unchanged to the engine.
  */
 export function inputKey(value) {
-    return (JSON.stringify(value, (_key, item) => typeof item === 'bigint' ? { $rustraBigInt: item.toString() } : item) ?? String(value));
+    const ancestors = new Set();
+    function encode(item) {
+        if (item === null)
+            return ['null'];
+        switch (typeof item) {
+            case 'undefined':
+                return ['undefined'];
+            case 'string':
+                return ['string', item];
+            case 'boolean':
+                return ['boolean', item];
+            case 'bigint':
+                return ['bigint', item.toString()];
+            case 'number':
+                return ['number', Object.is(item, -0) ? '-0' : String(item)];
+            case 'function':
+            case 'symbol':
+                throw new TypeError('Rustra command inputs cannot contain functions or symbols');
+        }
+        if (ancestors.has(item))
+            throw new TypeError('Rustra command inputs cannot contain cycles');
+        ancestors.add(item);
+        try {
+            if (item instanceof ArrayBuffer || ArrayBuffer.isView(item)) {
+                const bytes = item instanceof ArrayBuffer
+                    ? new Uint8Array(item)
+                    : new Uint8Array(item.buffer, item.byteOffset, item.byteLength);
+                return ['binary', Object.prototype.toString.call(item), Array.from(bytes)];
+            }
+            if (item instanceof Date)
+                return ['date', item.toISOString()];
+            if (item instanceof Set)
+                return ['set', Array.from(item, encode)];
+            if (item instanceof Map)
+                return ['map', Array.from(item, ([key, value]) => [encode(key), encode(value)])];
+            if (Array.isArray(item)) {
+                return [
+                    'array',
+                    Array.from({ length: item.length }, (_, index) => index in item ? encode(item[index]) : ['hole']),
+                ];
+            }
+            const prototype = Object.getPrototypeOf(item);
+            if (prototype !== Object.prototype && prototype !== null) {
+                throw new TypeError('Rustra command inputs must use supported values or plain records');
+            }
+            if (Object.getOwnPropertySymbols(item).length > 0) {
+                throw new TypeError('Rustra command inputs cannot contain symbol keys');
+            }
+            return [
+                'object',
+                Object.keys(item)
+                    .sort()
+                    .map((key) => [key, encode(item[key])]),
+            ];
+        }
+        finally {
+            ancestors.delete(item);
+        }
+    }
+    return JSON.stringify(encode(value));
 }
 //# sourceMappingURL=input-key.js.map

package/dist/input-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-key.js","sourceRoot":"","sources":["../src/input-key.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE,CAC5C,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACrE,IAAI,MAAM,CAAC,KAAK,CAAC,CACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"input-key.js","sourceRoot":"","sources":["../src/input-key.ts"],"names":[],"mappings":"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"}

package/dist/suspense-cache.d.ts

@@ -0,0 +1,22 @@
+import type { EngineClient } from '@rustra/types';
+export interface SuspenseEntry<O = unknown> {
+    commandName: string;
+    promise: Promise<O>;
+    status: 'pending' | 'fulfilled' | 'rejected';
+    value?: O;
+    error?: unknown;
+}
+export interface SuspenseCacheOptions {
+    /** Maximum total entries per engine. Default: 256. */
+    maxEntries?: number;
+    /** Retention after settlement, in milliseconds. Default: 300000 (5 minutes). */
+    ttlMs?: number;
+    /** Maximum time a cached request can remain pending. Default: 30000. */
+    pendingTimeoutMs?: number;
+}
+/** Configure one engine's finite cache policy and discard its existing entries. */
+export declare function configureSuspenseCache(options: SuspenseCacheOptions, engine?: EngineClient): void;
+/** With an engine, invalidate only that scope; without one, all live scopes. */
+export declare function invalidateCommands(commandName?: string, engine?: EngineClient): void;
+export declare function resolveSuspenseEntry<O>(key: string, commandName: string, start: () => Promise<O>, engine?: EngineClient): SuspenseEntry<O>;
+//# sourceMappingURL=suspense-cache.d.ts.map

package/dist/suspense-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspense-cache.d.ts","sourceRoot":"","sources":["../src/suspense-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAsCD,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,eAAqB,GAC1B,IAAI,CAgBN;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAWpF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACvB,MAAM,GAAE,YAAiC,GACxC,aAAa,CAAC,CAAC,CAAC,CA0DlB"}

package/dist/suspense-cache.js

@@ -0,0 +1,117 @@
+import { getDefaultEngine } from './context.js';
+const defaults = { maxEntries: 256, ttlMs: 300_000, pendingTimeoutMs: 30_000 };
+const caches = new WeakMap();
+// Weak references preserve the legacy cross-engine invalidation API without
+// retaining an engine (or its data) after its owner is gone.
+const liveCaches = new Set();
+function getCache(engine) {
+    let cache = caches.get(engine);
+    if (!cache) {
+        cache = { entries: new Map(), policy: { ...defaults } };
+        caches.set(engine, cache);
+        for (const reference of liveCaches)
+            if (!reference.deref())
+                liveCaches.delete(reference);
+        liveCaches.add(new WeakRef(cache));
+    }
+    return cache;
+}
+function remove(cache, key) {
+    const record = cache.entries.get(key);
+    if (record?.expiry)
+        clearTimeout(record.expiry);
+    cache.entries.delete(key);
+}
+function invalidate(cache, commandName) {
+    for (const [key, record] of cache.entries) {
+        if (commandName === undefined || record.entry.commandName === commandName)
+            remove(cache, key);
+    }
+}
+/** Configure one engine's finite cache policy and discard its existing entries. */
+export function configureSuspenseCache(options, engine = getDefaultEngine()) {
+    const policy = { ...defaults, ...options };
+    for (const [name, value] of Object.entries(policy)) {
+        if (!Number.isSafeInteger(value) ||
+            value < 1 ||
+            (name !== 'maxEntries' && value > 2_147_483_647)) {
+            throw new RangeError(`Rustra suspense cache ${name} must be a positive safe integer within timer limits`);
+        }
+    }
+    const cache = getCache(engine);
+    invalidate(cache);
+    cache.policy = policy;
+}
+/** With an engine, invalidate only that scope; without one, all live scopes. */
+export function invalidateCommands(commandName, engine) {
+    if (engine) {
+        const cache = caches.get(engine);
+        if (cache)
+            invalidate(cache, commandName);
+        return;
+    }
+    for (const reference of liveCaches) {
+        const cache = reference.deref();
+        if (cache)
+            invalidate(cache, commandName);
+        else
+            liveCaches.delete(reference);
+    }
+}
+export function resolveSuspenseEntry(key, commandName, start, engine = getDefaultEngine()) {
+    const cache = getCache(engine);
+    const now = Date.now();
+    for (const [candidate, record] of cache.entries) {
+        if (record.entry.status !== 'pending' && record.expiresAt <= now)
+            remove(cache, candidate);
+    }
+    const existing = cache.entries.get(key);
+    if (existing) {
+        cache.entries.delete(key);
+        cache.entries.set(key, existing);
+        return existing.entry;
+    }
+    if (cache.entries.size >= cache.policy.maxEntries) {
+        const evictable = [...cache.entries].find(([, record]) => record.entry.status !== 'pending');
+        if (evictable)
+            remove(cache, evictable[0]);
+        else
+            throw new Error('Rustra suspense cache capacity reached while all requests are pending');
+    }
+    let timeout;
+    const deadline = new Promise((_, reject) => {
+        timeout = setTimeout(() => reject(new Error('Rustra suspense command timed out')), cache.policy.pendingTimeoutMs);
+    });
+    let invocation;
+    try {
+        invocation = start();
+    }
+    catch (error) {
+        invocation = Promise.reject(error);
+    }
+    const promise = Promise.race([invocation, deadline]);
+    const entry = { commandName, promise, status: 'pending' };
+    const record = { entry, expiresAt: Infinity };
+    cache.entries.set(key, record);
+    function settled() {
+        clearTimeout(timeout);
+        // Invalidated requests still settle for their callers but never reinsert.
+        if (cache.entries.get(key) !== record)
+            return;
+        record.expiresAt = Date.now() + cache.policy.ttlMs;
+        record.expiry = setTimeout(() => remove(cache, key), cache.policy.ttlMs);
+        // Node SSR must not remain alive solely for cache retention.
+        record.expiry.unref?.();
+    }
+    promise.then((value) => {
+        entry.status = 'fulfilled';
+        entry.value = value;
+        settled();
+    }, (error) => {
+        entry.status = 'rejected';
+        entry.error = error instanceof Error ? error : new Error(String(error));
+        settled();
+    });
+    return entry;
+}
+//# sourceMappingURL=suspense-cache.js.map

package/dist/suspense-cache.js.map

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

package/dist/useEvent.js

@@ -19,7 +19,8 @@ export function useEvent(eventName, callback, subscribe) {
         let result;
         try {
             result = subscribe(eventName, (payload) => {
-                callbackRef.current(payload);
+                if (active)
+                    callbackRef.current(payload);
             });
         }
         catch (error) {

package/dist/useEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"useEvent.js","sourceRoot":"","sources":["../src/useEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAU1C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,QAA0B,EAC1B,SAA0B;IAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,WAAsC,CAAC;QAC3C,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBACxC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9E,OAAO,GAAG,EAAE;gBACV,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAC1B,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,MAAM;gBAAE,WAAW,GAAG,OAAO,CAAC;;gBAC7B,OAAO,EAAE,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,mCAAmC,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC;YAChF,CAAC;QACH,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;YACf,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"useEvent.js","sourceRoot":"","sources":["../src/useEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAU1C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,QAA0B,EAC1B,SAA0B;IAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,WAAsC,CAAC;QAC3C,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBACxC,IAAI,MAAM;oBAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9E,OAAO,GAAG,EAAE;gBACV,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAC1B,CAAC,OAAO,EAAE,EAAE;YACV,IAAI,MAAM;gBAAE,WAAW,GAAG,OAAO,CAAC;;gBAC7B,OAAO,EAAE,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,mCAAmC,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC;YAChF,CAAC;QACH,CAAC,CACF,CAAC;QACF,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;YACf,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/useMutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMutation.d.ts","sourceRoot":"","sources":["../src/useMutation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,EAC/C,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CA+EzB"}
+{"version":3,"file":"useMutation.d.ts","sourceRoot":"","sources":["../src/useMutation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,kBAAkB,CAAC,CAAC,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC1E;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3B,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,EAC/C,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAqGzB"}

package/dist/useMutation.js

@@ -1,71 +1,95 @@
-import { useState, useCallback, useEffect, useRef } from 'react';
+import { useState, useCallback, useEffect, useInsertionEffect, useMemo } from 'react';
 import { resolveCommandId } from '@rustra/types';
 import { useRustraEngine } from './context.js';
 export function useMutation(commandFn, options) {
     const engine = useRustraEngine();
-    const [data, setData] = useState(undefined);
-    const [loading, setLoading] = useState(false);
-    const [error, setError] = useState(null);
-    // minify-안전 식별: 코드젠이 심은 commandId 를 우선한다 (Function.name 은
-    // 프로덕션 번들러 mangling 으로 바뀔 수 있다).
     const commandName = resolveCommandId(commandFn);
-    const optionsRef = useRef(options);
-    const latestCallRef = useRef(0);
-    const pendingCallsRef = useRef(0);
-    const generationRef = useRef(0);
+    // Each engine/command pair owns its counters and callback snapshot. Retained
+    // async functions cannot borrow a replacement scope's callbacks or state.
+    const scope = useMemo(() => ({
+        engine,
+        commandName,
+        active: true,
+        generation: 0,
+        latestCall: 0,
+        pendingCalls: 0,
+        options: undefined,
+    }), [engine, commandName]);
+    const emptyState = {
+        scope,
+        data: undefined,
+        loading: false,
+        error: null,
+    };
+    const [state, setState] = useState(emptyState);
+    if (state.scope !== scope)
+        setState(emptyState);
+    // Publish only committed options, before any descendant layout effect can
+    // invoke the stable mutation function. Render-time writes leak aborted renders.
+    useInsertionEffect(() => {
+        scope.options = options;
+    }, [scope, options]);
     useEffect(() => {
-        optionsRef.current = options;
-    }, [options]);
+        scope.active = true;
+        return () => {
+            scope.active = false;
+            scope.generation += 1;
+            scope.pendingCalls = 0;
+        };
+    }, [scope]);
     const mutateAsync = useCallback(async (input, invokeOptions) => {
-        const generation = generationRef.current;
-        const callId = ++latestCallRef.current;
-        pendingCallsRef.current += 1;
-        setLoading(true);
-        setError(null);
+        const generation = scope.generation;
+        const callId = ++scope.latestCall;
+        const callbacks = scope.options;
+        const isCurrent = () => scope.active && scope.generation === generation;
+        const update = (changes) => {
+            if (!isCurrent())
+                return;
+            setState((current) => (current.scope === scope ? { ...current, ...changes } : current));
+        };
+        scope.pendingCalls += 1;
+        update({ loading: true, error: null });
         let result;
         try {
-            result = await engine.invoke(commandName, input, invokeOptions);
+            result = await scope.engine.invoke(scope.commandName, input, invokeOptions);
         }
         catch (err) {
             const parsedError = err instanceof Error ? err : new Error(String(err));
-            if (generationRef.current === generation && latestCallRef.current === callId) {
-                setError(parsedError);
-            }
-            optionsRef.current?.onError?.(parsedError, input);
-            optionsRef.current?.onSettled?.(undefined, parsedError, input);
+            if (scope.latestCall === callId)
+                update({ error: parsedError });
+            callbacks?.onError?.(parsedError, input);
+            callbacks?.onSettled?.(undefined, parsedError, input);
             throw parsedError;
         }
         finally {
-            if (generationRef.current === generation) {
-                pendingCallsRef.current = Math.max(0, pendingCallsRef.current - 1);
-                setLoading(pendingCallsRef.current > 0);
+            if (isCurrent()) {
+                scope.pendingCalls = Math.max(0, scope.pendingCalls - 1);
+                update({ loading: scope.pendingCalls > 0 });
             }
         }
-        if (generationRef.current === generation && latestCallRef.current === callId) {
-            setData(result);
-        }
-        optionsRef.current?.onSuccess?.(result, input);
-        optionsRef.current?.onSettled?.(result, null, input);
+        if (scope.latestCall === callId)
+            update({ data: result });
+        callbacks?.onSuccess?.(result, input);
+        callbacks?.onSettled?.(result, null, input);
         return result;
-    }, [engine, commandName]);
+    }, [scope]);
     const mutate = useCallback((input) => {
         mutateAsync(input).catch(() => {
             // Handled in mutateAsync state & onError callback
         });
     }, [mutateAsync]);
     const reset = useCallback(() => {
-        generationRef.current += 1;
-        pendingCallsRef.current = 0;
-        setData(undefined);
-        setError(null);
-        setLoading(false);
-    }, []);
+        scope.generation += 1;
+        scope.pendingCalls = 0;
+        setState((current) => current.scope === scope ? { scope, data: undefined, error: null, loading: false } : current);
+    }, [scope]);
+    const current = state.scope === scope ? state : emptyState;
     return {
         mutate,
         mutateAsync,
-        data,
-        loading,
-        error,
+        data: current.data,
+        loading: current.loading,
+        error: current.error,
         reset,
     };
 }

package/dist/useMutation.js.map

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

package/dist/useSuspenseCommand.d.ts

@@ -1,50 +1,11 @@
 import type { InvokeOptions } from '@rustra/types';
 import type { CommandFn, VoidCommandFn } from './useCommand.js';
+export { resolveSuspenseEntry, invalidateCommands, configureSuspenseCache, } from './suspense-cache.js';
+export type { SuspenseEntry, SuspenseCacheOptions } from './suspense-cache.js';
 /**
- * Cache entry state machine — `pending` until the in-flight promise settles,
- * then `fulfilled` (value stored) or `rejected` (error stored).
- */
-export interface SuspenseEntry<O = unknown> {
-    /** Owning command — `invalidateCommands` matches this field, not the key prefix. */
-    commandName: string;
-    promise: Promise<O>;
-    status: 'pending' | 'fulfilled' | 'rejected';
-    value?: O;
-    error?: unknown;
-}
-/**
- * Pure cache state machine: returns the existing entry for `key` when present,
- * otherwise creates one by invoking `start()` and drives it to its terminal
- * state. Settling updates the entry in place, so later accessors read the
- * cached value/error without re-invoking. Rejections are normalized to `Error`
- * (matching `useCommand`/`useMutation`); the stored object is re-thrown as-is.
- *
- * Exported for testing — the hook stays thin, and this is testable without
- * React (a thrown promise is awkward to exercise under SSR renderToString).
- */
-export declare function resolveSuspenseEntry<O>(key: string, commandName: string, start: () => Promise<O>): SuspenseEntry<O>;
-/**
- * Invalidate cached suspense entries.
- *
- * - `invalidateCommands('getItem')` — drop only that command's entries,
- *   matched by the entry's owning command (exact, so command names containing
- *   `::` cannot be over-matched by a shorter prefix).
- * - `invalidateCommands()` — drop every cached entry.
- *
- * Works outside components (module-level cache), e.g. after a mutation.
- */
-export declare function invalidateCommands(commandName?: string): void;
-/**
- * Suspense-compatible command hook. Must be called under a Suspense boundary.
- *
- * First call starts the invocation and throws the in-flight promise —
- * thrown-thenable Suspense on React 18, `use` on React 19. Once settled,
- * subsequent calls return the cached value. A rejected invocation re-throws
- * the same stored error object on every access (error boundary contract) until
- * `invalidateCommands` clears it.
- *
- * `options` are honored only on the first invocation per key; later calls
- * reuse the cached promise.
+ * Suspends until an engine-scoped command result is ready. Inputs are structurally
+ * keyed; options apply only to the first invocation of a cached key. Rejected
+ * results reach the nearest error boundary until invalidation or expiry.
  */
 export declare function useSuspenseCommand<I, O>(commandFn: CommandFn<I, O> | VoidCommandFn<O>, input?: I, options?: InvokeOptions): O;
 //# sourceMappingURL=useSuspenseCommand.d.ts.map

package/dist/useSuspenseCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSuspenseCommand.d.ts","sourceRoot":"","sources":["../src/useSuspenseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,oFAAoF;IACpF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAeD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACtB,aAAa,CAAC,CAAC,CAAC,CAmBlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACrC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,KAAK,CAAC,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,aAAa,GACtB,CAAC,CAYH"}
+{"version":3,"file":"useSuspenseCommand.d.ts","sourceRoot":"","sources":["../src/useSuspenseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIhE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EACrC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,KAAK,CAAC,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,aAAa,GACtB,CAAC,CAYH"}

package/dist/useSuspenseCommand.js

@@ -1,81 +1,17 @@
 import { resolveCommandId } from '@rustra/types';
 import { useRustraEngine } from './context.js';
 import { inputKey } from './input-key.js';
+import { resolveSuspenseEntry } from './suspense-cache.js';
+export { resolveSuspenseEntry, invalidateCommands, configureSuspenseCache, } from './suspense-cache.js';
 /**
- * Module-level suspense cache. Key is the resolved command name followed by
- * `::` and the serialized input — an absent input collapses to the bare
- * `commandName + '::'` suffix, otherwise `inputKey(input)` (bigint-safe).
- *
- * No eviction policy by design (YAGNI) — entries live for the session.
- */
-const cache = new Map();
-function cacheKey(commandName, input) {
-    return `${commandName}::${input === undefined ? '' : inputKey(input)}`;
-}
-/**
- * Pure cache state machine: returns the existing entry for `key` when present,
- * otherwise creates one by invoking `start()` and drives it to its terminal
- * state. Settling updates the entry in place, so later accessors read the
- * cached value/error without re-invoking. Rejections are normalized to `Error`
- * (matching `useCommand`/`useMutation`); the stored object is re-thrown as-is.
- *
- * Exported for testing — the hook stays thin, and this is testable without
- * React (a thrown promise is awkward to exercise under SSR renderToString).
- */
-export function resolveSuspenseEntry(key, commandName, start) {
-    const existing = cache.get(key);
-    if (existing)
-        return existing;
-    const promise = start();
-    const entry = { commandName, promise, status: 'pending' };
-    cache.set(key, entry);
-    promise.then((value) => {
-        entry.status = 'fulfilled';
-        entry.value = value;
-    }, (err) => {
-        entry.status = 'rejected';
-        entry.error = err instanceof Error ? err : new Error(String(err));
-    });
-    return entry;
-}
-/**
- * Invalidate cached suspense entries.
- *
- * - `invalidateCommands('getItem')` — drop only that command's entries,
- *   matched by the entry's owning command (exact, so command names containing
- *   `::` cannot be over-matched by a shorter prefix).
- * - `invalidateCommands()` — drop every cached entry.
- *
- * Works outside components (module-level cache), e.g. after a mutation.
- */
-export function invalidateCommands(commandName) {
-    if (commandName === undefined) {
-        cache.clear();
-        return;
-    }
-    for (const [key, entry] of cache) {
-        if (entry.commandName === commandName)
-            cache.delete(key);
-    }
-}
-/**
- * Suspense-compatible command hook. Must be called under a Suspense boundary.
- *
- * First call starts the invocation and throws the in-flight promise —
- * thrown-thenable Suspense on React 18, `use` on React 19. Once settled,
- * subsequent calls return the cached value. A rejected invocation re-throws
- * the same stored error object on every access (error boundary contract) until
- * `invalidateCommands` clears it.
- *
- * `options` are honored only on the first invocation per key; later calls
- * reuse the cached promise.
+ * Suspends until an engine-scoped command result is ready. Inputs are structurally
+ * keyed; options apply only to the first invocation of a cached key. Rejected
+ * results reach the nearest error boundary until invalidation or expiry.
  */
 export function useSuspenseCommand(commandFn, input, options) {
     const engine = useRustraEngine();
-    // minify-안전 식별: 코드젠이 심은 commandId 를 우선한다 (Function.name 은
-    // 프로덕션 번들러 mangling 으로 바뀔 수 있다).
     const commandName = resolveCommandId(commandFn);
-    const entry = resolveSuspenseEntry(cacheKey(commandName, input), commandName, () => engine.invoke(commandName, input, options));
+    const entry = resolveSuspenseEntry(JSON.stringify([commandName, inputKey(input)]), commandName, () => engine.invoke(commandName, input, options), engine);
     if (entry.status === 'pending')
         throw entry.promise;
     if (entry.status === 'rejected')

package/dist/useSuspenseCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSuspenseCommand.js","sourceRoot":"","sources":["../src/useSuspenseCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAe1C;;;;;;GAMG;AACH,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;AAE/C,SAAS,QAAQ,CAAC,WAAmB,EAAE,KAAc;IACnD,OAAO,GAAG,WAAW,KAAK,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAW,EACX,WAAmB,EACnB,KAAuB;IAEvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,QAAQ;QAAE,OAAO,QAA4B,CAAC;IAElD,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;IACxB,MAAM,KAAK,GAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC5E,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEtB,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;QACR,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;QACf,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;QAC1B,KAAK,CAAC,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC,CACF,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA6C,EAC7C,KAAS,EACT,OAAuB;IAEvB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,0DAA0D;IAC1D,iCAAiC;IACjC,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,oBAAoB,CAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CACpF,MAAM,CAAC,MAAM,CAAI,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAC9C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,OAAO,CAAC;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;QAAE,MAAM,KAAK,CAAC,KAAK,CAAC;IACnD,OAAO,KAAK,CAAC,KAAU,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"useSuspenseCommand.js","sourceRoot":"","sources":["../src/useSuspenseCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA6C,EAC7C,KAAS,EACT,OAAuB;IAEvB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAC9C,WAAW,EACX,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAI,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,EACnD,MAAM,CACP,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,OAAO,CAAC;IACpD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;QAAE,MAAM,KAAK,CAAC,KAAK,CAAC;IACnD,OAAO,KAAK,CAAC,KAAU,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rustra/react",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "React and React Native bindings and hooks for rustra-bridge",
   "license": "MIT",
   "type": "module",
@@ -23,19 +23,23 @@
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
-    "test": "bun test src/index.test.ts",
+    "test": "bun test ./src/index.test.ts ./src/suspense-lifecycle.test.ts && bun test ./src/lifecycle.test.ts",
     "test:compile": "tsc -p tsconfig.test.json"
   },
   "peerDependencies": {
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@rustra/types": "^0.9.0"
+    "@rustra/types": "^0.11.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
-    "react": "^19.0.0",
-    "typescript": "^5.9.0"
+    "react": "19.2.8",
+    "typescript": "^5.9.0",
+    "react-dom": "19.2.8",
+    "@types/react-dom": "^19.0.0",
+    "react-test-renderer": "19.2.8",
+    "@types/react-test-renderer": "^19.0.0"
   },
   "keywords": [
     "rustra",