@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 Webhooks 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,13 +8,13 @@ const HAS_CAMT053 = false;
8
8
  const NESTED_IMPORTS = [];
9
9
  const SUBCOMMANDS = [...["list", "create", "events", "events-relations", "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/webhooks', summary: 'List all webhook subscriptions', pathParams: [], hasBody: false, isMultipart: false },
12
- 'create': { method: 'POST', path: '/v1/webhooks', summary: 'Create a new webhook subscription', pathParams: [], hasBody: true, isMultipart: false },
13
- 'events': { method: 'GET', path: '/v1/webhooks/events', summary: 'Get available event types', pathParams: [], hasBody: false, isMultipart: false },
14
- 'events-relations': { method: 'GET', path: '/v1/webhooks/events/{eventType}/relations', summary: 'Get valid relations for an event type', pathParams: ['eventType'], hasBody: false, isMultipart: false },
15
- 'get': { method: 'GET', path: '/v1/webhooks/{id}', summary: 'Get a webhook subscription by ID', pathParams: ['id'], hasBody: false, isMultipart: false },
16
- 'update': { method: 'PATCH', path: '/v1/webhooks/{id}', summary: 'Update a webhook subscription', pathParams: ['id'], hasBody: true, isMultipart: false },
17
- 'delete': { method: 'DELETE', path: '/v1/webhooks/{id}', summary: 'Delete a webhook subscription', pathParams: ['id'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/webhooks', summary: 'List all webhook subscriptions', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'create': { method: 'POST', path: '/v1/webhooks', summary: 'Create a new webhook subscription', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tenantIds'] },
13
+ 'events': { method: 'GET', path: '/v1/webhooks/events', summary: 'Get available event types', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
+ 'events-relations': { method: 'GET', path: '/v1/webhooks/events/{eventType}/relations', summary: 'Get valid relations for an event type', pathParams: ['eventType'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
15
+ 'get': { method: 'GET', path: '/v1/webhooks/{id}', summary: 'Get a webhook subscription by ID', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
16
+ 'update': { method: 'PATCH', path: '/v1/webhooks/{id}', summary: 'Update a webhook subscription', pathParams: ['id'], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: ['tenantIds'] },
17
+ 'delete': { method: 'DELETE', path: '/v1/webhooks/{id}', summary: 'Delete a webhook subscription', pathParams: ['id'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
18
18
  };
19
19
  export default class Webhooks extends Command {
20
20
  static description = 'Manage webhooks';
@@ -132,15 +132,7 @@ export default class Webhooks extends Command {
132
132
  if (eqIndex === -1)
133
133
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
134
134
  const key = f.slice(0, eqIndex);
135
- let value = f.slice(eqIndex + 1);
136
- // Check for operator prefix (with or without $)
137
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
138
- if (opMatch) {
139
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
140
- }
141
- else {
142
- value = `\$eq:${value}`;
143
- }
135
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
144
136
  const filterKey = `filter.${key}`;
145
137
  if (filterKey in queryParams) {
146
138
  // Multiple filters on same field: collect as array
@@ -173,7 +165,9 @@ export default class Webhooks extends Command {
173
165
  data = form;
174
166
  }
175
167
  else if (endpoint.hasBody) {
176
- if (flags.file) {
168
+ // For binary-response endpoints, --file is the output path, not a JSON
169
+ // input file — skip the read-as-body branch.
170
+ if (flags.file && !endpoint.isBinaryResponse) {
177
171
  const fsModule = await import('node:fs');
178
172
  try {
179
173
  data = JSON.parse(fsModule.readFileSync(flags.file, 'utf-8'));
@@ -195,6 +189,7 @@ export default class Webhooks extends Command {
195
189
  if (!data)
196
190
  data = {};
197
191
  const body = data;
192
+ const arrayFields = new Set(endpoint.bodyArrayFields);
198
193
  for (const pair of flags.set) {
199
194
  const eqIndex = pair.indexOf('=');
200
195
  if (eqIndex === -1)
@@ -206,6 +201,19 @@ export default class Webhooks extends Command {
206
201
  value = JSON.parse(value);
207
202
  }
208
203
  catch { /* keep as string */ }
204
+ // For top-level keys typed as array in the API schema, split bare
205
+ // comma-separated input (e.g. "1171,1170" -> ["1171","1170"]) and
206
+ // wrap a lone scalar in a single-element array. Skips when --set
207
+ // already provided a JSON array.
208
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
209
+ if (isArrayField && !Array.isArray(value)) {
210
+ if (typeof value === 'string') {
211
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
212
+ }
213
+ else if (value !== undefined && value !== null) {
214
+ value = [value];
215
+ }
216
+ }
209
217
  // Support nested keys like "address.city"
210
218
  const keys = key.split('.');
211
219
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
@@ -256,6 +264,26 @@ export default class Webhooks extends Command {
256
264
  process.stderr.write('\n');
257
265
  }
258
266
  try {
267
+ // Binary response: download to file
268
+ if (endpoint.isBinaryResponse) {
269
+ if (!flags.file) {
270
+ this.error(`Endpoint returns a binary file. Specify the output path with -f / --file (e.g. -f report.xlsx).`);
271
+ }
272
+ const binResponse = await apiRequest(endpoint.method, apiPath, {
273
+ params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
274
+ data,
275
+ contextName: flags.context,
276
+ binary: true,
277
+ });
278
+ const fsModule = await import('node:fs');
279
+ const binData = binResponse.data;
280
+ const buffer = Buffer.isBuffer(binData)
281
+ ? binData
282
+ : Buffer.from(binData);
283
+ fsModule.writeFileSync(flags.file, buffer);
284
+ this.log(`Saved ${buffer.length} bytes to ${flags.file}`);
285
+ return;
286
+ }
259
287
  const response = await apiRequest(endpoint.method, apiPath, {
260
288
  params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
261
289
  data,
@@ -346,6 +374,7 @@ export default class Webhooks extends Command {
346
374
  }
347
375
  else if (flags.set && flags.set.length > 0) {
348
376
  const item = {};
377
+ const arrayFields = new Set(ENDPOINTS['create']?.bodyArrayFields ?? []);
349
378
  for (const pair of flags.set) {
350
379
  const eqIndex = pair.indexOf('=');
351
380
  if (eqIndex === -1)
@@ -356,6 +385,15 @@ export default class Webhooks extends Command {
356
385
  value = JSON.parse(value);
357
386
  }
358
387
  catch { /* keep as string */ }
388
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
389
+ if (isArrayField && !Array.isArray(value)) {
390
+ if (typeof value === 'string') {
391
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
392
+ }
393
+ else if (value !== undefined && value !== null) {
394
+ value = [value];
395
+ }
396
+ }
359
397
  const keys = key.split('.');
360
398
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
361
399
  this.error(`Invalid --set key: ${key}`);
@@ -505,14 +543,7 @@ export default class Webhooks extends Command {
505
543
  if (eqIndex === -1)
506
544
  this.error(`Invalid --filter format: ${f}. Use: --filter key=value`);
507
545
  const key = f.slice(0, eqIndex);
508
- let value = f.slice(eqIndex + 1);
509
- const opMatch = value.match(/^\$?(eq|ne|in|like|gt|gte|lt|lte|null):/);
510
- if (opMatch) {
511
- value = `\$${opMatch[1]}:${value.slice(opMatch[0].length)}`;
512
- }
513
- else {
514
- value = `\$eq:${value}`;
515
- }
546
+ const value = this.parseFilterValue(f.slice(eqIndex + 1));
516
547
  const filterKey = `filter.${key}`;
517
548
  if (filterKey in baseParams) {
518
549
  const existing = baseParams[filterKey];
@@ -689,6 +720,7 @@ export default class Webhooks extends Command {
689
720
  }
690
721
  else if (flags.set && flags.set.length > 0) {
691
722
  const item = {};
723
+ const arrayFields = new Set(ENDPOINTS[`create-${suffix}`]?.bodyArrayFields ?? []);
692
724
  for (const pair of flags.set) {
693
725
  const eqIndex = pair.indexOf('=');
694
726
  if (eqIndex === -1)
@@ -699,6 +731,15 @@ export default class Webhooks extends Command {
699
731
  value = JSON.parse(value);
700
732
  }
701
733
  catch { /* keep as string */ }
734
+ const isArrayField = !key.includes('.') && arrayFields.has(key);
735
+ if (isArrayField && !Array.isArray(value)) {
736
+ if (typeof value === 'string') {
737
+ value = value.split(',').map(v => v.trim()).filter(v => v.length > 0);
738
+ }
739
+ else if (value !== undefined && value !== null) {
740
+ value = [value];
741
+ }
742
+ }
702
743
  const keys = key.split('.');
703
744
  if (keys.some(k => k === '__proto__' || k === 'constructor' || k === 'prototype')) {
704
745
  this.error(`Invalid --set key: ${key}`);
@@ -818,6 +859,21 @@ export default class Webhooks extends Command {
818
859
  this.log('');
819
860
  this.log(`Summary: ${created} created, ${updated} updated, ${errors.length} failed`);
820
861
  }
862
+ parseFilterValue(value) {
863
+ // Recognises the nestjs-paginate operator set (with or without the leading $)
864
+ // and recursively unwraps chained operators like 'not:null' -> '$not:$null'
865
+ // or 'not:like:John' -> '$not:$like:John'. Falls back to '$eq:<value>' when
866
+ // no operator prefix is present.
867
+ const opRe = /^\$?(and|or|not|eq|gt|gte|in|null|lt|lte|btw|ne|ilike|like|sw|contains)(?::|$)/;
868
+ const m = value.match(opRe);
869
+ if (!m)
870
+ return `\$eq:${value}`;
871
+ const op = m[1];
872
+ const rest = value.slice(m[0].length);
873
+ if (rest === '')
874
+ return `\$${op}`;
875
+ return opRe.test(rest) ? `\$${op}:${this.parseFilterValue(rest)}` : `\$${op}:${rest}`;
876
+ }
821
877
  filterFields(data, fields) {
822
878
  const isUnsafeKey = (k) => k === '__proto__' || k === 'constructor' || k === 'prototype';
823
879
  const pick = (obj, keys) => {
@@ -30,6 +30,7 @@ export default class Workflows 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", "status", "find"], ...(HAS_IMPORT ? ['import'] : []), ...(HAS_EXPORT ? ['export'] : []), ...NESTED_IMPORTS.map(n => `import-${n}`)];
10
10
  const ENDPOINTS = {
11
- 'list': { method: 'GET', path: '/v1/workflows', summary: 'Get all workflows with their summary', pathParams: [], hasBody: false, isMultipart: false },
12
- 'status': { method: 'POST', path: '/v1/workflows/status', summary: 'Create a new workflow status update', pathParams: [], hasBody: true, isMultipart: false },
13
- 'find': { method: 'GET', path: '/v1/workflows/{workflowId}', summary: 'Get workflow details including status updates and entity changes', pathParams: ['workflowId'], hasBody: false, isMultipart: false },
11
+ 'list': { method: 'GET', path: '/v1/workflows', summary: 'Get all workflows with their summary', pathParams: [], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
12
+ 'status': { method: 'POST', path: '/v1/workflows/status', summary: 'Create a new workflow status update', pathParams: [], hasBody: true, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
13
+ 'find': { method: 'GET', path: '/v1/workflows/{workflowId}', summary: 'Get workflow details including status updates and entity changes', pathParams: ['workflowId'], hasBody: false, isMultipart: false, isBinaryResponse: false, bodyArrayFields: [] },
14
14
  };
15
15
  export default class Workflows extends Command {
16
16
  static description = 'Manage workflows';
@@ -124,15 +124,7 @@ export default class Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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 Workflows 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) => {
@@ -25,9 +25,13 @@ export declare class ApiError extends Error {
25
25
  data?: unknown | undefined;
26
26
  constructor(message: string, status: number, data?: unknown | undefined);
27
27
  }
28
- export declare function createApiClient(contextName?: string, acceptAny?: boolean): Promise<AxiosInstance>;
28
+ export declare function createApiClient(contextName?: string, options?: {
29
+ acceptAny?: boolean;
30
+ binary?: boolean;
31
+ } | boolean): Promise<AxiosInstance>;
29
32
  export declare function apiRequest<T = unknown>(method: string, path: string, options?: {
30
33
  acceptAny?: boolean;
34
+ binary?: boolean;
31
35
  contentType?: string;
32
36
  contextName?: string;
33
37
  data?: unknown;
@@ -11,7 +11,10 @@ export class ApiError extends Error {
11
11
  this.name = 'ApiError';
12
12
  }
13
13
  }
14
- export async function createApiClient(contextName, acceptAny = false) {
14
+ export async function createApiClient(contextName, options = false) {
15
+ // Backwards compatibility: a boolean argument means `acceptAny`.
16
+ const opts = typeof options === 'boolean' ? { acceptAny: options } : options;
17
+ const { acceptAny = false, binary = false } = opts;
15
18
  const context = contextName ? (await import('./config.js')).getContext(contextName) : getCurrentContext();
16
19
  if (!context) {
17
20
  throw new Error('No context configured. Run: aderis auth login --new');
@@ -21,14 +24,14 @@ export async function createApiClient(contextName, acceptAny = false) {
21
24
  const client = axios.create({
22
25
  baseURL,
23
26
  headers: {
24
- Accept: acceptAny ? '*/*' : 'application/json',
27
+ Accept: binary ? '*/*' : (acceptAny ? '*/*' : 'application/json'),
25
28
  Authorization: `Bearer ${token}`,
26
29
  'Content-Type': 'application/json',
27
30
  },
28
31
  // Serialize arrays as repeated params (key=v1&key=v2) instead of bracket format (key[]=v1)
29
32
  paramsSerializer: { indexes: null },
30
- // Allow any response type when acceptAny is true
31
- responseType: acceptAny ? 'text' : 'json',
33
+ // Binary downloads come back as raw bytes; otherwise honour acceptAny.
34
+ responseType: binary ? 'arraybuffer' : (acceptAny ? 'text' : 'json'),
32
35
  });
33
36
  // Response interceptor for error handling
34
37
  client.interceptors.response.use((response) => response, (error) => {
@@ -45,6 +48,14 @@ export async function createApiClient(contextName, acceptAny = false) {
45
48
  return client;
46
49
  }
47
50
  function extractErrorMessage(data) {
51
+ // Binary requests buffer the response as ArrayBuffer / Buffer / Uint8Array.
52
+ // Decode it before parsing so error payloads aren't reported as "Unknown error".
53
+ if (data instanceof ArrayBuffer) {
54
+ return extractErrorMessage(new TextDecoder().decode(new Uint8Array(data)));
55
+ }
56
+ if (data instanceof Uint8Array || (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))) {
57
+ return extractErrorMessage(new TextDecoder().decode(data));
58
+ }
48
59
  // If data is a JSON string, try to parse it first
49
60
  if (typeof data === 'string') {
50
61
  try {
@@ -75,7 +86,10 @@ function extractErrorMessage(data) {
75
86
  return 'Unknown error';
76
87
  }
77
88
  export async function apiRequest(method, path, options = {}) {
78
- const client = await createApiClient(options.contextName, options.acceptAny);
89
+ const client = await createApiClient(options.contextName, {
90
+ acceptAny: options.acceptAny,
91
+ binary: options.binary,
92
+ });
79
93
  const config = {
80
94
  method,
81
95
  url: path,
package/dist/lib/auth.js CHANGED
@@ -220,7 +220,17 @@ export async function login(context, options = {}) {
220
220
  }
221
221
  connections.clear();
222
222
  server.close();
223
+ process.off('SIGINT', onSigint);
223
224
  };
225
+ const onSigint = () => {
226
+ closeServer();
227
+ // Exit with the standard SIGINT code so the parent shell sees the
228
+ // expected termination status instead of a hung process. This is a CLI;
229
+ // process.exit is the correct way to bail from a SIGINT.
230
+ // eslint-disable-next-line unicorn/no-process-exit, n/no-process-exit
231
+ process.exit(130);
232
+ };
233
+ process.once('SIGINT', onSigint);
224
234
  server.listen(CALLBACK_PORT, () => {
225
235
  console.log(`Opening browser for authentication...`);
226
236
  console.log(`If the browser doesn't open, visit: ${authorizationUrl}`);
@@ -454,7 +464,14 @@ export async function loginAndSwitchTenant(context, tenantId) {
454
464
  }
455
465
  connections.clear();
456
466
  server.close();
467
+ process.off('SIGINT', onSigint);
468
+ };
469
+ const onSigint = () => {
470
+ closeServer();
471
+ // eslint-disable-next-line unicorn/no-process-exit, n/no-process-exit
472
+ process.exit(130);
457
473
  };
474
+ process.once('SIGINT', onSigint);
458
475
  const server = http.createServer(async (req, res) => {
459
476
  const url = new URL(req.url || '', `http://localhost:${CALLBACK_PORT}`);
460
477
  if (url.pathname !== '/oauth/callback') {
@@ -20,7 +20,7 @@ export const BASE_URLS = {
20
20
  export const DEFAULT_CLIENT_IDS = {
21
21
  dev: '74fd96f8-cf4b-49d8-b713-2a121ea22910',
22
22
  live: '970d9568-84c9-4613-b966-30d7e1d93828',
23
- test: '', // TODO: Add test client ID
23
+ test: 'bf0e5dd6-419f-4d64-8951-2c385533651f',
24
24
  };
25
25
  const CONFIG_DIR = path.join(os.homedir(), '.aderis');
26
26
  // Ensure config directory exists