@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 Items 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/items', summary: 'Get all items with pagination', pathParams: [], hasBody: false, isMultipart: false },
12
- 'create': { method: 'POST', path: '/v1/items', summary: 'Create a new item', pathParams: [], hasBody: true, isMultipart: false },
13
- 'get': { method: 'GET', path: '/v1/items/{id}', summary: 'Get an item by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
14
- 'update': { method: 'PATCH', path: '/v1/items/{id}', summary: 'Update an item', pathParams: ['id'], hasBody: true, isMultipart: false },
15
- 'delete': { method: 'DELETE', path: '/v1/items/{id}', summary: 'Delete an item', pathParams: ['id'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/items', summary: 'Get all items with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'create': { method: 'POST', path: '/v1/items', summary: 'Create a new item', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tagIds'] },
13
+ 'get': { method: 'GET', path: '/v1/items/{id}', summary: 'Get an item by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'update': { method: 'PATCH', path: '/v1/items/{id}', summary: 'Update an item', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tagIds'] },
15
+ 'delete': { method: 'DELETE', path: '/v1/items/{id}', summary: 'Delete an item', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
16
  };
17
17
  export default class Items extends Command {
18
18
  static description = 'Manage items';
@@ -130,15 +130,7 @@ export default class Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 Items 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 JournalLines 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,7 +8,7 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
9
  const SUBCOMMANDS = [...["list"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/journal-lines', summary: 'List all journal lines (global view across all journals)', pathParams: [], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/journal-lines', summary: 'List all journal lines (global view across all journals)', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
12
  };
13
13
  export default class JournalLines extends Command {
14
14
  static description = 'Manage journal lines';
@@ -122,15 +122,7 @@ export default class JournalLines extends Command {
122
122
  if (eqIndex === -1)
123
123
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
124
124
  const key = f.slice(0, eqIndex);
125
- let value = f.slice(eqIndex + 1);
126
- // Check for operator prefix (with or without $)
127
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
128
- if (opMatch) {
129
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
130
- }
131
- else {
132
- value = `\$eq:${value}`;
133
- }
125
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
134
126
  const filterKey = `filter.${key}`;
135
127
  if (filterKey in queryParams) {
136
128
  // Multiple filters on same field: collect as array
@@ -163,7 +155,9 @@ export default class JournalLines extends Command {
163
155
  data = form;
164
156
  }
165
157
  else if (endpoint.hasBody) {
166
- if (flags.file) {
158
+ // For binary-response endpoints, --file is the output path, not a JSON
159
+ // input file — skip the read-as-body branch.
160
+ if (flags.file && !endpoint.isBinaryResponse) {
167
161
  const fsModule = await import('node:fs');
168
162
  try {
169
163
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -185,6 +179,7 @@ export default class JournalLines extends Command {
185
179
  if (!data)
186
180
  data = {};
187
181
  const body = data;
182
+ const arrayFields = new Set(endpoint.bodyArrayFields);
188
183
  for (const pair of flags.set) {
189
184
  const eqIndex = pair.indexOf('=');
190
185
  if (eqIndex === -1)
@@ -196,6 +191,19 @@ export default class JournalLines extends Command {
196
191
  value = JSON.parse(value);
197
192
  }
198
193
  catch { /* keep as string */ }
194
+ // For top-level keys typed as array in the API schema, split bare
195
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
196
+ // wrap a lone scalar in a single-element array. Skips when --set
197
+ // already provided a JSON array.
198
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
199
+ if (isArrayField && !Array.isArray(value)) {
200
+ if (typeof value === 'string') {
201
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
202
+ }
203
+ else if (value !== undefined && value !== null) {
204
+ value = [value];
205
+ }
206
+ }
199
207
  // Support nested keys like "address.city"
200
208
  const keys = key.split('.');
201
209
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -246,6 +254,26 @@ export default class JournalLines extends Command {
246
254
  process.stderr.write('\n');
247
255
  }
248
256
  try {
257
+ // Binary response: download to file
258
+ if (endpoint.isBinaryResponse) {
259
+ if (!flags.file) {
260
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
261
+ }
262
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
263
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
264
+ data,
265
+ contextName: flags.context,
266
+ binary: true,
267
+ });
268
+ const fsModule = await import('node:fs');
269
+ const binData = binResponse.data;
270
+ const buffer = Buffer.isBuffer(binData)
271
+ ? binData
272
+ : Buffer.from(binData);
273
+ fsModule.writeFileSync(flags.file, buffer);
274
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
275
+ return;
276
+ }
249
277
  const response = await apiRequest(endpoint.method, apiPath, {
250
278
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
251
279
  data,
@@ -336,6 +364,7 @@ export default class JournalLines extends Command {
336
364
  }
337
365
  else if (flags.set && flags.set.length > 0) {
338
366
  const item = {};
367
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
339
368
  for (const pair of flags.set) {
340
369
  const eqIndex = pair.indexOf('=');
341
370
  if (eqIndex === -1)
@@ -346,6 +375,15 @@ export default class JournalLines extends Command {
346
375
  value = JSON.parse(value);
347
376
  }
348
377
  catch { /* keep as string */ }
378
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
379
+ if (isArrayField && !Array.isArray(value)) {
380
+ if (typeof value === 'string') {
381
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
382
+ }
383
+ else if (value !== undefined && value !== null) {
384
+ value = [value];
385
+ }
386
+ }
349
387
  const keys = key.split('.');
350
388
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
351
389
  this.error(`Invalid --set key: ${key}`);
@@ -495,14 +533,7 @@ export default class JournalLines extends Command {
495
533
  if (eqIndex === -1)
496
534
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
497
535
  const key = f.slice(0, eqIndex);
498
- let value = f.slice(eqIndex + 1);
499
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
500
- if (opMatch) {
501
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
502
- }
503
- else {
504
- value = `\$eq:${value}`;
505
- }
536
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
506
537
  const filterKey = `filter.${key}`;
507
538
  if (filterKey in baseParams) {
508
539
  const existing = baseParams[filterKey];
@@ -679,6 +710,7 @@ export default class JournalLines extends Command {
679
710
  }
680
711
  else if (flags.set && flags.set.length > 0) {
681
712
  const item = {};
713
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
682
714
  for (const pair of flags.set) {
683
715
  const eqIndex = pair.indexOf('=');
684
716
  if (eqIndex === -1)
@@ -689,6 +721,15 @@ export default class JournalLines extends Command {
689
721
  value = JSON.parse(value);
690
722
  }
691
723
  catch { /* keep as string */ }
724
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
725
+ if (isArrayField && !Array.isArray(value)) {
726
+ if (typeof value === 'string') {
727
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
728
+ }
729
+ else if (value !== undefined && value !== null) {
730
+ value = [value];
731
+ }
732
+ }
692
733
  const keys = key.split('.');
693
734
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
694
735
  this.error(`Invalid --set key: ${key}`);
@@ -808,35 +849,62 @@ export default class JournalLines extends Command {
808
849
  this.log('');
809
850
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
810
851
  }
852
+ parseFilterValue(value) {
853
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
854
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
855
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
856
+ // no operator prefix is present.
857
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
858
+ const m = value.match(opRe);
859
+ if (!m)
860
+ return `\$eq:${value}`;
861
+ const op = m[1];
862
+ const rest = value.slice(m[0].length);
863
+ if (rest === '')
864
+ return `\$${op}`;
865
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
866
+ }
811
867
  filterFields(data, fields) {
812
868
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
813
869
  const pick = (obj, keys) => {
814
- const result = {};
870
+ // Group keys by their first segment so sibling sub-paths
871
+ // (e.g. 'items.amount' + 'items._type') resolve in one recursive pass
872
+ // and don't clobber each other on merge.
873
+ const directKeys = new Set();
874
+ const nestedKeys = new Map();
815
875
  for (const key of keys) {
816
876
  if (key.split('.').some(isUnsafeKey))
817
877
  continue;
818
878
  if (key.includes('.')) {
819
- // Handle nested fields like 'customer.name' or 'allocations.salesInvoiceId'
820
879
  const [first, ...rest] = key.split('.');
821
- const val = obj[first];
822
- if (val && typeof val === 'object') {
823
- const restKey = rest.join('.');
824
- if (Array.isArray(val)) {
825
- // Map over array elements (e.g., allocations[].salesInvoiceId)
826
- const existing = Array.isArray(result[first]) ? result[first] : [];
827
- result[first] = val.map((item, i) => ({
828
- ...(existing[i] || {}),
829
- ...pick(item, [restKey]),
830
- }));
831
- }
832
- else {
833
- const nested = pick(val, [restKey]);
834
- result[first] = { ...(result[first] || {}), ...nested };
835
- }
880
+ if (isUnsafeKey(first))
881
+ continue;
882
+ const list = nestedKeys.get(first);
883
+ if (list) {
884
+ list.push(rest.join('.'));
885
+ }
886
+ else {
887
+ nestedKeys.set(first, [rest.join('.')]);
836
888
  }
837
889
  }
838
- else if (key in obj) {
890
+ else {
891
+ directKeys.add(key);
892
+ }
893
+ }
894
+ const result = {};
895
+ for (const key of directKeys) {
896
+ if (key in obj)
839
897
  result[key] = obj[key];
898
+ }
899
+ for (const [first, restKeys] of nestedKeys) {
900
+ const val = obj[first];
901
+ if (!val || typeof val !== 'object')
902
+ continue;
903
+ if (Array.isArray(val)) {
904
+ result[first] = val.map(item => pick(item, restKeys));
905
+ }
906
+ else {
907
+ result[first] = pick(val, restKeys);
840
908
  }
841
909
  }
842
910
  return result;
@@ -0,0 +1,42 @@
1
+ import { Command } from '@oclif/core';
2
+ export default class Journals extends Command {
3
+ static description: string;
4
+ static examples: string[];
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
+ 'note-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
18
+ 'file-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
19
+ page: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
20
+ limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
21
+ include: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
22
+ search: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
23
+ 'sort-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
24
+ filter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
25
+ query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
26
+ fields: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
27
+ sanitize: import("@oclif/core/interfaces").BooleanFlag<boolean>;
28
+ 'show-http-request': import("@oclif/core/interfaces").BooleanFlag<boolean>;
29
+ };
30
+ run(): Promise<void>;
31
+ private runImport;
32
+ private runExport;
33
+ private runCamt053Import;
34
+ private runNestedImport;
35
+ private parseFilterValue;
36
+ private filterFields;
37
+ private sanitizeOutput;
38
+ private getColumns;
39
+ private getValue;
40
+ private printTable;
41
+ private printCsv;
42
+ }