@rahdar/plugin-sdk 2026.11.1 → 2026.11.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rahdar/plugin-sdk",
-  "version": "2026.11.1",
+  "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,13 +5463,16 @@ 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";
             lastError?: string | null;
-            /** @enum {string|null} */
-            lastErrorKind?: "UNREACHABLE" | "THROTTLED" | "CREDENTIALS_REJECTED" | "NOT_ARTEMIS" | "WRONG_PATH" | "TLS_FAILED" | "BAD_RESPONSE" | "UNSUPPORTED_VERSION" | null;
+            /**
+             * @description Why the last call to the node failed. NOT_AUTHORIZED means the broker knows the account but an ACL or permission refused the call.
+             * @enum {string|null}
+             */
+            lastErrorKind?: "UNREACHABLE" | "THROTTLED" | "CREDENTIALS_REJECTED" | "NOT_AUTHORIZED" | "NOT_ARTEMIS" | "WRONG_PATH" | "TLS_FAILED" | "BAD_RESPONSE" | "UNSUPPORTED_VERSION" | null;
             /** Format: date-time */
             lastSeenAt?: string | null;
             /**
@@ -7962,6 +8013,8 @@ export interface components {
                 message?: string;
             }[];
             brokerErrorKind?: string;
+            /** @description Kafka, RabbitMQ or Artemis: the system a broker failure is of. */
+            system?: string;
             /** @description MANAGEMENT or CORE: the account a broker rejected. */
             account?: string;
             refusalKind?: string;
@@ -8896,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;
@@ -17573,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;
@@ -25361,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;