@cloudfleet/sdk 0.0.1-ed50a15 → 0.0.1-f018175

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 (94) hide show
  1. package/README.md +26 -2
  2. package/dist/@tanstack/react-query.gen.d.ts +1149 -0
  3. package/dist/@tanstack/react-query.gen.d.ts.map +1 -0
  4. package/dist/@tanstack/react-query.gen.js +1165 -0
  5. package/dist/@tanstack/react-query.gen.js.map +1 -0
  6. package/dist/client/client.gen.d.ts +3 -0
  7. package/dist/client/client.gen.d.ts.map +1 -0
  8. package/dist/client/client.gen.js +217 -0
  9. package/dist/client/client.gen.js.map +1 -0
  10. package/dist/client/index.d.ts +8 -7
  11. package/dist/client/index.d.ts.map +1 -1
  12. package/dist/client/index.js +6 -4
  13. package/dist/client/index.js.map +1 -1
  14. package/dist/client/{types.d.ts → types.gen.d.ts} +23 -22
  15. package/dist/client/types.gen.d.ts.map +1 -0
  16. package/dist/client/types.gen.js +3 -0
  17. package/dist/client/types.gen.js.map +1 -0
  18. package/dist/client/{utils.d.ts → utils.gen.d.ts} +17 -25
  19. package/dist/client/utils.gen.d.ts.map +1 -0
  20. package/dist/client/{utils.js → utils.gen.js} +66 -122
  21. package/dist/client/utils.gen.js.map +1 -0
  22. package/dist/client.gen.d.ts +3 -3
  23. package/dist/client.gen.d.ts.map +1 -1
  24. package/dist/client.gen.js +1 -3
  25. package/dist/client.gen.js.map +1 -1
  26. package/dist/core/{auth.d.ts → auth.gen.d.ts} +1 -1
  27. package/dist/core/auth.gen.d.ts.map +1 -0
  28. package/dist/core/{auth.js → auth.gen.js} +2 -1
  29. package/dist/core/auth.gen.js.map +1 -0
  30. package/dist/core/bodySerializer.gen.d.ts +26 -0
  31. package/dist/core/bodySerializer.gen.d.ts.map +1 -0
  32. package/dist/core/{bodySerializer.js → bodySerializer.gen.js} +6 -2
  33. package/dist/core/bodySerializer.gen.js.map +1 -0
  34. package/dist/core/{params.d.ts → params.gen.d.ts} +11 -1
  35. package/dist/core/params.gen.d.ts.map +1 -0
  36. package/dist/core/{params.js → params.gen.js} +24 -11
  37. package/dist/core/params.gen.js.map +1 -0
  38. package/dist/core/{pathSerializer.d.ts → pathSerializer.gen.d.ts} +1 -1
  39. package/dist/core/pathSerializer.gen.d.ts.map +1 -0
  40. package/dist/core/{pathSerializer.js → pathSerializer.gen.js} +5 -12
  41. package/dist/core/pathSerializer.gen.js.map +1 -0
  42. package/dist/core/queryKeySerializer.gen.d.ts +19 -0
  43. package/dist/core/queryKeySerializer.gen.d.ts.map +1 -0
  44. package/dist/core/queryKeySerializer.gen.js +93 -0
  45. package/dist/core/queryKeySerializer.gen.js.map +1 -0
  46. package/dist/core/serverSentEvents.gen.d.ts +72 -0
  47. package/dist/core/serverSentEvents.gen.d.ts.map +1 -0
  48. package/dist/core/serverSentEvents.gen.js +133 -0
  49. package/dist/core/serverSentEvents.gen.js.map +1 -0
  50. package/dist/core/{types.d.ts → types.gen.d.ts} +16 -16
  51. package/dist/core/types.gen.d.ts.map +1 -0
  52. package/dist/core/types.gen.js +3 -0
  53. package/dist/core/types.gen.js.map +1 -0
  54. package/dist/core/utils.gen.d.ts +20 -0
  55. package/dist/core/utils.gen.d.ts.map +1 -0
  56. package/dist/core/utils.gen.js +88 -0
  57. package/dist/core/utils.gen.js.map +1 -0
  58. package/dist/schemas.gen.d.ts +1579 -569
  59. package/dist/schemas.gen.d.ts.map +1 -1
  60. package/dist/schemas.gen.js +2995 -711
  61. package/dist/schemas.gen.js.map +1 -1
  62. package/dist/sdk.gen.d.ts +286 -164
  63. package/dist/sdk.gen.d.ts.map +1 -1
  64. package/dist/sdk.gen.js +406 -337
  65. package/dist/sdk.gen.js.map +1 -1
  66. package/dist/services/kubernetes/api.d.ts +20 -20
  67. package/dist/types.gen.d.ts +1782 -782
  68. package/dist/types.gen.d.ts.map +1 -1
  69. package/dist/zod.gen.d.ts +3497 -2553
  70. package/dist/zod.gen.d.ts.map +1 -1
  71. package/dist/zod.gen.js +1432 -1194
  72. package/dist/zod.gen.js.map +1 -1
  73. package/package.json +28 -8
  74. package/dist/client/client.d.ts +0 -3
  75. package/dist/client/client.d.ts.map +0 -1
  76. package/dist/client/client.js +0 -146
  77. package/dist/client/client.js.map +0 -1
  78. package/dist/client/types.d.ts.map +0 -1
  79. package/dist/client/types.js +0 -2
  80. package/dist/client/types.js.map +0 -1
  81. package/dist/client/utils.d.ts.map +0 -1
  82. package/dist/client/utils.js.map +0 -1
  83. package/dist/core/auth.d.ts.map +0 -1
  84. package/dist/core/auth.js.map +0 -1
  85. package/dist/core/bodySerializer.d.ts +0 -18
  86. package/dist/core/bodySerializer.d.ts.map +0 -1
  87. package/dist/core/bodySerializer.js.map +0 -1
  88. package/dist/core/params.d.ts.map +0 -1
  89. package/dist/core/params.js.map +0 -1
  90. package/dist/core/pathSerializer.d.ts.map +0 -1
  91. package/dist/core/pathSerializer.js.map +0 -1
  92. package/dist/core/types.d.ts.map +0 -1
  93. package/dist/core/types.js +0 -2
  94. package/dist/core/types.js.map +0 -1
@@ -2,6 +2,15 @@
2
2
  export const BillingContactSchema = {
3
3
  type: 'object',
4
4
  properties: {
5
+ type: {
6
+ type: 'string',
7
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
8
+ example: 'business',
9
+ enum: [
10
+ 'business',
11
+ 'personal'
12
+ ]
13
+ },
5
14
  company: {
6
15
  type: 'string',
7
16
  maxLength: 120,
@@ -58,15 +67,10 @@ export const BillingContactSchema = {
58
67
  description: 'Email address used for billing as a string.',
59
68
  example: 'email@example.com'
60
69
  },
61
- first_name: {
62
- type: 'string',
63
- description: 'First name of the billing contact person.',
64
- example: 'John'
65
- },
66
- last_name: {
70
+ individual_name: {
67
71
  type: 'string',
68
- description: 'Last name of the billing contact person.',
69
- example: 'Doe'
72
+ description: 'Name of the billing contact person.',
73
+ example: 'John Doe'
70
74
  },
71
75
  tax_id: {
72
76
  type: 'string',
@@ -79,10 +83,143 @@ export const BillingContactSchema = {
79
83
  nullable: true,
80
84
  description: 'Type of the tax ID.',
81
85
  example: 'de_vat',
82
- enum: ['ad_nrt', 'ae_trn', 'al_tin', 'am_tin', 'ao_tin', 'ar_cuit', 'at_vat', 'au_abn', 'au_arn', 'ba_tin', 'bb_tin', 'be_vat', 'bg_uic', 'bg_vat', 'bh_vat', 'bo_tin', 'br_cnpj', 'br_cpf', 'bs_tin', 'by_tin', 'ca_bn', 'ca_gst_hst', 'ca_pst_bc', 'ca_pst_mb', 'ca_pst_sk', 'ca_qst', 'cd_nif', 'ch_uid', 'ch_vat', 'cl_tin', 'cn_tin', 'co_nit', 'cr_tin', 'cy_vat', 'cz_vat', 'de_stn', 'de_vat', 'dk_vat', 'do_rcn', 'ec_ruc', 'ee_vat', 'eg_tin', 'es_cif', 'es_vat', 'eu_oss_vat', 'fi_vat', 'fr_vat', 'gb_vat', 'ge_vat', 'gn_nif', 'gr_vat', 'hk_br', 'hr_oib', 'hr_vat', 'hu_tin', 'hu_vat', 'id_npwp', 'ie_vat', 'il_vat', 'in_gst', 'is_vat', 'it_vat', 'jp_cn', 'jp_rn', 'jp_trn', 'ke_pin', 'kh_tin', 'kr_brn', 'kz_bin', 'li_uid', 'li_vat', 'lt_vat', 'lu_vat', 'lv_vat', 'ma_vat', 'md_vat', 'me_pib', 'mk_vat', 'mr_nif', 'mt_vat', 'mx_rfc', 'my_frp', 'my_itn', 'my_sst', 'ng_tin', 'nl_vat', 'no_vat', 'no_voec', 'np_pan', 'nz_gst', 'om_vat', 'pe_ruc', 'ph_tin', 'pl_vat', 'pt_vat', 'ro_tin', 'ro_vat', 'rs_pib', 'ru_inn', 'ru_kpp', 'sa_vat', 'se_vat', 'sg_gst', 'sg_uen', 'si_tin', 'si_vat', 'sk_vat', 'sn_ninea', 'sr_fin', 'sv_nit', 'th_vat', 'tj_tin', 'tr_tin', 'tw_vat', 'tz_vat', 'ua_vat', 'ug_tin', 'us_ein', 'uy_ruc', 'uz_tin', 'uz_vat', 've_rif', 'vn_tin', 'xi_vat', 'za_vat', 'zm_tin', 'zw_tin', '']
86
+ enum: [
87
+ 'ad_nrt',
88
+ 'ae_trn',
89
+ 'al_tin',
90
+ 'am_tin',
91
+ 'ao_tin',
92
+ 'ar_cuit',
93
+ 'at_vat',
94
+ 'au_abn',
95
+ 'au_arn',
96
+ 'ba_tin',
97
+ 'bb_tin',
98
+ 'be_vat',
99
+ 'bg_uic',
100
+ 'bg_vat',
101
+ 'bh_vat',
102
+ 'bo_tin',
103
+ 'br_cnpj',
104
+ 'br_cpf',
105
+ 'bs_tin',
106
+ 'by_tin',
107
+ 'ca_bn',
108
+ 'ca_gst_hst',
109
+ 'ca_pst_bc',
110
+ 'ca_pst_mb',
111
+ 'ca_pst_sk',
112
+ 'ca_qst',
113
+ 'cd_nif',
114
+ 'ch_uid',
115
+ 'ch_vat',
116
+ 'cl_tin',
117
+ 'cn_tin',
118
+ 'co_nit',
119
+ 'cr_tin',
120
+ 'cy_vat',
121
+ 'cz_vat',
122
+ 'de_stn',
123
+ 'de_vat',
124
+ 'dk_vat',
125
+ 'do_rcn',
126
+ 'ec_ruc',
127
+ 'ee_vat',
128
+ 'eg_tin',
129
+ 'es_cif',
130
+ 'es_vat',
131
+ 'eu_oss_vat',
132
+ 'fi_vat',
133
+ 'fr_vat',
134
+ 'gb_vat',
135
+ 'ge_vat',
136
+ 'gn_nif',
137
+ 'gr_vat',
138
+ 'hk_br',
139
+ 'hr_oib',
140
+ 'hr_vat',
141
+ 'hu_tin',
142
+ 'hu_vat',
143
+ 'id_npwp',
144
+ 'ie_vat',
145
+ 'il_vat',
146
+ 'in_gst',
147
+ 'is_vat',
148
+ 'it_vat',
149
+ 'jp_cn',
150
+ 'jp_rn',
151
+ 'jp_trn',
152
+ 'ke_pin',
153
+ 'kh_tin',
154
+ 'kr_brn',
155
+ 'kz_bin',
156
+ 'li_uid',
157
+ 'li_vat',
158
+ 'lt_vat',
159
+ 'lu_vat',
160
+ 'lv_vat',
161
+ 'ma_vat',
162
+ 'md_vat',
163
+ 'me_pib',
164
+ 'mk_vat',
165
+ 'mr_nif',
166
+ 'mt_vat',
167
+ 'mx_rfc',
168
+ 'my_frp',
169
+ 'my_itn',
170
+ 'my_sst',
171
+ 'ng_tin',
172
+ 'nl_vat',
173
+ 'no_vat',
174
+ 'no_voec',
175
+ 'np_pan',
176
+ 'nz_gst',
177
+ 'om_vat',
178
+ 'pe_ruc',
179
+ 'ph_tin',
180
+ 'pl_vat',
181
+ 'pt_vat',
182
+ 'ro_tin',
183
+ 'ro_vat',
184
+ 'rs_pib',
185
+ 'ru_inn',
186
+ 'ru_kpp',
187
+ 'sa_vat',
188
+ 'se_vat',
189
+ 'sg_gst',
190
+ 'sg_uen',
191
+ 'si_tin',
192
+ 'si_vat',
193
+ 'sk_vat',
194
+ 'sn_ninea',
195
+ 'sr_fin',
196
+ 'sv_nit',
197
+ 'th_vat',
198
+ 'tj_tin',
199
+ 'tr_tin',
200
+ 'tw_vat',
201
+ 'tz_vat',
202
+ 'ua_vat',
203
+ 'ug_tin',
204
+ 'us_ein',
205
+ 'uy_ruc',
206
+ 'uz_tin',
207
+ 'uz_vat',
208
+ 've_rif',
209
+ 'vn_tin',
210
+ 'xi_vat',
211
+ 'za_vat',
212
+ 'zm_tin',
213
+ 'zw_tin',
214
+ ''
215
+ ]
83
216
  }
84
217
  },
85
- required: ['email', 'first_name', 'last_name'],
218
+ required: [
219
+ 'type',
220
+ 'email',
221
+ 'individual_name'
222
+ ],
86
223
  additionalProperties: false
87
224
  };
88
225
  export const BillingCreditsSchema = {
@@ -93,10 +230,25 @@ export const BillingCreditsSchema = {
93
230
  description: 'Generated unique identifier of the promotional code.',
94
231
  example: '7kUZnH7nnKUFfvc4NK2KQF'
95
232
  },
96
- date_created: {
233
+ type: {
234
+ type: 'string',
235
+ description: 'Type of the promotional code.',
236
+ example: 'credit',
237
+ enum: [
238
+ 'credit',
239
+ 'discount'
240
+ ]
241
+ },
242
+ date_start: {
243
+ type: 'string',
244
+ format: 'date-time',
245
+ description: 'Timestamp when the credit becomes active. ISO 8601 date string in the UTC timezone.',
246
+ example: '2023-12-20T13:53:32.000Z'
247
+ },
248
+ date_end: {
97
249
  type: 'string',
98
250
  format: 'date-time',
99
- description: 'Date of the credit application. ISO 8601 date string in the UTC timezone.',
251
+ description: 'Timestamp when the credit expires or becomes inactive. ISO 8601 date string in the UTC timezone.',
100
252
  example: '2023-12-20T13:53:32.000Z'
101
253
  },
102
254
  code: {
@@ -109,40 +261,25 @@ export const BillingCreditsSchema = {
109
261
  description: 'Description of the promotional code.',
110
262
  example: '10% off on all products'
111
263
  },
112
- products: {
113
- type: 'array',
114
- items: {
115
- type: 'string'
116
- },
117
- description: 'List of product SKUs that the promotional code can be used on.',
118
- example: ['cfke_controlplane', 'cfke_connected_nodes', 'infra_compute', 'infra_storage', 'infra_loadbalancing', 'infra_traffic', 'cfcr_storage']
119
- },
120
- type: {
121
- type: 'string',
122
- description: 'Type of the promotional code.',
123
- example: 'credit',
124
- enum: ['credit', 'discount']
125
- },
126
- value: {
264
+ value_total: {
127
265
  type: 'number',
128
266
  format: 'float',
129
- description: 'Value of the promotional code.',
267
+ description: 'Total value of the promotional code.',
130
268
  example: 10
131
269
  },
132
- billing_period: {
133
- type: 'string',
134
- format: 'date-time',
135
- description: 'Date of the billing cycle. An ISO 8601 date string in the UTC timezone.',
136
- example: '2023-12-20T13:53:32.000Z'
137
- },
138
270
  value_remaining: {
139
271
  type: 'number',
140
272
  format: 'float',
141
- description: 'Value of the promotional code.',
142
- example: 10
273
+ description: 'Remaining value of the promotional code.',
274
+ example: 8
143
275
  }
144
276
  },
145
- required: ['date_created', 'code', 'type', 'value', 'billing_period'],
277
+ required: [
278
+ 'type',
279
+ 'date_start',
280
+ 'code',
281
+ 'value_total'
282
+ ],
146
283
  additionalProperties: false
147
284
  };
148
285
  export const ChartCreateInputSchema = {
@@ -183,7 +320,13 @@ export const ChartCreateInputSchema = {
183
320
  example: 'postgresql'
184
321
  }
185
322
  },
186
- required: ['values', 'version_channel', 'name', 'namespace', 'chart'],
323
+ required: [
324
+ 'values',
325
+ 'version_channel',
326
+ 'name',
327
+ 'namespace',
328
+ 'chart'
329
+ ],
187
330
  additionalProperties: false
188
331
  };
189
332
  export const ChartSchema = {
@@ -225,9 +368,8 @@ export const ChartSchema = {
225
368
  },
226
369
  status: {
227
370
  type: 'string',
228
- description: 'Status of the chart deployment.',
229
- example: 'active',
230
- enum: ['InstallSucceeded', 'InstallFailed', 'UpgradeSucceeded', 'UpgradeFailed', 'TestSucceeded', 'TestFailed', 'RollbackSucceeded', 'RollbackFailed', 'UninstallSucceeded', 'UninstallFailed', 'ArtifactFailed', 'DependencyNotReady', 'Progressing', 'SourceNotReady']
371
+ description: 'Status of the chart deployment (Flux HelmRelease Ready condition reason, e.g. InstallSucceeded, UpgradeFailed, Progressing).',
372
+ example: 'InstallSucceeded'
231
373
  },
232
374
  version_current: {
233
375
  type: 'string',
@@ -250,7 +392,18 @@ export const ChartSchema = {
250
392
  example: true
251
393
  }
252
394
  },
253
- required: ['values', 'version_channel', 'name', 'namespace', 'chart', 'status', 'version_current', 'created_at', 'updated_at', 'ready'],
395
+ required: [
396
+ 'values',
397
+ 'version_channel',
398
+ 'name',
399
+ 'namespace',
400
+ 'chart',
401
+ 'status',
402
+ 'version_current',
403
+ 'created_at',
404
+ 'updated_at',
405
+ 'ready'
406
+ ],
254
407
  additionalProperties: false
255
408
  };
256
409
  export const ChartUpdateInputSchema = {
@@ -267,7 +420,10 @@ export const ChartUpdateInputSchema = {
267
420
  example: '2.x.x-cfke.x'
268
421
  }
269
422
  },
270
- required: ['values', 'version_channel'],
423
+ required: [
424
+ 'values',
425
+ 'version_channel'
426
+ ],
271
427
  additionalProperties: false
272
428
  };
273
429
  export const ClusterCreateInputSchema = {
@@ -284,26 +440,117 @@ export const ClusterCreateInputSchema = {
284
440
  tier: {
285
441
  type: 'string',
286
442
  description: 'Tier of the cluster.',
443
+ default: 'basic',
287
444
  example: 'pro',
288
- enum: ['basic', 'pro']
289
- },
290
- region: {
291
- type: 'string',
292
- description: 'Cloudfleet control plane region. One of "staging", "northamerica-central-1", "europe-central-1a". This field can not be updated after creation.',
293
- default: 'staging',
294
- example: 'northamerica-central-1',
295
- enum: ['staging', 'northamerica-central-1', 'europe-central-1a']
445
+ enum: [
446
+ 'basic',
447
+ 'pro'
448
+ ]
296
449
  },
297
450
  version_channel: {
298
451
  type: 'string',
299
452
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
300
453
  description: 'Version of the kubernetes cluster.',
301
454
  default: '1.x.x-cfke.x',
302
- example: '1.29.x-cfke.x'
455
+ example: '1.x.x-cfke.x'
456
+ },
457
+ release_channel: {
458
+ type: 'string',
459
+ description: 'Release channel for the cluster\'s control plane.',
460
+ default: 'rapid',
461
+ example: 'rapid',
462
+ enum: [
463
+ 'rapid',
464
+ 'stable',
465
+ 'extended'
466
+ ]
467
+ },
468
+ features: {
469
+ type: 'object',
470
+ properties: {
471
+ gpu_sharing_strategy: {
472
+ type: 'string',
473
+ description: 'GPU sharing strategy.',
474
+ default: 'none',
475
+ example: 'none',
476
+ enum: [
477
+ 'none',
478
+ 'mps',
479
+ 'time_slicing'
480
+ ]
481
+ },
482
+ gpu_max_shared_clients_per_gpu: {
483
+ type: 'integer',
484
+ minimum: 2,
485
+ maximum: 48,
486
+ description: 'Maximum number of pods that may share a single GPU.',
487
+ default: 4,
488
+ example: 10
489
+ },
490
+ cilium_socket_lb_host_namespace_only: {
491
+ type: 'boolean',
492
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
493
+ example: false
494
+ }
495
+ },
496
+ additionalProperties: false,
497
+ description: 'Cluster feature toggles.',
498
+ default: {
499
+ gpu_sharing_strategy: 'none',
500
+ gpu_max_shared_clients_per_gpu: 4,
501
+ cilium_socket_lb_host_namespace_only: false
502
+ }
503
+ },
504
+ region: {
505
+ type: 'string',
506
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
507
+ example: 'europe-central-1a'
508
+ },
509
+ networking: {
510
+ type: 'object',
511
+ properties: {
512
+ pod_cidr: {
513
+ type: 'string',
514
+ description: 'CIDR block for pod IPs.',
515
+ default: '10.244.0.0/16'
516
+ },
517
+ service_cidr: {
518
+ type: 'string',
519
+ description: 'CIDR block for service IPs.',
520
+ default: '10.96.0.0/12'
521
+ },
522
+ dual_stack: {
523
+ type: 'boolean',
524
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
525
+ },
526
+ pod_cidr_v6: {
527
+ type: 'string',
528
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
529
+ default: '2001:db8:1:2::/48'
530
+ },
531
+ service_cidr_v6: {
532
+ type: 'string',
533
+ description: 'IPv6 service CIDR. Requires dual_stack.',
534
+ default: '2001:db8:1:1::/112'
535
+ }
536
+ },
537
+ additionalProperties: false,
538
+ description: 'Cluster networking configuration. Immutable after creation.',
539
+ default: {
540
+ pod_cidr: '10.244.0.0/16',
541
+ service_cidr: '10.96.0.0/12',
542
+ dual_stack: false,
543
+ pod_cidr_v6: '2001:db8:1:2::/48',
544
+ service_cidr_v6: '2001:db8:1:1::/112'
545
+ }
303
546
  }
304
547
  },
305
- required: ['name', 'tier'],
306
- additionalProperties: false
548
+ required: [
549
+ 'name',
550
+ 'region'
551
+ ],
552
+ additionalProperties: false,
553
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
307
554
  };
308
555
  export const ClusterJoinInformationSchema = {
309
556
  type: 'object',
@@ -311,8 +558,7 @@ export const ClusterJoinInformationSchema = {
311
558
  certificate_authority: {
312
559
  type: 'string',
313
560
  description: 'Certificate authority data for the kubernetes cluster. This is the root certificate authority for the cluster.',
314
- example: `-----BEGIN CERTIFICATE-----
315
- MIIC0DCCAbigAwIBAgI...`
561
+ example: '-----BEGIN CERTIFICATE-----\nMIIC0DCCAbigAwIBAgI...'
316
562
  },
317
563
  endpoint: {
318
564
  type: 'string',
@@ -320,6 +566,16 @@ MIIC0DCCAbigAwIBAgI...`
320
566
  description: 'Internal URL of the Kubernetes cluster control plane. This is the endpoint that kubelet uses to connect to the cluster.',
321
567
  example: 'https://10.31.64.7:6443'
322
568
  },
569
+ cluster_dns: {
570
+ type: 'string',
571
+ description: 'Cluster DNS IP address. This is the IP address of the kube-dns service in the cluster.',
572
+ example: '10.96.0.10'
573
+ },
574
+ pod_cidr: {
575
+ type: 'string',
576
+ description: 'Pod CIDR for the cluster. Used to configure iptables rules on nodes to prevent Tailscale routing loops.',
577
+ example: '10.244.0.0/16'
578
+ },
323
579
  auth_key: {
324
580
  type: 'string',
325
581
  description: 'Authentication key for the cluster.',
@@ -336,7 +592,7 @@ MIIC0DCCAbigAwIBAgI...`
336
592
  kubernetes: {
337
593
  type: 'string',
338
594
  description: 'Kubernetes version of the cluster.',
339
- example: '1.29.3'
595
+ example: '1.33.7'
340
596
  },
341
597
  tailscale: {
342
598
  type: 'string',
@@ -354,7 +610,12 @@ MIIC0DCCAbigAwIBAgI...`
354
610
  example: '565.0.0'
355
611
  }
356
612
  },
357
- required: ['kubernetes', 'tailscale', 'containerd', 'nvidia_driver'],
613
+ required: [
614
+ 'kubernetes',
615
+ 'tailscale',
616
+ 'containerd',
617
+ 'nvidia_driver'
618
+ ],
358
619
  additionalProperties: false,
359
620
  description: 'Versions of the different components of the cluster.'
360
621
  },
@@ -377,12 +638,25 @@ MIIC0DCCAbigAwIBAgI...`
377
638
  example: '//iam.googleapis.com/projects/89014267864/locations/global/workloadIdentityPools/cfke/providers/oidc'
378
639
  }
379
640
  },
380
- required: ['metadata_url', 'aws_role_arn', 'gcp_workload_identity_provider'],
641
+ required: [
642
+ 'metadata_url',
643
+ 'aws_role_arn',
644
+ 'gcp_workload_identity_provider'
645
+ ],
381
646
  additionalProperties: false,
382
- description: "OIDC Information for hosts to access to third party API's."
647
+ description: 'OIDC Information for hosts to access to third party API\'s.'
383
648
  }
384
649
  },
385
- required: ['certificate_authority', 'endpoint', 'auth_key', 'bootstrap_token', 'versions', 'third_party_api_access_config'],
650
+ required: [
651
+ 'certificate_authority',
652
+ 'endpoint',
653
+ 'cluster_dns',
654
+ 'pod_cidr',
655
+ 'auth_key',
656
+ 'bootstrap_token',
657
+ 'versions',
658
+ 'third_party_api_access_config'
659
+ ],
386
660
  additionalProperties: false
387
661
  };
388
662
  export const ClusterSchema = {
@@ -399,22 +673,121 @@ export const ClusterSchema = {
399
673
  tier: {
400
674
  type: 'string',
401
675
  description: 'Tier of the cluster.',
676
+ default: 'basic',
402
677
  example: 'pro',
403
- enum: ['basic', 'pro']
404
- },
405
- region: {
406
- type: 'string',
407
- description: 'Cloudfleet control plane region. One of "staging", "northamerica-central-1", "europe-central-1a". This field can not be updated after creation.',
408
- default: 'staging',
409
- example: 'northamerica-central-1',
410
- enum: ['staging', 'northamerica-central-1', 'europe-central-1a']
678
+ enum: [
679
+ 'basic',
680
+ 'pro'
681
+ ]
411
682
  },
412
683
  version_channel: {
413
684
  type: 'string',
414
685
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
415
686
  description: 'Version of the kubernetes cluster.',
416
687
  default: '1.x.x-cfke.x',
417
- example: '1.29.x-cfke.x'
688
+ example: '1.x.x-cfke.x'
689
+ },
690
+ release_channel: {
691
+ type: 'string',
692
+ description: 'Release channel for the cluster\'s control plane.',
693
+ default: 'rapid',
694
+ example: 'rapid',
695
+ enum: [
696
+ 'rapid',
697
+ 'stable',
698
+ 'extended'
699
+ ]
700
+ },
701
+ features: {
702
+ type: 'object',
703
+ properties: {
704
+ gpu_sharing_strategy: {
705
+ type: 'string',
706
+ description: 'GPU sharing strategy.',
707
+ default: 'none',
708
+ example: 'none',
709
+ enum: [
710
+ 'none',
711
+ 'mps',
712
+ 'time_slicing'
713
+ ]
714
+ },
715
+ gpu_max_shared_clients_per_gpu: {
716
+ type: 'integer',
717
+ minimum: 2,
718
+ maximum: 48,
719
+ description: 'Maximum number of pods that may share a single GPU.',
720
+ default: 4,
721
+ example: 10
722
+ },
723
+ cilium_socket_lb_host_namespace_only: {
724
+ type: 'boolean',
725
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
726
+ example: false
727
+ }
728
+ },
729
+ required: [
730
+ 'gpu_sharing_strategy',
731
+ 'gpu_max_shared_clients_per_gpu',
732
+ 'cilium_socket_lb_host_namespace_only'
733
+ ],
734
+ additionalProperties: false,
735
+ description: 'Cluster feature toggles.',
736
+ default: {
737
+ gpu_sharing_strategy: 'none',
738
+ gpu_max_shared_clients_per_gpu: 4,
739
+ cilium_socket_lb_host_namespace_only: false
740
+ }
741
+ },
742
+ region: {
743
+ type: 'string',
744
+ description: 'Cloudfleet control plane region. This field can not be updated after creation.',
745
+ example: 'europe-central-1a'
746
+ },
747
+ networking: {
748
+ type: 'object',
749
+ properties: {
750
+ pod_cidr: {
751
+ type: 'string',
752
+ description: 'CIDR block for pod IPs.',
753
+ default: '10.244.0.0/16'
754
+ },
755
+ service_cidr: {
756
+ type: 'string',
757
+ description: 'CIDR block for service IPs.',
758
+ default: '10.96.0.0/12'
759
+ },
760
+ dual_stack: {
761
+ type: 'boolean',
762
+ description: 'Enable IPv4+IPv6 dual-stack networking.'
763
+ },
764
+ pod_cidr_v6: {
765
+ type: 'string',
766
+ description: 'IPv6 pod CIDR. Requires dual_stack.',
767
+ default: '2001:db8:1:2::/48'
768
+ },
769
+ service_cidr_v6: {
770
+ type: 'string',
771
+ description: 'IPv6 service CIDR. Requires dual_stack.',
772
+ default: '2001:db8:1:1::/112'
773
+ }
774
+ },
775
+ required: [
776
+ 'pod_cidr',
777
+ 'service_cidr',
778
+ 'dual_stack',
779
+ 'pod_cidr_v6',
780
+ 'service_cidr_v6'
781
+ ],
782
+ additionalProperties: false,
783
+ description: 'Cluster networking configuration. Immutable after creation.',
784
+ default: {
785
+ pod_cidr: '10.244.0.0/16',
786
+ service_cidr: '10.96.0.0/12',
787
+ dual_stack: false,
788
+ pod_cidr_v6: '2001:db8:1:2::/48',
789
+ service_cidr_v6: '2001:db8:1:1::/112'
790
+ }
418
791
  },
419
792
  id: {
420
793
  type: 'string',
@@ -424,34 +797,56 @@ export const ClusterSchema = {
424
797
  },
425
798
  status: {
426
799
  type: 'string',
427
- description: 'Status of the cluster. When creating a new cluster, set to `active`. When deleting a clusters, set to `deleted`.',
428
- example: 'active',
429
- enum: ['active', 'deleted', 'creating', 'deployed', 'failed', 'updating']
800
+ description: 'Status of the cluster.',
801
+ example: 'deployed',
802
+ enum: [
803
+ 'creating',
804
+ 'deployed',
805
+ 'updating',
806
+ 'disabled'
807
+ ]
430
808
  },
431
809
  endpoint: {
432
810
  anyOf: [
433
811
  {
434
812
  type: 'string',
435
813
  format: 'uri',
436
- description: 'URL of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
437
- example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.cloudfleet.dev:6443'
814
+ description: 'URL signed by a public CA of the Kubernetes cluster control plane. This is the endpoint that kubectl uses to connect to the cluster.',
815
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
816
+ },
817
+ {
818
+ type: 'string',
819
+ enum: [
820
+ ''
821
+ ]
822
+ }
823
+ ]
824
+ },
825
+ endpoint_public: {
826
+ anyOf: [
827
+ {
828
+ type: 'string',
829
+ format: 'uri',
830
+ description: 'Deprecated alias of `endpoint`; retained for backward compatibility.',
831
+ example: 'https://2ae6557c-c61f-49c6-b4c1-a65473470a03.staging.cfke.io'
438
832
  },
439
833
  {
440
834
  type: 'string',
441
- enum: ['']
835
+ enum: [
836
+ ''
837
+ ]
442
838
  }
443
839
  ]
444
840
  },
445
841
  certificate_ca: {
446
842
  type: 'string',
447
843
  description: 'Certificate authority data for the kubernetes cluster. This is the root certificate authority for the cluster.',
448
- example: `-----BEGIN CERTIFICATE-----
449
- MIIC0DCCAbigAwIBAgI...`
844
+ example: '-----BEGIN CERTIFICATE-----\nMIIC0DCCAbigAwIBAgI...'
450
845
  },
451
846
  version_current: {
452
847
  type: 'string',
453
848
  description: 'Current version of the cluster.',
454
- example: '1.29.3-cfke.52'
849
+ example: '1.33.7-cfke.264'
455
850
  },
456
851
  created_at: {
457
852
  type: 'string',
@@ -469,8 +864,20 @@ MIIC0DCCAbigAwIBAgI...`
469
864
  example: true
470
865
  }
471
866
  },
472
- required: ['name', 'tier', 'id', 'status'],
473
- additionalProperties: false
867
+ required: [
868
+ 'name',
869
+ 'tier',
870
+ 'version_channel',
871
+ 'release_channel',
872
+ 'features',
873
+ 'region',
874
+ 'networking',
875
+ 'id',
876
+ 'status',
877
+ 'ready'
878
+ ],
879
+ additionalProperties: false,
880
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
474
881
  };
475
882
  export const ClusterUpdateInputSchema = {
476
883
  type: 'object',
@@ -486,18 +893,73 @@ export const ClusterUpdateInputSchema = {
486
893
  tier: {
487
894
  type: 'string',
488
895
  description: 'Tier of the cluster.',
896
+ default: 'basic',
489
897
  example: 'pro',
490
- enum: ['basic', 'pro']
898
+ enum: [
899
+ 'basic',
900
+ 'pro'
901
+ ]
491
902
  },
492
903
  version_channel: {
493
904
  type: 'string',
494
905
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
495
906
  description: 'Version of the kubernetes cluster.',
496
- example: '1.29.x-cfke.x'
907
+ default: '1.x.x-cfke.x',
908
+ example: '1.x.x-cfke.x'
909
+ },
910
+ release_channel: {
911
+ type: 'string',
912
+ description: 'Release channel for the cluster\'s control plane.',
913
+ default: 'rapid',
914
+ example: 'rapid',
915
+ enum: [
916
+ 'rapid',
917
+ 'stable',
918
+ 'extended'
919
+ ]
920
+ },
921
+ features: {
922
+ type: 'object',
923
+ properties: {
924
+ gpu_sharing_strategy: {
925
+ type: 'string',
926
+ description: 'GPU sharing strategy.',
927
+ default: 'none',
928
+ example: 'none',
929
+ enum: [
930
+ 'none',
931
+ 'mps',
932
+ 'time_slicing'
933
+ ]
934
+ },
935
+ gpu_max_shared_clients_per_gpu: {
936
+ type: 'integer',
937
+ minimum: 2,
938
+ maximum: 48,
939
+ description: 'Maximum number of pods that may share a single GPU.',
940
+ default: 4,
941
+ example: 10
942
+ },
943
+ cilium_socket_lb_host_namespace_only: {
944
+ type: 'boolean',
945
+ description: 'Restrict Cilium socket load-balancing to the host namespace. Required for the Tailscale operator and Istio.',
946
+ example: false
947
+ }
948
+ },
949
+ additionalProperties: false,
950
+ description: 'Cluster feature toggles.',
951
+ default: {
952
+ gpu_sharing_strategy: 'none',
953
+ gpu_max_shared_clients_per_gpu: 4,
954
+ cilium_socket_lb_host_namespace_only: false
955
+ }
497
956
  }
498
957
  },
499
- required: ['tier'],
500
- additionalProperties: false
958
+ required: [
959
+ 'name'
960
+ ],
961
+ additionalProperties: false,
962
+ description: 'Mutable cluster configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
501
963
  };
502
964
  export const FleetCreateInputSchema = {
503
965
  type: 'object',
@@ -506,13 +968,12 @@ export const FleetCreateInputSchema = {
506
968
  type: 'object',
507
969
  properties: {
508
970
  cpu: {
509
- type: 'number',
510
- format: 'float',
971
+ type: 'integer',
511
972
  minimum: 0,
512
- description: 'CPU limit in cores.'
973
+ maximum: 100000,
974
+ description: 'CPU limit in cores. Maximum 100,000.'
513
975
  }
514
976
  },
515
- required: ['cpu'],
516
977
  additionalProperties: false,
517
978
  description: 'Limits define a set of bounds for provisioning capacity.'
518
979
  },
@@ -520,47 +981,358 @@ export const FleetCreateInputSchema = {
520
981
  type: 'object',
521
982
  properties: {
522
983
  enabled: {
523
- type: 'boolean',
524
- default: true
984
+ type: 'boolean'
525
985
  },
526
986
  project: {
527
987
  type: 'string',
528
- description: 'Project GCP Project id to deploy instances into'
988
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
989
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
990
+ example: 'my-cloudfleet-project'
529
991
  }
530
992
  },
531
- required: ['project'],
993
+ required: [
994
+ 'enabled'
995
+ ],
532
996
  additionalProperties: false
533
997
  },
534
998
  hetzner: {
535
999
  type: 'object',
536
1000
  properties: {
537
1001
  enabled: {
538
- type: 'boolean',
539
- default: true
1002
+ type: 'boolean'
540
1003
  },
541
1004
  apiKey: {
542
1005
  type: 'string',
543
- description: 'Hetzner Cloud API key with read / write access'
1006
+ maxLength: 64,
1007
+ minLength: 64,
1008
+ pattern: '^[A-Za-z0-9]+$',
1009
+ description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
544
1010
  }
545
1011
  },
546
- required: ['apiKey'],
1012
+ required: [
1013
+ 'enabled'
1014
+ ],
547
1015
  additionalProperties: false
548
1016
  },
549
1017
  aws: {
550
1018
  type: 'object',
551
1019
  properties: {
552
1020
  enabled: {
553
- type: 'boolean',
554
- default: true
1021
+ type: 'boolean'
555
1022
  },
556
1023
  controllerRoleArn: {
557
1024
  type: 'string',
558
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1025
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1026
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1027
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
559
1028
  }
560
1029
  },
561
- required: ['controllerRoleArn'],
1030
+ required: [
1031
+ 'enabled'
1032
+ ],
562
1033
  additionalProperties: false
563
1034
  },
1035
+ constraints: {
1036
+ type: 'object',
1037
+ properties: {
1038
+ 'karpenter.sh/capacity-type': {
1039
+ type: 'array',
1040
+ items: {
1041
+ type: 'string',
1042
+ enum: [
1043
+ 'on-demand',
1044
+ 'spot'
1045
+ ]
1046
+ },
1047
+ minItems: 1,
1048
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1049
+ default: [
1050
+ 'on-demand',
1051
+ 'spot'
1052
+ ]
1053
+ },
1054
+ 'kubernetes.io/arch': {
1055
+ type: 'array',
1056
+ items: {
1057
+ type: 'string',
1058
+ enum: [
1059
+ 'amd64',
1060
+ 'arm64'
1061
+ ]
1062
+ },
1063
+ minItems: 1,
1064
+ description: 'Allowed values for `kubernetes.io/arch`.',
1065
+ default: [
1066
+ 'amd64'
1067
+ ]
1068
+ },
1069
+ 'cfke.io/instance-family': {
1070
+ type: 'array',
1071
+ items: {
1072
+ type: 'string',
1073
+ enum: [
1074
+ 'a1',
1075
+ 'a2',
1076
+ 'a3',
1077
+ 'a4',
1078
+ 'c1',
1079
+ 'c2',
1080
+ 'c2d',
1081
+ 'c3',
1082
+ 'c3d',
1083
+ 'c4',
1084
+ 'c4a',
1085
+ 'c4d',
1086
+ 'c5',
1087
+ 'c5a',
1088
+ 'c5ad',
1089
+ 'c5d',
1090
+ 'c5n',
1091
+ 'c6a',
1092
+ 'c6g',
1093
+ 'c6gd',
1094
+ 'c6gn',
1095
+ 'c6i',
1096
+ 'c6id',
1097
+ 'c6in',
1098
+ 'c7a',
1099
+ 'c7g',
1100
+ 'c7gd',
1101
+ 'c7gn',
1102
+ 'c7i',
1103
+ 'c7i-flex',
1104
+ 'c8g',
1105
+ 'c8gd',
1106
+ 'cax',
1107
+ 'ccx',
1108
+ 'cpx',
1109
+ 'cx',
1110
+ 'd2',
1111
+ 'd3',
1112
+ 'd3en',
1113
+ 'dl1',
1114
+ 'dl2q',
1115
+ 'e2',
1116
+ 'f1',
1117
+ 'f2',
1118
+ 'g1',
1119
+ 'g2',
1120
+ 'g4ad',
1121
+ 'g4dn',
1122
+ 'g5',
1123
+ 'g5g',
1124
+ 'g6',
1125
+ 'g6e',
1126
+ 'gr6',
1127
+ 'h1',
1128
+ 'h3',
1129
+ 'hpc6a',
1130
+ 'hpc6id',
1131
+ 'hpc7a',
1132
+ 'hpc7g',
1133
+ 'i2',
1134
+ 'i3',
1135
+ 'i3en',
1136
+ 'i4g',
1137
+ 'i4i',
1138
+ 'i7i',
1139
+ 'i7ie',
1140
+ 'i8g',
1141
+ 'im4gn',
1142
+ 'inf1',
1143
+ 'inf2',
1144
+ 'is4gen',
1145
+ 'm1',
1146
+ 'm2',
1147
+ 'm3',
1148
+ 'm4',
1149
+ 'm5',
1150
+ 'm5a',
1151
+ 'm5ad',
1152
+ 'm5d',
1153
+ 'm5dn',
1154
+ 'm5n',
1155
+ 'm5zn',
1156
+ 'm6a',
1157
+ 'm6g',
1158
+ 'm6gd',
1159
+ 'm6i',
1160
+ 'm6id',
1161
+ 'm6idn',
1162
+ 'm6in',
1163
+ 'm7a',
1164
+ 'm7g',
1165
+ 'm7gd',
1166
+ 'm7i',
1167
+ 'm7i-flex',
1168
+ 'm8g',
1169
+ 'm8gd',
1170
+ 'n1',
1171
+ 'n2',
1172
+ 'n2d',
1173
+ 'n4',
1174
+ 'p3',
1175
+ 'p3dn',
1176
+ 'p4d',
1177
+ 'p4de',
1178
+ 'p5',
1179
+ 'p5e',
1180
+ 'p5en',
1181
+ 'p6-b200',
1182
+ 'r3',
1183
+ 'r4',
1184
+ 'r5',
1185
+ 'r5a',
1186
+ 'r5ad',
1187
+ 'r5b',
1188
+ 'r5d',
1189
+ 'r5dn',
1190
+ 'r5n',
1191
+ 'r6a',
1192
+ 'r6g',
1193
+ 'r6gd',
1194
+ 'r6i',
1195
+ 'r6id',
1196
+ 'r6idn',
1197
+ 'r6in',
1198
+ 'r7a',
1199
+ 'r7g',
1200
+ 'r7gd',
1201
+ 'r7i',
1202
+ 'r7iz',
1203
+ 'r8g',
1204
+ 'r8gd',
1205
+ 't2',
1206
+ 't2a',
1207
+ 't2d',
1208
+ 't3',
1209
+ 't3a',
1210
+ 't4g',
1211
+ 'trn1',
1212
+ 'trn1n',
1213
+ 'u-3tb1',
1214
+ 'u-6tb1',
1215
+ 'u7i-12tb',
1216
+ 'u7i-6tb',
1217
+ 'u7i-8tb',
1218
+ 'u7in-16tb',
1219
+ 'u7in-24tb',
1220
+ 'u7in-32tb',
1221
+ 'vt1',
1222
+ 'x1',
1223
+ 'x1e',
1224
+ 'x2gd',
1225
+ 'x2idn',
1226
+ 'x2iedn',
1227
+ 'x2iezn',
1228
+ 'x4',
1229
+ 'x8g',
1230
+ 'z1d',
1231
+ 'z3'
1232
+ ]
1233
+ },
1234
+ description: 'Allowed values for `cfke.io/instance-family`.',
1235
+ default: []
1236
+ },
1237
+ 'topology.kubernetes.io/region': {
1238
+ type: 'array',
1239
+ items: {
1240
+ type: 'string',
1241
+ enum: [
1242
+ 'africa-south1',
1243
+ 'ap-northeast-1',
1244
+ 'ap-northeast-2',
1245
+ 'ap-northeast-3',
1246
+ 'ap-south-1',
1247
+ 'ap-southeast-1',
1248
+ 'ap-southeast-2',
1249
+ 'ash',
1250
+ 'asia-east1',
1251
+ 'asia-east2',
1252
+ 'asia-northeast1',
1253
+ 'asia-northeast2',
1254
+ 'asia-northeast3',
1255
+ 'asia-south1',
1256
+ 'asia-south2',
1257
+ 'asia-southeast1',
1258
+ 'asia-southeast2',
1259
+ 'australia-southeast1',
1260
+ 'australia-southeast2',
1261
+ 'ca-central-1',
1262
+ 'eu-central-1',
1263
+ 'eu-central-2',
1264
+ 'eu-north-1',
1265
+ 'eu-west-1',
1266
+ 'eu-west-2',
1267
+ 'eu-west-3',
1268
+ 'europe-central2',
1269
+ 'europe-north1',
1270
+ 'europe-southwest1',
1271
+ 'europe-west1',
1272
+ 'europe-west10',
1273
+ 'europe-west12',
1274
+ 'europe-west2',
1275
+ 'europe-west3',
1276
+ 'europe-west4',
1277
+ 'europe-west6',
1278
+ 'europe-west8',
1279
+ 'europe-west9',
1280
+ 'fsn1',
1281
+ 'hel1',
1282
+ 'hil',
1283
+ 'me-central1',
1284
+ 'me-central2',
1285
+ 'me-west1',
1286
+ 'nbg1',
1287
+ 'northamerica-northeast1',
1288
+ 'northamerica-northeast2',
1289
+ 'sa-east-1',
1290
+ 'sin',
1291
+ 'southamerica-east1',
1292
+ 'southamerica-west1',
1293
+ 'us-central1',
1294
+ 'us-east-1',
1295
+ 'us-east-2',
1296
+ 'us-east1',
1297
+ 'us-east4',
1298
+ 'us-east5',
1299
+ 'us-south1',
1300
+ 'us-west-1',
1301
+ 'us-west-2',
1302
+ 'us-west1',
1303
+ 'us-west2',
1304
+ 'us-west3',
1305
+ 'us-west4'
1306
+ ]
1307
+ },
1308
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1309
+ default: []
1310
+ }
1311
+ },
1312
+ additionalProperties: false,
1313
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1314
+ default: {
1315
+ 'karpenter.sh/capacity-type': [
1316
+ 'on-demand',
1317
+ 'spot'
1318
+ ],
1319
+ 'kubernetes.io/arch': [
1320
+ 'amd64'
1321
+ ],
1322
+ 'cfke.io/instance-family': [],
1323
+ 'topology.kubernetes.io/region': []
1324
+ }
1325
+ },
1326
+ scalingProfile: {
1327
+ type: 'string',
1328
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1329
+ default: 'conservative',
1330
+ example: 'conservative',
1331
+ enum: [
1332
+ 'aggressive',
1333
+ 'conservative'
1334
+ ]
1335
+ },
564
1336
  id: {
565
1337
  type: 'string',
566
1338
  maxLength: 63,
@@ -570,8 +1342,11 @@ export const FleetCreateInputSchema = {
570
1342
  example: 'new-clouds-fleet'
571
1343
  }
572
1344
  },
573
- required: ['id'],
574
- additionalProperties: false
1345
+ required: [
1346
+ 'id'
1347
+ ],
1348
+ additionalProperties: false,
1349
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
575
1350
  };
576
1351
  export const FleetSchema = {
577
1352
  type: 'object',
@@ -580,13 +1355,12 @@ export const FleetSchema = {
580
1355
  type: 'object',
581
1356
  properties: {
582
1357
  cpu: {
583
- type: 'number',
584
- format: 'float',
1358
+ type: 'integer',
585
1359
  minimum: 0,
586
- description: 'CPU limit in cores.'
1360
+ maximum: 100000,
1361
+ description: 'CPU limit in cores. Maximum 100,000.'
587
1362
  }
588
1363
  },
589
- required: ['cpu'],
590
1364
  additionalProperties: false,
591
1365
  description: 'Limits define a set of bounds for provisioning capacity.'
592
1366
  },
@@ -594,47 +1368,360 @@ export const FleetSchema = {
594
1368
  type: 'object',
595
1369
  properties: {
596
1370
  enabled: {
597
- type: 'boolean',
598
- default: true
1371
+ type: 'boolean'
599
1372
  },
600
1373
  project: {
601
1374
  type: 'string',
602
- description: 'Project GCP Project id to deploy instances into'
1375
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1376
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1377
+ example: 'my-cloudfleet-project'
603
1378
  }
604
1379
  },
605
- required: ['project'],
1380
+ required: [
1381
+ 'enabled'
1382
+ ],
606
1383
  additionalProperties: false
607
1384
  },
608
1385
  hetzner: {
609
1386
  type: 'object',
610
1387
  properties: {
611
1388
  enabled: {
612
- type: 'boolean',
613
- default: true
1389
+ type: 'boolean'
614
1390
  },
615
1391
  apiKey: {
616
1392
  type: 'string',
617
- description: 'Hetzner Cloud API key with read / write access'
1393
+ pattern: '^\\*{64}$',
1394
+ description: 'Redacted Hetzner API token. Returned as 64 asterisks when a token is configured; omitted otherwise. The real value is never echoed by the API.'
618
1395
  }
619
1396
  },
620
- required: ['apiKey'],
1397
+ required: [
1398
+ 'enabled'
1399
+ ],
621
1400
  additionalProperties: false
622
1401
  },
623
1402
  aws: {
624
1403
  type: 'object',
625
1404
  properties: {
626
1405
  enabled: {
627
- type: 'boolean',
628
- default: true
1406
+ type: 'boolean'
629
1407
  },
630
1408
  controllerRoleArn: {
631
1409
  type: 'string',
632
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1410
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1411
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1412
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
633
1413
  }
634
1414
  },
635
- required: ['controllerRoleArn'],
1415
+ required: [
1416
+ 'enabled'
1417
+ ],
636
1418
  additionalProperties: false
637
1419
  },
1420
+ constraints: {
1421
+ type: 'object',
1422
+ properties: {
1423
+ 'karpenter.sh/capacity-type': {
1424
+ type: 'array',
1425
+ items: {
1426
+ type: 'string',
1427
+ enum: [
1428
+ 'on-demand',
1429
+ 'spot'
1430
+ ]
1431
+ },
1432
+ minItems: 1,
1433
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1434
+ default: [
1435
+ 'on-demand',
1436
+ 'spot'
1437
+ ]
1438
+ },
1439
+ 'kubernetes.io/arch': {
1440
+ type: 'array',
1441
+ items: {
1442
+ type: 'string',
1443
+ enum: [
1444
+ 'amd64',
1445
+ 'arm64'
1446
+ ]
1447
+ },
1448
+ minItems: 1,
1449
+ description: 'Allowed values for `kubernetes.io/arch`.',
1450
+ default: [
1451
+ 'amd64'
1452
+ ]
1453
+ },
1454
+ 'cfke.io/instance-family': {
1455
+ type: 'array',
1456
+ items: {
1457
+ type: 'string',
1458
+ enum: [
1459
+ 'a1',
1460
+ 'a2',
1461
+ 'a3',
1462
+ 'a4',
1463
+ 'c1',
1464
+ 'c2',
1465
+ 'c2d',
1466
+ 'c3',
1467
+ 'c3d',
1468
+ 'c4',
1469
+ 'c4a',
1470
+ 'c4d',
1471
+ 'c5',
1472
+ 'c5a',
1473
+ 'c5ad',
1474
+ 'c5d',
1475
+ 'c5n',
1476
+ 'c6a',
1477
+ 'c6g',
1478
+ 'c6gd',
1479
+ 'c6gn',
1480
+ 'c6i',
1481
+ 'c6id',
1482
+ 'c6in',
1483
+ 'c7a',
1484
+ 'c7g',
1485
+ 'c7gd',
1486
+ 'c7gn',
1487
+ 'c7i',
1488
+ 'c7i-flex',
1489
+ 'c8g',
1490
+ 'c8gd',
1491
+ 'cax',
1492
+ 'ccx',
1493
+ 'cpx',
1494
+ 'cx',
1495
+ 'd2',
1496
+ 'd3',
1497
+ 'd3en',
1498
+ 'dl1',
1499
+ 'dl2q',
1500
+ 'e2',
1501
+ 'f1',
1502
+ 'f2',
1503
+ 'g1',
1504
+ 'g2',
1505
+ 'g4ad',
1506
+ 'g4dn',
1507
+ 'g5',
1508
+ 'g5g',
1509
+ 'g6',
1510
+ 'g6e',
1511
+ 'gr6',
1512
+ 'h1',
1513
+ 'h3',
1514
+ 'hpc6a',
1515
+ 'hpc6id',
1516
+ 'hpc7a',
1517
+ 'hpc7g',
1518
+ 'i2',
1519
+ 'i3',
1520
+ 'i3en',
1521
+ 'i4g',
1522
+ 'i4i',
1523
+ 'i7i',
1524
+ 'i7ie',
1525
+ 'i8g',
1526
+ 'im4gn',
1527
+ 'inf1',
1528
+ 'inf2',
1529
+ 'is4gen',
1530
+ 'm1',
1531
+ 'm2',
1532
+ 'm3',
1533
+ 'm4',
1534
+ 'm5',
1535
+ 'm5a',
1536
+ 'm5ad',
1537
+ 'm5d',
1538
+ 'm5dn',
1539
+ 'm5n',
1540
+ 'm5zn',
1541
+ 'm6a',
1542
+ 'm6g',
1543
+ 'm6gd',
1544
+ 'm6i',
1545
+ 'm6id',
1546
+ 'm6idn',
1547
+ 'm6in',
1548
+ 'm7a',
1549
+ 'm7g',
1550
+ 'm7gd',
1551
+ 'm7i',
1552
+ 'm7i-flex',
1553
+ 'm8g',
1554
+ 'm8gd',
1555
+ 'n1',
1556
+ 'n2',
1557
+ 'n2d',
1558
+ 'n4',
1559
+ 'p3',
1560
+ 'p3dn',
1561
+ 'p4d',
1562
+ 'p4de',
1563
+ 'p5',
1564
+ 'p5e',
1565
+ 'p5en',
1566
+ 'p6-b200',
1567
+ 'r3',
1568
+ 'r4',
1569
+ 'r5',
1570
+ 'r5a',
1571
+ 'r5ad',
1572
+ 'r5b',
1573
+ 'r5d',
1574
+ 'r5dn',
1575
+ 'r5n',
1576
+ 'r6a',
1577
+ 'r6g',
1578
+ 'r6gd',
1579
+ 'r6i',
1580
+ 'r6id',
1581
+ 'r6idn',
1582
+ 'r6in',
1583
+ 'r7a',
1584
+ 'r7g',
1585
+ 'r7gd',
1586
+ 'r7i',
1587
+ 'r7iz',
1588
+ 'r8g',
1589
+ 'r8gd',
1590
+ 't2',
1591
+ 't2a',
1592
+ 't2d',
1593
+ 't3',
1594
+ 't3a',
1595
+ 't4g',
1596
+ 'trn1',
1597
+ 'trn1n',
1598
+ 'u-3tb1',
1599
+ 'u-6tb1',
1600
+ 'u7i-12tb',
1601
+ 'u7i-6tb',
1602
+ 'u7i-8tb',
1603
+ 'u7in-16tb',
1604
+ 'u7in-24tb',
1605
+ 'u7in-32tb',
1606
+ 'vt1',
1607
+ 'x1',
1608
+ 'x1e',
1609
+ 'x2gd',
1610
+ 'x2idn',
1611
+ 'x2iedn',
1612
+ 'x2iezn',
1613
+ 'x4',
1614
+ 'x8g',
1615
+ 'z1d',
1616
+ 'z3'
1617
+ ]
1618
+ },
1619
+ description: 'Allowed values for `cfke.io/instance-family`.',
1620
+ default: []
1621
+ },
1622
+ 'topology.kubernetes.io/region': {
1623
+ type: 'array',
1624
+ items: {
1625
+ type: 'string',
1626
+ enum: [
1627
+ 'africa-south1',
1628
+ 'ap-northeast-1',
1629
+ 'ap-northeast-2',
1630
+ 'ap-northeast-3',
1631
+ 'ap-south-1',
1632
+ 'ap-southeast-1',
1633
+ 'ap-southeast-2',
1634
+ 'ash',
1635
+ 'asia-east1',
1636
+ 'asia-east2',
1637
+ 'asia-northeast1',
1638
+ 'asia-northeast2',
1639
+ 'asia-northeast3',
1640
+ 'asia-south1',
1641
+ 'asia-south2',
1642
+ 'asia-southeast1',
1643
+ 'asia-southeast2',
1644
+ 'australia-southeast1',
1645
+ 'australia-southeast2',
1646
+ 'ca-central-1',
1647
+ 'eu-central-1',
1648
+ 'eu-central-2',
1649
+ 'eu-north-1',
1650
+ 'eu-west-1',
1651
+ 'eu-west-2',
1652
+ 'eu-west-3',
1653
+ 'europe-central2',
1654
+ 'europe-north1',
1655
+ 'europe-southwest1',
1656
+ 'europe-west1',
1657
+ 'europe-west10',
1658
+ 'europe-west12',
1659
+ 'europe-west2',
1660
+ 'europe-west3',
1661
+ 'europe-west4',
1662
+ 'europe-west6',
1663
+ 'europe-west8',
1664
+ 'europe-west9',
1665
+ 'fsn1',
1666
+ 'hel1',
1667
+ 'hil',
1668
+ 'me-central1',
1669
+ 'me-central2',
1670
+ 'me-west1',
1671
+ 'nbg1',
1672
+ 'northamerica-northeast1',
1673
+ 'northamerica-northeast2',
1674
+ 'sa-east-1',
1675
+ 'sin',
1676
+ 'southamerica-east1',
1677
+ 'southamerica-west1',
1678
+ 'us-central1',
1679
+ 'us-east-1',
1680
+ 'us-east-2',
1681
+ 'us-east1',
1682
+ 'us-east4',
1683
+ 'us-east5',
1684
+ 'us-south1',
1685
+ 'us-west-1',
1686
+ 'us-west-2',
1687
+ 'us-west1',
1688
+ 'us-west2',
1689
+ 'us-west3',
1690
+ 'us-west4'
1691
+ ]
1692
+ },
1693
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
1694
+ default: []
1695
+ }
1696
+ },
1697
+ required: [
1698
+ 'karpenter.sh/capacity-type',
1699
+ 'kubernetes.io/arch'
1700
+ ],
1701
+ additionalProperties: false,
1702
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
1703
+ default: {
1704
+ 'karpenter.sh/capacity-type': [
1705
+ 'on-demand',
1706
+ 'spot'
1707
+ ],
1708
+ 'kubernetes.io/arch': [
1709
+ 'amd64'
1710
+ ],
1711
+ 'cfke.io/instance-family': [],
1712
+ 'topology.kubernetes.io/region': []
1713
+ }
1714
+ },
1715
+ scalingProfile: {
1716
+ type: 'string',
1717
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
1718
+ default: 'conservative',
1719
+ example: 'conservative',
1720
+ enum: [
1721
+ 'aggressive',
1722
+ 'conservative'
1723
+ ]
1724
+ },
638
1725
  id: {
639
1726
  type: 'string',
640
1727
  maxLength: 63,
@@ -642,10 +1729,38 @@ export const FleetSchema = {
642
1729
  pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
643
1730
  description: 'Unique identifier of the kubernetes fleet.',
644
1731
  example: 'new-clouds-fleet'
1732
+ },
1733
+ ready: {
1734
+ type: 'boolean',
1735
+ description: 'Indicates whether the fleet configuration is healthy.',
1736
+ example: true
1737
+ },
1738
+ status_message: {
1739
+ type: 'string',
1740
+ description: 'Human-readable reason the fleet is not ready. Present only when `ready` is false.',
1741
+ example: 'Invalid provider permissions.'
1742
+ },
1743
+ created_at: {
1744
+ type: 'string',
1745
+ description: 'Creation date and time of the fleet.',
1746
+ example: '2024-09-12T09:11:27Z'
1747
+ },
1748
+ updated_at: {
1749
+ type: 'string',
1750
+ description: 'Date and time the fleet was last updated.',
1751
+ example: '2024-09-12T09:11:27Z'
645
1752
  }
646
1753
  },
647
- required: ['id'],
648
- additionalProperties: false
1754
+ required: [
1755
+ 'constraints',
1756
+ 'scalingProfile',
1757
+ 'id',
1758
+ 'ready',
1759
+ 'created_at',
1760
+ 'updated_at'
1761
+ ],
1762
+ additionalProperties: false,
1763
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
649
1764
  };
650
1765
  export const FleetUpdateInputSchema = {
651
1766
  type: 'object',
@@ -654,13 +1769,12 @@ export const FleetUpdateInputSchema = {
654
1769
  type: 'object',
655
1770
  properties: {
656
1771
  cpu: {
657
- type: 'number',
658
- format: 'float',
1772
+ type: 'integer',
659
1773
  minimum: 0,
660
- description: 'CPU limit in cores.'
1774
+ maximum: 100000,
1775
+ description: 'CPU limit in cores. Maximum 100,000.'
661
1776
  }
662
1777
  },
663
- required: ['cpu'],
664
1778
  additionalProperties: false,
665
1779
  description: 'Limits define a set of bounds for provisioning capacity.'
666
1780
  },
@@ -668,53 +1782,390 @@ export const FleetUpdateInputSchema = {
668
1782
  type: 'object',
669
1783
  properties: {
670
1784
  enabled: {
671
- type: 'boolean',
672
- default: true
1785
+ type: 'boolean'
673
1786
  },
674
1787
  project: {
675
1788
  type: 'string',
676
- description: 'Project GCP Project id to deploy instances into'
1789
+ pattern: '^[a-z][a-z0-9-]{4,28}[a-z0-9]$',
1790
+ description: 'GCP project ID to deploy instances into. 6-30 chars, lowercase letters/digits/hyphens, must start with a letter and not end with a hyphen. Omit when GCP is disabled.',
1791
+ example: 'my-cloudfleet-project'
677
1792
  }
678
1793
  },
679
- required: ['project'],
1794
+ required: [
1795
+ 'enabled'
1796
+ ],
680
1797
  additionalProperties: false
681
1798
  },
682
1799
  hetzner: {
683
1800
  type: 'object',
684
1801
  properties: {
685
1802
  enabled: {
686
- type: 'boolean',
687
- default: true
1803
+ type: 'boolean'
688
1804
  },
689
1805
  apiKey: {
690
1806
  type: 'string',
691
- description: 'Hetzner Cloud API key with read / write access'
1807
+ maxLength: 64,
1808
+ minLength: 64,
1809
+ pattern: '^[A-Za-z0-9]+$',
1810
+ description: 'Hetzner Cloud API token with read / write access (64 alphanumeric characters). Omit this field to keep the existing value.'
692
1811
  }
693
1812
  },
694
- required: ['apiKey'],
1813
+ required: [
1814
+ 'enabled'
1815
+ ],
695
1816
  additionalProperties: false
696
1817
  },
697
1818
  aws: {
698
1819
  type: 'object',
699
1820
  properties: {
700
1821
  enabled: {
701
- type: 'boolean',
702
- default: true
1822
+ type: 'boolean'
703
1823
  },
704
1824
  controllerRoleArn: {
705
1825
  type: 'string',
706
- description: 'ControllerRoleArn is the AWS IAM role that Karpenter uses to manage resources.'
1826
+ pattern: '^arn:aws(-[a-z]+)*:iam::\\d{12}:role\\/[\\w+=,.@/-]+$',
1827
+ description: 'AWS IAM role ARN that Karpenter uses to manage resources. Omit when AWS is disabled.',
1828
+ example: 'arn:aws:iam::123456789012:role/Cloudfleet'
707
1829
  }
708
1830
  },
709
- required: ['controllerRoleArn'],
1831
+ required: [
1832
+ 'enabled'
1833
+ ],
710
1834
  additionalProperties: false
711
- }
712
- },
713
- additionalProperties: false
714
- };
715
- export const InviteSchema = {
716
- type: 'object',
717
- properties: {
1835
+ },
1836
+ constraints: {
1837
+ type: 'object',
1838
+ properties: {
1839
+ 'karpenter.sh/capacity-type': {
1840
+ type: 'array',
1841
+ items: {
1842
+ type: 'string',
1843
+ enum: [
1844
+ 'on-demand',
1845
+ 'spot'
1846
+ ]
1847
+ },
1848
+ minItems: 1,
1849
+ description: 'Allowed values for `karpenter.sh/capacity-type`.',
1850
+ default: [
1851
+ 'on-demand',
1852
+ 'spot'
1853
+ ]
1854
+ },
1855
+ 'kubernetes.io/arch': {
1856
+ type: 'array',
1857
+ items: {
1858
+ type: 'string',
1859
+ enum: [
1860
+ 'amd64',
1861
+ 'arm64'
1862
+ ]
1863
+ },
1864
+ minItems: 1,
1865
+ description: 'Allowed values for `kubernetes.io/arch`.',
1866
+ default: [
1867
+ 'amd64'
1868
+ ]
1869
+ },
1870
+ 'cfke.io/instance-family': {
1871
+ type: 'array',
1872
+ items: {
1873
+ type: 'string',
1874
+ enum: [
1875
+ 'a1',
1876
+ 'a2',
1877
+ 'a3',
1878
+ 'a4',
1879
+ 'c1',
1880
+ 'c2',
1881
+ 'c2d',
1882
+ 'c3',
1883
+ 'c3d',
1884
+ 'c4',
1885
+ 'c4a',
1886
+ 'c4d',
1887
+ 'c5',
1888
+ 'c5a',
1889
+ 'c5ad',
1890
+ 'c5d',
1891
+ 'c5n',
1892
+ 'c6a',
1893
+ 'c6g',
1894
+ 'c6gd',
1895
+ 'c6gn',
1896
+ 'c6i',
1897
+ 'c6id',
1898
+ 'c6in',
1899
+ 'c7a',
1900
+ 'c7g',
1901
+ 'c7gd',
1902
+ 'c7gn',
1903
+ 'c7i',
1904
+ 'c7i-flex',
1905
+ 'c8g',
1906
+ 'c8gd',
1907
+ 'cax',
1908
+ 'ccx',
1909
+ 'cpx',
1910
+ 'cx',
1911
+ 'd2',
1912
+ 'd3',
1913
+ 'd3en',
1914
+ 'dl1',
1915
+ 'dl2q',
1916
+ 'e2',
1917
+ 'f1',
1918
+ 'f2',
1919
+ 'g1',
1920
+ 'g2',
1921
+ 'g4ad',
1922
+ 'g4dn',
1923
+ 'g5',
1924
+ 'g5g',
1925
+ 'g6',
1926
+ 'g6e',
1927
+ 'gr6',
1928
+ 'h1',
1929
+ 'h3',
1930
+ 'hpc6a',
1931
+ 'hpc6id',
1932
+ 'hpc7a',
1933
+ 'hpc7g',
1934
+ 'i2',
1935
+ 'i3',
1936
+ 'i3en',
1937
+ 'i4g',
1938
+ 'i4i',
1939
+ 'i7i',
1940
+ 'i7ie',
1941
+ 'i8g',
1942
+ 'im4gn',
1943
+ 'inf1',
1944
+ 'inf2',
1945
+ 'is4gen',
1946
+ 'm1',
1947
+ 'm2',
1948
+ 'm3',
1949
+ 'm4',
1950
+ 'm5',
1951
+ 'm5a',
1952
+ 'm5ad',
1953
+ 'm5d',
1954
+ 'm5dn',
1955
+ 'm5n',
1956
+ 'm5zn',
1957
+ 'm6a',
1958
+ 'm6g',
1959
+ 'm6gd',
1960
+ 'm6i',
1961
+ 'm6id',
1962
+ 'm6idn',
1963
+ 'm6in',
1964
+ 'm7a',
1965
+ 'm7g',
1966
+ 'm7gd',
1967
+ 'm7i',
1968
+ 'm7i-flex',
1969
+ 'm8g',
1970
+ 'm8gd',
1971
+ 'n1',
1972
+ 'n2',
1973
+ 'n2d',
1974
+ 'n4',
1975
+ 'p3',
1976
+ 'p3dn',
1977
+ 'p4d',
1978
+ 'p4de',
1979
+ 'p5',
1980
+ 'p5e',
1981
+ 'p5en',
1982
+ 'p6-b200',
1983
+ 'r3',
1984
+ 'r4',
1985
+ 'r5',
1986
+ 'r5a',
1987
+ 'r5ad',
1988
+ 'r5b',
1989
+ 'r5d',
1990
+ 'r5dn',
1991
+ 'r5n',
1992
+ 'r6a',
1993
+ 'r6g',
1994
+ 'r6gd',
1995
+ 'r6i',
1996
+ 'r6id',
1997
+ 'r6idn',
1998
+ 'r6in',
1999
+ 'r7a',
2000
+ 'r7g',
2001
+ 'r7gd',
2002
+ 'r7i',
2003
+ 'r7iz',
2004
+ 'r8g',
2005
+ 'r8gd',
2006
+ 't2',
2007
+ 't2a',
2008
+ 't2d',
2009
+ 't3',
2010
+ 't3a',
2011
+ 't4g',
2012
+ 'trn1',
2013
+ 'trn1n',
2014
+ 'u-3tb1',
2015
+ 'u-6tb1',
2016
+ 'u7i-12tb',
2017
+ 'u7i-6tb',
2018
+ 'u7i-8tb',
2019
+ 'u7in-16tb',
2020
+ 'u7in-24tb',
2021
+ 'u7in-32tb',
2022
+ 'vt1',
2023
+ 'x1',
2024
+ 'x1e',
2025
+ 'x2gd',
2026
+ 'x2idn',
2027
+ 'x2iedn',
2028
+ 'x2iezn',
2029
+ 'x4',
2030
+ 'x8g',
2031
+ 'z1d',
2032
+ 'z3'
2033
+ ]
2034
+ },
2035
+ description: 'Allowed values for `cfke.io/instance-family`.',
2036
+ default: []
2037
+ },
2038
+ 'topology.kubernetes.io/region': {
2039
+ type: 'array',
2040
+ items: {
2041
+ type: 'string',
2042
+ enum: [
2043
+ 'africa-south1',
2044
+ 'ap-northeast-1',
2045
+ 'ap-northeast-2',
2046
+ 'ap-northeast-3',
2047
+ 'ap-south-1',
2048
+ 'ap-southeast-1',
2049
+ 'ap-southeast-2',
2050
+ 'ash',
2051
+ 'asia-east1',
2052
+ 'asia-east2',
2053
+ 'asia-northeast1',
2054
+ 'asia-northeast2',
2055
+ 'asia-northeast3',
2056
+ 'asia-south1',
2057
+ 'asia-south2',
2058
+ 'asia-southeast1',
2059
+ 'asia-southeast2',
2060
+ 'australia-southeast1',
2061
+ 'australia-southeast2',
2062
+ 'ca-central-1',
2063
+ 'eu-central-1',
2064
+ 'eu-central-2',
2065
+ 'eu-north-1',
2066
+ 'eu-west-1',
2067
+ 'eu-west-2',
2068
+ 'eu-west-3',
2069
+ 'europe-central2',
2070
+ 'europe-north1',
2071
+ 'europe-southwest1',
2072
+ 'europe-west1',
2073
+ 'europe-west10',
2074
+ 'europe-west12',
2075
+ 'europe-west2',
2076
+ 'europe-west3',
2077
+ 'europe-west4',
2078
+ 'europe-west6',
2079
+ 'europe-west8',
2080
+ 'europe-west9',
2081
+ 'fsn1',
2082
+ 'hel1',
2083
+ 'hil',
2084
+ 'me-central1',
2085
+ 'me-central2',
2086
+ 'me-west1',
2087
+ 'nbg1',
2088
+ 'northamerica-northeast1',
2089
+ 'northamerica-northeast2',
2090
+ 'sa-east-1',
2091
+ 'sin',
2092
+ 'southamerica-east1',
2093
+ 'southamerica-west1',
2094
+ 'us-central1',
2095
+ 'us-east-1',
2096
+ 'us-east-2',
2097
+ 'us-east1',
2098
+ 'us-east4',
2099
+ 'us-east5',
2100
+ 'us-south1',
2101
+ 'us-west-1',
2102
+ 'us-west-2',
2103
+ 'us-west1',
2104
+ 'us-west2',
2105
+ 'us-west3',
2106
+ 'us-west4'
2107
+ ]
2108
+ },
2109
+ description: 'Allowed values for `topology.kubernetes.io/region`.',
2110
+ default: []
2111
+ }
2112
+ },
2113
+ additionalProperties: false,
2114
+ description: 'Constraints define scheduling and provisioning requirements for the fleet. Each field restricts the values allowed for a given Kubernetes label key. Multiple constraints are ANDed together.',
2115
+ default: {
2116
+ 'karpenter.sh/capacity-type': [
2117
+ 'on-demand',
2118
+ 'spot'
2119
+ ],
2120
+ 'kubernetes.io/arch': [
2121
+ 'amd64'
2122
+ ],
2123
+ 'cfke.io/instance-family': [],
2124
+ 'topology.kubernetes.io/region': []
2125
+ }
2126
+ },
2127
+ scalingProfile: {
2128
+ type: 'string',
2129
+ description: 'Controls scale-up / scale-down responsiveness. `aggressive` prioritizes cost-optimization. `conservative` prioritizes stability of the fleet.',
2130
+ default: 'conservative',
2131
+ example: 'conservative',
2132
+ enum: [
2133
+ 'aggressive',
2134
+ 'conservative'
2135
+ ]
2136
+ }
2137
+ },
2138
+ additionalProperties: false,
2139
+ description: 'Mutable fleet configuration. Applied as a full overwrite: any omitted field is reset to its default rather than left unchanged.'
2140
+ };
2141
+ export const InviteCreateInputSchema = {
2142
+ type: 'object',
2143
+ properties: {
2144
+ email: {
2145
+ type: 'string',
2146
+ format: 'email',
2147
+ description: 'Email address of the user to invite.',
2148
+ example: 'email@example.com'
2149
+ },
2150
+ role: {
2151
+ type: 'string',
2152
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2153
+ default: 'User',
2154
+ example: 'User',
2155
+ enum: [
2156
+ 'Administrator',
2157
+ 'User'
2158
+ ]
2159
+ }
2160
+ },
2161
+ required: [
2162
+ 'email'
2163
+ ],
2164
+ additionalProperties: false
2165
+ };
2166
+ export const InviteSchema = {
2167
+ type: 'object',
2168
+ properties: {
718
2169
  id: {
719
2170
  type: 'string',
720
2171
  description: 'Unique identifier of the invitation.',
@@ -742,9 +2193,21 @@ export const InviteSchema = {
742
2193
  type: 'string',
743
2194
  description: 'Generated unique invite code.',
744
2195
  example: '7kUZnH7nnKUFfvc4NK2KQF'
2196
+ },
2197
+ role: {
2198
+ type: 'string',
2199
+ description: 'Role the invited user will be assigned on redemption. Can be \'Administrator\' or \'User\'.',
2200
+ default: 'User',
2201
+ example: 'User',
2202
+ enum: [
2203
+ 'Administrator',
2204
+ 'User'
2205
+ ]
745
2206
  }
746
2207
  },
747
- required: ['date_created'],
2208
+ required: [
2209
+ 'date_created'
2210
+ ],
748
2211
  additionalProperties: false
749
2212
  };
750
2213
  export const InvoiceSchema = {
@@ -752,23 +2215,18 @@ export const InvoiceSchema = {
752
2215
  properties: {
753
2216
  id: {
754
2217
  type: 'string',
755
- format: 'uuid',
756
- description: 'Unique identifier of the invoice. UUID v4 string in canonical form',
757
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
2218
+ description: 'Unique identifier of the invoice.',
2219
+ example: 'in_1234567890xCrwxghOTj1234'
758
2220
  },
759
- organizationId: {
760
- type: 'string',
761
- format: 'uuid',
762
- description: 'Unique identifier of the organization. UUID v4 string in canonical form',
763
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
2221
+ number: {
2222
+ type: 'string'
764
2223
  },
765
2224
  status: {
766
2225
  type: 'string',
767
2226
  description: 'Status of the invoice',
768
- example: 'DRAFT',
769
- enum: ['DRAFT', 'COMMITTED', 'VOID']
2227
+ example: 'paid'
770
2228
  },
771
- amount: {
2229
+ total: {
772
2230
  type: 'number',
773
2231
  format: 'float',
774
2232
  description: 'Total amount of the invoice',
@@ -777,431 +2235,218 @@ export const InvoiceSchema = {
777
2235
  currency: {
778
2236
  type: 'string',
779
2237
  description: 'Currency of the invoice',
780
- example: 'USD',
781
- enum: ['AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BRL', 'BSD', 'BTN', 'BWP', 'BYR', 'BZD', 'CAD', 'CDF', 'CHF', 'CLP', 'CNY', 'COP', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GGP', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'IMP', 'INR', 'IQD', 'IRR', 'ISK', 'JEP', 'JMD', 'JOD', 'JPY', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KRW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LTL', 'LVL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRO', 'MUR', 'MVR', 'MWK', 'MXN', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLL', 'SOS', 'SPL', 'SRD', 'STD', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TVD', 'TWD', 'TZS', 'UAH', 'UGX', 'USD', 'UYU', 'UZS', 'VEF', 'VND', 'VUV', 'WST', 'XAF', 'XCD', 'XDR', 'XOF', 'XPF', 'YER', 'ZAR', 'ZMW', 'ZWD', 'BTC']
782
- },
783
- creditAdj: {
784
- type: 'number',
785
- format: 'float',
786
- description: 'Total amount of credit adjustments',
787
- example: 0
788
- },
789
- refundAdj: {
790
- type: 'number',
791
- format: 'float',
792
- description: 'Total amount of refund adjustments',
793
- example: 0
2238
+ example: 'usd'
794
2239
  },
795
- invoiceDate: {
2240
+ created: {
796
2241
  type: 'string',
797
- description: 'Date of the invoice',
798
- example: '2019-01-01T00:00:00.000Z'
799
- },
800
- targetDate: {
801
- type: 'string',
802
- description: 'Target date of the invoice',
803
- example: '2019-01-01T00:00:00.000Z'
2242
+ format: 'date-time',
2243
+ description: 'Timestamp when the invoice was issued. ISO 8601 date string in the UTC timezone.',
2244
+ example: '2023-12-20T13:53:32.000Z'
804
2245
  },
805
- invoiceNumber: {
2246
+ period_start: {
806
2247
  type: 'string',
807
- description: 'Number of the invoice',
808
- example: 'INV-0001'
809
- },
810
- balance: {
811
- type: 'number',
812
- format: 'float',
813
- description: 'Balance of the invoice',
814
- example: 100
2248
+ format: 'date-time',
2249
+ description: 'Billing period start timestamp. ISO 8601 date string in the UTC timezone.',
2250
+ example: '2023-12-20T13:53:32.000Z'
815
2251
  },
816
- bundleKeys: {
2252
+ period_end: {
817
2253
  type: 'string',
818
- description: 'Bundle keys of the invoice',
819
- example: 'bundleKey1,bundleKey2'
820
- },
821
- credits: {
822
- type: 'array',
823
- items: {
824
- type: 'object',
825
- properties: {
826
- id: {
827
- type: 'string',
828
- format: 'uuid',
829
- description: 'Unique identifier of the invoice item. UUID v4 string in canonical form',
830
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
831
- },
832
- linkedInvoiceItemId: {
833
- type: 'string',
834
- format: 'uuid',
835
- description: 'Unique identifier of the linked invoice item. UUID v4 string in canonical form',
836
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
837
- },
838
- productName: {
839
- type: 'string',
840
- description: 'Name of the product',
841
- example: 'Research team'
842
- },
843
- planName: {
844
- type: 'string',
845
- description: 'Name of the plan',
846
- example: 'Plan A'
847
- },
848
- phaseName: {
849
- type: 'string',
850
- description: 'Name of the phase',
851
- example: 'Phase A'
852
- },
853
- usageName: {
854
- type: 'string',
855
- description: 'Name of the usage',
856
- example: 'Usage A'
857
- },
858
- prettyProductName: {
859
- type: 'string',
860
- description: 'Pretty name of the product',
861
- example: 'Research team'
862
- },
863
- prettyPlanName: {
864
- type: 'string',
865
- description: 'Pretty name of the plan',
866
- example: 'Plan A'
867
- },
868
- prettyPhaseName: {
869
- type: 'string',
870
- description: 'Pretty name of the phase',
871
- example: 'Phase A'
872
- },
873
- prettyUsageName: {
874
- type: 'string',
875
- description: 'Pretty name of the usage',
876
- example: 'Usage A'
877
- },
878
- itemType: {
879
- type: 'string',
880
- description: 'Type of the invoice item',
881
- example: 'EXTERNAL_CHARGE',
882
- enum: ['EXTERNAL_CHARGE', 'FIXED', 'RECURRING', 'REPAIR_ADJ', 'CBA_ADJ', 'CREDIT_ADJ', 'ITEM_ADJ', 'USAGE', 'TAX', 'PARENT_SUMMARY']
883
- },
884
- description: {
885
- type: 'string',
886
- description: 'Description of the invoice item',
887
- example: 'Description of the invoice item'
888
- },
889
- startDate: {
890
- type: 'string',
891
- description: 'Start date of the invoice item',
892
- example: '2019-01-01T00:00:00.000Z'
893
- },
894
- endDate: {
895
- type: 'string',
896
- description: 'End date of the invoice item',
897
- example: '2019-01-01T00:00:00.000Z'
898
- },
899
- amount: {
900
- type: 'number',
901
- format: 'float',
902
- description: 'Amount of the invoice item',
903
- example: 100
904
- },
905
- rate: {
906
- type: 'number',
907
- format: 'float',
908
- description: 'Rate of the invoice item',
909
- example: 100
910
- },
911
- currency: {
912
- type: 'string',
913
- description: 'Currency of the invoice item',
914
- example: 'USD',
915
- enum: ['AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BRL', 'BSD', 'BTN', 'BWP', 'BYR', 'BZD', 'CAD', 'CDF', 'CHF', 'CLP', 'CNY', 'COP', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GGP', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'IMP', 'INR', 'IQD', 'IRR', 'ISK', 'JEP', 'JMD', 'JOD', 'JPY', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KRW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LTL', 'LVL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRO', 'MUR', 'MVR', 'MWK', 'MXN', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLL', 'SOS', 'SPL', 'SRD', 'STD', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TVD', 'TWD', 'TZS', 'UAH', 'UGX', 'USD', 'UYU', 'UZS', 'VEF', 'VND', 'VUV', 'WST', 'XAF', 'XCD', 'XDR', 'XOF', 'XPF', 'YER', 'ZAR', 'ZMW', 'ZWD', 'BTC']
916
- },
917
- quantity: {
918
- type: 'number',
919
- format: 'float',
920
- description: 'Quantity of the invoice item',
921
- example: 1
922
- },
923
- itemDetails: {
924
- type: 'string',
925
- description: 'Details of the invoice item',
926
- example: 'Details of the invoice item'
927
- },
928
- catalogEffectiveDate: {
929
- type: 'string',
930
- description: 'Effective date of the catalog',
931
- example: '2019-01-01T00:00:00.000Z'
932
- },
933
- childItems: {
934
- type: 'array',
935
- items: {
936
- oneOf: [
937
- {
938
- type: 'array'
939
- },
940
- {
941
- type: 'boolean'
942
- },
943
- {
944
- type: 'number'
945
- },
946
- {
947
- type: 'object',
948
- additionalProperties: true
949
- },
950
- {
951
- type: 'string'
952
- }
953
- ]
954
- },
955
- description: 'Child items of the invoice item'
956
- }
957
- },
958
- additionalProperties: false
959
- },
960
- description: 'Credits of the invoice'
2254
+ format: 'date-time',
2255
+ description: 'Billing period end timestamp. ISO 8601 date string in the UTC timezone.',
2256
+ example: '2023-12-20T13:53:32.000Z'
961
2257
  },
962
- items: {
963
- type: 'array',
964
- items: {
965
- type: 'object',
966
- properties: {
967
- id: {
968
- type: 'string',
969
- format: 'uuid',
970
- description: 'Unique identifier of the invoice item. UUID v4 string in canonical form',
971
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
972
- },
973
- linkedInvoiceItemId: {
974
- type: 'string',
975
- format: 'uuid',
976
- description: 'Unique identifier of the linked invoice item. UUID v4 string in canonical form',
977
- example: '415026b6-f00f-44f8-968d-fc6ef4d0fc6d'
978
- },
979
- productName: {
980
- type: 'string',
981
- description: 'Name of the product',
982
- example: 'Research team'
983
- },
984
- planName: {
985
- type: 'string',
986
- description: 'Name of the plan',
987
- example: 'Plan A'
988
- },
989
- phaseName: {
990
- type: 'string',
991
- description: 'Name of the phase',
992
- example: 'Phase A'
993
- },
994
- usageName: {
995
- type: 'string',
996
- description: 'Name of the usage',
997
- example: 'Usage A'
998
- },
999
- prettyProductName: {
1000
- type: 'string',
1001
- description: 'Pretty name of the product',
1002
- example: 'Research team'
1003
- },
1004
- prettyPlanName: {
1005
- type: 'string',
1006
- description: 'Pretty name of the plan',
1007
- example: 'Plan A'
1008
- },
1009
- prettyPhaseName: {
1010
- type: 'string',
1011
- description: 'Pretty name of the phase',
1012
- example: 'Phase A'
1013
- },
1014
- prettyUsageName: {
1015
- type: 'string',
1016
- description: 'Pretty name of the usage',
1017
- example: 'Usage A'
1018
- },
1019
- itemType: {
1020
- type: 'string',
1021
- description: 'Type of the invoice item',
1022
- example: 'EXTERNAL_CHARGE',
1023
- enum: ['EXTERNAL_CHARGE', 'FIXED', 'RECURRING', 'REPAIR_ADJ', 'CBA_ADJ', 'CREDIT_ADJ', 'ITEM_ADJ', 'USAGE', 'TAX', 'PARENT_SUMMARY']
1024
- },
1025
- description: {
1026
- type: 'string',
1027
- description: 'Description of the invoice item',
1028
- example: 'Description of the invoice item'
1029
- },
1030
- startDate: {
1031
- type: 'string',
1032
- description: 'Start date of the invoice item',
1033
- example: '2019-01-01T00:00:00.000Z'
1034
- },
1035
- endDate: {
1036
- type: 'string',
1037
- description: 'End date of the invoice item',
1038
- example: '2019-01-01T00:00:00.000Z'
1039
- },
1040
- amount: {
1041
- type: 'number',
1042
- format: 'float',
1043
- description: 'Amount of the invoice item',
1044
- example: 100
1045
- },
1046
- rate: {
1047
- type: 'number',
1048
- format: 'float',
1049
- description: 'Rate of the invoice item',
1050
- example: 100
1051
- },
1052
- currency: {
1053
- type: 'string',
1054
- description: 'Currency of the invoice item',
1055
- example: 'USD',
1056
- enum: ['AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN', 'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BRL', 'BSD', 'BTN', 'BWP', 'BYR', 'BZD', 'CAD', 'CDF', 'CHF', 'CLP', 'CNY', 'COP', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD', 'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GGP', 'GHS', 'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF', 'IDR', 'ILS', 'IMP', 'INR', 'IQD', 'IRR', 'ISK', 'JEP', 'JMD', 'JOD', 'JPY', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KRW', 'KWD', 'KYD', 'KZT', 'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LTL', 'LVL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD', 'MMK', 'MNT', 'MOP', 'MRO', 'MUR', 'MVR', 'MWK', 'MXN', 'MYR', 'MZN', 'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK', 'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR', 'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLL', 'SOS', 'SPL', 'SRD', 'STD', 'SVC', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD', 'TVD', 'TWD', 'TZS', 'UAH', 'UGX', 'USD', 'UYU', 'UZS', 'VEF', 'VND', 'VUV', 'WST', 'XAF', 'XCD', 'XDR', 'XOF', 'XPF', 'YER', 'ZAR', 'ZMW', 'ZWD', 'BTC']
1057
- },
1058
- quantity: {
1059
- type: 'number',
1060
- format: 'float',
1061
- description: 'Quantity of the invoice item',
1062
- example: 1
1063
- },
1064
- itemDetails: {
1065
- type: 'string',
1066
- description: 'Details of the invoice item',
1067
- example: 'Details of the invoice item'
1068
- },
1069
- catalogEffectiveDate: {
1070
- type: 'string',
1071
- description: 'Effective date of the catalog',
1072
- example: '2019-01-01T00:00:00.000Z'
1073
- },
1074
- childItems: {
1075
- type: 'array',
1076
- items: {
1077
- oneOf: [
1078
- {
1079
- type: 'array'
1080
- },
1081
- {
1082
- type: 'boolean'
1083
- },
1084
- {
1085
- type: 'number'
1086
- },
1087
- {
1088
- type: 'object',
1089
- additionalProperties: true
1090
- },
1091
- {
1092
- type: 'string'
1093
- }
1094
- ]
1095
- },
1096
- description: 'Child items of the invoice item'
1097
- }
1098
- },
1099
- additionalProperties: false
1100
- },
1101
- description: 'Items of the invoice'
2258
+ invoice_pdf: {
2259
+ type: 'string'
1102
2260
  }
1103
2261
  },
2262
+ required: [
2263
+ 'created',
2264
+ 'period_start',
2265
+ 'period_end'
2266
+ ],
1104
2267
  additionalProperties: false
1105
2268
  };
1106
- export const MarketplaceListingSchema = {
2269
+ export const MarketplaceListingFilesSchema = {
1107
2270
  type: 'object',
1108
2271
  properties: {
1109
- id: {
1110
- type: 'string',
1111
- maxLength: 63,
1112
- minLength: 1,
1113
- pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$',
1114
- description: 'Id of the chart listing',
1115
- example: 'portworx-enterprise-disaster-recovery-baremetal'
1116
- },
1117
- name: {
1118
- type: 'string',
1119
- description: 'Name of the chart listing',
1120
- example: 'Portworx Enterprise + Disaster Recovery - Baremetal'
1121
- },
1122
- developer: {
2272
+ chartYaml: {
1123
2273
  type: 'string',
1124
- description: 'Author of the chart listing',
1125
- example: 'Portworx'
2274
+ description: 'Raw Chart.yaml content from the Helm chart',
2275
+ example: 'apiVersion: v2\nname: nginx-ingress\nversion: 1.18.2-cfke.45\nappVersion: 1.9.4'
1126
2276
  },
1127
- description: {
2277
+ valuesYaml: {
1128
2278
  type: 'string',
1129
- description: 'Short description of the chart listing',
1130
- example: 'Run Kubernetes with unmatched scalability, availability, and self-service access to any storage'
2279
+ description: 'Raw values.yaml content from the Helm chart',
2280
+ example: 'replicaCount: 1\nimage:\n repository: nginx\n tag: latest'
1131
2281
  },
1132
- logoUrl: {
2282
+ valuesSchemaJson: {
1133
2283
  type: 'string',
1134
- description: 'Logo of the chart listing',
1135
- example: 'https://portworx.com/wp-content/themes/portworx/assets/images/header/portworx-logo.png'
1136
- },
1137
- longDescription: {
2284
+ description: 'JSON schema for values.yaml as a string',
2285
+ example: '{"type":"object","properties":{"replicaCount":{"type":"number"}}}'
2286
+ }
2287
+ },
2288
+ additionalProperties: false
2289
+ };
2290
+ export const MarketplaceListingSchema = {
2291
+ type: 'object',
2292
+ properties: {
2293
+ name: {
1138
2294
  type: 'string',
1139
- description: 'Long description of the chart listing',
1140
- example: 'Portworx-Enterprise is the complete multi-cloud ready Kubernetes storage platform for running mission-critical apps in production....'
2295
+ description: 'Name of the chart',
2296
+ example: 'nginx-ingress'
1141
2297
  },
1142
- categories: {
2298
+ versions: {
1143
2299
  type: 'array',
1144
2300
  items: {
1145
2301
  type: 'string',
1146
- example: 'AI & Machine Learning'
2302
+ pattern: '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
2303
+ description: 'Specific version of the chart',
2304
+ example: '1.18.2-cfke.45'
1147
2305
  },
1148
- description: 'Tags of the chart'
2306
+ description: 'Available versions of the chart'
1149
2307
  },
1150
2308
  version_channels: {
1151
2309
  type: 'array',
1152
2310
  items: {
1153
2311
  type: 'string',
1154
2312
  pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
1155
- description: 'Version of the chart.',
1156
- example: '2.x.x-cfke.x'
1157
- }
2313
+ description: 'Version channel pattern',
2314
+ example: '1.18.x-cfke.x'
2315
+ },
2316
+ description: 'Version channels for the chart'
1158
2317
  },
1159
- value_schemas: {
1160
- type: 'array',
1161
- items: {
1162
- type: 'object',
1163
- properties: {
1164
- version: {
1165
- type: 'string',
1166
- pattern: '^(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)\\.(x|X|0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$',
1167
- description: 'Version of the chart.',
1168
- example: '2.1.1-cfke.123'
1169
- },
1170
- schema: {
1171
- type: 'string',
1172
- description: 'Schema of the chart values. JSON Schema as string'
1173
- },
1174
- placeholder: {
1175
- type: 'string',
1176
- description: 'Schema of the chart values',
1177
- example: `foo: 1
1178
- bar: example`
1179
- }
1180
- },
1181
- required: ['version', 'schema', 'placeholder'],
1182
- additionalProperties: false
1183
- }
1184
- }
1185
- },
1186
- required: ['id', 'name', 'developer', 'description', 'logoUrl', 'longDescription', 'categories', 'version_channels', 'value_schemas'],
1187
- additionalProperties: false
1188
- };
1189
- export const OrganizationCreateInputSchema = {
1190
- type: 'object',
1191
- properties: {
1192
- email: {
2318
+ latestVersion: {
1193
2319
  type: 'string',
1194
- format: 'email',
2320
+ description: 'Latest version of the chart',
2321
+ example: '1.18.2-cfke.45'
2322
+ },
2323
+ metadata: {
2324
+ type: 'object',
2325
+ properties: {
2326
+ name: {
2327
+ type: 'string',
2328
+ description: 'Chart name from metadata',
2329
+ example: 'nginx-ingress'
2330
+ },
2331
+ version: {
2332
+ type: 'string',
2333
+ description: 'Chart version from metadata',
2334
+ example: '1.18.2-cfke.45'
2335
+ },
2336
+ description: {
2337
+ type: 'string',
2338
+ description: 'Chart description',
2339
+ example: 'NGINX Ingress Controller for Kubernetes'
2340
+ },
2341
+ appVersion: {
2342
+ type: 'string',
2343
+ description: 'Application version',
2344
+ example: '1.9.4'
2345
+ },
2346
+ apiVersion: {
2347
+ type: 'string',
2348
+ description: 'Helm API version',
2349
+ example: 'v2'
2350
+ },
2351
+ keywords: {
2352
+ type: 'array',
2353
+ items: {
2354
+ type: 'string'
2355
+ },
2356
+ description: 'Chart keywords',
2357
+ example: [
2358
+ 'ingress',
2359
+ 'nginx',
2360
+ 'load-balancer'
2361
+ ]
2362
+ },
2363
+ home: {
2364
+ type: 'string',
2365
+ description: 'Chart home URL',
2366
+ example: 'https://kubernetes.github.io/ingress-nginx/'
2367
+ },
2368
+ icon: {
2369
+ type: 'string',
2370
+ description: 'A URL to an SVG or PNG image to be used as an icon',
2371
+ example: 'https://cloudfleet.ai/images/marketplace/icons/ingress-nginx.png'
2372
+ },
2373
+ sources: {
2374
+ type: 'array',
2375
+ items: {
2376
+ type: 'string'
2377
+ },
2378
+ description: 'Chart source URLs',
2379
+ example: [
2380
+ 'https://github.com/kubernetes/ingress-nginx'
2381
+ ]
2382
+ },
2383
+ maintainers: {
2384
+ type: 'array',
2385
+ items: {
2386
+ type: 'object',
2387
+ properties: {
2388
+ name: {
2389
+ type: 'string',
2390
+ description: 'Maintainer name',
2391
+ example: 'NGINX Team'
2392
+ },
2393
+ email: {
2394
+ type: 'string',
2395
+ description: 'Maintainer email',
2396
+ example: 'support@nginx.org'
2397
+ }
2398
+ },
2399
+ required: [
2400
+ 'name'
2401
+ ],
2402
+ additionalProperties: false
2403
+ },
2404
+ description: 'Chart maintainers'
2405
+ }
2406
+ },
2407
+ required: [
2408
+ 'name',
2409
+ 'version'
2410
+ ],
2411
+ additionalProperties: false,
2412
+ description: 'Chart metadata'
2413
+ }
2414
+ },
2415
+ required: [
2416
+ 'name',
2417
+ 'versions',
2418
+ 'version_channels',
2419
+ 'latestVersion'
2420
+ ],
2421
+ additionalProperties: false
2422
+ };
2423
+ export const OrganizationCreateInputSchema = {
2424
+ type: 'object',
2425
+ properties: {
2426
+ type: {
2427
+ type: 'string',
2428
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2429
+ example: 'business',
2430
+ enum: [
2431
+ 'business',
2432
+ 'personal'
2433
+ ]
2434
+ },
2435
+ email: {
2436
+ type: 'string',
2437
+ format: 'email',
1195
2438
  description: 'Email address used for billing as a string.',
1196
2439
  example: 'email@example.com'
1197
2440
  },
1198
2441
  first_name: {
1199
2442
  type: 'string',
2443
+ minLength: 1,
1200
2444
  description: 'First name of the billing contact person.',
1201
2445
  example: 'John'
1202
2446
  },
1203
2447
  last_name: {
1204
2448
  type: 'string',
2449
+ minLength: 1,
1205
2450
  description: 'Last name of the billing contact person.',
1206
2451
  example: 'Doe'
1207
2452
  },
@@ -1219,7 +2464,28 @@ export const OrganizationCreateInputSchema = {
1219
2464
  description: 'Password for the root account. Must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one number and one special character.'
1220
2465
  }
1221
2466
  },
1222
- required: ['email', 'first_name', 'last_name', 'company_name', 'password'],
2467
+ required: [
2468
+ 'type',
2469
+ 'email',
2470
+ 'first_name',
2471
+ 'last_name',
2472
+ 'company_name',
2473
+ 'password'
2474
+ ],
2475
+ additionalProperties: false
2476
+ };
2477
+ export const OrganizationCreateOutputSchema = {
2478
+ type: 'object',
2479
+ properties: {
2480
+ id: {
2481
+ type: 'string',
2482
+ description: 'Unique identifier of the newly created organization. Generated by the API and safe to use for client-side tracking immediately.',
2483
+ example: 'organization-id'
2484
+ }
2485
+ },
2486
+ required: [
2487
+ 'id'
2488
+ ],
1223
2489
  additionalProperties: false
1224
2490
  };
1225
2491
  export const OrganizationSchema = {
@@ -1238,6 +2504,15 @@ export const OrganizationSchema = {
1238
2504
  description: 'Name of the legal entity. This name will be used in invoices. Use your first and last name for individual accounts.',
1239
2505
  example: 'ACME Corp.'
1240
2506
  },
2507
+ type: {
2508
+ type: 'string',
2509
+ description: 'Type of the organization. `business` for legal entities, `personal` for individuals.',
2510
+ example: 'business',
2511
+ enum: [
2512
+ 'business',
2513
+ 'personal'
2514
+ ]
2515
+ },
1241
2516
  date_created: {
1242
2517
  type: 'string',
1243
2518
  format: 'date-time',
@@ -1279,107 +2554,1021 @@ export const OrganizationSchema = {
1279
2554
  type: 'array',
1280
2555
  items: {
1281
2556
  type: 'string',
1282
- example: 'basic'
2557
+ example: 'basic'
2558
+ },
2559
+ minItems: 0,
2560
+ description: 'List of Cloudfleet cluster tiers available for the organization.'
2561
+ },
2562
+ regions: {
2563
+ type: 'array',
2564
+ items: {
2565
+ type: 'string',
2566
+ example: 'northamerica-central-1a'
2567
+ },
2568
+ minItems: 1,
2569
+ description: 'List of Cloudfleet control plane regions available for the organization.'
2570
+ },
2571
+ versions: {
2572
+ type: 'array',
2573
+ items: {
2574
+ type: 'object',
2575
+ properties: {
2576
+ id: {
2577
+ type: 'string',
2578
+ description: 'Id of the control plane version. Used in API calls.',
2579
+ example: '1.33.x-cfke.x'
2580
+ },
2581
+ label: {
2582
+ type: 'string',
2583
+ description: 'Label of the control plane version. Used in frontent UI.',
2584
+ example: '1.33.x (Always latest 1.33 patch version)'
2585
+ }
2586
+ },
2587
+ required: [
2588
+ 'id',
2589
+ 'label'
2590
+ ],
2591
+ additionalProperties: false
2592
+ },
2593
+ minItems: 1,
2594
+ description: 'List of CFKE control plane versions available for the organization.'
2595
+ },
2596
+ cfcr_storage_gb: {
2597
+ type: 'integer',
2598
+ minimum: -1,
2599
+ description: 'Organization-level maximum CFCR storage volume in GB. -1 means no limit.',
2600
+ example: 500
2601
+ }
2602
+ },
2603
+ required: [
2604
+ 'basic_clusters_max',
2605
+ 'basic_clusters_available',
2606
+ 'pro_clusters_max',
2607
+ 'pro_clusters_available',
2608
+ 'fleets_max',
2609
+ 'cluster_tiers',
2610
+ 'regions',
2611
+ 'versions',
2612
+ 'cfcr_storage_gb'
2613
+ ],
2614
+ additionalProperties: false,
2615
+ description: 'For security reasons, platform quota is controlled by Cloudfleet and can be updated only by Cloudfleet administrators. Please open a support ticket if you need to change the platform quota.'
2616
+ },
2617
+ status: {
2618
+ type: 'string',
2619
+ description: 'Status of the organization. Can be `active` or `closed`, or `suspended`.',
2620
+ enum: [
2621
+ 'active',
2622
+ 'closed',
2623
+ 'suspended'
2624
+ ]
2625
+ },
2626
+ verification: {
2627
+ type: 'string',
2628
+ description: 'Verification status of the organization, which determines the assigned quota. `none` when billing information is incomplete, `submitted` when billing information is complete but the organization is not yet verified, `verified` when the organization is verified.',
2629
+ example: 'verified',
2630
+ enum: [
2631
+ 'none',
2632
+ 'submitted',
2633
+ 'verified'
2634
+ ]
2635
+ }
2636
+ },
2637
+ required: [
2638
+ 'id',
2639
+ 'type',
2640
+ 'date_created',
2641
+ 'quota',
2642
+ 'status',
2643
+ 'verification'
2644
+ ],
2645
+ additionalProperties: false
2646
+ };
2647
+ export const PaymentMethodSchema = {
2648
+ type: 'object',
2649
+ properties: {
2650
+ id: {
2651
+ type: 'string',
2652
+ description: 'Payment method identifier. Stripe payment method id for cards/SEPA; the constant `bank_transfer` for the invoice/bank-transfer method. Used to set as default or delete the payment method.',
2653
+ example: 'pm_1MtwBwLkdIwHu7ix28a3tqPa'
2654
+ },
2655
+ type: {
2656
+ type: 'string',
2657
+ description: 'Payment method type. `card`, `sepa_debit` for SEPA Direct Debit (business accounts only), or `bank_transfer` for paying invoices by bank transfer.',
2658
+ example: 'card',
2659
+ enum: [
2660
+ 'card',
2661
+ 'sepa_debit',
2662
+ 'bank_transfer'
2663
+ ]
2664
+ },
2665
+ last4: {
2666
+ type: 'string',
2667
+ nullable: true,
2668
+ description: 'Last 4 digits of the payment card number, of the bank account (IBAN) for SEPA Direct Debit, or of the destination IBAN for bank transfer.',
2669
+ example: '4242'
2670
+ },
2671
+ exp_month: {
2672
+ type: 'integer',
2673
+ minimum: 1,
2674
+ maximum: 12,
2675
+ nullable: true,
2676
+ description: 'Two-digit number representing the card\'s expiration month. Null for SEPA Direct Debit and bank transfer.',
2677
+ example: 12
2678
+ },
2679
+ exp_year: {
2680
+ type: 'integer',
2681
+ nullable: true,
2682
+ description: 'Four-digit number representing the card\'s expiration year. May be in the past for an expired card still on file. Null for SEPA Direct Debit and bank transfer.',
2683
+ example: 2028
2684
+ },
2685
+ brand: {
2686
+ type: 'string',
2687
+ nullable: true,
2688
+ description: 'Payment card brand as reported by Stripe, e.g. `visa`, `mastercard`, `amex`, `cartes_bancaires`, or `unknown`. Null for SEPA Direct Debit and bank transfer.',
2689
+ example: 'visa'
2690
+ },
2691
+ iban: {
2692
+ type: 'string',
2693
+ nullable: true,
2694
+ description: 'Full destination IBAN to send bank transfers to. Set only for `bank_transfer`; null otherwise. This is Cloudfleet\'s virtual receiving account, shown in full so the customer can pay into it.',
2695
+ example: 'DE11243015658023127510'
2696
+ },
2697
+ bic: {
2698
+ type: 'string',
2699
+ nullable: true,
2700
+ description: 'BIC/SWIFT of the destination bank for bank transfers. Set only for `bank_transfer`; null otherwise.',
2701
+ example: 'SOGEDEFFXXX'
2702
+ },
2703
+ account_holder_name: {
2704
+ type: 'string',
2705
+ nullable: true,
2706
+ description: 'Account holder name of the destination bank account for bank transfers. Set only for `bank_transfer`; null otherwise.',
2707
+ example: 'Cloudfleet GmbH'
2708
+ },
2709
+ is_default: {
2710
+ type: 'boolean',
2711
+ description: 'Whether this payment method is the default used for invoices and active subscriptions. Always false for `bank_transfer` (it cannot be a Stripe default payment method).',
2712
+ example: true
2713
+ }
2714
+ },
2715
+ required: [
2716
+ 'id',
2717
+ 'type',
2718
+ 'last4',
2719
+ 'exp_month',
2720
+ 'exp_year',
2721
+ 'brand',
2722
+ 'iban',
2723
+ 'bic',
2724
+ 'account_holder_name',
2725
+ 'is_default'
2726
+ ],
2727
+ additionalProperties: false
2728
+ };
2729
+ export const PlatformQuotaSchema = {
2730
+ type: 'object',
2731
+ properties: {
2732
+ basic_clusters_max: {
2733
+ type: 'integer',
2734
+ minimum: 0,
2735
+ description: 'Maximum number of Basic clusters that can be created.',
2736
+ example: 999
2737
+ },
2738
+ basic_clusters_available: {
2739
+ type: 'integer',
2740
+ description: 'Available number of Basic clusters that can be created.',
2741
+ example: 999
2742
+ },
2743
+ pro_clusters_max: {
2744
+ type: 'integer',
2745
+ minimum: 0,
2746
+ description: 'Maximum number of Pro clusters that can be created.',
2747
+ example: 999
2748
+ },
2749
+ pro_clusters_available: {
2750
+ type: 'integer',
2751
+ description: 'Available number of Pro clusters that can be created.',
2752
+ example: 999
2753
+ },
2754
+ fleets_max: {
2755
+ type: 'integer',
2756
+ minimum: 0,
2757
+ description: 'Maximum number of fleets that can be created per cluster.',
2758
+ example: 999
2759
+ },
2760
+ cluster_tiers: {
2761
+ type: 'array',
2762
+ items: {
2763
+ type: 'string',
2764
+ example: 'basic'
2765
+ },
2766
+ minItems: 0,
2767
+ description: 'List of Cloudfleet cluster tiers available for the organization.'
2768
+ },
2769
+ regions: {
2770
+ type: 'array',
2771
+ items: {
2772
+ type: 'string',
2773
+ example: 'northamerica-central-1a'
2774
+ },
2775
+ minItems: 1,
2776
+ description: 'List of Cloudfleet control plane regions available for the organization.'
2777
+ },
2778
+ versions: {
2779
+ type: 'array',
2780
+ items: {
2781
+ type: 'object',
2782
+ properties: {
2783
+ id: {
2784
+ type: 'string',
2785
+ description: 'Id of the control plane version. Used in API calls.',
2786
+ example: '1.33.x-cfke.x'
2787
+ },
2788
+ label: {
2789
+ type: 'string',
2790
+ description: 'Label of the control plane version. Used in frontent UI.',
2791
+ example: '1.33.x (Always latest 1.33 patch version)'
2792
+ }
2793
+ },
2794
+ required: [
2795
+ 'id',
2796
+ 'label'
2797
+ ],
2798
+ additionalProperties: false
2799
+ },
2800
+ minItems: 1,
2801
+ description: 'List of CFKE control plane versions available for the organization.'
2802
+ },
2803
+ cfcr_storage_gb: {
2804
+ type: 'integer',
2805
+ minimum: -1,
2806
+ description: 'Organization-level maximum CFCR storage volume in GB. -1 means no limit.',
2807
+ example: 500
2808
+ }
2809
+ },
2810
+ required: [
2811
+ 'basic_clusters_max',
2812
+ 'basic_clusters_available',
2813
+ 'pro_clusters_max',
2814
+ 'pro_clusters_available',
2815
+ 'fleets_max',
2816
+ 'cluster_tiers',
2817
+ 'regions',
2818
+ 'versions',
2819
+ 'cfcr_storage_gb'
2820
+ ],
2821
+ additionalProperties: false
2822
+ };
2823
+ export const RegistryRepositorySchema = {
2824
+ type: 'object',
2825
+ properties: {
2826
+ name: {
2827
+ type: 'string',
2828
+ description: 'Repository name.',
2829
+ example: 'my-app'
2830
+ },
2831
+ region: {
2832
+ type: 'string',
2833
+ description: 'Registry region.',
2834
+ example: 'northamerica'
2835
+ },
2836
+ uri: {
2837
+ type: 'string',
2838
+ description: 'Full URI of the repository.',
2839
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app'
2840
+ }
2841
+ },
2842
+ required: [
2843
+ 'name',
2844
+ 'region',
2845
+ 'uri'
2846
+ ],
2847
+ additionalProperties: false
2848
+ };
2849
+ export const RegistryRepositoryWithTagsSchema = {
2850
+ type: 'object',
2851
+ properties: {
2852
+ name: {
2853
+ type: 'string',
2854
+ description: 'Repository name.',
2855
+ example: 'my-app'
2856
+ },
2857
+ region: {
2858
+ type: 'string',
2859
+ description: 'Registry region.',
2860
+ example: 'northamerica'
2861
+ },
2862
+ uri: {
2863
+ type: 'string',
2864
+ description: 'Full URI of the repository.',
2865
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app'
2866
+ },
2867
+ tags: {
2868
+ type: 'array',
2869
+ items: {
2870
+ type: 'object',
2871
+ properties: {
2872
+ name: {
2873
+ type: 'string',
2874
+ description: 'Tag name.',
2875
+ example: 'latest'
2876
+ },
2877
+ size: {
2878
+ type: 'number',
2879
+ format: 'float',
2880
+ description: 'Size of the tag in bytes.',
2881
+ example: 123456789
2882
+ },
2883
+ mediaType: {
2884
+ type: 'string',
2885
+ description: 'Media type of the manifest.',
2886
+ example: 'application/vnd.docker.distribution.manifest.v2+json'
2887
+ },
2888
+ platforms: {
2889
+ type: 'array',
2890
+ items: {
2891
+ type: 'string'
2892
+ },
2893
+ description: 'Array of platform strings for multi-arch images (e.g., linux/amd64, linux/arm64).',
2894
+ example: [
2895
+ 'linux/amd64',
2896
+ 'linux/arm64'
2897
+ ]
2898
+ }
2899
+ },
2900
+ required: [
2901
+ 'name',
2902
+ 'size'
2903
+ ],
2904
+ additionalProperties: false
2905
+ },
2906
+ description: 'Array of tags in the repository.'
2907
+ },
2908
+ totalSize: {
2909
+ type: 'number',
2910
+ format: 'float',
2911
+ description: 'Total size of all tags in the repository in bytes.',
2912
+ example: 987654321
2913
+ }
2914
+ },
2915
+ required: [
2916
+ 'name',
2917
+ 'region',
2918
+ 'uri',
2919
+ 'tags',
2920
+ 'totalSize'
2921
+ ],
2922
+ additionalProperties: false
2923
+ };
2924
+ export const RegistryTagSchema = {
2925
+ type: 'object',
2926
+ properties: {
2927
+ name: {
2928
+ type: 'string',
2929
+ description: 'Tag name.',
2930
+ example: 'latest'
2931
+ },
2932
+ digest: {
2933
+ type: 'string',
2934
+ description: 'Manifest digest for pulling by digest.',
2935
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
2936
+ },
2937
+ mediaType: {
2938
+ type: 'string',
2939
+ description: 'Media type of the manifest.',
2940
+ example: 'application/vnd.docker.distribution.manifest.v2+json'
2941
+ },
2942
+ config: {
2943
+ type: 'object',
2944
+ properties: {
2945
+ size: {
2946
+ type: 'number',
2947
+ format: 'float',
2948
+ description: 'Size of the config in bytes.',
2949
+ example: 1234
2950
+ }
2951
+ },
2952
+ required: [
2953
+ 'size'
2954
+ ],
2955
+ additionalProperties: false,
2956
+ description: 'Manifest config metadata.'
2957
+ },
2958
+ layers: {
2959
+ type: 'array',
2960
+ items: {
2961
+ type: 'object',
2962
+ properties: {
2963
+ digest: {
2964
+ type: 'string',
2965
+ description: 'Digest of the layer.',
2966
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
2967
+ },
2968
+ size: {
2969
+ type: 'number',
2970
+ format: 'float',
2971
+ description: 'Size of the layer in bytes.',
2972
+ example: 5678
2973
+ }
2974
+ },
2975
+ required: [
2976
+ 'size'
2977
+ ],
2978
+ additionalProperties: false
2979
+ },
2980
+ description: 'Array of layer metadata.'
2981
+ },
2982
+ manifests: {
2983
+ type: 'array',
2984
+ items: {
2985
+ type: 'object',
2986
+ properties: {
2987
+ digest: {
2988
+ type: 'string',
2989
+ description: 'Digest of the manifest.',
2990
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
2991
+ },
2992
+ platform: {
2993
+ type: 'object',
2994
+ properties: {
2995
+ architecture: {
2996
+ type: 'string',
2997
+ description: 'Architecture of the platform.',
2998
+ example: 'amd64'
2999
+ },
3000
+ os: {
3001
+ type: 'string',
3002
+ description: 'Operating system of the platform.',
3003
+ example: 'linux'
3004
+ },
3005
+ variant: {
3006
+ type: 'string',
3007
+ description: 'Variant of the platform (e.g., v7, v8 for ARM).',
3008
+ example: 'v8'
3009
+ }
3010
+ },
3011
+ required: [
3012
+ 'architecture',
3013
+ 'os'
3014
+ ],
3015
+ additionalProperties: false,
3016
+ description: 'Platform information for the manifest.'
3017
+ },
3018
+ layers: {
3019
+ type: 'array',
3020
+ items: {
3021
+ type: 'object',
3022
+ properties: {
3023
+ digest: {
3024
+ type: 'string',
3025
+ description: 'Digest of the layer.',
3026
+ example: 'sha256:abcd1234ef567890abcd1234ef567890abcd1234ef567890abcd1234ef567890'
3027
+ },
3028
+ size: {
3029
+ type: 'number',
3030
+ format: 'float',
3031
+ description: 'Size of the layer in bytes.',
3032
+ example: 5678
3033
+ }
3034
+ },
3035
+ required: [
3036
+ 'size'
3037
+ ],
3038
+ additionalProperties: false
3039
+ },
3040
+ description: 'Layers for this platform.'
3041
+ },
3042
+ size: {
3043
+ type: 'number',
3044
+ format: 'float',
3045
+ description: 'Total size of this platform manifest in bytes.',
3046
+ example: 12345678
3047
+ }
3048
+ },
3049
+ required: [
3050
+ 'digest'
3051
+ ],
3052
+ additionalProperties: false
3053
+ },
3054
+ description: 'Array of manifests for multi-arch images.'
3055
+ },
3056
+ size: {
3057
+ type: 'number',
3058
+ format: 'float',
3059
+ description: 'Total size of the tag in bytes.',
3060
+ example: 123456789
3061
+ },
3062
+ region: {
3063
+ type: 'string',
3064
+ description: 'Registry region.',
3065
+ example: 'northamerica'
3066
+ },
3067
+ repository: {
3068
+ type: 'string',
3069
+ description: 'Repository name.',
3070
+ example: 'my-app'
3071
+ },
3072
+ uri: {
3073
+ type: 'string',
3074
+ description: 'Full URI of the tag.',
3075
+ example: 'ssds123e-6651-4e5d-9c04-079f6532989b.northamerica.registry.cloudfleet.dev/my-app:latest'
3076
+ }
3077
+ },
3078
+ required: [
3079
+ 'name',
3080
+ 'digest',
3081
+ 'size',
3082
+ 'region',
3083
+ 'repository',
3084
+ 'uri'
3085
+ ],
3086
+ additionalProperties: false
3087
+ };
3088
+ export const TicketAttachmentSchema = {
3089
+ type: 'object',
3090
+ properties: {
3091
+ id: {
3092
+ type: 'string',
3093
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3094
+ example: '60c72b2f9f1b2c001f8e4d3c'
3095
+ },
3096
+ filename: {
3097
+ type: 'string',
3098
+ description: 'Original filename as uploaded.',
3099
+ example: 'debug.log'
3100
+ },
3101
+ content_type: {
3102
+ type: 'string',
3103
+ description: 'MIME content type of the attachment.',
3104
+ example: 'text/plain'
3105
+ },
3106
+ size: {
3107
+ type: 'integer',
3108
+ description: 'Size of the attachment in bytes.',
3109
+ example: 12345
3110
+ }
3111
+ },
3112
+ required: [
3113
+ 'id',
3114
+ 'filename',
3115
+ 'content_type',
3116
+ 'size'
3117
+ ],
3118
+ additionalProperties: false
3119
+ };
3120
+ export const TicketCreateInputSchema = {
3121
+ type: 'object',
3122
+ properties: {
3123
+ category: {
3124
+ type: 'string',
3125
+ description: 'Ticket category. Drives auto-assignment and may carry a subcategory in `properties`.',
3126
+ example: 'technical',
3127
+ enum: [
3128
+ 'billing',
3129
+ 'technical',
3130
+ 'general'
3131
+ ]
3132
+ },
3133
+ body: {
3134
+ type: 'string',
3135
+ maxLength: 50000,
3136
+ minLength: 1,
3137
+ pattern: '\\S',
3138
+ description: 'Initial message body in markdown. There is no separate subject — the first message body is the description.',
3139
+ example: 'My cluster cannot reach the registry. Logs attached.'
3140
+ },
3141
+ properties: {
3142
+ type: 'object',
3143
+ additionalProperties: true,
3144
+ description: 'Free-form key/value bag set by the UI (e.g. `subcategory`, `cluster_id`, `cluster_name`, `region`).',
3145
+ example: {
3146
+ subcategory: 'cluster-question',
3147
+ cluster_id: '60c72b2f9f1b2c001f8e4d3a'
3148
+ }
3149
+ }
3150
+ },
3151
+ required: [
3152
+ 'category',
3153
+ 'body'
3154
+ ],
3155
+ additionalProperties: false
3156
+ };
3157
+ export const TicketListResponseSchema = {
3158
+ type: 'object',
3159
+ properties: {
3160
+ items: {
3161
+ type: 'array',
3162
+ items: {
3163
+ type: 'object',
3164
+ properties: {
3165
+ id: {
3166
+ type: 'string',
3167
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3168
+ example: '60c72b2f9f1b2c001f8e4d3a'
3169
+ },
3170
+ status: {
3171
+ type: 'string',
3172
+ description: 'Current state of the ticket.',
3173
+ example: 'waiting_on_us',
3174
+ enum: [
3175
+ 'waiting_on_us',
3176
+ 'waiting_on_user',
3177
+ 'closed'
3178
+ ]
3179
+ },
3180
+ category: {
3181
+ type: 'string',
3182
+ description: 'Ticket category.',
3183
+ example: 'technical',
3184
+ enum: [
3185
+ 'billing',
3186
+ 'technical',
3187
+ 'general'
3188
+ ]
3189
+ },
3190
+ summary: {
3191
+ type: 'string',
3192
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3193
+ example: 'My cluster cannot reach the registry. Logs attached.'
3194
+ },
3195
+ closed_at: {
3196
+ type: 'string',
3197
+ format: 'date-time',
3198
+ nullable: true,
3199
+ description: 'Closure timestamp. Null while the ticket is open.',
3200
+ example: '2026-05-18T16:08:14.338Z'
3201
+ },
3202
+ date_created: {
3203
+ type: 'string',
3204
+ format: 'date-time',
3205
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3206
+ example: '2026-05-11T16:08:14.338Z'
3207
+ },
3208
+ date_updated: {
3209
+ type: 'string',
3210
+ format: 'date-time',
3211
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3212
+ example: '2026-05-11T16:08:14.338Z'
3213
+ },
3214
+ messages: {
3215
+ type: 'array',
3216
+ items: {
3217
+ type: 'object',
3218
+ properties: {
3219
+ id: {
3220
+ type: 'string',
3221
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3222
+ example: '60c72b2f9f1b2c001f8e4d3b'
3223
+ },
3224
+ type: {
3225
+ type: 'string',
3226
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3227
+ example: 'customer_reply',
3228
+ enum: [
3229
+ 'customer_reply',
3230
+ 'agent_reply'
3231
+ ]
3232
+ },
3233
+ body: {
3234
+ type: 'string',
3235
+ description: 'Message body in markdown.',
3236
+ example: 'Thanks — that resolved it on my side.'
3237
+ },
3238
+ author_first_name: {
3239
+ type: 'string',
3240
+ nullable: true,
3241
+ description: 'First name of the author. Null when not provided.',
3242
+ example: 'Jane'
3243
+ },
3244
+ author_last_name: {
3245
+ type: 'string',
3246
+ nullable: true,
3247
+ description: 'Last name of the author. Null when not provided.',
3248
+ example: 'Doe'
3249
+ },
3250
+ attachments: {
3251
+ type: 'array',
3252
+ items: {
3253
+ type: 'object',
3254
+ properties: {
3255
+ id: {
3256
+ type: 'string',
3257
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3258
+ example: '60c72b2f9f1b2c001f8e4d3c'
3259
+ },
3260
+ filename: {
3261
+ type: 'string',
3262
+ description: 'Original filename as uploaded.',
3263
+ example: 'debug.log'
3264
+ },
3265
+ content_type: {
3266
+ type: 'string',
3267
+ description: 'MIME content type of the attachment.',
3268
+ example: 'text/plain'
3269
+ },
3270
+ size: {
3271
+ type: 'integer',
3272
+ description: 'Size of the attachment in bytes.',
3273
+ example: 12345
3274
+ }
3275
+ },
3276
+ required: [
3277
+ 'id',
3278
+ 'filename',
3279
+ 'content_type',
3280
+ 'size'
3281
+ ],
3282
+ additionalProperties: false
3283
+ },
3284
+ description: 'Attachments associated with this message.',
3285
+ example: []
3286
+ },
3287
+ date_created: {
3288
+ type: 'string',
3289
+ format: 'date-time',
3290
+ description: 'Creation date of the message. ISO 8601 UTC.',
3291
+ example: '2026-05-11T16:08:14.338Z'
3292
+ }
3293
+ },
3294
+ required: [
3295
+ 'id',
3296
+ 'type',
3297
+ 'body',
3298
+ 'date_created'
3299
+ ],
3300
+ additionalProperties: false
3301
+ },
3302
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
3303
+ }
3304
+ },
3305
+ required: [
3306
+ 'id',
3307
+ 'status',
3308
+ 'category',
3309
+ 'summary',
3310
+ 'date_created',
3311
+ 'date_updated'
3312
+ ],
3313
+ additionalProperties: false
3314
+ },
3315
+ description: 'Tickets for the organization, ordered newest first. Messages are omitted from list responses.'
3316
+ }
3317
+ },
3318
+ required: [
3319
+ 'items'
3320
+ ],
3321
+ additionalProperties: false
3322
+ };
3323
+ export const TicketMessageInputSchema = {
3324
+ type: 'object',
3325
+ properties: {
3326
+ body: {
3327
+ type: 'string',
3328
+ maxLength: 50000,
3329
+ minLength: 1,
3330
+ pattern: '\\S',
3331
+ description: 'Reply body in markdown.',
3332
+ example: 'Thanks — that resolved it on my side.'
3333
+ }
3334
+ },
3335
+ required: [
3336
+ 'body'
3337
+ ],
3338
+ additionalProperties: false
3339
+ };
3340
+ export const TicketMessageSchema = {
3341
+ type: 'object',
3342
+ properties: {
3343
+ id: {
3344
+ type: 'string',
3345
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3346
+ example: '60c72b2f9f1b2c001f8e4d3b'
3347
+ },
3348
+ type: {
3349
+ type: 'string',
3350
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3351
+ example: 'customer_reply',
3352
+ enum: [
3353
+ 'customer_reply',
3354
+ 'agent_reply'
3355
+ ]
3356
+ },
3357
+ body: {
3358
+ type: 'string',
3359
+ description: 'Message body in markdown.',
3360
+ example: 'Thanks — that resolved it on my side.'
3361
+ },
3362
+ author_first_name: {
3363
+ type: 'string',
3364
+ description: 'First name of the author. Null when not provided.',
3365
+ example: 'Jane'
3366
+ },
3367
+ author_last_name: {
3368
+ type: 'string',
3369
+ description: 'Last name of the author. Null when not provided.',
3370
+ example: 'Doe'
3371
+ },
3372
+ attachments: {
3373
+ type: 'array',
3374
+ items: {
3375
+ type: 'object',
3376
+ properties: {
3377
+ id: {
3378
+ type: 'string',
3379
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3380
+ example: '60c72b2f9f1b2c001f8e4d3c'
1283
3381
  },
1284
- minItems: 0,
1285
- description: 'List of Cloudfleet cluster tiers available for the organization.'
1286
- },
1287
- regions: {
1288
- type: 'array',
1289
- items: {
3382
+ filename: {
1290
3383
  type: 'string',
1291
- example: 'northamerica-central-1'
3384
+ description: 'Original filename as uploaded.',
3385
+ example: 'debug.log'
1292
3386
  },
1293
- minItems: 1,
1294
- description: 'List of Cloudfleet control plane regions available for the organization.'
1295
- },
1296
- versions: {
1297
- type: 'array',
1298
- items: {
1299
- type: 'object',
1300
- properties: {
1301
- id: {
1302
- type: 'string',
1303
- description: 'Id of the control plane version. Used in API calls.',
1304
- example: '1.29.x-cfke.x'
1305
- },
1306
- label: {
1307
- type: 'string',
1308
- description: 'Label of the control plane version. Used in frontent UI.',
1309
- example: '1.29.x (Always latest 1.29 patch version)'
1310
- }
1311
- },
1312
- required: ['id', 'label'],
1313
- additionalProperties: false
3387
+ content_type: {
3388
+ type: 'string',
3389
+ description: 'MIME content type of the attachment.',
3390
+ example: 'text/plain'
1314
3391
  },
1315
- minItems: 1,
1316
- description: 'List of CFKE control plane versions available for the organization.'
1317
- }
3392
+ size: {
3393
+ type: 'integer',
3394
+ description: 'Size of the attachment in bytes.',
3395
+ example: 12345
3396
+ }
3397
+ },
3398
+ required: [
3399
+ 'id',
3400
+ 'filename',
3401
+ 'content_type',
3402
+ 'size'
3403
+ ],
3404
+ additionalProperties: false
1318
3405
  },
1319
- required: ['basic_clusters_max', 'basic_clusters_available', 'pro_clusters_max', 'pro_clusters_available', 'fleets_max', 'cluster_tiers', 'regions', 'versions'],
1320
- additionalProperties: false,
1321
- description: 'For security reasons, platform quota is controlled by Cloudfleet and can be updated only by Cloudfleet administrators. Please open a support ticket if you need to change the platform quota.'
3406
+ description: 'Attachments associated with this message.',
3407
+ example: []
1322
3408
  },
1323
- status: {
3409
+ date_created: {
1324
3410
  type: 'string',
1325
- description: 'Status of the organization. Can be `active` or `closed`, or `suspended`.',
1326
- enum: ['active', 'closed', 'suspended']
3411
+ format: 'date-time',
3412
+ description: 'Creation date of the message. ISO 8601 UTC.',
3413
+ example: '2026-05-11T16:08:14.338Z'
1327
3414
  }
1328
3415
  },
1329
- required: ['id', 'date_created', 'quota', 'status'],
3416
+ required: [
3417
+ 'id',
3418
+ 'type',
3419
+ 'body',
3420
+ 'date_created'
3421
+ ],
1330
3422
  additionalProperties: false
1331
3423
  };
1332
- export const PaymentMethodSchema = {
3424
+ export const TicketSchema = {
1333
3425
  type: 'object',
1334
3426
  properties: {
1335
3427
  id: {
1336
3428
  type: 'string',
1337
- format: 'uuid',
1338
- description: 'Unique identifier of the organization. UUID v4 string in canonical form.',
1339
- example: 'e94d30ec-a2dd-4dcb-832c-ac2be144ba91'
3429
+ description: 'Unique identifier of the ticket (Mongo ObjectId).',
3430
+ example: '60c72b2f9f1b2c001f8e4d3a'
1340
3431
  },
1341
- setup: {
1342
- type: 'boolean',
1343
- description: 'Whether organization payment method was set up and ready to use for payments.',
1344
- example: true
3432
+ status: {
3433
+ type: 'string',
3434
+ description: 'Current state of the ticket.',
3435
+ example: 'waiting_on_us',
3436
+ enum: [
3437
+ 'waiting_on_us',
3438
+ 'waiting_on_user',
3439
+ 'closed'
3440
+ ]
1345
3441
  },
1346
- type: {
3442
+ category: {
1347
3443
  type: 'string',
1348
- nullable: true,
1349
- description: 'Payment method type type. Only `card` payments supported at the moment.',
1350
- example: 'card',
1351
- enum: ['card']
3444
+ description: 'Ticket category.',
3445
+ example: 'technical',
3446
+ enum: [
3447
+ 'billing',
3448
+ 'technical',
3449
+ 'general'
3450
+ ]
1352
3451
  },
1353
- last4: {
3452
+ summary: {
1354
3453
  type: 'string',
1355
- nullable: true,
1356
- description: 'Last 4 digits of the payment card number.',
1357
- example: '4242'
3454
+ description: 'First 128 characters of the initial message body, with markdown formatting and newlines stripped. Used for ticket list previews.',
3455
+ example: 'My cluster cannot reach the registry. Logs attached.'
1358
3456
  },
1359
- exp_month: {
1360
- type: 'integer',
1361
- minimum: 1,
1362
- maximum: 12,
1363
- nullable: true,
1364
- description: "Two-digit number representing the card's expiration month.",
1365
- example: '12'
3457
+ closed_at: {
3458
+ type: 'string',
3459
+ format: 'date-time',
3460
+ description: 'Closure timestamp. Null while the ticket is open.',
3461
+ example: '2026-05-18T16:08:14.338Z'
1366
3462
  },
1367
- exp_year: {
1368
- type: 'integer',
1369
- minimum: 2024,
1370
- nullable: true,
1371
- description: "Four-digit number representing the card's expiration year.",
1372
- example: '2028'
3463
+ date_created: {
3464
+ type: 'string',
3465
+ format: 'date-time',
3466
+ description: 'Creation date of the ticket. ISO 8601 UTC.',
3467
+ example: '2026-05-11T16:08:14.338Z'
1373
3468
  },
1374
- brand: {
3469
+ date_updated: {
1375
3470
  type: 'string',
1376
- nullable: true,
1377
- description: 'Payment card brand. Can be `amex`, `diners`, `discover`, `eftpos_au`, `jcb`, `mastercard`, `unionpay`, `visa`, or `unknown`.',
1378
- example: 'visa',
1379
- enum: ['amex', 'diners', 'discover', 'eftpos_au', 'jcb', 'mastercard', 'unionpay', 'visa', 'unknown']
3471
+ format: 'date-time',
3472
+ description: 'Last update date of the ticket. ISO 8601 UTC.',
3473
+ example: '2026-05-11T16:08:14.338Z'
3474
+ },
3475
+ messages: {
3476
+ type: 'array',
3477
+ items: {
3478
+ type: 'object',
3479
+ properties: {
3480
+ id: {
3481
+ type: 'string',
3482
+ description: 'Unique identifier of the message (Mongo ObjectId).',
3483
+ example: '60c72b2f9f1b2c001f8e4d3b'
3484
+ },
3485
+ type: {
3486
+ type: 'string',
3487
+ description: 'Message type. Internal notes are filtered out of customer-facing responses.',
3488
+ example: 'customer_reply',
3489
+ enum: [
3490
+ 'customer_reply',
3491
+ 'agent_reply'
3492
+ ]
3493
+ },
3494
+ body: {
3495
+ type: 'string',
3496
+ description: 'Message body in markdown.',
3497
+ example: 'Thanks — that resolved it on my side.'
3498
+ },
3499
+ author_first_name: {
3500
+ type: 'string',
3501
+ description: 'First name of the author. Null when not provided.',
3502
+ example: 'Jane'
3503
+ },
3504
+ author_last_name: {
3505
+ type: 'string',
3506
+ description: 'Last name of the author. Null when not provided.',
3507
+ example: 'Doe'
3508
+ },
3509
+ attachments: {
3510
+ type: 'array',
3511
+ items: {
3512
+ type: 'object',
3513
+ properties: {
3514
+ id: {
3515
+ type: 'string',
3516
+ description: 'Unique identifier of the attachment (Mongo ObjectId).',
3517
+ example: '60c72b2f9f1b2c001f8e4d3c'
3518
+ },
3519
+ filename: {
3520
+ type: 'string',
3521
+ description: 'Original filename as uploaded.',
3522
+ example: 'debug.log'
3523
+ },
3524
+ content_type: {
3525
+ type: 'string',
3526
+ description: 'MIME content type of the attachment.',
3527
+ example: 'text/plain'
3528
+ },
3529
+ size: {
3530
+ type: 'integer',
3531
+ description: 'Size of the attachment in bytes.',
3532
+ example: 12345
3533
+ }
3534
+ },
3535
+ required: [
3536
+ 'id',
3537
+ 'filename',
3538
+ 'content_type',
3539
+ 'size'
3540
+ ],
3541
+ additionalProperties: false
3542
+ },
3543
+ description: 'Attachments associated with this message.',
3544
+ example: []
3545
+ },
3546
+ date_created: {
3547
+ type: 'string',
3548
+ format: 'date-time',
3549
+ description: 'Creation date of the message. ISO 8601 UTC.',
3550
+ example: '2026-05-11T16:08:14.338Z'
3551
+ }
3552
+ },
3553
+ required: [
3554
+ 'id',
3555
+ 'type',
3556
+ 'body',
3557
+ 'date_created'
3558
+ ],
3559
+ additionalProperties: false
3560
+ },
3561
+ description: 'Messages on the ticket in chronological order. Internal notes are excluded. Returned by the detail endpoint only.'
1380
3562
  }
1381
3563
  },
1382
- required: ['id', 'setup', 'type', 'last4', 'exp_month', 'exp_year', 'brand'],
3564
+ required: [
3565
+ 'id',
3566
+ 'status',
3567
+ 'category',
3568
+ 'summary',
3569
+ 'date_created',
3570
+ 'date_updated'
3571
+ ],
1383
3572
  additionalProperties: false
1384
3573
  };
1385
3574
  export const TokenCreateInputSchema = {
@@ -1397,10 +3586,16 @@ export const TokenCreateInputSchema = {
1397
3586
  type: 'string',
1398
3587
  description: 'Role assumed by the token.',
1399
3588
  example: 'User',
1400
- enum: ['Administrator', 'User']
3589
+ enum: [
3590
+ 'Administrator',
3591
+ 'User'
3592
+ ]
1401
3593
  }
1402
3594
  },
1403
- required: ['name', 'role'],
3595
+ required: [
3596
+ 'name',
3597
+ 'role'
3598
+ ],
1404
3599
  additionalProperties: false
1405
3600
  };
1406
3601
  export const TokenSchema = {
@@ -1418,7 +3613,10 @@ export const TokenSchema = {
1418
3613
  type: 'string',
1419
3614
  description: 'Role assumed by the token.',
1420
3615
  example: 'User',
1421
- enum: ['Administrator', 'User']
3616
+ enum: [
3617
+ 'Administrator',
3618
+ 'User'
3619
+ ]
1422
3620
  },
1423
3621
  id: {
1424
3622
  type: 'string',
@@ -1437,7 +3635,11 @@ export const TokenSchema = {
1437
3635
  example: '2023-12-20T13:53:32.000Z'
1438
3636
  }
1439
3637
  },
1440
- required: ['name', 'role', 'date_created'],
3638
+ required: [
3639
+ 'name',
3640
+ 'role',
3641
+ 'date_created'
3642
+ ],
1441
3643
  additionalProperties: false
1442
3644
  };
1443
3645
  export const TokenUpdateInputSchema = {
@@ -1455,11 +3657,129 @@ export const TokenUpdateInputSchema = {
1455
3657
  type: 'string',
1456
3658
  description: 'Role assumed by the token.',
1457
3659
  example: 'User',
1458
- enum: ['Administrator', 'User']
3660
+ enum: [
3661
+ 'Administrator',
3662
+ 'User'
3663
+ ]
1459
3664
  }
1460
3665
  },
1461
3666
  additionalProperties: false
1462
3667
  };
3668
+ export const UsageFacetsSchema = {
3669
+ type: 'object',
3670
+ properties: {
3671
+ cluster_id: {
3672
+ type: 'array',
3673
+ items: {
3674
+ type: 'string'
3675
+ },
3676
+ description: 'List of unique cluster IDs',
3677
+ example: [
3678
+ '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3679
+ ]
3680
+ },
3681
+ product: {
3682
+ type: 'array',
3683
+ items: {
3684
+ type: 'string'
3685
+ },
3686
+ description: 'List of unique products',
3687
+ example: [
3688
+ 'cfke_controlplane',
3689
+ 'cfke_connected_nodes'
3690
+ ]
3691
+ }
3692
+ },
3693
+ additionalProperties: false
3694
+ };
3695
+ export const UsageResponseSchema = {
3696
+ type: 'object',
3697
+ properties: {
3698
+ data: {
3699
+ type: 'array',
3700
+ items: {
3701
+ type: 'object',
3702
+ properties: {
3703
+ hour: {
3704
+ type: 'string',
3705
+ description: 'Hour of the usage',
3706
+ example: '2019-01-01T00:00:00.000Z'
3707
+ },
3708
+ cluster_id: {
3709
+ type: 'string',
3710
+ description: 'Unique identifier of the kubernetes cluster. UUID v4 string in canonical form',
3711
+ example: '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3712
+ },
3713
+ product: {
3714
+ type: 'string',
3715
+ description: 'The product the usage is associated with',
3716
+ example: 'cfke_controlplane'
3717
+ },
3718
+ value: {
3719
+ type: 'number',
3720
+ format: 'float',
3721
+ description: 'Consumption',
3722
+ example: 4
3723
+ },
3724
+ price: {
3725
+ type: 'number',
3726
+ format: 'float',
3727
+ description: 'Price per unit',
3728
+ example: 0.01
3729
+ },
3730
+ total: {
3731
+ type: 'number',
3732
+ format: 'float',
3733
+ description: 'Total cost'
3734
+ }
3735
+ },
3736
+ required: [
3737
+ 'hour',
3738
+ 'cluster_id',
3739
+ 'product',
3740
+ 'value',
3741
+ 'price',
3742
+ 'total'
3743
+ ],
3744
+ additionalProperties: false
3745
+ },
3746
+ description: 'Usage data'
3747
+ },
3748
+ facets: {
3749
+ type: 'object',
3750
+ properties: {
3751
+ cluster_id: {
3752
+ type: 'array',
3753
+ items: {
3754
+ type: 'string'
3755
+ },
3756
+ description: 'List of unique cluster IDs',
3757
+ example: [
3758
+ '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
3759
+ ]
3760
+ },
3761
+ product: {
3762
+ type: 'array',
3763
+ items: {
3764
+ type: 'string'
3765
+ },
3766
+ description: 'List of unique products',
3767
+ example: [
3768
+ 'cfke_controlplane',
3769
+ 'cfke_connected_nodes'
3770
+ ]
3771
+ }
3772
+ },
3773
+ additionalProperties: false,
3774
+ description: 'Facets for filtering'
3775
+ }
3776
+ },
3777
+ required: [
3778
+ 'data',
3779
+ 'facets'
3780
+ ],
3781
+ additionalProperties: false
3782
+ };
1463
3783
  export const UsageSchema = {
1464
3784
  type: 'object',
1465
3785
  properties: {
@@ -1470,90 +3790,40 @@ export const UsageSchema = {
1470
3790
  },
1471
3791
  cluster_id: {
1472
3792
  type: 'string',
1473
- format: 'uuid',
1474
3793
  description: 'Unique identifier of the kubernetes cluster. UUID v4 string in canonical form',
1475
3794
  example: '6b5439b1-923a-4f2b-a371-d554e5ea23fa'
1476
3795
  },
1477
- cluster_tier: {
1478
- type: 'string',
1479
- description: 'Tier of the cluster.',
1480
- example: 'pro',
1481
- enum: ['basic', 'pro', '']
1482
- },
1483
3796
  product: {
1484
3797
  type: 'string',
1485
3798
  description: 'The product the usage is associated with',
1486
- example: 'cfke_controlplane',
1487
- enum: ['cfke_controlplane', 'cfke_connected_nodes', 'infra_compute', 'infra_storage', 'infra_loadbalancing', 'infra_traffic', 'cfcr_storage']
1488
- },
1489
- node_name: {
1490
- type: 'string',
1491
- description: 'Name of the Kubernetes node',
1492
- example: 'flexible-moth-956037384'
3799
+ example: 'cfke_controlplane'
1493
3800
  },
1494
- sku: {
1495
- type: 'string',
1496
- description: 'SKU of the Kubernetes node',
1497
- example: 'GCP-NORTHAMERICA-NORTHEAST1-A-G1-SMALL-SPOT'
1498
- },
1499
- cpu: {
1500
- anyOf: [
1501
- {
1502
- type: 'number',
1503
- format: 'float',
1504
- description: 'CPU core count of the node',
1505
- example: 4
1506
- },
1507
- {
1508
- type: 'string',
1509
- enum: ['']
1510
- }
1511
- ]
3801
+ value: {
3802
+ type: 'number',
3803
+ format: 'float',
3804
+ description: 'Consumption',
3805
+ example: 4
1512
3806
  },
1513
3807
  price: {
1514
- anyOf: [
1515
- {
1516
- type: 'number',
1517
- format: 'float',
1518
- description: 'Price',
1519
- example: 4
1520
- },
1521
- {
1522
- type: 'string',
1523
- enum: ['']
1524
- }
1525
- ]
1526
- },
1527
- value: {
1528
- anyOf: [
1529
- {
1530
- type: 'number',
1531
- format: 'float',
1532
- description: 'Value',
1533
- example: 4
1534
- },
1535
- {
1536
- type: 'string',
1537
- enum: ['']
1538
- }
1539
- ]
3808
+ type: 'number',
3809
+ format: 'float',
3810
+ description: 'Price per unit',
3811
+ example: 0.01
1540
3812
  },
1541
3813
  total: {
1542
- anyOf: [
1543
- {
1544
- type: 'number',
1545
- format: 'float',
1546
- description: 'Total',
1547
- example: 4
1548
- },
1549
- {
1550
- type: 'string',
1551
- enum: ['']
1552
- }
1553
- ]
3814
+ type: 'number',
3815
+ format: 'float',
3816
+ description: 'Total cost'
1554
3817
  }
1555
3818
  },
1556
- required: ['cluster_id', 'cluster_tier', 'product', 'node_name', 'sku', 'cpu', 'price', 'value', 'total'],
3819
+ required: [
3820
+ 'hour',
3821
+ 'cluster_id',
3822
+ 'product',
3823
+ 'value',
3824
+ 'price',
3825
+ 'total'
3826
+ ],
1557
3827
  additionalProperties: false
1558
3828
  };
1559
3829
  export const UserCreateInputSchema = {
@@ -1589,21 +3859,15 @@ export const UserCreateInputSchema = {
1589
3859
  type: 'string',
1590
3860
  minLength: 8,
1591
3861
  description: 'User password. Must be at least 8 characters long.'
1592
- },
1593
- status: {
1594
- type: 'string',
1595
- description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1596
- example: 'active',
1597
- enum: ['active', 'inactive']
1598
- },
1599
- role: {
1600
- type: 'string',
1601
- description: "User role. Can be 'Administrator', 'User'.",
1602
- example: 'User',
1603
- enum: ['Administrator', 'User']
1604
3862
  }
1605
3863
  },
1606
- required: ['email', 'first_name', 'last_name', 'code', 'password'],
3864
+ required: [
3865
+ 'email',
3866
+ 'first_name',
3867
+ 'last_name',
3868
+ 'code',
3869
+ 'password'
3870
+ ],
1607
3871
  additionalProperties: false
1608
3872
  };
1609
3873
  export const UserSchema = {
@@ -1631,15 +3895,21 @@ export const UserSchema = {
1631
3895
  },
1632
3896
  role: {
1633
3897
  type: 'string',
1634
- description: "User role. Can be 'Administrator', 'User'.",
3898
+ description: 'User role. Can be \'Administrator\', \'User\'.',
1635
3899
  example: 'User',
1636
- enum: ['Administrator', 'User']
3900
+ enum: [
3901
+ 'Administrator',
3902
+ 'User'
3903
+ ]
1637
3904
  },
1638
3905
  status: {
1639
3906
  type: 'string',
1640
3907
  description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1641
3908
  example: 'active',
1642
- enum: ['active', 'inactive']
3909
+ enum: [
3910
+ 'active',
3911
+ 'inactive'
3912
+ ]
1643
3913
  },
1644
3914
  id: {
1645
3915
  type: 'string',
@@ -1654,7 +3924,15 @@ export const UserSchema = {
1654
3924
  example: '2023-11-02T16:08:14.338Z'
1655
3925
  }
1656
3926
  },
1657
- required: ['email', 'first_name', 'last_name', 'role', 'status', 'id', 'date_created'],
3927
+ required: [
3928
+ 'email',
3929
+ 'first_name',
3930
+ 'last_name',
3931
+ 'role',
3932
+ 'status',
3933
+ 'id',
3934
+ 'date_created'
3935
+ ],
1658
3936
  additionalProperties: false
1659
3937
  };
1660
3938
  export const UserUpdateInputSchema = {
@@ -1682,15 +3960,21 @@ export const UserUpdateInputSchema = {
1682
3960
  },
1683
3961
  role: {
1684
3962
  type: 'string',
1685
- description: "User role. Can be 'Administrator', 'User'.",
3963
+ description: 'User role. Can be \'Administrator\', \'User\'.',
1686
3964
  example: 'User',
1687
- enum: ['Administrator', 'User']
3965
+ enum: [
3966
+ 'Administrator',
3967
+ 'User'
3968
+ ]
1688
3969
  },
1689
3970
  status: {
1690
3971
  type: 'string',
1691
3972
  description: 'Status of the user. Can be `active` or `inactive`. Inactive users cannot log in or manage organization resources.',
1692
3973
  example: 'active',
1693
- enum: ['active', 'inactive']
3974
+ enum: [
3975
+ 'active',
3976
+ 'inactive'
3977
+ ]
1694
3978
  }
1695
3979
  },
1696
3980
  additionalProperties: false