@rahdar/plugin-sdk 2026.10.51 → 2026.10.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rahdar/plugin-sdk",
-  "version": "2026.10.51",
+  "version": "2026.10.57",
   "description": "Build the UI of a Rahdar plugin: typings for the Rahdar APIs a plugin may use, and a Vite preset.",
   "license": "Apache-2.0",
   "repository": {
@@ -32,8 +32,8 @@
   ],
   "sideEffects": false,
   "peerDependencies": {
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
     "@mantine/core": "9.7.2",
     "@mantine/hooks": "9.7.2",
     "@tanstack/react-query": "5.104.1",

package/peers.json

@@ -1,6 +1,6 @@
 {
-  "react": "19.3.0",
-  "react-dom": "19.3.0",
+  "react": "19.3.1",
+  "react-dom": "19.3.1",
   "@mantine/core": "9.7.2",
   "@mantine/hooks": "9.7.2",
   "@tanstack/react-query": "5.104.1",

package/types/kernel/actions/types.d.ts

@@ -1,6 +1,8 @@
 import type { ComponentType, ReactNode } from 'react';
+import type { ResourceRef } from '../api/resourceId.ts';
 import type { components } from '../api/schema.d.ts';
 import type { GateVerdict } from '../../ui/capabilityGate.ts';
+export type { ResourceRef };
 type Schemas = components['schemas'];
 /**
  * The sections of a row's action menu, in the order it shows them (ADR-0107). The list is closed,
@@ -25,65 +27,65 @@ export type ActionSection = (typeof ACTION_SECTIONS)[number]['id'];
  * change the broker (Flow).
  */
 export type ActionMode = 'act' | 'navigate';
-export interface QueueTarget {
-    queueName: string;
-    address?: string | null;
-    snapshot?: Schemas['QueueView'];
+export interface SubscriptionTarget extends ResourceRef {
+    /** The canonical id of the destination it is bound to. */
+    destination?: string | null;
+    snapshot?: Schemas['SubscriptionView'];
 }
-export interface AddressTarget {
-    address: string;
-    snapshot?: Schemas['AddressView'];
+export interface DestinationTarget extends ResourceRef {
+    snapshot?: Schemas['DestinationView'];
 }
-/** Connections, sessions, consumers and producers are per node; a close needs to know which. */
+/** Connections, channels, consumers and producers are per node; a close needs to know which. */
 interface NodeScoped {
     nodeId: string;
     nodeName: string;
 }
-export interface ConnectionTarget extends NodeScoped {
-    connectionId: string;
+export interface ConnectionTarget extends ResourceRef, NodeScoped {
     snapshot?: Schemas['ConnectionView'];
 }
-export interface SessionTarget extends NodeScoped {
-    sessionId: string;
-    connectionId?: string | null;
-    snapshot?: Schemas['SessionView'];
+export interface ChannelTarget extends ResourceRef, NodeScoped {
+    /** The name of the connection the channel belongs to. */
+    connection?: string | null;
+    snapshot?: Schemas['ChannelView'];
 }
-export interface ConsumerTarget extends NodeScoped {
-    consumerId: string;
-    queueName?: string | null;
-    sessionId?: string | null;
+export interface ConsumerTarget extends ResourceRef, NodeScoped {
+    /** The canonical id of the subscription it consumes from. */
+    subscription?: string | null;
+    /** The name of the channel it belongs to. */
+    channel?: string | null;
     snapshot?: Schemas['ConsumerView'];
 }
-export interface ProducerTarget extends NodeScoped {
-    producerId: string;
-    address?: string | null;
-    sessionId?: string | null;
+export interface ProducerTarget extends ResourceRef, NodeScoped {
+    /** The canonical id of the destination it sends to. */
+    destination?: string | null;
+    /** The name of the channel it belongs to. */
+    channel?: string | null;
     snapshot?: Schemas['ProducerView'];
 }
 export interface MessageTarget {
-    queueName: string;
-    messageId: number;
+    /** The subscription the message sits in. */
+    subscription: ResourceRef;
+    position: string;
     /** The node the message was browsed on; absent for the live node. */
     node?: string;
 }
-export interface DivertTarget {
-    name: string;
-    snapshot?: Schemas['DivertView'];
+export interface RouteTarget extends ResourceRef {
+    snapshot?: Schemas['RouteView'];
 }
 /** A client of the flow view: an identity that may stand for many connections. */
 export interface ClientTarget {
     label: string;
 }
-/** Each resource kind a row menu or a link can be about, with its target. */
+/** Each resource role a row menu or a link can be about, with its target. */
 export interface ActionTargets {
-    queue: QueueTarget;
-    address: AddressTarget;
+    destination: DestinationTarget;
+    subscription: SubscriptionTarget;
+    route: RouteTarget;
     connection: ConnectionTarget;
-    session: SessionTarget;
+    channel: ChannelTarget;
     consumer: ConsumerTarget;
     producer: ProducerTarget;
     message: MessageTarget;
-    divert: DivertTarget;
     client: ClientTarget;
 }
 export type ActionKind = keyof ActionTargets;
@@ -111,7 +113,7 @@ export interface ActionHost {
     explain(verdict: Blocked, what: string, options?: {
         restoreFocus?: () => void;
     }): void;
-    /** Copies `text` and says so; `what` names it ("queue name"). */
+    /** Copies `text` and says so; `what` names it ("subscription name"). */
     copy(text: string, what: string): void;
 }
 /** What a row-action contribution is given. */
@@ -127,4 +129,3 @@ export interface LinkProps<T> {
     target: T;
     children: ReactNode;
 }
-export {};

package/types/kernel/api/paging.d.ts

@@ -33,7 +33,10 @@ export interface ResourceParams {
     size?: number;
 }
 export declare function resourceSearch(params: ResourceParams): string;
-/** One page of a cluster-wide listing (queues, addresses, consumers, …), refetched on the usual interval. */
-export declare function useResource<T>(id: string, kind: string, params: ResourceParams): UseQueryResult<PagedView<T>, ApiError>;
+/**
+ * One page of a cluster-wide listing (subscriptions, destinations, consumers, …), refetched on the usual interval.
+ * `topic` names the stream topic that invalidates it; `path` is the route when that is another word.
+ */
+export declare function useResource<T>(id: string, topic: string, params: ResourceParams, path?: string): UseQueryResult<PagedView<T>, ApiError>;
 /** Rows in the envelope every list endpoint answers with, for the fixtures that stand in for one. */
 export declare function paged<T>(data: T[]): PagedView<T>;

package/types/kernel/api/request.d.ts

@@ -29,7 +29,7 @@ export declare class ApiError extends Error {
 /** What the server says about an operation it held for approval instead of running. */
 export interface HeldOperation {
     id: string;
-    /** What the operation would do, in words, such as `Purge queue "orders" on prod`. */
+    /** What the operation would do, in words, such as `Purge subscription "orders" on prod`. */
     summary: string;
     /** When the request lapses unless someone decides it, as an ISO instant. */
     expiresAt: string;
@@ -81,4 +81,4 @@ export interface LifecycleVars {
     dryRun?: boolean;
     override?: boolean;
 }
-export declare function lifecycleQuery(dryRun?: boolean, override?: boolean): string;
+export declare function lifecycleQuery(dryRun?: boolean, override?: boolean, node?: string): string;

package/types/kernel/api/resourceId.d.ts

@@ -0,0 +1,32 @@
+/** The canonical id of the resource of this kind with this path, outermost segment first. */
+export declare function resourceId(kind: string, ...path: string[]): string;
+/** The kind of a canonical id. */
+export declare function kindOf(id: string): string;
+/** The name of a canonical id: its last segment, decoded. Empty for no id. */
+export declare function nameOf(id: string | null | undefined): string;
+/** What identifies a resource wherever a screen or a plugin is handed one: its canonical id, kind and name. */
+export interface ResourceRef {
+    /** The resource's canonical id, which an API call names. */
+    id: string;
+    /** The id of its kind, such as `artemis.queue`. */
+    kind: string;
+    /** Its name, which a filter and a copy use. */
+    name: string;
+}
+/** The reference of a canonical id. */
+export declare function refOf(id: string): ResourceRef;
+/** `/resources/{kind}/{path}` of a canonical id, ready to follow with `:pause`, `/messages` and the like. */
+export declare function resourcePath(id: string): string;
+/** The kinds a cluster's system offers, as the cluster view lists them. */
+export type ClusterKinds = ReadonlyArray<{
+    id: string;
+    resourceClass: string;
+}>;
+/** The roles a screen that holds only a name needs an id for. */
+export type Role = 'SUBSCRIPTION' | 'DESTINATION';
+/** The kind that plays this role in the cluster's system. */
+export declare function kindOfRole(kinds: ClusterKinds | undefined, role: Role): string;
+/** The id of the subscription of this name; for a screen that holds a name and no row (a URL param, a picker). */
+export declare const subscriptionId: (kinds: ClusterKinds | undefined, name: string) => string;
+/** The id of the destination of this name, built as {@link subscriptionId} builds a subscription's. */
+export declare const destinationId: (kinds: ClusterKinds | undefined, name: string) => string;