@shivaedev/react 0.22.1 → 0.23.1

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.23.1 - 2026-10-30
+
+### Changed
+
+- Release with updated workspace dependencies.
+
+## 0.23.0 - 2026-10-30
+
+### Added
+
+- Expose the native submission `cause` on `useEditor`, `useCreate` and `SaveState` so applications can render failures that include defects.
+- Export modules under `internal/` in `contract` and `react` and `server/internal/` in `jobs` through the existing `.ts` wildcard, so consumers can import those modules directly by their file paths.
+- Access exports the `Permission` Schema and derives its type from it. Role resolution and identity session decoding use that Schema.
+- Access exports `forbidden(permission)` and `unauthorized()` from `refusal.ts` for consistent permission refusals.
+
+### Changed
+
+- Generated applications import React test helpers from their existing `@shivaedev/test-story` development dependency.
+
+### Fixed
+
+- Work Board reads draft timestamps and expiry through its form client’s runtime Clock.
+- Ignore repeated sign-out dispatch while sign-out is pending.
+- Generated apps send an explicitly signed-out visitor to sign-in when the replacement session receives `Unauthorized` from the notes route.
+
+### Breaking
+
+- Persisted drafts require a `now: () => number` callback in core forms, `usePersistedDraft`, `useEditor` and `useCreate`. Capture `Clock.Clock` in the application’s Effect setup and pass `now: () => clock.currentTimeMillisUnsafe()` so timestamps and expiry follow that clock, including TestClock in stories.
+- Form no longer exports the identity cast helpers `holder`, `fieldOf`, `choicesOf` or `checkOf` from `shape.ts`, or `keySelector` from `paths.ts`. Use declared reference, field, check and selector types directly; get field refs and choices through the form’s typed `field` and `choices` methods.
+- `useSignOut` stops follow-up navigation on component unmount or registry disposal. Keep the component mounted until the request completes, or let the replacement session's route policy navigate to sign-in when a session refresh unmounts it first.
+- Move the React test helpers to `@shivaedev/test-story/client/react.ts`. Replace imports from `@shivaedev/react/client/testing.ts` with this path for `render`, `eventually`, `captureReactWarnings`, `expectNoReactWarnings` and their types. Add `@shivaedev/test-story` as a development dependency and install its React helpers' optional peers `react`, `react-dom` and `@effect/atom-react` when using them. React no longer brings `@shivaedev/test` into applications as a runtime dependency.
+- Access, identity and React now share access's grant evaluator: an `any` grant covers an `own` check for the same permission name. An `own` grant still cannot cover an `any` check. Applications that need separate capabilities must declare separate permission names; record ownership checks still belong in `canAccess` or `requireAccess`.
+- Replace `Access.requirePermission(user, permission)` with `requirePermission(yield* Access.resolve(user.role), permission)` from `@shivaedev/access/requirePermission.ts`. The new function takes a signed-in user; reject an absent session with `unauthorized()` from `@shivaedev/access/refusal.ts` before resolving its role. `requireAccess` continues to handle signed-out users itself.
+- Replace identity's `requirePermission(permission)` with access's `requirePermission(yield* SessionUser, permission)`. There is no identity re-export. Admin's built-in handlers use this shared enforcement.
+- Access's `requireAccess` now uses the shared permission refusal message, `Permission required: <name> (<strength>)`, instead of `Access denied: <name>`. Consumers should branch on the `Forbidden` tag.
+
 ## 0.22.1 - 2026-10-30
 
 ### Changed

package/README.md

@@ -30,7 +30,7 @@ An **editor** joins a query atom, a form field schema and a save Effect. The que
 
 A **session generation** is the string returned by `identify(session)`. `SessionBoundary` owns its client, registry and React subtree. Your auth owner supplies the session and decides when to replace or end it. The boundary automatically mounts live connections on bound contract APIs returned by `connect`, directly or as client properties such as `api`. Use a Platform database host and the default shared WebSocket client; the application needs no subscribe handler or `live()` call. Live changed hints coalesce over 20 ms by default. Set `liveCoalesceWindow` on `SessionBoundary` to a native Duration to choose the window for that session, or `0` for immediate per-hint refreshes. A bound query can override that default with `useQuery(atom, { coalesceWindow: "2 seconds" })`. Changing this option applies to subsequent windows without reconnecting or refetching any query; a window already started keeps its deadline. A refetch in flight runs once more after settling when further hints arrive. Cache policy, RPC declarations and transport stay with native Effect and the application; this package supplies their React state and lifecycle boundary.
 
-`useEditor` and `useCreate` opt into persisted input with `persistedDraft: { key }`. Choose a stable key for the record or create request, independent of its server revision. The adapters use form's browser storage and inherit ownership from `SessionBoundary`: reload and query refresh preserve edits, successful submission clears accepted input, and a committed session replacement drops tracked drafts. A suspended replacement that is canceled keeps the visible session's draft and future writes. Later edits made during a save remain persisted. Optional `storage`, `maxBytes` and `maxAgeMs` customize the provider and bounds; defaults are `localStorage`, 256 KiB of UTF-8 JSON and seven days. See [form's persisted input API](https://github.com/ShivaeDev/platform/tree/main/packages/form#persist-input-across-reloads) for direct form hooks and limits.
+`useEditor` and `useCreate` opt into persisted input with `persistedDraft: { key, now }`. Choose a stable key for the record or create request, independent of its server revision. Supply `now: () => clock.currentTimeMillisUnsafe()` using `Clock.Clock` captured in the application’s Effect setup; draft timestamps and expiry use that clock. The adapters use form's browser storage and inherit ownership from `SessionBoundary`: reload and query refresh preserve edits, successful submission clears accepted input, and a committed session replacement drops tracked drafts. A suspended replacement that is canceled keeps the visible session's draft and future writes. Later edits made during a save remain persisted. Optional `storage`, `maxBytes` and `maxAgeMs` customize the provider and bounds; defaults are `localStorage`, 256 KiB of UTF-8 JSON and seven days. See [form's persisted input API](https://github.com/ShivaeDev/platform/tree/main/packages/form#persist-input-across-reloads) for direct form hooks and limits.
 
 ### 1. Once per application
 
@@ -313,7 +313,7 @@ export function InvoiceLineEditor({ id }: { readonly id: number }) {
 						}}
 					>
 						<Inputs form={editor.form} />
-						{Option.isSome(editor.failure) && <p role="alert">Could not save</p>}
+						{Option.isSome(editor.cause) && <p role="alert">Could not save</p>}
 						<button type="submit" disabled={editor.saving}>
 							Save
 						</button>
@@ -346,7 +346,7 @@ export function InvoiceLineCreate() {
 			}}
 		>
 			<Inputs form={create.form} />
-			{Option.isSome(create.failure) && <p role="alert">Could not create</p>}
+			{Option.isSome(create.cause) && <p role="alert">Could not create</p>}
 			<button type="submit" disabled={create.saving}>
 				Create
 			</button>
@@ -423,7 +423,7 @@ Use `useEditor` for a continuing editor that subscribes to a record, merges refr
 
 #### Field rejections and other failures
 
-A tagged error with string `_tag` and `message`, and a `field` naming a form field, becomes that field's message by default. Other save failures appear in `failure`. Use `rejectField` when the server uses a different shape or field name:
+A tagged error with string `_tag` and `message`, and a `field` naming a form field, becomes that field's message by default. Other typed save failures appear in `failure`. The native `cause` also exposes defects, interruptions and form validation failures; use it for a general failure alert so a save that dies is visible. Use `rejectField` when the server uses a different shape or field name:
 
 ```ts
 const TitleFields = Schema.Struct({ title: Schema.String });
@@ -654,7 +654,7 @@ For a loader that coordinates more work, use `loadQuery(registry, atom, loaderCo
 
 #### Session permissions and guarded routes
 
-Permissions come from the session payload's `user.permissions`, populated by `@shivaedev/access` through the server's role policy. `can(session, permission)` reads exact name and strength grants without making a request. `useCan()` supplies the same check from the nearest `PermissionBoundary` for component controls. A signed-out session has no grants. These checks control visibility; the server still authorizes every request.
+Permissions come from the session payload's `user.permissions`, populated by `@shivaedev/access` through the server's role policy. `can(session, permission)` uses access's grant evaluator without making a request: names match exactly, and an `any` grant covers an `own` check for that name. An `own` grant does not cover an `any` check. `useCan()` supplies the same check from the nearest `PermissionBoundary` for component controls. A signed-out session has no grants. These checks control visibility; the server still authorizes every request.
 
 Declare a route's requirement in TanStack's native `staticData.permission`. Install `permissionGuard` once as the root route's `beforeLoad`; it checks the matched routes before their loaders run. Signed-out visitors go to the app's `signIn` path with the full requested location in the `returnTo` search field. A signed-in session without a required grant throws the shared `Forbidden` failure.
 
@@ -770,7 +770,7 @@ function Account() {
 
 The example uses the application's Better Auth client. Reads preserve returned auth errors and use the same `AuthActionUnavailable` failure as actions for rejected promises. Releasing a pending read interrupts its Effect and aborts the supplied signal.
 
-For an explicit sign-out in a TanStack route, use `useSignOut(signOut, { signIn: "/sign-in" })` from `@shivaedev/react/client/useSignOut.ts` in place of `useAction`. It exposes the same state and a `dispatch()` handler. The hook records sign-out intent before the request and navigates to sign-in after success. `permissionGuard` and `signInSearch(location)` omit `returnTo` for that intent, including when the auth owner's session refresh reruns guards first. Use `signInSearch` for module sign-in links too; ordinary visits retain the full requested location. Applications do not need history markers or Better Auth completion timing hooks.
+For an explicit sign-out in a TanStack route, use `useSignOut(signOut, { signIn: "/sign-in" })` from `@shivaedev/react/client/useSignOut.ts` in place of `useAction`. It exposes the same state and a `dispatch()` handler. The hook records sign-out intent before the request and navigates to sign-in after success. Repeated clicks while pending share one request and follow-up. Unmounting the component or disposing its registry stops the follow-up navigation. If a session refresh replaces the component before the response, the replacement session’s route policy owns navigation to sign-in. `permissionGuard` and `signInSearch(location)` omit `returnTo` for that intent, including when the auth owner's session refresh reruns guards first. Use `signInSearch` for module sign-in links too; ordinary visits retain the full requested location. Applications do not need history markers or Better Auth completion timing hooks.
 
 ### 3. Every day
 
@@ -826,11 +826,11 @@ Without a runtime it uses a native empty atom runtime. Stories supply a runtime
 
 #### Render tests in happy-dom
 
-Use `@shivaedev/react/client/testing.ts` with Vitest's `happy-dom` environment. Install contract and changes for the example's query, command and key declarations, and the testing peers and environment in your app's dev dependencies:
+Use `@shivaedev/test-story/client/react.ts` with Vitest's `happy-dom` environment. Install contract and changes for the example's query, command and key declarations, and the testing peers and environment in your app's dev dependencies:
 
 ```sh
 pnpm add @shivaedev/changes @shivaedev/contract
-pnpm add -D @shivaedev/test @effect/vitest vitest happy-dom react-dom @types/react-dom
+pnpm add -D @shivaedev/test-story @effect/platform-node @effect/vitest vitest happy-dom react-dom @types/react-dom
 ```
 
 Configure Vitest with `test: { environment: "happy-dom" }`, or select that environment for your DOM test project. This complete `notes.dom.test.tsx` renders a component that runs a declared query and command against native RPC test handlers:
@@ -846,7 +846,7 @@ import { contract } from "@shivaedev/contract/contract.ts";
 import { collection } from "@shivaedev/changes/keys.ts";
 import { command, query } from "@shivaedev/contract/operation.ts";
 import { useAction, useQuery } from "@shivaedev/react/client/resultState.ts";
-import { eventually, expectNoReactWarnings, render } from "@shivaedev/react/client/testing.ts";
+import { eventually, expectNoReactWarnings, render } from "@shivaedev/test-story/client/react.ts";
 import { it } from "@shivaedev/test/it.ts";
 
 Object.assign(globalThis, { "IS_REACT_ACT_ENVIRONMENT": true });
@@ -893,22 +893,21 @@ function NotesView() {
 }
 
 it.live("renders a query and refetches it after a command through a test RPC layer", function* () {
-	const view = yield* Effect.promise(() => render(createElement(NotesView)));
-	try {
-		yield* eventually(() => expect(view.container.querySelector("button")?.disabled).toBe(false));
-		expect(view.container.querySelector("output")?.textContent).toBe("");
-		yield* Effect.promise(() => act(async () => view.container.querySelector("button")?.click()));
-		yield* eventually(() => {
-			expect(view.container.querySelector("output")?.textContent).toBe("Morning walk");
-			expect(view.container.querySelector("button")?.disabled).toBe(false);
-		});
-	} finally {
-		yield* Effect.promise(view.unmount);
-	}
+	const view = yield* Effect.acquireRelease(
+		Effect.promise(() => render(createElement(NotesView))),
+		(view) => Effect.promise(view.unmount),
+	);
+	yield* eventually(() => expect(view.container.querySelector("button")?.disabled).toBe(false));
+	expect(view.container.querySelector("output")?.textContent).toBe("");
+	yield* Effect.promise(() => act(async () => view.container.querySelector("button")?.click()));
+	yield* eventually(() => {
+		expect(view.container.querySelector("output")?.textContent).toBe("Morning walk");
+		expect(view.container.querySelector("button")?.disabled).toBe(false);
+	});
 });
 ```
 
-`render(node, options?)` returns the attached `container`, its fresh native `registry`, `render(nextNode)` to update the same root and registry, and `unmount()` to release the root, registry and container. The options are React's own `RootOptions`, passed to `createRoot`, including `onCaughtError`, `onUncaughtError` and `onRecoverableError`. Always unmount in `finally`. Keep component interactions inside React's `act`. `eventually(assert)` returns an Effect: yield it directly in a story or Effect test, keeping the expectation in the spec. It retries for up to three seconds in live time, allowing pending responses to settle inside `act` between attempts without advancing the story’s TestClock. A timeout fails with an Error whose message includes the elapsed milliseconds and last assertion message, and whose `cause` is that assertion error. In an async test, use `await Effect.runPromise(eventually(assert))`. `expectNoReactWarnings()` registers a Vitest hook that fails a test if it logged to `console.error`.
+`render(node, options?)` returns the attached `container`, its fresh native `registry`, `render(nextNode)` to update the same root and registry, and `unmount()` to release the root, registry and container. The options are React's own `RootOptions`, passed to `createRoot`, including `onCaughtError`, `onUncaughtError` and `onRecoverableError`. In Effect tests, acquire the view with `Effect.acquireRelease` so its scope releases it on success, failure or interruption. In async tests, unmount in `finally`. Keep component interactions inside React's `act`. `eventually(assert)` returns an Effect: yield it directly in a story or Effect test, keeping the expectation in the spec. It retries for up to three seconds in live time, allowing pending responses to settle inside `act` between attempts without advancing the story’s TestClock. A timeout fails with an Error whose message includes the elapsed milliseconds and last assertion message, and whose `cause` is that assertion error. In an async test, use `await Effect.runPromise(eventually(assert))`. `expectNoReactWarnings()` registers a Vitest hook that fails a test if it logged to `console.error`.
 
 The RPC layer stays application-owned: replace these in-memory handlers with the service Layer your component needs.
 
@@ -928,7 +927,7 @@ screenStories.it("shows the route failure", [], async () => {
 });
 ```
 
-Story kits can acquire `captureReactWarnings` from `client/testing.ts` in their `create` effect with `const warnings = yield* captureReactWarnings`. The scope owns the capture and restores `console.error` when it closes, including after a failed story. Pass `warnings.onCaughtError` to `render` to capture boundary errors, or `warnings.expectCaughtError(predicate)` to exclude a declared error. Both handlers silence caught errors; the capture also silences and records `console.error` calls. `warnings.read()` returns `{ consoleErrors, caughtErrors }`, with each console call's arguments and the unexpected caught errors. It asserts nothing, leaving the story spec to state its expectation. The Vitest guard uses the same capture mechanism and additionally checks that every declared error occurred.
+Story kits can acquire `captureReactWarnings` from `@shivaedev/test-story/client/react.ts` in their `create` effect with `const warnings = yield* captureReactWarnings`. The scope owns the capture and restores `console.error` when it closes, including after a failed story. Pass `warnings.onCaughtError` to `render` to capture boundary errors, or `warnings.expectCaughtError(predicate)` to exclude a declared error. Both handlers silence caught errors; the capture also silences and records `console.error` calls. `warnings.read()` returns `{ consoleErrors, caughtErrors }`, with each console call's arguments and the unexpected caught errors. It asserts nothing, leaving the story spec to state its expectation. The Vitest guard uses the same capture mechanism and additionally checks that every declared error occurred.
 
 ### API
 

package/dist/client/saveState.d.ts

@@ -1,6 +1,7 @@
-import { Option } from "effect";
-import { FieldFailure, type Fields, type Form } from "@shivaedev/form/shape.ts";
+import { type Cause, Option } from "effect";
+import { FieldFailure, type Fields, type Form, Invalid } from "@shivaedev/form/shape.ts";
 export interface SaveState<E> {
+    readonly cause: Option.Option<Cause.Cause<E | FieldFailure | Invalid>>;
     readonly dirty: boolean;
     readonly failure: Option.Option<E>;
     readonly revert: () => void;

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

@@ -1 +1 @@
-{"version":3,"file":"saveState.d.ts","sourceRoot":"","sources":["../../src/client/saveState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAW,MAAM,0BAA0B,CAAC;AAMzF,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AACD,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,EACvE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,aAAa,CAAC,GAAG,SAAS,EACnE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAC1B,SAAS,CAAC,CAAC,GAAG,aAAa,CAAC,CAgC9B"}
+{"version":3,"file":"saveState.d.ts","sourceRoot":"","sources":["../../src/client/saveState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAMzF,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AACD,wBAAgB,YAAY,CAAC,OAAO,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,EACvE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,aAAa,CAAC,GAAG,SAAS,EACnE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAC1B,SAAS,CAAC,CAAC,GAAG,aAAa,CAAC,CAgC9B"}

package/dist/client/saveState.js

@@ -32,6 +32,6 @@ export function useSaveState(form, settled) {
     }, [form, registry]);
     const revert = useCallback(() => form?.revert(), [form]);
     const failure = Option.filter(AsyncResult.error(result), (error) => !(error instanceof FieldFailure || error instanceof Invalid));
-    return { dirty, failure, revert, save, saving: result.waiting };
+    return { cause: AsyncResult.cause(result), dirty, failure, revert, save, saving: result.waiting };
 }
 //# sourceMappingURL=saveState.js.map

package/dist/client/saveState.js.map

@@ -1 +1 @@
-{"version":3,"file":"saveState.js","sourceRoot":"","sources":["../../src/client/saveState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,WAAW,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,YAAY,EAA0B,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAQ/B,MAAM,UAAU,YAAY,CAC3B,IAAmE,EACnE,OAA4B;IAE5B,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,MAAM,GAA2E,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;IAC1H,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC;IACjD,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACtB,SAAS,CACR,GAAG,EAAE,CACJ,IAAI;WACD,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3C,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACF,CAAC,CAAC,EACH,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CACzB,CAAC;IACF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7D,OAAO;QACR,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC5B,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,CAAC,KAAK,EAA8B,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,YAAY,OAAO,CAAC,CACnG,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACjE,CAAC"}
+{"version":3,"file":"saveState.js","sourceRoot":"","sources":["../../src/client/saveState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAc,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,YAAY,EAA0B,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;AAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAS/B,MAAM,UAAU,YAAY,CAC3B,IAAmE,EACnE,OAA4B;IAE5B,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,MAAM,GAA2E,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;IAC1H,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC;IACjD,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACtB,SAAS,CACR,GAAG,EAAE,CACJ,IAAI;WACD,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3C,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACF,CAAC,CAAC,EACH,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CACzB,CAAC;IACF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7D,OAAO;QACR,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC5B,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EACzB,CAAC,KAAK,EAA8B,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,YAAY,IAAI,KAAK,YAAY,OAAO,CAAC,CACnG,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACnG,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useSignOut.d.ts","sourceRoot":"","sources":["../../src/client/useSignOut.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAM/C,OAAO,QAAQ,wBAAwB,CAAC;IACvC,UAAU,YAAY;QACrB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;KACrC;CACD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;EAsC3G"}
+{"version":3,"file":"useSignOut.d.ts","sourceRoot":"","sources":["../../src/client/useSignOut.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAM/C,OAAO,QAAQ,wBAAwB,CAAC;IACvC,UAAU,YAAY;QACrB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;KACrC;CACD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;EA8C3G"}

package/dist/client/useSignOut.js

@@ -1,9 +1,9 @@
-import { RegistryContext } from "@effect/atom-react";
+import { RegistryContext, useAtomMount } from "@effect/atom-react";
 import { useRouter } from "@tanstack/react-router";
 import { Effect } from "effect";
 import * as Atom from "effect/reactivity/Atom";
 import * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { useContext, useMemo } from "react";
+import { useContext, useEffect, useMemo } from "react";
 import { SignOutRegistryContext } from "#internal/SignOutRegistryContext.ts";
 import { useAction } from "./resultState.js";
 export function useSignOut(action, options) {
@@ -14,25 +14,33 @@ export function useSignOut(action, options) {
         get.addFinalizer(registry.subscribe(action, (result) => get.setSelf(result)));
         return registry.get(action);
     }, (_, input) => registry.set(action, input)), [registry, action]);
-    const state = useAction(source);
-    function failed() {
-        if (router) {
-            router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: false });
+    const followUp = useMemo(() => {
+        function failed() {
+            if (router) {
+                router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: false });
+            }
         }
-    }
-    function completed() {
-        if (router) {
-            void router.navigate({ replace: true, state: { __platformSignOut: true }, to: options.signIn });
+        function completed() {
+            if (router) {
+                void router.navigate({ replace: true, state: { __platformSignOut: true }, to: options.signIn });
+            }
         }
-    }
+        return Atom.fn()(() => AtomRegistry.getResult(registry, action, { suspendOnWaiting: true }).pipe(Effect.match({ onFailure: failed, onSuccess: completed })));
+    }, [registry, action, router, options.signIn]);
+    useAtomMount(followUp);
+    useEffect(() => () => local.set(followUp, Atom.Interrupt), [local, followUp]);
+    const state = useAction(source);
     return {
         ...state,
         dispatch: () => {
+            if (registry.get(action).waiting || local.get(followUp).waiting) {
+                return;
+            }
             if (router) {
                 router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: true });
             }
             state.dispatch(undefined);
-            Effect.runFork(AtomRegistry.getResult(registry, action, { suspendOnWaiting: true }).pipe(Effect.match({ onFailure: failed, onSuccess: completed })));
+            local.set(followUp, undefined);
         },
     };
 }

package/dist/client/useSignOut.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSignOut.js","sourceRoot":"","sources":["../../src/client/useSignOut.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQ7C,MAAM,UAAU,UAAU,CAAO,MAAqC,EAAE,OAAoC;IAC3G,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,UAAU,CAAC,sBAAsB,CAAC,IAAI,KAAK,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CACrB,GAAG,EAAE,CACJ,IAAI,CAAC,QAAQ,CACZ,CAAC,GAAG,EAAE,EAAE;QACP,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9E,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,EACD,CAAC,CAAC,EAAE,KAA8C,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAClF,EACF,CAAC,QAAQ,EAAE,MAAM,CAAC,CAClB,CAAC;IACF,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,SAAS,MAAM;QACd,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;QACtH,CAAC;IACF,CAAC;IACD,SAAS,SAAS;QACjB,IAAI,MAAM,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACjG,CAAC;IACF,CAAC;IACD,OAAO;QACN,GAAG,KAAK;QACR,QAAQ,EAAE,GAAG,EAAE;YACd,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;YACrH,CAAC;YACD,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC1B,MAAM,CAAC,OAAO,CACb,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CACpI,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"useSignOut.js","sourceRoot":"","sources":["../../src/client/useSignOut.ts"],"names":[],"mappings":"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"}

package/dist/permissionGuard.js

@@ -1,5 +1,5 @@
 import { redirect } from "@tanstack/react-router";
-import { Forbidden } from "@shivaedev/errors/taxonomy.ts";
+import { forbidden } from "@shivaedev/access/refusal.ts";
 import { can } from "./permissions.js";
 import { signInSearch } from "./signInSearch.js";
 export function permissionGuard({ session, signIn }) {
@@ -14,7 +14,7 @@ export function permissionGuard({ session, signIn }) {
         }
         for (const permission of required) {
             if (!can(current, permission)) {
-                throw new Forbidden({ message: `Permission required: ${permission.name} (${permission.strength})` });
+                throw forbidden(permission);
             }
         }
     };

package/dist/permissionGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissionGuard.js","sourceRoot":"","sources":["../src/permissionGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,GAAG,EAA0B,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAuB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtE,MAAM,UAAU,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAA0B;IAC1E,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9H,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;QACR,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,wBAAwB,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;YACtG,CAAC;QACF,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"permissionGuard.js","sourceRoot":"","sources":["../src/permissionGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,GAAG,EAA0B,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAuB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkBtE,MAAM,UAAU,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAA0B;IAC1E,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9H,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;QACR,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC/B,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}

package/dist/permissions.d.ts

@@ -1,4 +1,4 @@
-import type { Permission } from "@shivaedev/access/permission.ts";
+import { type Permission } from "@shivaedev/access/permission.ts";
 export interface PermissionSession {
     readonly user: {
         readonly permissions?: readonly Permission[];

package/dist/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE;QACd,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;KAC7C,CAAC;CACF;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAElG"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEjF,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE;QACd,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;KAC7C,CAAC;CACF;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAElG"}

package/dist/permissions.js

@@ -1,4 +1,5 @@
+import { hasPermission } from "@shivaedev/access/permission.ts";
 export function can(session, permission) {
-    return session?.user.permissions?.some((grant) => grant.name === permission.name && grant.strength === permission.strength) ?? false;
+    return hasPermission(session?.user.permissions, permission);
 }
 //# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,GAAG,CAAC,OAA6C,EAAE,UAAsB;IACxF,OAAO,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;AACtI,CAAC"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmB,MAAM,iCAAiC,CAAC;AAQjF,MAAM,UAAU,GAAG,CAAC,OAA6C,EAAE,UAAsB;IACxF,OAAO,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC7D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shivaedev/react",
-  "version": "0.22.1",
+  "version": "0.23.1",
   "description": "React query, action, editor and session hooks for native Effect atoms",
   "keywords": [
     "effect"
@@ -31,7 +31,6 @@
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
     },
-    "./internal/*": null,
     "./package.json": "./package.json"
   },
   "files": [
@@ -46,11 +45,10 @@
     "README.md"
   ],
   "dependencies": {
-    "@shivaedev/access": "0.1.2",
-    "@shivaedev/contract": "0.21.0",
-    "@shivaedev/errors": "0.1.1",
-    "@shivaedev/form": "0.7.1",
-    "@shivaedev/test": "0.10.1"
+    "@shivaedev/access": "0.2.0",
+    "@shivaedev/contract": "0.23.0",
+    "@shivaedev/errors": "0.1.2",
+    "@shivaedev/form": "0.8.0"
   },
   "devDependencies": {
     "@effect/atom-react": "4.0.6",
@@ -58,15 +56,16 @@
     "@effect/sql-pg": "4.0.6",
     "@effect/sql-sqlite-node": "4.0.6",
     "@shivaedev/changes": "0.5.1",
-    "@shivaedev/identity": "0.4.0",
-    "@shivaedev/jobs": "0.22.1",
+    "@shivaedev/identity": "0.7.0",
+    "@shivaedev/jobs": "0.23.1",
     "@shivaedev/local-postgres": "0.7.0",
-    "@shivaedev/quality": "0.45.0",
-    "@shivaedev/server": "0.5.0",
-    "@shivaedev/service": "0.5.1",
-    "@shivaedev/sql": "0.25.0",
-    "@shivaedev/test-sql": "0.11.0",
-    "@shivaedev/test-story": "0.24.0",
+    "@shivaedev/quality": "0.47.0",
+    "@shivaedev/server": "0.8.0",
+    "@shivaedev/service": "0.6.0",
+    "@shivaedev/sql": "0.26.1",
+    "@shivaedev/test": "0.11.0",
+    "@shivaedev/test-sql": "0.13.0",
+    "@shivaedev/test-story": "0.25.1",
     "@tanstack/react-router": "1.170.46",
     "@types/node": "24.19.2",
     "@types/react": "19.3.0",
@@ -82,19 +81,11 @@
     "@effect/atom-react": "4.0.6",
     "@tanstack/react-router": "1.170.46",
     "effect": "4.0.6",
-    "react": "19.3.1",
-    "react-dom": "19.3.1",
-    "vitest": "5.0.5"
+    "react": "19.3.1"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {
       "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    },
-    "vitest": {
-      "optional": true
     }
   },
   "engines": {

package/src/client/saveState.ts

@@ -1,5 +1,5 @@
 import { RegistryContext, useAtomValue } from "@effect/atom-react";
-import { Option } from "effect";
+import { type Cause, Option } from "effect";
 import * as AsyncResult from "effect/reactivity/AsyncResult";
 import * as Atom from "effect/reactivity/Atom";
 import { useCallback, useContext, useEffect } from "react";
@@ -10,6 +10,7 @@ import { useSessionRecheck } from "./sessionBoundary.ts";
 const idle = Atom.make(AsyncResult.initial());
 const clean = Atom.make(false);
 export interface SaveState<E> {
+	readonly cause: Option.Option<Cause.Cause<E | FieldFailure | Invalid>>;
 	readonly dirty: boolean;
 	readonly failure: Option.Option<E>;
 	readonly revert: () => void;
@@ -50,5 +51,5 @@ export function useSaveState<TFields extends Fields, A, E, TRuntimeError>(
 		AsyncResult.error(result),
 		(error): error is E | TRuntimeError => !(error instanceof FieldFailure || error instanceof Invalid),
 	);
-	return { dirty, failure, revert, save, saving: result.waiting };
+	return { cause: AsyncResult.cause(result), dirty, failure, revert, save, saving: result.waiting };
 }

package/src/client/useSignOut.ts

@@ -1,9 +1,9 @@
-import { RegistryContext } from "@effect/atom-react";
+import { RegistryContext, useAtomMount } from "@effect/atom-react";
 import { useRouter } from "@tanstack/react-router";
 import { Effect } from "effect";
 import * as Atom from "effect/reactivity/Atom";
 import * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { useContext, useMemo } from "react";
+import { useContext, useEffect, useMemo } from "react";
 import { SignOutRegistryContext } from "#internal/SignOutRegistryContext.ts";
 import { useAction } from "./resultState.ts";
 
@@ -28,27 +28,35 @@ export function useSignOut<A, E>(action: Atom.AtomResultFn<void, A, E>, options:
 			),
 		[registry, action],
 	);
-	const state = useAction(source);
-	function failed() {
-		if (router) {
-			router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: false });
+	const followUp = useMemo(() => {
+		function failed() {
+			if (router) {
+				router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: false });
+			}
 		}
-	}
-	function completed() {
-		if (router) {
-			void router.navigate({ replace: true, state: { __platformSignOut: true }, to: options.signIn });
+		function completed() {
+			if (router) {
+				void router.navigate({ replace: true, state: { __platformSignOut: true }, to: options.signIn });
+			}
 		}
-	}
+		return Atom.fn<void>()(() =>
+			AtomRegistry.getResult(registry, action, { suspendOnWaiting: true }).pipe(Effect.match({ onFailure: failed, onSuccess: completed })),
+		);
+	}, [registry, action, router, options.signIn]);
+	useAtomMount(followUp);
+	useEffect(() => () => local.set(followUp, Atom.Interrupt), [local, followUp]);
+	const state = useAction(source);
 	return {
 		...state,
 		dispatch: () => {
+			if (registry.get(action).waiting || local.get(followUp).waiting) {
+				return;
+			}
 			if (router) {
 				router.history.replace(router.history.location.href, { ...router.history.location.state, __platformSignOut: true });
 			}
 			state.dispatch(undefined);
-			Effect.runFork(
-				AtomRegistry.getResult(registry, action, { suspendOnWaiting: true }).pipe(Effect.match({ onFailure: failed, onSuccess: completed })),
-			);
+			local.set(followUp, undefined);
 		},
 	};
 }

package/src/permissionGuard.ts

@@ -1,6 +1,6 @@
 import { redirect } from "@tanstack/react-router";
 import type { Permission } from "@shivaedev/access/permission.ts";
-import { Forbidden } from "@shivaedev/errors/taxonomy.ts";
+import { forbidden } from "@shivaedev/access/refusal.ts";
 import { can, type PermissionSession } from "./permissions.ts";
 import { type SignInLocation, signInSearch } from "./signInSearch.ts";
 
@@ -32,7 +32,7 @@ export function permissionGuard({ session, signIn }: PermissionGuardOptions): (c
 		}
 		for (const permission of required) {
 			if (!can(current, permission)) {
-				throw new Forbidden({ message: `Permission required: ${permission.name} (${permission.strength})` });
+				throw forbidden(permission);
 			}
 		}
 	};

package/src/permissions.ts

@@ -1,4 +1,4 @@
-import type { Permission } from "@shivaedev/access/permission.ts";
+import { hasPermission, type Permission } from "@shivaedev/access/permission.ts";
 
 export interface PermissionSession {
 	readonly user: {
@@ -7,5 +7,5 @@ export interface PermissionSession {
 }
 
 export function can(session: PermissionSession | null | undefined, permission: Permission): boolean {
-	return session?.user.permissions?.some((grant) => grant.name === permission.name && grant.strength === permission.strength) ?? false;
+	return hasPermission(session?.user.permissions, permission);
 }

package/dist/client/testing.d.ts

@@ -1,28 +0,0 @@
-import { Effect, Scope } from "effect";
-import * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { type ReactNode } from "react";
-import { type RootOptions } from "react-dom/client";
-type CaughtErrorHandler = NonNullable<RootOptions["onCaughtError"]>;
-export interface ReactWarningsReadout {
-    readonly caughtErrors: readonly unknown[];
-    readonly consoleErrors: readonly (readonly unknown[])[];
-}
-export interface ReactWarnings {
-    readonly expectCaughtError: (matches: (error: unknown) => boolean) => CaughtErrorHandler;
-    readonly onCaughtError: CaughtErrorHandler;
-    readonly read: () => ReactWarningsReadout;
-}
-export declare const captureReactWarnings: Effect.Effect<ReactWarnings, never, Scope.Scope>;
-export declare function expectNoReactWarnings(): {
-    expectCaughtError(matches: (error: unknown) => boolean): NonNullable<RootOptions["onCaughtError"]>;
-};
-export declare function eventually(assert: () => void): Effect.Effect<void, Error, never>;
-export interface Rendered {
-    readonly container: HTMLDivElement;
-    readonly registry: AtomRegistry.AtomRegistry;
-    readonly render: (node: ReactNode) => Promise<void>;
-    readonly unmount: () => Promise<void>;
-}
-export declare function render(node: ReactNode, options?: RootOptions): Promise<Rendered>;
-export {};
-//# sourceMappingURL=testing.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/client/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,MAAM,EAAQ,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKhE,KAAK,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,SAAS,OAAO,EAAE,CAAC,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,KAAK,kBAAkB,CAAC;IACzF,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,oBAAoB,CAAC;CAC1C;AAqCD,eAAO,MAAM,oBAAoB,kDAA6D,CAAC;AAE/F,wBAAgB,qBAAqB;IAkBnC,iBAAiB,UAAU,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;EAInG;AACD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,IAAI,qCAwB5C;AACD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,YAAY,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AACD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4BtF"}

package/dist/client/testing.js

@@ -1,108 +0,0 @@
-import { RegistryContext } from "@effect/atom-react";
-import { Clock, Effect, Exit, Scope } from "effect";
-import * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { act, createElement } from "react";
-import { createRoot } from "react-dom/client";
-import { beforeEach, expect, vi } from "vitest";
-import { eventually as retry } from "@shivaedev/test/eventually.ts";
-import { withLive } from "@shivaedev/test/withLive.ts";
-const acquireReactWarnings = Effect.acquireRelease(Effect.sync(() => {
-    const errors = vi.spyOn(console, "error").mockImplementation(() => undefined);
-    let consoleErrors;
-    const caughtErrors = [];
-    const expectations = [];
-    const capture = {
-        expectCaughtError: (matches) => {
-            const expectation = { caught: false };
-            expectations.push(expectation);
-            return (error) => {
-                if (matches(error)) {
-                    expectation.caught = true;
-                }
-                else {
-                    caughtErrors.push(error);
-                }
-            };
-        },
-        onCaughtError: (error) => {
-            caughtErrors.push(error);
-        },
-        read: () => ({ caughtErrors: [...caughtErrors], consoleErrors: consoleErrors ?? errors.mock.calls.map((args) => [...args]) }),
-    };
-    return {
-        capture,
-        expectations,
-        restore: () => {
-            consoleErrors = capture.read().consoleErrors;
-            errors.mockRestore();
-        },
-    };
-}), ({ restore }) => Effect.sync(restore));
-export const captureReactWarnings = Effect.map(acquireReactWarnings, ({ capture }) => capture);
-export function expectNoReactWarnings() {
-    let current;
-    beforeEach(({ onTestFinished }) => {
-        const scope = Effect.runSync(Scope.make());
-        current = Effect.runSync(Effect.provideService(acquireReactWarnings, Scope.Scope, scope));
-        const { capture, expectations } = current;
-        onTestFinished(() => {
-            Effect.runSync(Scope.close(scope, Exit.void));
-            const { consoleErrors, caughtErrors } = capture.read();
-            expect(consoleErrors).toEqual([]);
-            expect(caughtErrors, "Unexpected caught React errors").toEqual([]);
-            expect(expectations.every(({ caught }) => caught), "Expected caught React error did not occur").toBe(true);
-        });
-    });
-    return {
-        expectCaughtError(matches) {
-            return current.capture.expectCaughtError(matches);
-        },
-    };
-}
-export function eventually(assert) {
-    return withLive(Effect.gen(function* () {
-        const started = yield* Clock.currentTimeMillis;
-        return yield* retry(Effect.try({ catch: (error) => error, try: assert }), {
-            timeout: "3 seconds",
-            // Responses and React updates must settle together inside act.
-            wait: Effect.promise(() => act(async () => {
-                await new Promise((resolve) => setTimeout(resolve, 10));
-            })),
-        }).pipe(Effect.catch((error) => Effect.gen(function* () {
-            const elapsed = (yield* Clock.currentTimeMillis) - started;
-            return yield* Effect.fail(new Error(`Assertion did not pass after ${elapsed}ms: ${error instanceof Error ? error.message : String(error)}`, { cause: error }));
-        })));
-    }));
-}
-export async function render(node, options) {
-    const registry = AtomRegistry.make();
-    const container = document.createElement("div");
-    document.body.append(container);
-    const root = createRoot(container, options);
-    let mounted = true;
-    async function unmount() {
-        if (!mounted) {
-            return;
-        }
-        mounted = false;
-        try {
-            await act(async () => root.unmount());
-        }
-        finally {
-            registry.dispose();
-            container.remove();
-        }
-    }
-    async function update(next) {
-        await act(async () => root.render(createElement(RegistryContext.Provider, { value: registry }, next)));
-    }
-    try {
-        await update(node);
-    }
-    catch (error) {
-        await unmount();
-        throw error;
-    }
-    return { container, registry, render: update, unmount };
-}
-//# sourceMappingURL=testing.js.map

package/dist/client/testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/client/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAevD,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,CACjD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IAChB,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,aAA0D,CAAC;IAC/D,MAAM,YAAY,GAAc,EAAE,CAAC;IACnC,MAAM,YAAY,GAA0B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAkB;QAC9B,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC9B,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,EAAE,EAAE;gBAChB,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACpB,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACP,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,CAAC;YACF,CAAC,CAAC;QACH,CAAC;QACD,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,aAAa,EAAE,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;KAC7H,CAAC;IACF,OAAO;QACN,OAAO;QACP,YAAY;QACZ,OAAO,EAAE,GAAG,EAAE;YACb,aAAa,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC;YAC7C,MAAM,CAAC,WAAW,EAAE,CAAC;QACtB,CAAC;KACD,CAAC;AACH,CAAC,CAAC,EACF,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;AAE/F,MAAM,UAAU,qBAAqB;IACpC,IAAI,OAAoD,CAAC;IACzD,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1F,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAC1C,cAAc,CAAC,GAAG,EAAE;YACnB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,YAAY,EAAE,gCAAgC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnE,MAAM,CACL,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAC1C,2CAA2C,CAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACN,iBAAiB,CAAC,OAAoC;YACrD,OAAO,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;KACD,CAAC;AACH,CAAC;AACD,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC5C,OAAO,QAAQ,CACd,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC/C,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE;YACzE,OAAO,EAAE,WAAW;YACpB,+DAA+D;YAC/D,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CACzB,GAAG,CAAC,KAAK,IAAI,EAAE;gBACd,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CACF;SACD,CAAC,CAAC,IAAI,CACN,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACtB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnB,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC;YAC3D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACxB,IAAI,KAAK,CAAC,gCAAgC,OAAO,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CACnI,CAAC;QACH,CAAC,CAAC,CACF,CACD,CAAC;IACH,CAAC,CAAC,CACF,CAAC;AACH,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAe,EAAE,OAAqB;IAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,UAAU,OAAO;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO;QACR,CAAC;QACD,OAAO,GAAG,KAAK,CAAC;QAChB,IAAI,CAAC;YACJ,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;gBAAS,CAAC;YACV,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,SAAS,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC;IACF,CAAC;IACD,KAAK,UAAU,MAAM,CAAC,IAAe;QACpC,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,KAAK,CAAC;IACb,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC"}

package/src/client/testing.ts

@@ -1,142 +0,0 @@
-import { RegistryContext } from "@effect/atom-react";
-import { Clock, Effect, Exit, Scope } from "effect";
-import * as AtomRegistry from "effect/reactivity/AtomRegistry";
-import { act, createElement, type ReactNode } from "react";
-import { createRoot, type RootOptions } from "react-dom/client";
-import { beforeEach, expect, vi } from "vitest";
-import { eventually as retry } from "@shivaedev/test/eventually.ts";
-import { withLive } from "@shivaedev/test/withLive.ts";
-
-type CaughtErrorHandler = NonNullable<RootOptions["onCaughtError"]>;
-
-export interface ReactWarningsReadout {
-	readonly caughtErrors: readonly unknown[];
-	readonly consoleErrors: readonly (readonly unknown[])[];
-}
-
-export interface ReactWarnings {
-	readonly expectCaughtError: (matches: (error: unknown) => boolean) => CaughtErrorHandler;
-	readonly onCaughtError: CaughtErrorHandler;
-	readonly read: () => ReactWarningsReadout;
-}
-
-const acquireReactWarnings = Effect.acquireRelease(
-	Effect.sync(() => {
-		const errors = vi.spyOn(console, "error").mockImplementation(() => undefined);
-		let consoleErrors: readonly (readonly unknown[])[] | undefined;
-		const caughtErrors: unknown[] = [];
-		const expectations: { caught: boolean }[] = [];
-		const capture: ReactWarnings = {
-			expectCaughtError: (matches) => {
-				const expectation = { caught: false };
-				expectations.push(expectation);
-				return (error) => {
-					if (matches(error)) {
-						expectation.caught = true;
-					} else {
-						caughtErrors.push(error);
-					}
-				};
-			},
-			onCaughtError: (error) => {
-				caughtErrors.push(error);
-			},
-			read: () => ({ caughtErrors: [...caughtErrors], consoleErrors: consoleErrors ?? errors.mock.calls.map((args) => [...args]) }),
-		};
-		return {
-			capture,
-			expectations,
-			restore: () => {
-				consoleErrors = capture.read().consoleErrors;
-				errors.mockRestore();
-			},
-		};
-	}),
-	({ restore }) => Effect.sync(restore),
-);
-
-export const captureReactWarnings = Effect.map(acquireReactWarnings, ({ capture }) => capture);
-
-export function expectNoReactWarnings() {
-	let current: Effect.Success<typeof acquireReactWarnings>;
-	beforeEach(({ onTestFinished }) => {
-		const scope = Effect.runSync(Scope.make());
-		current = Effect.runSync(Effect.provideService(acquireReactWarnings, Scope.Scope, scope));
-		const { capture, expectations } = current;
-		onTestFinished(() => {
-			Effect.runSync(Scope.close(scope, Exit.void));
-			const { consoleErrors, caughtErrors } = capture.read();
-			expect(consoleErrors).toEqual([]);
-			expect(caughtErrors, "Unexpected caught React errors").toEqual([]);
-			expect(
-				expectations.every(({ caught }) => caught),
-				"Expected caught React error did not occur",
-			).toBe(true);
-		});
-	});
-	return {
-		expectCaughtError(matches: (error: unknown) => boolean): NonNullable<RootOptions["onCaughtError"]> {
-			return current.capture.expectCaughtError(matches);
-		},
-	};
-}
-export function eventually(assert: () => void) {
-	return withLive(
-		Effect.gen(function* () {
-			const started = yield* Clock.currentTimeMillis;
-			return yield* retry(Effect.try({ catch: (error) => error, try: assert }), {
-				timeout: "3 seconds",
-				// Responses and React updates must settle together inside act.
-				wait: Effect.promise(() =>
-					act(async () => {
-						await new Promise<void>((resolve) => setTimeout(resolve, 10));
-					}),
-				),
-			}).pipe(
-				Effect.catch((error) =>
-					Effect.gen(function* () {
-						const elapsed = (yield* Clock.currentTimeMillis) - started;
-						return yield* Effect.fail(
-							new Error(`Assertion did not pass after ${elapsed}ms: ${error instanceof Error ? error.message : String(error)}`, { cause: error }),
-						);
-					}),
-				),
-			);
-		}),
-	);
-}
-export interface Rendered {
-	readonly container: HTMLDivElement;
-	readonly registry: AtomRegistry.AtomRegistry;
-	readonly render: (node: ReactNode) => Promise<void>;
-	readonly unmount: () => Promise<void>;
-}
-export async function render(node: ReactNode, options?: RootOptions): Promise<Rendered> {
-	const registry = AtomRegistry.make();
-	const container = document.createElement("div");
-	document.body.append(container);
-	const root = createRoot(container, options);
-	let mounted = true;
-	async function unmount() {
-		if (!mounted) {
-			return;
-		}
-		mounted = false;
-		try {
-			await act(async () => root.unmount());
-		} finally {
-			registry.dispose();
-			container.remove();
-		}
-	}
-	async function update(next: ReactNode) {
-		await act(async () => root.render(createElement(RegistryContext.Provider, { value: registry }, next)));
-	}
-	try {
-		await update(node);
-	} catch (error) {
-		await unmount();
-		throw error;
-	}
-	return { container, registry, render: update, unmount };
-}