@cosmicdrift/kumiko-samples 0.411.0 → 0.412.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 (73) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +1 -1
  3. package/packages/bundled-features/src/agent-tools/agent-doc-lint.ts +64 -3
  4. package/packages/bundled-features/src/agent-tools/agent-manifest.ts +13 -130
  5. package/packages/bundled-features/src/agent-tools/api-docs/anchors.ts +60 -0
  6. package/packages/bundled-features/src/agent-tools/api-docs/check.ts +25 -0
  7. package/packages/bundled-features/src/agent-tools/api-docs/collect-events.ts +140 -0
  8. package/packages/bundled-features/src/agent-tools/api-docs/collect.ts +175 -0
  9. package/packages/bundled-features/src/agent-tools/api-docs/curl.ts +28 -0
  10. package/packages/bundled-features/src/agent-tools/api-docs/error-table.ts +45 -0
  11. package/packages/bundled-features/src/agent-tools/api-docs/examples.ts +43 -0
  12. package/packages/bundled-features/src/agent-tools/api-docs/generate.ts +179 -0
  13. package/packages/bundled-features/src/agent-tools/api-docs/index-json.ts +29 -0
  14. package/packages/bundled-features/src/agent-tools/api-docs/index.ts +21 -0
  15. package/packages/bundled-features/src/agent-tools/api-docs/list-parameters.ts +38 -0
  16. package/packages/bundled-features/src/agent-tools/api-docs/markdown.ts +70 -0
  17. package/packages/bundled-features/src/agent-tools/api-docs/menu-path.ts +82 -0
  18. package/packages/bundled-features/src/agent-tools/api-docs/model.ts +83 -0
  19. package/packages/bundled-features/src/agent-tools/api-docs/problems.ts +58 -0
  20. package/packages/bundled-features/src/agent-tools/api-docs/render-events.ts +76 -0
  21. package/packages/bundled-features/src/agent-tools/api-docs/render-openapi.ts +216 -0
  22. package/packages/bundled-features/src/agent-tools/api-docs/render-overview.ts +86 -0
  23. package/packages/bundled-features/src/agent-tools/api-docs/render-reference.ts +79 -0
  24. package/packages/bundled-features/src/agent-tools/api-docs/render-tokens.ts +136 -0
  25. package/packages/bundled-features/src/agent-tools/api-docs/schema-fields.ts +167 -0
  26. package/packages/bundled-features/src/agent-tools/api-docs/section-ids.ts +28 -0
  27. package/packages/bundled-features/src/agent-tools/api-docs/system-only.ts +11 -0
  28. package/packages/bundled-features/src/agent-tools/api-docs/texts/de.ts +166 -0
  29. package/packages/bundled-features/src/agent-tools/api-docs/texts/en.ts +159 -0
  30. package/packages/bundled-features/src/agent-tools/api-docs/texts/es.ts +162 -0
  31. package/packages/bundled-features/src/agent-tools/api-docs/texts/fr.ts +169 -0
  32. package/packages/bundled-features/src/agent-tools/api-docs/texts/index.ts +67 -0
  33. package/packages/bundled-features/src/agent-tools/api-docs/texts/it.ts +165 -0
  34. package/packages/bundled-features/src/agent-tools/api-docs/texts/types.ts +130 -0
  35. package/packages/bundled-features/src/agent-tools/api-docs/ui-writes.ts +81 -0
  36. package/packages/bundled-features/src/agent-tools/changes.json +24 -0
  37. package/packages/bundled-features/src/agent-tools/handler-schema.ts +45 -0
  38. package/packages/bundled-features/src/agent-tools/index.ts +24 -0
  39. package/packages/bundled-features/src/agent-tools/labels.ts +181 -0
  40. package/packages/bundled-features/src/inbound-mail-foundation/changes.json +6 -0
  41. package/packages/bundled-features/src/inbound-mail-foundation/entities.ts +99 -71
  42. package/packages/bundled-features/src/inbound-mail-foundation/feature.ts +2 -2
  43. package/packages/bundled-features/src/personal-access-tokens/changes.json +6 -0
  44. package/packages/bundled-features/src/personal-access-tokens/feature.ts +5 -2
  45. package/packages/bundled-features/src/personal-access-tokens/handlers/create.write.ts +7 -2
  46. package/packages/bundled-features/src/personal-access-tokens/i18n.ts +6 -1
  47. package/packages/bundled-features/src/personal-access-tokens/index.ts +37 -2
  48. package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +28 -0
  49. package/packages/bundled-features/src/personal-access-tokens/screens.ts +9 -1
  50. package/packages/bundled-features/src/personal-access-tokens/web/constants.ts +1 -0
  51. package/packages/bundled-features/src/personal-access-tokens/web/scopes.ts +14 -0
  52. package/samples/recipes/api-docs/README.md +52 -0
  53. package/samples/recipes/api-docs/api-docs/de/events.md +62 -0
  54. package/samples/recipes/api-docs/api-docs/de/overview.md +100 -0
  55. package/samples/recipes/api-docs/api-docs/de/reference/tickets.md +305 -0
  56. package/samples/recipes/api-docs/api-docs/de/tokens.md +66 -0
  57. package/samples/recipes/api-docs/api-docs/en/events.md +62 -0
  58. package/samples/recipes/api-docs/api-docs/en/overview.md +100 -0
  59. package/samples/recipes/api-docs/api-docs/en/reference/tickets.md +305 -0
  60. package/samples/recipes/api-docs/api-docs/en/tokens.md +66 -0
  61. package/samples/recipes/api-docs/api-docs/index.json +371 -0
  62. package/samples/recipes/api-docs/api-docs/openapi.json +982 -0
  63. package/samples/recipes/api-docs/api-examples/ticket-close.json +21 -0
  64. package/samples/recipes/api-docs/api-examples/ticket-create.json +42 -0
  65. package/samples/recipes/api-docs/api-examples/ticket-detail.json +28 -0
  66. package/samples/recipes/api-docs/api-examples/ticket-list.json +31 -0
  67. package/samples/recipes/api-docs/api-examples/ticket-update.json +54 -0
  68. package/samples/recipes/api-docs/api-examples/webhooks/ticket-closed.json +8 -0
  69. package/samples/recipes/api-docs/api-examples/webhooks/ticket-created.json +10 -0
  70. package/samples/recipes/api-docs/kumiko.config.ts +33 -0
  71. package/samples/recipes/api-docs/package.json +14 -0
  72. package/samples/recipes/api-docs/src/feature.ts +218 -0
  73. package/samples/recipes/api-docs/tsconfig.json +22 -0
@@ -0,0 +1,21 @@
1
+ {
2
+ "request": {
3
+ "endpoint": "/api/write",
4
+ "body": {
5
+ "type": "helpdesk:write:ticket:close",
6
+ "payload": {
7
+ "id": "00000000-0000-4000-8000-000000000001",
8
+ "resolution": "Replaced the cartridge"
9
+ }
10
+ }
11
+ },
12
+ "response": {
13
+ "status": 200,
14
+ "body": {
15
+ "isSuccess": true,
16
+ "data": {
17
+ "id": "00000000-0000-4000-8000-000000000001"
18
+ }
19
+ }
20
+ }
21
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "request": {
3
+ "endpoint": "/api/write",
4
+ "body": {
5
+ "type": "helpdesk:write:ticket:create",
6
+ "payload": {
7
+ "title": "Printer is on fire",
8
+ "priority": "high"
9
+ }
10
+ }
11
+ },
12
+ "response": {
13
+ "status": 200,
14
+ "body": {
15
+ "isSuccess": true,
16
+ "data": {
17
+ "kind": "save",
18
+ "id": "00000000-0000-4000-8000-000000000001",
19
+ "data": {
20
+ "id": "00000000-0000-4000-8000-000000000001",
21
+ "tenantId": "00000000-0000-4000-8000-000000000002",
22
+ "version": 1,
23
+ "insertedAt": "2026-01-15T09:30:00.000Z",
24
+ "modifiedAt": null,
25
+ "insertedById": "00000000-0000-4000-8000-000000000003",
26
+ "modifiedById": null,
27
+ "title": "Printer is on fire",
28
+ "status": "open",
29
+ "priority": "high"
30
+ },
31
+ "changes": {
32
+ "title": "Printer is on fire",
33
+ "status": "open",
34
+ "priority": "high"
35
+ },
36
+ "previous": {},
37
+ "isNew": true,
38
+ "entityName": "ticket"
39
+ }
40
+ }
41
+ }
42
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "request": {
3
+ "endpoint": "/api/query",
4
+ "body": {
5
+ "type": "helpdesk:query:ticket:detail",
6
+ "payload": {
7
+ "id": "00000000-0000-4000-8000-000000000001"
8
+ }
9
+ }
10
+ },
11
+ "response": {
12
+ "status": 200,
13
+ "body": {
14
+ "data": {
15
+ "id": "00000000-0000-4000-8000-000000000001",
16
+ "tenantId": "00000000-0000-4000-8000-000000000002",
17
+ "version": 1,
18
+ "insertedAt": "2026-01-15T09:30:00.000Z",
19
+ "modifiedAt": null,
20
+ "insertedById": "00000000-0000-4000-8000-000000000003",
21
+ "modifiedById": null,
22
+ "title": "Printer is on fire",
23
+ "status": "open",
24
+ "priority": "high"
25
+ }
26
+ }
27
+ }
28
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "request": {
3
+ "endpoint": "/api/query",
4
+ "body": {
5
+ "type": "helpdesk:query:ticket:list",
6
+ "payload": {}
7
+ }
8
+ },
9
+ "response": {
10
+ "status": 200,
11
+ "body": {
12
+ "data": {
13
+ "rows": [
14
+ {
15
+ "id": "00000000-0000-4000-8000-000000000001",
16
+ "tenantId": "00000000-0000-4000-8000-000000000002",
17
+ "version": 1,
18
+ "insertedAt": "2026-01-15T09:30:00.000Z",
19
+ "modifiedAt": null,
20
+ "insertedById": "00000000-0000-4000-8000-000000000003",
21
+ "modifiedById": null,
22
+ "title": "Printer is on fire",
23
+ "status": "open",
24
+ "priority": "high"
25
+ }
26
+ ],
27
+ "nextCursor": null
28
+ }
29
+ }
30
+ }
31
+ }
@@ -0,0 +1,54 @@
1
+ {
2
+ "request": {
3
+ "endpoint": "/api/write",
4
+ "body": {
5
+ "type": "helpdesk:write:ticket:update",
6
+ "payload": {
7
+ "id": "00000000-0000-4000-8000-000000000001",
8
+ "version": 1,
9
+ "changes": {
10
+ "priority": "normal"
11
+ }
12
+ }
13
+ }
14
+ },
15
+ "response": {
16
+ "status": 200,
17
+ "body": {
18
+ "isSuccess": true,
19
+ "data": {
20
+ "kind": "save",
21
+ "id": "00000000-0000-4000-8000-000000000001",
22
+ "data": {
23
+ "id": "00000000-0000-4000-8000-000000000001",
24
+ "tenantId": "00000000-0000-4000-8000-000000000002",
25
+ "version": 2,
26
+ "insertedAt": "2026-01-15T09:30:00.000Z",
27
+ "modifiedAt": "2026-01-15T09:30:00.000Z",
28
+ "insertedById": "00000000-0000-4000-8000-000000000003",
29
+ "modifiedById": "00000000-0000-4000-8000-000000000003",
30
+ "title": "Printer is on fire",
31
+ "status": "open",
32
+ "priority": "normal"
33
+ },
34
+ "changes": {
35
+ "priority": "normal"
36
+ },
37
+ "previous": {
38
+ "id": "00000000-0000-4000-8000-000000000001",
39
+ "tenantId": "00000000-0000-4000-8000-000000000002",
40
+ "version": 1,
41
+ "insertedAt": "2026-01-15T09:30:00.000Z",
42
+ "modifiedAt": null,
43
+ "insertedById": "00000000-0000-4000-8000-000000000003",
44
+ "modifiedById": null,
45
+ "title": "Printer is on fire",
46
+ "status": "open",
47
+ "priority": "high"
48
+ },
49
+ "isNew": false,
50
+ "entityName": "ticket"
51
+ }
52
+ }
53
+ }
54
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "event": "helpdesk:ticket-closed",
3
+ "version": 1,
4
+ "payload": {
5
+ "id": "00000000-0000-4000-8000-000000000001",
6
+ "resolution": "Replaced the roller"
7
+ }
8
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "event": "ticket.created",
3
+ "version": 1,
4
+ "payload": {
5
+ "id": "00000000-0000-4000-8000-000000000001",
6
+ "title": "Scanner jams",
7
+ "status": "open",
8
+ "priority": "low"
9
+ }
10
+ }
@@ -0,0 +1,33 @@
1
+ import { createAuthFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
2
+ import { defineAppConfig } from "@cosmicdrift/kumiko-framework/config";
3
+ import { localeDe } from "@cosmicdrift/kumiko-locale-de";
4
+ import { helpdeskFeature, patFeature } from "./src/feature";
5
+
6
+ const PURGE_REASON =
7
+ "Purging is an admin chore that stays in the app and is never offered to API clients.";
8
+
9
+ export default defineAppConfig({
10
+ features: [createAuthFoundationFeature(), helpdeskFeature, patFeature(), localeDe()],
11
+ includeBundled: true,
12
+ client: { entries: ["src/client.tsx"] },
13
+ ports: { dev: 4520, e2e: 4521, infra: { postgres: 15520 } },
14
+ apiDocs: {
15
+ appName: "Helpdesk",
16
+ baseUrl: "https://helpdesk.example.com",
17
+ locales: ["en", "de"],
18
+ planNote: {
19
+ en: "API tokens are included in every Helpdesk plan.",
20
+ de: "API-Tokens sind in jedem Helpdesk-Tarif enthalten.",
21
+ },
22
+ webhookDelivery: {
23
+ en: "Deliveries are signed so that you can verify the sender. A delivery that fails is retried a few times before it is dropped. Answer within a few seconds and treat repeated deliveries of the same event as one.",
24
+ de: "Zustellungen sind signiert, damit du den Absender prüfen kannst. Eine fehlgeschlagene Zustellung wird einige Male wiederholt, bevor sie verworfen wird. Antworte innerhalb weniger Sekunden und behandle wiederholte Zustellungen desselben Ereignisses als eine.",
25
+ },
26
+ uiOnlyWrites: [
27
+ {
28
+ pattern: "helpdesk:write:ticket:purge",
29
+ reason: PURGE_REASON,
30
+ },
31
+ ],
32
+ },
33
+ });
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "@cosmicdrift/kumiko-sample-api-docs",
3
+ "description": "API documentation for personal access tokens: recorded examples, kumiko api-docs and a committed golden.",
4
+ "private": true,
5
+ "dependencies": {
6
+ "@cosmicdrift/kumiko-bundled-features": "workspace:*",
7
+ "@cosmicdrift/kumiko-framework": "workspace:*",
8
+ "@cosmicdrift/kumiko-locale-de": "workspace:*",
9
+ "@cosmicdrift/kumiko-server-runtime": "workspace:*"
10
+ },
11
+ "devDependencies": {
12
+ "@cosmicdrift/kumiko-testing": "workspace:*"
13
+ }
14
+ }
@@ -0,0 +1,218 @@
1
+ // API docs sample: a helpdesk whose ticket handlers are reachable with a personal access token.
2
+ // Every handler a token scope reaches needs a description and, per locale, a title, description
3
+ // and field labels; `kumiko api-docs` turns them into the pages under api-docs/.
4
+
5
+ import { createPersonalAccessTokensFeature } from "@cosmicdrift/kumiko-bundled-features/personal-access-tokens";
6
+ import {
7
+ createEntity,
8
+ createEntityExecutor,
9
+ createSelectField,
10
+ createTextField,
11
+ defineFeature,
12
+ emitEvent,
13
+ setFields,
14
+ } from "@cosmicdrift/kumiko-framework/engine";
15
+ import { failNotFound, failUnprocessable } from "@cosmicdrift/kumiko-framework/errors";
16
+ import { z } from "zod";
17
+
18
+ export const ticketEntity = createEntity({
19
+ table: "read_api_docs_tickets",
20
+ webhookEvents: true,
21
+ description: "A support request with a title, a priority and an open or closed status.",
22
+ fields: {
23
+ title: createTextField({ personal: false, reason: "is_business_data", required: true }),
24
+ status: createSelectField({ options: ["open", "closed"] as const, default: "open" }),
25
+ priority: createSelectField({ options: ["low", "normal", "high"] as const, default: "normal" }),
26
+ },
27
+ });
28
+
29
+ const ticketAccess = { roles: ["Admin", "User"] } as const;
30
+
31
+ export const helpdeskFeature = defineFeature("helpdesk", (r) => {
32
+ const { table: ticketTable, executor: ticketExecutor } = createEntityExecutor(
33
+ "ticket",
34
+ ticketEntity,
35
+ );
36
+
37
+ r.crud("ticket", ticketEntity, {
38
+ write: { access: ticketAccess },
39
+ read: { access: ticketAccess },
40
+ verbs: { delete: false },
41
+ descriptions: {
42
+ create: "Opens a new ticket.",
43
+ update: "Changes the title or the priority of a ticket.",
44
+ list: "Lists tickets, newest first.",
45
+ detail: "Returns one ticket.",
46
+ },
47
+ });
48
+
49
+ const ticketClosed = r.defineEvent("ticket-closed", z.object({ resolution: z.string().min(1) }), {
50
+ piiFields: "none",
51
+ });
52
+
53
+ r.defineWebhookEvent({
54
+ name: "ticket-closed",
55
+ wireName: "ticket.closed",
56
+ description: "A ticket was closed and its resolution recorded.",
57
+ payload: z.object({
58
+ id: z.uuid().describe("ID of the closed ticket"),
59
+ resolution: z.string().describe("How the ticket was resolved"),
60
+ }),
61
+ version: 1,
62
+ });
63
+
64
+ r.writeHandler({
65
+ name: "ticket:close",
66
+ description: "Closes a ticket and records how it was resolved.",
67
+ schema: z.object({ id: z.uuid(), resolution: z.string().min(1) }),
68
+ access: ticketAccess,
69
+ handler: async (event, ctx) => {
70
+ const ticket = await ticketExecutor.detail({ id: event.payload.id }, event.user, ctx.db);
71
+ if (!ticket) return failNotFound("ticket", event.payload.id);
72
+ if (ticket["status"] === "closed") return failUnprocessable("ticket_already_closed");
73
+ await emitEvent(ctx, ticketClosed, {
74
+ aggregateId: event.payload.id,
75
+ aggregateType: "ticket",
76
+ payload: { resolution: event.payload.resolution },
77
+ });
78
+ return { isSuccess: true as const, data: { id: event.payload.id } };
79
+ },
80
+ });
81
+
82
+ // Reachable from a screen but deliberately outside every token scope: see uiOnlyWrites in kumiko.config.ts.
83
+ r.writeHandler({
84
+ name: "ticket:purge",
85
+ description: "Removes tickets that were closed long ago.",
86
+ schema: z.object({ olderThanDays: z.number().int().min(30) }),
87
+ access: { roles: ["Admin"] },
88
+ handler: async () => ({ isSuccess: true as const, data: { purged: 0 } }),
89
+ });
90
+
91
+ const markTicketClosed = setFields(ticketTable, { status: "closed" });
92
+ r.projection({
93
+ name: "ticket-status",
94
+ source: "ticket",
95
+ table: ticketTable,
96
+ apply: { [ticketClosed.name]: (event, tx, ctx) => markTicketClosed(event, tx, ctx) },
97
+ });
98
+
99
+ r.screen({
100
+ id: "ticket-list",
101
+ type: "entityList",
102
+ entity: "ticket",
103
+ columns: ["title", "status", "priority"],
104
+ });
105
+ r.screen({
106
+ id: "ticket-edit",
107
+ type: "entityEdit",
108
+ entity: "ticket",
109
+ layout: { sections: [{ title: "helpdesk:section.ticket", fields: ["title", "priority"] }] },
110
+ });
111
+ r.screen({
112
+ id: "close-ticket",
113
+ type: "actionForm",
114
+ handler: "helpdesk:write:ticket:close",
115
+ fields: { resolution: createTextField({ personal: false, reason: "is_business_data" }) },
116
+ layout: { sections: [{ title: "helpdesk:section.close", fields: ["resolution"] }] },
117
+ });
118
+ r.screen({
119
+ id: "purge-tickets",
120
+ type: "actionForm",
121
+ handler: "helpdesk:write:ticket:purge",
122
+ fields: {},
123
+ layout: { sections: [] },
124
+ });
125
+
126
+ r.nav({ id: "tickets", label: "helpdesk:nav:tickets", screen: "helpdesk:screen:ticket-list" });
127
+ r.nav({ id: "settings", label: "helpdesk:nav:settings" });
128
+ r.nav({
129
+ id: "api-tokens",
130
+ label: "helpdesk:nav:api-tokens",
131
+ parent: "helpdesk:nav:settings",
132
+ screen: "personal-access-tokens:screen:api-tokens",
133
+ });
134
+
135
+ r.translations({
136
+ keys: {
137
+ "helpdesk:nav:tickets": { en: "Tickets", de: "Tickets" },
138
+ "helpdesk:nav:settings": { en: "Settings", de: "Einstellungen" },
139
+ "helpdesk:nav:api-tokens": { en: "API tokens", de: "API-Tokens" },
140
+ "helpdesk:section.ticket": { en: "Ticket", de: "Ticket" },
141
+ "helpdesk:section.close": { en: "Close ticket", de: "Ticket schließen" },
142
+ "helpdesk:entity:ticket:field:title": { en: "Title", de: "Titel" },
143
+ "helpdesk:entity:ticket:field:status": { en: "Status", de: "Status" },
144
+ "helpdesk:entity:ticket:field:priority": { en: "Priority", de: "Priorität" },
145
+ "helpdesk:write:ticket:create:title": { en: "Create ticket", de: "Ticket anlegen" },
146
+ "helpdesk:write:ticket:create:description": {
147
+ en: "Opens a new ticket.",
148
+ de: "Legt ein neues Ticket an.",
149
+ },
150
+ "helpdesk:write:ticket:update:title": { en: "Update ticket", de: "Ticket ändern" },
151
+ "helpdesk:write:ticket:update:description": {
152
+ en: "Changes the title or the priority of a ticket.",
153
+ de: "Ändert Titel oder Priorität eines Tickets.",
154
+ },
155
+ "helpdesk:query:ticket:list:title": { en: "List tickets", de: "Tickets auflisten" },
156
+ "helpdesk:query:ticket:list:description": {
157
+ en: "Lists tickets, newest first.",
158
+ de: "Listet Tickets, neueste zuerst.",
159
+ },
160
+ "helpdesk:query:ticket:detail:title": { en: "Show ticket", de: "Ticket anzeigen" },
161
+ "helpdesk:query:ticket:detail:description": {
162
+ en: "Returns one ticket.",
163
+ de: "Liefert ein Ticket.",
164
+ },
165
+ "helpdesk:write:ticket:close:title": { en: "Close ticket", de: "Ticket schließen" },
166
+ "helpdesk:write:ticket:close:description": {
167
+ en: "Closes a ticket and records how it was resolved.",
168
+ de: "Schließt ein Ticket und hält fest, wie es gelöst wurde.",
169
+ },
170
+ "helpdesk:write:ticket:close:field:id": { en: "Ticket", de: "Ticket" },
171
+ "helpdesk:write:ticket:close:field:resolution": { en: "Resolution", de: "Lösung" },
172
+ "helpdesk:write:ticket:purge:title": { en: "Purge tickets", de: "Tickets bereinigen" },
173
+ "helpdesk:write:ticket:purge:description": {
174
+ en: "Removes tickets that were closed long ago.",
175
+ de: "Entfernt Tickets, die lange geschlossen sind.",
176
+ },
177
+ "helpdesk:write:ticket:purge:field:olderThanDays": {
178
+ en: "Closed longer than (days)",
179
+ de: "Länger geschlossen als (Tage)",
180
+ },
181
+ "helpdesk:entity:ticket": { en: "ticket", de: "Ticket" },
182
+ "helpdesk:entity:ticket:field:id": { en: "Ticket ID", de: "Ticket-ID" },
183
+ "helpdesk:webhook:ticket-closed:description": {
184
+ en: "A ticket was closed and its resolution recorded.",
185
+ de: "Ein Ticket wurde geschlossen und seine Lösung festgehalten.",
186
+ },
187
+ "helpdesk:webhook:ticket-closed:field:id": {
188
+ en: "ID of the closed ticket",
189
+ de: "ID des geschlossenen Tickets",
190
+ },
191
+ "helpdesk:webhook:ticket-closed:field:resolution": {
192
+ en: "How the ticket was resolved",
193
+ de: "Wie das Ticket gelöst wurde",
194
+ },
195
+ "helpdesk:entity:__action-form__:field:resolution": { en: "Resolution", de: "Lösung" },
196
+ },
197
+ });
198
+ });
199
+
200
+ export const PAT_RATE_LIMIT = { maxRequests: 60, windowMs: 60_000 } as const;
201
+
202
+ export function patFeature() {
203
+ return createPersonalAccessTokensFeature({
204
+ scopes: {
205
+ tickets: {
206
+ label: "Tickets",
207
+ events: ["ticket.created", "helpdesk:ticket-closed"],
208
+ read: ["helpdesk:query:ticket:*"],
209
+ write: [
210
+ "helpdesk:write:ticket:create",
211
+ "helpdesk:write:ticket:update",
212
+ "helpdesk:write:ticket:close",
213
+ ],
214
+ },
215
+ },
216
+ rateLimit: PAT_RATE_LIMIT,
217
+ });
218
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "extends": "../../../tsconfig.json",
3
+ "compilerOptions": {
4
+ "paths": {
5
+ "@cosmicdrift/kumiko-framework/*": [
6
+ "../../../packages/framework/src/*/index.ts"
7
+ ],
8
+ "@cosmicdrift/kumiko-bundled-features/*": [
9
+ "../../../packages/bundled-features/src/*/index.ts"
10
+ ],
11
+ "@cosmicdrift/kumiko-dev-server": [
12
+ "../../../packages/dev-server/src/index.ts"
13
+ ],
14
+ "@cosmicdrift/kumiko-dev-server/*": ["../../../packages/dev-server/src/*"]
15
+ },
16
+ "noEmit": true,
17
+ "rootDir": "../../..",
18
+ "lib": ["ESNext", "DOM", "DOM.Iterable"],
19
+ "types": ["bun-types"]
20
+ },
21
+ "include": ["./src", "./kumiko.config.ts"]
22
+ }