@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
@@ -31,6 +31,7 @@ export default class Accounts extends Command {
31
31
  private runExport;
32
32
  private runCamt053Import;
33
33
  private runNestedImport;
34
+ private parseFilterValue;
34
35
  private filterFields;
35
36
  private sanitizeOutput;
36
37
  private getColumns;
@@ -8,16 +8,16 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = ["notes"];
9
9
  const SUBCOMMANDS = [...["list", "create", "get", "update", "delete", "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/accounts', summary: 'List all accounts', pathParams: [], hasBody: false, isMultipart: false },
12
- 'create': { method: 'POST', path: '/v1/accounts', summary: 'Create a new account', pathParams: [], hasBody: true, isMultipart: false },
13
- 'get': { method: 'GET', path: '/v1/accounts/{id}', summary: 'Get an account by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
14
- 'update': { method: 'PATCH', path: '/v1/accounts/{id}', summary: 'Update an account', pathParams: ['id'], hasBody: true, isMultipart: false },
15
- 'delete': { method: 'DELETE', path: '/v1/accounts/{id}', summary: 'Delete an account', pathParams: ['id'], hasBody: false, isMultipart: false },
16
- 'list-notes': { method: 'GET', path: '/v1/accounts/{accountId}/notes', summary: 'Get all notes for an account', pathParams: ['accountId'], hasBody: false, isMultipart: false },
17
- 'create-notes': { method: 'POST', path: '/v1/accounts/{accountId}/notes', summary: 'Create a note for an account', pathParams: ['accountId'], hasBody: true, isMultipart: false },
18
- 'get-notes': { method: 'GET', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Get a specific note for an account', pathParams: ['accountId', 'noteId'], hasBody: false, isMultipart: false },
19
- 'update-notes': { method: 'PATCH', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Update a note for an account', pathParams: ['accountId', 'noteId'], hasBody: true, isMultipart: false },
20
- 'delete-notes': { method: 'DELETE', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Delete a note from an account', pathParams: ['accountId', 'noteId'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/accounts', summary: 'List all accounts', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'create': { method: 'POST', path: '/v1/accounts', summary: 'Create a new account', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tagIds', 'notes'] },
13
+ 'get': { method: 'GET', path: '/v1/accounts/{id}', summary: 'Get an account by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'update': { method: 'PATCH', path: '/v1/accounts/{id}', summary: 'Update an account', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tagIds'] },
15
+ 'delete': { method: 'DELETE', path: '/v1/accounts/{id}', summary: 'Delete an account', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
+ 'list-notes': { method: 'GET', path: '/v1/accounts/{accountId}/notes', summary: 'Get all notes for an account', pathParams: ['accountId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
17
+ 'create-notes': { method: 'POST', path: '/v1/accounts/{accountId}/notes', summary: 'Create a note for an account', pathParams: ['accountId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
18
+ 'get-notes': { method: 'GET', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Get a specific note for an account', pathParams: ['accountId', 'noteId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
19
+ 'update-notes': { method: 'PATCH', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Update a note for an account', pathParams: ['accountId', 'noteId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
20
+ 'delete-notes': { method: 'DELETE', path: '/v1/accounts/{accountId}/notes/{noteId}', summary: 'Delete a note from an account', pathParams: ['accountId', 'noteId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
21
21
  };
22
22
  export default class Accounts extends Command {
23
23
  static description = 'Manage accounts';
@@ -136,15 +136,7 @@ export default class Accounts extends Command {
136
136
  if (eqIndex === -1)
137
137
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
138
138
  const key = f.slice(0, eqIndex);
139
- let value = f.slice(eqIndex + 1);
140
- // Check for operator prefix (with or without $)
141
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
142
- if (opMatch) {
143
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
144
- }
145
- else {
146
- value = `\$eq:${value}`;
147
- }
139
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
148
140
  const filterKey = `filter.${key}`;
149
141
  if (filterKey in queryParams) {
150
142
  // Multiple filters on same field: collect as array
@@ -177,7 +169,9 @@ export default class Accounts extends Command {
177
169
  data = form;
178
170
  }
179
171
  else if (endpoint.hasBody) {
180
- if (flags.file) {
172
+ // For binary-response endpoints, --file is the output path, not a JSON
173
+ // input file — skip the read-as-body branch.
174
+ if (flags.file && !endpoint.isBinaryResponse) {
181
175
  const fsModule = await import('node:fs');
182
176
  try {
183
177
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -199,6 +193,7 @@ export default class Accounts extends Command {
199
193
  if (!data)
200
194
  data = {};
201
195
  const body = data;
196
+ const arrayFields = new Set(endpoint.bodyArrayFields);
202
197
  for (const pair of flags.set) {
203
198
  const eqIndex = pair.indexOf('=');
204
199
  if (eqIndex === -1)
@@ -210,6 +205,19 @@ export default class Accounts extends Command {
210
205
  value = JSON.parse(value);
211
206
  }
212
207
  catch { /* keep as string */ }
208
+ // For top-level keys typed as array in the API schema, split bare
209
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
210
+ // wrap a lone scalar in a single-element array. Skips when --set
211
+ // already provided a JSON array.
212
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
213
+ if (isArrayField && !Array.isArray(value)) {
214
+ if (typeof value === 'string') {
215
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
216
+ }
217
+ else if (value !== undefined && value !== null) {
218
+ value = [value];
219
+ }
220
+ }
213
221
  // Support nested keys like "address.city"
214
222
  const keys = key.split('.');
215
223
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -260,6 +268,26 @@ export default class Accounts extends Command {
260
268
  process.stderr.write('\n');
261
269
  }
262
270
  try {
271
+ // Binary response: download to file
272
+ if (endpoint.isBinaryResponse) {
273
+ if (!flags.file) {
274
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
275
+ }
276
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
277
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
278
+ data,
279
+ contextName: flags.context,
280
+ binary: true,
281
+ });
282
+ const fsModule = await import('node:fs');
283
+ const binData = binResponse.data;
284
+ const buffer = Buffer.isBuffer(binData)
285
+ ? binData
286
+ : Buffer.from(binData);
287
+ fsModule.writeFileSync(flags.file, buffer);
288
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
289
+ return;
290
+ }
263
291
  const response = await apiRequest(endpoint.method, apiPath, {
264
292
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
265
293
  data,
@@ -350,6 +378,7 @@ export default class Accounts extends Command {
350
378
  }
351
379
  else if (flags.set && flags.set.length > 0) {
352
380
  const item = {};
381
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
353
382
  for (const pair of flags.set) {
354
383
  const eqIndex = pair.indexOf('=');
355
384
  if (eqIndex === -1)
@@ -360,6 +389,15 @@ export default class Accounts extends Command {
360
389
  value = JSON.parse(value);
361
390
  }
362
391
  catch { /* keep as string */ }
392
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
393
+ if (isArrayField && !Array.isArray(value)) {
394
+ if (typeof value === 'string') {
395
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
396
+ }
397
+ else if (value !== undefined && value !== null) {
398
+ value = [value];
399
+ }
400
+ }
363
401
  const keys = key.split('.');
364
402
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
365
403
  this.error(`Invalid --set key: ${key}`);
@@ -509,14 +547,7 @@ export default class Accounts extends Command {
509
547
  if (eqIndex === -1)
510
548
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
511
549
  const key = f.slice(0, eqIndex);
512
- let value = f.slice(eqIndex + 1);
513
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
514
- if (opMatch) {
515
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
516
- }
517
- else {
518
- value = `\$eq:${value}`;
519
- }
550
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
520
551
  const filterKey = `filter.${key}`;
521
552
  if (filterKey in baseParams) {
522
553
  const existing = baseParams[filterKey];
@@ -693,6 +724,7 @@ export default class Accounts extends Command {
693
724
  }
694
725
  else if (flags.set && flags.set.length > 0) {
695
726
  const item = {};
727
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
696
728
  for (const pair of flags.set) {
697
729
  const eqIndex = pair.indexOf('=');
698
730
  if (eqIndex === -1)
@@ -703,6 +735,15 @@ export default class Accounts extends Command {
703
735
  value = JSON.parse(value);
704
736
  }
705
737
  catch { /* keep as string */ }
738
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
739
+ if (isArrayField && !Array.isArray(value)) {
740
+ if (typeof value === 'string') {
741
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
742
+ }
743
+ else if (value !== undefined && value !== null) {
744
+ value = [value];
745
+ }
746
+ }
706
747
  const keys = key.split('.');
707
748
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
708
749
  this.error(`Invalid --set key: ${key}`);
@@ -822,6 +863,21 @@ export default class Accounts extends Command {
822
863
  this.log('');
823
864
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
824
865
  }
866
+ parseFilterValue(value) {
867
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
868
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
869
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
870
+ // no operator prefix is present.
871
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
872
+ const m = value.match(opRe);
873
+ if (!m)
874
+ return `\$eq:${value}`;
875
+ const op = m[1];
876
+ const rest = value.slice(m[0].length);
877
+ if (rest === '')
878
+ return `\$${op}`;
879
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
880
+ }
825
881
  filterFields(data, fields) {
826
882
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
827
883
  const pick = (obj, keys) => {
@@ -30,6 +30,7 @@ export default class AgentRuns 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;
@@ -6,11 +6,13 @@ const HAS_IMPORT = false;
6
6
  const HAS_EXPORT = true;
7
7
  const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
- const SUBCOMMANDS = [...["list", "get", "retry"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
9
+ const SUBCOMMANDS = [...["list", "get", "retry", "restart", "discard"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/agent-runs', summary: 'List agent runs for the current tenant', pathParams: [], hasBody: false, isMultipart: false },
12
- 'get': { method: 'GET', path: '/v1/agent-runs/{runId}', summary: 'Get an agent-run detail by id', pathParams: ['runId'], hasBody: false, isMultipart: false },
13
- 'retry': { method: 'POST', path: '/v1/agent-runs/{runId}/retry', summary: 'Retry an agent run from NEEDS_REVIEW with a reviewer instruction', pathParams: ['runId'], hasBody: true, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/agent-runs', summary: 'List agent runs for the current tenant', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'get': { method: 'GET', path: '/v1/agent-runs/{runId}', summary: 'Get an agent-run detail by id', pathParams: ['runId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
13
+ 'retry': { method: 'POST', path: '/v1/agent-runs/{runId}/retry', summary: 'Retry an agent run from NEEDS_REVIEW with a reviewer instruction', pathParams: ['runId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'restart': { method: 'POST', path: '/v1/agent-runs/{runId}/restart', summary: 'Restart a FAILED agent run from its existing state', pathParams: ['runId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
15
+ 'discard': { method: 'POST', path: '/v1/agent-runs/{runId}/discard', summary: 'Discard an agent run with an optional reviewer reason', pathParams: ['runId'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
16
  };
15
17
  export default class AgentRuns extends Command {
16
18
  static description = 'Manage agent runs';
@@ -125,15 +127,7 @@ export default class AgentRuns extends Command {
125
127
  if (eqIndex === -1)
126
128
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
127
129
  const key = f.slice(0, eqIndex);
128
- let value = f.slice(eqIndex + 1);
129
- // Check for operator prefix (with or without $)
130
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
131
- if (opMatch) {
132
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
133
- }
134
- else {
135
- value = `\$eq:${value}`;
136
- }
130
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
137
131
  const filterKey = `filter.${key}`;
138
132
  if (filterKey in queryParams) {
139
133
  // Multiple filters on same field: collect as array
@@ -166,7 +160,9 @@ export default class AgentRuns extends Command {
166
160
  data = form;
167
161
  }
168
162
  else if (endpoint.hasBody) {
169
- if (flags.file) {
163
+ // For binary-response endpoints, --file is the output path, not a JSON
164
+ // input file — skip the read-as-body branch.
165
+ if (flags.file && !endpoint.isBinaryResponse) {
170
166
  const fsModule = await import('node:fs');
171
167
  try {
172
168
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -188,6 +184,7 @@ export default class AgentRuns extends Command {
188
184
  if (!data)
189
185
  data = {};
190
186
  const body = data;
187
+ const arrayFields = new Set(endpoint.bodyArrayFields);
191
188
  for (const pair of flags.set) {
192
189
  const eqIndex = pair.indexOf('=');
193
190
  if (eqIndex === -1)
@@ -199,6 +196,19 @@ export default class AgentRuns extends Command {
199
196
  value = JSON.parse(value);
200
197
  }
201
198
  catch { /* keep as string */ }
199
+ // For top-level keys typed as array in the API schema, split bare
200
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
201
+ // wrap a lone scalar in a single-element array. Skips when --set
202
+ // already provided a JSON array.
203
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
204
+ if (isArrayField && !Array.isArray(value)) {
205
+ if (typeof value === 'string') {
206
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
207
+ }
208
+ else if (value !== undefined && value !== null) {
209
+ value = [value];
210
+ }
211
+ }
202
212
  // Support nested keys like "address.city"
203
213
  const keys = key.split('.');
204
214
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -249,6 +259,26 @@ export default class AgentRuns extends Command {
249
259
  process.stderr.write('\n');
250
260
  }
251
261
  try {
262
+ // Binary response: download to file
263
+ if (endpoint.isBinaryResponse) {
264
+ if (!flags.file) {
265
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
266
+ }
267
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
268
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
269
+ data,
270
+ contextName: flags.context,
271
+ binary: true,
272
+ });
273
+ const fsModule = await import('node:fs');
274
+ const binData = binResponse.data;
275
+ const buffer = Buffer.isBuffer(binData)
276
+ ? binData
277
+ : Buffer.from(binData);
278
+ fsModule.writeFileSync(flags.file, buffer);
279
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
280
+ return;
281
+ }
252
282
  const response = await apiRequest(endpoint.method, apiPath, {
253
283
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
254
284
  data,
@@ -339,6 +369,7 @@ export default class AgentRuns extends Command {
339
369
  }
340
370
  else if (flags.set && flags.set.length > 0) {
341
371
  const item = {};
372
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
342
373
  for (const pair of flags.set) {
343
374
  const eqIndex = pair.indexOf('=');
344
375
  if (eqIndex === -1)
@@ -349,6 +380,15 @@ export default class AgentRuns extends Command {
349
380
  value = JSON.parse(value);
350
381
  }
351
382
  catch { /* keep as string */ }
383
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
384
+ if (isArrayField && !Array.isArray(value)) {
385
+ if (typeof value === 'string') {
386
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
387
+ }
388
+ else if (value !== undefined && value !== null) {
389
+ value = [value];
390
+ }
391
+ }
352
392
  const keys = key.split('.');
353
393
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
354
394
  this.error(`Invalid --set key: ${key}`);
@@ -498,14 +538,7 @@ export default class AgentRuns extends Command {
498
538
  if (eqIndex === -1)
499
539
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
500
540
  const key = f.slice(0, eqIndex);
501
- let value = f.slice(eqIndex + 1);
502
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
503
- if (opMatch) {
504
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
505
- }
506
- else {
507
- value = `\$eq:${value}`;
508
- }
541
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
509
542
  const filterKey = `filter.${key}`;
510
543
  if (filterKey in baseParams) {
511
544
  const existing = baseParams[filterKey];
@@ -682,6 +715,7 @@ export default class AgentRuns extends Command {
682
715
  }
683
716
  else if (flags.set && flags.set.length > 0) {
684
717
  const item = {};
718
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
685
719
  for (const pair of flags.set) {
686
720
  const eqIndex = pair.indexOf('=');
687
721
  if (eqIndex === -1)
@@ -692,6 +726,15 @@ export default class AgentRuns extends Command {
692
726
  value = JSON.parse(value);
693
727
  }
694
728
  catch { /* keep as string */ }
729
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
730
+ if (isArrayField && !Array.isArray(value)) {
731
+ if (typeof value === 'string') {
732
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
733
+ }
734
+ else if (value !== undefined && value !== null) {
735
+ value = [value];
736
+ }
737
+ }
695
738
  const keys = key.split('.');
696
739
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
697
740
  this.error(`Invalid --set key: ${key}`);
@@ -811,6 +854,21 @@ export default class AgentRuns extends Command {
811
854
  this.log('');
812
855
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
813
856
  }
857
+ parseFilterValue(value) {
858
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
859
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
860
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
861
+ // no operator prefix is present.
862
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
863
+ const m = value.match(opRe);
864
+ if (!m)
865
+ return `\$eq:${value}`;
866
+ const op = m[1];
867
+ const rest = value.slice(m[0].length);
868
+ if (rest === '')
869
+ return `\$${op}`;
870
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
871
+ }
814
872
  filterFields(data, fields) {
815
873
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
816
874
  const pick = (obj, keys) => {
@@ -0,0 +1,40 @@
1
+ import { Command } from '@oclif/core';
2
+ export default class AsyncEndpointsInternal 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
+ }