@shivaedev/effect-react 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.6.0 - 2026-10-18
+
+### Added
+
+- `authAction` in `client/authAction.ts` binds Better Auth client promises to native action atoms for `useAction`, with pending state and typed returned failures. Rejected promises fail with the exported `AuthActionUnavailable` error; `AuthActionResult` describes the structural client result.
+
 ## 0.5.1 - 2026-10-18
 
 ### Fixed

package/README.md

@@ -141,6 +141,31 @@ create.dispatch({
 
 An action's `dispatch(input)` returns `void`. Read the atom's latest result from `data`, `cause` or `result`. With the default `Atom.fn` action, a later dispatch interrupts the earlier work and the shared state reports the later result. Disable duplicate submissions or give independent work distinct native action atoms. When one caller needs its own success or failure, run the actual RPC Effect through its runtime, as the editor's `save` does; shared atom state cannot identify one invocation's completion.
 
+### Better Auth actions
+
+`authAction` from `@shivaedev/effect-react/client/authAction.ts` turns a Better Auth client call into a native action atom. Create it with the client, then pass it to `useAction` for the same `pending`, `data`, `cause`, `result` and `dispatch` shape as commands:
+
+```tsx
+const signIn = authAction((credentials: { email: string; password: string }, signal) =>
+  authClient.signIn.email(credentials, { signal }),
+);
+
+function SignInButton({ email, password }: { email: string; password: string }) {
+  const action = useAction(signIn);
+  const failure = AsyncResult.error(action.result);
+  return (
+    <>
+      <button disabled={action.pending} onClick={() => action.dispatch({ email, password })}>
+        {action.pending ? "Signing in…" : "Sign in"}
+      </button>
+      {Option.isSome(failure) && <p role="alert">Sign-in failed</p>}
+    </>
+  );
+}
+```
+
+The example uses `authAction`, `useAction`, `effect/reactivity/AsyncResult` and `effect/Option`, with an application-owned `authClient`. Returned auth errors keep their fields in the typed failure channel. Rejected promises become `AuthActionUnavailable` with the original rejection in `cause`. The application chooses error text and what happens after success.
+
 ### Route loaders with TanStack Router
 
 TanStack Router owns routes, navigation, loader data and error components. `@shivaedev/effect-react/loadQuery.ts` supplies `loadQuery(registry, atom, loaderContext)` to read a contract query atom in the same registry as React. The atom runs through its native RPC runtime; the loader does not create another runtime or query cache.

package/dist/client/authAction.d.ts

@@ -0,0 +1,15 @@
+import * as Atom from "effect/reactivity/Atom";
+declare const AuthActionUnavailable_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AuthActionUnavailable";
+} & Readonly<A>;
+export declare class AuthActionUnavailable extends AuthActionUnavailable_base<{
+    readonly cause: unknown;
+}> {
+}
+export interface AuthActionResult<A, E> {
+    readonly data: A;
+    readonly error: E | null;
+}
+export declare function authAction<TInput, A, E extends object = never>(run: (input: TInput, signal: AbortSignal) => Promise<AuthActionResult<A, E>>): Atom.AtomResultFn<TInput, A, E | AuthActionUnavailable>;
+export {};
+//# sourceMappingURL=authAction.d.ts.map

package/dist/client/authAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authAction.d.ts","sourceRoot":"","sources":["../../src/client/authAction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;;;;AAE/C,qBAAa,qBAAsB,SAAQ,2BAA0C;IACpF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACxB,CAAC;CAAG;AAEL,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EAC7D,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC1E,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAOzD"}

package/dist/client/authAction.js

@@ -0,0 +1,11 @@
+import { Data, Effect } from "effect";
+import * as Atom from "effect/reactivity/Atom";
+export class AuthActionUnavailable extends Data.TaggedError("AuthActionUnavailable") {
+}
+export function authAction(run) {
+    return Atom.fn()((input) => Effect.tryPromise({
+        catch: (cause) => new AuthActionUnavailable({ cause }),
+        try: (signal) => run(input, signal),
+    }).pipe(Effect.flatMap((result) => (result.error === null ? Effect.succeed(result.data) : Effect.fail(result.error)))));
+}
+//# sourceMappingURL=authAction.js.map

package/dist/client/authAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authAction.js","sourceRoot":"","sources":["../../src/client/authAction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAE/C,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAEjF;CAAG;AAOL,MAAM,UAAU,UAAU,CACzB,GAA4E;IAE5E,OAAO,IAAI,CAAC,EAAE,EAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAClC,MAAM,CAAC,UAAU,CAAC;QACjB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC;QACtD,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;KACnC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACtH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/effect-react",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "React query, action, editor and session hooks for native Effect atoms",
   "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/effect-react#readme",
   "bugs": {
@@ -51,14 +51,14 @@
     "@effect/platform-node": "4.0.4",
     "@effect/sql-pg": "4.0.4",
     "@effect/sql-sqlite-node": "4.0.4",
-    "@shivaedev/effect-pg-boss": "0.9.0",
+    "@shivaedev/effect-pg-boss": "0.10.0",
     "@shivaedev/effect-service": "0.4.0",
     "@shivaedev/effect-sql": "0.5.2",
     "@shivaedev/effect-test": "0.6.0",
-    "@shivaedev/local-postgres": "0.4.0",
-    "@shivaedev/platform": "0.16.1",
-    "@shivaedev/quality": "0.26.0",
-    "@shivaedev/test-story": "0.8.0",
+    "@shivaedev/local-postgres": "0.4.1",
+    "@shivaedev/platform": "0.17.0",
+    "@shivaedev/quality": "0.27.0",
+    "@shivaedev/test-story": "0.9.0",
     "@tanstack/react-router": "1.170.42",
     "@types/node": "24.19.2",
     "@types/react": "19.3.0",

package/src/client/authAction.ts

@@ -0,0 +1,22 @@
+import { Data, Effect } from "effect";
+import * as Atom from "effect/reactivity/Atom";
+
+export class AuthActionUnavailable extends Data.TaggedError("AuthActionUnavailable")<{
+	readonly cause: unknown;
+}> {}
+
+export interface AuthActionResult<A, E> {
+	readonly data: A;
+	readonly error: E | null;
+}
+
+export function authAction<TInput, A, E extends object = never>(
+	run: (input: TInput, signal: AbortSignal) => Promise<AuthActionResult<A, E>>,
+): Atom.AtomResultFn<TInput, A, E | AuthActionUnavailable> {
+	return Atom.fn<TInput>()((input) =>
+		Effect.tryPromise({
+			catch: (cause) => new AuthActionUnavailable({ cause }),
+			try: (signal) => run(input, signal),
+		}).pipe(Effect.flatMap((result) => (result.error === null ? Effect.succeed(result.data) : Effect.fail(result.error)))),
+	);
+}