@astrale-os/shell-react 0.4.0-beta.10 → 0.4.0-beta.11

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.4.0-beta.11](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.10...shell-react-v0.4.0-beta.11) (2026-09-03)
+
+
+### Bug Fixes
+
+* **react:** allow id-only action receivers ([#167](https://github.com/astrale-os/shell/issues/167)) ([7f75975](https://github.com/astrale-os/shell/commit/7f759753864033e9593bb70080fa8b8c5a5157c0))
+
 ## [0.4.0-beta.10](https://github.com/astrale-os/shell/compare/shell-react-v0.4.0-beta.9...shell-react-v0.4.0-beta.10) (2026-09-01)
 
 

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export type { ActAsProps, PolicyObject } from './auth/index.js';
 export { ClientError, NodeUnavailableError, ProtocolError, ResponseError, StaleRouteError, TransportError, isClientError, isNodeUnavailableError, useCall, useGraphStore, useQuery, useStream, } from './graph/index.js';
 export type { CallOptions, GraphResource, GraphResourceState, GraphStore, QueryResourceOptions, StreamHandle, StreamOptions, } from './graph/index.js';
 export { DomainProvider, RelationUnavailableError, queryRefresh, useAction, useDomain, useDomains, useDynamicDomain, useDynamicObject, useKernel, useMutation, useObject, useRelation, } from './schema/index.js';
-export type { ActionOptions, ActionRefresh, DomainProviderProps, DomainAction, MutationOptions, QueryRefresh, RelationOptions, RelationResource, RelationUnavailable, RichReadOptions, } from './schema/index.js';
+export type { ActionReceiver, ActionOptions, ActionRefresh, DomainProviderProps, DomainAction, MutationOptions, QueryRefresh, RelationOptions, RelationResource, RelationUnavailable, RichReadOptions, } from './schema/index.js';
 export { Link, NavigationScope, NavScope, NodeLink, pathParam, ViewLink, defineNavigation, enumParam, location, memoryAdapter, urlAdapter, useAncestors, useLocation, useNavigate, useNavigation, useNavScope, } from './navigation/index.js';
 export type { LinkProps, LocationDefinition, MissingPolicy, NavAdapter, NavLocation, NavScopeHandle, NavScopeProps, NavSnapshot, NavTarget, NavigationDefinition, NavigationParam, NavigationParams, NavigationRoutes, NavigationTarget, NodeLinkProps, Navigate, SerializedLocation, ViewLinkProps, } from './navigation/index.js';
 export { SelectionScope, useSelection } from './selection/index.js';

package/dist/schema/action.hook.d.ts

@@ -1,13 +1,16 @@
-import type { BoundNodeFor } from '@astrale-os/sdk/client';
 import type { SessionRequestOptions } from '@astrale-os/sdk/client/session';
+import type { NodeId } from '@astrale-os/sdk/graph/node';
 import type { QueryAST, QueryDefinition } from '@astrale-os/sdk/query';
 import type { Domain } from '@astrale-os/sdk/schema';
-import type { CallableInputOf, CallableResultOf, MethodOwnerKeyOf, MethodInheritance, ResolvedFunction, ResolvedMethod } from '@astrale-os/sdk/schema';
+import type { CallableInputOf, CallableResultOf, MethodInheritance, ResolvedFunction, ResolvedMethod } from '@astrale-os/sdk/schema';
 type ExecutableInheritance = Exclude<MethodInheritance, 'abstract'>;
 type InstanceMethod = ResolvedMethod<unknown, unknown, false, ExecutableInheritance>;
 type StaticMethod = ResolvedMethod<unknown, unknown, true, ExecutableInheritance>;
 type Callable = ResolvedFunction | InstanceMethod | StaticMethod;
-type MethodReceiver<C extends InstanceMethod> = BoundNodeFor<MethodOwnerKeyOf<C>>;
+/** Stable identity of an instance Method receiver; the Kernel resolves and authorizes its Class. */
+export interface ActionReceiver {
+    readonly id: NodeId;
+}
 declare const QUERY_REFRESH: unique symbol;
 export interface QueryRefresh {
     readonly id: string;
@@ -27,7 +30,7 @@ export interface ActionOptions extends SessionRequestOptions {
     readonly refresh?: ActionRefresh;
     readonly onError?: (error: unknown) => void;
 }
-type ActionArgs<C extends Callable> = C extends InstanceMethod ? [receiver: MethodReceiver<C>, input: CallableInputOf<C>] : [input: CallableInputOf<C>];
+type ActionArgs<C extends Callable> = C extends InstanceMethod ? [receiver: ActionReceiver, input: CallableInputOf<C>] : [input: CallableInputOf<C>];
 export interface DomainAction<Args extends unknown[], Result> {
     run(...args: Args): Promise<Result>;
     readonly pending: boolean;

package/dist/schema/index.d.ts

@@ -3,6 +3,7 @@ export { useDomain, useDomains, useDynamicDomain } from './domain.hook.js';
 export { DomainProvider } from './domain.context.js';
 export type { DomainProviderProps } from './domain.context.js';
 export { queryRefresh, useAction } from './action.hook.js';
+export type { ActionReceiver } from './action.hook.js';
 export type { ActionOptions, ActionRefresh, DomainAction, QueryRefresh } from './action.hook.js';
 export { useMutation } from './mutation.hook.js';
 export type { MutationOptions } from './mutation.hook.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.4.0-beta.10",
+  "version": "0.4.0-beta.11",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@astrale-os/sdk": "0.5.0-beta.99",
+    "@astrale-os/sdk": "0.5.0-beta.101",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^26.2.0",
@@ -46,7 +46,7 @@
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@astrale-os/sdk": ">=0.5.0-beta.99 <1.0.0",
+    "@astrale-os/sdk": ">=0.5.0-beta.101 <1.0.0",
     "react": ">=18",
     "react-dom": ">=18"
   },

package/src/index.ts

@@ -53,6 +53,7 @@ export {
   useRelation,
 } from './schema/index.js'
 export type {
+  ActionReceiver,
   ActionOptions,
   ActionRefresh,
   DomainProviderProps,

package/src/schema/action.hook.ts

@@ -1,4 +1,3 @@
-import type { BoundNodeFor } from '@astrale-os/sdk/client'
 import type { SessionRequestOptions } from '@astrale-os/sdk/client/session'
 import type { NodeId } from '@astrale-os/sdk/graph/node'
 import type { QueryAST, QueryDefinition } from '@astrale-os/sdk/query'
@@ -6,7 +5,6 @@ import type { Domain } from '@astrale-os/sdk/schema'
 import type {
   CallableInputOf,
   CallableResultOf,
-  MethodOwnerKeyOf,
   MethodInheritance,
   ResolvedFunction,
   ResolvedMethod,
@@ -28,8 +26,11 @@ type ExecutableInheritance = Exclude<MethodInheritance, 'abstract'>
 type InstanceMethod = ResolvedMethod<unknown, unknown, false, ExecutableInheritance>
 type StaticMethod = ResolvedMethod<unknown, unknown, true, ExecutableInheritance>
 type Callable = ResolvedFunction | InstanceMethod | StaticMethod
-type Receiver = { readonly id: NodeId }
-type MethodReceiver<C extends InstanceMethod> = BoundNodeFor<MethodOwnerKeyOf<C>>
+
+/** Stable identity of an instance Method receiver; the Kernel resolves and authorizes its Class. */
+export interface ActionReceiver {
+  readonly id: NodeId
+}
 
 const QUERY_REFRESH = Symbol('shell-react.query-refresh')
 
@@ -76,7 +77,7 @@ export interface ActionOptions extends SessionRequestOptions {
 }
 
 type ActionArgs<C extends Callable> = C extends InstanceMethod
-  ? [receiver: MethodReceiver<C>, input: CallableInputOf<C>]
+  ? [receiver: ActionReceiver, input: CallableInputOf<C>]
   : [input: CallableInputOf<C>]
 
 export interface DomainAction<Args extends unknown[], Result> {
@@ -110,7 +111,10 @@ export function useAction<C extends Callable>(
       try {
         const result = isInstanceMethod(current)
           ? await kernel.session.invoke(
-              reference(bindingRef.current.domain, current)(receiverPath(args[0] as Receiver)),
+              reference(
+                bindingRef.current.domain,
+                current,
+              )(receiverPath(args[0] as ActionReceiver)),
               args[1] as never,
               request,
             )
@@ -161,7 +165,7 @@ function isInstanceMethod(callable: Callable): callable is InstanceMethod {
   return 'owner' in callable && callable.static === false
 }
 
-function receiverPath(receiver: Receiver): Path {
+function receiverPath(receiver: ActionReceiver): Path {
   return Path.id(receiver.id)
 }
 

package/src/schema/index.ts

@@ -3,6 +3,7 @@ export { useDomain, useDomains, useDynamicDomain } from './domain.hook.js'
 export { DomainProvider } from './domain.context.js'
 export type { DomainProviderProps } from './domain.context.js'
 export { queryRefresh, useAction } from './action.hook.js'
+export type { ActionReceiver } from './action.hook.js'
 export type { ActionOptions, ActionRefresh, DomainAction, QueryRefresh } from './action.hook.js'
 export { useMutation } from './mutation.hook.js'
 export type { MutationOptions } from './mutation.hook.js'