@rustra/react 0.1.3

package/README.md

@@ -0,0 +1,23 @@
+# @rustra/react
+
+React hooks and context bindings for Rustra command clients.
+
+```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>;
+```
+
+The package provides `RustraProvider`, `useRustraEngine`, `useCommand`,
+`useMutation`, and `useEvent`. React is a peer dependency; configure the
+platform-specific Rustra engine before rendering the provider.

package/dist/context.d.ts

@@ -0,0 +1,16 @@
+import React, { type ReactNode } from 'react';
+import type { EngineClient } from '@rustra/types';
+export interface RustraProviderProps {
+    engine: EngineClient;
+    children: ReactNode;
+}
+/**
+ * Provides a scoped Rustra `EngineClient` to component subtree.
+ */
+export declare function RustraProvider({ engine, children }: RustraProviderProps): React.ReactElement;
+/**
+ * Returns the currently active `EngineClient`, either from `<RustraProvider>` or
+ * a default engine invoking the global `invoke` singleton.
+ */
+export declare function useRustraEngine(): EngineClient;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +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,QAAQ,EAAE,SAAS,CAAC;CACrB;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"}

package/dist/context.js

@@ -0,0 +1,24 @@
+import React, { createContext, useContext, useMemo } from 'react';
+import { invoke } from '@rustra/types';
+const RustraContext = createContext(null);
+/**
+ * Provides a scoped Rustra `EngineClient` to component subtree.
+ */
+export function RustraProvider({ engine, children }) {
+    return React.createElement(RustraContext.Provider, { value: engine }, children);
+}
+/**
+ * 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]);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +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;AAO/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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @rustra/react — React and React Native hooks for rustra-bridge.
+ *
+ * Provides declarative data fetching (`useCommand`), mutations (`useMutation`),
+ * event subscriptions (`useEvent`), and scoped engine context (`RustraProvider`).
+ *
+ * @example
+ * ```tsx
+ * import { RustraProvider, useCommand, useMutation } from '@rustra/react';
+ * import { getItem, createItem } from './generated/commands.js';
+ *
+ * function ItemView({ id }: { id: string }) {
+ *   const { data, loading, error, refetch } = useCommand(getItem, { id });
+ *   const { mutate, loading: creating } = useMutation(createItem, {
+ *     onSuccess: () => refetch(),
+ *   });
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   return <div>{data?.item?.name}</div>;
+ * }
+ * ```
+ */
+export { RustraProvider, useRustraEngine } from './context.js';
+export type { RustraProviderProps } from './context.js';
+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 { useEvent } from './useEvent.js';
+export type { EventCallback, UnsubscribeFn, SubscribeFn } from './useEvent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @rustra/react — React and React Native hooks for rustra-bridge.
+ *
+ * Provides declarative data fetching (`useCommand`), mutations (`useMutation`),
+ * event subscriptions (`useEvent`), and scoped engine context (`RustraProvider`).
+ *
+ * @example
+ * ```tsx
+ * import { RustraProvider, useCommand, useMutation } from '@rustra/react';
+ * import { getItem, createItem } from './generated/commands.js';
+ *
+ * function ItemView({ id }: { id: string }) {
+ *   const { data, loading, error, refetch } = useCommand(getItem, { id });
+ *   const { mutate, loading: creating } = useMutation(createItem, {
+ *     onSuccess: () => refetch(),
+ *   });
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   return <div>{data?.item?.name}</div>;
+ * }
+ * ```
+ */
+export { RustraProvider, useRustraEngine } from './context.js';
+export { useCommand } from './useCommand.js';
+export { useMutation } from './useMutation.js';
+export { useEvent } from './useEvent.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,92 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createElement } from 'react';
+import { renderToString } from 'react-dom/server';
+import { RustraProvider, useRustraEngine, useCommand, useMutation, useEvent } from './index.js';
+function createTestEngine(dataMap) {
+    return {
+        async invoke(command, _args) {
+            if (command in dataMap) {
+                return dataMap[command];
+            }
+            throw new Error(`Command not found: ${command}`);
+        },
+    };
+}
+test('RustraProvider supplies engine to useRustraEngine', () => {
+    const engine = createTestEngine({ testCmd: 'hello' });
+    let capturedEngine = null;
+    function TestComponent() {
+        capturedEngine = useRustraEngine();
+        return createElement('div', null, 'test');
+    }
+    renderToString(createElement(RustraProvider, { engine, children: createElement(TestComponent) }));
+    assert.equal(capturedEngine, engine);
+});
+test('useCommand hook contract and properties', () => {
+    async function dummyCmd(input) {
+        return { res: input.val * 2 };
+    }
+    const hookResult = { current: null };
+    function TestComponent() {
+        const result = useCommand(dummyCmd, { val: 5 }, { enabled: false });
+        hookResult.current = result;
+        return createElement('div', null, String(result.loading));
+    }
+    const engine = createTestEngine({ dummyCmd: { res: 10 } });
+    renderToString(createElement(RustraProvider, { engine, children: createElement(TestComponent) }));
+    const result = hookResult.current;
+    assert.ok(result);
+    assert.equal(result.loading, false);
+    assert.equal(typeof result.refetch, 'function');
+});
+test('useMutation hook contract and execution', async () => {
+    async function updateItem(_input) {
+        return { updated: true };
+    }
+    const engine = createTestEngine({ updateItem: { updated: true } });
+    const mutationResult = { current: null };
+    function TestComponent() {
+        mutationResult.current = useMutation(updateItem);
+        return createElement('div', null, 'mutation');
+    }
+    renderToString(createElement(RustraProvider, { engine, children: createElement(TestComponent) }));
+    const result = mutationResult.current;
+    assert.ok(result);
+    assert.equal(typeof result.mutate, 'function');
+    assert.equal(typeof result.mutateAsync, 'function');
+    assert.equal(typeof result.reset, 'function');
+    // Execute mutation
+    const res = await result.mutateAsync({ id: 'item-1' });
+    assert.deepEqual(res, { updated: true });
+});
+test('useEvent handles subscription and contract', () => {
+    let subscribedName = '';
+    let unsubscribed = false;
+    let handlerCalledWith = null;
+    const mockSubscriber = (name, cb) => {
+        subscribedName = name;
+        cb({ count: 1 });
+        return () => {
+            unsubscribed = true;
+        };
+    };
+    function TestComponent() {
+        useEvent('tick', (payload) => {
+            handlerCalledWith = payload;
+        }, mockSubscriber);
+        return createElement('div', null, 'events');
+    }
+    const el = createElement(TestComponent);
+    assert.ok(el);
+    assert.equal(typeof useEvent, 'function');
+    // Verify subscriber invocation contract
+    const unsub = mockSubscriber('tick', (payload) => {
+        handlerCalledWith = payload;
+    });
+    assert.equal(subscribedName, 'tick');
+    assert.deepEqual(handlerCalledWith, { count: 1 });
+    unsub();
+    assert.equal(unsubscribed, true);
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

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

package/dist/useCommand.d.ts

@@ -0,0 +1,15 @@
+import type { InvokeOptions } from '@rustra/types';
+export type CommandFn<I, O> = (input: I, options?: InvokeOptions) => Promise<O>;
+export type VoidCommandFn<O> = (options?: InvokeOptions) => Promise<O>;
+export interface UseCommandOptions {
+    /** If false, query will not run automatically. Default: true */
+    enabled?: boolean;
+}
+export interface UseCommandResult<O> {
+    data: O | undefined;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<O | undefined>;
+}
+export declare function useCommand<I, O>(commandFn: CommandFn<I, O> | VoidCommandFn<O>, input?: I, options?: UseCommandOptions): UseCommandResult<O>;
+//# sourceMappingURL=useCommand.d.ts.map

package/dist/useCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommand.d.ts","sourceRoot":"","sources":["../src/useCommand.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAChF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACvC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC7B,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC7C,KAAK,CAAC,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,iBAAiB,GAC1B,gBAAgB,CAAC,CAAC,CAAC,CAwDrB"}

package/dist/useCommand.js

@@ -0,0 +1,54 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { useRustraEngine } from './context.js';
+export function useCommand(commandFn, input, options) {
+    const engine = useRustraEngine();
+    const [data, setData] = useState(undefined);
+    const [loading, setLoading] = useState(options?.enabled ?? true);
+    const [error, setError] = useState(null);
+    const abortControllerRef = useRef(null);
+    const commandName = commandFn.name;
+    const execute = useCallback(async () => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+        }
+        const ac = new AbortController();
+        abortControllerRef.current = ac;
+        setLoading(true);
+        setError(null);
+        try {
+            const res = await engine.invoke(commandName, input, { signal: ac.signal });
+            if (!ac.signal.aborted) {
+                setData(res);
+                setLoading(false);
+            }
+            return res;
+        }
+        catch (err) {
+            if (!ac.signal.aborted) {
+                const parsedError = err instanceof Error ? err : new Error(String(err));
+                setError(parsedError);
+                setLoading(false);
+            }
+            return undefined;
+        }
+    }, [engine, commandName, JSON.stringify(input)]);
+    useEffect(() => {
+        if (options?.enabled === false) {
+            setLoading(false);
+            return;
+        }
+        execute();
+        return () => {
+            if (abortControllerRef.current) {
+                abortControllerRef.current.abort();
+            }
+        };
+    }, [execute, options?.enabled]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: execute,
+    };
+}
+//# sourceMappingURL=useCommand.js.map

package/dist/useCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommand.js","sourceRoot":"","sources":["../src/useCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAiB/C,MAAM,UAAU,UAAU,CACxB,SAA6C,EAC7C,KAAS,EACT,OAA2B;IAE3B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,SAAS,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,kBAAkB,GAAG,MAAM,CAAyB,IAAI,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC;IAEnC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAA4B,EAAE;QAC7D,IAAI,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAC/B,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,kBAAkB,CAAC,OAAO,GAAG,EAAE,CAAC;QAEhC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAI,WAAW,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,CAAC;gBACb,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,WAAW,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxE,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACtB,UAAU,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/B,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;QAEV,OAAO,GAAG,EAAE;YACV,IAAI,kBAAkB,CAAC,OAAO,EAAE,CAAC;gBAC/B,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEhC,OAAO;QACL,IAAI;QACJ,OAAO;QACP,KAAK;QACL,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC"}

package/dist/useEvent.d.ts

@@ -0,0 +1,12 @@
+export type EventCallback<T = unknown> = (payload: T) => void;
+export type UnsubscribeFn = () => void;
+export type SubscribeFn<T = unknown> = (eventName: string, callback: EventCallback<T>) => UnsubscribeFn;
+/**
+ * Subscribes to a Rustra event stream and automatically unregisters on unmount.
+ *
+ * @param eventName Name of the event to listen to (e.g. "progress.tick")
+ * @param callback Handler called whenever the event fires
+ * @param subscribe Optional subscription function (e.g., from `@rustra/react-native` `subscribeEvent`)
+ */
+export declare function useEvent<T = unknown>(eventName: string, callback: EventCallback<T>, subscribe?: SubscribeFn<T>): void;
+//# sourceMappingURL=useEvent.d.ts.map

package/dist/useEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEvent.d.ts","sourceRoot":"","sources":["../src/useEvent.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AACvC,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,KACvB,aAAa,CAAC;AAEnB;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GACzB,IAAI,CAaN"}

package/dist/useEvent.js

@@ -0,0 +1,23 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Subscribes to a Rustra event stream and automatically unregisters on unmount.
+ *
+ * @param eventName Name of the event to listen to (e.g. "progress.tick")
+ * @param callback Handler called whenever the event fires
+ * @param subscribe Optional subscription function (e.g., from `@rustra/react-native` `subscribeEvent`)
+ */
+export function useEvent(eventName, callback, subscribe) {
+    const callbackRef = useRef(callback);
+    callbackRef.current = callback;
+    useEffect(() => {
+        if (!subscribe)
+            return;
+        const unsubscribe = subscribe(eventName, (payload) => {
+            callbackRef.current(payload);
+        });
+        return () => {
+            unsubscribe?.();
+        };
+    }, [eventName, subscribe]);
+}
+//# sourceMappingURL=useEvent.js.map

package/dist/useEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEvent.js","sourceRoot":"","sources":["../src/useEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAS1C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,QAA0B,EAC1B,SAA0B;IAE1B,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACnD,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/useMutation.d.ts

@@ -0,0 +1,17 @@
+import type { InvokeOptions } from '@rustra/types';
+import type { CommandFn, VoidCommandFn } from './useCommand.js';
+export interface UseMutationOptions<I, O> {
+    onSuccess?: (data: O, input: I) => void;
+    onError?: (error: Error, input: I) => void;
+    onSettled?: (data: O | undefined, error: Error | null, input: I) => void;
+}
+export interface UseMutationResult<I, O> {
+    mutate: (input: I) => void;
+    mutateAsync: (input: I, options?: InvokeOptions) => Promise<O>;
+    data: O | undefined;
+    loading: boolean;
+    error: Error | null;
+    reset: () => void;
+}
+export declare function useMutation<I = void, O = unknown>(commandFn: CommandFn<I, O> | VoidCommandFn<O>, options?: UseMutationOptions<I, O>): UseMutationResult<I, O>;
+//# sourceMappingURL=useMutation.d.ts.map

package/dist/useMutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMutation.d.ts","sourceRoot":"","sources":["../src/useMutation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,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,CAyDzB"}

package/dist/useMutation.js

@@ -0,0 +1,50 @@
+import { useState, useCallback, useRef } from 'react';
+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);
+    const commandName = commandFn.name;
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const mutateAsync = useCallback(async (input, invokeOptions) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const res = await engine.invoke(commandName, input, invokeOptions);
+            setData(res);
+            setLoading(false);
+            optionsRef.current?.onSuccess?.(res, input);
+            optionsRef.current?.onSettled?.(res, null, input);
+            return res;
+        }
+        catch (err) {
+            const parsedError = err instanceof Error ? err : new Error(String(err));
+            setError(parsedError);
+            setLoading(false);
+            optionsRef.current?.onError?.(parsedError, input);
+            optionsRef.current?.onSettled?.(undefined, parsedError, input);
+            throw parsedError;
+        }
+    }, [engine, commandName]);
+    const mutate = useCallback((input) => {
+        mutateAsync(input).catch(() => {
+            // Handled in mutateAsync state & onError callback
+        });
+    }, [mutateAsync]);
+    const reset = useCallback(() => {
+        setData(undefined);
+        setError(null);
+        setLoading(false);
+    }, []);
+    return {
+        mutate,
+        mutateAsync,
+        data,
+        loading,
+        error,
+        reset,
+    };
+}
+//# sourceMappingURL=useMutation.js.map

package/dist/useMutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMutation.js","sourceRoot":"","sources":["../src/useMutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAkB/C,MAAM,UAAU,WAAW,CACzB,SAA6C,EAC7C,OAAkC;IAElC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAgB,SAAS,CAAC,CAAC;IAC3D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EAAE,KAAQ,EAAE,aAA6B,EAAc,EAAE;QAC5D,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAI,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;YACtE,OAAO,CAAC,GAAG,CAAC,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5C,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,QAAQ,CAAC,WAAW,CAAC,CAAC;YACtB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClD,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,WAAW,CAAC;QACpB,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,WAAW,CAAC,CACtB,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,KAAQ,EAAE,EAAE;QACX,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC5B,kDAAkD;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,WAAW,CAAC,CACd,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,OAAO,CAAC,SAAS,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,MAAM;QACN,WAAW;QACX,IAAI;QACJ,OAAO;QACP,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@rustra/react",
+  "version": "0.1.3",
+  "description": "React and React Native bindings and hooks for rustra-bridge",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "npm run build && node --test dist/index.test.js"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "@rustra/types": "^0.1.3"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "typescript": "^5.9.0"
+  },
+  "keywords": [
+    "rustra",
+    "bridge",
+    "react",
+    "react-native",
+    "hooks"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/loopy-lim/rustra.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/loopy-lim/rustra/issues"
+  },
+  "homepage": "https://github.com/loopy-lim/rustra#readme"
+}