@cosmicdrift/kumiko-bundled-features 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 (255) hide show
  1. package/dist/admin-shell/feature.d.ts +1 -1
  2. package/dist/agent-tools/agent-doc-lint.d.ts +9 -0
  3. package/dist/agent-tools/agent-doc-lint.js +42 -5
  4. package/dist/agent-tools/agent-manifest.d.ts +0 -1
  5. package/dist/agent-tools/agent-manifest.js +9 -99
  6. package/dist/agent-tools/api-docs/anchors.d.ts +14 -0
  7. package/dist/agent-tools/api-docs/anchors.js +49 -0
  8. package/dist/agent-tools/api-docs/check.d.ts +7 -0
  9. package/dist/agent-tools/api-docs/check.js +15 -0
  10. package/dist/agent-tools/api-docs/collect-events.d.ts +10 -0
  11. package/dist/agent-tools/api-docs/collect-events.js +90 -0
  12. package/dist/agent-tools/api-docs/collect.d.ts +15 -0
  13. package/dist/agent-tools/api-docs/collect.js +108 -0
  14. package/dist/agent-tools/api-docs/curl.d.ts +5 -0
  15. package/dist/agent-tools/api-docs/curl.js +24 -0
  16. package/dist/agent-tools/api-docs/error-table.d.ts +9 -0
  17. package/dist/agent-tools/api-docs/error-table.js +31 -0
  18. package/dist/agent-tools/api-docs/examples.d.ts +16 -0
  19. package/dist/agent-tools/api-docs/examples.js +25 -0
  20. package/dist/agent-tools/api-docs/generate.d.ts +19 -0
  21. package/dist/agent-tools/api-docs/generate.js +104 -0
  22. package/dist/agent-tools/api-docs/index-json.d.ts +15 -0
  23. package/dist/agent-tools/api-docs/index-json.js +6 -0
  24. package/dist/agent-tools/api-docs/index.d.ts +9 -0
  25. package/dist/agent-tools/api-docs/index.js +6 -0
  26. package/dist/agent-tools/api-docs/list-parameters.d.ts +61 -0
  27. package/dist/agent-tools/api-docs/list-parameters.js +28 -0
  28. package/dist/agent-tools/api-docs/markdown.d.ts +29 -0
  29. package/dist/agent-tools/api-docs/markdown.js +48 -0
  30. package/dist/agent-tools/api-docs/menu-path.d.ts +8 -0
  31. package/dist/agent-tools/api-docs/menu-path.js +60 -0
  32. package/dist/agent-tools/api-docs/model.d.ts +76 -0
  33. package/dist/agent-tools/api-docs/problems.d.ts +32 -0
  34. package/dist/agent-tools/api-docs/problems.js +28 -0
  35. package/dist/agent-tools/api-docs/render-events.d.ts +12 -0
  36. package/dist/agent-tools/api-docs/render-events.js +55 -0
  37. package/dist/agent-tools/api-docs/render-openapi.d.ts +10 -0
  38. package/dist/agent-tools/api-docs/render-openapi.js +170 -0
  39. package/dist/agent-tools/api-docs/render-overview.d.ts +11 -0
  40. package/dist/agent-tools/api-docs/render-overview.js +60 -0
  41. package/dist/agent-tools/api-docs/render-reference.d.ts +14 -0
  42. package/dist/agent-tools/api-docs/render-reference.js +50 -0
  43. package/dist/agent-tools/api-docs/render-tokens.d.ts +12 -0
  44. package/dist/agent-tools/api-docs/render-tokens.js +101 -0
  45. package/dist/agent-tools/api-docs/schema-fields.d.ts +16 -0
  46. package/dist/agent-tools/api-docs/schema-fields.js +141 -0
  47. package/dist/agent-tools/api-docs/section-ids.d.ts +25 -0
  48. package/dist/agent-tools/api-docs/section-ids.js +26 -0
  49. package/dist/agent-tools/api-docs/system-only.d.ts +5 -0
  50. package/dist/agent-tools/api-docs/system-only.js +7 -0
  51. package/dist/agent-tools/api-docs/texts/de.d.ts +123 -0
  52. package/dist/agent-tools/api-docs/texts/de.js +123 -0
  53. package/dist/agent-tools/api-docs/texts/en.d.ts +123 -0
  54. package/dist/agent-tools/api-docs/texts/en.js +123 -0
  55. package/dist/agent-tools/api-docs/texts/es.d.ts +123 -0
  56. package/dist/agent-tools/api-docs/texts/es.js +123 -0
  57. package/dist/agent-tools/api-docs/texts/fr.d.ts +123 -0
  58. package/dist/agent-tools/api-docs/texts/fr.js +123 -0
  59. package/dist/agent-tools/api-docs/texts/index.d.ts +14 -0
  60. package/dist/agent-tools/api-docs/texts/index.js +55 -0
  61. package/dist/agent-tools/api-docs/texts/it.d.ts +123 -0
  62. package/dist/agent-tools/api-docs/texts/it.js +123 -0
  63. package/dist/agent-tools/api-docs/texts/types.d.ts +18 -0
  64. package/dist/agent-tools/api-docs/texts/types.js +104 -0
  65. package/dist/agent-tools/api-docs/ui-writes.d.ts +12 -0
  66. package/dist/agent-tools/api-docs/ui-writes.js +73 -0
  67. package/dist/agent-tools/handler-schema.d.ts +5 -0
  68. package/dist/agent-tools/handler-schema.js +37 -0
  69. package/dist/agent-tools/index.d.ts +2 -1
  70. package/dist/agent-tools/index.js +2 -1
  71. package/dist/agent-tools/labels.d.ts +26 -0
  72. package/dist/agent-tools/labels.js +131 -0
  73. package/dist/auth-email-password/boot-rules.d.ts +7 -0
  74. package/dist/auth-email-password/boot-rules.js +7 -0
  75. package/dist/auth-email-password/feature.js +6 -13
  76. package/dist/auth-email-password/validate-options.d.ts +5 -0
  77. package/dist/auth-email-password/validate-options.js +15 -0
  78. package/dist/billing-foundation/boot-rules.d.ts +22 -0
  79. package/dist/billing-foundation/boot-rules.js +22 -0
  80. package/dist/billing-foundation/validate-options.js +56 -18
  81. package/dist/cap-overview/boot-rules.d.ts +12 -0
  82. package/dist/cap-overview/boot-rules.js +12 -0
  83. package/dist/cap-overview/feature.js +8 -3
  84. package/dist/documents/boot-rules.d.ts +12 -0
  85. package/dist/documents/boot-rules.js +12 -0
  86. package/dist/documents/feature.js +8 -3
  87. package/dist/file-derivatives/boot-rules.d.ts +7 -0
  88. package/dist/file-derivatives/boot-rules.js +7 -0
  89. package/dist/file-derivatives/feature.js +5 -2
  90. package/dist/folders/boot-rules.d.ts +7 -0
  91. package/dist/folders/boot-rules.js +7 -0
  92. package/dist/folders/feature.js +8 -5
  93. package/dist/helpdesk/boot-rules.d.ts +7 -0
  94. package/dist/helpdesk/boot-rules.js +7 -0
  95. package/dist/{contact → helpdesk}/challenge.js +2 -2
  96. package/dist/helpdesk/client/helpdesk-client-source.d.ts +1 -0
  97. package/dist/{contact/client/contact-client-source.js → helpdesk/client/helpdesk-client-source.js} +4 -4
  98. package/dist/helpdesk/client/helpdesk-website-client.d.ts +26 -0
  99. package/dist/helpdesk/client/helpdesk-website-client.js +1 -0
  100. package/dist/helpdesk/client/index.d.ts +2 -0
  101. package/dist/helpdesk/client/index.js +1 -0
  102. package/dist/{contact → helpdesk}/entity.d.ts +6 -6
  103. package/dist/{contact → helpdesk}/entity.js +31 -27
  104. package/dist/helpdesk/feature.d.ts +3 -0
  105. package/dist/{contact → helpdesk}/feature.js +43 -39
  106. package/dist/{contact → helpdesk}/handlers/attempts.d.ts +2 -2
  107. package/dist/helpdesk/handlers/challenge.query.d.ts +9 -0
  108. package/dist/{contact → helpdesk}/handlers/challenge.query.js +5 -5
  109. package/dist/helpdesk/handlers/forward-request.write.d.ts +9 -0
  110. package/dist/{contact → helpdesk}/handlers/forward-request.write.js +17 -15
  111. package/dist/{contact → helpdesk}/handlers/mark-done.write.d.ts +2 -2
  112. package/dist/{contact → helpdesk}/handlers/mark-done.write.js +8 -8
  113. package/dist/{contact → helpdesk}/handlers/notify-reporter-in-app.write.d.ts +2 -2
  114. package/dist/{contact → helpdesk}/handlers/notify-reporter-in-app.write.js +11 -11
  115. package/dist/{contact → helpdesk}/handlers/open-count.js +2 -2
  116. package/dist/{contact → helpdesk}/handlers/open-count.query.js +4 -4
  117. package/dist/{contact → helpdesk}/handlers/replies.query.js +6 -6
  118. package/dist/{contact → helpdesk}/handlers/reply.write.d.ts +4 -4
  119. package/dist/{contact → helpdesk}/handlers/reply.write.js +16 -16
  120. package/dist/helpdesk/handlers/report.write.d.ts +16 -0
  121. package/dist/{contact → helpdesk}/handlers/report.write.js +17 -17
  122. package/dist/helpdesk/handlers/request-delivery.query.d.ts +16 -0
  123. package/dist/{contact → helpdesk}/handlers/request-delivery.query.js +24 -24
  124. package/dist/{contact → helpdesk}/handlers/request-detail.query.d.ts +3 -3
  125. package/dist/{contact → helpdesk}/handlers/request-detail.query.js +10 -10
  126. package/dist/{contact → helpdesk}/handlers/request-list.query.js +2 -2
  127. package/dist/helpdesk/handlers/send-reply-mail.write.d.ts +8 -0
  128. package/dist/{contact → helpdesk}/handlers/send-reply-mail.write.js +15 -15
  129. package/dist/helpdesk/handlers/send-test.write.d.ts +5 -0
  130. package/dist/{contact → helpdesk}/handlers/send-test.write.js +10 -10
  131. package/dist/{contact → helpdesk}/handlers/submit.write.d.ts +4 -4
  132. package/dist/{contact → helpdesk}/handlers/submit.write.js +17 -17
  133. package/dist/{contact → helpdesk}/handlers/take-over-uploads.js +5 -5
  134. package/dist/{contact → helpdesk}/i18n.d.ts +1 -1
  135. package/dist/{contact → helpdesk}/i18n.js +78 -75
  136. package/dist/helpdesk/index.d.ts +5 -0
  137. package/dist/helpdesk/index.js +4 -0
  138. package/dist/{contact → helpdesk}/lib.d.ts +5 -5
  139. package/dist/{contact → helpdesk}/lib.js +16 -16
  140. package/dist/{contact → helpdesk}/mail.d.ts +20 -20
  141. package/dist/{contact → helpdesk}/mail.js +47 -47
  142. package/dist/{contact → helpdesk}/options.d.ts +6 -6
  143. package/dist/helpdesk/options.js +36 -0
  144. package/dist/helpdesk/panels.d.ts +2 -0
  145. package/dist/helpdesk/panels.js +21 -0
  146. package/dist/{contact → helpdesk}/payloads.d.ts +11 -11
  147. package/dist/{contact → helpdesk}/payloads.js +28 -28
  148. package/dist/helpdesk/screens.d.ts +5 -0
  149. package/dist/{contact → helpdesk}/screens.js +87 -87
  150. package/dist/{contact → helpdesk}/subject.js +3 -3
  151. package/dist/helpdesk/user-data-hooks.d.ts +3 -0
  152. package/dist/{contact → helpdesk}/user-data-hooks.js +15 -15
  153. package/dist/helpdesk/web/constants.d.ts +127 -0
  154. package/dist/helpdesk/web/constants.js +126 -0
  155. package/dist/helpdesk/web/index.d.ts +1 -0
  156. package/dist/helpdesk/web/index.js +1 -0
  157. package/dist/host-routing/boot-rules.d.ts +22 -0
  158. package/dist/host-routing/boot-rules.js +22 -0
  159. package/dist/host-routing/validate-options.js +35 -11
  160. package/dist/inbound-mail-foundation/entities.d.ts +84 -0
  161. package/dist/inbound-mail-foundation/entities.js +96 -71
  162. package/dist/inbound-mail-foundation/feature.js +2 -2
  163. package/dist/jobs/boot-rules.d.ts +7 -0
  164. package/dist/jobs/boot-rules.js +7 -0
  165. package/dist/jobs/feature.js +5 -2
  166. package/dist/legal-pages/boot-rules.d.ts +17 -0
  167. package/dist/legal-pages/boot-rules.js +17 -0
  168. package/dist/legal-pages/feature.js +5 -2
  169. package/dist/legal-pages/lib/validate-routes.js +11 -3
  170. package/dist/metrics/boot-rules.d.ts +12 -0
  171. package/dist/metrics/boot-rules.js +12 -0
  172. package/dist/metrics/validate.js +8 -2
  173. package/dist/notes-history/boot-rules.d.ts +7 -0
  174. package/dist/notes-history/boot-rules.js +7 -0
  175. package/dist/notes-history/feature.js +7 -4
  176. package/dist/personal-access-tokens/boot-rules.d.ts +7 -0
  177. package/dist/personal-access-tokens/boot-rules.js +7 -0
  178. package/dist/personal-access-tokens/feature.d.ts +1 -0
  179. package/dist/personal-access-tokens/feature.js +4 -2
  180. package/dist/personal-access-tokens/handlers/create.write.js +2 -2
  181. package/dist/personal-access-tokens/i18n.js +5 -1
  182. package/dist/personal-access-tokens/index.d.ts +4 -2
  183. package/dist/personal-access-tokens/index.js +29 -2
  184. package/dist/personal-access-tokens/scope-events-check.d.ts +3 -0
  185. package/dist/personal-access-tokens/scope-events-check.js +21 -0
  186. package/dist/personal-access-tokens/screens.js +8 -2
  187. package/dist/personal-access-tokens/web/constants.d.ts +1 -0
  188. package/dist/personal-access-tokens/web/constants.js +1 -0
  189. package/dist/personal-access-tokens/web/scopes.d.ts +2 -0
  190. package/dist/personal-access-tokens/web/scopes.js +12 -0
  191. package/dist/presence/boot-rules.d.ts +7 -0
  192. package/dist/presence/boot-rules.js +7 -0
  193. package/dist/presence/options.js +5 -1
  194. package/dist/readiness/boot-rules.d.ts +12 -0
  195. package/dist/readiness/boot-rules.js +12 -0
  196. package/dist/readiness/probe-boot-check.js +8 -3
  197. package/dist/shared/assert-no-where-rule-in-ownership-write.d.ts +1 -1
  198. package/dist/shared/assert-no-where-rule-in-ownership-write.js +11 -7
  199. package/dist/shared/boot-rules.d.ts +7 -0
  200. package/dist/shared/boot-rules.js +7 -0
  201. package/dist/subscription-mollie/boot-rules.d.ts +17 -0
  202. package/dist/subscription-mollie/boot-rules.js +17 -0
  203. package/dist/subscription-mollie/feature.js +13 -6
  204. package/dist/tags/boot-rules.d.ts +7 -0
  205. package/dist/tags/boot-rules.js +7 -0
  206. package/dist/tags/feature.js +8 -5
  207. package/dist/template-resolver/boot-rules.d.ts +17 -0
  208. package/dist/template-resolver/boot-rules.js +17 -0
  209. package/dist/template-resolver/feature.js +14 -5
  210. package/dist/tenant/boot-rules.d.ts +7 -0
  211. package/dist/tenant/boot-rules.js +7 -0
  212. package/dist/tenant/feature.js +5 -2
  213. package/kumiko-es-tables.json +4 -4
  214. package/package.json +29 -29
  215. package/src/agent-tools/changes.json +24 -0
  216. package/src/{contact → helpdesk}/changes.json +6 -0
  217. package/src/inbound-mail-foundation/changes.json +6 -0
  218. package/src/personal-access-tokens/changes.json +6 -0
  219. package/dist/contact/client/contact-client-source.d.ts +0 -1
  220. package/dist/contact/client/contact-website-client.d.ts +0 -26
  221. package/dist/contact/client/index.d.ts +0 -2
  222. package/dist/contact/client/index.js +0 -1
  223. package/dist/contact/feature.d.ts +0 -3
  224. package/dist/contact/handlers/challenge.query.d.ts +0 -9
  225. package/dist/contact/handlers/forward-request.write.d.ts +0 -9
  226. package/dist/contact/handlers/report.write.d.ts +0 -16
  227. package/dist/contact/handlers/request-delivery.query.d.ts +0 -16
  228. package/dist/contact/handlers/send-reply-mail.write.d.ts +0 -8
  229. package/dist/contact/handlers/send-test.write.d.ts +0 -5
  230. package/dist/contact/index.d.ts +0 -5
  231. package/dist/contact/index.js +0 -4
  232. package/dist/contact/options.js +0 -32
  233. package/dist/contact/panels.d.ts +0 -2
  234. package/dist/contact/panels.js +0 -21
  235. package/dist/contact/screens.d.ts +0 -5
  236. package/dist/contact/user-data-hooks.d.ts +0 -3
  237. package/dist/contact/web/constants.d.ts +0 -127
  238. package/dist/contact/web/constants.js +0 -126
  239. package/dist/contact/web/index.d.ts +0 -1
  240. package/dist/contact/web/index.js +0 -1
  241. /package/dist/{contact/client/contact-website-client.js → agent-tools/api-docs/model.js} +0 -0
  242. /package/dist/{contact → helpdesk}/challenge.d.ts +0 -0
  243. /package/dist/{contact → helpdesk}/handlers/access.d.ts +0 -0
  244. /package/dist/{contact → helpdesk}/handlers/access.js +0 -0
  245. /package/dist/{contact → helpdesk}/handlers/attempts.js +0 -0
  246. /package/dist/{contact → helpdesk}/handlers/open-count.d.ts +0 -0
  247. /package/dist/{contact → helpdesk}/handlers/open-count.query.d.ts +0 -0
  248. /package/dist/{contact → helpdesk}/handlers/replies.query.d.ts +0 -0
  249. /package/dist/{contact → helpdesk}/handlers/request-list.query.d.ts +0 -0
  250. /package/dist/{contact → helpdesk}/handlers/take-over-uploads.d.ts +0 -0
  251. /package/dist/{contact → helpdesk}/pow.d.ts +0 -0
  252. /package/dist/{contact → helpdesk}/pow.js +0 -0
  253. /package/dist/{contact → helpdesk}/subject.d.ts +0 -0
  254. /package/dist/{contact → helpdesk}/user-agent.d.ts +0 -0
  255. /package/dist/{contact → helpdesk}/user-agent.js +0 -0
@@ -1,7 +1,7 @@
1
1
  import { i18nKey, MAX_LIST_LIMIT, } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { ACTION_FORM_ENTITY } from "@cosmicdrift/kumiko-framework/ui-types";
3
3
  import { fieldOptionLabelKeyPrefix } from "@cosmicdrift/kumiko-renderer/headless";
4
- import { PAT_FEATURE, PAT_MINT_SCREEN_ID, PAT_SCREEN_ID, PatHandlers, PatQueries, } from "./web/constants.js";
4
+ import { PAT_DEFAULT_EXPIRES_IN_DAYS, PAT_FEATURE, PAT_MAX_EXPIRES_IN_DAYS, PAT_MINT_SCREEN_ID, PAT_SCREEN_ID, PatHandlers, PatQueries, } from "./web/constants.js";
5
5
  const PAT_STATUS_OPTION_KEY_PREFIX = "pat.list.status.";
6
6
  // Same keys the mint form's `scopes` multiSelect options resolve through
7
7
  // (see patScopeOptionTranslations), so list and form show identical labels.
@@ -114,7 +114,13 @@ export function createPatMintScreen(scopes) {
114
114
  display: "checkboxes",
115
115
  options: patGrantOptions(scopes),
116
116
  },
117
- expiresInDays: { type: "number", integer: true, min: 1, max: 3650, default: 90 },
117
+ expiresInDays: {
118
+ type: "number",
119
+ integer: true,
120
+ min: 1,
121
+ max: PAT_MAX_EXPIRES_IN_DAYS,
122
+ default: PAT_DEFAULT_EXPIRES_IN_DAYS,
123
+ },
118
124
  currentPassword: { type: "text", required: true, format: "password", sensitive: true },
119
125
  mfaCode: { type: "text" },
120
126
  },
@@ -5,6 +5,7 @@ export declare const PatErrors: {
5
5
  readonly reauthRequired: "reauth_required";
6
6
  };
7
7
  export declare const PAT_DEFAULT_EXPIRES_IN_DAYS = 90;
8
+ export declare const PAT_MAX_EXPIRES_IN_DAYS = 3650;
8
9
  export declare const PAT_SCREEN_ID = "api-tokens";
9
10
  export declare const PAT_MINT_SCREEN_ID = "api-token-create";
10
11
  export declare const PatHandlers: {
@@ -13,6 +13,7 @@ export const PatErrors = {
13
13
  // default is a standing-credential risk; the existing 3650-day cap still
14
14
  // lets callers who genuinely want a long-lived token pass it explicitly.
15
15
  export const PAT_DEFAULT_EXPIRES_IN_DAYS = 90;
16
+ export const PAT_MAX_EXPIRES_IN_DAYS = 3650;
16
17
  // Declarative projectionList screen id — the caller's own tokens, revoke as a
17
18
  // row action. The app places it via r.nav.
18
19
  export const PAT_SCREEN_ID = "api-tokens";
@@ -2,6 +2,7 @@ export type PatScopeDef = {
2
2
  readonly label: string;
3
3
  readonly read: readonly string[];
4
4
  readonly write?: readonly string[];
5
+ readonly events?: readonly string[];
5
6
  };
6
7
  export type PatScopeConfig = Readonly<Record<string, PatScopeDef>>;
7
8
  export type PatLevel = "read" | "write";
@@ -9,4 +10,5 @@ export declare function parseGrant(grant: string): {
9
10
  domain: string;
10
11
  level: string;
11
12
  } | null;
13
+ export declare function expandScopeEvents(config: PatScopeConfig, granted: readonly string[]): string[];
12
14
  export declare function expandScopes(config: PatScopeConfig, granted: readonly string[]): string[];
@@ -6,6 +6,18 @@ export function parseGrant(grant) {
6
6
  return null;
7
7
  return { domain: grant.slice(0, idx), level: grant.slice(idx + 1) };
8
8
  }
9
+ // Union of the webhook events of every granted domain; read level already suffices to subscribe.
10
+ export function expandScopeEvents(config, granted) {
11
+ const out = new Set();
12
+ for (const grant of granted) {
13
+ const parsed = parseGrant(grant);
14
+ if (!parsed)
15
+ continue;
16
+ for (const qn of config[parsed.domain]?.events ?? [])
17
+ out.add(qn);
18
+ }
19
+ return [...out];
20
+ }
9
21
  // Expand granted "<domain>:<level>" entries into the union of QN globs: read
10
22
  // always grants the read QNs; write additionally grants the write QNs. Unknown
11
23
  // domains contribute nothing (fail-closed — a scope dropped from config after a
@@ -0,0 +1,7 @@
1
+ export declare const PRESENCE_BOOT_RULES: {
2
+ readonly invalidTtlSeconds: {
3
+ readonly id: "presence/invalid-ttl-seconds";
4
+ readonly summary: "The presence ttlSeconds option is a positive number.";
5
+ readonly fix: "Pass a positive ttlSeconds.";
6
+ };
7
+ };
@@ -0,0 +1,7 @@
1
+ export const PRESENCE_BOOT_RULES = {
2
+ invalidTtlSeconds: {
3
+ id: "presence/invalid-ttl-seconds",
4
+ summary: "The presence ttlSeconds option is a positive number.",
5
+ fix: "Pass a positive ttlSeconds.",
6
+ },
7
+ };
@@ -1,9 +1,13 @@
1
+ import { bootRuleError } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { PRESENCE_BOOT_RULES } from "./boot-rules.js";
1
3
  export const PRESENCE_DEFAULT_ROLES = ["TenantAdmin", "TenantMember"];
2
4
  export const PRESENCE_DEFAULT_TTL_SECONDS = 45;
3
5
  export function resolvePresenceSettings(options) {
4
6
  const ttlSeconds = options.ttlSeconds ?? PRESENCE_DEFAULT_TTL_SECONDS;
5
7
  if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
6
- throw new Error(`presence: ttlSeconds must be a positive number, got ${ttlSeconds}`);
8
+ throw bootRuleError(PRESENCE_BOOT_RULES.invalidTtlSeconds, {
9
+ message: `presence: ttlSeconds must be a positive number, got ${ttlSeconds}`,
10
+ });
7
11
  }
8
12
  return {
9
13
  entities: new Set(options.entities ?? []),
@@ -0,0 +1,12 @@
1
+ export declare const READINESS_BOOT_RULES: {
2
+ readonly probeTranslationMissing: {
3
+ readonly id: "readiness/probe-translation-missing";
4
+ readonly summary: "Probe area and label keys are defined by a mounted feature.";
5
+ readonly fix: "Add the key via r.translations(...).";
6
+ };
7
+ readonly probeFixScreenUnknown: {
8
+ readonly id: "readiness/probe-fix-screen-unknown";
9
+ readonly summary: "A probe fixScreen names a screen of a mounted feature.";
10
+ readonly fix: "Use a <feature>:screen:<id> qualified name of a mounted screen.";
11
+ };
12
+ };
@@ -0,0 +1,12 @@
1
+ export const READINESS_BOOT_RULES = {
2
+ probeTranslationMissing: {
3
+ id: "readiness/probe-translation-missing",
4
+ summary: "Probe area and label keys are defined by a mounted feature.",
5
+ fix: "Add the key via r.translations(...).",
6
+ },
7
+ probeFixScreenUnknown: {
8
+ id: "readiness/probe-fix-screen-unknown",
9
+ summary: "A probe fixScreen names a screen of a mounted feature.",
10
+ fix: "Use a <feature>:screen:<id> qualified name of a mounted screen.",
11
+ },
12
+ };
@@ -1,4 +1,5 @@
1
- import { buildConfigFeatureSchema, createRegistry, SETTINGS_HUB_FEATURE, } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { bootRuleError, buildConfigFeatureSchema, createRegistry, SETTINGS_HUB_FEATURE, } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { READINESS_BOOT_RULES } from "./boot-rules.js";
2
3
  // Settings screens come from config keys at schema build, not from r.screen, yet a probe may
3
4
  // link a failed row to one (mail sending lives on config:screen:mail-foundation-tenant).
4
5
  function mountedScreenQns(features) {
@@ -28,11 +29,15 @@ export function validateProbeTranslations(features) {
28
29
  ["label", probe.label],
29
30
  ]) {
30
31
  if (!defined.has(key)) {
31
- throw new Error(`Probe "${probe.qualifiedName}": ${field} translation key "${key}" is not defined by any mounted feature. Add it via r.translations(...).`);
32
+ throw bootRuleError(READINESS_BOOT_RULES.probeTranslationMissing, {
33
+ message: `Probe "${probe.qualifiedName}": ${field} translation key "${key}" is not defined by any mounted feature. Add it via r.translations(...).`,
34
+ });
32
35
  }
33
36
  }
34
37
  if (probe.fixScreen !== undefined && !screenQns.has(probe.fixScreen)) {
35
- throw new Error(`Probe "${probe.qualifiedName}": fixScreen "${probe.fixScreen}" is not a screen of any mounted feature. Use a "<feature>:screen:<id>" QN.`);
38
+ throw bootRuleError(READINESS_BOOT_RULES.probeFixScreenUnknown, {
39
+ message: `Probe "${probe.qualifiedName}": fixScreen "${probe.fixScreen}" is not a screen of any mounted feature. Use a "<feature>:screen:<id>" QN.`,
40
+ });
36
41
  }
37
42
  }
38
43
  }
@@ -1,2 +1,2 @@
1
- import type { OwnershipMap } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { type OwnershipMap } from "@cosmicdrift/kumiko-framework/engine";
2
2
  export declare function assertNoWhereRuleInOwnershipWrite(factoryName: string, writeOwnership: OwnershipMap | undefined): void;
@@ -1,3 +1,5 @@
1
+ import { bootRuleError } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { SHARED_BOOT_RULES } from "./boot-rules.js";
1
3
  // Boot validation rejects `{ kind: "where" }` in access.write too;
2
4
  // failing at factory time names the option instead of an entity scope.
3
5
  export function assertNoWhereRuleInOwnershipWrite(factoryName, writeOwnership) {
@@ -8,11 +10,13 @@ export function assertNoWhereRuleInOwnershipWrite(factoryName, writeOwnership) {
8
10
  // skip: no where-rule present, the option is valid
9
11
  if (!hasWhereRule)
10
12
  return;
11
- throw new Error(`${factoryName}({ ownership }): ownership.write must not contain a ` +
12
- '`{ kind: "where" }` rule — where-rules are evaluated only at the SQL ' +
13
- "layer (the read path, via buildOwnershipClause). Write paths that " +
14
- "consult access.write (userCanCreateFieldRow/userCanWriteFieldRow) can't " +
15
- "evaluate them, so such a rule can only ever deny — boot validation " +
16
- "rejects it too (fw#2626). Use a `from()` rule for ownership.write, or " +
17
- "leave it unset.");
13
+ throw bootRuleError(SHARED_BOOT_RULES.whereRuleInOwnershipWrite, {
14
+ message: `${factoryName}({ ownership }): ownership.write must not contain a ` +
15
+ '`{ kind: "where" }` rule — where-rules are evaluated only at the SQL ' +
16
+ "layer (the read path, via buildOwnershipClause). Write paths that " +
17
+ "consult access.write (userCanCreateFieldRow/userCanWriteFieldRow) can't " +
18
+ "evaluate them, so such a rule can only ever deny — boot validation " +
19
+ "rejects it too (fw#2626). Use a `from()` rule for ownership.write, or " +
20
+ "leave it unset.",
21
+ });
18
22
  }
@@ -0,0 +1,7 @@
1
+ export declare const SHARED_BOOT_RULES: {
2
+ readonly whereRuleInOwnershipWrite: {
3
+ readonly id: "shared/where-rule-in-ownership-write";
4
+ readonly summary: "ownership.write of a bundled-feature factory contains no where rule.";
5
+ readonly fix: "Drop the where rule from ownership.write; it only applies on the read path.";
6
+ };
7
+ };
@@ -0,0 +1,7 @@
1
+ export const SHARED_BOOT_RULES = {
2
+ whereRuleInOwnershipWrite: {
3
+ id: "shared/where-rule-in-ownership-write",
4
+ summary: "ownership.write of a bundled-feature factory contains no where rule.",
5
+ fix: "Drop the where rule from ownership.write; it only applies on the read path.",
6
+ },
7
+ };
@@ -0,0 +1,17 @@
1
+ export declare const SUBSCRIPTION_MOLLIE_BOOT_RULES: {
2
+ readonly emptyApiKey: {
3
+ readonly id: "subscription-mollie/empty-api-key";
4
+ readonly summary: "The Mollie provider receives a non-empty apiKey.";
5
+ readonly fix: "Set MOLLIE_API_KEY before mounting.";
6
+ };
7
+ readonly emptyWebhookUrl: {
8
+ readonly id: "subscription-mollie/empty-webhook-url";
9
+ readonly summary: "The Mollie provider receives a non-empty webhookUrl.";
10
+ readonly fix: "Pass the foundation webhook URL Mollie sends events to.";
11
+ };
12
+ readonly priceMapDrift: {
13
+ readonly id: "subscription-mollie/price-map-drift";
14
+ readonly summary: "priceToTier and priceToConfig declare the same price ids.";
15
+ readonly fix: "Make both maps list the same price ids.";
16
+ };
17
+ };
@@ -0,0 +1,17 @@
1
+ export const SUBSCRIPTION_MOLLIE_BOOT_RULES = {
2
+ emptyApiKey: {
3
+ id: "subscription-mollie/empty-api-key",
4
+ summary: "The Mollie provider receives a non-empty apiKey.",
5
+ fix: "Set MOLLIE_API_KEY before mounting.",
6
+ },
7
+ emptyWebhookUrl: {
8
+ id: "subscription-mollie/empty-webhook-url",
9
+ summary: "The Mollie provider receives a non-empty webhookUrl.",
10
+ fix: "Pass the foundation webhook URL Mollie sends events to.",
11
+ },
12
+ priceMapDrift: {
13
+ id: "subscription-mollie/price-map-drift",
14
+ summary: "priceToTier and priceToConfig declare the same price ids.",
15
+ fix: "Make both maps list the same price ids.",
16
+ },
17
+ };
@@ -38,9 +38,10 @@
38
38
  // },
39
39
  // }),
40
40
  // ];
41
- import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
41
+ import { bootRuleError, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
42
42
  import { createMollieClient } from "@mollie/api-client";
43
43
  import * as z from "zod";
44
+ import { SUBSCRIPTION_MOLLIE_BOOT_RULES } from "./boot-rules.js";
44
45
  import { MOLLIE_PROVIDER_NAME, SUBSCRIPTION_MOLLIE_FEATURE } from "./constants.js";
45
46
  import { createMollieCheckoutSession } from "./plugin-methods.js";
46
47
  import { verifyAndParseMollieWebhook } from "./verify-webhook.js";
@@ -59,10 +60,14 @@ export const subscriptionMollieEnvSchema = z.object({
59
60
  });
60
61
  export function createSubscriptionMollieFeature(options) {
61
62
  if (options.apiKey.length === 0) {
62
- throw new Error("subscription-mollie: apiKey is empty. Set MOLLIE_API_KEY (or system-config) before mounting.");
63
+ throw bootRuleError(SUBSCRIPTION_MOLLIE_BOOT_RULES.emptyApiKey, {
64
+ message: "subscription-mollie: apiKey is empty. Set MOLLIE_API_KEY (or system-config) before mounting.",
65
+ });
63
66
  }
64
67
  if (options.webhookUrl.length === 0) {
65
- throw new Error("subscription-mollie: webhookUrl is empty. Set the foundation-webhook-URL where Mollie sends events.");
68
+ throw bootRuleError(SUBSCRIPTION_MOLLIE_BOOT_RULES.emptyWebhookUrl, {
69
+ message: "subscription-mollie: webhookUrl is empty. Set the foundation-webhook-URL where Mollie sends events.",
70
+ });
66
71
  }
67
72
  // Drift guard: priceToTier and priceToConfig must have identical keys;
68
73
  // otherwise verifyAndParseWebhook silently returns null.
@@ -71,9 +76,11 @@ export function createSubscriptionMollieFeature(options) {
71
76
  const missingInConfig = [...tierKeys].filter((k) => !configKeys.has(k));
72
77
  const missingInTier = [...configKeys].filter((k) => !tierKeys.has(k));
73
78
  if (missingInConfig.length > 0 || missingInTier.length > 0) {
74
- throw new Error(`subscription-mollie: priceToTier ↔ priceToConfig drift — ` +
75
- `priceIds in tier but missing config: [${missingInConfig.join(", ")}]; ` +
76
- `priceIds in config but missing tier: [${missingInTier.join(", ")}]`);
79
+ throw bootRuleError(SUBSCRIPTION_MOLLIE_BOOT_RULES.priceMapDrift, {
80
+ message: `subscription-mollie: priceToTier ↔ priceToConfig drift — ` +
81
+ `priceIds in tier but missing config: [${missingInConfig.join(", ")}]; ` +
82
+ `priceIds in config but missing tier: [${missingInTier.join(", ")}]`,
83
+ });
77
84
  }
78
85
  const client = createMollieClient({ apiKey: options.apiKey });
79
86
  // Adapter that binds the plugin's minimal fetch client to the full Mollie
@@ -0,0 +1,7 @@
1
+ export declare const TAGS_BOOT_RULES: {
2
+ readonly emptyParentsAllowlist: {
3
+ readonly id: "tags/empty-parents-allowlist";
4
+ readonly summary: "The parents allowlist is omitted or non-empty.";
5
+ readonly fix: "Omit parents or list at least one entity.";
6
+ };
7
+ };
@@ -0,0 +1,7 @@
1
+ export const TAGS_BOOT_RULES = {
2
+ emptyParentsAllowlist: {
3
+ id: "tags/empty-parents-allowlist",
4
+ summary: "The parents allowlist is omitted or non-empty.",
5
+ fix: "Omit parents or list at least one entity.",
6
+ },
7
+ };
@@ -17,8 +17,9 @@
17
17
  // Convention aliases tag:{create,update,delete} + tag:detail back the
18
18
  // entityList/entityEdit catalog screens (legacy QNs stay for TagManager).
19
19
  // Deferred: optional host-projection decoration (`wireTagsFor`), search indexing.
20
- import { defineEntityDetailHandler, defineEntityListHandler, defineEntityUpdateHandler, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
20
+ import { bootRuleError, defineEntityDetailHandler, defineEntityListHandler, defineEntityUpdateHandler, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
21
21
  import { assertNoWhereRuleInOwnershipWrite, resolveFeatureAccess } from "../shared/index.js";
22
+ import { TAGS_BOOT_RULES } from "./boot-rules.js";
22
23
  import { createTagAssignmentEntity, tagEntity } from "./entity.js";
23
24
  import { createTagAssignmentExecutor } from "./executor.js";
24
25
  import { createAssignTagHandler } from "./handlers/assign-tag.write.js";
@@ -98,10 +99,12 @@ export function createTagsFeature(opts = {}) {
98
99
  return defaultTagsFeature;
99
100
  }
100
101
  if (opts.parents !== undefined && opts.parents.length === 0) {
101
- throw new Error("createTagsFeature({ parents }): parents must not be an empty array — " +
102
- "an empty allowlist rejects every assign-tag call and hides every " +
103
- "assignment row. Omit `parents` to keep every registered entity " +
104
- "admissible as a host instead.");
102
+ throw bootRuleError(TAGS_BOOT_RULES.emptyParentsAllowlist, {
103
+ message: "createTagsFeature({ parents }): parents must not be an empty array — " +
104
+ "an empty allowlist rejects every assign-tag call and hides every " +
105
+ "assignment row. Omit `parents` to keep every registered entity " +
106
+ "admissible as a host instead.",
107
+ });
105
108
  }
106
109
  assertNoWhereRuleInOwnershipWrite("createTagsFeature", opts.ownership?.write);
107
110
  const access = resolveFeatureAccess(opts, DEFAULT_TAG_ACCESS);
@@ -0,0 +1,17 @@
1
+ export declare const TEMPLATE_RESOLVER_BOOT_RULES: {
2
+ readonly collectionRefusedKind: {
3
+ readonly id: "template-resolver/collection-refused-kind";
4
+ readonly summary: "Collections only use kinds that collections may write.";
5
+ readonly fix: "Pick an allowed collection kind.";
6
+ };
7
+ readonly tenantEditableDuplicate: {
8
+ readonly id: "template-resolver/tenant-editable-duplicate";
9
+ readonly summary: "tenantEditable lists each kind and slug once.";
10
+ readonly fix: "Remove the duplicate entry.";
11
+ };
12
+ readonly tenantEditableInvalidEntry: {
13
+ readonly id: "template-resolver/tenant-editable-invalid-entry";
14
+ readonly summary: "Each tenantEditable entry has a non-empty slug and at least one access role.";
15
+ readonly fix: "Give the entry a slug and roles.";
16
+ };
17
+ };
@@ -0,0 +1,17 @@
1
+ export const TEMPLATE_RESOLVER_BOOT_RULES = {
2
+ collectionRefusedKind: {
3
+ id: "template-resolver/collection-refused-kind",
4
+ summary: "Collections only use kinds that collections may write.",
5
+ fix: "Pick an allowed collection kind.",
6
+ },
7
+ tenantEditableDuplicate: {
8
+ id: "template-resolver/tenant-editable-duplicate",
9
+ summary: "tenantEditable lists each kind and slug once.",
10
+ fix: "Remove the duplicate entry.",
11
+ },
12
+ tenantEditableInvalidEntry: {
13
+ id: "template-resolver/tenant-editable-invalid-entry",
14
+ summary: "Each tenantEditable entry has a non-empty slug and at least one access role.",
15
+ fix: "Give the entry a slug and roles.",
16
+ },
17
+ };
@@ -1,4 +1,5 @@
1
- import { createSystemConfig, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { bootRuleError, createSystemConfig, defineFeature, } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { TEMPLATE_RESOLVER_BOOT_RULES } from "./boot-rules.js";
2
3
  import { bySlugQuery } from "./handlers/by-slug.query.js";
3
4
  import { byTenantQuery } from "./handlers/by-tenant.query.js";
4
5
  import { makeCollectionItemQuery } from "./handlers/collection-item.query.js";
@@ -38,7 +39,9 @@ import { DEFAULT_COLLECTION_ACCESS, isCollectionRefusedKind } from "./web/consta
38
39
  function assertCollectionKindsAllowed(collections) {
39
40
  for (const collection of collections) {
40
41
  if (isCollectionRefusedKind(collection.kind)) {
41
- throw new Error(`template-resolver: collection "${collection.id}" uses kind "${collection.kind}", which collections may not write`);
42
+ throw bootRuleError(TEMPLATE_RESOLVER_BOOT_RULES.collectionRefusedKind, {
43
+ message: `template-resolver: collection "${collection.id}" uses kind "${collection.kind}", which collections may not write`,
44
+ });
42
45
  }
43
46
  }
44
47
  }
@@ -47,14 +50,20 @@ function assertTenantEditableValid(entries) {
47
50
  for (const entry of entries) {
48
51
  const key = `${entry.kind}/${entry.slug}`;
49
52
  if (seen.has(key)) {
50
- throw new Error(`template-resolver: tenantEditable lists "${key}" twice`);
53
+ throw bootRuleError(TEMPLATE_RESOLVER_BOOT_RULES.tenantEditableDuplicate, {
54
+ message: `template-resolver: tenantEditable lists "${key}" twice`,
55
+ });
51
56
  }
52
57
  seen.add(key);
53
58
  if (entry.slug.trim() === "") {
54
- throw new Error(`template-resolver: tenantEditable entry of kind "${entry.kind}" has an empty slug`);
59
+ throw bootRuleError(TEMPLATE_RESOLVER_BOOT_RULES.tenantEditableInvalidEntry, {
60
+ message: `template-resolver: tenantEditable entry of kind "${entry.kind}" has an empty slug`,
61
+ });
55
62
  }
56
63
  if (entry.access.roles.length === 0) {
57
- throw new Error(`template-resolver: tenantEditable entry "${entry.kind}/${entry.slug}" has no roles in access`);
64
+ throw bootRuleError(TEMPLATE_RESOLVER_BOOT_RULES.tenantEditableInvalidEntry, {
65
+ message: `template-resolver: tenantEditable entry "${entry.kind}/${entry.slug}" has no roles in access`,
66
+ });
58
67
  }
59
68
  }
60
69
  }
@@ -0,0 +1,7 @@
1
+ export declare const TENANT_BOOT_RULES: {
2
+ readonly assignableRoleMissingFromScreens: {
3
+ readonly id: "tenant/assignable-role-missing-from-screens";
4
+ readonly summary: "Every assignable app role is present in the tenant screens' options.";
5
+ readonly fix: "Pass assignableAppRoles: collectAssignableAppRoles(appFeatures) to createTenantFeature.";
6
+ };
7
+ };
@@ -0,0 +1,7 @@
1
+ export const TENANT_BOOT_RULES = {
2
+ assignableRoleMissingFromScreens: {
3
+ id: "tenant/assignable-role-missing-from-screens",
4
+ summary: "Every assignable app role is present in the tenant screens' options.",
5
+ fix: "Pass assignableAppRoles: collectAssignableAppRoles(appFeatures) to createTenantFeature.",
6
+ },
7
+ };
@@ -1,4 +1,5 @@
1
- import { access, assignableAppRolesFromUsages, createSystemConfig, createTenantConfig, defineEntityDetailHandler, defineEntityListHandler, defineEntityUpdateHandler, defineFeature, EXT_ASSIGNABLE_ROLE, i18nKey, } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { access, assignableAppRolesFromUsages, bootRuleError, createSystemConfig, createTenantConfig, defineEntityDetailHandler, defineEntityListHandler, defineEntityUpdateHandler, defineFeature, EXT_ASSIGNABLE_ROLE, i18nKey, } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { TENANT_BOOT_RULES } from "./boot-rules.js";
2
3
  import { activeTenantIdsQuery } from "./handlers/active-tenant-ids.query.js";
3
4
  import { addMemberWrite } from "./handlers/add-member.write.js";
4
5
  import { cancelInvitationWrite } from "./handlers/cancel-invitation.write.js";
@@ -47,7 +48,9 @@ export function createTenantFeature(options) {
47
48
  for (const [role, assignableFrom] of collectAssignableAppRoles(features)) {
48
49
  if (options?.assignableAppRoles?.get(role) === assignableFrom)
49
50
  continue;
50
- throw new Error(`[tenant] assignable app role "${role}" (assignableFrom "${assignableFrom}") is declared but missing from the tenant screens' options; pass assignableAppRoles: collectAssignableAppRoles(appFeatures) to createTenantFeature.`);
51
+ throw bootRuleError(TENANT_BOOT_RULES.assignableRoleMissingFromScreens, {
52
+ message: `[tenant] assignable app role "${role}" (assignableFrom "${assignableFrom}") is declared but missing from the tenant screens' options; pass assignableAppRoles: collectAssignableAppRoles(appFeatures) to createTenantFeature.`,
53
+ });
51
54
  }
52
55
  });
53
56
  r.entity({ name: "tenant", ...tenantEntity });
@@ -20,12 +20,12 @@
20
20
  "export": "configValuesTable"
21
21
  },
22
22
  {
23
- "module": "contact/entity",
24
- "export": "contactRequestTable"
23
+ "module": "helpdesk/entity",
24
+ "export": "helpdeskRequestTable"
25
25
  },
26
26
  {
27
- "module": "contact/entity",
28
- "export": "contactReplyTable"
27
+ "module": "helpdesk/entity",
28
+ "export": "helpdeskReplyTable"
29
29
  },
30
30
  {
31
31
  "module": "data-retention/schema/tenant-retention-override",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cosmicdrift/kumiko-bundled-features",
3
- "version": "0.411.0",
3
+ "version": "0.413.0",
4
4
  "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
5
5
  "license": "MIT",
6
6
  "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -556,21 +556,21 @@
556
556
  "types": "./dist/legal-pages/web/index.d.ts",
557
557
  "default": "./dist/legal-pages/web/index.js"
558
558
  },
559
- "./contact": {
560
- "types": "./dist/contact/index.d.ts",
561
- "default": "./dist/contact/index.js"
559
+ "./helpdesk": {
560
+ "types": "./dist/helpdesk/index.d.ts",
561
+ "default": "./dist/helpdesk/index.js"
562
562
  },
563
563
  "./presence": {
564
564
  "types": "./dist/presence/index.d.ts",
565
565
  "default": "./dist/presence/index.js"
566
566
  },
567
- "./contact/web": {
568
- "types": "./dist/contact/web/index.d.ts",
569
- "default": "./dist/contact/web/index.js"
567
+ "./helpdesk/web": {
568
+ "types": "./dist/helpdesk/web/index.d.ts",
569
+ "default": "./dist/helpdesk/web/index.js"
570
570
  },
571
- "./contact/client": {
572
- "types": "./dist/contact/client/index.d.ts",
573
- "default": "./dist/contact/client/index.js"
571
+ "./helpdesk/client": {
572
+ "types": "./dist/helpdesk/client/index.d.ts",
573
+ "default": "./dist/helpdesk/client/index.js"
574
574
  },
575
575
  "./waitlist": {
576
576
  "types": "./dist/waitlist/index.d.ts",
@@ -614,9 +614,9 @@
614
614
  }
615
615
  },
616
616
  "dependencies": {
617
- "@cosmicdrift/kumiko-framework": "0.411.0",
618
- "@cosmicdrift/kumiko-renderer": "0.411.0",
619
- "@cosmicdrift/kumiko-types": "0.411.0",
617
+ "@cosmicdrift/kumiko-framework": "0.413.0",
618
+ "@cosmicdrift/kumiko-renderer": "0.413.0",
619
+ "@cosmicdrift/kumiko-types": "0.413.0",
620
620
  "@mollie/api-client": "^4.6.0",
621
621
  "@node-rs/argon2": "^2.2.2",
622
622
  "@tiptap/core": "^3.32.2",
@@ -1188,21 +1188,21 @@
1188
1188
  "types": "./dist/legal-pages/web/index.d.ts",
1189
1189
  "default": "./dist/legal-pages/web/index.js"
1190
1190
  },
1191
- "./contact": {
1192
- "types": "./dist/contact/index.d.ts",
1193
- "default": "./dist/contact/index.js"
1191
+ "./helpdesk": {
1192
+ "types": "./dist/helpdesk/index.d.ts",
1193
+ "default": "./dist/helpdesk/index.js"
1194
1194
  },
1195
1195
  "./presence": {
1196
1196
  "types": "./dist/presence/index.d.ts",
1197
1197
  "default": "./dist/presence/index.js"
1198
1198
  },
1199
- "./contact/web": {
1200
- "types": "./dist/contact/web/index.d.ts",
1201
- "default": "./dist/contact/web/index.js"
1199
+ "./helpdesk/web": {
1200
+ "types": "./dist/helpdesk/web/index.d.ts",
1201
+ "default": "./dist/helpdesk/web/index.js"
1202
1202
  },
1203
- "./contact/client": {
1204
- "types": "./dist/contact/client/index.d.ts",
1205
- "default": "./dist/contact/client/index.js"
1203
+ "./helpdesk/client": {
1204
+ "types": "./dist/helpdesk/client/index.d.ts",
1205
+ "default": "./dist/helpdesk/client/index.js"
1206
1206
  },
1207
1207
  "./waitlist": {
1208
1208
  "types": "./dist/waitlist/index.d.ts",
@@ -1254,19 +1254,19 @@
1254
1254
  "LICENSE"
1255
1255
  ],
1256
1256
  "devDependencies": {
1257
- "@cosmicdrift/kumiko-locale-de": "0.411.0",
1258
- "@cosmicdrift/kumiko-locale-es": "0.411.0",
1259
- "@cosmicdrift/kumiko-locale-fr": "0.411.0",
1260
- "@cosmicdrift/kumiko-locale-it": "0.411.0",
1261
- "@cosmicdrift/kumiko-renderer-mail-html": "0.411.0",
1262
- "@cosmicdrift/kumiko-testing": "0.411.0",
1257
+ "@cosmicdrift/kumiko-locale-de": "0.413.0",
1258
+ "@cosmicdrift/kumiko-locale-es": "0.413.0",
1259
+ "@cosmicdrift/kumiko-locale-fr": "0.413.0",
1260
+ "@cosmicdrift/kumiko-locale-it": "0.413.0",
1261
+ "@cosmicdrift/kumiko-renderer-mail-html": "0.413.0",
1262
+ "@cosmicdrift/kumiko-testing": "0.413.0",
1263
1263
  "@testing-library/user-event": "^14.6.8",
1264
1264
  "@types/sanitize-html": "^2.16.2",
1265
1265
  "jsqr": "^1.4.0",
1266
1266
  "unpdf": "^1.9.1"
1267
1267
  },
1268
1268
  "peerDependencies": {
1269
- "@cosmicdrift/kumiko-testing": "0.411.0"
1269
+ "@cosmicdrift/kumiko-testing": "0.413.0"
1270
1270
  },
1271
1271
  "peerDependenciesMeta": {
1272
1272
  "@cosmicdrift/kumiko-testing": {
@@ -1,4 +1,28 @@
1
1
  [
2
+ {
3
+ "version": "0.412.0",
4
+ "type": "improvement",
5
+ "title": "kumiko api-docs generates HTTP API docs from the registry and the PAT scopes",
6
+ "detail": "`kumiko api-docs [--out <dir>] [--locales en,de] [--check]` reads `kumiko.config.ts` and writes `<out>/openapi.json` (OpenAPI 3.1 with only the handlers some PAT scope reaches, one request wrapper per handler with a `type` discriminator), `<out>/<locale>/overview.md` (endpoints, body, envelopes, error codes with HTTP status, versions, lists, batches, safe retries), `<out>/<locale>/tokens.md` (create path from the app's nav labels, scope table, expiry, rate limit, errors, revoke, security, optional plan note) and `<out>/<locale>/reference/<scope>.md` (per handler: title, description, required grant, field table, curl example, recorded response), plus `<out>/index.json` with order, source versions and language independent anchor ids per heading. Output is plain GFM with only `title` and `description` in the frontmatter, so Astro and Starlight render it as is, and it is byte identical for the same input. New `AppConfig.apiDocs` options: `appName`, `baseUrl` (required), `locales`, `planNote`, `uiOnlyWrites` (pattern plus reason), `texts` (paragraph overrides per locale) and `examplesDir`. `--check` writes nothing and exits 1 when a handler in a scope has no description or no description translation (new gap kind `handlerWithoutDescriptionTranslation`, key `handlerDescriptionKey(qn)`), when a write that a screen triggers lies in no scope and is not listed in `uiOnlyWrites`, when a `uiOnlyWrites` entry matches nothing, or when the committed output differs. Known gap: the screen write check only looks at features with at least one handler in a scope. New exports: `frameworkErrorHttpStatus`, `FrameworkErrorCode`, `patAuthRejectHttpStatus`, `PAT_RATE_LIMITED_CODE`, `qnMatches`, `patAllows`, `handlerDescriptionKey`, `patScopesFromFeature`, `PAT_MAX_EXPIRES_IN_DAYS`, and `ApiExampleFileSchema` from `@cosmicdrift/kumiko-types/api-example`."
7
+ },
8
+ {
9
+ "version": "0.412.0",
10
+ "type": "improvement",
11
+ "title": "api-docs token guide covers client code, logs and leaks",
12
+ "detail": "The security list in `tokens.md` now says never to keep a token in an app or web page or in a log, and to revoke a token at once if it may have leaked, in all five locales. Regenerate with `kumiko api-docs`; `--check` reports the changed `tokens.md` until then."
13
+ },
14
+ {
15
+ "version": "0.412.0",
16
+ "type": "improvement",
17
+ "title": "api-docs names events by wireName and skips system-only handlers",
18
+ "detail": "`events.md` headings and anchors, the OpenAPI `webhooks` keys and their `summary` use the wire name; the contract QN stays as `x-kumiko-qn` in OpenAPI and as the anchor `qn` in `index.json`. Write and query handlers whose `access.roles` are only `[\"system\"]` are no longer documented, even when a scope pattern such as `app:write:monitor:*` matches them, and the `uiWriteOutsideScopes` check ignores them."
19
+ },
20
+ {
21
+ "version": "0.412.0",
22
+ "type": "improvement",
23
+ "title": "kumiko api-docs documents webhook events",
24
+ "detail": "When a scope lists events, the output gains `<locale>/events.md` (delivery text from `apiDocs.webhookDelivery`, versioning rules, one section per event with fields and a recorded example), an OpenAPI 3.1 `webhooks` section keyed by event name and an `events` page in `index.json`. New problems `webhookDeliveryTextMissing` and `webhookEventWithoutDescriptionTranslation`. Field descriptions come from `.describe()` on declared payloads and from the entity field translations on derived ones. `ApiDocsInput.webhookExamples` is optional; `kumiko api-docs` reads `<examplesDir>/webhooks/*.json`."
25
+ },
2
26
  {
3
27
  "version": "0.409.0",
4
28
  "type": "improvement",