@cosmicdrift/kumiko-samples 0.412.0 → 0.413.1

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 (135) 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/api-docs/anchors.ts +1 -1
  5. package/packages/bundled-features/src/auth-email-password/boot-rules.ts +9 -0
  6. package/packages/bundled-features/src/auth-email-password/feature.ts +6 -19
  7. package/packages/bundled-features/src/auth-email-password/validate-options.ts +20 -0
  8. package/packages/bundled-features/src/billing-foundation/boot-rules.ts +26 -0
  9. package/packages/bundled-features/src/billing-foundation/validate-options.ts +59 -46
  10. package/packages/bundled-features/src/cap-overview/boot-rules.ts +14 -0
  11. package/packages/bundled-features/src/cap-overview/feature.ts +12 -5
  12. package/packages/bundled-features/src/data-retention/changes.json +6 -0
  13. package/packages/bundled-features/src/data-retention/feature.ts +3 -2
  14. package/packages/bundled-features/src/documents/boot-rules.ts +14 -0
  15. package/packages/bundled-features/src/documents/feature.ts +8 -4
  16. package/packages/bundled-features/src/file-derivatives/boot-rules.ts +9 -0
  17. package/packages/bundled-features/src/file-derivatives/feature.ts +6 -3
  18. package/packages/bundled-features/src/folders/boot-rules.ts +9 -0
  19. package/packages/bundled-features/src/folders/feature.ts +6 -3
  20. package/packages/bundled-features/src/helpdesk/boot-rules.ts +9 -0
  21. package/packages/bundled-features/src/{contact → helpdesk}/challenge.ts +2 -2
  22. package/packages/bundled-features/src/{contact → helpdesk}/changes.json +18 -0
  23. package/packages/bundled-features/src/{contact/client/contact-client-source.ts → helpdesk/client/helpdesk-client-source.ts} +4 -4
  24. package/packages/bundled-features/src/helpdesk/client/helpdesk-website-client.ts +29 -0
  25. package/packages/bundled-features/src/helpdesk/client/index.ts +9 -0
  26. package/packages/bundled-features/src/{contact → helpdesk}/entity.ts +35 -31
  27. package/packages/bundled-features/src/{contact → helpdesk}/feature.ts +56 -52
  28. package/packages/bundled-features/src/{contact → helpdesk}/handlers/attempts.ts +3 -3
  29. package/packages/bundled-features/src/{contact → helpdesk}/handlers/challenge.query.ts +10 -10
  30. package/packages/bundled-features/src/{contact → helpdesk}/handlers/forward-request.write.ts +25 -23
  31. package/packages/bundled-features/src/{contact → helpdesk}/handlers/mark-done.write.ts +11 -11
  32. package/packages/bundled-features/src/{contact → helpdesk}/handlers/notify-reporter-in-app.write.ts +14 -14
  33. package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.query.ts +4 -4
  34. package/packages/bundled-features/src/{contact → helpdesk}/handlers/open-count.ts +2 -2
  35. package/packages/bundled-features/src/{contact → helpdesk}/handlers/replies.query.ts +6 -6
  36. package/packages/bundled-features/src/{contact → helpdesk}/handlers/reply.write.ts +30 -30
  37. package/packages/bundled-features/src/{contact → helpdesk}/handlers/report.write.ts +29 -29
  38. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-delivery.query.ts +40 -40
  39. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-detail.query.ts +15 -15
  40. package/packages/bundled-features/src/{contact → helpdesk}/handlers/request-list.query.ts +2 -2
  41. package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-reply-mail.write.ts +24 -24
  42. package/packages/bundled-features/src/{contact → helpdesk}/handlers/send-test.write.ts +18 -14
  43. package/packages/bundled-features/src/{contact → helpdesk}/handlers/submit.write.ts +32 -31
  44. package/packages/bundled-features/src/{contact → helpdesk}/handlers/take-over-uploads.ts +5 -5
  45. package/packages/bundled-features/src/{contact → helpdesk}/i18n.ts +78 -75
  46. package/packages/bundled-features/src/helpdesk/index.ts +29 -0
  47. package/packages/bundled-features/src/{contact → helpdesk}/lib.ts +32 -28
  48. package/packages/bundled-features/src/{contact → helpdesk}/mail.ts +56 -56
  49. package/packages/bundled-features/src/{contact → helpdesk}/options.ts +18 -16
  50. package/packages/bundled-features/src/helpdesk/panels.ts +28 -0
  51. package/packages/bundled-features/src/{contact → helpdesk}/payloads.ts +33 -33
  52. package/packages/bundled-features/src/{contact → helpdesk}/screens.ts +104 -104
  53. package/packages/bundled-features/src/{contact → helpdesk}/subject.ts +3 -3
  54. package/packages/bundled-features/src/{contact → helpdesk}/user-data-hooks.ts +17 -17
  55. package/packages/bundled-features/src/helpdesk/web/constants.ts +160 -0
  56. package/packages/bundled-features/src/helpdesk/web/index.ts +29 -0
  57. package/packages/bundled-features/src/host-routing/boot-rules.ts +27 -0
  58. package/packages/bundled-features/src/host-routing/validate-options.ts +36 -27
  59. package/packages/bundled-features/src/jobs/boot-rules.ts +9 -0
  60. package/packages/bundled-features/src/jobs/feature.ts +9 -4
  61. package/packages/bundled-features/src/legal-pages/boot-rules.ts +19 -0
  62. package/packages/bundled-features/src/legal-pages/feature.ts +6 -3
  63. package/packages/bundled-features/src/legal-pages/lib/validate-routes.ts +11 -5
  64. package/packages/bundled-features/src/metrics/boot-rules.ts +15 -0
  65. package/packages/bundled-features/src/metrics/validate.ts +8 -2
  66. package/packages/bundled-features/src/notes-history/boot-rules.ts +9 -0
  67. package/packages/bundled-features/src/notes-history/feature.ts +6 -3
  68. package/packages/bundled-features/src/personal-access-tokens/boot-rules.ts +9 -0
  69. package/packages/bundled-features/src/personal-access-tokens/scope-events-check.ts +6 -3
  70. package/packages/bundled-features/src/presence/boot-rules.ts +9 -0
  71. package/packages/bundled-features/src/presence/options.ts +5 -1
  72. package/packages/bundled-features/src/readiness/boot-rules.ts +14 -0
  73. package/packages/bundled-features/src/readiness/probe-boot-check.ts +8 -6
  74. package/packages/bundled-features/src/shared/assert-no-where-rule-in-ownership-write.ts +6 -4
  75. package/packages/bundled-features/src/shared/boot-rules.ts +9 -0
  76. package/packages/bundled-features/src/subscription-mollie/boot-rules.ts +19 -0
  77. package/packages/bundled-features/src/subscription-mollie/feature.ts +18 -10
  78. package/packages/bundled-features/src/tags/boot-rules.ts +9 -0
  79. package/packages/bundled-features/src/tags/feature.ts +6 -3
  80. package/packages/bundled-features/src/template-resolver/boot-rules.ts +19 -0
  81. package/packages/bundled-features/src/template-resolver/feature.ts +14 -10
  82. package/packages/bundled-features/src/tenant/boot-rules.ts +9 -0
  83. package/packages/bundled-features/src/tenant/feature.ts +5 -3
  84. package/samples/apps/marketing-demo/README.md +1 -1
  85. package/samples/apps/marketing-demo/playwright.config.ts +1 -1
  86. package/samples/apps/marketing-demo/src/app/client.tsx +3 -3
  87. package/samples/apps/marketing-demo/src/app/seed-data.ts +1 -1
  88. package/samples/apps/marketing-demo/src/app/seed.ts +4 -4
  89. package/samples/apps/marketing-demo/src/app/server.ts +3 -3
  90. package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/feature.ts +15 -12
  91. package/samples/apps/marketing-demo/src/features/ticketing/i18n.ts +100 -0
  92. package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/ticket.ts +4 -4
  93. package/samples/apps/marketing-demo/src/features/ticketing/web/index.ts +7 -0
  94. package/samples/apps/use-all-bundled/feature-manifest.json +67 -67
  95. package/samples/apps/use-all-bundled/kumiko/migrations/0064_helpdesk-rename.rebuild.json +4 -0
  96. package/samples/apps/use-all-bundled/package.json +1 -1
  97. package/samples/apps/use-all-bundled/src/app/client.tsx +1 -1
  98. package/samples/apps/use-all-bundled/src/app/screens-feature.ts +10 -10
  99. package/samples/apps/use-all-bundled/src/run-config.ts +6 -6
  100. package/samples/recipes/api-docs/README.md +3 -3
  101. package/samples/recipes/api-docs/api-docs/de/events.md +14 -14
  102. package/samples/recipes/api-docs/api-docs/de/overview.md +3 -3
  103. package/samples/recipes/api-docs/api-docs/de/reference/tickets.md +10 -10
  104. package/samples/recipes/api-docs/api-docs/de/tokens.md +4 -4
  105. package/samples/recipes/api-docs/api-docs/en/events.md +14 -14
  106. package/samples/recipes/api-docs/api-docs/en/overview.md +3 -3
  107. package/samples/recipes/api-docs/api-docs/en/reference/tickets.md +10 -10
  108. package/samples/recipes/api-docs/api-docs/en/tokens.md +4 -4
  109. package/samples/recipes/api-docs/api-docs/index.json +22 -22
  110. package/samples/recipes/api-docs/api-docs/openapi.json +67 -67
  111. package/samples/recipes/api-docs/api-examples/ticket-close.json +1 -1
  112. package/samples/recipes/api-docs/api-examples/ticket-create.json +1 -1
  113. package/samples/recipes/api-docs/api-examples/ticket-detail.json +1 -1
  114. package/samples/recipes/api-docs/api-examples/ticket-list.json +1 -1
  115. package/samples/recipes/api-docs/api-examples/ticket-update.json +1 -1
  116. package/samples/recipes/api-docs/api-examples/webhooks/ticket-closed.json +1 -1
  117. package/samples/recipes/api-docs/kumiko.config.ts +4 -4
  118. package/samples/recipes/api-docs/src/feature.ts +44 -44
  119. package/samples/recipes/golden-path/src/feature.ts +1 -1
  120. package/samples/recipes/helpdesk/README.md +56 -0
  121. package/samples/recipes/{contact → helpdesk}/package.json +2 -2
  122. package/samples/recipes/{contact → helpdesk}/src/feature.ts +11 -8
  123. package/packages/bundled-features/src/contact/client/contact-website-client.ts +0 -29
  124. package/packages/bundled-features/src/contact/client/index.ts +0 -9
  125. package/packages/bundled-features/src/contact/index.ts +0 -29
  126. package/packages/bundled-features/src/contact/panels.ts +0 -28
  127. package/packages/bundled-features/src/contact/web/constants.ts +0 -160
  128. package/packages/bundled-features/src/contact/web/index.ts +0 -29
  129. package/samples/apps/marketing-demo/src/features/helpdesk/i18n.ts +0 -100
  130. package/samples/apps/marketing-demo/src/features/helpdesk/web/index.ts +0 -7
  131. package/samples/recipes/contact/README.md +0 -52
  132. /package/packages/bundled-features/src/{contact → helpdesk}/handlers/access.ts +0 -0
  133. /package/packages/bundled-features/src/{contact → helpdesk}/pow.ts +0 -0
  134. /package/packages/bundled-features/src/{contact → helpdesk}/user-agent.ts +0 -0
  135. /package/samples/apps/marketing-demo/src/features/{helpdesk → ticketing}/schema/index.ts +0 -0
@@ -88,7 +88,7 @@ export const ticketEditScreen: EntityEditScreenDefinition = {
88
88
  layout: {
89
89
  sections: [
90
90
  {
91
- title: "helpdesk:section.ticket",
91
+ title: "ticketing:section.ticket",
92
92
  columns: 2,
93
93
  fields: [
94
94
  { field: "title", span: 2 },
@@ -100,12 +100,12 @@ export const ticketEditScreen: EntityEditScreenDefinition = {
100
100
  ],
101
101
  },
102
102
  {
103
- title: "helpdesk:section.people",
103
+ title: "ticketing:section.people",
104
104
  columns: 2,
105
105
  fields: ["reporter", "assignee"],
106
106
  },
107
107
  {
108
- title: "helpdesk:section.tracking",
108
+ title: "ticketing:section.tracking",
109
109
  columns: 2,
110
110
  fields: ["dueDate", "spentMinutes"],
111
111
  },
@@ -131,6 +131,6 @@ export const ticketListScreen: EntityListScreenDefinition = {
131
131
  pageSize: 25,
132
132
  defaultSort: { field: "severity", dir: "desc" },
133
133
  rowActions: [
134
- { kind: "navigate", id: "edit", label: "helpdesk:actions.edit", screen: "ticket-edit" },
134
+ { kind: "navigate", id: "edit", label: "ticketing:actions.edit", screen: "ticket-edit" },
135
135
  ],
136
136
  };
@@ -0,0 +1,7 @@
1
+ import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
2
+ import { ticketingTranslations } from "../i18n";
3
+
4
+ export const ticketingClient: ClientFeatureDefinition = {
5
+ name: "ticketing",
6
+ translations: ticketingTranslations,
7
+ };
@@ -694,73 +694,6 @@
694
694
  "recommended": true
695
695
  }
696
696
  },
697
- {
698
- "name": "contact",
699
- "description": "Contact inbox: an anonymous browser client (GET /contact/client.js) submits questions, contact requests, bug reports and wishes behind a honeypot, a minimum submit time and a single-use proof-of-work challenge; signed-in users file reports from the admin. Every request is stored platform-wide and every SystemAdmin is notified by mail, optionally also in a Telegram chat (option `telegram`, off by default); the notification names only the kind, the app and a link, never name, address, phone, subject or message, because mail and Telegram cannot be shredded. SystemAdmins reply by mail (Reply-To set, attachments, quoting the original) and mark requests done; a website sender gets a fixed acknowledgement, a signed-in reporter a copy and an in-app note. Personal data is crypto-shredding-ready and the EXT_USER_DATA hooks export and erase a user's requests.",
700
- "toggleableDefault": null,
701
- "adoptsBundledLists": true,
702
- "requires": [
703
- "config",
704
- "delivery",
705
- "user-data-rights",
706
- "files",
707
- "notes-history"
708
- ],
709
- "optionalRequires": [
710
- "channel-telegram"
711
- ],
712
- "configReads": [],
713
- "exposesApis": [],
714
- "usesApis": [],
715
- "extensionsUsed": [
716
- {
717
- "extensionName": "userData",
718
- "entityName": "contact-request"
719
- },
720
- {
721
- "extensionName": "userData",
722
- "entityName": "contact-reply"
723
- }
724
- ],
725
- "configKeys": [
726
- {
727
- "key": "reply-to",
728
- "qualifiedName": "contact:config:reply-to",
729
- "type": "text",
730
- "scope": "system",
731
- "default": "",
732
- "encrypted": false,
733
- "computed": false,
734
- "validated": false,
735
- "options": null,
736
- "bounds": null,
737
- "pattern": {
738
- "regex": "^$|^[^\\s@<>]{1,64}@[^\\s@<>]{1,200}\\.[^\\s@<>]{2,24}$"
739
- },
740
- "writeRoles": [
741
- "SystemAdmin"
742
- ],
743
- "readRoles": [
744
- "SystemAdmin"
745
- ]
746
- }
747
- ],
748
- "secrets": [],
749
- "writeHandlers": [
750
- "contact:write:forward-request",
751
- "contact:write:mark-done",
752
- "contact:write:notify-reporter-in-app",
753
- "contact:write:reply",
754
- "contact:write:report",
755
- "contact:write:send-reply-mail",
756
- "contact:write:submit"
757
- ],
758
- "uiHints": {
759
- "displayLabel": "Contact",
760
- "category": "communication",
761
- "recommended": false
762
- }
763
- },
764
697
  {
765
698
  "name": "crypto-shredding",
766
699
  "description": "Operator-level crypto-shredding trigger. `forget-subject` erases a user or tenant subject key in the configured KMS adapter, making every PII field encrypted under it permanently unreadable (reads render the `[[erased]]` sentinel), and appends a `subject-forgotten` audit event. Requires a KMS adapter (`runProdApp({ kms })`). The automated Art.-17 deletion pipeline in `user-data-rights` erases keys itself; this command covers manual forgets (authority requests, operator recovery, tenant destroy).",
@@ -1466,6 +1399,73 @@
1466
1399
  "secrets": [],
1467
1400
  "writeHandlers": []
1468
1401
  },
1402
+ {
1403
+ "name": "helpdesk",
1404
+ "description": "Helpdesk inbox: an anonymous browser client (GET /helpdesk/client.js) submits questions, contact requests, bug reports and wishes behind a honeypot, a minimum submit time and a single-use proof-of-work challenge; signed-in users file reports from the admin. Every request is stored platform-wide and every SystemAdmin is notified by mail, optionally also in a Telegram chat (option `telegram`, off by default); the notification names only the kind, the app and a link, never name, address, phone, subject or message, because mail and Telegram cannot be shredded. SystemAdmins reply by mail (Reply-To set, attachments, quoting the original) and mark requests done; a website sender gets a fixed acknowledgement, a signed-in reporter a copy and an in-app note. Personal data is crypto-shredding-ready and the EXT_USER_DATA hooks export and erase a user's requests.",
1405
+ "toggleableDefault": null,
1406
+ "adoptsBundledLists": true,
1407
+ "requires": [
1408
+ "config",
1409
+ "delivery",
1410
+ "user-data-rights",
1411
+ "files",
1412
+ "notes-history"
1413
+ ],
1414
+ "optionalRequires": [
1415
+ "channel-telegram"
1416
+ ],
1417
+ "configReads": [],
1418
+ "exposesApis": [],
1419
+ "usesApis": [],
1420
+ "extensionsUsed": [
1421
+ {
1422
+ "extensionName": "userData",
1423
+ "entityName": "helpdesk-request"
1424
+ },
1425
+ {
1426
+ "extensionName": "userData",
1427
+ "entityName": "helpdesk-reply"
1428
+ }
1429
+ ],
1430
+ "configKeys": [
1431
+ {
1432
+ "key": "reply-to",
1433
+ "qualifiedName": "helpdesk:config:reply-to",
1434
+ "type": "text",
1435
+ "scope": "system",
1436
+ "default": "",
1437
+ "encrypted": false,
1438
+ "computed": false,
1439
+ "validated": false,
1440
+ "options": null,
1441
+ "bounds": null,
1442
+ "pattern": {
1443
+ "regex": "^$|^[^\\s@<>]{1,64}@[^\\s@<>]{1,200}\\.[^\\s@<>]{2,24}$"
1444
+ },
1445
+ "writeRoles": [
1446
+ "SystemAdmin"
1447
+ ],
1448
+ "readRoles": [
1449
+ "SystemAdmin"
1450
+ ]
1451
+ }
1452
+ ],
1453
+ "secrets": [],
1454
+ "writeHandlers": [
1455
+ "helpdesk:write:forward-request",
1456
+ "helpdesk:write:mark-done",
1457
+ "helpdesk:write:notify-reporter-in-app",
1458
+ "helpdesk:write:reply",
1459
+ "helpdesk:write:report",
1460
+ "helpdesk:write:send-reply-mail",
1461
+ "helpdesk:write:submit"
1462
+ ],
1463
+ "uiHints": {
1464
+ "displayLabel": "Helpdesk",
1465
+ "category": "communication",
1466
+ "recommended": false
1467
+ }
1468
+ },
1469
1469
  {
1470
1470
  "name": "host-routing",
1471
1471
  "description": "Host- and path-based tenant routing: an authoritative tenant resolver from the subdomain (tenantBy host), a tenant existence check against enabled, active tenants, and the tenant-key query behind createHostDispatch, which picks the HTML file, CSP, locale redirect or 404 per host for runProdApp's hostDispatch.",
@@ -0,0 +1,4 @@
1
+ {
2
+ "version": 1,
3
+ "tables": ["read_helpdesk_replies", "read_helpdesk_requests"]
4
+ }
@@ -11,7 +11,7 @@
11
11
  "screenshots": "bun x playwright test e2e/screenshots.spec.ts --config=playwright.config.ts",
12
12
  "billing-gallery": "bun x playwright test --config=playwright.billing-gallery.config.ts",
13
13
  "docs-guides": "bun x playwright test e2e/docs-guides.screenshots.spec.ts --config=playwright.config.ts && bun x playwright test --config=playwright.billing-docs.config.ts",
14
- "contact-shots": "bun x playwright test e2e/contact.screenshots.spec.ts --config=playwright.config.ts",
14
+ "helpdesk-shots": "bun x playwright test e2e/helpdesk.screenshots.spec.ts --config=playwright.config.ts",
15
15
  "e2e": "bun x playwright test e2e/mfa-login.spec.ts --config=playwright.config.ts",
16
16
  "gen:manifest": "bun run scripts/gen-feature-manifest.ts",
17
17
  "gen:sample-index": "bun run scripts/gen-sample-index.ts"
@@ -120,7 +120,7 @@ createKumikoApp({
120
120
  userProfileClient(),
121
121
  customFieldsClient(),
122
122
  foldersClient(),
123
- // The contact request detail frames its internal notes with the NotesSection extension.
123
+ // The helpdesk request detail frames its internal notes with the NotesSection extension.
124
124
  notesHistoryClient(),
125
125
  inboundMailFoundationClient(),
126
126
  complianceProfilesClient(),
@@ -5,7 +5,7 @@
5
5
  // (#1258): an open screen not reachable via nav is no longer an eligible
6
6
  // fallback candidate.
7
7
 
8
- import { ContactScreens } from "@cosmicdrift/kumiko-bundled-features/contact";
8
+ import { HelpdeskScreens } from "@cosmicdrift/kumiko-bundled-features/helpdesk";
9
9
  import { MAIL_ACCOUNT_LIST_SCREEN_QN } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
10
10
  import {
11
11
  access,
@@ -18,7 +18,7 @@ const PLATFORM_WORKSPACES = ["admin-shell:workspace:platform"] as const;
18
18
 
19
19
  export const appScreensFeature: FeatureDefinition = defineFeature("app-screens", (r) => {
20
20
  r.describe("App-side nav placement for the user-profile self-service page and the mailbox list.");
21
- r.requires({ features: ["user-profile", "inbound-mail-foundation", "contact"] });
21
+ r.requires({ features: ["user-profile", "inbound-mail-foundation", "helpdesk"] });
22
22
  r.nav({
23
23
  id: "profile",
24
24
  label: "screen:profile.title",
@@ -48,19 +48,19 @@ export const appScreensFeature: FeatureDefinition = defineFeature("app-screens",
48
48
  order: 20,
49
49
  });
50
50
  r.nav({
51
- id: "contact-requests",
51
+ id: "helpdesk-requests",
52
52
  label: "screen:request-list.title",
53
53
  icon: "mail",
54
- screen: ContactScreens.requestList,
54
+ screen: HelpdeskScreens.requestList,
55
55
  order: 25,
56
56
  access: { roles: access.systemAdmin },
57
57
  workspaces: PLATFORM_WORKSPACES,
58
58
  });
59
59
  r.nav({
60
- id: "contact-forwarding",
61
- label: "nav:contact-forwarding.title",
60
+ id: "helpdesk-forwarding",
61
+ label: "nav:helpdesk-forwarding.title",
62
62
  icon: "settings",
63
- screen: ContactScreens.forwarding,
63
+ screen: HelpdeskScreens.forwarding,
64
64
  parent: ADMIN_NAV_QN,
65
65
  order: 30,
66
66
  access: { roles: access.systemAdmin },
@@ -74,17 +74,17 @@ export const appScreensFeature: FeatureDefinition = defineFeature("app-screens",
74
74
  workspaces: ADMIN_NAV_WORKSPACES,
75
75
  });
76
76
  r.nav({
77
- id: "contact-report",
77
+ id: "helpdesk-report",
78
78
  label: "screen:report.title",
79
79
  icon: "mail",
80
- screen: ContactScreens.report,
80
+ screen: HelpdeskScreens.report,
81
81
  parent: "app-screens:nav:help",
82
82
  order: 10,
83
83
  workspaces: ADMIN_NAV_WORKSPACES,
84
84
  });
85
85
  r.translations({
86
86
  keys: {
87
- "nav:contact-forwarding.title": { de: "Weiterleitung", en: "Forwarding" },
87
+ "nav:helpdesk-forwarding.title": { de: "Weiterleitung", en: "Forwarding" },
88
88
  "nav:help.title": { de: "Hilfe", en: "Help" },
89
89
  "nav:mail-accounts.title": { de: "Postfächer", en: "Mailboxes" },
90
90
  "screen:profile.title": { de: "Profil", en: "Profile" },
@@ -38,10 +38,6 @@ import { createChannelTeamsFeature } from "@cosmicdrift/kumiko-bundled-features/
38
38
  import { createChannelTelegramFeature } from "@cosmicdrift/kumiko-bundled-features/channel-telegram";
39
39
  import { createComplianceProfilesFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles";
40
40
  import { createComplianceProfilesOpsFeature } from "@cosmicdrift/kumiko-bundled-features/compliance-profiles-ops";
41
- import {
42
- contactOpenRequestsPanels,
43
- createContactFeature,
44
- } from "@cosmicdrift/kumiko-bundled-features/contact";
45
41
  import { createCustomFieldsFeature } from "@cosmicdrift/kumiko-bundled-features/custom-fields";
46
42
  import { createDataRetentionFeature } from "@cosmicdrift/kumiko-bundled-features/data-retention";
47
43
  import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
@@ -58,6 +54,10 @@ import { createFoldersFeature } from "@cosmicdrift/kumiko-bundled-features/folde
58
54
  import { createFoldersUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/folders-user-data";
59
55
  import { createFormDraftFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft";
60
56
  import { createFormDraftUserDataFeature } from "@cosmicdrift/kumiko-bundled-features/form-draft-user-data";
57
+ import {
58
+ createHelpdeskFeature,
59
+ helpdeskOpenRequestsPanels,
60
+ } from "@cosmicdrift/kumiko-bundled-features/helpdesk";
61
61
  import { createHostRoutingFeature } from "@cosmicdrift/kumiko-bundled-features/host-routing";
62
62
  import { createInboundMailFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
63
63
  import { createInboundProviderImapFeature } from "@cosmicdrift/kumiko-bundled-features/inbound-provider-imap";
@@ -314,7 +314,7 @@ export const APP_FEATURES = [
314
314
  // CMS / content
315
315
  createLegalPagesFeature(),
316
316
  createWaitlistFeature(),
317
- createContactFeature({
317
+ createHelpdeskFeature({
318
318
  appName: "publicstatus",
319
319
  appVersion: "2026.10.30",
320
320
  fields: { phone: "optional" },
@@ -410,7 +410,7 @@ export const APP_FEATURES = [
410
410
  createAdminShellFeature({
411
411
  includeCapOverview: true,
412
412
  includeDocumentDesigner: true,
413
- extraPlatformPanels: contactOpenRequestsPanels(),
413
+ extraPlatformPanels: helpdeskOpenRequestsPanels(),
414
414
  }),
415
415
 
416
416
  // app-author-grade
@@ -1,6 +1,6 @@
1
1
  # API docs
2
2
 
3
- API documentation for personal access tokens, generated from the app itself. A helpdesk
3
+ API documentation for personal access tokens, generated from the app itself. A ticketing
4
4
  feature exposes its ticket handlers through token scopes; `kumiko api-docs` turns the
5
5
  registry, the translations and recorded requests into Markdown pages, an OpenAPI file and
6
6
  an `index.json` that a website or an agent can read.
@@ -8,7 +8,7 @@ an `index.json` that a website or an agent can read.
8
8
  ## What it shows
9
9
 
10
10
  - **Scopes decide the content.** Only handlers that a scope of the token feature reaches
11
- appear. `helpdesk:write:ticket:purge` is reachable from a screen but in no scope, so it is
11
+ appear. `ticketing:write:ticket:purge` is reachable from a screen but in no scope, so it is
12
12
  listed under `apiDocs.uiOnlyWrites` with a reason; without that entry the generator reports it.
13
13
  - **Texts come from the feature.** Titles, descriptions and field labels per locale use the
14
14
  keys `<handler qn>:title`, `:description` and `:field:<name>`; the German pages need the
@@ -44,7 +44,7 @@ those two files differ from a real run of the command.
44
44
 
45
45
  ```
46
46
  kumiko.config.ts features and the apiDocs block
47
- src/feature.ts helpdesk feature and the token feature with its scopes
47
+ src/feature.ts ticketing feature and the token feature with its scopes
48
48
  src/__tests__/api-docs.integration.test.ts mints a token, records the examples, checks scope limits
49
49
  src/__tests__/api-docs.golden.test.ts generator output equals api-docs/
50
50
  api-examples/ recorded requests and responses
@@ -15,48 +15,48 @@ Ein neues optionales Feld behält die Version. Eine inkompatible Änderung, etwa
15
15
 
16
16
  ## Ereignisse
17
17
 
18
- ### ticket.closed
18
+ ### ticket.created
19
19
 
20
- Ein Ticket wurde geschlossen und seine Lösung festgehalten.
20
+ Ein Datensatz vom Typ Ticket wurde angelegt.
21
21
 
22
22
  - Version: `1`
23
23
  - Benötigter Scope: `tickets:read`
24
24
 
25
25
  | Feld | Typ | Pflicht | Beschreibung |
26
26
  | --- | --- | --- | --- |
27
- | `id` | string (uuid) | ja | ID des geschlossenen Tickets |
28
- | `resolution` | string | ja | Wie das Ticket gelöst wurde |
27
+ | `id` | string (uuid) | ja | Ticket-ID |
28
+ | `title` | string | ja | Titel |
29
+ | `status` | "open" \| "closed" | ja | Status |
30
+ | `priority` | "low" \| "normal" \| "high" | ja | Priorität |
29
31
 
30
32
  **Beispiel-Nutzlast**
31
33
 
32
34
  ```json
33
35
  {
34
36
  "id": "00000000-0000-4000-8000-000000000001",
35
- "resolution": "Replaced the roller"
37
+ "title": "Scanner jams",
38
+ "status": "open",
39
+ "priority": "low"
36
40
  }
37
41
  ```
38
42
 
39
- ### ticket.created
43
+ ### ticket.closed
40
44
 
41
- Ein Datensatz vom Typ Ticket wurde angelegt.
45
+ Ein Ticket wurde geschlossen und seine Lösung festgehalten.
42
46
 
43
47
  - Version: `1`
44
48
  - Benötigter Scope: `tickets:read`
45
49
 
46
50
  | Feld | Typ | Pflicht | Beschreibung |
47
51
  | --- | --- | --- | --- |
48
- | `id` | string (uuid) | ja | Ticket-ID |
49
- | `title` | string | ja | Titel |
50
- | `status` | "open" \| "closed" | ja | Status |
51
- | `priority` | "low" \| "normal" \| "high" | ja | Priorität |
52
+ | `id` | string (uuid) | ja | ID des geschlossenen Tickets |
53
+ | `resolution` | string | ja | Wie das Ticket gelöst wurde |
52
54
 
53
55
  **Beispiel-Nutzlast**
54
56
 
55
57
  ```json
56
58
  {
57
59
  "id": "00000000-0000-4000-8000-000000000001",
58
- "title": "Scanner jams",
59
- "status": "open",
60
- "priority": "low"
60
+ "resolution": "Replaced the roller"
61
61
  }
62
62
  ```
@@ -19,14 +19,14 @@ Sende einen API-Token im Header `Authorization` als `Bearer <token>`. Anfragen m
19
19
 
20
20
  ## Request-Body
21
21
 
22
- `type` ist der Name des Handlers, zum Beispiel `helpdesk:query:ticket:detail`. `payload` enthält die Felder aus der Referenz. `requestId` ist optional, siehe unten. Das Payload darf höchstens 20 Ebenen tief verschachtelt sein.
22
+ `type` ist der Name des Handlers, zum Beispiel `ticketing:query:ticket:detail`. `payload` enthält die Felder aus der Referenz. `requestId` ist optional, siehe unten. Das Payload darf höchstens 20 Ebenen tief verschachtelt sein.
23
23
 
24
24
  ```bash
25
- curl -X POST https://helpdesk.example.com/api/query \
25
+ curl -X POST https://ticketing.example.com/api/query \
26
26
  -H "Authorization: Bearer $API_TOKEN" \
27
27
  -H "Content-Type: application/json" \
28
28
  -d '{
29
- "type": "helpdesk:query:ticket:detail",
29
+ "type": "ticketing:query:ticket:detail",
30
30
  "payload": {
31
31
  "id": "00000000-0000-4000-8000-000000000001"
32
32
  }
@@ -19,11 +19,11 @@ Liefert ein Ticket.
19
19
  **Beispielanfrage**
20
20
 
21
21
  ```bash
22
- curl -X POST https://helpdesk.example.com/api/query \
22
+ curl -X POST https://ticketing.example.com/api/query \
23
23
  -H "Authorization: Bearer $API_TOKEN" \
24
24
  -H "Content-Type: application/json" \
25
25
  -d '{
26
- "type": "helpdesk:query:ticket:detail",
26
+ "type": "ticketing:query:ticket:detail",
27
27
  "payload": {
28
28
  "id": "00000000-0000-4000-8000-000000000001"
29
29
  }
@@ -84,11 +84,11 @@ Listet Tickets, neueste zuerst.
84
84
  **Beispielanfrage**
85
85
 
86
86
  ```bash
87
- curl -X POST https://helpdesk.example.com/api/query \
87
+ curl -X POST https://ticketing.example.com/api/query \
88
88
  -H "Authorization: Bearer $API_TOKEN" \
89
89
  -H "Content-Type: application/json" \
90
90
  -d '{
91
- "type": "helpdesk:query:ticket:list",
91
+ "type": "ticketing:query:ticket:list",
92
92
  "payload": {}
93
93
  }'
94
94
  ```
@@ -136,11 +136,11 @@ Schließt ein Ticket und hält fest, wie es gelöst wurde.
136
136
  **Beispielanfrage**
137
137
 
138
138
  ```bash
139
- curl -X POST https://helpdesk.example.com/api/write \
139
+ curl -X POST https://ticketing.example.com/api/write \
140
140
  -H "Authorization: Bearer $API_TOKEN" \
141
141
  -H "Content-Type: application/json" \
142
142
  -d '{
143
- "type": "helpdesk:write:ticket:close",
143
+ "type": "ticketing:write:ticket:close",
144
144
  "payload": {
145
145
  "id": "00000000-0000-4000-8000-000000000001",
146
146
  "resolution": "Replaced the cartridge"
@@ -179,11 +179,11 @@ Legt ein neues Ticket an.
179
179
  **Beispielanfrage**
180
180
 
181
181
  ```bash
182
- curl -X POST https://helpdesk.example.com/api/write \
182
+ curl -X POST https://ticketing.example.com/api/write \
183
183
  -H "Authorization: Bearer $API_TOKEN" \
184
184
  -H "Content-Type: application/json" \
185
185
  -d '{
186
- "type": "helpdesk:write:ticket:create",
186
+ "type": "ticketing:write:ticket:create",
187
187
  "payload": {
188
188
  "title": "Printer is on fire",
189
189
  "priority": "high"
@@ -246,11 +246,11 @@ Status: 200
246
246
  **Beispielanfrage**
247
247
 
248
248
  ```bash
249
- curl -X POST https://helpdesk.example.com/api/write \
249
+ curl -X POST https://ticketing.example.com/api/write \
250
250
  -H "Authorization: Bearer $API_TOKEN" \
251
251
  -H "Content-Type: application/json" \
252
252
  -d '{
253
- "type": "helpdesk:write:ticket:update",
253
+ "type": "ticketing:write:ticket:update",
254
254
  "payload": {
255
255
  "id": "00000000-0000-4000-8000-000000000001",
256
256
  "version": 1,
@@ -19,11 +19,11 @@ Ein Token läuft nach 90 Tagen ab, wenn du keinen anderen Ablauf wählst. Mögli
19
19
  Sende den Token im Header `Authorization`. Anfragen mit Token brauchen weder Cookie noch CSRF-Token.
20
20
 
21
21
  ```bash
22
- curl -X POST https://helpdesk.example.com/api/query \
22
+ curl -X POST https://ticketing.example.com/api/query \
23
23
  -H "Authorization: Bearer $API_TOKEN" \
24
24
  -H "Content-Type: application/json" \
25
25
  -d '{
26
- "type": "helpdesk:query:ticket:detail",
26
+ "type": "ticketing:query:ticket:detail",
27
27
  "payload": {
28
28
  "id": "00000000-0000-4000-8000-000000000001"
29
29
  }
@@ -36,8 +36,8 @@ Jeder Scope hat zwei Stufen. `read` erlaubt die lesenden Handler. `write` erlaub
36
36
 
37
37
  | Scope | Berechtigung | Handler |
38
38
  | --- | --- | --- |
39
- | `tickets` (Tickets) | `tickets:read` | `helpdesk:query:ticket:detail`, `helpdesk:query:ticket:list` |
40
- | `tickets` (Tickets) | `tickets:write` | `helpdesk:write:ticket:close`, `helpdesk:write:ticket:create`, `helpdesk:write:ticket:update` |
39
+ | `tickets` (Tickets) | `tickets:read` | `ticketing:query:ticket:detail`, `ticketing:query:ticket:list` |
40
+ | `tickets` (Tickets) | `tickets:write` | `ticketing:write:ticket:close`, `ticketing:write:ticket:create`, `ticketing:write:ticket:update` |
41
41
 
42
42
  ## Ratenbegrenzung
43
43
 
@@ -15,48 +15,48 @@ Adding an optional field keeps the version. A breaking change, such as removing
15
15
 
16
16
  ## Events
17
17
 
18
- ### ticket.closed
18
+ ### ticket.created
19
19
 
20
- A ticket was closed and its resolution recorded.
20
+ A record of type ticket was created.
21
21
 
22
22
  - Version: `1`
23
23
  - Required scope: `tickets:read`
24
24
 
25
25
  | Field | Type | Required | Description |
26
26
  | --- | --- | --- | --- |
27
- | `id` | string (uuid) | yes | ID of the closed ticket |
28
- | `resolution` | string | yes | How the ticket was resolved |
27
+ | `id` | string (uuid) | yes | Ticket ID |
28
+ | `title` | string | yes | Title |
29
+ | `status` | "open" \| "closed" | yes | Status |
30
+ | `priority` | "low" \| "normal" \| "high" | yes | Priority |
29
31
 
30
32
  **Example payload**
31
33
 
32
34
  ```json
33
35
  {
34
36
  "id": "00000000-0000-4000-8000-000000000001",
35
- "resolution": "Replaced the roller"
37
+ "title": "Scanner jams",
38
+ "status": "open",
39
+ "priority": "low"
36
40
  }
37
41
  ```
38
42
 
39
- ### ticket.created
43
+ ### ticket.closed
40
44
 
41
- A record of type ticket was created.
45
+ A ticket was closed and its resolution recorded.
42
46
 
43
47
  - Version: `1`
44
48
  - Required scope: `tickets:read`
45
49
 
46
50
  | Field | Type | Required | Description |
47
51
  | --- | --- | --- | --- |
48
- | `id` | string (uuid) | yes | Ticket ID |
49
- | `title` | string | yes | Title |
50
- | `status` | "open" \| "closed" | yes | Status |
51
- | `priority` | "low" \| "normal" \| "high" | yes | Priority |
52
+ | `id` | string (uuid) | yes | ID of the closed ticket |
53
+ | `resolution` | string | yes | How the ticket was resolved |
52
54
 
53
55
  **Example payload**
54
56
 
55
57
  ```json
56
58
  {
57
59
  "id": "00000000-0000-4000-8000-000000000001",
58
- "title": "Scanner jams",
59
- "status": "open",
60
- "priority": "low"
60
+ "resolution": "Replaced the roller"
61
61
  }
62
62
  ```
@@ -19,14 +19,14 @@ Send an API token in the `Authorization` header as `Bearer <token>`. Requests wi
19
19
 
20
20
  ## Request body
21
21
 
22
- `type` is the handler name, for example `helpdesk:query:ticket:detail`. `payload` holds the fields from the reference. `requestId` is optional, see below. The payload may be nested at most 20 levels deep.
22
+ `type` is the handler name, for example `ticketing:query:ticket:detail`. `payload` holds the fields from the reference. `requestId` is optional, see below. The payload may be nested at most 20 levels deep.
23
23
 
24
24
  ```bash
25
- curl -X POST https://helpdesk.example.com/api/query \
25
+ curl -X POST https://ticketing.example.com/api/query \
26
26
  -H "Authorization: Bearer $API_TOKEN" \
27
27
  -H "Content-Type: application/json" \
28
28
  -d '{
29
- "type": "helpdesk:query:ticket:detail",
29
+ "type": "ticketing:query:ticket:detail",
30
30
  "payload": {
31
31
  "id": "00000000-0000-4000-8000-000000000001"
32
32
  }