@aderis-erp/cli 1.0.3 → 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 (169) 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 3.js +1072 -0
  4. package/dist/commands/access-groups.d.ts +1 -0
  5. package/dist/commands/access-groups.js +79 -23
  6. package/dist/commands/account-transactions.d.ts +1 -0
  7. package/dist/commands/account-transactions.js +91 -35
  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 +1 -0
  11. package/dist/commands/accounts.js +84 -28
  12. package/dist/commands/agent-runs.d.ts +1 -0
  13. package/dist/commands/agent-runs.js +80 -22
  14. package/dist/commands/async-endpoints-internal 3.d.ts +40 -0
  15. package/dist/commands/async-endpoints-internal 3.js +1062 -0
  16. package/dist/commands/async-endpoints-internal.d.ts +1 -0
  17. package/dist/commands/async-endpoints-internal.js +77 -21
  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 +1 -0
  21. package/dist/commands/audit-log.js +77 -21
  22. package/dist/commands/bank-accounts.d.ts +1 -0
  23. package/dist/commands/bank-accounts.js +91 -35
  24. package/dist/commands/bank-integrations.d.ts +1 -0
  25. package/dist/commands/bank-integrations.js +92 -36
  26. package/dist/commands/business-partners 3.d.ts +41 -0
  27. package/dist/commands/business-partners 3.js +1078 -0
  28. package/dist/commands/business-partners---contacts 3.d.ts +42 -0
  29. package/dist/commands/business-partners---contacts 3.js +1072 -0
  30. package/dist/commands/business-partners---contacts.d.ts +1 -0
  31. package/dist/commands/business-partners---contacts.js +84 -28
  32. package/dist/commands/business-partners.d.ts +1 -0
  33. package/dist/commands/business-partners.js +84 -28
  34. package/dist/commands/credit-card-accounts 3.d.ts +42 -0
  35. package/dist/commands/credit-card-accounts 3.js +1084 -0
  36. package/dist/commands/credit-card-accounts.d.ts +1 -0
  37. package/dist/commands/credit-card-accounts.js +89 -33
  38. package/dist/commands/documents.d.ts +1 -0
  39. package/dist/commands/documents.js +80 -24
  40. package/dist/commands/dunning-configs 3.d.ts +40 -0
  41. package/dist/commands/dunning-configs 3.js +1072 -0
  42. package/dist/commands/dunning-configs.d.ts +1 -0
  43. package/dist/commands/dunning-configs.js +79 -23
  44. package/dist/commands/dunning-reminders.d.ts +1 -0
  45. package/dist/commands/dunning-reminders.js +82 -26
  46. package/dist/commands/dunning-runs 3.d.ts +40 -0
  47. package/dist/commands/dunning-runs 3.js +1061 -0
  48. package/dist/commands/dunning-runs.d.ts +1 -0
  49. package/dist/commands/dunning-runs.js +75 -19
  50. package/dist/commands/employees.d.ts +1 -0
  51. package/dist/commands/employees.js +106 -50
  52. package/dist/commands/event-processor-mappings 3.d.ts +40 -0
  53. package/dist/commands/event-processor-mappings 3.js +1071 -0
  54. package/dist/commands/event-processor-mappings.d.ts +1 -0
  55. package/dist/commands/event-processor-mappings.js +79 -23
  56. package/dist/commands/files-internal 3.d.ts +40 -0
  57. package/dist/commands/files-internal 3.js +1073 -0
  58. package/dist/commands/files-internal.d.ts +1 -0
  59. package/dist/commands/files-internal.js +83 -27
  60. package/dist/commands/health 3.d.ts +40 -0
  61. package/dist/commands/health 3.js +1067 -0
  62. package/dist/commands/health.d.ts +1 -0
  63. package/dist/commands/health.js +79 -23
  64. package/dist/commands/inbox 3.d.ts +40 -0
  65. package/dist/commands/inbox 3.js +1065 -0
  66. package/dist/commands/inbox.d.ts +1 -0
  67. package/dist/commands/inbox.js +79 -23
  68. package/dist/commands/integrations 3.d.ts +41 -0
  69. package/dist/commands/integrations 3.js +1067 -0
  70. package/dist/commands/integrations.d.ts +1 -0
  71. package/dist/commands/integrations.js +77 -21
  72. package/dist/commands/item-categories 3.d.ts +40 -0
  73. package/dist/commands/item-categories 3.js +1072 -0
  74. package/dist/commands/item-categories.d.ts +1 -0
  75. package/dist/commands/item-categories.js +79 -23
  76. package/dist/commands/items 3.d.ts +40 -0
  77. package/dist/commands/items 3.js +1072 -0
  78. package/dist/commands/items.d.ts +1 -0
  79. package/dist/commands/items.js +79 -23
  80. package/dist/commands/journal-lines.d.ts +1 -0
  81. package/dist/commands/journal-lines.js +75 -19
  82. package/dist/commands/journals 3.d.ts +42 -0
  83. package/dist/commands/journals 3.js +1088 -0
  84. package/dist/commands/journals.d.ts +1 -0
  85. package/dist/commands/journals.js +93 -37
  86. package/dist/commands/ledgers.d.ts +1 -0
  87. package/dist/commands/ledgers.js +90 -34
  88. package/dist/commands/office-locations 3.d.ts +40 -0
  89. package/dist/commands/office-locations 3.js +1072 -0
  90. package/dist/commands/office-locations.d.ts +1 -0
  91. package/dist/commands/office-locations.js +79 -23
  92. package/dist/commands/payment-method-ledger-mappings 3.d.ts +41 -0
  93. package/dist/commands/payment-method-ledger-mappings 3.js +1066 -0
  94. package/dist/commands/payment-method-ledger-mappings.d.ts +1 -0
  95. package/dist/commands/payment-method-ledger-mappings.js +79 -23
  96. package/dist/commands/payment-methods 3.d.ts +40 -0
  97. package/dist/commands/payment-methods 3.js +1072 -0
  98. package/dist/commands/payment-methods.d.ts +1 -0
  99. package/dist/commands/payment-methods.js +79 -23
  100. package/dist/commands/payment-runs 3.d.ts +42 -0
  101. package/dist/commands/payment-runs 3.js +1087 -0
  102. package/dist/commands/payment-runs.d.ts +1 -0
  103. package/dist/commands/payment-runs.js +92 -36
  104. package/dist/commands/payment-terms 3.d.ts +40 -0
  105. package/dist/commands/payment-terms 3.js +1073 -0
  106. package/dist/commands/payment-terms.d.ts +1 -0
  107. package/dist/commands/payment-terms.js +80 -24
  108. package/dist/commands/price-lists 3.d.ts +41 -0
  109. package/dist/commands/price-lists 3.js +1078 -0
  110. package/dist/commands/price-lists.d.ts +1 -0
  111. package/dist/commands/price-lists.js +84 -28
  112. package/dist/commands/processor-mappings 2.d.ts +40 -0
  113. package/dist/commands/processor-mappings 2.js +1070 -0
  114. package/dist/commands/processor-mappings.d.ts +1 -0
  115. package/dist/commands/processor-mappings.js +78 -22
  116. package/dist/commands/processors.d.ts +1 -0
  117. package/dist/commands/processors.js +83 -27
  118. package/dist/commands/reconciliation 3.d.ts +40 -0
  119. package/dist/commands/reconciliation 3.js +1069 -0
  120. package/dist/commands/reconciliation.d.ts +1 -0
  121. package/dist/commands/reconciliation.js +80 -24
  122. package/dist/commands/reports.d.ts +1 -0
  123. package/dist/commands/reports.js +80 -21
  124. package/dist/commands/salary-types 3.d.ts +40 -0
  125. package/dist/commands/salary-types 3.js +1072 -0
  126. package/dist/commands/salary-types.d.ts +1 -0
  127. package/dist/commands/salary-types.js +79 -23
  128. package/dist/commands/sales-invoices 3.d.ts +43 -0
  129. package/dist/commands/sales-invoices 3.js +1100 -0
  130. package/dist/commands/sales-invoices.d.ts +1 -0
  131. package/dist/commands/sales-invoices.js +104 -48
  132. package/dist/commands/sales-orders 3.d.ts +43 -0
  133. package/dist/commands/sales-orders 3.js +1098 -0
  134. package/dist/commands/sales-orders.d.ts +1 -0
  135. package/dist/commands/sales-orders.js +102 -46
  136. package/dist/commands/tags 3.d.ts +40 -0
  137. package/dist/commands/tags 3.js +1072 -0
  138. package/dist/commands/tags.d.ts +1 -0
  139. package/dist/commands/tags.js +79 -23
  140. package/dist/commands/tax-codes 3.d.ts +40 -0
  141. package/dist/commands/tax-codes 3.js +1075 -0
  142. package/dist/commands/tax-codes.d.ts +1 -0
  143. package/dist/commands/tax-codes.js +82 -26
  144. package/dist/commands/tax-matrix.d.ts +1 -0
  145. package/dist/commands/tax-matrix.js +79 -23
  146. package/dist/commands/tenants.d.ts +1 -0
  147. package/dist/commands/tenants.js +79 -23
  148. package/dist/commands/text-templates 3.d.ts +40 -0
  149. package/dist/commands/text-templates 3.js +1072 -0
  150. package/dist/commands/text-templates.d.ts +1 -0
  151. package/dist/commands/text-templates.js +79 -23
  152. package/dist/commands/tools.d.ts +1 -0
  153. package/dist/commands/tools.js +76 -20
  154. package/dist/commands/vendor-invoices.d.ts +1 -0
  155. package/dist/commands/vendor-invoices.js +108 -52
  156. package/dist/commands/webhooks 3.d.ts +40 -0
  157. package/dist/commands/webhooks 3.js +1074 -0
  158. package/dist/commands/webhooks.d.ts +1 -0
  159. package/dist/commands/webhooks.js +81 -25
  160. package/dist/commands/workflows.d.ts +1 -0
  161. package/dist/commands/workflows.js +77 -21
  162. package/dist/lib/api-client.d.ts +5 -1
  163. package/dist/lib/api-client.js +19 -5
  164. package/dist/lib/auth.js +17 -0
  165. package/dist/lib/config.js +1 -1
  166. package/oclif.manifest.json +6099 -711
  167. package/package.json +1 -1
  168. package/dist/index 2.js +0 -1
  169. package/dist/index.d 2.ts +0 -1
@@ -30,6 +30,7 @@ export default class AuditLog 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,9 +8,9 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
9
  const SUBCOMMANDS = [...["list", "find-entity", "find-workflow"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/audit-log', summary: 'Get audit log entries', pathParams: [], hasBody: false, isMultipart: false },
12
- 'find-entity': { method: 'GET', path: '/v1/audit-log/entity/{entityId}', summary: 'Get audit history for a specific entity', pathParams: ['entityId'], hasBody: false, isMultipart: false },
13
- 'find-workflow': { method: 'GET', path: '/v1/audit-log/workflow/{workflowId}', summary: 'Get audit log entries for a specific workflow', pathParams: ['workflowId'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/audit-log', summary: 'Get audit log entries', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'find-entity': { method: 'GET', path: '/v1/audit-log/entity/{entityId}', summary: 'Get audit history for a specific entity', pathParams: ['entityId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
13
+ 'find-workflow': { method: 'GET', path: '/v1/audit-log/workflow/{workflowId}', summary: 'Get audit log entries for a specific workflow', pathParams: ['workflowId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
14
  };
15
15
  export default class AuditLog extends Command {
16
16
  static description = 'Manage audit log';
@@ -124,15 +124,7 @@ export default class AuditLog extends Command {
124
124
  if (eqIndex === -1)
125
125
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
126
126
  const key = f.slice(0, eqIndex);
127
- let value = f.slice(eqIndex + 1);
128
- // Check for operator prefix (with or without $)
129
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
130
- if (opMatch) {
131
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
132
- }
133
- else {
134
- value = `\$eq:${value}`;
135
- }
127
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
136
128
  const filterKey = `filter.${key}`;
137
129
  if (filterKey in queryParams) {
138
130
  // Multiple filters on same field: collect as array
@@ -165,7 +157,9 @@ export default class AuditLog extends Command {
165
157
  data = form;
166
158
  }
167
159
  else if (endpoint.hasBody) {
168
- if (flags.file) {
160
+ // For binary-response endpoints, --file is the output path, not a JSON
161
+ // input file — skip the read-as-body branch.
162
+ if (flags.file && !endpoint.isBinaryResponse) {
169
163
  const fsModule = await import('node:fs');
170
164
  try {
171
165
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -187,6 +181,7 @@ export default class AuditLog extends Command {
187
181
  if (!data)
188
182
  data = {};
189
183
  const body = data;
184
+ const arrayFields = new Set(endpoint.bodyArrayFields);
190
185
  for (const pair of flags.set) {
191
186
  const eqIndex = pair.indexOf('=');
192
187
  if (eqIndex === -1)
@@ -198,6 +193,19 @@ export default class AuditLog extends Command {
198
193
  value = JSON.parse(value);
199
194
  }
200
195
  catch { /* keep as string */ }
196
+ // For top-level keys typed as array in the API schema, split bare
197
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
198
+ // wrap a lone scalar in a single-element array. Skips when --set
199
+ // already provided a JSON array.
200
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
201
+ if (isArrayField && !Array.isArray(value)) {
202
+ if (typeof value === 'string') {
203
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
204
+ }
205
+ else if (value !== undefined && value !== null) {
206
+ value = [value];
207
+ }
208
+ }
201
209
  // Support nested keys like "address.city"
202
210
  const keys = key.split('.');
203
211
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -248,6 +256,26 @@ export default class AuditLog extends Command {
248
256
  process.stderr.write('\n');
249
257
  }
250
258
  try {
259
+ // Binary response: download to file
260
+ if (endpoint.isBinaryResponse) {
261
+ if (!flags.file) {
262
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
263
+ }
264
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
265
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
266
+ data,
267
+ contextName: flags.context,
268
+ binary: true,
269
+ });
270
+ const fsModule = await import('node:fs');
271
+ const binData = binResponse.data;
272
+ const buffer = Buffer.isBuffer(binData)
273
+ ? binData
274
+ : Buffer.from(binData);
275
+ fsModule.writeFileSync(flags.file, buffer);
276
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
277
+ return;
278
+ }
251
279
  const response = await apiRequest(endpoint.method, apiPath, {
252
280
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
253
281
  data,
@@ -338,6 +366,7 @@ export default class AuditLog extends Command {
338
366
  }
339
367
  else if (flags.set && flags.set.length > 0) {
340
368
  const item = {};
369
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
341
370
  for (const pair of flags.set) {
342
371
  const eqIndex = pair.indexOf('=');
343
372
  if (eqIndex === -1)
@@ -348,6 +377,15 @@ export default class AuditLog extends Command {
348
377
  value = JSON.parse(value);
349
378
  }
350
379
  catch { /* keep as string */ }
380
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
381
+ if (isArrayField && !Array.isArray(value)) {
382
+ if (typeof value === 'string') {
383
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
384
+ }
385
+ else if (value !== undefined && value !== null) {
386
+ value = [value];
387
+ }
388
+ }
351
389
  const keys = key.split('.');
352
390
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
353
391
  this.error(`Invalid --set key: ${key}`);
@@ -497,14 +535,7 @@ export default class AuditLog extends Command {
497
535
  if (eqIndex === -1)
498
536
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
499
537
  const key = f.slice(0, eqIndex);
500
- let value = f.slice(eqIndex + 1);
501
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
502
- if (opMatch) {
503
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
504
- }
505
- else {
506
- value = `\$eq:${value}`;
507
- }
538
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
508
539
  const filterKey = `filter.${key}`;
509
540
  if (filterKey in baseParams) {
510
541
  const existing = baseParams[filterKey];
@@ -681,6 +712,7 @@ export default class AuditLog extends Command {
681
712
  }
682
713
  else if (flags.set && flags.set.length > 0) {
683
714
  const item = {};
715
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
684
716
  for (const pair of flags.set) {
685
717
  const eqIndex = pair.indexOf('=');
686
718
  if (eqIndex === -1)
@@ -691,6 +723,15 @@ export default class AuditLog extends Command {
691
723
  value = JSON.parse(value);
692
724
  }
693
725
  catch { /* keep as string */ }
726
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
727
+ if (isArrayField && !Array.isArray(value)) {
728
+ if (typeof value === 'string') {
729
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
730
+ }
731
+ else if (value !== undefined && value !== null) {
732
+ value = [value];
733
+ }
734
+ }
694
735
  const keys = key.split('.');
695
736
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
696
737
  this.error(`Invalid --set key: ${key}`);
@@ -810,6 +851,21 @@ export default class AuditLog extends Command {
810
851
  this.log('');
811
852
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
812
853
  }
854
+ parseFilterValue(value) {
855
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
856
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
857
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
858
+ // no operator prefix is present.
859
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
860
+ const m = value.match(opRe);
861
+ if (!m)
862
+ return `\$eq:${value}`;
863
+ const op = m[1];
864
+ const rest = value.slice(m[0].length);
865
+ if (rest === '')
866
+ return `\$${op}`;
867
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
868
+ }
813
869
  filterFields(data, fields) {
814
870
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
815
871
  const pick = (obj, keys) => {
@@ -32,6 +32,7 @@ export default class BankAccounts extends Command {
32
32
  private runExport;
33
33
  private runCamt053Import;
34
34
  private runNestedImport;
35
+ private parseFilterValue;
35
36
  private filterFields;
36
37
  private sanitizeOutput;
37
38
  private getColumns;
@@ -8,23 +8,23 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = ["ledger-mappings", "notes"];
9
9
  const SUBCOMMANDS = [...["list", "create", "get", "update", "delete", "get-balances", "get-balances-latest", "list-ledger-mappings", "create-ledger-mappings", "get-ledger-mappings", "update-ledger-mappings", "delete-ledger-mappings", "list-notes", "create-notes", "get-notes", "update-notes", "delete-notes"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/bank-accounts', summary: 'Get all bank accounts with pagination', pathParams: [], hasBody: false, isMultipart: false },
12
- 'create': { method: 'POST', path: '/v1/bank-accounts', summary: 'Create a new bank account (with optional notes)', pathParams: [], hasBody: true, isMultipart: false },
13
- 'get': { method: 'GET', path: '/v1/bank-accounts/{id}', summary: 'Get a bank account by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
14
- 'update': { method: 'PATCH', path: '/v1/bank-accounts/{id}', summary: 'Update a bank account', pathParams: ['id'], hasBody: true, isMultipart: false },
15
- 'delete': { method: 'DELETE', path: '/v1/bank-accounts/{id}', summary: 'Delete a bank account', pathParams: ['id'], hasBody: false, isMultipart: false },
16
- 'get-balances': { method: 'GET', path: '/v1/bank-accounts/{id}/balances', summary: 'Get balance history for a bank account', pathParams: ['id'], hasBody: false, isMultipart: false },
17
- 'get-balances-latest': { method: 'GET', path: '/v1/bank-accounts/{id}/balances/latest', summary: 'Get latest balances (OPBD, CLBD, CLAV) for a bank account', pathParams: ['id'], hasBody: false, isMultipart: false },
18
- 'list-ledger-mappings': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings', summary: 'Get all ledger mappings for a bank account', pathParams: ['bankAccountId'], hasBody: false, isMultipart: false },
19
- 'create-ledger-mappings': { method: 'POST', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings', summary: 'Create a ledger mapping for a bank account', pathParams: ['bankAccountId'], hasBody: true, isMultipart: false },
20
- 'get-ledger-mappings': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Get a ledger mapping by ID', pathParams: ['bankAccountId', 'mappingId'], hasBody: false, isMultipart: false },
21
- 'update-ledger-mappings': { method: 'PATCH', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Update a ledger mapping', pathParams: ['bankAccountId', 'mappingId'], hasBody: true, isMultipart: false },
22
- 'delete-ledger-mappings': { method: 'DELETE', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Delete a ledger mapping', pathParams: ['bankAccountId', 'mappingId'], hasBody: false, isMultipart: false },
23
- 'list-notes': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/notes', summary: 'Get all notes for a bank account', pathParams: ['bankAccountId'], hasBody: false, isMultipart: false },
24
- 'create-notes': { method: 'POST', path: '/v1/bank-accounts/{bankAccountId}/notes', summary: 'Create a note for a bank account', pathParams: ['bankAccountId'], hasBody: true, isMultipart: false },
25
- 'get-notes': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Get a specific note for a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: false, isMultipart: false },
26
- 'update-notes': { method: 'PATCH', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Update a note for a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: true, isMultipart: false },
27
- 'delete-notes': { method: 'DELETE', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Delete a note from a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/bank-accounts', summary: 'Get all bank accounts with pagination', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'create': { method: 'POST', path: '/v1/bank-accounts', summary: 'Create a new bank account (with optional notes)', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['paymentRunDays', 'notes'] },
13
+ 'get': { method: 'GET', path: '/v1/bank-accounts/{id}', summary: 'Get a bank account by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'update': { method: 'PATCH', path: '/v1/bank-accounts/{id}', summary: 'Update a bank account', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['paymentRunDays', 'notes'] },
15
+ 'delete': { method: 'DELETE', path: '/v1/bank-accounts/{id}', summary: 'Delete a bank account', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
+ 'get-balances': { method: 'GET', path: '/v1/bank-accounts/{id}/balances', summary: 'Get balance history for a bank account', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
17
+ 'get-balances-latest': { method: 'GET', path: '/v1/bank-accounts/{id}/balances/latest', summary: 'Get latest balances (OPBD, CLBD, CLAV) for a bank account', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
18
+ 'list-ledger-mappings': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings', summary: 'Get all ledger mappings for a bank account', pathParams: ['bankAccountId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
19
+ 'create-ledger-mappings': { method: 'POST', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings', summary: 'Create a ledger mapping for a bank account', pathParams: ['bankAccountId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
20
+ 'get-ledger-mappings': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Get a ledger mapping by ID', pathParams: ['bankAccountId', 'mappingId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
21
+ 'update-ledger-mappings': { method: 'PATCH', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Update a ledger mapping', pathParams: ['bankAccountId', 'mappingId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
22
+ 'delete-ledger-mappings': { method: 'DELETE', path: '/v1/bank-accounts/{bankAccountId}/ledger-mappings/{mappingId}', summary: 'Delete a ledger mapping', pathParams: ['bankAccountId', 'mappingId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
23
+ 'list-notes': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/notes', summary: 'Get all notes for a bank account', pathParams: ['bankAccountId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
24
+ 'create-notes': { method: 'POST', path: '/v1/bank-accounts/{bankAccountId}/notes', summary: 'Create a note for a bank account', pathParams: ['bankAccountId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
25
+ 'get-notes': { method: 'GET', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Get a specific note for a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
26
+ 'update-notes': { method: 'PATCH', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Update a note for a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
27
+ 'delete-notes': { method: 'DELETE', path: '/v1/bank-accounts/{bankAccountId}/notes/{noteId}', summary: 'Delete a note from a bank account', pathParams: ['bankAccountId', 'noteId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
28
28
  };
29
29
  export default class BankAccounts extends Command {
30
30
  static description = 'Manage bank accounts';
@@ -144,15 +144,7 @@ export default class BankAccounts extends Command {
144
144
  if (eqIndex === -1)
145
145
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
146
146
  const key = f.slice(0, eqIndex);
147
- let value = f.slice(eqIndex + 1);
148
- // Check for operator prefix (with or without $)
149
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
150
- if (opMatch) {
151
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
152
- }
153
- else {
154
- value = `\$eq:${value}`;
155
- }
147
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
156
148
  const filterKey = `filter.${key}`;
157
149
  if (filterKey in queryParams) {
158
150
  // Multiple filters on same field: collect as array
@@ -185,7 +177,9 @@ export default class BankAccounts extends Command {
185
177
  data = form;
186
178
  }
187
179
  else if (endpoint.hasBody) {
188
- if (flags.file) {
180
+ // For binary-response endpoints, --file is the output path, not a JSON
181
+ // input file — skip the read-as-body branch.
182
+ if (flags.file && !endpoint.isBinaryResponse) {
189
183
  const fsModule = await import('node:fs');
190
184
  try {
191
185
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -207,6 +201,7 @@ export default class BankAccounts extends Command {
207
201
  if (!data)
208
202
  data = {};
209
203
  const body = data;
204
+ const arrayFields = new Set(endpoint.bodyArrayFields);
210
205
  for (const pair of flags.set) {
211
206
  const eqIndex = pair.indexOf('=');
212
207
  if (eqIndex === -1)
@@ -218,6 +213,19 @@ export default class BankAccounts extends Command {
218
213
  value = JSON.parse(value);
219
214
  }
220
215
  catch { /* keep as string */ }
216
+ // For top-level keys typed as array in the API schema, split bare
217
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
218
+ // wrap a lone scalar in a single-element array. Skips when --set
219
+ // already provided a JSON array.
220
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
221
+ if (isArrayField && !Array.isArray(value)) {
222
+ if (typeof value === 'string') {
223
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
224
+ }
225
+ else if (value !== undefined && value !== null) {
226
+ value = [value];
227
+ }
228
+ }
221
229
  // Support nested keys like "address.city"
222
230
  const keys = key.split('.');
223
231
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -268,6 +276,26 @@ export default class BankAccounts extends Command {
268
276
  process.stderr.write('\n');
269
277
  }
270
278
  try {
279
+ // Binary response: download to file
280
+ if (endpoint.isBinaryResponse) {
281
+ if (!flags.file) {
282
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
283
+ }
284
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
285
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
286
+ data,
287
+ contextName: flags.context,
288
+ binary: true,
289
+ });
290
+ const fsModule = await import('node:fs');
291
+ const binData = binResponse.data;
292
+ const buffer = Buffer.isBuffer(binData)
293
+ ? binData
294
+ : Buffer.from(binData);
295
+ fsModule.writeFileSync(flags.file, buffer);
296
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
297
+ return;
298
+ }
271
299
  const response = await apiRequest(endpoint.method, apiPath, {
272
300
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
273
301
  data,
@@ -358,6 +386,7 @@ export default class BankAccounts extends Command {
358
386
  }
359
387
  else if (flags.set && flags.set.length > 0) {
360
388
  const item = {};
389
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
361
390
  for (const pair of flags.set) {
362
391
  const eqIndex = pair.indexOf('=');
363
392
  if (eqIndex === -1)
@@ -368,6 +397,15 @@ export default class BankAccounts extends Command {
368
397
  value = JSON.parse(value);
369
398
  }
370
399
  catch { /* keep as string */ }
400
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
401
+ if (isArrayField && !Array.isArray(value)) {
402
+ if (typeof value === 'string') {
403
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
404
+ }
405
+ else if (value !== undefined && value !== null) {
406
+ value = [value];
407
+ }
408
+ }
371
409
  const keys = key.split('.');
372
410
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
373
411
  this.error(`Invalid --set key: ${key}`);
@@ -517,14 +555,7 @@ export default class BankAccounts extends Command {
517
555
  if (eqIndex === -1)
518
556
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
519
557
  const key = f.slice(0, eqIndex);
520
- let value = f.slice(eqIndex + 1);
521
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
522
- if (opMatch) {
523
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
524
- }
525
- else {
526
- value = `\$eq:${value}`;
527
- }
558
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
528
559
  const filterKey = `filter.${key}`;
529
560
  if (filterKey in baseParams) {
530
561
  const existing = baseParams[filterKey];
@@ -701,6 +732,7 @@ export default class BankAccounts extends Command {
701
732
  }
702
733
  else if (flags.set && flags.set.length > 0) {
703
734
  const item = {};
735
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
704
736
  for (const pair of flags.set) {
705
737
  const eqIndex = pair.indexOf('=');
706
738
  if (eqIndex === -1)
@@ -711,6 +743,15 @@ export default class BankAccounts extends Command {
711
743
  value = JSON.parse(value);
712
744
  }
713
745
  catch { /* keep as string */ }
746
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
747
+ if (isArrayField && !Array.isArray(value)) {
748
+ if (typeof value === 'string') {
749
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
750
+ }
751
+ else if (value !== undefined && value !== null) {
752
+ value = [value];
753
+ }
754
+ }
714
755
  const keys = key.split('.');
715
756
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
716
757
  this.error(`Invalid --set key: ${key}`);
@@ -830,6 +871,21 @@ export default class BankAccounts extends Command {
830
871
  this.log('');
831
872
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
832
873
  }
874
+ parseFilterValue(value) {
875
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
876
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
877
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
878
+ // no operator prefix is present.
879
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
880
+ const m = value.match(opRe);
881
+ if (!m)
882
+ return `\$eq:${value}`;
883
+ const op = m[1];
884
+ const rest = value.slice(m[0].length);
885
+ if (rest === '')
886
+ return `\$${op}`;
887
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
888
+ }
833
889
  filterFields(data, fields) {
834
890
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
835
891
  const pick = (obj, keys) => {
@@ -32,6 +32,7 @@ export default class BankIntegrations extends Command {
32
32
  private runExport;
33
33
  private runCamt053Import;
34
34
  private runNestedImport;
35
+ private parseFilterValue;
35
36
  private filterFields;
36
37
  private sanitizeOutput;
37
38
  private getColumns;