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
@@ -3,13 +3,35 @@ import type { Actor } from '../auth/ability.js';
3
3
  import type { ResourceService } from '../admin/resource_service.js';
4
4
  import type { ResourceRegistry } from '../resource/registry.js';
5
5
  import type { Field } from '../resource/types.js';
6
+ import { type ImportAdapter } from './import_adapters.js';
7
+ /** Batch states before dry runs; kept for compatibility. See ImportBatchStatus. */
6
8
  export type ImportStatus = 'mapping' | 'queued' | 'running' | 'done' | 'failed';
9
+ /** Every batch state; 'validated' is a finished dry run waiting for the real import. */
10
+ export type ImportBatchStatus = ImportStatus | 'validated';
11
+ /** 'create' adds every row; 'upsert' updates the live record whose unique `matchField` matches. */
12
+ export type ImportMode = 'create' | 'upsert';
7
13
  export type ImportTarget = {
8
14
  key: string;
9
15
  label: string;
10
16
  type: string;
11
17
  required: boolean;
12
18
  };
19
+ /** An importable field as ImportBatches returns it. */
20
+ export type ImportTargetField = ImportTarget & {
21
+ /** Marked `unique` in the definition: usable as an upsert match field. */
22
+ unique: boolean;
23
+ };
24
+ /** One row's outcome in a dry run: what the real import would do, or why it would fail. */
25
+ export type ImportReportRow = {
26
+ row: number;
27
+ ok: boolean;
28
+ action?: 'create' | 'update';
29
+ message?: string;
30
+ };
31
+ /**
32
+ * The batch shape before import modes; kept for compatibility.
33
+ * @deprecated Use ImportBatchRecord, which ImportBatches returns.
34
+ */
13
35
  export type ImportBatch = {
14
36
  id: number;
15
37
  resource: string;
@@ -31,43 +53,135 @@ export type ImportBatch = {
31
53
  finishedAt: string | null;
32
54
  targets: ImportTarget[];
33
55
  };
56
+ /** An import batch with its mode, dry-run state and per-row report. */
57
+ export type ImportBatchRecord = Omit<ImportBatch, 'status' | 'targets'> & {
58
+ status: ImportBatchStatus;
59
+ mode: ImportMode;
60
+ matchField: string | null;
61
+ /** The batch is (or was last) processed as a validation run that saves nothing. */
62
+ dryRun: boolean;
63
+ /** Rows an upsert updated (or, in a dry run, would update). */
64
+ updated: number;
65
+ /** Per-row dry-run report; empty for list() and for real imports. */
66
+ report: ImportReportRow[];
67
+ targets: ImportTargetField[];
68
+ };
34
69
  export type ActorSource = {
35
70
  load(id: number): Promise<Actor>;
36
71
  };
72
+ export type ImportBatchesOptions = {
73
+ /** Extra file formats; CSV and xlsx are always available. See ImportAdapter. */
74
+ adapters?: ImportAdapter[];
75
+ };
76
+ export type ImportCreateInput = {
77
+ fileName: unknown;
78
+ /** UTF-8 text, raw bytes, or base64 text when `encoding` is 'base64'. */
79
+ content: unknown;
80
+ /** An adapter name; detected from the file when omitted. */
81
+ format?: unknown;
82
+ encoding?: unknown;
83
+ mimeType?: unknown;
84
+ mode?: unknown;
85
+ matchField?: unknown;
86
+ dryRun?: unknown;
87
+ };
88
+ export type ImportStartOptions = {
89
+ mode?: unknown;
90
+ matchField?: unknown;
91
+ dryRun?: unknown;
92
+ };
37
93
  export declare const IMPORT_ROW_LIMIT = 5000;
38
94
  /** Converts one CSV cell to the field's stored representation, or throws a readable error. */
39
95
  export declare function importCell(field: Field, raw: string, lookups: Map<string, string>): unknown;
40
96
  /**
41
- * CSV imports in batches: the upload is parsed and stored, the user maps columns
42
- * to writable fields, and a worker saves each row through ResourceService with
43
- * the importing user's current permissions. Row failures never stop the batch.
97
+ * File imports in batches: the upload is parsed by a format adapter (CSV built in) and
98
+ * stored, the user maps columns to writable fields, and a worker saves each row through
99
+ * ResourceService with the importing user's current permissions. Row failures never stop
100
+ * the batch. A dry run validates every row exactly like the real import inside a
101
+ * transaction that is rolled back, so nothing (records, activity, outbox events, sequence
102
+ * numbers, notifications) is kept; the batch then waits as 'validated' for the real run.
103
+ * Upsert mode updates the live record matched by a unique field and creates the rest.
44
104
  */
45
105
  export declare class ImportBatches {
46
106
  private db;
47
107
  private registry;
48
108
  private resources;
49
109
  private actors;
50
- constructor(db: Knex, registry: ResourceRegistry, resources: ResourceService, actors: ActorSource);
51
- /** Writable, importable fields for this actor. */
52
- targets(name: string, actor: Actor): ImportTarget[];
53
- create(name: string, actor: Actor, input: {
54
- fileName: unknown;
55
- content: unknown;
56
- }): Promise<ImportBatch>;
57
- show(id: unknown, actor: Actor): Promise<ImportBatch>;
58
- list(actor: Actor): Promise<ImportBatch[]>;
59
- /** Stores the column mapping and queues the batch for the worker. */
60
- start(id: unknown, actor: Actor, mapping: unknown): Promise<ImportBatch>;
110
+ private formats;
111
+ constructor(db: Knex, registry: ResourceRegistry, resources: ResourceService, actors: ActorSource, options?: ImportBatchesOptions);
112
+ /**
113
+ * Adds a file format, for example an ODS adapter. A later adapter with the same
114
+ * name replaces the earlier one; CSV stays the fallback for text without an extension.
115
+ */
116
+ registerAdapter(adapter: ImportAdapter): this;
117
+ /** Registered formats, CSV first. */
118
+ adapters(): readonly ImportAdapter[];
119
+ /** Every accepted upload extension, for the upload validator and the file picker. */
120
+ extensions(): string[];
121
+ /** Writable, importable fields for this actor; upsert also needs update permission. */
122
+ targets(name: string, actor: Actor, mode?: ImportMode): ImportTargetField[];
61
123
  /**
62
- * Worker step: claims one queued or running batch and imports up to `chunk`
63
- * rows. Progress is committed per row, so a crash resumes after the last one.
124
+ * A CSV header row of the actor's importable fields in Arabic, required ones marked
125
+ * with `*`, with a UTF-8 byte-order mark so spreadsheet programs show Arabic. The
126
+ * headers map automatically when the filled template is uploaded.
127
+ */
128
+ template(name: string, actor: Actor, mode?: ImportMode): {
129
+ fileName: string;
130
+ content: string;
131
+ };
132
+ /**
133
+ * The same template as an Excel workbook: one right-to-left sheet whose bold header row
134
+ * holds the actor's importable fields, required ones marked with `*`.
135
+ */
136
+ xlsxTemplate(name: string, actor: Actor, mode?: ImportMode): Promise<{
137
+ fileName: string;
138
+ mimeType: string;
139
+ content: Uint8Array<ArrayBufferLike>;
140
+ }>;
141
+ create(name: string, actor: Actor, input: ImportCreateInput): Promise<ImportBatchRecord>;
142
+ show(id: unknown, actor: Actor): Promise<ImportBatchRecord>;
143
+ list(actor: Actor): Promise<ImportBatchRecord[]>;
144
+ /**
145
+ * Stores the column mapping and queues the batch for the worker. A batch in 'mapping'
146
+ * runs as created (dry run or not) unless `dryRun` says otherwise; a 'validated' batch
147
+ * runs for real by default, so the same batch is imported after its dry run.
148
+ */
149
+ start(id: unknown, actor: Actor, mapping: unknown, options?: ImportStartOptions): Promise<ImportBatchRecord>;
150
+ /**
151
+ * Worker step: claims one queued or running batch and imports (or, for a dry run,
152
+ * validates) up to `chunk` rows. The claim is a lease (lease_id, lease_expires_at, renewed
153
+ * after every row): concurrent workers never share a batch, and an expired lease is taken
154
+ * over, resuming after the last committed row. Import progress is committed per row in
155
+ * the row's own transaction; a dry run records its progress and report once per chunk.
156
+ * Returns null when no batch is free, or when this worker's lease was taken over (it then
157
+ * writes nothing further).
64
158
  */
65
159
  process(chunk?: number): Promise<{
66
160
  id: number;
67
161
  processed: number;
68
162
  created: number;
163
+ updated: number;
69
164
  failed: number;
70
165
  } | null>;
166
+ /**
167
+ * Saves one row through ResourceService. Upsert first looks for the live record with
168
+ * the same match value among the records the actor may update (scope and role rules as
169
+ * SQL, as list() applies them); ResourceService then authorizes the update and checks
170
+ * the record's current `version`. A value held only by a record outside that reach takes
171
+ * the create path and answers exactly as a create of it would (a duplicate from the
172
+ * unique index), so the row never tells the importer where the value is stored. A real import runs in a
173
+ * savepoint of `trx` (the caller's progress transaction); a dry run does the same inside
174
+ * a transaction that is always rolled back.
175
+ */
176
+ private saveRow;
177
+ /**
178
+ * Rows whose unique value repeats an earlier row of the same file. In upsert mode a
179
+ * repeated match value is not an error: that row would update the earlier row's record.
180
+ */
181
+ private earlierDuplicates;
182
+ private adapterFor;
183
+ private mode;
184
+ private matchField;
71
185
  private safeTargets;
72
186
  private owned;
73
187
  private present;