@aderis-erp/cli 1.0.2 → 1.0.4

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 (191) hide show
  1. package/README.md +6 -0
  2. package/dist/commands/access-groups 3.d.ts +40 -0
  3. package/dist/commands/{access-groups 2.js → access-groups 3.js } +106 -40
  4. package/dist/commands/access-groups.d.ts +40 -0
  5. package/dist/commands/access-groups.js +1074 -0
  6. package/dist/commands/account-transactions.d.ts +42 -0
  7. package/dist/commands/account-transactions.js +1088 -0
  8. package/dist/commands/accounts 2.d.ts +41 -0
  9. package/dist/commands/accounts 2.js +1078 -0
  10. package/dist/commands/accounts.d.ts +41 -0
  11. package/dist/commands/accounts.js +1080 -0
  12. package/dist/commands/agent-runs.d.ts +40 -0
  13. package/dist/commands/agent-runs.js +1071 -0
  14. package/dist/commands/async-endpoints-internal 3.d.ts +40 -0
  15. package/dist/commands/{processing-logs.js → async-endpoints-internal 3.js } +110 -46
  16. package/dist/commands/async-endpoints-internal.d.ts +40 -0
  17. package/dist/commands/async-endpoints-internal.js +1064 -0
  18. package/dist/commands/audit-log 3.d.ts +40 -0
  19. package/dist/commands/audit-log 3.js +1066 -0
  20. package/dist/commands/audit-log.d.ts +40 -0
  21. package/dist/commands/audit-log.js +1068 -0
  22. package/dist/commands/auth/login.d.ts +14 -0
  23. package/dist/commands/auth/login.js +116 -0
  24. package/dist/commands/auth/logout.d.ts +10 -0
  25. package/dist/commands/auth/logout.js +58 -0
  26. package/dist/commands/auth/status.d.ts +12 -0
  27. package/dist/commands/auth/status.js +101 -0
  28. package/dist/commands/auth/tenant.d.ts +19 -0
  29. package/dist/commands/auth/tenant.js +184 -0
  30. package/dist/commands/auth.d.ts +37 -0
  31. package/dist/commands/auth.js +871 -0
  32. package/dist/commands/bank-accounts.d.ts +42 -0
  33. package/dist/commands/bank-accounts.js +1088 -0
  34. package/dist/commands/bank-integrations.d.ts +1 -0
  35. package/dist/commands/bank-integrations.js +122 -54
  36. package/dist/commands/business-partners 3.d.ts +41 -0
  37. package/dist/commands/business-partners 3.js +1078 -0
  38. package/dist/commands/business-partners---contacts 3.d.ts +42 -0
  39. package/dist/commands/business-partners---contacts 3.js +1072 -0
  40. package/dist/commands/business-partners---contacts.d.ts +1 -0
  41. package/dist/commands/business-partners---contacts.js +114 -46
  42. package/dist/commands/business-partners.d.ts +1 -0
  43. package/dist/commands/business-partners.js +114 -46
  44. package/dist/commands/config/add.d.ts +13 -0
  45. package/dist/commands/config/add.js +120 -0
  46. package/dist/commands/config/current.d.ts +9 -0
  47. package/dist/commands/config/current.js +43 -0
  48. package/dist/commands/config/delete.d.ts +12 -0
  49. package/dist/commands/config/delete.js +67 -0
  50. package/dist/commands/config/list.d.ts +9 -0
  51. package/dist/commands/config/list.js +50 -0
  52. package/dist/commands/config/use.d.ts +9 -0
  53. package/dist/commands/config/use.js +40 -0
  54. package/dist/commands/credit-card-accounts 3.d.ts +42 -0
  55. package/dist/commands/credit-card-accounts 3.js +1084 -0
  56. package/dist/commands/credit-card-accounts.d.ts +1 -0
  57. package/dist/commands/credit-card-accounts.js +119 -51
  58. package/dist/commands/documents.d.ts +1 -0
  59. package/dist/commands/documents.js +110 -42
  60. package/dist/commands/dunning-configs 3.d.ts +40 -0
  61. package/dist/commands/dunning-configs 3.js +1072 -0
  62. package/dist/commands/dunning-configs.d.ts +1 -0
  63. package/dist/commands/dunning-configs.js +109 -41
  64. package/dist/commands/dunning-reminders.d.ts +1 -0
  65. package/dist/commands/dunning-reminders.js +112 -44
  66. package/dist/commands/dunning-runs 3.d.ts +40 -0
  67. package/dist/commands/{pubsub.js → dunning-runs 3.js } +108 -43
  68. package/dist/commands/dunning-runs.d.ts +1 -0
  69. package/dist/commands/dunning-runs.js +105 -37
  70. package/dist/commands/employees.d.ts +1 -0
  71. package/dist/commands/employees.js +136 -68
  72. package/dist/commands/event-processor-mappings 3.d.ts +40 -0
  73. package/dist/commands/event-processor-mappings 3.js +1071 -0
  74. package/dist/commands/event-processor-mappings.d.ts +1 -0
  75. package/dist/commands/event-processor-mappings.js +109 -41
  76. package/dist/commands/files-internal 3.d.ts +40 -0
  77. package/dist/commands/files-internal 3.js +1073 -0
  78. package/dist/commands/files-internal.d.ts +1 -0
  79. package/dist/commands/files-internal.js +113 -45
  80. package/dist/commands/health 3.d.ts +40 -0
  81. package/dist/commands/health 3.js +1067 -0
  82. package/dist/commands/health.d.ts +1 -0
  83. package/dist/commands/health.js +109 -41
  84. package/dist/commands/{pubsub.d.ts → inbox 3.d.ts } +2 -1
  85. package/dist/commands/inbox 3.js +1065 -0
  86. package/dist/commands/inbox.d.ts +1 -0
  87. package/dist/commands/inbox.js +110 -40
  88. package/dist/commands/integrations 3.d.ts +41 -0
  89. package/dist/commands/integrations 3.js +1067 -0
  90. package/dist/commands/integrations.d.ts +1 -0
  91. package/dist/commands/integrations.js +107 -39
  92. package/dist/commands/item-categories 3.d.ts +40 -0
  93. package/dist/commands/item-categories 3.js +1072 -0
  94. package/dist/commands/item-categories.d.ts +1 -0
  95. package/dist/commands/item-categories.js +109 -41
  96. package/dist/commands/items 3.d.ts +40 -0
  97. package/dist/commands/items 3.js +1072 -0
  98. package/dist/commands/items.d.ts +1 -0
  99. package/dist/commands/items.js +109 -41
  100. package/dist/commands/journal-lines.d.ts +1 -0
  101. package/dist/commands/journal-lines.js +105 -37
  102. package/dist/commands/journals 3.d.ts +42 -0
  103. package/dist/commands/journals 3.js +1088 -0
  104. package/dist/commands/journals.d.ts +1 -0
  105. package/dist/commands/journals.js +123 -55
  106. package/dist/commands/ledgers.d.ts +1 -0
  107. package/dist/commands/ledgers.js +120 -52
  108. package/dist/commands/office-locations 3.d.ts +40 -0
  109. package/dist/commands/office-locations 3.js +1072 -0
  110. package/dist/commands/office-locations.d.ts +1 -0
  111. package/dist/commands/office-locations.js +109 -41
  112. package/dist/commands/payment-method-ledger-mappings 3.d.ts +41 -0
  113. package/dist/commands/payment-method-ledger-mappings 3.js +1066 -0
  114. package/dist/commands/payment-method-ledger-mappings.d.ts +1 -0
  115. package/dist/commands/payment-method-ledger-mappings.js +109 -41
  116. package/dist/commands/payment-methods 3.d.ts +40 -0
  117. package/dist/commands/payment-methods 3.js +1072 -0
  118. package/dist/commands/payment-methods.d.ts +1 -0
  119. package/dist/commands/payment-methods.js +109 -41
  120. package/dist/commands/payment-runs 3.d.ts +42 -0
  121. package/dist/commands/payment-runs 3.js +1087 -0
  122. package/dist/commands/payment-runs.d.ts +1 -0
  123. package/dist/commands/payment-runs.js +122 -54
  124. package/dist/commands/payment-terms 3.d.ts +40 -0
  125. package/dist/commands/payment-terms 3.js +1073 -0
  126. package/dist/commands/payment-terms.d.ts +1 -0
  127. package/dist/commands/payment-terms.js +110 -42
  128. package/dist/commands/price-lists 3.d.ts +41 -0
  129. package/dist/commands/price-lists 3.js +1078 -0
  130. package/dist/commands/price-lists.d.ts +1 -0
  131. package/dist/commands/price-lists.js +114 -46
  132. package/dist/commands/processor-mappings 2.d.ts +40 -0
  133. package/dist/commands/processor-mappings 2.js +1070 -0
  134. package/dist/commands/processor-mappings.d.ts +1 -0
  135. package/dist/commands/processor-mappings.js +108 -40
  136. package/dist/commands/processors.d.ts +1 -0
  137. package/dist/commands/processors.js +113 -45
  138. package/dist/commands/reconciliation 3.d.ts +40 -0
  139. package/dist/commands/reconciliation 3.js +1069 -0
  140. package/dist/commands/reconciliation.d.ts +1 -0
  141. package/dist/commands/reconciliation.js +110 -42
  142. package/dist/commands/reports.d.ts +1 -0
  143. package/dist/commands/reports.js +110 -39
  144. package/dist/commands/salary-types 3.d.ts +40 -0
  145. package/dist/commands/salary-types 3.js +1072 -0
  146. package/dist/commands/salary-types.d.ts +1 -0
  147. package/dist/commands/salary-types.js +1074 -0
  148. package/dist/commands/sales-invoices 3.d.ts +43 -0
  149. package/dist/commands/sales-invoices 3.js +1100 -0
  150. package/dist/commands/sales-invoices.d.ts +1 -0
  151. package/dist/commands/sales-invoices.js +134 -66
  152. package/dist/commands/sales-orders 3.d.ts +43 -0
  153. package/dist/commands/sales-orders 3.js +1098 -0
  154. package/dist/commands/sales-orders.d.ts +1 -0
  155. package/dist/commands/sales-orders.js +133 -64
  156. package/dist/commands/switch.d.ts +1 -0
  157. package/dist/commands/switch.js +58 -3
  158. package/dist/commands/{processing-logs.d.ts → tags 3.d.ts } +2 -1
  159. package/dist/commands/tags 3.js +1072 -0
  160. package/dist/commands/tags.d.ts +1 -0
  161. package/dist/commands/tags.js +109 -41
  162. package/dist/commands/tax-codes 3.d.ts +40 -0
  163. package/dist/commands/tax-codes 3.js +1075 -0
  164. package/dist/commands/tax-codes.d.ts +1 -0
  165. package/dist/commands/tax-codes.js +112 -44
  166. package/dist/commands/tax-matrix.d.ts +1 -0
  167. package/dist/commands/tax-matrix.js +109 -41
  168. package/dist/commands/tenants.d.ts +1 -0
  169. package/dist/commands/tenants.js +109 -41
  170. package/dist/commands/text-templates 3.d.ts +40 -0
  171. package/dist/commands/text-templates 3.js +1072 -0
  172. package/dist/commands/text-templates.d.ts +1 -0
  173. package/dist/commands/text-templates.js +109 -41
  174. package/dist/commands/tools.d.ts +1 -0
  175. package/dist/commands/tools.js +106 -38
  176. package/dist/commands/vendor-invoices.d.ts +1 -0
  177. package/dist/commands/vendor-invoices.js +139 -69
  178. package/dist/commands/webhooks 3.d.ts +40 -0
  179. package/dist/commands/webhooks 3.js +1074 -0
  180. package/dist/commands/webhooks.d.ts +1 -0
  181. package/dist/commands/webhooks.js +111 -43
  182. package/dist/commands/workflows.d.ts +1 -0
  183. package/dist/commands/workflows.js +107 -39
  184. package/dist/lib/api-client.d.ts +5 -1
  185. package/dist/lib/api-client.js +19 -5
  186. package/dist/lib/auth.d.ts +16 -1
  187. package/dist/lib/auth.js +170 -45
  188. package/dist/lib/config.d.ts +7 -0
  189. package/dist/lib/config.js +7 -1
  190. package/oclif.manifest.json +7464 -653
  191. package/package.json +2 -2
@@ -30,6 +30,7 @@ export default class DunningConfigs extends Command {
30
30
  private runExport;
31
31
  private runCamt053Import;
32
32
  private runNestedImport;
33
+ private parseFilterValue;
33
34
  private filterFields;
34
35
  private sanitizeOutput;
35
36
  private getColumns;
@@ -8,11 +8,11 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
9
  const SUBCOMMANDS = [...["list", "create", "get", "update", "delete"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/dunning-configs', summary: 'List all dunning run configs', pathParams: [], hasBody: false, isMultipart: false },
12
- 'create': { method: 'POST', path: '/v1/dunning-configs', summary: 'Create a new dunning run config', pathParams: [], hasBody: true, isMultipart: false },
13
- 'get': { method: 'GET', path: '/v1/dunning-configs/{id}', summary: 'Get a dunning run config by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
14
- 'update': { method: 'PATCH', path: '/v1/dunning-configs/{id}', summary: 'Update a dunning run config', pathParams: ['id'], hasBody: true, isMultipart: false },
15
- 'delete': { method: 'DELETE', path: '/v1/dunning-configs/{id}', summary: 'Delete a dunning run config', pathParams: ['id'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/dunning-configs', summary: 'List all dunning run configs', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'create': { method: 'POST', path: '/v1/dunning-configs', summary: 'Create a new dunning run config', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
13
+ 'get': { method: 'GET', path: '/v1/dunning-configs/{id}', summary: 'Get a dunning run config by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'update': { method: 'PATCH', path: '/v1/dunning-configs/{id}', summary: 'Update a dunning run config', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
15
+ 'delete': { method: 'DELETE', path: '/v1/dunning-configs/{id}', summary: 'Delete a dunning run config', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
16
  };
17
17
  export default class DunningConfigs extends Command {
18
18
  static description = 'Manage dunning configs';
@@ -130,15 +130,7 @@ export default class DunningConfigs extends Command {
130
130
  if (eqIndex === -1)
131
131
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
132
132
  const key = f.slice(0, eqIndex);
133
- let value = f.slice(eqIndex + 1);
134
- // Check for operator prefix (with or without $)
135
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
136
- if (opMatch) {
137
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
138
- }
139
- else {
140
- value = `\$eq:${value}`;
141
- }
133
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
142
134
  const filterKey = `filter.${key}`;
143
135
  if (filterKey in queryParams) {
144
136
  // Multiple filters on same field: collect as array
@@ -171,7 +163,9 @@ export default class DunningConfigs extends Command {
171
163
  data = form;
172
164
  }
173
165
  else if (endpoint.hasBody) {
174
- if (flags.file) {
166
+ // For binary-response endpoints, --file is the output path, not a JSON
167
+ // input file — skip the read-as-body branch.
168
+ if (flags.file && !endpoint.isBinaryResponse) {
175
169
  const fsModule = await import('node:fs');
176
170
  try {
177
171
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -193,6 +187,7 @@ export default class DunningConfigs extends Command {
193
187
  if (!data)
194
188
  data = {};
195
189
  const body = data;
190
+ const arrayFields = new Set(endpoint.bodyArrayFields);
196
191
  for (const pair of flags.set) {
197
192
  const eqIndex = pair.indexOf('=');
198
193
  if (eqIndex === -1)
@@ -204,6 +199,19 @@ export default class DunningConfigs extends Command {
204
199
  value = JSON.parse(value);
205
200
  }
206
201
  catch { /* keep as string */ }
202
+ // For top-level keys typed as array in the API schema, split bare
203
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
204
+ // wrap a lone scalar in a single-element array. Skips when --set
205
+ // already provided a JSON array.
206
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
207
+ if (isArrayField && !Array.isArray(value)) {
208
+ if (typeof value === 'string') {
209
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
210
+ }
211
+ else if (value !== undefined && value !== null) {
212
+ value = [value];
213
+ }
214
+ }
207
215
  // Support nested keys like "address.city"
208
216
  const keys = key.split('.');
209
217
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -254,6 +262,26 @@ export default class DunningConfigs extends Command {
254
262
  process.stderr.write('\n');
255
263
  }
256
264
  try {
265
+ // Binary response: download to file
266
+ if (endpoint.isBinaryResponse) {
267
+ if (!flags.file) {
268
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
269
+ }
270
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
271
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
272
+ data,
273
+ contextName: flags.context,
274
+ binary: true,
275
+ });
276
+ const fsModule = await import('node:fs');
277
+ const binData = binResponse.data;
278
+ const buffer = Buffer.isBuffer(binData)
279
+ ? binData
280
+ : Buffer.from(binData);
281
+ fsModule.writeFileSync(flags.file, buffer);
282
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
283
+ return;
284
+ }
257
285
  const response = await apiRequest(endpoint.method, apiPath, {
258
286
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
259
287
  data,
@@ -344,6 +372,7 @@ export default class DunningConfigs extends Command {
344
372
  }
345
373
  else if (flags.set && flags.set.length > 0) {
346
374
  const item = {};
375
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
347
376
  for (const pair of flags.set) {
348
377
  const eqIndex = pair.indexOf('=');
349
378
  if (eqIndex === -1)
@@ -354,6 +383,15 @@ export default class DunningConfigs extends Command {
354
383
  value = JSON.parse(value);
355
384
  }
356
385
  catch { /* keep as string */ }
386
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
387
+ if (isArrayField && !Array.isArray(value)) {
388
+ if (typeof value === 'string') {
389
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
390
+ }
391
+ else if (value !== undefined && value !== null) {
392
+ value = [value];
393
+ }
394
+ }
357
395
  const keys = key.split('.');
358
396
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
359
397
  this.error(`Invalid --set key: ${key}`);
@@ -503,14 +541,7 @@ export default class DunningConfigs extends Command {
503
541
  if (eqIndex === -1)
504
542
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
505
543
  const key = f.slice(0, eqIndex);
506
- let value = f.slice(eqIndex + 1);
507
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
508
- if (opMatch) {
509
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
510
- }
511
- else {
512
- value = `\$eq:${value}`;
513
- }
544
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
514
545
  const filterKey = `filter.${key}`;
515
546
  if (filterKey in baseParams) {
516
547
  const existing = baseParams[filterKey];
@@ -687,6 +718,7 @@ export default class DunningConfigs extends Command {
687
718
  }
688
719
  else if (flags.set && flags.set.length > 0) {
689
720
  const item = {};
721
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
690
722
  for (const pair of flags.set) {
691
723
  const eqIndex = pair.indexOf('=');
692
724
  if (eqIndex === -1)
@@ -697,6 +729,15 @@ export default class DunningConfigs extends Command {
697
729
  value = JSON.parse(value);
698
730
  }
699
731
  catch { /* keep as string */ }
732
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
733
+ if (isArrayField && !Array.isArray(value)) {
734
+ if (typeof value === 'string') {
735
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
736
+ }
737
+ else if (value !== undefined && value !== null) {
738
+ value = [value];
739
+ }
740
+ }
700
741
  const keys = key.split('.');
701
742
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
702
743
  this.error(`Invalid --set key: ${key}`);
@@ -816,35 +857,62 @@ export default class DunningConfigs extends Command {
816
857
  this.log('');
817
858
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
818
859
  }
860
+ parseFilterValue(value) {
861
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
862
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
863
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
864
+ // no operator prefix is present.
865
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
866
+ const m = value.match(opRe);
867
+ if (!m)
868
+ return `\$eq:${value}`;
869
+ const op = m[1];
870
+ const rest = value.slice(m[0].length);
871
+ if (rest === '')
872
+ return `\$${op}`;
873
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
874
+ }
819
875
  filterFields(data, fields) {
820
876
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
821
877
  const pick = (obj, keys) => {
822
- const result = {};
878
+ // Group keys by their first segment so sibling sub-paths
879
+ // (e.g. 'items.amount' + 'items._type') resolve in one recursive pass
880
+ // and don't clobber each other on merge.
881
+ const directKeys = new Set();
882
+ const nestedKeys = new Map();
823
883
  for (const key of keys) {
824
884
  if (key.split('.').some(isUnsafeKey))
825
885
  continue;
826
886
  if (key.includes('.')) {
827
- // Handle nested fields like 'customer.name' or 'allocations.salesInvoiceId'
828
887
  const [first, ...rest] = key.split('.');
829
- const val = obj[first];
830
- if (val && typeof val === 'object') {
831
- const restKey = rest.join('.');
832
- if (Array.isArray(val)) {
833
- // Map over array elements (e.g., allocations[].salesInvoiceId)
834
- const existing = Array.isArray(result[first]) ? result[first] : [];
835
- result[first] = val.map((item, i) => ({
836
- ...(existing[i] || {}),
837
- ...pick(item, [restKey]),
838
- }));
839
- }
840
- else {
841
- const nested = pick(val, [restKey]);
842
- result[first] = { ...(result[first] || {}), ...nested };
843
- }
888
+ if (isUnsafeKey(first))
889
+ continue;
890
+ const list = nestedKeys.get(first);
891
+ if (list) {
892
+ list.push(rest.join('.'));
893
+ }
894
+ else {
895
+ nestedKeys.set(first, [rest.join('.')]);
844
896
  }
845
897
  }
846
- else if (key in obj) {
898
+ else {
899
+ directKeys.add(key);
900
+ }
901
+ }
902
+ const result = {};
903
+ for (const key of directKeys) {
904
+ if (key in obj)
847
905
  result[key] = obj[key];
906
+ }
907
+ for (const [first, restKeys] of nestedKeys) {
908
+ const val = obj[first];
909
+ if (!val || typeof val !== 'object')
910
+ continue;
911
+ if (Array.isArray(val)) {
912
+ result[first] = val.map(item => pick(item, restKeys));
913
+ }
914
+ else {
915
+ result[first] = pick(val, restKeys);
848
916
  }
849
917
  }
850
918
  return result;
@@ -30,6 +30,7 @@ export default class DunningReminders extends Command {
30
30
  private runExport;
31
31
  private runCamt053Import;
32
32
  private runNestedImport;
33
+ private parseFilterValue;
33
34
  private filterFields;
34
35
  private sanitizeOutput;
35
36
  private getColumns;
@@ -8,14 +8,14 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
9
  const SUBCOMMANDS = [...["pending", "ongoing", "cancelled", "get", "update", "list", "approve", "cancel"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'pending': { method: 'GET', path: '/v1/dunning-reminders/pending', summary: 'Get pending reminders (awaiting approval) with pagination', pathParams: [], hasBody: false, isMultipart: false },
12
- 'ongoing': { method: 'GET', path: '/v1/dunning-reminders/ongoing', summary: 'Get ongoing reminders (pending, sent, or failed) with pagination', pathParams: [], hasBody: false, isMultipart: false },
13
- 'cancelled': { method: 'GET', path: '/v1/dunning-reminders/cancelled', summary: 'Get cancelled reminders with pagination', pathParams: [], hasBody: false, isMultipart: false },
14
- 'get': { method: 'GET', path: '/v1/dunning-reminders/{id}', summary: 'Get a single dunning reminder by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
15
- 'update': { method: 'PATCH', path: '/v1/dunning-reminders/{id}', summary: 'Update recipient or action on a dunning reminder', pathParams: ['id'], hasBody: true, isMultipart: false },
16
- 'list': { method: 'GET', path: '/v1/dunning-reminders', summary: 'Get all dunning reminders with pagination', pathParams: [], hasBody: false, isMultipart: false },
17
- 'approve': { method: 'POST', path: '/v1/dunning-reminders/{reminderId}/approve', summary: 'Approve a dunning reminder for sending', pathParams: ['reminderId'], hasBody: true, isMultipart: false },
18
- 'cancel': { method: 'POST', path: '/v1/dunning-reminders/{reminderId}/cancel', summary: 'Cancel a dunning reminder', pathParams: ['reminderId'], hasBody: true, isMultipart: false },
11
+ 'pending': { method: 'GET', path: '/v1/dunning-reminders/pending', summary: 'Get pending reminders (awaiting approval) with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'ongoing': { method: 'GET', path: '/v1/dunning-reminders/ongoing', summary: 'Get ongoing reminders (pending, sent, or failed) with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
13
+ 'cancelled': { method: 'GET', path: '/v1/dunning-reminders/cancelled', summary: 'Get cancelled reminders with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'get': { method: 'GET', path: '/v1/dunning-reminders/{id}', summary: 'Get a single dunning reminder by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
15
+ 'update': { method: 'PATCH', path: '/v1/dunning-reminders/{id}', summary: 'Update recipient or action on a dunning reminder', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
+ 'list': { method: 'GET', path: '/v1/dunning-reminders', summary: 'Get all dunning reminders with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
17
+ 'approve': { method: 'POST', path: '/v1/dunning-reminders/{reminderId}/approve', summary: 'Approve a dunning reminder for sending', pathParams: ['reminderId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
18
+ 'cancel': { method: 'POST', path: '/v1/dunning-reminders/{reminderId}/cancel', summary: 'Cancel a dunning reminder', pathParams: ['reminderId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
19
19
  };
20
20
  export default class DunningReminders extends Command {
21
21
  static description = 'Manage dunning reminders';
@@ -131,15 +131,7 @@ export default class DunningReminders extends Command {
131
131
  if (eqIndex === -1)
132
132
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
133
133
  const key = f.slice(0, eqIndex);
134
- let value = f.slice(eqIndex + 1);
135
- // Check for operator prefix (with or without $)
136
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
137
- if (opMatch) {
138
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
139
- }
140
- else {
141
- value = `\$eq:${value}`;
142
- }
134
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
143
135
  const filterKey = `filter.${key}`;
144
136
  if (filterKey in queryParams) {
145
137
  // Multiple filters on same field: collect as array
@@ -172,7 +164,9 @@ export default class DunningReminders extends Command {
172
164
  data = form;
173
165
  }
174
166
  else if (endpoint.hasBody) {
175
- if (flags.file) {
167
+ // For binary-response endpoints, --file is the output path, not a JSON
168
+ // input file — skip the read-as-body branch.
169
+ if (flags.file && !endpoint.isBinaryResponse) {
176
170
  const fsModule = await import('node:fs');
177
171
  try {
178
172
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -194,6 +188,7 @@ export default class DunningReminders extends Command {
194
188
  if (!data)
195
189
  data = {};
196
190
  const body = data;
191
+ const arrayFields = new Set(endpoint.bodyArrayFields);
197
192
  for (const pair of flags.set) {
198
193
  const eqIndex = pair.indexOf('=');
199
194
  if (eqIndex === -1)
@@ -205,6 +200,19 @@ export default class DunningReminders extends Command {
205
200
  value = JSON.parse(value);
206
201
  }
207
202
  catch { /* keep as string */ }
203
+ // For top-level keys typed as array in the API schema, split bare
204
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
205
+ // wrap a lone scalar in a single-element array. Skips when --set
206
+ // already provided a JSON array.
207
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
208
+ if (isArrayField && !Array.isArray(value)) {
209
+ if (typeof value === 'string') {
210
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
211
+ }
212
+ else if (value !== undefined && value !== null) {
213
+ value = [value];
214
+ }
215
+ }
208
216
  // Support nested keys like "address.city"
209
217
  const keys = key.split('.');
210
218
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -255,6 +263,26 @@ export default class DunningReminders extends Command {
255
263
  process.stderr.write('\n');
256
264
  }
257
265
  try {
266
+ // Binary response: download to file
267
+ if (endpoint.isBinaryResponse) {
268
+ if (!flags.file) {
269
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
270
+ }
271
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
272
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
273
+ data,
274
+ contextName: flags.context,
275
+ binary: true,
276
+ });
277
+ const fsModule = await import('node:fs');
278
+ const binData = binResponse.data;
279
+ const buffer = Buffer.isBuffer(binData)
280
+ ? binData
281
+ : Buffer.from(binData);
282
+ fsModule.writeFileSync(flags.file, buffer);
283
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
284
+ return;
285
+ }
258
286
  const response = await apiRequest(endpoint.method, apiPath, {
259
287
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
260
288
  data,
@@ -345,6 +373,7 @@ export default class DunningReminders extends Command {
345
373
  }
346
374
  else if (flags.set && flags.set.length > 0) {
347
375
  const item = {};
376
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
348
377
  for (const pair of flags.set) {
349
378
  const eqIndex = pair.indexOf('=');
350
379
  if (eqIndex === -1)
@@ -355,6 +384,15 @@ export default class DunningReminders extends Command {
355
384
  value = JSON.parse(value);
356
385
  }
357
386
  catch { /* keep as string */ }
387
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
388
+ if (isArrayField && !Array.isArray(value)) {
389
+ if (typeof value === 'string') {
390
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
391
+ }
392
+ else if (value !== undefined && value !== null) {
393
+ value = [value];
394
+ }
395
+ }
358
396
  const keys = key.split('.');
359
397
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
360
398
  this.error(`Invalid --set key: ${key}`);
@@ -504,14 +542,7 @@ export default class DunningReminders extends Command {
504
542
  if (eqIndex === -1)
505
543
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
506
544
  const key = f.slice(0, eqIndex);
507
- let value = f.slice(eqIndex + 1);
508
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
509
- if (opMatch) {
510
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
511
- }
512
- else {
513
- value = `\$eq:${value}`;
514
- }
545
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
515
546
  const filterKey = `filter.${key}`;
516
547
  if (filterKey in baseParams) {
517
548
  const existing = baseParams[filterKey];
@@ -688,6 +719,7 @@ export default class DunningReminders extends Command {
688
719
  }
689
720
  else if (flags.set && flags.set.length > 0) {
690
721
  const item = {};
722
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
691
723
  for (const pair of flags.set) {
692
724
  const eqIndex = pair.indexOf('=');
693
725
  if (eqIndex === -1)
@@ -698,6 +730,15 @@ export default class DunningReminders extends Command {
698
730
  value = JSON.parse(value);
699
731
  }
700
732
  catch { /* keep as string */ }
733
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
734
+ if (isArrayField && !Array.isArray(value)) {
735
+ if (typeof value === 'string') {
736
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
737
+ }
738
+ else if (value !== undefined && value !== null) {
739
+ value = [value];
740
+ }
741
+ }
701
742
  const keys = key.split('.');
702
743
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
703
744
  this.error(`Invalid --set key: ${key}`);
@@ -817,35 +858,62 @@ export default class DunningReminders extends Command {
817
858
  this.log('');
818
859
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
819
860
  }
861
+ parseFilterValue(value) {
862
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
863
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
864
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
865
+ // no operator prefix is present.
866
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
867
+ const m = value.match(opRe);
868
+ if (!m)
869
+ return `\$eq:${value}`;
870
+ const op = m[1];
871
+ const rest = value.slice(m[0].length);
872
+ if (rest === '')
873
+ return `\$${op}`;
874
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
875
+ }
820
876
  filterFields(data, fields) {
821
877
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
822
878
  const pick = (obj, keys) => {
823
- const result = {};
879
+ // Group keys by their first segment so sibling sub-paths
880
+ // (e.g. 'items.amount' + 'items._type') resolve in one recursive pass
881
+ // and don't clobber each other on merge.
882
+ const directKeys = new Set();
883
+ const nestedKeys = new Map();
824
884
  for (const key of keys) {
825
885
  if (key.split('.').some(isUnsafeKey))
826
886
  continue;
827
887
  if (key.includes('.')) {
828
- // Handle nested fields like 'customer.name' or 'allocations.salesInvoiceId'
829
888
  const [first, ...rest] = key.split('.');
830
- const val = obj[first];
831
- if (val && typeof val === 'object') {
832
- const restKey = rest.join('.');
833
- if (Array.isArray(val)) {
834
- // Map over array elements (e.g., allocations[].salesInvoiceId)
835
- const existing = Array.isArray(result[first]) ? result[first] : [];
836
- result[first] = val.map((item, i) => ({
837
- ...(existing[i] || {}),
838
- ...pick(item, [restKey]),
839
- }));
840
- }
841
- else {
842
- const nested = pick(val, [restKey]);
843
- result[first] = { ...(result[first] || {}), ...nested };
844
- }
889
+ if (isUnsafeKey(first))
890
+ continue;
891
+ const list = nestedKeys.get(first);
892
+ if (list) {
893
+ list.push(rest.join('.'));
894
+ }
895
+ else {
896
+ nestedKeys.set(first, [rest.join('.')]);
845
897
  }
846
898
  }
847
- else if (key in obj) {
899
+ else {
900
+ directKeys.add(key);
901
+ }
902
+ }
903
+ const result = {};
904
+ for (const key of directKeys) {
905
+ if (key in obj)
848
906
  result[key] = obj[key];
907
+ }
908
+ for (const [first, restKeys] of nestedKeys) {
909
+ const val = obj[first];
910
+ if (!val || typeof val !== 'object')
911
+ continue;
912
+ if (Array.isArray(val)) {
913
+ result[first] = val.map(item => pick(item, restKeys));
914
+ }
915
+ else {
916
+ result[first] = pick(val, restKeys);
849
917
  }
850
918
  }
851
919
  return result;
@@ -0,0 +1,40 @@
1
+ import { Command } from '@oclif/core';
2
+ export default class DunningRuns extends Command {
3
+ static description: string;
4
+ static examples: never[];
5
+ static args: {
6
+ action: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
7
+ id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
8
+ };
9
+ static flags: {
10
+ context: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
11
+ output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
12
+ table: import("@oclif/core/interfaces").BooleanFlag<boolean>;
13
+ csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
14
+ data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
15
+ file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
16
+ set: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
17
+ page: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
18
+ limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
19
+ include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
20
+ search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
21
+ 'sort-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
22
+ filter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
23
+ query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
24
+ fields: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
25
+ sanitize: import("@oclif/core/interfaces").BooleanFlag<boolean>;
26
+ 'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
27
+ };
28
+ run(): Promise<void>;
29
+ private runImport;
30
+ private runExport;
31
+ private runCamt053Import;
32
+ private runNestedImport;
33
+ private parseFilterValue;
34
+ private filterFields;
35
+ private sanitizeOutput;
36
+ private getColumns;
37
+ private getValue;
38
+ private printTable;
39
+ private printCsv;
40
+ }