adula 2.0.0 → 2.2.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 (214) hide show
  1. package/README.md +149 -18
  2. package/build/agent/AGENTS.template.md +4 -4
  3. package/build/agent/capabilities.md +22 -11
  4. package/build/agent/skills/adula-frontend-design/SKILL.md +1 -1
  5. package/build/agent/skills/idea-review/SKILL.md +2 -2
  6. package/build/commands/adula_outbox.d.ts +10 -0
  7. package/build/commands/adula_outbox.js +11 -0
  8. package/build/commands/adula_restore_reconcile.d.ts +10 -0
  9. package/build/commands/adula_restore_reconcile.js +34 -0
  10. package/build/commands/adula_runtime_health.d.ts +10 -0
  11. package/build/commands/adula_runtime_health.js +27 -0
  12. package/build/commands/adula_uploads_prune.d.ts +10 -0
  13. package/build/commands/adula_uploads_prune.js +16 -0
  14. package/build/commands/app.d.ts +10 -0
  15. package/build/commands/app.js +64 -0
  16. package/build/commands/backup_create.d.ts +11 -0
  17. package/build/commands/backup_create.js +99 -0
  18. package/build/commands/backup_restore_files.d.ts +11 -0
  19. package/build/commands/backup_restore_files.js +44 -0
  20. package/build/commands/backup_restore_test.d.ts +12 -0
  21. package/build/commands/backup_restore_test.js +185 -0
  22. package/build/commands/backup_services.d.ts +31 -0
  23. package/build/commands/backup_services.js +6 -0
  24. package/build/commands/backup_verify.d.ts +9 -0
  25. package/build/commands/backup_verify.js +59 -0
  26. package/build/commands/backup_verify_snapshot.d.ts +10 -0
  27. package/build/commands/backup_verify_snapshot.js +37 -0
  28. package/build/commands/client.d.ts +16 -0
  29. package/build/commands/client.js +71 -0
  30. package/build/commands/doctor.js +4 -1
  31. package/build/commands/install.d.ts +8 -0
  32. package/build/commands/install.js +63 -45
  33. package/build/commands/main.d.ts +3 -2
  34. package/build/commands/main.js +26 -0
  35. package/build/commands/module_add.js +4 -20
  36. package/build/commands/resource.d.ts +2 -0
  37. package/build/commands/resource.js +12 -3
  38. package/build/commands/resource_migration.d.ts +15 -0
  39. package/build/commands/resource_migration.js +72 -0
  40. package/build/commands/resource_snapshot.d.ts +2 -0
  41. package/build/commands/resource_snapshot.js +3 -0
  42. package/build/commands/sla_evaluate.d.ts +14 -0
  43. package/build/commands/sla_evaluate.js +16 -0
  44. package/build/commands/ui.js +5 -3
  45. package/build/commands/ui_css.d.ts +9 -0
  46. package/build/commands/ui_css.js +19 -0
  47. package/build/commands/upgrade.d.ts +1 -1
  48. package/build/commands/upgrade.js +1 -1
  49. package/build/configure.js +1 -1
  50. package/build/database/migrations/1770000000020_two_factor.d.ts +5 -0
  51. package/build/database/migrations/1770000000020_two_factor.js +10 -0
  52. package/build/database/migrations/1770000000041_import_modes.d.ts +5 -0
  53. package/build/database/migrations/1770000000041_import_modes.js +10 -0
  54. package/build/database/migrations/1770000000042_sync_jobs.d.ts +5 -0
  55. package/build/database/migrations/1770000000042_sync_jobs.js +10 -0
  56. package/build/database/migrations/1770000000043_notification_channels.d.ts +5 -0
  57. package/build/database/migrations/1770000000043_notification_channels.js +10 -0
  58. package/build/database/migrations/1770000000044_channel_confirmations.d.ts +5 -0
  59. package/build/database/migrations/1770000000044_channel_confirmations.js +10 -0
  60. package/build/database/migrations/1770000000045_import_leases.d.ts +5 -0
  61. package/build/database/migrations/1770000000045_import_leases.js +10 -0
  62. package/build/database/migrations/1770000000046_workflow_delegation_sla.d.ts +5 -0
  63. package/build/database/migrations/1770000000046_workflow_delegation_sla.js +10 -0
  64. package/build/database/migrations/1770000000049_print_templates.d.ts +5 -0
  65. package/build/database/migrations/1770000000049_print_templates.js +10 -0
  66. package/build/index.d.ts +56 -10
  67. package/build/index.js +34 -6
  68. package/build/providers/adula_provider.d.ts +2 -0
  69. package/build/providers/adula_provider.js +7 -0
  70. package/build/src/admin/contracts.js +1 -1
  71. package/build/src/admin/controller.d.ts +14 -1
  72. package/build/src/admin/controller.js +77 -13
  73. package/build/src/admin/errors.d.ts +32 -0
  74. package/build/src/admin/errors.js +63 -1
  75. package/build/src/admin/presentation.d.ts +21 -2
  76. package/build/src/admin/resource/editor.d.ts +59 -0
  77. package/build/src/admin/resource/editor.js +323 -0
  78. package/build/src/admin/resource/export.d.ts +37 -0
  79. package/build/src/admin/resource/export.js +181 -0
  80. package/build/src/admin/resource/lifecycle.d.ts +21 -0
  81. package/build/src/admin/resource/lifecycle.js +91 -0
  82. package/build/src/admin/resource/query.d.ts +100 -0
  83. package/build/src/admin/resource/query.js +508 -0
  84. package/build/src/admin/resource/read.d.ts +106 -0
  85. package/build/src/admin/resource/read.js +327 -0
  86. package/build/src/admin/resource/shared.d.ts +77 -0
  87. package/build/src/admin/resource/shared.js +222 -0
  88. package/build/src/admin/resource/trash.d.ts +10 -0
  89. package/build/src/admin/resource/trash.js +56 -0
  90. package/build/src/admin/resource/write.d.ts +57 -0
  91. package/build/src/admin/resource/write.js +574 -0
  92. package/build/src/admin/resource_service.d.ts +66 -193
  93. package/build/src/admin/resource_service.js +69 -1345
  94. package/build/src/attachments/attachment_service.d.ts +46 -2
  95. package/build/src/attachments/attachment_service.js +96 -4
  96. package/build/src/auth/conditions.d.ts +5 -0
  97. package/build/src/auth/conditions.js +26 -3
  98. package/build/src/auth/sql.js +17 -5
  99. package/build/src/auth/two_factor.d.ts +96 -0
  100. package/build/src/auth/two_factor.js +259 -0
  101. package/build/src/collaboration/assignments.d.ts +36 -1
  102. package/build/src/collaboration/assignments.js +132 -66
  103. package/build/src/collaboration/record_collaboration.d.ts +2 -3
  104. package/build/src/collaboration/record_collaboration.js +19 -16
  105. package/build/src/collaboration/shared.d.ts +16 -0
  106. package/build/src/collaboration/shared.js +21 -0
  107. package/build/src/commands/app_scaffold.d.ts +72 -0
  108. package/build/src/commands/app_scaffold.js +285 -0
  109. package/build/src/commands/capabilities.js +34 -8
  110. package/build/src/commands/doctor.d.ts +14 -2
  111. package/build/src/commands/doctor.js +50 -5
  112. package/build/src/commands/gap_report.d.ts +1 -1
  113. package/build/src/commands/gap_report.js +2 -2
  114. package/build/src/commands/generator.d.ts +37 -1
  115. package/build/src/commands/generator.js +61 -18
  116. package/build/src/commands/snapshot.d.ts +10 -13
  117. package/build/src/commands/snapshot.js +31 -14
  118. package/build/src/commands/source_markers.d.ts +10 -0
  119. package/build/src/commands/source_markers.js +29 -0
  120. package/build/src/core/activity.d.ts +2 -0
  121. package/build/src/core/activity.js +7 -1
  122. package/build/src/core/administrators.d.ts +38 -0
  123. package/build/src/core/administrators.js +129 -0
  124. package/build/src/core/html_sanitizer.d.ts +20 -0
  125. package/build/src/core/html_sanitizer.js +261 -0
  126. package/build/src/core/like.d.ts +5 -0
  127. package/build/src/core/like.js +5 -0
  128. package/build/src/core/lookups.d.ts +80 -0
  129. package/build/src/core/lookups.js +319 -0
  130. package/build/src/core/message_templates.d.ts +7 -2
  131. package/build/src/core/message_templates.js +72 -11
  132. package/build/src/core/module_seed.js +2 -1
  133. package/build/src/core/notification_channels.d.ts +235 -0
  134. package/build/src/core/notification_channels.js +660 -0
  135. package/build/src/core/roles.js +2 -2
  136. package/build/src/core/saved_views.d.ts +8 -1
  137. package/build/src/core/saved_views.js +36 -2
  138. package/build/src/core/sequences.d.ts +32 -0
  139. package/build/src/core/sequences.js +97 -0
  140. package/build/src/core/settings.d.ts +5 -0
  141. package/build/src/core/settings.js +19 -2
  142. package/build/src/core/template_language.d.ts +61 -0
  143. package/build/src/core/template_language.js +141 -0
  144. package/build/src/core/ui_preferences.d.ts +4 -0
  145. package/build/src/core/ui_preferences.js +4 -1
  146. package/build/src/core/user_invitations.d.ts +5 -1
  147. package/build/src/core/user_invitations.js +7 -1
  148. package/build/src/core/users.js +1 -1
  149. package/build/src/database/calendar_days.d.ts +19 -0
  150. package/build/src/database/calendar_days.js +36 -0
  151. package/build/src/database/schema.d.ts +155 -2
  152. package/build/src/database/schema.js +531 -59
  153. package/build/src/database/schema_diff.d.ts +56 -0
  154. package/build/src/database/schema_diff.js +157 -0
  155. package/build/src/events/record_mutation.d.ts +2 -1
  156. package/build/src/events/record_mutation.js +1 -0
  157. package/build/src/integrations/api_client.d.ts +37 -0
  158. package/build/src/integrations/api_client.js +552 -0
  159. package/build/src/integrations/import_adapters.d.ts +37 -0
  160. package/build/src/integrations/import_adapters.js +35 -0
  161. package/build/src/integrations/imports.d.ts +118 -16
  162. package/build/src/integrations/imports.js +406 -73
  163. package/build/src/integrations/openapi.d.ts +3 -1
  164. package/build/src/integrations/openapi.js +454 -31
  165. package/build/src/integrations/outbound.d.ts +51 -0
  166. package/build/src/integrations/outbound.js +195 -0
  167. package/build/src/integrations/print.d.ts +21 -1
  168. package/build/src/integrations/print.js +63 -21
  169. package/build/src/integrations/print_templates.d.ts +216 -0
  170. package/build/src/integrations/print_templates.js +1015 -0
  171. package/build/src/integrations/sync_jobs.d.ts +139 -0
  172. package/build/src/integrations/sync_jobs.js +416 -0
  173. package/build/src/integrations/webhooks.d.ts +12 -12
  174. package/build/src/integrations/webhooks.js +34 -43
  175. package/build/src/languages/ar.d.ts +11 -0
  176. package/build/src/languages/ar.js +336 -0
  177. package/build/src/languages/ar_ui.d.ts +332 -0
  178. package/build/src/languages/ar_ui.js +333 -0
  179. package/build/src/languages/catalog.d.ts +66 -0
  180. package/build/src/languages/catalog.js +152 -0
  181. package/build/src/languages/en.d.ts +7 -0
  182. package/build/src/languages/en.js +330 -0
  183. package/build/src/languages/en_ui.d.ts +3 -0
  184. package/build/src/languages/en_ui.js +328 -0
  185. package/build/src/languages/validation.d.ts +26 -0
  186. package/build/src/languages/validation.js +60 -0
  187. package/build/src/lists/bulk_actions.d.ts +89 -0
  188. package/build/src/lists/bulk_actions.js +268 -0
  189. package/build/src/lists/dashboards.d.ts +96 -0
  190. package/build/src/lists/dashboards.js +241 -0
  191. package/build/src/mcp/tools.js +1 -1
  192. package/build/src/resource/define_resource.d.ts +18 -1
  193. package/build/src/resource/define_resource.js +205 -18
  194. package/build/src/resource/definition.d.ts +44 -0
  195. package/build/src/resource/definition.js +171 -0
  196. package/build/src/resource/registry.js +15 -4
  197. package/build/src/resource/types.d.ts +304 -16
  198. package/build/src/resource/values.d.ts +56 -1
  199. package/build/src/resource/values.js +237 -5
  200. package/build/src/services/settings.d.ts +2 -0
  201. package/build/src/services/settings.js +5 -1
  202. package/build/src/upgrade/legacy.js +2 -2
  203. package/build/src/workflows/calendar.d.ts +9 -0
  204. package/build/src/workflows/calendar.js +44 -0
  205. package/build/src/workflows/define_workflow.d.ts +48 -3
  206. package/build/src/workflows/define_workflow.js +57 -13
  207. package/build/src/workflows/delegations.d.ts +93 -0
  208. package/build/src/workflows/delegations.js +287 -0
  209. package/build/src/workflows/engine.d.ts +69 -4
  210. package/build/src/workflows/engine.js +441 -83
  211. package/build/src/workflows/sla.d.ts +15 -0
  212. package/build/src/workflows/sla.js +8 -0
  213. package/build/stubs/resource_contract.txt +12 -1
  214. package/package.json +5 -2
@@ -1,97 +1,55 @@
1
1
  import type { Knex } from 'knex';
2
2
  import type { ResourceRegistry } from '../resource/registry.js';
3
- import type { Action, JsonValue, RecordData, Resource, SerializedRecord } from '../resource/types.js';
4
- import { type Actor, type AdulaAbility } from '../auth/ability.js';
5
- import { type Conditions } from '../auth/conditions.js';
6
- import type { ResourceDescription, ResourceNavigation, ResourceField } from './presentation.js';
7
- export type AggregateOptions = {
8
- /** Up to three queryable fields (docStatus and orgUnitId are also accepted). */
9
- groupBy?: string[];
10
- /** Count rows per group (default true). */
11
- count?: boolean;
12
- /** Integer or money fields to total per group; money totals are decimal strings. */
13
- sum?: string[];
14
- /** Equality filters, as in list(). */
15
- filters?: Record<string, unknown>;
16
- /** Role-rule style conditions ($eq, $ne, $in, $lt, $gt, $like, "$actor.id"). */
17
- where?: Conditions;
18
- search?: string;
19
- };
20
- export type AggregateRow = {
21
- group: Record<string, JsonValue>;
22
- count?: number;
23
- sum?: Record<string, string | null>;
24
- };
25
- export type ListOptions = {
26
- limit?: number;
27
- cursor?: string;
28
- search?: string;
29
- sort?: string;
30
- direction?: 'asc' | 'desc';
31
- filters?: Record<string, unknown>;
32
- /** Only records carrying this tag (see RecordCollaboration.setTags). */
33
- tag?: string;
34
- estimate?: boolean;
35
- };
3
+ import type { Action, RecordData, SerializedRecord } from '../resource/types.js';
4
+ import type { Actor } from '../auth/ability.js';
5
+ import type { ResourceDescription, ResourceNavigation } from './presentation.js';
6
+ import type { AttachmentPreviewOptions } from '../attachments/attachment_service.js';
7
+ import { type CsvExport, type ExportOptions } from './resource/export.js';
8
+ import type { AggregateOptions, AggregateRow, ListOptions } from './resource/query.js';
9
+ import type { SystemSaveOptions } from './resource/write.js';
10
+ export { canQueryField } from './resource/shared.js';
11
+ export type { AggregateOptions, AggregateRow, ListOptions, ListFilterScalar, ListFilterValue, } from './resource/query.js';
12
+ export { EXPORT_ROW_LIMIT } from './resource/export.js';
13
+ export type { CsvExport, ExportOptions } from './resource/export.js';
14
+ export type { SystemSaveOptions } from './resource/write.js';
36
15
  /**
37
- * Whether an actor may sort, filter or search by a field. Querying reveals values
38
- * indirectly, so it needs unconditional view access at the field's level.
16
+ * Authorized reads and writes of registered resources. The work is done by the modules
17
+ * under ./resource (query, read, editor, write, lifecycle); this class keeps the public
18
+ * surface and hands them its database and registry.
39
19
  */
40
- export declare function canQueryField(resource: Resource, actor: Actor, ability: AdulaAbility, key: string): boolean;
41
- /** Options of ResourceService.systemSave. */
42
- export type SystemSaveOptions = {
43
- /** The user recorded as the author: created/updated by, activity and events. */
44
- actorId: number;
45
- /** Write inside the module's transaction. */
46
- trx?: Knex.Transaction;
47
- /** Why module code wrote the record; stored with the activity entry. */
48
- reason?: string;
49
- /** Optimistic lock: when given, it must match the stored version. */
50
- version?: number;
51
- /**
52
- * The person who chose the values, when module code writes a choice made by a user,
53
- * such as a supervisor reassigning a record. A new value of a user field must then be
54
- * eligible for them as in a user save; without it, any active member qualifies on
55
- * unscoped resources.
56
- */
57
- chooser?: Actor;
58
- };
59
20
  export declare class ResourceService {
60
21
  private db;
61
22
  private registry;
62
- constructor(db: Knex, registry: ResourceRegistry);
23
+ private context;
24
+ /** `attachments.pdfPreview: false` reports PDFs as download-only in summaries (ADR 047). */
25
+ constructor(db: Knex, registry: ResourceRegistry, options?: {
26
+ attachments?: AttachmentPreviewOptions;
27
+ });
28
+ /**
29
+ * Runs work in one database transaction; pass the transaction to save(), transition(),
30
+ * restore() or amend() so several reads and writes commit or roll back together.
31
+ */
32
+ transaction<T>(work: (trx: Knex.Transaction) => Promise<T>): Promise<T>;
63
33
  /** The Arabic label of a registered resource, for notifications and titles. */
64
34
  label(name: string): string;
65
35
  /** Project navigation is derived from registered resources and the current actor. */
66
36
  navigation(actor: Actor): ResourceNavigation;
67
37
  describe(name: string, actor: Actor): ResourceDescription;
68
- private permissions;
69
- private normalizeValues;
70
- /** Stored attachment ids become summaries for readers; copies keep policy checks on raw rows. */
71
- private hydrate;
72
- private hydrateOne;
73
- private authorizeAction;
74
- private scopedQuery;
75
- private columns;
76
- private find;
77
- /** A live record regardless of any actor's scope, for system writes. */
78
- private findAny;
79
- private requireRecord;
80
38
  /**
81
39
  * Authorizes one record for collaboration features (comments, tags, assignments...).
82
40
  * Scope and conditional rules apply exactly as for show/update.
83
41
  */
84
42
  access(name: string, id: number, actor: Actor, action?: Action, db?: Knex): Promise<{
85
- resource: Resource;
43
+ resource: import("../resource/types.js").Resource;
86
44
  record: RecordData;
87
- ability: AdulaAbility;
45
+ ability: import("../auth/ability.js").AdulaAbility;
88
46
  }>;
89
47
  /** Whether a (possibly other) actor may perform an action on a record; never throws for denial. */
90
48
  permits(name: string, id: number, actor: Actor, action?: Action): Promise<boolean>;
91
49
  list(name: string, actor: Actor, options?: ListOptions): Promise<{
92
50
  data: SerializedRecord[];
93
51
  permissions: {
94
- [k: string]: Partial<Record<Action, boolean>>;
52
+ [k: string]: Partial<Record<Action | "restore", boolean>>;
95
53
  };
96
54
  meta: {
97
55
  limit: number;
@@ -100,7 +58,6 @@ export declare class ResourceService {
100
58
  };
101
59
  related: Record<string, SerializedRecord[]>;
102
60
  }>;
103
- private canQueryField;
104
61
  /**
105
62
  * Counts and totals over the records the actor may view, grouped by queryable fields,
106
63
  * for dashboards. Authorization is list()'s: the same rules, organization scope and
@@ -111,9 +68,6 @@ export declare class ResourceService {
111
68
  rows: AggregateRow[];
112
69
  truncated: boolean;
113
70
  }>;
114
- private preload;
115
- /** Formats record titles of one resource, loading the labels of its title lookups once. */
116
- private titler;
117
71
  /**
118
72
  * Titles of records the actor may view, read under the actor's field access (#32).
119
73
  * Records the actor cannot view are left out; callers fall back to the record id.
@@ -121,7 +75,7 @@ export declare class ResourceService {
121
75
  titles(name: string, ids: readonly number[], actor: Actor): Promise<Map<number, string>>;
122
76
  show(name: string, id: number, actor: Actor): Promise<{
123
77
  data: SerializedRecord;
124
- permissions: Partial<Record<Action, boolean>>;
78
+ permissions: Partial<Record<Action | "restore", boolean>>;
125
79
  related: Record<string, SerializedRecord[]>;
126
80
  }>;
127
81
  relationOptions(name: string, key: string, actor: Actor, options?: {
@@ -139,25 +93,27 @@ export declare class ResourceService {
139
93
  }[];
140
94
  nextCursor: string | null;
141
95
  }>;
142
- /**
143
- * Choices for a user field. A form lists active members of the record's unit or its
144
- * ancestors (the users the record is visible to through membership); a filter lists
145
- * active users who share organization scope with the actor. Only names are returned.
146
- */
147
- private userOptions;
148
- /**
149
- * Active users eligible for a user field: members of the unit at `path` or of one of
150
- * its ancestors, or (without a path) users sharing organization scope with the actor.
151
- * A system write on an unscoped resource passes no actor: any active member qualifies.
152
- */
153
- private eligibleUsers;
154
96
  /** Deferred relation reads re-authorize the parent and each child on every request. */
155
97
  children(name: string, id: number, actor: Actor): Promise<Record<string, {
156
98
  rows: SerializedRecord[];
157
99
  hasMore: boolean;
100
+ related?: Record<string, SerializedRecord[]>;
101
+ }>>;
102
+ /**
103
+ * The lines of a printed document (ADR 048), authorized like children(): the hasMany
104
+ * field's rules and level, the child's view permission and each line's scope apply,
105
+ * and a group is read only when the record exposes it (`serialize`, or `list` and
106
+ * `show`) or one of the resource's code print templates declares it. Each group holds up
107
+ * to `limit` rows (`hasMore` beyond) with the display rows of the lines' relations.
108
+ */
109
+ documentLines(name: string, id: number, actor: Actor, options: {
110
+ fields: readonly string[];
111
+ limit: number;
112
+ }): Promise<Record<string, {
113
+ rows: SerializedRecord[];
114
+ hasMore: boolean;
115
+ related?: Record<string, SerializedRecord[]>;
158
116
  }>>;
159
- /** Inline children of an already authorized parent record. */
160
- private childrenOf;
161
117
  /** Active lookup labels for the lookup fields the actor may read on this resource. */
162
118
  lookups(name: string, actor: Actor): Promise<Record<string, {
163
119
  value: string;
@@ -170,10 +126,6 @@ export declare class ResourceService {
170
126
  fields: string[];
171
127
  actorId: number;
172
128
  actorName: string | null;
173
- /**
174
- * @deprecated Always null. Kept so project-owned copies of resource-show from
175
- * earlier releases still compile; they fall back to the actor id.
176
- */
177
129
  actorEmail: string | null;
178
130
  createdAt: string;
179
131
  }[]>;
@@ -185,6 +137,7 @@ export declare class ResourceService {
185
137
  children: Record<string, {
186
138
  rows: SerializedRecord[];
187
139
  hasMore: boolean;
140
+ related?: Record<string, SerializedRecord[]>;
188
141
  }>;
189
142
  activity: {
190
143
  id: number;
@@ -192,22 +145,16 @@ export declare class ResourceService {
192
145
  fields: string[];
193
146
  actorId: number;
194
147
  actorName: string | null;
195
- /**
196
- * @deprecated Always null. Kept so project-owned copies of resource-show from
197
- * earlier releases still compile; they fall back to the actor id.
198
- */
199
148
  actorEmail: string | null;
200
149
  createdAt: string;
201
150
  }[];
202
151
  }>;
203
152
  /** show(), children() and activity() of one record from a single record read. */
204
153
  record(name: string, id: number, actor: Actor): Promise<{
205
- data: SerializedRecord;
206
- permissions: Partial<Record<Action, boolean>>;
207
- related: Record<string, SerializedRecord[]>;
208
154
  children: Record<string, {
209
155
  rows: SerializedRecord[];
210
156
  hasMore: boolean;
157
+ related?: Record<string, SerializedRecord[]>;
211
158
  }>;
212
159
  activity: {
213
160
  id: number;
@@ -215,15 +162,13 @@ export declare class ResourceService {
215
162
  fields: string[];
216
163
  actorId: number;
217
164
  actorName: string | null;
218
- /**
219
- * @deprecated Always null. Kept so project-owned copies of resource-show from
220
- * earlier releases still compile; they fall back to the actor id.
221
- */
222
165
  actorEmail: string | null;
223
166
  createdAt: string;
224
167
  }[];
168
+ data: SerializedRecord;
169
+ permissions: Partial<Record<Action | "restore", boolean>>;
170
+ related: Record<string, SerializedRecord[]>;
225
171
  }>;
226
- private activityOf;
227
172
  /**
228
173
  * The form description for create (no id) or update. `defaults` pre-fills a create form
229
174
  * (#48), for example `?defaults[violation]=13`: only visible form fields are used, a
@@ -237,87 +182,7 @@ export declare class ResourceService {
237
182
  name: string;
238
183
  label: string;
239
184
  recordLabel: string | null;
240
- fields: ({
241
- label: import("../resource/types.js").Label;
242
- column?: string;
243
- required?: boolean;
244
- unique?: boolean;
245
- sortable?: boolean;
246
- searchable?: boolean;
247
- filterable?: boolean;
248
- permissionLevel?: number;
249
- sequence?: string;
250
- type: "string" | "text" | "integer" | "money" | "boolean" | "date" | "datetime" | "json";
251
- key: string;
252
- } | {
253
- label: import("../resource/types.js").Label;
254
- column?: string;
255
- required?: boolean;
256
- unique?: boolean;
257
- sortable?: boolean;
258
- searchable?: boolean;
259
- filterable?: boolean;
260
- permissionLevel?: number;
261
- sequence?: string;
262
- type: "attachment";
263
- accept?: string[] | "any";
264
- maxSize?: string;
265
- key: string;
266
- } | {
267
- label: import("../resource/types.js").Label;
268
- column?: string;
269
- required?: boolean;
270
- unique?: boolean;
271
- sortable?: boolean;
272
- searchable?: boolean;
273
- filterable?: boolean;
274
- permissionLevel?: number;
275
- sequence?: string;
276
- type: "belongsTo";
277
- resource: string;
278
- key: string;
279
- } | {
280
- label: import("../resource/types.js").Label;
281
- column?: string;
282
- required?: boolean;
283
- unique?: boolean;
284
- sortable?: boolean;
285
- searchable?: boolean;
286
- filterable?: boolean;
287
- permissionLevel?: number;
288
- sequence?: string;
289
- type: "user";
290
- key: string;
291
- } | {
292
- label: import("../resource/types.js").Label;
293
- column?: string;
294
- required?: boolean;
295
- unique?: boolean;
296
- sortable?: boolean;
297
- searchable?: boolean;
298
- filterable?: boolean;
299
- permissionLevel?: number;
300
- sequence?: string;
301
- type: "hasMany";
302
- resource: string;
303
- foreignKey: string;
304
- inline?: boolean;
305
- key: string;
306
- } | {
307
- label: import("../resource/types.js").Label;
308
- column?: string;
309
- required?: boolean;
310
- unique?: boolean;
311
- sortable?: boolean;
312
- searchable?: boolean;
313
- filterable?: boolean;
314
- permissionLevel?: number;
315
- sequence?: string;
316
- type: "lookup";
317
- group: string;
318
- key: string;
319
- })[];
320
- /** Initial values of a create form, already checked against the actor's access. */
185
+ fields: import("./presentation.js").ResourceField[];
321
186
  defaults: SerializedRecord;
322
187
  inline: Record<string, {
323
188
  rows: SerializedRecord[];
@@ -327,7 +192,7 @@ export declare class ResourceService {
327
192
  update: boolean;
328
193
  delete: boolean;
329
194
  }>;
330
- fields: ResourceField[];
195
+ fields: import("./presentation.js").ResourceField[];
331
196
  createFields: string[];
332
197
  updateFields: Record<string, string[]>;
333
198
  }>;
@@ -341,7 +206,6 @@ export declare class ResourceService {
341
206
  label: string;
342
207
  }[];
343
208
  scoped: boolean;
344
- /** The belongsTo field whose record decides the unit; the form shows no unit picker. */
345
209
  scopeFrom: string | null;
346
210
  record: SerializedRecord | null;
347
211
  }>;
@@ -361,16 +225,25 @@ export declare class ResourceService {
361
225
  * `updated` event, or right after moving the parent. Returns the number of moved records.
362
226
  */
363
227
  rehome(parentName: string, parentId: number, options: Omit<SystemSaveOptions, 'version'>): Promise<number>;
364
- private persist;
365
- private requireVersion;
366
- /** Inline children share the parent's draft state, organization and update authority. */
367
- private requireInlineParents;
368
228
  transition(name: string, id: number, actor: Actor, action: 'delete' | 'submit' | 'cancel', version?: unknown, transaction?: Knex.Transaction): Promise<SerializedRecord>;
229
+ /**
230
+ * Restores a soft-deleted record (ADR 046). Authorized by the actor's delete rule: its
231
+ * conditions and organization scope are evaluated on the deleted record (404 outside
232
+ * the scope or when the record is not deleted, 403 when a condition refuses). Records a
233
+ * `restore` activity and a `<module>.<resource>.restored` event.
234
+ */
235
+ restore(name: string, id: number, actor: Actor, transaction?: Knex.Transaction): Promise<SerializedRecord>;
236
+ /**
237
+ * The currently filtered list as CSV (BOM, CRLF), read through list() with the same
238
+ * authorization, filters, search, tag and sort; columns are the list fields the actor
239
+ * may read, as display values. Above EXPORT_ROW_LIMIT rows it is 422 E_EXPORT_LIMIT.
240
+ * Every export is recorded in the activity log (`core.exports`, `exported`).
241
+ */
242
+ export(name: string, actor: Actor, options?: ExportOptions): Promise<CsvExport>;
369
243
  /**
370
244
  * Amend-by-copy: a cancelled document is copied into a new draft that points to
371
245
  * it through amended_from_id, together with its inline lines. The original stays
372
246
  * cancelled and unchanged; sequence fields receive new numbers.
373
247
  */
374
248
  amend(name: string, id: number, actor: Actor, transaction?: Knex.Transaction): Promise<SerializedRecord>;
375
- private audit;
376
249
  }