@epilot/sdk 2.18.10 → 2.18.12

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 (139) hide show
  1. package/definitions/file-runtime.json +1 -1
  2. package/definitions/file.json +178 -0
  3. package/definitions/integration-toolkit.json +54 -42
  4. package/dist/apis/access-token.cjs +6 -6
  5. package/dist/apis/access-token.js +1 -1
  6. package/dist/apis/address-suggestions.cjs +6 -6
  7. package/dist/apis/address-suggestions.js +1 -1
  8. package/dist/apis/address.cjs +6 -6
  9. package/dist/apis/address.js +1 -1
  10. package/dist/apis/ai-agents.cjs +6 -6
  11. package/dist/apis/ai-agents.js +1 -1
  12. package/dist/apis/app.cjs +6 -6
  13. package/dist/apis/app.js +1 -1
  14. package/dist/apis/audit-logs.cjs +6 -6
  15. package/dist/apis/audit-logs.js +1 -1
  16. package/dist/apis/automation.cjs +6 -6
  17. package/dist/apis/automation.js +1 -1
  18. package/dist/apis/billing.cjs +6 -6
  19. package/dist/apis/billing.js +1 -1
  20. package/dist/apis/blueprint-manifest.cjs +6 -6
  21. package/dist/apis/blueprint-manifest.js +1 -1
  22. package/dist/apis/calendar.cjs +6 -6
  23. package/dist/apis/calendar.js +1 -1
  24. package/dist/apis/configuration-hub.cjs +6 -6
  25. package/dist/apis/configuration-hub.js +1 -1
  26. package/dist/apis/consent.cjs +6 -6
  27. package/dist/apis/consent.js +1 -1
  28. package/dist/apis/customer-portal.cjs +6 -6
  29. package/dist/apis/customer-portal.js +1 -1
  30. package/dist/apis/dashboard.cjs +6 -6
  31. package/dist/apis/dashboard.js +1 -1
  32. package/dist/apis/data-governance.cjs +6 -6
  33. package/dist/apis/data-governance.js +1 -1
  34. package/dist/apis/deduplication.cjs +6 -6
  35. package/dist/apis/deduplication.js +1 -1
  36. package/dist/apis/design.cjs +6 -6
  37. package/dist/apis/design.js +1 -1
  38. package/dist/apis/document.cjs +6 -6
  39. package/dist/apis/document.js +1 -1
  40. package/dist/apis/email-settings.cjs +6 -6
  41. package/dist/apis/email-settings.js +1 -1
  42. package/dist/apis/email-template.cjs +6 -6
  43. package/dist/apis/email-template.js +1 -1
  44. package/dist/apis/entity-mapping.cjs +6 -6
  45. package/dist/apis/entity-mapping.js +1 -1
  46. package/dist/apis/entity.cjs +6 -6
  47. package/dist/apis/entity.js +1 -1
  48. package/dist/apis/environments.cjs +6 -6
  49. package/dist/apis/environments.js +1 -1
  50. package/dist/apis/event-catalog.cjs +6 -6
  51. package/dist/apis/event-catalog.js +1 -1
  52. package/dist/apis/file.cjs +8 -8
  53. package/dist/apis/file.d.cts +2 -2
  54. package/dist/apis/file.d.ts +2 -2
  55. package/dist/apis/file.js +2 -2
  56. package/dist/apis/iban.cjs +6 -6
  57. package/dist/apis/iban.js +1 -1
  58. package/dist/apis/integration-toolkit.cjs +6 -6
  59. package/dist/apis/integration-toolkit.d.cts +2 -2
  60. package/dist/apis/integration-toolkit.d.ts +2 -2
  61. package/dist/apis/integration-toolkit.js +1 -1
  62. package/dist/apis/journey.cjs +6 -6
  63. package/dist/apis/journey.js +1 -1
  64. package/dist/apis/kanban.cjs +6 -6
  65. package/dist/apis/kanban.js +1 -1
  66. package/dist/apis/message.cjs +6 -6
  67. package/dist/apis/message.js +1 -1
  68. package/dist/apis/metering.cjs +6 -6
  69. package/dist/apis/metering.js +1 -1
  70. package/dist/apis/notes.cjs +6 -6
  71. package/dist/apis/notes.js +1 -1
  72. package/dist/apis/notification.cjs +6 -6
  73. package/dist/apis/notification.js +1 -1
  74. package/dist/apis/organization.cjs +6 -6
  75. package/dist/apis/organization.js +1 -1
  76. package/dist/apis/partner-directory.cjs +6 -6
  77. package/dist/apis/partner-directory.js +1 -1
  78. package/dist/apis/permissions.cjs +6 -6
  79. package/dist/apis/permissions.js +1 -1
  80. package/dist/apis/pricing-tier.cjs +6 -6
  81. package/dist/apis/pricing-tier.js +1 -1
  82. package/dist/apis/pricing.cjs +6 -6
  83. package/dist/apis/pricing.js +1 -1
  84. package/dist/apis/purpose.cjs +6 -6
  85. package/dist/apis/purpose.js +1 -1
  86. package/dist/apis/query.cjs +6 -6
  87. package/dist/apis/query.js +1 -1
  88. package/dist/apis/sandbox.cjs +6 -6
  89. package/dist/apis/sandbox.js +1 -1
  90. package/dist/apis/sharing.cjs +6 -6
  91. package/dist/apis/sharing.js +1 -1
  92. package/dist/apis/snapshot.cjs +6 -6
  93. package/dist/apis/snapshot.js +1 -1
  94. package/dist/apis/submission.cjs +6 -6
  95. package/dist/apis/submission.js +1 -1
  96. package/dist/apis/target.cjs +6 -6
  97. package/dist/apis/target.js +1 -1
  98. package/dist/apis/targeting.cjs +6 -6
  99. package/dist/apis/targeting.js +1 -1
  100. package/dist/apis/template-variables.cjs +6 -6
  101. package/dist/apis/template-variables.js +1 -1
  102. package/dist/apis/user.cjs +6 -6
  103. package/dist/apis/user.js +1 -1
  104. package/dist/apis/validation-rules.cjs +6 -6
  105. package/dist/apis/validation-rules.js +1 -1
  106. package/dist/apis/webhooks.cjs +6 -6
  107. package/dist/apis/webhooks.js +1 -1
  108. package/dist/apis/workflow-definition.cjs +6 -6
  109. package/dist/apis/workflow-definition.js +1 -1
  110. package/dist/apis/workflow.cjs +6 -6
  111. package/dist/apis/workflow.js +1 -1
  112. package/dist/{chunk-C37WPDHV.js → chunk-4LZNHNK7.js} +3 -3
  113. package/dist/chunk-5S2PEECD.cjs +14 -0
  114. package/dist/chunk-IBMGFLXF.js +14 -0
  115. package/dist/{chunk-OODZDECW.cjs → chunk-R6N6H5M2.cjs} +3 -3
  116. package/dist/file-M5HNKOPG.cjs +7 -0
  117. package/dist/file-ZUNCUDBY.js +7 -0
  118. package/dist/{file-runtime-ASJ6YBDM.js → file-runtime-423SISQ2.js} +1 -1
  119. package/dist/file-runtime-IHVDQNIX.cjs +5 -0
  120. package/dist/{file.d-FYKxJ29C.d.cts → file.d-CBsXF4W8.d.cts} +218 -1
  121. package/dist/{file.d-FYKxJ29C.d.ts → file.d-CBsXF4W8.d.ts} +218 -1
  122. package/dist/index.cjs +10 -10
  123. package/dist/index.d.cts +2 -2
  124. package/dist/index.d.ts +2 -2
  125. package/dist/index.js +2 -2
  126. package/dist/integration-toolkit-RIBZBI2Y.js +7 -0
  127. package/dist/integration-toolkit-RPWD4MAN.cjs +7 -0
  128. package/dist/{integration-toolkit.d-D5LjhCQB.d.cts → integration-toolkit.d-pP-3dBPT.d.cts} +50 -39
  129. package/dist/{integration-toolkit.d-D5LjhCQB.d.ts → integration-toolkit.d-pP-3dBPT.d.ts} +50 -39
  130. package/docs/file.md +122 -0
  131. package/docs/integration-toolkit.md +130 -73
  132. package/package.json +1 -1
  133. package/dist/chunk-CIPXCDZ6.js +0 -14
  134. package/dist/chunk-CO7WGRHF.cjs +0 -14
  135. package/dist/file-A6OZJKIS.cjs +0 -7
  136. package/dist/file-CRT7VUGQ.js +0 -7
  137. package/dist/file-runtime-VQIZUOUB.cjs +0 -5
  138. package/dist/integration-toolkit-OSK5M75F.js +0 -7
  139. package/dist/integration-toolkit-W5IENOJW.cjs +0 -7
package/docs/file.md CHANGED
@@ -35,6 +35,8 @@ const { data } = await fileClient.uploadFileV2(...)
35
35
  - [`createZipJob`](#createzipjob)
36
36
  - [`getZipJob`](#getzipjob)
37
37
  - [`getFileSummary`](#getfilesummary)
38
+ - [`getFileSummaryFeedback`](#getfilesummaryfeedback)
39
+ - [`putFileSummaryFeedback`](#putfilesummaryfeedback)
38
40
  - [`createFileSummaryJob`](#createfilesummaryjob)
39
41
  - [`getCurrentFileSummaryJob`](#getcurrentfilesummaryjob)
40
42
  - [`getFileSummaryJob`](#getfilesummaryjob)
@@ -77,6 +79,9 @@ const { data } = await fileClient.uploadFileV2(...)
77
79
  - [`FileSummaryJobStatus`](#filesummaryjobstatus)
78
80
  - [`FileSummaryJob`](#filesummaryjob)
79
81
  - [`FileSummary`](#filesummary)
82
+ - [`FileSummaryFeedback`](#filesummaryfeedback)
83
+ - [`FileSummaryFeedbackResponse`](#filesummaryfeedbackresponse)
84
+ - [`PutFileSummaryFeedbackRequest`](#putfilesummaryfeedbackrequest)
80
85
  - [`FileTextStatus`](#filetextstatus)
81
86
  - [`FileText`](#filetext)
82
87
  - [`FileTextReady`](#filetextready)
@@ -194,6 +199,7 @@ const { data } = await client.saveFileV2(
194
199
  short_summary_de: 'string',
195
200
  preview_summary_en: 'string',
196
201
  short_summary_en: 'string',
202
+ file_summary_execution_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
197
203
  s3ref: {}
198
204
  },
199
205
  )
@@ -225,6 +231,7 @@ const { data } = await client.saveFileV2(
225
231
  "short_summary_de": "string",
226
232
  "preview_summary_en": "string",
227
233
  "short_summary_en": "string",
234
+ "file_summary_execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
228
235
  "source_url": "https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf",
229
236
  "s3ref": {},
230
237
  "versions": [
@@ -299,6 +306,7 @@ const { data } = await client.getFile({
299
306
  "short_summary_de": "string",
300
307
  "preview_summary_en": "string",
301
308
  "short_summary_en": "string",
309
+ "file_summary_execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
302
310
  "source_url": "https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf",
303
311
  "s3ref": {},
304
312
  "versions": [
@@ -373,6 +381,7 @@ const { data } = await client.deleteFile({
373
381
  "short_summary_de": "string",
374
382
  "preview_summary_en": "string",
375
383
  "short_summary_en": "string",
384
+ "file_summary_execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
376
385
  "source_url": "https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf",
377
386
  "s3ref": {},
378
387
  "versions": [
@@ -571,6 +580,7 @@ const { data } = await client.getFileSummary({
571
580
  {
572
581
  "status": "queued",
573
582
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
583
+ "feedback_available": true,
574
584
  "preview_summary_de": "string",
575
585
  "short_summary_de": "string",
576
586
  "preview_summary_en": "string",
@@ -582,6 +592,72 @@ const { data } = await client.getFileSummary({
582
592
 
583
593
  ---
584
594
 
595
+ ### `getFileSummaryFeedback`
596
+
597
+ Get file summary feedback
598
+
599
+ `GET /v1/files/{id}/summary/feedback`
600
+
601
+ ```ts
602
+ const { data } = await client.getFileSummaryFeedback({
603
+ id: '123e4567-e89b-12d3-a456-426614174000',
604
+ })
605
+ ```
606
+
607
+ <details>
608
+ <summary>Response</summary>
609
+
610
+ ```json
611
+ {
612
+ "feedback": {
613
+ "rating": "up",
614
+ "comment": "string",
615
+ "user_id": "string",
616
+ "submitted_at": "1970-01-01T00:00:00.000Z"
617
+ }
618
+ }
619
+ ```
620
+
621
+ </details>
622
+
623
+ ---
624
+
625
+ ### `putFileSummaryFeedback`
626
+
627
+ Submit file summary feedback
628
+
629
+ `PUT /v1/files/{id}/summary/feedback`
630
+
631
+ ```ts
632
+ const { data } = await client.putFileSummaryFeedback(
633
+ {
634
+ id: '123e4567-e89b-12d3-a456-426614174000',
635
+ },
636
+ {
637
+ rating: 'up',
638
+ comment: 'string'
639
+ },
640
+ )
641
+ ```
642
+
643
+ <details>
644
+ <summary>Response</summary>
645
+
646
+ ```json
647
+ {
648
+ "feedback": {
649
+ "rating": "up",
650
+ "comment": "string",
651
+ "user_id": "string",
652
+ "submitted_at": "1970-01-01T00:00:00.000Z"
653
+ }
654
+ }
655
+ ```
656
+
657
+ </details>
658
+
659
+ ---
660
+
585
661
  ### `createFileSummaryJob`
586
662
 
587
663
  Create or return the current AI summary job for a file entity.
@@ -1123,6 +1199,7 @@ const { data } = await client.getFilesInCollection({
1123
1199
  "short_summary_de": "string",
1124
1200
  "preview_summary_en": "string",
1125
1201
  "short_summary_en": "string",
1202
+ "file_summary_execution_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
1126
1203
  "source_url": "https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf",
1127
1204
  "s3ref": {},
1128
1205
  "versions": [
@@ -1244,6 +1321,7 @@ type FileAttributes = {
1244
1321
  short_summary_de?: string
1245
1322
  preview_summary_en?: string
1246
1323
  short_summary_en?: string
1324
+ file_summary_execution_id?: string // uuid
1247
1325
  }
1248
1326
  ```
1249
1327
 
@@ -1281,6 +1359,7 @@ type FileSummaryJob = {
1281
1359
  type FileSummary = {
1282
1360
  status?: "queued" | "waiting_for_extraction" | "processing" | "completed" | "failed" | "unsupported" | "stale"
1283
1361
  job_id?: string // uuid
1362
+ feedback_available?: boolean
1284
1363
  preview_summary_de?: string
1285
1364
  short_summary_de?: string
1286
1365
  preview_summary_en?: string
@@ -1288,6 +1367,39 @@ type FileSummary = {
1288
1367
  }
1289
1368
  ```
1290
1369
 
1370
+ ### `FileSummaryFeedback`
1371
+
1372
+ ```ts
1373
+ type FileSummaryFeedback = {
1374
+ rating: "up" | "down"
1375
+ comment?: string
1376
+ user_id: string
1377
+ submitted_at: string // date-time
1378
+ }
1379
+ ```
1380
+
1381
+ ### `FileSummaryFeedbackResponse`
1382
+
1383
+ ```ts
1384
+ type FileSummaryFeedbackResponse = {
1385
+ feedback: {
1386
+ rating: "up" | "down"
1387
+ comment?: string
1388
+ user_id: string
1389
+ submitted_at: string // date-time
1390
+ }
1391
+ }
1392
+ ```
1393
+
1394
+ ### `PutFileSummaryFeedbackRequest`
1395
+
1396
+ ```ts
1397
+ type PutFileSummaryFeedbackRequest = {
1398
+ rating: "up" | "down"
1399
+ comment?: string
1400
+ }
1401
+ ```
1402
+
1291
1403
  ### `FileTextStatus`
1292
1404
 
1293
1405
  Availability of the plain-text representation for a file entity.
@@ -1379,6 +1491,7 @@ type FileEntity = {
1379
1491
  short_summary_de?: string
1380
1492
  preview_summary_en?: string
1381
1493
  short_summary_en?: string
1494
+ file_summary_execution_id?: string // uuid
1382
1495
  source_url?: string
1383
1496
  s3ref?: object
1384
1497
  versions: Array<{
@@ -1446,6 +1559,7 @@ type SaveS3FilePayload = {
1446
1559
  short_summary_de?: string
1447
1560
  preview_summary_en?: string
1448
1561
  short_summary_en?: string
1562
+ file_summary_execution_id?: string // uuid
1449
1563
  s3ref?: unknown
1450
1564
  }
1451
1565
  ```
@@ -1478,6 +1592,7 @@ type SaveFileFromSourceURLPayload = {
1478
1592
  short_summary_de?: string
1479
1593
  preview_summary_en?: string
1480
1594
  short_summary_en?: string
1595
+ file_summary_execution_id?: string // uuid
1481
1596
  source_url?: string // uri
1482
1597
  }
1483
1598
  ```
@@ -1510,6 +1625,7 @@ type SaveCustomFilePayload = {
1510
1625
  short_summary_de?: string
1511
1626
  preview_summary_en?: string
1512
1627
  short_summary_en?: string
1628
+ file_summary_execution_id?: string // uuid
1513
1629
  }
1514
1630
  ```
1515
1631
 
@@ -1541,6 +1657,7 @@ type SaveFilePayload = {
1541
1657
  short_summary_de?: string
1542
1658
  preview_summary_en?: string
1543
1659
  short_summary_en?: string
1660
+ file_summary_execution_id?: string // uuid
1544
1661
  s3ref?: unknown
1545
1662
  } | {
1546
1663
  _id?: object
@@ -1567,6 +1684,7 @@ type SaveFilePayload = {
1567
1684
  short_summary_de?: string
1568
1685
  preview_summary_en?: string
1569
1686
  short_summary_en?: string
1687
+ file_summary_execution_id?: string // uuid
1570
1688
  source_url?: string // uri
1571
1689
  } | {
1572
1690
  _id?: object
@@ -1593,6 +1711,7 @@ type SaveFilePayload = {
1593
1711
  short_summary_de?: string
1594
1712
  preview_summary_en?: string
1595
1713
  short_summary_en?: string
1714
+ file_summary_execution_id?: string // uuid
1596
1715
  }
1597
1716
  ```
1598
1717
 
@@ -1624,6 +1743,7 @@ type SaveFilePayloadV2 = {
1624
1743
  short_summary_de?: string
1625
1744
  preview_summary_en?: string
1626
1745
  short_summary_en?: string
1746
+ file_summary_execution_id?: string // uuid
1627
1747
  s3ref?: unknown
1628
1748
  } | {
1629
1749
  _id?: object
@@ -1650,6 +1770,7 @@ type SaveFilePayloadV2 = {
1650
1770
  short_summary_de?: string
1651
1771
  preview_summary_en?: string
1652
1772
  short_summary_en?: string
1773
+ file_summary_execution_id?: string // uuid
1653
1774
  source_url?: string // uri
1654
1775
  } | {
1655
1776
  _id?: object
@@ -1676,6 +1797,7 @@ type SaveFilePayloadV2 = {
1676
1797
  short_summary_de?: string
1677
1798
  preview_summary_en?: string
1678
1799
  short_summary_en?: string
1800
+ file_summary_execution_id?: string // uuid
1679
1801
  }
1680
1802
  ```
1681
1803
 
@@ -3214,7 +3214,7 @@ const { data } = await client.commitTypes(
3214
3214
 
3215
3215
  ### `createErpImport`
3216
3216
 
3217
- Register an already-uploaded file (S3 ref) as a pricing-file import job and return its id. Nothing runs yet: no use case is chosen and no validation starts here. Rank the candidates with POST /v2/erp/
3217
+ Register an already-uploaded file (S3 ref) as a pricing-file import job. Returns the job and a file preview. Nothing runs yet: no use case is chosen and no validation starts here. Optionally rank cand
3218
3218
 
3219
3219
  `POST /v2/erp/imports`
3220
3220
 
@@ -3231,6 +3231,66 @@ const { data } = await client.createErpImport(
3231
3231
  )
3232
3232
  ```
3233
3233
 
3234
+ <details>
3235
+ <summary>Response</summary>
3236
+
3237
+ ```json
3238
+ {
3239
+ "job": {
3240
+ "import_id": "string",
3241
+ "org_id": "string",
3242
+ "created_by": "string",
3243
+ "integration_id": "string",
3244
+ "use_case_slug": "string",
3245
+ "format": "csv",
3246
+ "status": "PENDING",
3247
+ "s3_input_ref": {
3248
+ "bucket": "string",
3249
+ "key": "string"
3250
+ },
3251
+ "validation": {
3252
+ "total_rows": 0,
3253
+ "blocking": 0,
3254
+ "warnings": 0,
3255
+ "entities": {},
3256
+ "issues": [
3257
+ {
3258
+ "code": "UNIQUE_ID_COLUMN_MISSING",
3259
+ "severity": "warning",
3260
+ "columns": [
3261
+ {
3262
+ "name": "string",
3263
+ "entity": "string"
3264
+ }
3265
+ ],
3266
+ "row": 0
3267
+ }
3268
+ ]
3269
+ },
3270
+ "progress": {
3271
+ "processed_rows": 0,
3272
+ "total_rows": 0
3273
+ },
3274
+ "error": {
3275
+ "code": "VALIDATION_BLOCKED",
3276
+ "message": "string"
3277
+ },
3278
+ "correlation_id": "string",
3279
+ "activity_id": "string",
3280
+ "created_at": "1970-01-01T00:00:00.000Z",
3281
+ "updated_at": "1970-01-01T00:00:00.000Z"
3282
+ },
3283
+ "preview": {
3284
+ "columns": ["string"],
3285
+ "rows": [
3286
+ ["string"]
3287
+ ]
3288
+ }
3289
+ }
3290
+ ```
3291
+
3292
+ </details>
3293
+
3234
3294
  ---
3235
3295
 
3236
3296
  ### `listErpImports`
@@ -3273,8 +3333,13 @@ const { data } = await client.listErpImports({
3273
3333
  {
3274
3334
  "code": "UNIQUE_ID_COLUMN_MISSING",
3275
3335
  "severity": "warning",
3276
- "message": "string",
3277
- "columns": ["string"]
3336
+ "columns": [
3337
+ {
3338
+ "name": "string",
3339
+ "entity": "string"
3340
+ }
3341
+ ],
3342
+ "row": 0
3278
3343
  }
3279
3344
  ]
3280
3345
  },
@@ -3337,8 +3402,13 @@ const { data } = await client.getErpImport({
3337
3402
  {
3338
3403
  "code": "UNIQUE_ID_COLUMN_MISSING",
3339
3404
  "severity": "warning",
3340
- "message": "string",
3341
- "columns": ["string"]
3405
+ "columns": [
3406
+ {
3407
+ "name": "string",
3408
+ "entity": "string"
3409
+ }
3410
+ ],
3411
+ "row": 0
3342
3412
  }
3343
3413
  ]
3344
3414
  },
@@ -3384,8 +3454,7 @@ const { data } = await client.validateErpImport(
3384
3454
 
3385
3455
  ### `suggestErpImportUseCases`
3386
3456
 
3387
- Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Reads only the file's first row, not its data.
3388
- Every eligible use case is
3457
+ Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Optional: skip this and call `:validate` directly when the use case is al
3389
3458
 
3390
3459
  `POST /v2/erp/imports/{importId}:suggest-use-cases`
3391
3460
 
@@ -3400,6 +3469,7 @@ const { data } = await client.suggestErpImportUseCases({
3400
3469
 
3401
3470
  ```json
3402
3471
  {
3472
+ "file_columns": 0,
3403
3473
  "suggestions": [
3404
3474
  {
3405
3475
  "integration_id": "string",
@@ -3407,8 +3477,7 @@ const { data } = await client.suggestErpImportUseCases({
3407
3477
  "use_case_slug": "string",
3408
3478
  "use_case_name": "string",
3409
3479
  "entity_types": 0,
3410
- "matched_columns": 0,
3411
- "file_columns": 0
3480
+ "matched_columns": 0
3412
3481
  }
3413
3482
  ]
3414
3483
  }
@@ -3435,53 +3504,6 @@ const { data } = await client.executeErpImport(
3435
3504
  )
3436
3505
  ```
3437
3506
 
3438
- <details>
3439
- <summary>Response</summary>
3440
-
3441
- ```json
3442
- {
3443
- "import_id": "string",
3444
- "org_id": "string",
3445
- "created_by": "string",
3446
- "integration_id": "string",
3447
- "use_case_slug": "string",
3448
- "format": "csv",
3449
- "status": "PENDING",
3450
- "s3_input_ref": {
3451
- "bucket": "string",
3452
- "key": "string"
3453
- },
3454
- "validation": {
3455
- "total_rows": 0,
3456
- "blocking": 0,
3457
- "warnings": 0,
3458
- "entities": {},
3459
- "issues": [
3460
- {
3461
- "code": "UNIQUE_ID_COLUMN_MISSING",
3462
- "severity": "warning",
3463
- "message": "string",
3464
- "columns": ["string"]
3465
- }
3466
- ]
3467
- },
3468
- "progress": {
3469
- "processed_rows": 0,
3470
- "total_rows": 0
3471
- },
3472
- "error": {
3473
- "code": "VALIDATION_BLOCKED",
3474
- "message": "string"
3475
- },
3476
- "correlation_id": "string",
3477
- "activity_id": "string",
3478
- "created_at": "1970-01-01T00:00:00.000Z",
3479
- "updated_at": "1970-01-01T00:00:00.000Z"
3480
- }
3481
- ```
3482
-
3483
- </details>
3484
-
3485
3507
  ---
3486
3508
 
3487
3509
  ### `abortErpImport`
@@ -3543,7 +3565,6 @@ type ErpImportUseCaseSuggestion = {
3543
3565
  use_case_name: string
3544
3566
  entity_types: number
3545
3567
  matched_columns: number
3546
- file_columns: number
3547
3568
  }
3548
3569
  ```
3549
3570
 
@@ -3551,6 +3572,7 @@ type ErpImportUseCaseSuggestion = {
3551
3572
 
3552
3573
  ```ts
3553
3574
  type SuggestErpImportUseCasesResponse = {
3575
+ file_columns: number
3554
3576
  suggestions: Array<{
3555
3577
  integration_id: string
3556
3578
  integration_name: string
@@ -3558,7 +3580,6 @@ type SuggestErpImportUseCasesResponse = {
3558
3580
  use_case_name: string
3559
3581
  entity_types: number
3560
3582
  matched_columns: number
3561
- file_columns: number
3562
3583
  }>
3563
3584
  }
3564
3585
  ```
@@ -3575,14 +3596,18 @@ type ExecuteErpImportRequest = {
3575
3596
 
3576
3597
  ### `ErpImportIssue`
3577
3598
 
3578
- A problem found during validation, scoped to the file as a whole rather than to individual rows. See `code` for the kinds reported.
3599
+ A problem found during validation, scoped to the file as a whole rather than to individual rows.
3600
+ `code` is the translation key and the other fields are its parameters — there is deliberately no message to display. Each code appears at most once, with everything it has to say aggregated into that one
3579
3601
 
3580
3602
  ```ts
3581
3603
  type ErpImportIssue = {
3582
3604
  code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS"
3583
3605
  severity: "warning" | "blocking"
3584
- message: string
3585
- columns?: string[]
3606
+ columns?: Array<{
3607
+ name: string
3608
+ entity?: string
3609
+ }>
3610
+ row?: number
3586
3611
  }
3587
3612
  ```
3588
3613
 
@@ -3599,8 +3624,11 @@ type ErpImportValidation = {
3599
3624
  issues?: Array<{
3600
3625
  code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS"
3601
3626
  severity: "warning" | "blocking"
3602
- message: string
3603
- columns?: string[]
3627
+ columns?: Array<{
3628
+ name: { ... }
3629
+ entity?: { ... }
3630
+ }>
3631
+ row?: number
3604
3632
  }>
3605
3633
  }
3606
3634
  ```
@@ -3619,7 +3647,7 @@ type ErpImportProgress = {
3619
3647
 
3620
3648
  ### `ErpImportError`
3621
3649
 
3622
- Why the import failed — present if and only if status = FAILED.
3650
+ Why the import failed — present if and only if status = FAILED. `code` is the translation key; for VALIDATION_BLOCKED the specifics are in `validation`.
3623
3651
 
3624
3652
  ```ts
3625
3653
  type ErpImportError = {
@@ -3630,13 +3658,12 @@ type ErpImportError = {
3630
3658
 
3631
3659
  ### `ErpImportFilePreview`
3632
3660
 
3633
- Sample of the file's first rows, using the same parser as `:validate`. `status` is the outcome of this read, not a verdict on the file.
3661
+ Sample of the file's first rows, using the same parser as `:validate`. Registration refuses a file it cannot read, so a created job always includes this.
3634
3662
 
3635
3663
  ```ts
3636
3664
  type ErpImportFilePreview = {
3637
- status: "AVAILABLE" | "FORMAT_UNSUPPORTED" | "UNREADABLE"
3638
- columns?: string[]
3639
- rows?: string[][]
3665
+ columns: string[]
3666
+ rows: string[][]
3640
3667
  }
3641
3668
  ```
3642
3669
 
@@ -3644,11 +3671,41 @@ type ErpImportFilePreview = {
3644
3671
 
3645
3672
  ```ts
3646
3673
  type CreateErpImportResponse = {
3647
- import_id: string
3674
+ job: {
3675
+ import_id: string
3676
+ org_id: string
3677
+ created_by?: string
3678
+ integration_id?: string
3679
+ use_case_slug?: string
3680
+ format: "csv" | "xlsx"
3681
+ status: "PENDING" | "VALIDATING" | "READY" | "PROCESSING" | "IMPORTED" | "FAILED" | "CANCELLING" | "CANCELLED"
3682
+ s3_input_ref: {
3683
+ bucket: { ... }
3684
+ key: { ... }
3685
+ }
3686
+ validation?: {
3687
+ total_rows: { ... }
3688
+ blocking: { ... }
3689
+ warnings: { ... }
3690
+ entities: { ... }
3691
+ issues?: { ... }
3692
+ }
3693
+ progress?: {
3694
+ processed_rows: { ... }
3695
+ total_rows?: { ... }
3696
+ }
3697
+ error?: {
3698
+ code: { ... }
3699
+ message: { ... }
3700
+ }
3701
+ correlation_id?: string
3702
+ activity_id?: string
3703
+ created_at: string // date-time
3704
+ updated_at: string // date-time
3705
+ }
3648
3706
  preview?: {
3649
- status: "AVAILABLE" | "FORMAT_UNSUPPORTED" | "UNREADABLE"
3650
- columns?: string[]
3651
- rows?: string[][]
3707
+ columns: string[]
3708
+ rows: string[][]
3652
3709
  }
3653
3710
  }
3654
3711
  ```
@@ -3676,8 +3733,8 @@ type ErpImportJob = {
3676
3733
  issues?: Array<{
3677
3734
  code: { ... }
3678
3735
  severity: { ... }
3679
- message: { ... }
3680
3736
  columns?: { ... }
3737
+ row?: { ... }
3681
3738
  }>
3682
3739
  }
3683
3740
  progress?: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@epilot/sdk",
3
- "version": "2.18.10",
3
+ "version": "2.18.12",
4
4
  "description": "JavaScript/TypeScript SDK for epilot APIs",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -1,14 +0,0 @@
1
- import {
2
- __commonJS
3
- } from "./chunk-YPSWSI3M.js";
4
-
5
- // src/definitions/file-runtime.json
6
- var require_file_runtime = __commonJS({
7
- "src/definitions/file-runtime.json"(exports, module) {
8
- module.exports = { s: "https://file.sls.epilot.io", o: [["uploadFileV2", "post", "/v2/files/upload", [["file_entity_id", "q"]], 1], ["saveFileV2", "post", "/v2/files", [["ActivityIdQueryParam"], ["FillActivityQueryParam"], ["StrictQueryParam"], ["AsyncOperationQueryParam"], ["DeleteTempFileQueryParam"], ["VersionOnlyQueryParam"]], 1], ["uploadFile", "post", "/v1/files/upload", [["file_entity_id", "q"]], 1], ["saveFile", "post", "/v1/files", [["ActivityIdQueryParam"], ["AsyncOperationQueryParam"], ["VersionOnlyQueryParam"]], 1], ["getFile", "get", "/v2/files/{id}", [["id", "p", true], ["source_url", "q"], ["StrictQueryParam"], ["AsyncOperationQueryParam"]]], ["deleteFile", "delete", "/v2/files/{id}", [["id", "p", true], ["purge", "q"], ["ActivityIdQueryParam"], ["StrictQueryParam"]]], ["downloadFile", "get", "/v1/files/{id}/download", [["id", "p", true], ["version", "q"], ["attachment", "q"], ["x-track", "q", false, "form", true]]], ["downloadS3File", "post", "/v1/files:downloadS3", [["s3_key", "q", true], ["s3_bucket", "q", true], ["attachment", "q"]]], ["downloadFiles", "post", "/v1/files:downloadFiles", null, 1], ["createZipJob", "post", "/v1/files:zipJob", null, 1], ["getZipJob", "get", "/v1/files:zipJob/{job_id}", [["job_id", "p", true]]], ["getFileSummary", "get", "/v1/files/{id}/summary", [["id", "p", true]]], ["createFileSummaryJob", "post", "/v1/files/{id}/summary-jobs", [["id", "p", true]]], ["getCurrentFileSummaryJob", "get", "/v1/files/{id}/summary-jobs/current", [["id", "p", true]]], ["getFileSummaryJob", "get", "/v1/files/{id}/summary-jobs/{job_id}", [["id", "p", true], ["job_id", "p", true]]], ["generateFileSummary", "post", "/v1/files/{id}/summary:generate", [["id", "p", true]]], ["getFileText", "get", "/v1/files/{id}/text", [["id", "p", true]]], ["previewFile", "get", "/v1/files/{id}/preview", [["id", "p", true], ["version", "q"], ["w", "q"], ["h", "q"]]], ["previewS3File", "post", "/v1/files:previewS3", [["w", "q"], ["h", "q"]], 1], ["previewS3FileGet", "get", "/v1/files:previewS3", [["key", "q", true], ["bucket", "q", true], ["w", "q"], ["h", "q"]]], ["previewPublicFile", "get", "/v1/files/public/{id}/preview", [["id", "p", true], ["version", "q"], ["w", "q"], ["h", "q"], ["org_id", "q"]]], ["getSession", "get", "/v1/files/session"], ["deleteSession", "delete", "/v1/files/session"], ["generatePublicLink", "post", "/v1/files/{id}/public/links", [["id", "p", true]]], ["listPublicLinksForFile", "get", "/v1/files/{id}/public/links", [["id", "p", true]]], ["accessPublicLink", "get", "/v1/files/public/links/{id}/{filename}", [["id", "p", true], ["filename", "p", true], ["hash", "q"]]], ["revokePublicLink", "delete", "/v1/files/public/links/{id}", [["id", "p", true]]], ["verifyCustomDownloadUrl", "post", "/v1/files/download:verify", null, 1], ["uploadFilePublic", "post", "/v1/files/public/upload", null, 1], ["getUserSchemaFileCollections", "get", "/v1/{slug}/collections", [["slug", "p", true]]], ["createUserSchemaFileCollection", "post", "/v1/{slug}/collections", [["slug", "p", true]], 1], ["updateUserSchemaFileCollection", "put", "/v1/{slug}/collections/{collectionSlug}", [["slug", "p", true], ["collectionSlug", "p", true]], 1], ["deleteUserSchemaFileCollection", "delete", "/v1/{slug}/collections/{collectionSlug}", [["slug", "p", true], ["collectionSlug", "p", true]]], ["getFilesInCollection", "get", "/v1/entity/{id}/collections/{collectionSlug}/files", [["EntityIdPathParam"], ["collectionSlug", "p", true]]], ["getGlobalFileCollections", "get", "/v1/collections/{schemaSlug}", [["schemaSlug", "p", true]]]], v: "3.0.3", cp: { EntityIdPathParam: ["id", "p", true], StrictQueryParam: ["strict", "q"], ActivityIdQueryParam: ["activity_id", "q"], FillActivityQueryParam: ["fill_activity", "q"], AsyncOperationQueryParam: ["async", "q"], DeleteTempFileQueryParam: ["delete_temp_file", "q"], VersionOnlyQueryParam: ["version_only", "q"] } };
9
- }
10
- });
11
-
12
- export {
13
- require_file_runtime
14
- };
@@ -1,14 +0,0 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true});
2
-
3
- var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
4
-
5
- // src/definitions/file-runtime.json
6
- var require_file_runtime = _chunkNJK5F5TFcjs.__commonJS.call(void 0, {
7
- "src/definitions/file-runtime.json"(exports, module) {
8
- module.exports = { s: "https://file.sls.epilot.io", o: [["uploadFileV2", "post", "/v2/files/upload", [["file_entity_id", "q"]], 1], ["saveFileV2", "post", "/v2/files", [["ActivityIdQueryParam"], ["FillActivityQueryParam"], ["StrictQueryParam"], ["AsyncOperationQueryParam"], ["DeleteTempFileQueryParam"], ["VersionOnlyQueryParam"]], 1], ["uploadFile", "post", "/v1/files/upload", [["file_entity_id", "q"]], 1], ["saveFile", "post", "/v1/files", [["ActivityIdQueryParam"], ["AsyncOperationQueryParam"], ["VersionOnlyQueryParam"]], 1], ["getFile", "get", "/v2/files/{id}", [["id", "p", true], ["source_url", "q"], ["StrictQueryParam"], ["AsyncOperationQueryParam"]]], ["deleteFile", "delete", "/v2/files/{id}", [["id", "p", true], ["purge", "q"], ["ActivityIdQueryParam"], ["StrictQueryParam"]]], ["downloadFile", "get", "/v1/files/{id}/download", [["id", "p", true], ["version", "q"], ["attachment", "q"], ["x-track", "q", false, "form", true]]], ["downloadS3File", "post", "/v1/files:downloadS3", [["s3_key", "q", true], ["s3_bucket", "q", true], ["attachment", "q"]]], ["downloadFiles", "post", "/v1/files:downloadFiles", null, 1], ["createZipJob", "post", "/v1/files:zipJob", null, 1], ["getZipJob", "get", "/v1/files:zipJob/{job_id}", [["job_id", "p", true]]], ["getFileSummary", "get", "/v1/files/{id}/summary", [["id", "p", true]]], ["createFileSummaryJob", "post", "/v1/files/{id}/summary-jobs", [["id", "p", true]]], ["getCurrentFileSummaryJob", "get", "/v1/files/{id}/summary-jobs/current", [["id", "p", true]]], ["getFileSummaryJob", "get", "/v1/files/{id}/summary-jobs/{job_id}", [["id", "p", true], ["job_id", "p", true]]], ["generateFileSummary", "post", "/v1/files/{id}/summary:generate", [["id", "p", true]]], ["getFileText", "get", "/v1/files/{id}/text", [["id", "p", true]]], ["previewFile", "get", "/v1/files/{id}/preview", [["id", "p", true], ["version", "q"], ["w", "q"], ["h", "q"]]], ["previewS3File", "post", "/v1/files:previewS3", [["w", "q"], ["h", "q"]], 1], ["previewS3FileGet", "get", "/v1/files:previewS3", [["key", "q", true], ["bucket", "q", true], ["w", "q"], ["h", "q"]]], ["previewPublicFile", "get", "/v1/files/public/{id}/preview", [["id", "p", true], ["version", "q"], ["w", "q"], ["h", "q"], ["org_id", "q"]]], ["getSession", "get", "/v1/files/session"], ["deleteSession", "delete", "/v1/files/session"], ["generatePublicLink", "post", "/v1/files/{id}/public/links", [["id", "p", true]]], ["listPublicLinksForFile", "get", "/v1/files/{id}/public/links", [["id", "p", true]]], ["accessPublicLink", "get", "/v1/files/public/links/{id}/{filename}", [["id", "p", true], ["filename", "p", true], ["hash", "q"]]], ["revokePublicLink", "delete", "/v1/files/public/links/{id}", [["id", "p", true]]], ["verifyCustomDownloadUrl", "post", "/v1/files/download:verify", null, 1], ["uploadFilePublic", "post", "/v1/files/public/upload", null, 1], ["getUserSchemaFileCollections", "get", "/v1/{slug}/collections", [["slug", "p", true]]], ["createUserSchemaFileCollection", "post", "/v1/{slug}/collections", [["slug", "p", true]], 1], ["updateUserSchemaFileCollection", "put", "/v1/{slug}/collections/{collectionSlug}", [["slug", "p", true], ["collectionSlug", "p", true]], 1], ["deleteUserSchemaFileCollection", "delete", "/v1/{slug}/collections/{collectionSlug}", [["slug", "p", true], ["collectionSlug", "p", true]]], ["getFilesInCollection", "get", "/v1/entity/{id}/collections/{collectionSlug}/files", [["EntityIdPathParam"], ["collectionSlug", "p", true]]], ["getGlobalFileCollections", "get", "/v1/collections/{schemaSlug}", [["schemaSlug", "p", true]]]], v: "3.0.3", cp: { EntityIdPathParam: ["id", "p", true], StrictQueryParam: ["strict", "q"], ActivityIdQueryParam: ["activity_id", "q"], FillActivityQueryParam: ["fill_activity", "q"], AsyncOperationQueryParam: ["async", "q"], DeleteTempFileQueryParam: ["delete_temp_file", "q"], VersionOnlyQueryParam: ["version_only", "q"] } };
9
- }
10
- });
11
-
12
-
13
-
14
- exports.require_file_runtime = require_file_runtime;