@meshery/schemas 1.3.25 → 1.3.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/dist/cloudApi.d.mts +1690 -1690
  2. package/dist/cloudApi.d.ts +1690 -1690
  3. package/dist/constructs/v1beta1/category/CategorySchema.js +1 -1
  4. package/dist/constructs/v1beta1/category/CategorySchema.mjs +1 -1
  5. package/dist/constructs/v1beta1/component/ComponentSchema.js +1 -1
  6. package/dist/constructs/v1beta1/component/ComponentSchema.mjs +1 -1
  7. package/dist/constructs/v1beta1/evaluation/EvaluationSchema.js +4 -4
  8. package/dist/constructs/v1beta1/evaluation/EvaluationSchema.mjs +4 -4
  9. package/dist/constructs/v1beta1/model/ModelSchema.js +3 -3
  10. package/dist/constructs/v1beta1/model/ModelSchema.mjs +3 -3
  11. package/dist/constructs/v1beta1/pattern/PatternSchema.js +11 -11
  12. package/dist/constructs/v1beta1/pattern/PatternSchema.mjs +11 -11
  13. package/dist/constructs/v1beta1/system/System.d.ts +445 -0
  14. package/dist/constructs/v1beta1/system/SystemSchema.js +1 -1
  15. package/dist/constructs/v1beta1/system/SystemSchema.mjs +1 -1
  16. package/dist/constructs/v1beta1/workspace/WorkspaceSchema.js +2 -2
  17. package/dist/constructs/v1beta1/workspace/WorkspaceSchema.mjs +2 -2
  18. package/dist/constructs/v1beta2/component/ComponentSchema.js +1 -1
  19. package/dist/constructs/v1beta2/component/ComponentSchema.mjs +1 -1
  20. package/dist/constructs/v1beta2/design/DesignSchema.js +22 -22
  21. package/dist/constructs/v1beta2/design/DesignSchema.mjs +22 -22
  22. package/dist/constructs/v1beta2/model/ModelSchema.js +3 -3
  23. package/dist/constructs/v1beta2/model/ModelSchema.mjs +3 -3
  24. package/dist/constructs/v1beta2/relationship/RelationshipSchema.js +1 -1
  25. package/dist/constructs/v1beta2/relationship/RelationshipSchema.mjs +1 -1
  26. package/dist/constructs/v1beta2/user/UserSchema.js +1 -1
  27. package/dist/constructs/v1beta2/user/UserSchema.mjs +1 -1
  28. package/dist/constructs/v1beta3/component/ComponentSchema.js +1 -1
  29. package/dist/constructs/v1beta3/component/ComponentSchema.mjs +1 -1
  30. package/dist/constructs/v1beta3/connection/Connection.d.ts +444 -0
  31. package/dist/constructs/v1beta3/connection/ConnectionSchema.js +1 -1
  32. package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +1 -1
  33. package/dist/constructs/v1beta3/design/DesignSchema.js +2 -2
  34. package/dist/constructs/v1beta3/design/DesignSchema.mjs +2 -2
  35. package/dist/constructs/v1beta3/user/UserSchema.js +1 -1
  36. package/dist/constructs/v1beta3/user/UserSchema.mjs +1 -1
  37. package/dist/constructs/v1beta3/workspace/WorkspaceSchema.js +2 -2
  38. package/dist/constructs/v1beta3/workspace/WorkspaceSchema.mjs +2 -2
  39. package/dist/index.js +42 -42
  40. package/dist/index.mjs +42 -42
  41. package/dist/mesheryApi.d.mts +2096 -695
  42. package/dist/mesheryApi.d.ts +2096 -695
  43. package/dist/mesheryApi.js +1 -1
  44. package/dist/mesheryApi.mjs +1 -1
  45. package/package.json +1 -1
@@ -104,6 +104,106 @@ export interface paths {
104
104
  patch?: never;
105
105
  trace?: never;
106
106
  };
107
+ "/api/system/controllers/operator/status": {
108
+ parameters: {
109
+ query?: never;
110
+ header?: never;
111
+ path?: never;
112
+ cookie?: never;
113
+ };
114
+ /**
115
+ * Get the Meshery Operator status for a connection
116
+ * @description Returns the current status of the Meshery Operator controller for the given kubernetes connection. Replaces the getOperatorStatus GraphQL query.
117
+ */
118
+ get: operations["getOperatorControllerStatus"];
119
+ put?: never;
120
+ post?: never;
121
+ delete?: never;
122
+ options?: never;
123
+ head?: never;
124
+ patch?: never;
125
+ trace?: never;
126
+ };
127
+ "/api/system/controllers/meshsync/status": {
128
+ parameters: {
129
+ query?: never;
130
+ header?: never;
131
+ path?: never;
132
+ cookie?: never;
133
+ };
134
+ /**
135
+ * Get the MeshSync controller status for a connection
136
+ * @description Returns the current status of the MeshSync controller for the given kubernetes connection. Replaces the getMeshsyncStatus GraphQL query.
137
+ */
138
+ get: operations["getMeshsyncControllerStatus"];
139
+ put?: never;
140
+ post?: never;
141
+ delete?: never;
142
+ options?: never;
143
+ head?: never;
144
+ patch?: never;
145
+ trace?: never;
146
+ };
147
+ "/api/system/controllers/broker/status": {
148
+ parameters: {
149
+ query?: never;
150
+ header?: never;
151
+ path?: never;
152
+ cookie?: never;
153
+ };
154
+ /**
155
+ * Get the Meshery Broker (NATS) controller status for a connection
156
+ * @description Returns the current status of the Meshery Broker (NATS) controller for the given kubernetes connection. Replaces the getNatsStatus GraphQL query.
157
+ */
158
+ get: operations["getBrokerControllerStatus"];
159
+ put?: never;
160
+ post?: never;
161
+ delete?: never;
162
+ options?: never;
163
+ head?: never;
164
+ patch?: never;
165
+ trace?: never;
166
+ };
167
+ "/api/system/controllers/diagnostics": {
168
+ parameters: {
169
+ query?: never;
170
+ header?: never;
171
+ path?: never;
172
+ cookie?: never;
173
+ };
174
+ /**
175
+ * Get controller diagnostics and remediation for a connection
176
+ * @description Returns human-actionable diagnostics for a kubernetes connection's Meshery controllers (operator, MeshSync, broker), derived from their current status and Meshery's live broker connection. Each diagnostic carries a severity, a summary, an explanation, and concrete remediation steps so the UI can render a "Diagnostics" section in the connection detail view. An empty diagnostics list (with healthy=true) means no problems were detected.
177
+ */
178
+ get: operations["getControllerDiagnostics"];
179
+ put?: never;
180
+ post?: never;
181
+ delete?: never;
182
+ options?: never;
183
+ head?: never;
184
+ patch?: never;
185
+ trace?: never;
186
+ };
187
+ "/api/system/controllers/status/subscribe": {
188
+ parameters: {
189
+ query?: never;
190
+ header?: never;
191
+ path?: never;
192
+ cookie?: never;
193
+ };
194
+ /**
195
+ * Stream Meshery controller status over Server-Sent Events
196
+ * @description Server-Sent Events (SSE) stream of controller status (operator, MeshSync, broker) for the requested kubernetes connections. Replaces the subscribeMesheryControllersStatus GraphQL subscription. The server emits the full status array as an unnamed SSE event (`data: <json>` followed by a blank line) on subscribe and again whenever any controller's status changes; a comment keepalive is sent periodically. Consume with a native EventSource, not a buffered JSON client.
197
+ */
198
+ get: operations["subscribeControllersStatus"];
199
+ put?: never;
200
+ post?: never;
201
+ delete?: never;
202
+ options?: never;
203
+ head?: never;
204
+ patch?: never;
205
+ trace?: never;
206
+ };
107
207
  }
108
208
  export type webhooks = Record<string, never>;
109
209
  export interface components {
@@ -137,6 +237,93 @@ export interface components {
137
237
  /** @description Human-readable status message. */
138
238
  message: string;
139
239
  };
240
+ /** @description Status of a single Meshery controller (operator, MeshSync, or broker) for a kubernetes connection. Element type of the controller-status SSE stream and the operator status response. */
241
+ ControllerStatus: {
242
+ /**
243
+ * Format: uuid
244
+ * @description The kubernetes connection ID this status belongs to.
245
+ */
246
+ connectionId: string;
247
+ /**
248
+ * @description The controller this status describes.
249
+ * @enum {string}
250
+ */
251
+ controller: "OPERATOR" | "MESHSYNC" | "BROKER";
252
+ /** @description Current controller status (e.g. DEPLOYED, NOTDEPLOYED, RUNNING, CONNECTED, UNKNOWN). */
253
+ status: string;
254
+ /** @description Deployed controller version, when known. */
255
+ version: string;
256
+ };
257
+ /** @description Detailed status of a named Meshery controller (MeshSync or Broker) for a kubernetes connection. */
258
+ ControllerInfo: {
259
+ /** @description Controller name (e.g. MeshSync, MesheryBroker). */
260
+ name: string;
261
+ /** @description Deployed controller version, when known. */
262
+ version: string;
263
+ /** @description Current controller status. May be composed, e.g. "Connected <endpoint>". */
264
+ status: string;
265
+ /**
266
+ * Format: uuid
267
+ * @description The kubernetes connection ID this status belongs to.
268
+ */
269
+ connectionId: string;
270
+ };
271
+ /** @description A single human-actionable diagnostic about a kubernetes connection's Meshery controllers, with an explanation and remediation steps. */
272
+ ControllerDiagnostic: {
273
+ /**
274
+ * @description How serious the diagnostic is.
275
+ * @enum {string}
276
+ */
277
+ severity: "info" | "warning" | "error";
278
+ /**
279
+ * @description The controller this diagnostic concerns, when applicable.
280
+ * @enum {string}
281
+ */
282
+ controller?: "OPERATOR" | "MESHSYNC" | "BROKER";
283
+ /** @description Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on. */
284
+ code: string;
285
+ /** @description Short, human-readable title for the diagnostic. */
286
+ summary: string;
287
+ /** @description A fuller explanation of what is wrong and why. */
288
+ description?: string;
289
+ /** @description Ordered, concrete steps the user can take to resolve the issue. */
290
+ remediation?: string[];
291
+ /** @description A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable). */
292
+ endpoint?: string;
293
+ };
294
+ /** @description Diagnostics for a kubernetes connection's Meshery controllers, for rendering a "Diagnostics" section in the connection detail view. */
295
+ ConnectionDiagnostics: {
296
+ /**
297
+ * Format: uuid
298
+ * @description The kubernetes connection ID these diagnostics belong to.
299
+ */
300
+ connectionId: string;
301
+ /** @description True when no warning/error diagnostics were detected (informational diagnostics do not affect health). */
302
+ healthy: boolean;
303
+ /** @description The diagnostics detected for this connection (possibly empty). */
304
+ diagnostics: {
305
+ /**
306
+ * @description How serious the diagnostic is.
307
+ * @enum {string}
308
+ */
309
+ severity: "info" | "warning" | "error";
310
+ /**
311
+ * @description The controller this diagnostic concerns, when applicable.
312
+ * @enum {string}
313
+ */
314
+ controller?: "OPERATOR" | "MESHSYNC" | "BROKER";
315
+ /** @description Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on. */
316
+ code: string;
317
+ /** @description Short, human-readable title for the diagnostic. */
318
+ summary: string;
319
+ /** @description A fuller explanation of what is wrong and why. */
320
+ description?: string;
321
+ /** @description Ordered, concrete steps the user can take to resolve the issue. */
322
+ remediation?: string[];
323
+ /** @description A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable). */
324
+ endpoint?: string;
325
+ }[];
326
+ };
140
327
  /** @description Database table summary. */
141
328
  SystemDatabaseTable: {
142
329
  /** @description Name of the table. */
@@ -543,4 +730,262 @@ export interface operations {
543
730
  };
544
731
  };
545
732
  };
733
+ getOperatorControllerStatus: {
734
+ parameters: {
735
+ query: {
736
+ /** @description The kubernetes connection ID whose operator status is requested. */
737
+ connectionId: string;
738
+ };
739
+ header?: never;
740
+ path?: never;
741
+ cookie?: never;
742
+ };
743
+ requestBody?: never;
744
+ responses: {
745
+ /** @description Operator controller status */
746
+ 200: {
747
+ headers: {
748
+ [name: string]: unknown;
749
+ };
750
+ content: {
751
+ "application/json": {
752
+ /**
753
+ * Format: uuid
754
+ * @description The kubernetes connection ID this status belongs to.
755
+ */
756
+ connectionId: string;
757
+ /**
758
+ * @description The controller this status describes.
759
+ * @enum {string}
760
+ */
761
+ controller: "OPERATOR" | "MESHSYNC" | "BROKER";
762
+ /** @description Current controller status (e.g. DEPLOYED, NOTDEPLOYED, RUNNING, CONNECTED, UNKNOWN). */
763
+ status: string;
764
+ /** @description Deployed controller version, when known. */
765
+ version: string;
766
+ };
767
+ };
768
+ };
769
+ /** @description Expired JWT token used or insufficient privilege */
770
+ 401: {
771
+ headers: {
772
+ [name: string]: unknown;
773
+ };
774
+ content: {
775
+ "text/plain": string;
776
+ };
777
+ };
778
+ /** @description Internal server error while resolving controller status. */
779
+ 500: {
780
+ headers: {
781
+ [name: string]: unknown;
782
+ };
783
+ content?: never;
784
+ };
785
+ };
786
+ };
787
+ getMeshsyncControllerStatus: {
788
+ parameters: {
789
+ query: {
790
+ /** @description The kubernetes connection ID whose MeshSync status is requested. */
791
+ connectionId: string;
792
+ };
793
+ header?: never;
794
+ path?: never;
795
+ cookie?: never;
796
+ };
797
+ requestBody?: never;
798
+ responses: {
799
+ /** @description MeshSync controller status */
800
+ 200: {
801
+ headers: {
802
+ [name: string]: unknown;
803
+ };
804
+ content: {
805
+ "application/json": {
806
+ /** @description Controller name (e.g. MeshSync, MesheryBroker). */
807
+ name: string;
808
+ /** @description Deployed controller version, when known. */
809
+ version: string;
810
+ /** @description Current controller status. May be composed, e.g. "Connected <endpoint>". */
811
+ status: string;
812
+ /**
813
+ * Format: uuid
814
+ * @description The kubernetes connection ID this status belongs to.
815
+ */
816
+ connectionId: string;
817
+ };
818
+ };
819
+ };
820
+ /** @description Expired JWT token used or insufficient privilege */
821
+ 401: {
822
+ headers: {
823
+ [name: string]: unknown;
824
+ };
825
+ content: {
826
+ "text/plain": string;
827
+ };
828
+ };
829
+ /** @description Internal server error while resolving controller status. */
830
+ 500: {
831
+ headers: {
832
+ [name: string]: unknown;
833
+ };
834
+ content?: never;
835
+ };
836
+ };
837
+ };
838
+ getBrokerControllerStatus: {
839
+ parameters: {
840
+ query: {
841
+ /** @description The kubernetes connection ID whose broker status is requested. */
842
+ connectionId: string;
843
+ };
844
+ header?: never;
845
+ path?: never;
846
+ cookie?: never;
847
+ };
848
+ requestBody?: never;
849
+ responses: {
850
+ /** @description Broker controller status */
851
+ 200: {
852
+ headers: {
853
+ [name: string]: unknown;
854
+ };
855
+ content: {
856
+ "application/json": {
857
+ /** @description Controller name (e.g. MeshSync, MesheryBroker). */
858
+ name: string;
859
+ /** @description Deployed controller version, when known. */
860
+ version: string;
861
+ /** @description Current controller status. May be composed, e.g. "Connected <endpoint>". */
862
+ status: string;
863
+ /**
864
+ * Format: uuid
865
+ * @description The kubernetes connection ID this status belongs to.
866
+ */
867
+ connectionId: string;
868
+ };
869
+ };
870
+ };
871
+ /** @description Expired JWT token used or insufficient privilege */
872
+ 401: {
873
+ headers: {
874
+ [name: string]: unknown;
875
+ };
876
+ content: {
877
+ "text/plain": string;
878
+ };
879
+ };
880
+ /** @description Internal server error while resolving controller status. */
881
+ 500: {
882
+ headers: {
883
+ [name: string]: unknown;
884
+ };
885
+ content?: never;
886
+ };
887
+ };
888
+ };
889
+ getControllerDiagnostics: {
890
+ parameters: {
891
+ query: {
892
+ /** @description The kubernetes connection ID whose diagnostics are requested. */
893
+ connectionId: string;
894
+ };
895
+ header?: never;
896
+ path?: never;
897
+ cookie?: never;
898
+ };
899
+ requestBody?: never;
900
+ responses: {
901
+ /** @description Connection controller diagnostics */
902
+ 200: {
903
+ headers: {
904
+ [name: string]: unknown;
905
+ };
906
+ content: {
907
+ "application/json": {
908
+ /**
909
+ * Format: uuid
910
+ * @description The kubernetes connection ID these diagnostics belong to.
911
+ */
912
+ connectionId: string;
913
+ /** @description True when no warning/error diagnostics were detected (informational diagnostics do not affect health). */
914
+ healthy: boolean;
915
+ /** @description The diagnostics detected for this connection (possibly empty). */
916
+ diagnostics: {
917
+ /**
918
+ * @description How serious the diagnostic is.
919
+ * @enum {string}
920
+ */
921
+ severity: "info" | "warning" | "error";
922
+ /**
923
+ * @description The controller this diagnostic concerns, when applicable.
924
+ * @enum {string}
925
+ */
926
+ controller?: "OPERATOR" | "MESHSYNC" | "BROKER";
927
+ /** @description Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on. */
928
+ code: string;
929
+ /** @description Short, human-readable title for the diagnostic. */
930
+ summary: string;
931
+ /** @description A fuller explanation of what is wrong and why. */
932
+ description?: string;
933
+ /** @description Ordered, concrete steps the user can take to resolve the issue. */
934
+ remediation?: string[];
935
+ /** @description A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable). */
936
+ endpoint?: string;
937
+ }[];
938
+ };
939
+ };
940
+ };
941
+ /** @description Expired JWT token used or insufficient privilege */
942
+ 401: {
943
+ headers: {
944
+ [name: string]: unknown;
945
+ };
946
+ content: {
947
+ "text/plain": string;
948
+ };
949
+ };
950
+ /** @description Internal server error while resolving controller diagnostics. */
951
+ 500: {
952
+ headers: {
953
+ [name: string]: unknown;
954
+ };
955
+ content?: never;
956
+ };
957
+ };
958
+ };
959
+ subscribeControllersStatus: {
960
+ parameters: {
961
+ query?: {
962
+ /** @description Kubernetes connection IDs to watch. Repeatable (connectionIds=<id>&connectionIds=<id>). */
963
+ connectionIds?: string[];
964
+ };
965
+ header?: never;
966
+ path?: never;
967
+ cookie?: never;
968
+ };
969
+ requestBody?: never;
970
+ responses: {
971
+ /** @description An open text/event-stream of controller status snapshots. */
972
+ 200: {
973
+ headers: {
974
+ [name: string]: unknown;
975
+ };
976
+ content: {
977
+ "text/event-stream": string;
978
+ };
979
+ };
980
+ /** @description Expired JWT token used or insufficient privilege */
981
+ 401: {
982
+ headers: {
983
+ [name: string]: unknown;
984
+ };
985
+ content: {
986
+ "text/plain": string;
987
+ };
988
+ };
989
+ };
990
+ };
546
991
  }
@@ -1,2 +1,2 @@
1
- 'use strict';var e={openapi:"3.0.0",info:{title:"System API",description:"OpenAPI schema for Meshery server operational endpoints.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"System",description:"Operational endpoints for Meshery Server."}],paths:{"/api/system/database":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get a summary of the Meshery server's database",description:"Returns a paginated summary of Meshery database tables and row counts.",operationId:"getSystemDatabase",parameters:[{name:"page",in:"query",description:"Zero-based page index for the table list.",required:false,schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of tables to include per page.",required:false,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Substring filter applied to table names.",required:false,schema:{type:"string",maxLength:255}},{name:"sort",in:"query",description:"Column to order the table list by.",required:false,schema:{type:"string",enum:["name"]}},{name:"order",in:"query",description:"Sort direction for the `sort` column.",required:false,schema:{type:"string",enum:["asc","desc"]}}],responses:{200:{description:"Database summary",content:{"application/json":{schema:{type:"object",description:"Paginated summary of the Meshery server's embedded database.",additionalProperties:false,required:["page","pageSize","totalTables","recordCount","tables"],properties:{page:{type:"integer",description:"Zero-based page index of the returned table slice.",minimum:0},pageSize:{type:"integer",description:"Number of tables included in this page.",minimum:1},totalTables:{type:"integer",description:"Total number of tables in the database matching the search filter.",minimum:0},recordCount:{type:"integer",description:"Aggregate row count across the tables returned in this page.",minimum:0},tables:{type:"array",description:"Tables included in this page, with per-table row counts.",items:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}},"/api/system/database/reset":{delete:{"x-internal":["meshery"],tags:["System"],summary:"Reset the Meshery server's database",description:"Resets the Meshery server database. This is a destructive operation.",operationId:"resetSystemDatabase",responses:{200:{description:"Database reset",content:{"application/json":{schema:{type:"object",description:"Status message response.",additionalProperties:false,required:["message"],properties:{message:{type:"string",description:"Human-readable status message.",minLength:1,maxLength:1024}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error during reset (archive, drop, migrate, or reseed)."}}}},"/api/system/version":{get:{"x-internal":["cloud","meshery"],tags:["System"],summary:"Get the running Meshery server's version metadata",description:"Returns version metadata for the running Meshery service.",operationId:"getSystemVersion",security:[],responses:{200:{description:"Server version metadata",content:{"application/json":{schema:{type:"object",description:"Version metadata for a running Meshery service.",additionalProperties:false,properties:{version:{type:"string",description:"Meshery Cloud deployment version.",maxLength:128},build:{type:"string",description:"Build identifier (typically the git tag of the running binary).",maxLength:128},latest:{type:"string",description:"Latest available Meshery release tag fetched from GitHub.",maxLength:128},outdated:{type:"boolean",description:"True when the running build is older than the latest available release."},commitsha:{type:"string",description:"Git commit SHA of the running service. The wire field is `commitsha`.",maxLength:64},releaseChannel:{type:"string",description:"Release channel of the running binary (e.g. `stable`, `edge`).",maxLength:64}}}}}},500:{description:"Encoding error while serializing the version payload."}}}},"/api/system/email/test":{post:{"x-internal":["cloud"],tags:["System"],summary:"Send a test email",description:"Sends a test email through the configured SMTP provider to verify the email configuration. Restricted to provider administrators.",operationId:"sendTestEmail",requestBody:{description:"Recipient and optional subject for the test email.",required:true,content:{"application/json":{schema:{type:"object",description:"Request body for sending a test email through the configured SMTP provider.",additionalProperties:false,required:["to"],properties:{to:{type:"string",description:"Recipient email address for the test message.",format:"email",maxLength:320},subject:{type:"string",description:"Subject line for the test message. A default subject is used when omitted.",maxLength:998,"x-oapi-codegen-extra-tags":{json:"subject,omitempty"}}}}}}},responses:{200:{description:"Test email sent",content:{"application/json":{schema:{type:"object",description:"Result of a test email send attempt.",additionalProperties:false,required:["status","message","timestamp","sentTo"],properties:{status:{type:"string",description:"Outcome status of the send attempt (e.g. `success`).",maxLength:64},message:{type:"string",description:"Human-readable result message.",maxLength:1024},timestamp:{type:"string",description:"Unix-epoch seconds, as a decimal string, when the test email was sent.",pattern:"^[0-9]+$",maxLength:20},sentTo:{type:"string",description:"Recipient address the test email was sent to.",format:"email",maxLength:320}}}}}},400:{description:"Invalid request payload or malformed recipient email address."},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Email configuration validation failed or the send attempt errored."}}}},"/api/system/sync":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get initial session bootstrap data",description:"Returns session bootstrap data for the authenticated user.",operationId:"getSystemSync",responses:{200:{description:"Session sync payload",content:{"application/json":{schema:{type:"object",description:"Session bootstrap payload for the authenticated user.",additionalProperties:true,properties:{k8sConfig:{type:"array",description:"Kubernetes contexts currently tracked by the Meshery server.",items:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Marshal error while serializing the session sync payload."}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}}},securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{EmailTestRequest:{type:"object",description:"Request body for sending a test email through the configured SMTP provider.",additionalProperties:false,required:["to"],properties:{to:{type:"string",description:"Recipient email address for the test message.",format:"email",maxLength:320},subject:{type:"string",description:"Subject line for the test message. A default subject is used when omitted.",maxLength:998,"x-oapi-codegen-extra-tags":{json:"subject,omitempty"}}}},EmailTestResponse:{type:"object",description:"Result of a test email send attempt.",additionalProperties:false,required:["status","message","timestamp","sentTo"],properties:{status:{type:"string",description:"Outcome status of the send attempt (e.g. `success`).",maxLength:64},message:{type:"string",description:"Human-readable result message.",maxLength:1024},timestamp:{type:"string",description:"Unix-epoch seconds, as a decimal string, when the test email was sent.",pattern:"^[0-9]+$",maxLength:20},sentTo:{type:"string",description:"Recipient address the test email was sent to.",format:"email",maxLength:320}}},SystemMessageResponse:{type:"object",description:"Status message response.",additionalProperties:false,required:["message"],properties:{message:{type:"string",description:"Human-readable status message.",minLength:1,maxLength:1024}}},SystemDatabaseTable:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}},SystemDatabaseSummary:{type:"object",description:"Paginated summary of the Meshery server's embedded database.",additionalProperties:false,required:["page","pageSize","totalTables","recordCount","tables"],properties:{page:{type:"integer",description:"Zero-based page index of the returned table slice.",minimum:0},pageSize:{type:"integer",description:"Number of tables included in this page.",minimum:1},totalTables:{type:"integer",description:"Total number of tables in the database matching the search filter.",minimum:0},recordCount:{type:"integer",description:"Aggregate row count across the tables returned in this page.",minimum:0},tables:{type:"array",description:"Tables included in this page, with per-table row counts.",items:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}}}}},SystemVersion:{type:"object",description:"Version metadata for a running Meshery service.",additionalProperties:false,properties:{version:{type:"string",description:"Meshery Cloud deployment version.",maxLength:128},build:{type:"string",description:"Build identifier (typically the git tag of the running binary).",maxLength:128},latest:{type:"string",description:"Latest available Meshery release tag fetched from GitHub.",maxLength:128},outdated:{type:"boolean",description:"True when the running build is older than the latest available release."},commitsha:{type:"string",description:"Git commit SHA of the running service. The wire field is `commitsha`.",maxLength:64},releaseChannel:{type:"string",description:"Release channel of the running binary (e.g. `stable`, `edge`).",maxLength:64}}},SystemSessionSyncK8sContext:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}},SystemSessionSync:{type:"object",description:"Session bootstrap payload for the authenticated user.",additionalProperties:true,properties:{k8sConfig:{type:"array",description:"Kubernetes contexts currently tracked by the Meshery server.",items:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}}}}}}},t=e;
1
+ 'use strict';var e={openapi:"3.0.0",info:{title:"System API",description:"OpenAPI schema for Meshery server operational endpoints.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"System",description:"Operational endpoints for Meshery Server."}],paths:{"/api/system/database":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get a summary of the Meshery server's database",description:"Returns a paginated summary of Meshery database tables and row counts.",operationId:"getSystemDatabase",parameters:[{name:"page",in:"query",description:"Zero-based page index for the table list.",required:false,schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of tables to include per page.",required:false,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Substring filter applied to table names.",required:false,schema:{type:"string",maxLength:255}},{name:"sort",in:"query",description:"Column to order the table list by.",required:false,schema:{type:"string",enum:["name"]}},{name:"order",in:"query",description:"Sort direction for the `sort` column.",required:false,schema:{type:"string",enum:["asc","desc"]}}],responses:{200:{description:"Database summary",content:{"application/json":{schema:{type:"object",description:"Paginated summary of the Meshery server's embedded database.",additionalProperties:false,required:["page","pageSize","totalTables","recordCount","tables"],properties:{page:{type:"integer",description:"Zero-based page index of the returned table slice.",minimum:0},pageSize:{type:"integer",description:"Number of tables included in this page.",minimum:1},totalTables:{type:"integer",description:"Total number of tables in the database matching the search filter.",minimum:0},recordCount:{type:"integer",description:"Aggregate row count across the tables returned in this page.",minimum:0},tables:{type:"array",description:"Tables included in this page, with per-table row counts.",items:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}},"/api/system/database/reset":{delete:{"x-internal":["meshery"],tags:["System"],summary:"Reset the Meshery server's database",description:"Resets the Meshery server database. This is a destructive operation.",operationId:"resetSystemDatabase",responses:{200:{description:"Database reset",content:{"application/json":{schema:{type:"object",description:"Status message response.",additionalProperties:false,required:["message"],properties:{message:{type:"string",description:"Human-readable status message.",minLength:1,maxLength:1024}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error during reset (archive, drop, migrate, or reseed)."}}}},"/api/system/version":{get:{"x-internal":["cloud","meshery"],tags:["System"],summary:"Get the running Meshery server's version metadata",description:"Returns version metadata for the running Meshery service.",operationId:"getSystemVersion",security:[],responses:{200:{description:"Server version metadata",content:{"application/json":{schema:{type:"object",description:"Version metadata for a running Meshery service.",additionalProperties:false,properties:{version:{type:"string",description:"Meshery Cloud deployment version.",maxLength:128},build:{type:"string",description:"Build identifier (typically the git tag of the running binary).",maxLength:128},latest:{type:"string",description:"Latest available Meshery release tag fetched from GitHub.",maxLength:128},outdated:{type:"boolean",description:"True when the running build is older than the latest available release."},commitsha:{type:"string",description:"Git commit SHA of the running service. The wire field is `commitsha`.",maxLength:64},releaseChannel:{type:"string",description:"Release channel of the running binary (e.g. `stable`, `edge`).",maxLength:64}}}}}},500:{description:"Encoding error while serializing the version payload."}}}},"/api/system/email/test":{post:{"x-internal":["cloud"],tags:["System"],summary:"Send a test email",description:"Sends a test email through the configured SMTP provider to verify the email configuration. Restricted to provider administrators.",operationId:"sendTestEmail",requestBody:{description:"Recipient and optional subject for the test email.",required:true,content:{"application/json":{schema:{type:"object",description:"Request body for sending a test email through the configured SMTP provider.",additionalProperties:false,required:["to"],properties:{to:{type:"string",description:"Recipient email address for the test message.",format:"email",maxLength:320},subject:{type:"string",description:"Subject line for the test message. A default subject is used when omitted.",maxLength:998,"x-oapi-codegen-extra-tags":{json:"subject,omitempty"}}}}}}},responses:{200:{description:"Test email sent",content:{"application/json":{schema:{type:"object",description:"Result of a test email send attempt.",additionalProperties:false,required:["status","message","timestamp","sentTo"],properties:{status:{type:"string",description:"Outcome status of the send attempt (e.g. `success`).",maxLength:64},message:{type:"string",description:"Human-readable result message.",maxLength:1024},timestamp:{type:"string",description:"Unix-epoch seconds, as a decimal string, when the test email was sent.",pattern:"^[0-9]+$",maxLength:20},sentTo:{type:"string",description:"Recipient address the test email was sent to.",format:"email",maxLength:320}}}}}},400:{description:"Invalid request payload or malformed recipient email address."},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Email configuration validation failed or the send attempt errored."}}}},"/api/system/sync":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get initial session bootstrap data",description:"Returns session bootstrap data for the authenticated user.",operationId:"getSystemSync",responses:{200:{description:"Session sync payload",content:{"application/json":{schema:{type:"object",description:"Session bootstrap payload for the authenticated user.",additionalProperties:true,properties:{k8sConfig:{type:"array",description:"Kubernetes contexts currently tracked by the Meshery server.",items:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Marshal error while serializing the session sync payload."}}}},"/api/system/controllers/operator/status":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get the Meshery Operator status for a connection",description:"Returns the current status of the Meshery Operator controller for the given kubernetes connection. Replaces the getOperatorStatus GraphQL query.",operationId:"getOperatorControllerStatus",parameters:[{name:"connectionId",in:"query",description:"The kubernetes connection ID whose operator status is requested.",required:true,schema:{type:"string",format:"uuid"}}],responses:{200:{description:"Operator controller status",content:{"application/json":{schema:{type:"object",description:"Status of a single Meshery controller (operator, MeshSync, or broker) for a kubernetes connection. Element type of the controller-status SSE stream and the operator status response.",additionalProperties:false,required:["connectionId","controller","status","version"],properties:{connectionId:{description:"The kubernetes connection ID this status belongs to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},controller:{type:"string",description:"The controller this status describes.",enum:["OPERATOR","MESHSYNC","BROKER"]},status:{type:"string",description:"Current controller status (e.g. DEPLOYED, NOTDEPLOYED, RUNNING, CONNECTED, UNKNOWN).",maxLength:255},version:{type:"string",description:"Deployed controller version, when known.",maxLength:255}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error while resolving controller status."}}}},"/api/system/controllers/meshsync/status":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get the MeshSync controller status for a connection",description:"Returns the current status of the MeshSync controller for the given kubernetes connection. Replaces the getMeshsyncStatus GraphQL query.",operationId:"getMeshsyncControllerStatus",parameters:[{name:"connectionId",in:"query",description:"The kubernetes connection ID whose MeshSync status is requested.",required:true,schema:{type:"string",format:"uuid"}}],responses:{200:{description:"MeshSync controller status",content:{"application/json":{schema:{type:"object",description:"Detailed status of a named Meshery controller (MeshSync or Broker) for a kubernetes connection.",additionalProperties:false,required:["name","version","status","connectionId"],properties:{name:{type:"string",description:"Controller name (e.g. MeshSync, MesheryBroker).",maxLength:255},version:{type:"string",description:"Deployed controller version, when known.",maxLength:255},status:{type:"string",description:'Current controller status. May be composed, e.g. "Connected <endpoint>".',maxLength:1024},connectionId:{description:"The kubernetes connection ID this status belongs to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error while resolving controller status."}}}},"/api/system/controllers/broker/status":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get the Meshery Broker (NATS) controller status for a connection",description:"Returns the current status of the Meshery Broker (NATS) controller for the given kubernetes connection. Replaces the getNatsStatus GraphQL query.",operationId:"getBrokerControllerStatus",parameters:[{name:"connectionId",in:"query",description:"The kubernetes connection ID whose broker status is requested.",required:true,schema:{type:"string",format:"uuid"}}],responses:{200:{description:"Broker controller status",content:{"application/json":{schema:{type:"object",description:"Detailed status of a named Meshery controller (MeshSync or Broker) for a kubernetes connection.",additionalProperties:false,required:["name","version","status","connectionId"],properties:{name:{type:"string",description:"Controller name (e.g. MeshSync, MesheryBroker).",maxLength:255},version:{type:"string",description:"Deployed controller version, when known.",maxLength:255},status:{type:"string",description:'Current controller status. May be composed, e.g. "Connected <endpoint>".',maxLength:1024},connectionId:{description:"The kubernetes connection ID this status belongs to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error while resolving controller status."}}}},"/api/system/controllers/diagnostics":{get:{"x-internal":["meshery"],tags:["System"],summary:"Get controller diagnostics and remediation for a connection",description:`Returns human-actionable diagnostics for a kubernetes connection's Meshery controllers (operator, MeshSync, broker), derived from their current status and Meshery's live broker connection. Each diagnostic carries a severity, a summary, an explanation, and concrete remediation steps so the UI can render a "Diagnostics" section in the connection detail view. An empty diagnostics list (with healthy=true) means no problems were detected.`,operationId:"getControllerDiagnostics",parameters:[{name:"connectionId",in:"query",description:"The kubernetes connection ID whose diagnostics are requested.",required:true,schema:{type:"string",format:"uuid"}}],responses:{200:{description:"Connection controller diagnostics",content:{"application/json":{schema:{type:"object",description:`Diagnostics for a kubernetes connection's Meshery controllers, for rendering a "Diagnostics" section in the connection detail view.`,additionalProperties:false,required:["connectionId","healthy","diagnostics"],properties:{connectionId:{description:"The kubernetes connection ID these diagnostics belong to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},healthy:{type:"boolean",description:"True when no warning/error diagnostics were detected (informational diagnostics do not affect health)."},diagnostics:{type:"array",description:"The diagnostics detected for this connection (possibly empty).",items:{type:"object",description:"A single human-actionable diagnostic about a kubernetes connection's Meshery controllers, with an explanation and remediation steps.",additionalProperties:false,required:["severity","code","summary"],properties:{severity:{type:"string",description:"How serious the diagnostic is.",enum:["info","warning","error"]},controller:{type:"string",description:"The controller this diagnostic concerns, when applicable.",enum:["OPERATOR","MESHSYNC","BROKER"],"x-oapi-codegen-extra-tags":{json:"controller,omitempty"}},code:{type:"string",description:"Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on.",maxLength:128},summary:{type:"string",description:"Short, human-readable title for the diagnostic.",maxLength:255},description:{type:"string",description:"A fuller explanation of what is wrong and why.",maxLength:2048,"x-oapi-codegen-extra-tags":{json:"description,omitempty"}},remediation:{type:"array",description:"Ordered, concrete steps the user can take to resolve the issue.",items:{type:"string",maxLength:1024},"x-oapi-codegen-extra-tags":{json:"remediation,omitempty"}},endpoint:{type:"string",description:"A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable).",maxLength:512,"x-oapi-codegen-extra-tags":{json:"endpoint,omitempty"}}}}}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error while resolving controller diagnostics."}}}},"/api/system/controllers/status/subscribe":{get:{"x-internal":["meshery"],tags:["System"],summary:"Stream Meshery controller status over Server-Sent Events",description:"Server-Sent Events (SSE) stream of controller status (operator, MeshSync, broker) for the requested kubernetes connections. Replaces the subscribeMesheryControllersStatus GraphQL subscription. The server emits the full status array as an unnamed SSE event (`data: <json>` followed by a blank line) on subscribe and again whenever any controller's status changes; a comment keepalive is sent periodically. Consume with a native EventSource, not a buffered JSON client.",operationId:"subscribeControllersStatus",parameters:[{name:"connectionIds",in:"query",description:"Kubernetes connection IDs to watch. Repeatable (connectionIds=<id>&connectionIds=<id>).",required:false,schema:{type:"array",items:{type:"string",format:"uuid"}}}],responses:{200:{description:"An open text/event-stream of controller status snapshots.",content:{"text/event-stream":{schema:{type:"string",description:"SSE frames. Each `data:` line is a JSON array of ControllerStatus items."}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}}},securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{EmailTestRequest:{type:"object",description:"Request body for sending a test email through the configured SMTP provider.",additionalProperties:false,required:["to"],properties:{to:{type:"string",description:"Recipient email address for the test message.",format:"email",maxLength:320},subject:{type:"string",description:"Subject line for the test message. A default subject is used when omitted.",maxLength:998,"x-oapi-codegen-extra-tags":{json:"subject,omitempty"}}}},EmailTestResponse:{type:"object",description:"Result of a test email send attempt.",additionalProperties:false,required:["status","message","timestamp","sentTo"],properties:{status:{type:"string",description:"Outcome status of the send attempt (e.g. `success`).",maxLength:64},message:{type:"string",description:"Human-readable result message.",maxLength:1024},timestamp:{type:"string",description:"Unix-epoch seconds, as a decimal string, when the test email was sent.",pattern:"^[0-9]+$",maxLength:20},sentTo:{type:"string",description:"Recipient address the test email was sent to.",format:"email",maxLength:320}}},SystemMessageResponse:{type:"object",description:"Status message response.",additionalProperties:false,required:["message"],properties:{message:{type:"string",description:"Human-readable status message.",minLength:1,maxLength:1024}}},ControllerStatus:{type:"object",description:"Status of a single Meshery controller (operator, MeshSync, or broker) for a kubernetes connection. Element type of the controller-status SSE stream and the operator status response.",additionalProperties:false,required:["connectionId","controller","status","version"],properties:{connectionId:{description:"The kubernetes connection ID this status belongs to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},controller:{type:"string",description:"The controller this status describes.",enum:["OPERATOR","MESHSYNC","BROKER"]},status:{type:"string",description:"Current controller status (e.g. DEPLOYED, NOTDEPLOYED, RUNNING, CONNECTED, UNKNOWN).",maxLength:255},version:{type:"string",description:"Deployed controller version, when known.",maxLength:255}}},ControllerInfo:{type:"object",description:"Detailed status of a named Meshery controller (MeshSync or Broker) for a kubernetes connection.",additionalProperties:false,required:["name","version","status","connectionId"],properties:{name:{type:"string",description:"Controller name (e.g. MeshSync, MesheryBroker).",maxLength:255},version:{type:"string",description:"Deployed controller version, when known.",maxLength:255},status:{type:"string",description:'Current controller status. May be composed, e.g. "Connected <endpoint>".',maxLength:1024},connectionId:{description:"The kubernetes connection ID this status belongs to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}},ControllerDiagnostic:{type:"object",description:"A single human-actionable diagnostic about a kubernetes connection's Meshery controllers, with an explanation and remediation steps.",additionalProperties:false,required:["severity","code","summary"],properties:{severity:{type:"string",description:"How serious the diagnostic is.",enum:["info","warning","error"]},controller:{type:"string",description:"The controller this diagnostic concerns, when applicable.",enum:["OPERATOR","MESHSYNC","BROKER"],"x-oapi-codegen-extra-tags":{json:"controller,omitempty"}},code:{type:"string",description:"Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on.",maxLength:128},summary:{type:"string",description:"Short, human-readable title for the diagnostic.",maxLength:255},description:{type:"string",description:"A fuller explanation of what is wrong and why.",maxLength:2048,"x-oapi-codegen-extra-tags":{json:"description,omitempty"}},remediation:{type:"array",description:"Ordered, concrete steps the user can take to resolve the issue.",items:{type:"string",maxLength:1024},"x-oapi-codegen-extra-tags":{json:"remediation,omitempty"}},endpoint:{type:"string",description:"A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable).",maxLength:512,"x-oapi-codegen-extra-tags":{json:"endpoint,omitempty"}}}},ConnectionDiagnostics:{type:"object",description:`Diagnostics for a kubernetes connection's Meshery controllers, for rendering a "Diagnostics" section in the connection detail view.`,additionalProperties:false,required:["connectionId","healthy","diagnostics"],properties:{connectionId:{description:"The kubernetes connection ID these diagnostics belong to.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},healthy:{type:"boolean",description:"True when no warning/error diagnostics were detected (informational diagnostics do not affect health)."},diagnostics:{type:"array",description:"The diagnostics detected for this connection (possibly empty).",items:{type:"object",description:"A single human-actionable diagnostic about a kubernetes connection's Meshery controllers, with an explanation and remediation steps.",additionalProperties:false,required:["severity","code","summary"],properties:{severity:{type:"string",description:"How serious the diagnostic is.",enum:["info","warning","error"]},controller:{type:"string",description:"The controller this diagnostic concerns, when applicable.",enum:["OPERATOR","MESHSYNC","BROKER"],"x-oapi-codegen-extra-tags":{json:"controller,omitempty"}},code:{type:"string",description:"Stable machine-readable code for this diagnostic (e.g. `broker_unreachable`), for the UI to key on.",maxLength:128},summary:{type:"string",description:"Short, human-readable title for the diagnostic.",maxLength:255},description:{type:"string",description:"A fuller explanation of what is wrong and why.",maxLength:2048,"x-oapi-codegen-extra-tags":{json:"description,omitempty"}},remediation:{type:"array",description:"Ordered, concrete steps the user can take to resolve the issue.",items:{type:"string",maxLength:1024},"x-oapi-codegen-extra-tags":{json:"remediation,omitempty"}},endpoint:{type:"string",description:"A relevant endpoint for the diagnostic, when applicable (e.g. the broker's published address the user needs to make reachable).",maxLength:512,"x-oapi-codegen-extra-tags":{json:"endpoint,omitempty"}}}}}}},SystemDatabaseTable:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}},SystemDatabaseSummary:{type:"object",description:"Paginated summary of the Meshery server's embedded database.",additionalProperties:false,required:["page","pageSize","totalTables","recordCount","tables"],properties:{page:{type:"integer",description:"Zero-based page index of the returned table slice.",minimum:0},pageSize:{type:"integer",description:"Number of tables included in this page.",minimum:1},totalTables:{type:"integer",description:"Total number of tables in the database matching the search filter.",minimum:0},recordCount:{type:"integer",description:"Aggregate row count across the tables returned in this page.",minimum:0},tables:{type:"array",description:"Tables included in this page, with per-table row counts.",items:{type:"object",description:"Database table summary.",additionalProperties:false,required:["name","type","count"],properties:{name:{type:"string",description:"Name of the table.",maxLength:255},type:{type:"string",description:"SQLite object type (e.g. `table`).",maxLength:64},count:{type:"integer",description:"Number of rows currently in the table.",format:"int64",minimum:0}}}}}},SystemVersion:{type:"object",description:"Version metadata for a running Meshery service.",additionalProperties:false,properties:{version:{type:"string",description:"Meshery Cloud deployment version.",maxLength:128},build:{type:"string",description:"Build identifier (typically the git tag of the running binary).",maxLength:128},latest:{type:"string",description:"Latest available Meshery release tag fetched from GitHub.",maxLength:128},outdated:{type:"boolean",description:"True when the running build is older than the latest available release."},commitsha:{type:"string",description:"Git commit SHA of the running service. The wire field is `commitsha`.",maxLength:64},releaseChannel:{type:"string",description:"Release channel of the running binary (e.g. `stable`, `edge`).",maxLength:64}}},SystemSessionSyncK8sContext:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}},SystemSessionSync:{type:"object",description:"Session bootstrap payload for the authenticated user.",additionalProperties:true,properties:{k8sConfig:{type:"array",description:"Kubernetes contexts currently tracked by the Meshery server.",items:{type:"object",description:"Kubernetes context tracked by Meshery.",additionalProperties:false,properties:{id:{type:"string",description:"Stable identifier for the Kubernetes context.","x-id-format":"external",minLength:32,maxLength:32,pattern:"^[0-9a-f]{32}$"},name:{type:"string",description:"Human-readable name of the Kubernetes context.",maxLength:255},clusterConfigured:{type:"boolean",description:"True when Meshery has a usable kubeconfig for this context."},server:{type:"string",description:"API server URL for the Kubernetes context.",maxLength:2048},clusterId:{description:"Kubernetes server ID associated with this context.",type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},createdAt:{description:"When the context was first registered with Meshery.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"CreatedAt","x-oapi-codegen-extra-tags":{db:"created_at",yaml:"created_at"},"x-go-type-skip-optional-pointer":true},updatedAt:{description:"When the context was last updated.","x-go-type":"time.Time",type:"string",format:"date-time","x-go-name":"UpdatedAt","x-oapi-codegen-extra-tags":{db:"updated_at",yaml:"updated_at"},"x-go-type-skip-optional-pointer":true}}}}}}}}},t=e;
2
2
  module.exports=t;