@rahdar/plugin-sdk 2026.11.3 → 2026.11.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rahdar/plugin-sdk",
-  "version": "2026.11.3",
+  "version": "2026.11.5",
   "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": {

package/types/branding.d.ts

@@ -8,7 +8,7 @@
 export declare const branding: {
     readonly productName: "Rahdar";
     readonly productShortName: "Rahdar";
-    readonly tagline: "Cluster-wide management and observability for Apache ActiveMQ Artemis";
+    readonly tagline: "Cluster-wide management and observability for Apache Kafka, RabbitMQ and Apache ActiveMQ Artemis";
     readonly trademarkNotice: string;
     readonly projectUrl: "https://github.com/sudoitir/rahdar";
 };

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

@@ -1316,6 +1316,38 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/clusters/{clusterId}/kafka/brokers/{broker}/config:preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["previewConfig_1"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/clusters/{clusterId}/kafka/brokers/{broker}/config:apply": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["applyConfig_1"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/clusters/{clusterId}/kafka/acls:preview": {
         parameters: {
             query?: never;
@@ -3108,6 +3140,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/clusters/{clusterId}/kafka/brokers/{broker}/config": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["brokerConfig"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/clusters/{clusterId}/kafka/acls": {
         parameters: {
             query?: never;
@@ -4863,7 +4911,7 @@ export interface components {
             scopeId?: string | null;
             /** @description SUBSCRIPTION or DESTINATION: limits the grant to names matching resourcePattern */
             resourceType?: string | null;
-            /** @description An Artemis wildcard pattern, with resourceType; absent for the whole scope */
+            /** @description A wildcard pattern over resource names (. separates words, * matches one word, # any number of words), with resourceType; absent for the whole scope */
             resourcePattern?: string | null;
         };
         CreatedTokenView: {
@@ -5313,7 +5361,7 @@ export interface components {
             notifications: components["schemas"]["CapabilityView"];
             messageIo: components["schemas"]["CapabilityView"];
             slowConsumerDetection: components["schemas"]["CapabilityView"];
-            /** @description Operations that need a newer Artemis release than some node runs */
+            /** @description Operations that need a newer broker release than some node runs */
             versionGates: components["schemas"]["VersionGateView"][];
             /** @description Every capability the system's driver assessed for the account, with its own reason. Empty for a system whose capabilities are the fixed ones above. */
             findings: components["schemas"]["AccessFinding"][];
@@ -5415,7 +5463,7 @@ export interface components {
             replicaSync?: boolean | null;
             version?: string | null;
             /**
-             * @description Where version sits against the supported Artemis range
+             * @description Where version sits against the range Rahdar supports for the node's system
              * @enum {string}
              */
             versionSupport: "SUPPORTED" | "BELOW_MINIMUM" | "NEWER_THAN_TESTED" | "UNKNOWN";
@@ -8901,6 +8949,28 @@ export interface components {
             lag?: number | null;
             caughtUp: boolean;
         };
+        BrokerConfig: {
+            /** @description The broker id, or default for the cluster-wide default. */
+            broker: string;
+            clusterDefault: boolean;
+            /** @description Settings with a value; secrets are never listed. */
+            entries: components["schemas"]["BrokerConfigEntry"][];
+            /** @description Why the restart-only settings are not marked, when the cluster does not say. */
+            note?: string | null;
+        };
+        BrokerConfigEntry: {
+            name: string;
+            value: string;
+            /**
+             * @description Where the value is set: this broker, the cluster default, its file or built in.
+             * @enum {string}
+             */
+            source: "NODE" | "CLUSTER" | "STATIC" | "DEFAULT";
+            /** @description Whether only a restart of the broker changes it. */
+            readOnly: boolean;
+            /** @description ms, bytes or the like, when the value is a quantity. */
+            unit?: string | null;
+        };
         AclPage: {
             /** @description False where the cluster has no authorizer. */
             available: boolean;
@@ -17578,6 +17648,147 @@ export interface operations {
             };
         };
     };
+    previewConfig_1: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes the request safe to retry. Within 24 hours a repeat by the same user with the same method, path, query and body returns the first result with `Idempotent-Replayed: true` and applies nothing again. The same key with another request is 422 `idempotency-key-reused`; while the first is still running it is 409 `idempotency-in-progress`. 1 to 255 printable ASCII characters; not accepted on multipart uploads. Server errors and 401, 403 and 429 are not recorded, so the retry runs. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                clusterId: string;
+                broker: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ConfigChangeRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": components["schemas"]["ConfigPreview"];
+                };
+            };
+            /** @description Too many requests. Wait for Retry-After seconds. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: number;
+                    /** @description Requests allowed in the window (API tokens). */
+                    "RateLimit-Limit"?: number;
+                    /** @description Requests left in the window (API tokens). */
+                    "RateLimit-Remaining"?: number;
+                    /** @description Seconds until the window resets (API tokens). */
+                    "RateLimit-Reset"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Client error */
+            "4XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Server error */
+            "5XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
+    applyConfig_1: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes the request safe to retry. Within 24 hours a repeat by the same user with the same method, path, query and body returns the first result with `Idempotent-Replayed: true` and applies nothing again. The same key with another request is 422 `idempotency-key-reused`; while the first is still running it is 409 `idempotency-in-progress`. 1 to 255 printable ASCII characters; not accepted on multipart uploads. Server errors and 401, 403 and 429 are not recorded, so the retry runs. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                clusterId: string;
+                broker: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ConfigChangeRequest"];
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": components["schemas"]["ConfigPreview"];
+                };
+            };
+            /** @description Held for approval: the operation has not run. X-Rahdar-Held-Operation names the request. */
+            202: {
+                headers: {
+                    /** @description The held operation's id, when the operation was held. */
+                    "X-Rahdar-Held-Operation"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HeldOutcome"];
+                };
+            };
+            /** @description Too many requests. Wait for Retry-After seconds. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: number;
+                    /** @description Requests allowed in the window (API tokens). */
+                    "RateLimit-Limit"?: number;
+                    /** @description Requests left in the window (API tokens). */
+                    "RateLimit-Remaining"?: number;
+                    /** @description Seconds until the window resets (API tokens). */
+                    "RateLimit-Reset"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Client error */
+            "4XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Server error */
+            "5XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
     previewAcls: {
         parameters: {
             query?: never;
@@ -25366,6 +25577,64 @@ export interface operations {
             };
         };
     };
+    brokerConfig: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                clusterId: string;
+                broker: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": components["schemas"]["BrokerConfig"];
+                };
+            };
+            /** @description Too many requests. Wait for Retry-After seconds. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: number;
+                    /** @description Requests allowed in the window (API tokens). */
+                    "RateLimit-Limit"?: number;
+                    /** @description Requests left in the window (API tokens). */
+                    "RateLimit-Remaining"?: number;
+                    /** @description Seconds until the window resets (API tokens). */
+                    "RateLimit-Reset"?: number;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Client error */
+            "4XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Server error */
+            "5XX": {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
     acls: {
         parameters: {
             query?: {

package/types/ui/CapabilityReason.d.ts

@@ -1,7 +1,8 @@
 /**
- * Why a control is unavailable, in full: the reason, and the `broker.xml` that enables it where one
- * exists (non-negotiable #5). The one rendering of it, shared by the {@link CapabilityGate} popover
- * and the explanation a blocked menu item opens, so both say the same thing the same way.
+ * Why a control is unavailable, in full: the reason, and the change that enables it where one exists
+ * (non-negotiable #5): the `broker.xml` snippet on Artemis, the command or setting on Kafka and RabbitMQ.
+ * The one rendering of it, shared by the {@link CapabilityGate} popover and the explanation a blocked
+ * menu item opens, so both say the same thing the same way.
  */
 export declare function CapabilityReason({ reason, snippet, size, }: Readonly<{
     reason: string;