@cosmicdrift/kumiko-samples 0.411.0 → 0.413.0

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 (182) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +13 -13
  3. package/packages/bundled-features/src/admin-shell/feature.ts +1 -1
  4. package/packages/bundled-features/src/agent-tools/agent-doc-lint.ts +64 -3
  5. package/packages/bundled-features/src/agent-tools/agent-manifest.ts +13 -130
  6. package/packages/bundled-features/src/agent-tools/api-docs/anchors.ts +60 -0
  7. package/packages/bundled-features/src/agent-tools/api-docs/check.ts +25 -0
  8. package/packages/bundled-features/src/agent-tools/api-docs/collect-events.ts +140 -0
  9. package/packages/bundled-features/src/agent-tools/api-docs/collect.ts +175 -0
  10. package/packages/bundled-features/src/agent-tools/api-docs/curl.ts +28 -0
  11. package/packages/bundled-features/src/agent-tools/api-docs/error-table.ts +45 -0
  12. package/packages/bundled-features/src/agent-tools/api-docs/examples.ts +43 -0
  13. package/packages/bundled-features/src/agent-tools/api-docs/generate.ts +179 -0
  14. package/packages/bundled-features/src/agent-tools/api-docs/index-json.ts +29 -0
  15. package/packages/bundled-features/src/agent-tools/api-docs/index.ts +21 -0
  16. package/packages/bundled-features/src/agent-tools/api-docs/list-parameters.ts +38 -0
  17. package/packages/bundled-features/src/agent-tools/api-docs/markdown.ts +70 -0
  18. package/packages/bundled-features/src/agent-tools/api-docs/menu-path.ts +82 -0
  19. package/packages/bundled-features/src/agent-tools/api-docs/model.ts +83 -0
  20. package/packages/bundled-features/src/agent-tools/api-docs/problems.ts +58 -0
  21. package/packages/bundled-features/src/agent-tools/api-docs/render-events.ts +76 -0
  22. package/packages/bundled-features/src/agent-tools/api-docs/render-openapi.ts +216 -0
  23. package/packages/bundled-features/src/agent-tools/api-docs/render-overview.ts +86 -0
  24. package/packages/bundled-features/src/agent-tools/api-docs/render-reference.ts +79 -0
  25. package/packages/bundled-features/src/agent-tools/api-docs/render-tokens.ts +136 -0
  26. package/packages/bundled-features/src/agent-tools/api-docs/schema-fields.ts +167 -0
  27. package/packages/bundled-features/src/agent-tools/api-docs/section-ids.ts +28 -0
  28. package/packages/bundled-features/src/agent-tools/api-docs/system-only.ts +11 -0
  29. package/packages/bundled-features/src/agent-tools/api-docs/texts/de.ts +166 -0
  30. package/packages/bundled-features/src/agent-tools/api-docs/texts/en.ts +159 -0
  31. package/packages/bundled-features/src/agent-tools/api-docs/texts/es.ts +162 -0
  32. package/packages/bundled-features/src/agent-tools/api-docs/texts/fr.ts +169 -0
  33. package/packages/bundled-features/src/agent-tools/api-docs/texts/index.ts +67 -0
  34. package/packages/bundled-features/src/agent-tools/api-docs/texts/it.ts +165 -0
  35. package/packages/bundled-features/src/agent-tools/api-docs/texts/types.ts +130 -0
  36. package/packages/bundled-features/src/agent-tools/api-docs/ui-writes.ts +81 -0
  37. package/packages/bundled-features/src/agent-tools/changes.json +24 -0
  38. package/packages/bundled-features/src/agent-tools/handler-schema.ts +45 -0
  39. package/packages/bundled-features/src/agent-tools/index.ts +24 -0
  40. package/packages/bundled-features/src/agent-tools/labels.ts +181 -0
  41. package/packages/bundled-features/src/auth-email-password/boot-rules.ts +9 -0
  42. package/packages/bundled-features/src/auth-email-password/feature.ts +6 -19
  43. package/packages/bundled-features/src/auth-email-password/validate-options.ts +20 -0
  44. package/packages/bundled-features/src/billing-foundation/boot-rules.ts +26 -0
  45. package/packages/bundled-features/src/billing-foundation/validate-options.ts +59 -46
  46. package/packages/bundled-features/src/cap-overview/boot-rules.ts +14 -0
  47. package/packages/bundled-features/src/cap-overview/feature.ts +12 -5
  48. package/packages/bundled-features/src/documents/boot-rules.ts +14 -0
  49. package/packages/bundled-features/src/documents/feature.ts +8 -4
  50. package/packages/bundled-features/src/file-derivatives/boot-rules.ts +9 -0
  51. package/packages/bundled-features/src/file-derivatives/feature.ts +6 -3
  52. package/packages/bundled-features/src/folders/boot-rules.ts +9 -0
  53. package/packages/bundled-features/src/folders/feature.ts +6 -3
  54. package/packages/bundled-features/src/helpdesk/boot-rules.ts +9 -0
  55. package/packages/bundled-features/src/{contact → helpdesk}/challenge.ts +2 -2
  56. package/packages/bundled-features/src/{contact → helpdesk}/changes.json +6 -0
  57. package/packages/bundled-features/src/{contact/client/contact-client-source.ts → helpdesk/client/helpdesk-client-source.ts} +4 -4
  58. package/packages/bundled-features/src/helpdesk/client/helpdesk-website-client.ts +29 -0
  59. package/packages/bundled-features/src/helpdesk/client/index.ts +9 -0
  60. package/packages/bundled-features/src/{contact → helpdesk}/entity.ts +35 -31
  61. package/packages/bundled-features/src/{contact → helpdesk}/feature.ts +56 -52
  62. package/packages/bundled-features/src/{contact → helpdesk}/handlers/attempts.ts +3 -3
  63. package/packages/bundled-features/src/{contact → helpdesk}/handlers/challenge.query.ts +10 -10
  64. package/packages/bundled-features/src/{contact → helpdesk}/handlers/forward-request.write.ts +25 -23
  65. package/packages/bundled-features/src/{contact → helpdesk}/handlers/mark-done.write.ts +11 -11
  66. package/packages/bundled-features/src/{contact → helpdesk}/handlers/notify-reporter-in-app.write.ts +14 -14
  67. package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.query.ts +4 -4
  68. package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.ts +2 -2
  69. package/packages/bundled-features/src/{contact → helpdesk}/handlers/replies.query.ts +6 -6
  70. package/packages/bundled-features/src/{contact → helpdesk}/handlers/reply.write.ts +30 -30
  71. package/packages/bundled-features/src/{contact → helpdesk}/handlers/report.write.ts +29 -29
  72. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-delivery.query.ts +40 -40
  73. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-detail.query.ts +15 -15
  74. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-list.query.ts +2 -2
  75. package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-reply-mail.write.ts +24 -24
  76. package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-test.write.ts +18 -14
  77. package/packages/bundled-features/src/{contact → helpdesk}/handlers/submit.write.ts +32 -31
  78. package/packages/bundled-features/src/{contact → helpdesk}/handlers/take-over-uploads.ts +5 -5
  79. package/packages/bundled-features/src/{contact → helpdesk}/i18n.ts +78 -75
  80. package/packages/bundled-features/src/helpdesk/index.ts +29 -0
  81. package/packages/bundled-features/src/{contact → helpdesk}/lib.ts +32 -28
  82. package/packages/bundled-features/src/{contact → helpdesk}/mail.ts +56 -56
  83. package/packages/bundled-features/src/{contact → helpdesk}/options.ts +18 -16
  84. package/packages/bundled-features/src/helpdesk/panels.ts +28 -0
  85. package/packages/bundled-features/src/{contact → helpdesk}/payloads.ts +33 -33
  86. package/packages/bundled-features/src/{contact → helpdesk}/screens.ts +104 -104
  87. package/packages/bundled-features/src/{contact → helpdesk}/subject.ts +3 -3
  88. package/packages/bundled-features/src/{contact → helpdesk}/user-data-hooks.ts +17 -17
  89. package/packages/bundled-features/src/helpdesk/web/constants.ts +160 -0
  90. package/packages/bundled-features/src/helpdesk/web/index.ts +29 -0
  91. package/packages/bundled-features/src/host-routing/boot-rules.ts +27 -0
  92. package/packages/bundled-features/src/host-routing/validate-options.ts +36 -27
  93. package/packages/bundled-features/src/inbound-mail-foundation/changes.json +6 -0
  94. package/packages/bundled-features/src/inbound-mail-foundation/entities.ts +99 -71
  95. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +2 -2
  96. package/packages/bundled-features/src/jobs/boot-rules.ts +9 -0
  97. package/packages/bundled-features/src/jobs/feature.ts +9 -4
  98. package/packages/bundled-features/src/legal-pages/boot-rules.ts +19 -0
  99. package/packages/bundled-features/src/legal-pages/feature.ts +6 -3
  100. package/packages/bundled-features/src/legal-pages/lib/validate-routes.ts +11 -5
  101. package/packages/bundled-features/src/metrics/boot-rules.ts +15 -0
  102. package/packages/bundled-features/src/metrics/validate.ts +8 -2
  103. package/packages/bundled-features/src/notes-history/boot-rules.ts +9 -0
  104. package/packages/bundled-features/src/notes-history/feature.ts +6 -3
  105. package/packages/bundled-features/src/personal-access-tokens/boot-rules.ts +9 -0
  106. package/packages/bundled-features/src/personal-access-tokens/changes.json +6 -0
  107. package/packages/bundled-features/src/personal-access-tokens/feature.ts +5 -2
  108. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +7 -2
  109. package/packages/bundled-features/src/personal-access-tokens/i18n.ts +6 -1
  110. package/packages/bundled-features/src/personal-access-tokens/index.ts +37 -2
  111. package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +31 -0
  112. package/packages/bundled-features/src/personal-access-tokens/screens.ts +9 -1
  113. package/packages/bundled-features/src/personal-access-tokens/web/constants.ts +1 -0
  114. package/packages/bundled-features/src/personal-access-tokens/web/scopes.ts +14 -0
  115. package/packages/bundled-features/src/presence/boot-rules.ts +9 -0
  116. package/packages/bundled-features/src/presence/options.ts +5 -1
  117. package/packages/bundled-features/src/readiness/boot-rules.ts +14 -0
  118. package/packages/bundled-features/src/readiness/probe-boot-check.ts +8 -6
  119. package/packages/bundled-features/src/shared/assert-no-where-rule-in-ownership-write.ts +6 -4
  120. package/packages/bundled-features/src/shared/boot-rules.ts +9 -0
  121. package/packages/bundled-features/src/subscription-mollie/boot-rules.ts +19 -0
  122. package/packages/bundled-features/src/subscription-mollie/feature.ts +18 -10
  123. package/packages/bundled-features/src/tags/boot-rules.ts +9 -0
  124. package/packages/bundled-features/src/tags/feature.ts +6 -3
  125. package/packages/bundled-features/src/template-resolver/boot-rules.ts +19 -0
  126. package/packages/bundled-features/src/template-resolver/feature.ts +14 -10
  127. package/packages/bundled-features/src/tenant/boot-rules.ts +9 -0
  128. package/packages/bundled-features/src/tenant/feature.ts +5 -3
  129. package/samples/apps/marketing-demo/README.md +1 -1
  130. package/samples/apps/marketing-demo/playwright.config.ts +1 -1
  131. package/samples/apps/marketing-demo/src/app/client.tsx +3 -3
  132. package/samples/apps/marketing-demo/src/app/seed-data.ts +1 -1
  133. package/samples/apps/marketing-demo/src/app/seed.ts +4 -4
  134. package/samples/apps/marketing-demo/src/app/server.ts +3 -3
  135. package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/feature.ts +15 -12
  136. package/samples/apps/marketing-demo/src/features/ticketing/i18n.ts +100 -0
  137. package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/ticket.ts +4 -4
  138. package/samples/apps/marketing-demo/src/features/ticketing/web/index.ts +7 -0
  139. package/samples/apps/use-all-bundled/feature-manifest.json +67 -67
  140. package/samples/apps/use-all-bundled/kumiko/migrations/0064_helpdesk-rename.rebuild.json +4 -0
  141. package/samples/apps/use-all-bundled/package.json +1 -1
  142. package/samples/apps/use-all-bundled/src/app/client.tsx +1 -1
  143. package/samples/apps/use-all-bundled/src/app/screens-feature.ts +10 -10
  144. package/samples/apps/use-all-bundled/src/run-config.ts +6 -6
  145. package/samples/recipes/api-docs/README.md +52 -0
  146. package/samples/recipes/api-docs/api-docs/de/events.md +62 -0
  147. package/samples/recipes/api-docs/api-docs/de/overview.md +100 -0
  148. package/samples/recipes/api-docs/api-docs/de/reference/tickets.md +305 -0
  149. package/samples/recipes/api-docs/api-docs/de/tokens.md +66 -0
  150. package/samples/recipes/api-docs/api-docs/en/events.md +62 -0
  151. package/samples/recipes/api-docs/api-docs/en/overview.md +100 -0
  152. package/samples/recipes/api-docs/api-docs/en/reference/tickets.md +305 -0
  153. package/samples/recipes/api-docs/api-docs/en/tokens.md +66 -0
  154. package/samples/recipes/api-docs/api-docs/index.json +371 -0
  155. package/samples/recipes/api-docs/api-docs/openapi.json +982 -0
  156. package/samples/recipes/api-docs/api-examples/ticket-close.json +21 -0
  157. package/samples/recipes/api-docs/api-examples/ticket-create.json +42 -0
  158. package/samples/recipes/api-docs/api-examples/ticket-detail.json +28 -0
  159. package/samples/recipes/api-docs/api-examples/ticket-list.json +31 -0
  160. package/samples/recipes/api-docs/api-examples/ticket-update.json +54 -0
  161. package/samples/recipes/api-docs/api-examples/webhooks/ticket-closed.json +8 -0
  162. package/samples/recipes/api-docs/api-examples/webhooks/ticket-created.json +10 -0
  163. package/samples/recipes/api-docs/kumiko.config.ts +33 -0
  164. package/samples/recipes/api-docs/package.json +14 -0
  165. package/samples/recipes/api-docs/src/feature.ts +218 -0
  166. package/samples/recipes/api-docs/tsconfig.json +22 -0
  167. package/samples/recipes/golden-path/src/feature.ts +1 -1
  168. package/samples/recipes/{contact → helpdesk}/README.md +16 -16
  169. package/samples/recipes/{contact → helpdesk}/package.json +2 -2
  170. package/samples/recipes/{contact → helpdesk}/src/feature.ts +6 -6
  171. package/packages/bundled-features/src/contact/client/contact-website-client.ts +0 -29
  172. package/packages/bundled-features/src/contact/client/index.ts +0 -9
  173. package/packages/bundled-features/src/contact/index.ts +0 -29
  174. package/packages/bundled-features/src/contact/panels.ts +0 -28
  175. package/packages/bundled-features/src/contact/web/constants.ts +0 -160
  176. package/packages/bundled-features/src/contact/web/index.ts +0 -29
  177. package/samples/apps/marketing-demo/src/features/helpdesk/i18n.ts +0 -100
  178. package/samples/apps/marketing-demo/src/features/helpdesk/web/index.ts +0 -7
  179. /package/packages/bundled-features/src/{contact → helpdesk}/handlers/access.ts +0 -0
  180. /package/packages/bundled-features/src/{contact → helpdesk}/pow.ts +0 -0
  181. /package/packages/bundled-features/src/{contact → helpdesk}/user-agent.ts +0 -0
  182. /package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/index.ts +0 -0
@@ -0,0 +1,982 @@
1
+ {
2
+ "openapi": "3.1.0",
3
+ "info": {
4
+ "title": "Helpdesk API",
5
+ "version": "0.0.0"
6
+ },
7
+ "servers": [
8
+ {
9
+ "url": "https://ticketing.example.com"
10
+ }
11
+ ],
12
+ "security": [
13
+ {
14
+ "bearerAuth": []
15
+ }
16
+ ],
17
+ "paths": {
18
+ "/api/query": {
19
+ "post": {
20
+ "summary": "Query",
21
+ "requestBody": {
22
+ "required": true,
23
+ "content": {
24
+ "application/json": {
25
+ "schema": {
26
+ "oneOf": [
27
+ {
28
+ "$ref": "#/components/schemas/ticketing.query.ticket.detail.request"
29
+ },
30
+ {
31
+ "$ref": "#/components/schemas/ticketing.query.ticket.list.request"
32
+ }
33
+ ],
34
+ "discriminator": {
35
+ "propertyName": "type",
36
+ "mapping": {
37
+ "ticketing:query:ticket:detail": "#/components/schemas/ticketing.query.ticket.detail.request",
38
+ "ticketing:query:ticket:list": "#/components/schemas/ticketing.query.ticket.list.request"
39
+ }
40
+ }
41
+ }
42
+ }
43
+ }
44
+ },
45
+ "responses": {
46
+ "200": {
47
+ "description": "Success",
48
+ "content": {
49
+ "application/json": {
50
+ "schema": {
51
+ "type": "object",
52
+ "properties": {
53
+ "isSuccess": {
54
+ "type": "boolean"
55
+ },
56
+ "data": {}
57
+ }
58
+ }
59
+ }
60
+ }
61
+ },
62
+ "400": {
63
+ "description": "Error",
64
+ "content": {
65
+ "application/json": {
66
+ "schema": {
67
+ "$ref": "#/components/schemas/ErrorEnvelope"
68
+ }
69
+ }
70
+ }
71
+ },
72
+ "401": {
73
+ "description": "Error",
74
+ "content": {
75
+ "application/json": {
76
+ "schema": {
77
+ "$ref": "#/components/schemas/ErrorEnvelope"
78
+ }
79
+ }
80
+ }
81
+ },
82
+ "403": {
83
+ "description": "Error",
84
+ "content": {
85
+ "application/json": {
86
+ "schema": {
87
+ "$ref": "#/components/schemas/ErrorEnvelope"
88
+ }
89
+ }
90
+ }
91
+ },
92
+ "404": {
93
+ "description": "Error",
94
+ "content": {
95
+ "application/json": {
96
+ "schema": {
97
+ "$ref": "#/components/schemas/ErrorEnvelope"
98
+ }
99
+ }
100
+ }
101
+ },
102
+ "409": {
103
+ "description": "Error",
104
+ "content": {
105
+ "application/json": {
106
+ "schema": {
107
+ "$ref": "#/components/schemas/ErrorEnvelope"
108
+ }
109
+ }
110
+ }
111
+ },
112
+ "422": {
113
+ "description": "Error",
114
+ "content": {
115
+ "application/json": {
116
+ "schema": {
117
+ "$ref": "#/components/schemas/ErrorEnvelope"
118
+ }
119
+ }
120
+ }
121
+ },
122
+ "429": {
123
+ "description": "Error",
124
+ "content": {
125
+ "application/json": {
126
+ "schema": {
127
+ "$ref": "#/components/schemas/ErrorEnvelope"
128
+ }
129
+ }
130
+ }
131
+ },
132
+ "500": {
133
+ "description": "Error",
134
+ "content": {
135
+ "application/json": {
136
+ "schema": {
137
+ "$ref": "#/components/schemas/ErrorEnvelope"
138
+ }
139
+ }
140
+ }
141
+ },
142
+ "503": {
143
+ "description": "Error",
144
+ "content": {
145
+ "application/json": {
146
+ "schema": {
147
+ "$ref": "#/components/schemas/ErrorEnvelope"
148
+ }
149
+ }
150
+ }
151
+ },
152
+ "504": {
153
+ "description": "Error",
154
+ "content": {
155
+ "application/json": {
156
+ "schema": {
157
+ "$ref": "#/components/schemas/ErrorEnvelope"
158
+ }
159
+ }
160
+ }
161
+ }
162
+ }
163
+ }
164
+ },
165
+ "/api/write": {
166
+ "post": {
167
+ "summary": "Write",
168
+ "requestBody": {
169
+ "required": true,
170
+ "content": {
171
+ "application/json": {
172
+ "schema": {
173
+ "oneOf": [
174
+ {
175
+ "$ref": "#/components/schemas/ticketing.write.ticket.close.request"
176
+ },
177
+ {
178
+ "$ref": "#/components/schemas/ticketing.write.ticket.create.request"
179
+ },
180
+ {
181
+ "$ref": "#/components/schemas/ticketing.write.ticket.update.request"
182
+ }
183
+ ],
184
+ "discriminator": {
185
+ "propertyName": "type",
186
+ "mapping": {
187
+ "ticketing:write:ticket:close": "#/components/schemas/ticketing.write.ticket.close.request",
188
+ "ticketing:write:ticket:create": "#/components/schemas/ticketing.write.ticket.create.request",
189
+ "ticketing:write:ticket:update": "#/components/schemas/ticketing.write.ticket.update.request"
190
+ }
191
+ }
192
+ }
193
+ }
194
+ }
195
+ },
196
+ "responses": {
197
+ "200": {
198
+ "description": "Success",
199
+ "content": {
200
+ "application/json": {
201
+ "schema": {
202
+ "type": "object",
203
+ "properties": {
204
+ "isSuccess": {
205
+ "type": "boolean"
206
+ },
207
+ "data": {}
208
+ }
209
+ }
210
+ }
211
+ }
212
+ },
213
+ "400": {
214
+ "description": "Error",
215
+ "content": {
216
+ "application/json": {
217
+ "schema": {
218
+ "$ref": "#/components/schemas/ErrorEnvelope"
219
+ }
220
+ }
221
+ }
222
+ },
223
+ "401": {
224
+ "description": "Error",
225
+ "content": {
226
+ "application/json": {
227
+ "schema": {
228
+ "$ref": "#/components/schemas/ErrorEnvelope"
229
+ }
230
+ }
231
+ }
232
+ },
233
+ "403": {
234
+ "description": "Error",
235
+ "content": {
236
+ "application/json": {
237
+ "schema": {
238
+ "$ref": "#/components/schemas/ErrorEnvelope"
239
+ }
240
+ }
241
+ }
242
+ },
243
+ "404": {
244
+ "description": "Error",
245
+ "content": {
246
+ "application/json": {
247
+ "schema": {
248
+ "$ref": "#/components/schemas/ErrorEnvelope"
249
+ }
250
+ }
251
+ }
252
+ },
253
+ "409": {
254
+ "description": "Error",
255
+ "content": {
256
+ "application/json": {
257
+ "schema": {
258
+ "$ref": "#/components/schemas/ErrorEnvelope"
259
+ }
260
+ }
261
+ }
262
+ },
263
+ "422": {
264
+ "description": "Error",
265
+ "content": {
266
+ "application/json": {
267
+ "schema": {
268
+ "$ref": "#/components/schemas/ErrorEnvelope"
269
+ }
270
+ }
271
+ }
272
+ },
273
+ "429": {
274
+ "description": "Error",
275
+ "content": {
276
+ "application/json": {
277
+ "schema": {
278
+ "$ref": "#/components/schemas/ErrorEnvelope"
279
+ }
280
+ }
281
+ }
282
+ },
283
+ "500": {
284
+ "description": "Error",
285
+ "content": {
286
+ "application/json": {
287
+ "schema": {
288
+ "$ref": "#/components/schemas/ErrorEnvelope"
289
+ }
290
+ }
291
+ }
292
+ },
293
+ "503": {
294
+ "description": "Error",
295
+ "content": {
296
+ "application/json": {
297
+ "schema": {
298
+ "$ref": "#/components/schemas/ErrorEnvelope"
299
+ }
300
+ }
301
+ }
302
+ },
303
+ "504": {
304
+ "description": "Error",
305
+ "content": {
306
+ "application/json": {
307
+ "schema": {
308
+ "$ref": "#/components/schemas/ErrorEnvelope"
309
+ }
310
+ }
311
+ }
312
+ }
313
+ }
314
+ }
315
+ },
316
+ "/api/batch": {
317
+ "post": {
318
+ "summary": "Batch",
319
+ "requestBody": {
320
+ "required": true,
321
+ "content": {
322
+ "application/json": {
323
+ "schema": {
324
+ "type": "object",
325
+ "required": [
326
+ "commands"
327
+ ],
328
+ "properties": {
329
+ "commands": {
330
+ "type": "array",
331
+ "items": {
332
+ "oneOf": [
333
+ {
334
+ "$ref": "#/components/schemas/ticketing.write.ticket.close.request"
335
+ },
336
+ {
337
+ "$ref": "#/components/schemas/ticketing.write.ticket.create.request"
338
+ },
339
+ {
340
+ "$ref": "#/components/schemas/ticketing.write.ticket.update.request"
341
+ }
342
+ ],
343
+ "discriminator": {
344
+ "propertyName": "type",
345
+ "mapping": {
346
+ "ticketing:write:ticket:close": "#/components/schemas/ticketing.write.ticket.close.request",
347
+ "ticketing:write:ticket:create": "#/components/schemas/ticketing.write.ticket.create.request",
348
+ "ticketing:write:ticket:update": "#/components/schemas/ticketing.write.ticket.update.request"
349
+ }
350
+ }
351
+ }
352
+ },
353
+ "requestId": {
354
+ "type": "string"
355
+ }
356
+ }
357
+ }
358
+ }
359
+ }
360
+ },
361
+ "responses": {
362
+ "200": {
363
+ "description": "Success",
364
+ "content": {
365
+ "application/json": {
366
+ "schema": {
367
+ "type": "object",
368
+ "properties": {
369
+ "isSuccess": {
370
+ "type": "boolean"
371
+ },
372
+ "data": {
373
+ "type": "array"
374
+ }
375
+ }
376
+ }
377
+ }
378
+ }
379
+ },
380
+ "400": {
381
+ "description": "Error",
382
+ "content": {
383
+ "application/json": {
384
+ "schema": {
385
+ "$ref": "#/components/schemas/ErrorEnvelope"
386
+ }
387
+ }
388
+ }
389
+ },
390
+ "401": {
391
+ "description": "Error",
392
+ "content": {
393
+ "application/json": {
394
+ "schema": {
395
+ "$ref": "#/components/schemas/ErrorEnvelope"
396
+ }
397
+ }
398
+ }
399
+ },
400
+ "403": {
401
+ "description": "Error",
402
+ "content": {
403
+ "application/json": {
404
+ "schema": {
405
+ "$ref": "#/components/schemas/ErrorEnvelope"
406
+ }
407
+ }
408
+ }
409
+ },
410
+ "404": {
411
+ "description": "Error",
412
+ "content": {
413
+ "application/json": {
414
+ "schema": {
415
+ "$ref": "#/components/schemas/ErrorEnvelope"
416
+ }
417
+ }
418
+ }
419
+ },
420
+ "409": {
421
+ "description": "Error",
422
+ "content": {
423
+ "application/json": {
424
+ "schema": {
425
+ "$ref": "#/components/schemas/ErrorEnvelope"
426
+ }
427
+ }
428
+ }
429
+ },
430
+ "422": {
431
+ "description": "Error",
432
+ "content": {
433
+ "application/json": {
434
+ "schema": {
435
+ "$ref": "#/components/schemas/ErrorEnvelope"
436
+ }
437
+ }
438
+ }
439
+ },
440
+ "429": {
441
+ "description": "Error",
442
+ "content": {
443
+ "application/json": {
444
+ "schema": {
445
+ "$ref": "#/components/schemas/ErrorEnvelope"
446
+ }
447
+ }
448
+ }
449
+ },
450
+ "500": {
451
+ "description": "Error",
452
+ "content": {
453
+ "application/json": {
454
+ "schema": {
455
+ "$ref": "#/components/schemas/ErrorEnvelope"
456
+ }
457
+ }
458
+ }
459
+ },
460
+ "503": {
461
+ "description": "Error",
462
+ "content": {
463
+ "application/json": {
464
+ "schema": {
465
+ "$ref": "#/components/schemas/ErrorEnvelope"
466
+ }
467
+ }
468
+ }
469
+ },
470
+ "504": {
471
+ "description": "Error",
472
+ "content": {
473
+ "application/json": {
474
+ "schema": {
475
+ "$ref": "#/components/schemas/ErrorEnvelope"
476
+ }
477
+ }
478
+ }
479
+ }
480
+ }
481
+ }
482
+ }
483
+ },
484
+ "webhooks": {
485
+ "ticket.created": {
486
+ "post": {
487
+ "summary": "ticket.created",
488
+ "x-kumiko-qn": "ticket.created",
489
+ "description": "A record of type ticket was created.",
490
+ "requestBody": {
491
+ "required": true,
492
+ "content": {
493
+ "application/json": {
494
+ "schema": {
495
+ "$ref": "#/components/schemas/ticket.created.entity-event"
496
+ }
497
+ }
498
+ }
499
+ },
500
+ "x-kumiko-version": 1,
501
+ "x-kumiko-scope": [
502
+ "tickets:read"
503
+ ]
504
+ }
505
+ },
506
+ "ticket.closed": {
507
+ "post": {
508
+ "summary": "ticket.closed",
509
+ "x-kumiko-qn": "ticketing:ticket-closed",
510
+ "description": "A ticket was closed and its resolution recorded.",
511
+ "requestBody": {
512
+ "required": true,
513
+ "content": {
514
+ "application/json": {
515
+ "schema": {
516
+ "$ref": "#/components/schemas/ticketing.ticket-closed.event"
517
+ }
518
+ }
519
+ }
520
+ },
521
+ "x-kumiko-version": 1,
522
+ "x-kumiko-scope": [
523
+ "tickets:read"
524
+ ]
525
+ }
526
+ }
527
+ },
528
+ "components": {
529
+ "securitySchemes": {
530
+ "bearerAuth": {
531
+ "type": "http",
532
+ "scheme": "bearer"
533
+ }
534
+ },
535
+ "schemas": {
536
+ "ticketing.query.ticket.detail.request": {
537
+ "type": "object",
538
+ "description": "Returns one ticket.",
539
+ "required": [
540
+ "type",
541
+ "payload"
542
+ ],
543
+ "properties": {
544
+ "type": {
545
+ "const": "ticketing:query:ticket:detail"
546
+ },
547
+ "payload": {
548
+ "$ref": "#/components/schemas/ticketing.query.ticket.detail.payload"
549
+ },
550
+ "requestId": {
551
+ "type": "string"
552
+ }
553
+ }
554
+ },
555
+ "ticketing.query.ticket.detail.payload": {
556
+ "type": "object",
557
+ "properties": {
558
+ "id": {
559
+ "type": "string",
560
+ "format": "uuid",
561
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
562
+ }
563
+ },
564
+ "required": [
565
+ "id"
566
+ ]
567
+ },
568
+ "ticketing.query.ticket.list.request": {
569
+ "type": "object",
570
+ "description": "Lists tickets, newest first.",
571
+ "required": [
572
+ "type",
573
+ "payload"
574
+ ],
575
+ "properties": {
576
+ "type": {
577
+ "const": "ticketing:query:ticket:list"
578
+ },
579
+ "payload": {
580
+ "$ref": "#/components/schemas/ticketing.query.ticket.list.payload"
581
+ },
582
+ "requestId": {
583
+ "type": "string"
584
+ }
585
+ }
586
+ },
587
+ "ticketing.query.ticket.list.payload": {
588
+ "type": "object",
589
+ "properties": {
590
+ "cursor": {
591
+ "type": "string"
592
+ },
593
+ "limit": {
594
+ "type": "integer",
595
+ "minimum": 0,
596
+ "maximum": 200
597
+ },
598
+ "search": {
599
+ "type": "string"
600
+ },
601
+ "sort": {
602
+ "type": "string"
603
+ },
604
+ "sortDirection": {
605
+ "type": "string",
606
+ "enum": [
607
+ "asc",
608
+ "desc"
609
+ ]
610
+ },
611
+ "offset": {
612
+ "type": "integer",
613
+ "minimum": 0,
614
+ "maximum": 9007199254740991
615
+ },
616
+ "totalCount": {
617
+ "type": "boolean"
618
+ },
619
+ "includeDeleted": {
620
+ "type": "boolean"
621
+ },
622
+ "onlyDeleted": {
623
+ "type": "boolean"
624
+ },
625
+ "filter": {
626
+ "type": "object",
627
+ "properties": {
628
+ "field": {
629
+ "type": "string"
630
+ },
631
+ "op": {
632
+ "type": "string",
633
+ "enum": [
634
+ "eq",
635
+ "ne",
636
+ "lt",
637
+ "gt",
638
+ "lte",
639
+ "gte",
640
+ "in"
641
+ ]
642
+ },
643
+ "value": {}
644
+ },
645
+ "required": [
646
+ "field",
647
+ "op",
648
+ "value"
649
+ ]
650
+ },
651
+ "filters": {
652
+ "type": "array",
653
+ "items": {
654
+ "type": "object",
655
+ "properties": {
656
+ "field": {
657
+ "type": "string"
658
+ },
659
+ "op": {
660
+ "type": "string",
661
+ "enum": [
662
+ "eq",
663
+ "ne",
664
+ "lt",
665
+ "gt",
666
+ "lte",
667
+ "gte",
668
+ "in"
669
+ ]
670
+ },
671
+ "value": {}
672
+ },
673
+ "required": [
674
+ "field",
675
+ "op",
676
+ "value"
677
+ ]
678
+ }
679
+ },
680
+ "namedFilter": {
681
+ "type": "string",
682
+ "minLength": 1,
683
+ "maxLength": 100
684
+ },
685
+ "aggregate": {
686
+ "type": "object",
687
+ "properties": {
688
+ "groupBy": {
689
+ "type": "string"
690
+ },
691
+ "measures": {
692
+ "default": [],
693
+ "maxItems": 20,
694
+ "type": "array",
695
+ "items": {
696
+ "type": "object",
697
+ "properties": {
698
+ "field": {
699
+ "type": "string"
700
+ },
701
+ "kind": {
702
+ "type": "string",
703
+ "enum": [
704
+ "sum",
705
+ "avg",
706
+ "count",
707
+ "min",
708
+ "max"
709
+ ]
710
+ }
711
+ },
712
+ "required": [
713
+ "field",
714
+ "kind"
715
+ ]
716
+ }
717
+ }
718
+ }
719
+ }
720
+ }
721
+ },
722
+ "ticketing.write.ticket.close.request": {
723
+ "type": "object",
724
+ "description": "Closes a ticket and records how it was resolved.",
725
+ "required": [
726
+ "type",
727
+ "payload"
728
+ ],
729
+ "properties": {
730
+ "type": {
731
+ "const": "ticketing:write:ticket:close"
732
+ },
733
+ "payload": {
734
+ "$ref": "#/components/schemas/ticketing.write.ticket.close.payload"
735
+ },
736
+ "requestId": {
737
+ "type": "string"
738
+ }
739
+ }
740
+ },
741
+ "ticketing.write.ticket.close.payload": {
742
+ "type": "object",
743
+ "properties": {
744
+ "id": {
745
+ "type": "string",
746
+ "format": "uuid",
747
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
748
+ },
749
+ "resolution": {
750
+ "type": "string",
751
+ "minLength": 1
752
+ }
753
+ },
754
+ "required": [
755
+ "id",
756
+ "resolution"
757
+ ]
758
+ },
759
+ "ticketing.write.ticket.create.request": {
760
+ "type": "object",
761
+ "description": "Opens a new ticket.",
762
+ "required": [
763
+ "type",
764
+ "payload"
765
+ ],
766
+ "properties": {
767
+ "type": {
768
+ "const": "ticketing:write:ticket:create"
769
+ },
770
+ "payload": {
771
+ "$ref": "#/components/schemas/ticketing.write.ticket.create.payload"
772
+ },
773
+ "requestId": {
774
+ "type": "string"
775
+ }
776
+ }
777
+ },
778
+ "ticketing.write.ticket.create.payload": {
779
+ "type": "object",
780
+ "properties": {
781
+ "title": {
782
+ "type": "string",
783
+ "minLength": 1,
784
+ "maxLength": 200
785
+ },
786
+ "status": {
787
+ "type": "string",
788
+ "enum": [
789
+ "open",
790
+ "closed"
791
+ ]
792
+ },
793
+ "priority": {
794
+ "type": "string",
795
+ "enum": [
796
+ "low",
797
+ "normal",
798
+ "high"
799
+ ]
800
+ }
801
+ },
802
+ "required": [
803
+ "title"
804
+ ]
805
+ },
806
+ "ticketing.write.ticket.update.request": {
807
+ "type": "object",
808
+ "description": "Changes the title or the priority of a ticket.",
809
+ "required": [
810
+ "type",
811
+ "payload"
812
+ ],
813
+ "properties": {
814
+ "type": {
815
+ "const": "ticketing:write:ticket:update"
816
+ },
817
+ "payload": {
818
+ "$ref": "#/components/schemas/ticketing.write.ticket.update.payload"
819
+ },
820
+ "requestId": {
821
+ "type": "string"
822
+ }
823
+ }
824
+ },
825
+ "ticketing.write.ticket.update.payload": {
826
+ "type": "object",
827
+ "properties": {
828
+ "id": {
829
+ "type": "string",
830
+ "format": "uuid",
831
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
832
+ },
833
+ "version": {
834
+ "type": "number"
835
+ },
836
+ "changes": {
837
+ "type": "object",
838
+ "properties": {
839
+ "title": {
840
+ "type": "string",
841
+ "minLength": 1,
842
+ "maxLength": 200
843
+ },
844
+ "status": {
845
+ "type": "string",
846
+ "enum": [
847
+ "open",
848
+ "closed"
849
+ ]
850
+ },
851
+ "priority": {
852
+ "type": "string",
853
+ "enum": [
854
+ "low",
855
+ "normal",
856
+ "high"
857
+ ]
858
+ }
859
+ }
860
+ }
861
+ },
862
+ "required": [
863
+ "id",
864
+ "version",
865
+ "changes"
866
+ ]
867
+ },
868
+ "ticket.created.entity-event": {
869
+ "type": "object",
870
+ "properties": {
871
+ "id": {
872
+ "type": "string",
873
+ "format": "uuid",
874
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
875
+ },
876
+ "title": {
877
+ "type": "string",
878
+ "minLength": 1,
879
+ "maxLength": 200
880
+ },
881
+ "status": {
882
+ "type": "string",
883
+ "enum": [
884
+ "open",
885
+ "closed"
886
+ ]
887
+ },
888
+ "priority": {
889
+ "type": "string",
890
+ "enum": [
891
+ "low",
892
+ "normal",
893
+ "high"
894
+ ]
895
+ }
896
+ },
897
+ "required": [
898
+ "id",
899
+ "title",
900
+ "status",
901
+ "priority"
902
+ ],
903
+ "additionalProperties": false
904
+ },
905
+ "ticketing.ticket-closed.event": {
906
+ "type": "object",
907
+ "properties": {
908
+ "id": {
909
+ "type": "string",
910
+ "format": "uuid",
911
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
912
+ "description": "ID of the closed ticket"
913
+ },
914
+ "resolution": {
915
+ "type": "string",
916
+ "description": "How the ticket was resolved"
917
+ }
918
+ },
919
+ "required": [
920
+ "id",
921
+ "resolution"
922
+ ],
923
+ "additionalProperties": false
924
+ },
925
+ "ErrorEnvelope": {
926
+ "type": "object",
927
+ "required": [
928
+ "error"
929
+ ],
930
+ "properties": {
931
+ "isSuccess": {
932
+ "type": "boolean"
933
+ },
934
+ "error": {
935
+ "type": "object",
936
+ "required": [
937
+ "code",
938
+ "message"
939
+ ],
940
+ "properties": {
941
+ "code": {
942
+ "type": "string",
943
+ "enum": [
944
+ "access_denied",
945
+ "ambiguous_auth",
946
+ "conflict",
947
+ "feature_disabled",
948
+ "idempotent_replay",
949
+ "internal_error",
950
+ "invalid_token",
951
+ "member_read_timeout",
952
+ "missing_token",
953
+ "not_found",
954
+ "pat_rate_limited",
955
+ "precondition_failed",
956
+ "rate_limit_unavailable",
957
+ "rate_limited",
958
+ "record_locked",
959
+ "unauthenticated",
960
+ "unconfigured",
961
+ "unique_violation",
962
+ "unprocessable",
963
+ "validation_error",
964
+ "version_conflict"
965
+ ]
966
+ },
967
+ "httpStatus": {
968
+ "type": "integer"
969
+ },
970
+ "message": {
971
+ "type": "string"
972
+ },
973
+ "details": {
974
+ "type": "object"
975
+ }
976
+ }
977
+ }
978
+ }
979
+ }
980
+ }
981
+ }
982
+ }