adula 2.1.0 → 2.3.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 (269) hide show
  1. package/README.md +149 -18
  2. package/build/agent/AGENTS.template.md +4 -4
  3. package/build/agent/capabilities.md +22 -12
  4. package/build/agent/skills/adula-frontend-design/SKILL.md +6 -4
  5. package/build/agent/skills/idea-review/SKILL.md +2 -2
  6. package/build/commands/adula_assistant_prune.d.ts +10 -0
  7. package/build/commands/adula_assistant_prune.js +12 -0
  8. package/build/commands/adula_outbox.d.ts +10 -0
  9. package/build/commands/adula_outbox.js +11 -0
  10. package/build/commands/adula_restore_reconcile.d.ts +10 -0
  11. package/build/commands/adula_restore_reconcile.js +34 -0
  12. package/build/commands/adula_runtime_health.d.ts +10 -0
  13. package/build/commands/adula_runtime_health.js +27 -0
  14. package/build/commands/adula_uploads_prune.d.ts +10 -0
  15. package/build/commands/adula_uploads_prune.js +16 -0
  16. package/build/commands/app.d.ts +10 -0
  17. package/build/commands/app.js +64 -0
  18. package/build/commands/backup_create.d.ts +11 -0
  19. package/build/commands/backup_create.js +99 -0
  20. package/build/commands/backup_open.d.ts +16 -0
  21. package/build/commands/backup_open.js +48 -0
  22. package/build/commands/backup_restore_files.d.ts +11 -0
  23. package/build/commands/backup_restore_files.js +44 -0
  24. package/build/commands/backup_restore_test.d.ts +12 -0
  25. package/build/commands/backup_restore_test.js +188 -0
  26. package/build/commands/backup_seal.d.ts +12 -0
  27. package/build/commands/backup_seal.js +36 -0
  28. package/build/commands/backup_services.d.ts +33 -0
  29. package/build/commands/backup_services.js +6 -0
  30. package/build/commands/backup_verify.d.ts +9 -0
  31. package/build/commands/backup_verify.js +59 -0
  32. package/build/commands/backup_verify_snapshot.d.ts +10 -0
  33. package/build/commands/backup_verify_snapshot.js +37 -0
  34. package/build/commands/client.d.ts +16 -0
  35. package/build/commands/client.js +71 -0
  36. package/build/commands/doctor.js +21 -1
  37. package/build/commands/install.d.ts +8 -0
  38. package/build/commands/install.js +69 -45
  39. package/build/commands/main.d.ts +3 -2
  40. package/build/commands/main.js +32 -0
  41. package/build/commands/module_add.js +4 -20
  42. package/build/commands/resource.d.ts +2 -0
  43. package/build/commands/resource.js +12 -3
  44. package/build/commands/resource_migration.d.ts +15 -0
  45. package/build/commands/resource_migration.js +81 -0
  46. package/build/commands/resource_snapshot.d.ts +2 -0
  47. package/build/commands/resource_snapshot.js +21 -4
  48. package/build/commands/sla_evaluate.d.ts +14 -0
  49. package/build/commands/sla_evaluate.js +16 -0
  50. package/build/commands/ui.js +4 -2
  51. package/build/commands/ui_css.d.ts +9 -0
  52. package/build/commands/ui_css.js +19 -0
  53. package/build/commands/upgrade.d.ts +1 -1
  54. package/build/commands/upgrade.js +1 -1
  55. package/build/configure.js +1 -1
  56. package/build/database/migrations/1770000000020_two_factor.d.ts +5 -0
  57. package/build/database/migrations/1770000000020_two_factor.js +10 -0
  58. package/build/database/migrations/1770000000041_import_modes.d.ts +5 -0
  59. package/build/database/migrations/1770000000041_import_modes.js +10 -0
  60. package/build/database/migrations/1770000000042_sync_jobs.d.ts +5 -0
  61. package/build/database/migrations/1770000000042_sync_jobs.js +10 -0
  62. package/build/database/migrations/1770000000043_notification_channels.d.ts +5 -0
  63. package/build/database/migrations/1770000000043_notification_channels.js +10 -0
  64. package/build/database/migrations/1770000000044_channel_confirmations.d.ts +5 -0
  65. package/build/database/migrations/1770000000044_channel_confirmations.js +10 -0
  66. package/build/database/migrations/1770000000045_import_leases.d.ts +5 -0
  67. package/build/database/migrations/1770000000045_import_leases.js +10 -0
  68. package/build/database/migrations/1770000000046_workflow_delegation_sla.d.ts +5 -0
  69. package/build/database/migrations/1770000000046_workflow_delegation_sla.js +10 -0
  70. package/build/database/migrations/1770000000049_print_templates.d.ts +5 -0
  71. package/build/database/migrations/1770000000049_print_templates.js +10 -0
  72. package/build/database/migrations/1770000000051_comment_notifications.d.ts +5 -0
  73. package/build/database/migrations/1770000000051_comment_notifications.js +10 -0
  74. package/build/database/migrations/1770000000054_cloud_backups.d.ts +5 -0
  75. package/build/database/migrations/1770000000054_cloud_backups.js +10 -0
  76. package/build/database/migrations/1770000000055_ai_assistant.d.ts +5 -0
  77. package/build/database/migrations/1770000000055_ai_assistant.js +10 -0
  78. package/build/database/migrations/1770000000056_appearance.d.ts +5 -0
  79. package/build/database/migrations/1770000000056_appearance.js +10 -0
  80. package/build/index.d.ts +87 -11
  81. package/build/index.js +50 -7
  82. package/build/providers/adula_provider.d.ts +2 -0
  83. package/build/providers/adula_provider.js +7 -0
  84. package/build/src/admin/contracts.js +1 -1
  85. package/build/src/admin/controller.d.ts +14 -1
  86. package/build/src/admin/controller.js +91 -13
  87. package/build/src/admin/errors.d.ts +32 -0
  88. package/build/src/admin/errors.js +63 -1
  89. package/build/src/admin/presentation.d.ts +21 -2
  90. package/build/src/admin/resource/editor.d.ts +60 -0
  91. package/build/src/admin/resource/editor.js +345 -0
  92. package/build/src/admin/resource/export.d.ts +54 -0
  93. package/build/src/admin/resource/export.js +262 -0
  94. package/build/src/admin/resource/lifecycle.d.ts +23 -0
  95. package/build/src/admin/resource/lifecycle.js +91 -0
  96. package/build/src/admin/resource/query.d.ts +111 -0
  97. package/build/src/admin/resource/query.js +595 -0
  98. package/build/src/admin/resource/read.d.ts +109 -0
  99. package/build/src/admin/resource/read.js +388 -0
  100. package/build/src/admin/resource/shared.d.ts +93 -0
  101. package/build/src/admin/resource/shared.js +265 -0
  102. package/build/src/admin/resource/trash.d.ts +10 -0
  103. package/build/src/admin/resource/trash.js +56 -0
  104. package/build/src/admin/resource/write.d.ts +57 -0
  105. package/build/src/admin/resource/write.js +603 -0
  106. package/build/src/admin/resource_service.d.ts +80 -193
  107. package/build/src/admin/resource_service.js +81 -1343
  108. package/build/src/admin/resource_tools.d.ts +111 -0
  109. package/build/src/admin/resource_tools.js +139 -0
  110. package/build/src/ai/assistant.d.ts +100 -0
  111. package/build/src/ai/assistant.js +487 -0
  112. package/build/src/ai/client.d.ts +49 -0
  113. package/build/src/ai/client.js +85 -0
  114. package/build/src/ai/prompt.d.ts +23 -0
  115. package/build/src/ai/prompt.js +83 -0
  116. package/build/src/ai/settings.d.ts +56 -0
  117. package/build/src/ai/settings.js +214 -0
  118. package/build/src/ai/usage.d.ts +16 -0
  119. package/build/src/ai/usage.js +33 -0
  120. package/build/src/appearance/appearance.d.ts +134 -0
  121. package/build/src/appearance/appearance.js +461 -0
  122. package/build/src/appearance/colors.d.ts +43 -0
  123. package/build/src/appearance/colors.js +99 -0
  124. package/build/src/appearance/logo.d.ts +32 -0
  125. package/build/src/appearance/logo.js +112 -0
  126. package/build/src/attachments/attachment_service.d.ts +46 -2
  127. package/build/src/attachments/attachment_service.js +96 -4
  128. package/build/src/auth/actor_store.d.ts +5 -1
  129. package/build/src/auth/actor_store.js +8 -4
  130. package/build/src/auth/conditions.d.ts +5 -0
  131. package/build/src/auth/conditions.js +26 -3
  132. package/build/src/auth/sql.js +17 -5
  133. package/build/src/auth/two_factor.d.ts +96 -0
  134. package/build/src/auth/two_factor.js +259 -0
  135. package/build/src/backups/archive.d.ts +52 -0
  136. package/build/src/backups/archive.js +362 -0
  137. package/build/src/backups/cloud_backups.d.ts +133 -0
  138. package/build/src/backups/cloud_backups.js +650 -0
  139. package/build/src/backups/doctor.d.ts +7 -0
  140. package/build/src/backups/doctor.js +55 -0
  141. package/build/src/backups/providers.d.ts +81 -0
  142. package/build/src/backups/providers.js +470 -0
  143. package/build/src/collaboration/assignments.d.ts +59 -2
  144. package/build/src/collaboration/assignments.js +196 -74
  145. package/build/src/collaboration/record_collaboration.d.ts +21 -4
  146. package/build/src/collaboration/record_collaboration.js +126 -51
  147. package/build/src/collaboration/shared.d.ts +24 -0
  148. package/build/src/collaboration/shared.js +34 -0
  149. package/build/src/commands/app_scaffold.d.ts +72 -0
  150. package/build/src/commands/app_scaffold.js +285 -0
  151. package/build/src/commands/capabilities.js +35 -9
  152. package/build/src/commands/doctor.d.ts +24 -2
  153. package/build/src/commands/doctor.js +81 -6
  154. package/build/src/commands/gap_report.d.ts +1 -1
  155. package/build/src/commands/gap_report.js +2 -2
  156. package/build/src/commands/generator.d.ts +37 -1
  157. package/build/src/commands/generator.js +61 -18
  158. package/build/src/commands/snapshot.d.ts +24 -13
  159. package/build/src/commands/snapshot.js +54 -14
  160. package/build/src/commands/source_markers.d.ts +10 -0
  161. package/build/src/commands/source_markers.js +29 -0
  162. package/build/src/core/activity.d.ts +2 -0
  163. package/build/src/core/activity.js +7 -1
  164. package/build/src/core/administrators.d.ts +38 -0
  165. package/build/src/core/administrators.js +145 -0
  166. package/build/src/core/avatar_image.d.ts +33 -0
  167. package/build/src/core/avatar_image.js +278 -0
  168. package/build/src/core/html_sanitizer.d.ts +20 -0
  169. package/build/src/core/html_sanitizer.js +261 -0
  170. package/build/src/core/like.d.ts +5 -0
  171. package/build/src/core/like.js +5 -0
  172. package/build/src/core/lookups.d.ts +80 -0
  173. package/build/src/core/lookups.js +319 -0
  174. package/build/src/core/mail_settings.d.ts +83 -0
  175. package/build/src/core/mail_settings.js +274 -0
  176. package/build/src/core/mail_test.d.ts +16 -0
  177. package/build/src/core/mail_test.js +81 -6
  178. package/build/src/core/message_templates.d.ts +15 -2
  179. package/build/src/core/message_templates.js +81 -11
  180. package/build/src/core/module_seed.js +2 -1
  181. package/build/src/core/notification_channels.d.ts +235 -0
  182. package/build/src/core/notification_channels.js +660 -0
  183. package/build/src/core/roles.js +26 -9
  184. package/build/src/core/saved_views.d.ts +8 -1
  185. package/build/src/core/saved_views.js +91 -26
  186. package/build/src/core/sequences.d.ts +32 -0
  187. package/build/src/core/sequences.js +97 -0
  188. package/build/src/core/settings.d.ts +5 -0
  189. package/build/src/core/settings.js +31 -3
  190. package/build/src/core/template_language.d.ts +61 -0
  191. package/build/src/core/template_language.js +141 -0
  192. package/build/src/core/ui_preferences.d.ts +10 -0
  193. package/build/src/core/ui_preferences.js +15 -1
  194. package/build/src/core/user_avatars.d.ts +79 -0
  195. package/build/src/core/user_avatars.js +186 -0
  196. package/build/src/core/user_invitations.d.ts +5 -1
  197. package/build/src/core/user_invitations.js +7 -1
  198. package/build/src/core/user_preferences.d.ts +36 -0
  199. package/build/src/core/user_preferences.js +125 -0
  200. package/build/src/core/users.d.ts +2 -0
  201. package/build/src/core/users.js +5 -3
  202. package/build/src/database/calendar_days.d.ts +19 -0
  203. package/build/src/database/calendar_days.js +36 -0
  204. package/build/src/database/schema.d.ts +201 -2
  205. package/build/src/database/schema.js +713 -59
  206. package/build/src/database/schema_diff.d.ts +70 -0
  207. package/build/src/database/schema_diff.js +190 -0
  208. package/build/src/events/record_mutation.d.ts +2 -1
  209. package/build/src/events/record_mutation.js +1 -0
  210. package/build/src/integrations/api_client.d.ts +37 -0
  211. package/build/src/integrations/api_client.js +567 -0
  212. package/build/src/integrations/import_adapters.d.ts +37 -0
  213. package/build/src/integrations/import_adapters.js +35 -0
  214. package/build/src/integrations/imports.d.ts +130 -16
  215. package/build/src/integrations/imports.js +434 -73
  216. package/build/src/integrations/openapi.d.ts +3 -1
  217. package/build/src/integrations/openapi.js +465 -31
  218. package/build/src/integrations/outbound.d.ts +94 -0
  219. package/build/src/integrations/outbound.js +276 -0
  220. package/build/src/integrations/print.d.ts +22 -1
  221. package/build/src/integrations/print.js +68 -22
  222. package/build/src/integrations/print_templates.d.ts +216 -0
  223. package/build/src/integrations/print_templates.js +1017 -0
  224. package/build/src/integrations/sync_jobs.d.ts +139 -0
  225. package/build/src/integrations/sync_jobs.js +416 -0
  226. package/build/src/integrations/webhooks.d.ts +12 -12
  227. package/build/src/integrations/webhooks.js +34 -43
  228. package/build/src/integrations/xlsx.d.ts +41 -0
  229. package/build/src/integrations/xlsx.js +519 -0
  230. package/build/src/languages/ar.d.ts +11 -0
  231. package/build/src/languages/ar.js +358 -0
  232. package/build/src/languages/ar_ui.d.ts +461 -0
  233. package/build/src/languages/ar_ui.js +464 -0
  234. package/build/src/languages/catalog.d.ts +66 -0
  235. package/build/src/languages/catalog.js +152 -0
  236. package/build/src/languages/en.d.ts +7 -0
  237. package/build/src/languages/en.js +352 -0
  238. package/build/src/languages/en_ui.d.ts +3 -0
  239. package/build/src/languages/en_ui.js +458 -0
  240. package/build/src/languages/validation.d.ts +26 -0
  241. package/build/src/languages/validation.js +60 -0
  242. package/build/src/lists/bulk_actions.d.ts +89 -0
  243. package/build/src/lists/bulk_actions.js +268 -0
  244. package/build/src/lists/dashboards.d.ts +138 -0
  245. package/build/src/lists/dashboards.js +290 -0
  246. package/build/src/mcp/tools.js +9 -104
  247. package/build/src/resource/define_resource.d.ts +18 -1
  248. package/build/src/resource/define_resource.js +212 -18
  249. package/build/src/resource/definition.d.ts +44 -0
  250. package/build/src/resource/definition.js +171 -0
  251. package/build/src/resource/registry.js +15 -4
  252. package/build/src/resource/types.d.ts +313 -16
  253. package/build/src/resource/values.d.ts +56 -1
  254. package/build/src/resource/values.js +237 -5
  255. package/build/src/services/settings.d.ts +2 -0
  256. package/build/src/services/settings.js +5 -1
  257. package/build/src/upgrade/legacy.js +2 -2
  258. package/build/src/workflows/calendar.d.ts +9 -0
  259. package/build/src/workflows/calendar.js +44 -0
  260. package/build/src/workflows/define_workflow.d.ts +48 -3
  261. package/build/src/workflows/define_workflow.js +57 -13
  262. package/build/src/workflows/delegations.d.ts +107 -0
  263. package/build/src/workflows/delegations.js +326 -0
  264. package/build/src/workflows/engine.d.ts +80 -4
  265. package/build/src/workflows/engine.js +466 -86
  266. package/build/src/workflows/sla.d.ts +15 -0
  267. package/build/src/workflows/sla.js +8 -0
  268. package/build/stubs/resource_contract.txt +12 -1
  269. package/package.json +9 -2
@@ -0,0 +1,265 @@
1
+ import { subject } from '@casl/ability';
2
+ import { columnName, joinTable } from '../../resource/define_resource.js';
3
+ import { buildAbility, canRecord, inOrgScope, } from '../../auth/ability.js';
4
+ import { conditionSql } from '../../auth/sql.js';
5
+ import { fromRow, selectedFields } from '../contracts.js';
6
+ import { AdulaError, forbiddenAction, notFound } from '../errors.js';
7
+ import { currentLanguage, labelText, translate } from '../../languages/catalog.js';
8
+ import { fieldValue, isMultipleAttachment } from '../../resource/values.js';
9
+ import { isAttachmentId, loadAttachments, } from '../../attachments/attachment_service.js';
10
+ /**
11
+ * The permission level an actor needs to see or write a field: its own permissionLevel,
12
+ * and at least 1 when the resource lists it as hidden.
13
+ */
14
+ export function fieldLevel(resource, key) {
15
+ return Math.max(resource.fields[key].permissionLevel ?? 0, resource.hidden?.includes(key) ? 1 : 0);
16
+ }
17
+ /**
18
+ * Whether a viewer may read a field of a record: exposed by the resource (serialize, or
19
+ * list and show), at the field's permission level, and allowed by the role rules on this
20
+ * record. The per-field change history and the activity entries apply this rule.
21
+ */
22
+ export function readableField(resource, record, ability, actor, key) {
23
+ const serialized = resource.serialize ?? [...resource.list, ...resource.show];
24
+ return (key in resource.fields &&
25
+ serialized.includes(key) &&
26
+ actor.permissionLevel >= fieldLevel(resource, key) &&
27
+ ability.can('view', subject(resource.name, record), key));
28
+ }
29
+ /**
30
+ * Whether an actor may sort, filter or search by a field. Querying reveals values
31
+ * indirectly, so it needs unconditional view access at the field's level.
32
+ */
33
+ export function canQueryField(resource, actor, ability, key) {
34
+ const level = fieldLevel(resource, key);
35
+ // Conditional field rules cannot safely authorize a global sort/search.
36
+ return (actor.permissionLevel >= level &&
37
+ ability.can('view', resource.name, key) &&
38
+ !ability.rules.some((rule) => rule.conditions &&
39
+ (!rule.fields || rule.fields.includes(key)) &&
40
+ (rule.subject === resource.name || rule.subject === 'all')));
41
+ }
42
+ /** The actor's ability, after checking the resource offers the action and the actor holds it. */
43
+ export function authorizeAction(ctx, resource, actor, action) {
44
+ const ability = buildAbility(actor.rules, ctx.registry.all());
45
+ if (!resource.actions.includes(action) || !ability.can(action, resource.name))
46
+ throw forbiddenAction();
47
+ for (const rule of ability.rulesFor(action, resource.name))
48
+ conditionSql(rule.conditions, resource);
49
+ return ability;
50
+ }
51
+ /** Live rows of a resource inside the actor's organization scope. */
52
+ export function scopedQuery(db, resource, actor) {
53
+ const query = db(`${resource.name} as r`).whereNull('r.deleted_at');
54
+ if (resource.scoped) {
55
+ query.join('org_units as ou', 'ou.id', 'r.org_unit_id').where((scope) => {
56
+ if (!actor.orgPaths.length)
57
+ scope.whereRaw('FALSE');
58
+ actor.orgPaths.forEach((path) => scope.orWhereRaw('ou.path <@ ?::ltree', [path]));
59
+ });
60
+ }
61
+ return query;
62
+ }
63
+ /** The qualified columns the ability may read (or write). */
64
+ export function columns(resource, ability, write = false, extra = []) {
65
+ return selectedFields(resource, ability, { write, extra }).map((key) => `r.${resource.fields[key]?.column ?? columnName(key)}`);
66
+ }
67
+ /** One live record within the actor's scope; 404 otherwise. */
68
+ export async function find(db, resource, actor, ability, id, lock = false) {
69
+ const query = scopedQuery(db, resource, actor)
70
+ .where('r.id', id)
71
+ .select(columns(resource, ability, lock));
72
+ if (resource.scoped)
73
+ query.select('ou.path as org_path');
74
+ if (lock)
75
+ query.forUpdate('r');
76
+ const row = await query.first();
77
+ if (!row)
78
+ throw notFound();
79
+ const [record] = await withLinks(db, resource, [fromRow(row, resource)]);
80
+ return record;
81
+ }
82
+ /**
83
+ * Adds the linked ids of every manyToMany field (ascending arrays) to records read
84
+ * from the resource's table, so policies, serialization and audits see them like
85
+ * column values. Mutates and returns the records.
86
+ *
87
+ * Only live targets are linked: a soft-deleted target's id is never shown, and because
88
+ * writes diff against these ids too, its join row survives an edit and the link returns
89
+ * when the target is restored.
90
+ */
91
+ export async function withLinks(db, resource, records) {
92
+ if (!records.length)
93
+ return records;
94
+ for (const [key, field] of Object.entries(resource.fields)) {
95
+ if (field.type !== 'manyToMany')
96
+ continue;
97
+ const join = joinTable(resource.name, key, field);
98
+ const rows = await db(join.table)
99
+ .join(`${field.resource} as t`, 't.id', `${join.table}.${join.target}`)
100
+ .whereNull('t.deleted_at')
101
+ .whereIn(`${join.table}.${join.owner}`, records.map((record) => Number(record.id)))
102
+ .orderBy(`${join.table}.${join.target}`)
103
+ .select(`${join.table}.${join.owner} as owner`, `${join.table}.${join.target} as target`);
104
+ const links = new Map();
105
+ for (const row of rows) {
106
+ const list = links.get(Number(row.owner)) ?? [];
107
+ list.push(Number(row.target));
108
+ links.set(Number(row.owner), list);
109
+ }
110
+ for (const record of records)
111
+ record[key] = links.get(Number(record.id)) ?? [];
112
+ }
113
+ return records;
114
+ }
115
+ /**
116
+ * Applies a filter on a field without a plain column comparison: a multiSelect contains
117
+ * the value, a manyToMany links the id. Returns false for other fields.
118
+ */
119
+ export function collectionFilter(query, resource, key, value) {
120
+ const field = resource.fields[key];
121
+ if (field?.type === 'multiSelect') {
122
+ const column = `r.${field.column ?? columnName(key)}`;
123
+ if (value === null)
124
+ query.where((q) => q.whereNull(column).orWhereRaw("?? = '[]'::jsonb", [column]));
125
+ else
126
+ query.whereRaw('?? @> ?::jsonb', [column, JSON.stringify([value])]);
127
+ return true;
128
+ }
129
+ if (field?.type === 'manyToMany') {
130
+ const join = joinTable(resource.name, key, field);
131
+ const links = (exists) => {
132
+ // Links to soft-deleted targets are not shown (withLinks), so they never match.
133
+ exists
134
+ .from(join.table)
135
+ .join(`${field.resource} as t`, 't.id', `${join.table}.${join.target}`)
136
+ .whereNull('t.deleted_at')
137
+ .whereRaw('?? = r.id', [`${join.table}.${join.owner}`]);
138
+ if (value !== null)
139
+ exists.where(`${join.table}.${join.target}`, value);
140
+ };
141
+ if (value === null)
142
+ query.whereNotExists(links);
143
+ else
144
+ query.whereExists(links);
145
+ return true;
146
+ }
147
+ return false;
148
+ }
149
+ /** A live record regardless of any actor's scope, for system writes. */
150
+ export async function findAny(db, resource, id, lock = false) {
151
+ const query = db(`${resource.name} as r`).whereNull('r.deleted_at').where('r.id', id);
152
+ query.select(selectedFields(resource, buildAbility([], []), { write: true }).map((key) => `r.${resource.fields[key]?.column ?? columnName(key)}`));
153
+ if (resource.scoped)
154
+ query.leftJoin('org_units as ou', 'ou.id', 'r.org_unit_id').select('ou.path as org_path');
155
+ if (lock)
156
+ query.forUpdate('r');
157
+ const row = await query.first();
158
+ if (!row)
159
+ throw notFound();
160
+ const [record] = await withLinks(db, resource, [fromRow(row, resource)]);
161
+ return record;
162
+ }
163
+ /** Scope (404) and conditional rules (403) of one loaded record. */
164
+ export function requireRecord(ability, actor, resource, action, record) {
165
+ if (resource.scoped && !inOrgScope(record.orgPath, actor.orgPaths))
166
+ throw notFound();
167
+ if (!canRecord(ability, actor, resource, action, record))
168
+ throw forbiddenAction();
169
+ }
170
+ /**
171
+ * A child that inherits its unit (`scope.from`, ADR 029) is written only by readers of its
172
+ * parent. The refusal names the missing rule, since the same role may read and delete
173
+ * the child (#140); a parent outside the actor's scope stays 404.
174
+ */
175
+ export function requireParentView(ability, actor, child, parent, record) {
176
+ try {
177
+ requireRecord(ability, actor, parent, 'view', record);
178
+ }
179
+ catch (error) {
180
+ if (!(error instanceof AdulaError) || error.status !== 403)
181
+ throw error;
182
+ throw new AdulaError(403, 'E_FORBIDDEN', translate('errors.parentView', currentLanguage(), {
183
+ child: labelText(child.label),
184
+ parent: labelText(parent.label),
185
+ }));
186
+ }
187
+ }
188
+ /** Which of the resource's actions the actor may take on one record now. */
189
+ export function permissions(resource, record, actor, ability) {
190
+ return Object.fromEntries(resource.actions.map((action) => [
191
+ action,
192
+ canRecord(ability, actor, resource, action, record) &&
193
+ (!resource.submittable ||
194
+ !['update', 'delete', 'submit'].includes(action) ||
195
+ record.docStatus === 0) &&
196
+ (action !== 'cancel' || (resource.submittable && record.docStatus === 1)) &&
197
+ (action !== 'amend' || (resource.submittable && record.docStatus === 2)),
198
+ ]));
199
+ }
200
+ /** Coerces every present field value to its stored representation (422 E_FIELD_VALUE). */
201
+ export function normalizeValues(resource, record) {
202
+ for (const [key, field] of Object.entries(resource.fields)) {
203
+ if (!(key in record))
204
+ continue;
205
+ try {
206
+ record[key] = fieldValue(field, record[key]);
207
+ }
208
+ catch (error) {
209
+ throw new AdulaError(422, 'E_FIELD_VALUE', `${key}: ${error.message}`);
210
+ }
211
+ }
212
+ }
213
+ /** Stored attachment ids become summaries for readers; copies keep policy checks on raw rows. */
214
+ export async function hydrate(db, resource, records, options = {}) {
215
+ const keys = Object.keys(resource.fields).filter((key) => resource.fields[key].type === 'attachment');
216
+ if (!keys.length || !records.length)
217
+ return records;
218
+ // A multiple field holds an ordered array of ids: its summaries keep that order.
219
+ const ids = records.flatMap((record) => keys.flatMap((key) => (Array.isArray(record[key]) ? record[key] : [record[key]])));
220
+ const summaries = await loadAttachments(db, ids.filter(isAttachmentId), options);
221
+ return records.map((record) => {
222
+ const copy = { ...record };
223
+ for (const key of keys) {
224
+ if (!(key in copy))
225
+ continue;
226
+ const value = copy[key];
227
+ if (isMultipleAttachment(resource.fields[key]))
228
+ copy[key] = (Array.isArray(value) ? value : [])
229
+ .map((id) => (isAttachmentId(id) ? summaries.get(id) : undefined))
230
+ .filter((summary) => summary !== undefined);
231
+ else
232
+ copy[key] = isAttachmentId(value) ? (summaries.get(value) ?? null) : null;
233
+ }
234
+ return copy;
235
+ });
236
+ }
237
+ export async function hydrateOne(db, resource, record, options = {}) {
238
+ const [hydrated] = await hydrate(db, resource, [record], options);
239
+ return hydrated;
240
+ }
241
+ /**
242
+ * Active users eligible for a user field: members of the unit at `path` or of one of
243
+ * its ancestors, or (without a path) users sharing organization scope with the actor.
244
+ * A system write on an unscoped resource passes no actor: any active member qualifies.
245
+ */
246
+ export function eligibleUsers(db, path, actor) {
247
+ return db('users as u')
248
+ .whereNull('u.disabled_at')
249
+ .whereExists((members) => {
250
+ members
251
+ .from('user_org_units as m')
252
+ .join('org_units as o', 'o.id', 'm.org_unit_id')
253
+ .whereRaw('m.user_id = u.id');
254
+ if (path !== null)
255
+ members.whereRaw('?::ltree <@ o.path', [path]);
256
+ else if (actor)
257
+ members.where((scope) => {
258
+ if (!actor.orgPaths.length)
259
+ scope.whereRaw('FALSE');
260
+ for (const own of actor.orgPaths)
261
+ scope.orWhereRaw('o.path <@ ?::ltree', [own]).orWhereRaw('o.path @> ?::ltree', [own]);
262
+ });
263
+ })
264
+ .distinct();
265
+ }
@@ -0,0 +1,10 @@
1
+ import type { Knex } from 'knex';
2
+ import type { Actor } from '../../auth/ability.js';
3
+ import { type ResourceContext } from './shared.js';
4
+ /**
5
+ * Clears deleted_at of a soft-deleted record; see ResourceService.restore. Restore is
6
+ * authorized by the actor's delete rule (ADR 046): the resource must offer delete, the
7
+ * actor must hold it, and its conditions and organization scope are evaluated on the
8
+ * deleted record (404 outside the scope, 403 when a condition refuses).
9
+ */
10
+ export declare function restore(ctx: ResourceContext, name: string, id: number, actor: Actor, transaction?: Knex.Transaction): Promise<import("../../resource/types.js").SerializedRecord>;
@@ -0,0 +1,56 @@
1
+ import { fromRow, serialize } from '../contracts.js';
2
+ import { notFound } from '../errors.js';
3
+ import { audit, requireInlineParents } from './lifecycle.js';
4
+ import { authorizeAction, columns, hydrateOne, requireRecord, } from './shared.js';
5
+ /**
6
+ * One soft-deleted record within the actor's organization scope; 404 otherwise. It
7
+ * mirrors shared.find() for rows whose deleted_at is set, so restore never sees a live row.
8
+ */
9
+ async function findDeleted(db, resource, actor, ability, id) {
10
+ const query = db(`${resource.name} as r`).whereNotNull('r.deleted_at').where('r.id', id);
11
+ if (resource.scoped) {
12
+ query
13
+ .join('org_units as ou', 'ou.id', 'r.org_unit_id')
14
+ .where((scope) => {
15
+ if (!actor.orgPaths.length)
16
+ scope.whereRaw('FALSE');
17
+ actor.orgPaths.forEach((path) => scope.orWhereRaw('ou.path <@ ?::ltree', [path]));
18
+ })
19
+ .select('ou.path as org_path');
20
+ }
21
+ query.select(columns(resource, ability, true)).forUpdate('r');
22
+ const row = await query.first();
23
+ if (!row)
24
+ throw notFound();
25
+ return fromRow(row, resource);
26
+ }
27
+ /**
28
+ * Clears deleted_at of a soft-deleted record; see ResourceService.restore. Restore is
29
+ * authorized by the actor's delete rule (ADR 046): the resource must offer delete, the
30
+ * actor must hold it, and its conditions and organization scope are evaluated on the
31
+ * deleted record (404 outside the scope, 403 when a condition refuses).
32
+ */
33
+ export async function restore(ctx, name, id, actor, transaction) {
34
+ const resource = ctx.registry.get(name);
35
+ const ability = authorizeAction(ctx, resource, actor, 'delete');
36
+ if (!Number.isSafeInteger(id) || id <= 0)
37
+ throw notFound();
38
+ const work = async (trx) => {
39
+ const record = await findDeleted(trx, resource, actor, ability, id);
40
+ requireRecord(ability, actor, resource, 'delete', record);
41
+ // An inline line comes back only while its parent is a draft the actor may update.
42
+ await requireInlineParents(ctx, trx, resource, actor, record);
43
+ const values = {
44
+ deleted_at: null,
45
+ updated_by: actor.id,
46
+ updated_at: trx.fn.now(),
47
+ };
48
+ if (resource.version)
49
+ values.version = Number(record.version) + 1;
50
+ const [row] = await trx(name).where({ id }).update(values).returning('*');
51
+ const saved = fromRow(row, resource);
52
+ await audit(ctx, trx, resource, actor, 'restore', saved, []);
53
+ return serialize(resource, await hydrateOne(trx, resource, saved, ctx.attachments), ability, actor);
54
+ };
55
+ return transaction ? work(transaction) : ctx.db.transaction(work);
56
+ }
@@ -0,0 +1,57 @@
1
+ import type { Knex } from 'knex';
2
+ import type { RecordData, SerializedRecord } from '../../resource/types.js';
3
+ import { type Actor } from '../../auth/ability.js';
4
+ import { type ResourceContext } from './shared.js';
5
+ import { type ParentWrite } from './lifecycle.js';
6
+ /** Options of ResourceService.systemSave. */
7
+ export type SystemSaveOptions = {
8
+ /**
9
+ * The user recorded as the author: created/updated by, activity and events. null is an
10
+ * unattributed update by the system itself (for example a workflow whose triggering
11
+ * event named no user): it runs the validator, hooks and lock, keeps updated_by, and
12
+ * writes no activity entry or domain event because there is no author. Creates need one.
13
+ */
14
+ actorId: number | null;
15
+ /** Write inside the module's transaction. */
16
+ trx?: Knex.Transaction;
17
+ /** Why module code wrote the record; stored with the activity entry. */
18
+ reason?: string;
19
+ /** Optimistic lock: when given, it must match the stored version. */
20
+ version?: number;
21
+ /**
22
+ * The person who chose the values, when module code writes a choice made by a user,
23
+ * such as a supervisor reassigning a record. A new value of a user field must then be
24
+ * eligible for them as in a user save; without it, any active member qualifies on
25
+ * unscoped resources.
26
+ */
27
+ chooser?: Actor;
28
+ /**
29
+ * Also write a submitted document (docStatus 1), as workflow update steps do. Drafts
30
+ * are always writable; cancelled documents stay locked.
31
+ */
32
+ submitted?: boolean;
33
+ };
34
+ /** What persist() needs to know about a write decided by module code. */
35
+ type SystemWrite = {
36
+ reason?: string;
37
+ version?: number;
38
+ chooser?: Actor;
39
+ submitted?: boolean;
40
+ unattributed?: boolean;
41
+ };
42
+ /** A module-code write; see ResourceService.systemSave. */
43
+ export declare function systemSave(ctx: ResourceContext, name: string, values: RecordData, id: number | undefined, options: SystemSaveOptions): Promise<RecordData>;
44
+ /** Moves records whose scope follows a parent; see ResourceService.rehome. */
45
+ export declare function rehome(ctx: ResourceContext, parentName: string, parentId: number, options: Omit<SystemSaveOptions, 'version'>): Promise<number>;
46
+ /**
47
+ * Creates or updates one record, for a user (save) or for module code (system). Every
48
+ * user write, every inline row and every amended copy goes through here.
49
+ */
50
+ export declare function persist(ctx: ResourceContext, name: string, actor: Actor, input: RecordData, id?: number, transaction?: Knex.Transaction, parentWrite?: ParentWrite, system?: SystemWrite): Promise<SerializedRecord>;
51
+ /**
52
+ * Amend-by-copy: a cancelled document is copied into a new draft that points to
53
+ * it through amended_from_id, together with its inline lines. The original stays
54
+ * cancelled and unchanged; sequence fields receive new numbers.
55
+ */
56
+ export declare function amend(ctx: ResourceContext, name: string, id: number, actor: Actor, transaction?: Knex.Transaction): Promise<SerializedRecord>;
57
+ export {};