@qilin-agent/client-ui-session 3.1.7 → 3.1.8

package/lib/client.js

@@ -842,6 +842,22 @@ window.__ModuleLoader__.load({
 				return this.sourceFor(owner);
 			}
 			/**
+			* Keep `callback`'s effects installed while the current Peer may call
+			* `action` on one Session resource, with the semantics of
+			* `ctx.remoteAccess.whenAccess`: `useSessionAccess` answers the same
+			* question during render.
+			* @param sessionId - the Session resource the guarded effects depend on.
+			* @param action - endpoint action the guarded effects depend on.
+			* @param callback - creates one disposer or an iterable of disposers.
+			* @returns idempotent disposer owned by the caller's Cordis fiber.
+			*/
+			whenAccess(sessionId, action, callback) {
+				const access = this.ctx.get("remoteAccess");
+				/* v8 ignore next -- this plugin injects remoteAccess, so the service is active while uiSession is reachable. */
+				if (access === void 0) throw new Error("ui-session: whenAccess requires the remoteAccess service");
+				return access.whenResourceAccess("session", sessionId, action, callback);
+			}
+			/**
 			* Register one Session-scoped standard-source contribution.
 			* @param descriptor - static member roster and per-binding resolver.
 			* @returns disposer owned by the caller's Cordis fiber.
@@ -1101,14 +1117,22 @@ window.__ModuleLoader__.load({
 		*/
 		function apply(ctx) {
 			const service = new UiSession(ctx, ctx.sessions);
+			const access = ctx.get("remoteAccess");
 			ctx.slots.provideRoot({
 				hooks: {
 					sessions: ctx.sessions.list,
 					sessionStatus: service.sessionStatus
 				},
-				keyedHooks: { sessionRetainInfo: (key) => ctx.sessions.retainInfo(key) }
+				keyedHooks: {
+					sessionRetainInfo: (key) => ctx.sessions.retainInfo(key),
+					...access === void 0 ? {} : { sessionAccess: (sessionId, action) => typeof action === "string" ? access.source("session", sessionId, action) : void 0 }
+				}
 			});
 			ctx.slots.installScope("session", service.adapter);
+			if (access !== void 0) service.provide({
+				keyedHooks: ["access"],
+				resolve: (binding) => ({ keyedHooks: { access: (action) => access.source("session", binding.sessionId, action) } })
+			});
 		}
 		function sameSessionStatus(left, right) {
 			if (left.size !== right.size) return false;

package/lib/types/client/index.d.ts

@@ -3,6 +3,7 @@ import { Service, type Context } from '@qilin-agent/kylin';
 import type { ISessions, SessionBinding, SessionListState, SessionReference, SessionRetainInfo, SessionSnapshot, UseProjection } from '@qilin-agent/api-session-controller/client';
 import type { SessionId } from '@qilin-agent/session/types';
 import type { HostObservable, KeyedStandardSource, MaybeSnapshotSelectorHook, SlotScopeAdapter, SnapshotSelectorHook, StandardSourceBinding } from '@qilin-agent/client-ui-slots';
+import type { AccessEffect, RemoteEndpoint } from '@qilin-agent/api-remote-access/client/types';
 /** Selector hook over the Session Controller list and current selection. */
 export type UseSessions = SnapshotSelectorHook<SessionListState>;
 /** Selector hook over one Session's lifecycle and control state. */
@@ -73,6 +74,8 @@ declare module '@qilin-agent/client-ui-slots' {
         useSessions: UseSessions;
         useSessionStatus: UseSessionStatus;
         useSessionRetainInfo: UseSessionRetainInfo;
+        /** Whether the current Peer may call `action` on one Session resource. */
+        useSessionAccess: (sessionId: SessionId, action: RemoteEndpoint) => boolean;
     }
     interface SessionStandardProps {
         /** Current Session lifecycle and control state. */
@@ -81,6 +84,8 @@ declare module '@qilin-agent/client-ui-slots' {
         sessionId: SessionId;
         /** Host-computed projection values addressed by projection key. */
         useProjection: UseProjection;
+        /** Whether the current Peer may call `action` on this Session resource. */
+        useAccess: (action: RemoteEndpoint) => boolean;
     }
     interface SessionMaybeStandardProps {
         /** Current Session state, absent while no Session is selected. */
@@ -89,6 +94,8 @@ declare module '@qilin-agent/client-ui-slots' {
         sessionId: SessionId | undefined;
         /** Host-computed projection values; every key is absent without a Session. */
         useProjection: UseProjection;
+        /** The bound Session's access answer; `undefined` without a Session, which callers treat as not allowed. */
+        useAccess: (action: RemoteEndpoint) => boolean | undefined;
     }
 }
 declare module '@qilin-agent/api-session-controller/client' {
@@ -154,6 +161,17 @@ export declare class UiSession extends Service {
      * @throws when the reference does not belong to the active Controller generation.
      */
     bindingSource(reference: SessionReference | undefined): HostObservable<StandardSourceBinding>;
+    /**
+     * Keep `callback`'s effects installed while the current Peer may call
+     * `action` on one Session resource, with the semantics of
+     * `ctx.remoteAccess.whenAccess`: `useSessionAccess` answers the same
+     * question during render.
+     * @param sessionId - the Session resource the guarded effects depend on.
+     * @param action - endpoint action the guarded effects depend on.
+     * @param callback - creates one disposer or an iterable of disposers.
+     * @returns idempotent disposer owned by the caller's Cordis fiber.
+     */
+    whenAccess(sessionId: SessionId, action: RemoteEndpoint, callback: () => AccessEffect): () => void;
     /**
      * Register one Session-scoped standard-source contribution.
      * @param descriptor - static member roster and per-binding resolver.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-session",
   "description": "Session Controller adapter for React and session-scoped slots",
-  "version": "3.1.7",
+  "version": "3.1.8",
   "publishConfig": {
     "access": "public"
   },
@@ -40,19 +40,20 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.5"
+    "@qilin-agent/kylin": "~4.0.6-alpha.2"
   },
   "devDependencies": {
+    "@qilin-agent/api-remote-access": "3.1.8",
+    "@qilin-agent/kylin": "~4.0.6-alpha.2",
+    "@qilin-agent/api-remotes": "3.1.8",
+    "@qilin-agent/api-session-controller": "3.1.8",
+    "@qilin-agent/client-store": "3.1.8",
+    "@qilin-agent/client-ui-renderer": "3.1.8",
+    "@qilin-agent/client-ui-slots": "3.1.8",
+    "@qilin-agent/session": "3.1.8",
+    "@qilin-agent/util-values": "3.1.8",
     "@types/react": "~18.3.1",
-    "react": "^18.2.0",
-    "@qilin-agent/kylin": "~4.0.5",
-    "@qilin-agent/api-session-controller": "3.1.7",
-    "@qilin-agent/client-store": "3.1.7",
-    "@qilin-agent/api-remotes": "3.1.7",
-    "@qilin-agent/client-ui-renderer": "3.1.7",
-    "@qilin-agent/client-ui-slots": "3.1.7",
-    "@qilin-agent/session": "3.1.7",
-    "@qilin-agent/util-values": "3.1.7"
+    "react": "^18.2.0"
   },
   "files": [
     "lib/index.js",