@algolia/ingestion 1.2.5 → 1.3.0

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.
@@ -11,7 +11,7 @@ import { createXhrRequester } from "@algolia/requester-browser-xhr";
11
11
 
12
12
  // src/ingestionClient.ts
13
13
  import { createAuth, createTransporter, getAlgoliaAgent } from "@algolia/client-common";
14
- var apiClientVersion = "1.2.5";
14
+ var apiClientVersion = "1.3.0";
15
15
  var REGIONS = ["eu", "us"];
16
16
  function getDefaultHosts(region) {
17
17
  const url = "data.{region}.algolia.com".replace("{region}", region);
@@ -35,26 +35,25 @@ function createIngestionClient({
35
35
  ...options
36
36
  }) {
37
37
  const auth = createAuth(appIdOption, apiKeyOption, authMode);
38
- const transporter = createTransporter({
39
- hosts: getDefaultHosts(regionOption),
40
- ...options,
41
- algoliaAgent: getAlgoliaAgent({
42
- algoliaAgents,
43
- client: "Ingestion",
44
- version: apiClientVersion
45
- }),
46
- baseHeaders: {
47
- "content-type": "text/plain",
48
- ...auth.headers(),
49
- ...options.baseHeaders
50
- },
51
- baseQueryParameters: {
52
- ...auth.queryParameters(),
53
- ...options.baseQueryParameters
54
- }
55
- });
56
38
  return {
57
- transporter,
39
+ transporter: createTransporter({
40
+ hosts: getDefaultHosts(regionOption),
41
+ ...options,
42
+ algoliaAgent: getAlgoliaAgent({
43
+ algoliaAgents,
44
+ client: "Ingestion",
45
+ version: apiClientVersion
46
+ }),
47
+ baseHeaders: {
48
+ "content-type": "text/plain",
49
+ ...auth.headers(),
50
+ ...options.baseHeaders
51
+ },
52
+ baseQueryParameters: {
53
+ ...auth.queryParameters(),
54
+ ...options.baseQueryParameters
55
+ }
56
+ }),
58
57
  /**
59
58
  * The `appId` currently in use.
60
59
  */
@@ -63,13 +62,15 @@ function createIngestionClient({
63
62
  * Clears the cache of the transporter for the `requestsCache` and `responsesCache` properties.
64
63
  */
65
64
  clearCache() {
66
- return Promise.all([transporter.requestsCache.clear(), transporter.responsesCache.clear()]).then(() => void 0);
65
+ return Promise.all([this.transporter.requestsCache.clear(), this.transporter.responsesCache.clear()]).then(
66
+ () => void 0
67
+ );
67
68
  },
68
69
  /**
69
70
  * Get the value of the `algoliaAgent`, used by our libraries internally and telemetry system.
70
71
  */
71
72
  get _ua() {
72
- return transporter.algoliaAgent.value;
73
+ return this.transporter.algoliaAgent.value;
73
74
  },
74
75
  /**
75
76
  * Adds a `segment` to the `x-algolia-agent` sent with every requests.
@@ -78,7 +79,16 @@ function createIngestionClient({
78
79
  * @param version - The version of the agent.
79
80
  */
80
81
  addAlgoliaAgent(segment, version) {
81
- transporter.algoliaAgent.add({ segment, version });
82
+ this.transporter.algoliaAgent.add({ segment, version });
83
+ },
84
+ /**
85
+ * Helper method to switch the API key used to authenticate the requests.
86
+ *
87
+ * @param params - Method params.
88
+ * @param params.apiKey - The new API Key to use.
89
+ */
90
+ setClientApiKey({ apiKey }) {
91
+ this.transporter.baseHeaders["x-algolia-api-key"] = apiKey;
82
92
  },
83
93
  /**
84
94
  * Creates a new authentication resource.
@@ -114,7 +124,7 @@ function createIngestionClient({
114
124
  headers,
115
125
  data: authenticationCreate
116
126
  };
117
- return transporter.request(request, requestOptions);
127
+ return this.transporter.request(request, requestOptions);
118
128
  },
119
129
  /**
120
130
  * Creates a new destination.
@@ -150,7 +160,7 @@ function createIngestionClient({
150
160
  headers,
151
161
  data: destinationCreate
152
162
  };
153
- return transporter.request(request, requestOptions);
163
+ return this.transporter.request(request, requestOptions);
154
164
  },
155
165
  /**
156
166
  * Creates a new source.
@@ -183,7 +193,7 @@ function createIngestionClient({
183
193
  headers,
184
194
  data: sourceCreate
185
195
  };
186
- return transporter.request(request, requestOptions);
196
+ return this.transporter.request(request, requestOptions);
187
197
  },
188
198
  /**
189
199
  * Creates a new task.
@@ -214,7 +224,7 @@ function createIngestionClient({
214
224
  headers,
215
225
  data: taskCreate
216
226
  };
217
- return transporter.request(request, requestOptions);
227
+ return this.transporter.request(request, requestOptions);
218
228
  },
219
229
  /**
220
230
  * Creates a new task using the v1 endpoint, please use `createTask` instead.
@@ -248,7 +258,7 @@ function createIngestionClient({
248
258
  headers,
249
259
  data: taskCreate
250
260
  };
251
- return transporter.request(request, requestOptions);
261
+ return this.transporter.request(request, requestOptions);
252
262
  },
253
263
  /**
254
264
  * Creates a new transformation.
@@ -276,7 +286,7 @@ function createIngestionClient({
276
286
  headers,
277
287
  data: transformationCreate
278
288
  };
279
- return transporter.request(request, requestOptions);
289
+ return this.transporter.request(request, requestOptions);
280
290
  },
281
291
  /**
282
292
  * This method allow you to send requests to the Algolia REST API.
@@ -299,7 +309,7 @@ function createIngestionClient({
299
309
  queryParameters,
300
310
  headers
301
311
  };
302
- return transporter.request(request, requestOptions);
312
+ return this.transporter.request(request, requestOptions);
303
313
  },
304
314
  /**
305
315
  * This method allow you to send requests to the Algolia REST API.
@@ -322,7 +332,7 @@ function createIngestionClient({
322
332
  queryParameters,
323
333
  headers
324
334
  };
325
- return transporter.request(request, requestOptions);
335
+ return this.transporter.request(request, requestOptions);
326
336
  },
327
337
  /**
328
338
  * This method allow you to send requests to the Algolia REST API.
@@ -347,7 +357,7 @@ function createIngestionClient({
347
357
  headers,
348
358
  data: body ? body : {}
349
359
  };
350
- return transporter.request(request, requestOptions);
360
+ return this.transporter.request(request, requestOptions);
351
361
  },
352
362
  /**
353
363
  * This method allow you to send requests to the Algolia REST API.
@@ -372,7 +382,7 @@ function createIngestionClient({
372
382
  headers,
373
383
  data: body ? body : {}
374
384
  };
375
- return transporter.request(request, requestOptions);
385
+ return this.transporter.request(request, requestOptions);
376
386
  },
377
387
  /**
378
388
  * Deletes an authentication resource. You can\'t delete authentication resources that are used by a source or a destination.
@@ -402,7 +412,7 @@ function createIngestionClient({
402
412
  queryParameters,
403
413
  headers
404
414
  };
405
- return transporter.request(request, requestOptions);
415
+ return this.transporter.request(request, requestOptions);
406
416
  },
407
417
  /**
408
418
  * Deletes a destination by its ID. You can\'t delete destinations that are referenced in tasks.
@@ -432,7 +442,7 @@ function createIngestionClient({
432
442
  queryParameters,
433
443
  headers
434
444
  };
435
- return transporter.request(request, requestOptions);
445
+ return this.transporter.request(request, requestOptions);
436
446
  },
437
447
  /**
438
448
  * Deletes a source by its ID. You can\'t delete sources that are referenced in tasks.
@@ -459,7 +469,7 @@ function createIngestionClient({
459
469
  queryParameters,
460
470
  headers
461
471
  };
462
- return transporter.request(request, requestOptions);
472
+ return this.transporter.request(request, requestOptions);
463
473
  },
464
474
  /**
465
475
  * Deletes a task by its ID.
@@ -481,7 +491,7 @@ function createIngestionClient({
481
491
  queryParameters,
482
492
  headers
483
493
  };
484
- return transporter.request(request, requestOptions);
494
+ return this.transporter.request(request, requestOptions);
485
495
  },
486
496
  /**
487
497
  * Deletes a task by its ID using the v1 endpoint, please use `deleteTask` instead.
@@ -503,7 +513,7 @@ function createIngestionClient({
503
513
  queryParameters,
504
514
  headers
505
515
  };
506
- return transporter.request(request, requestOptions);
516
+ return this.transporter.request(request, requestOptions);
507
517
  },
508
518
  /**
509
519
  * Deletes a transformation by its ID.
@@ -528,7 +538,7 @@ function createIngestionClient({
528
538
  queryParameters,
529
539
  headers
530
540
  };
531
- return transporter.request(request, requestOptions);
541
+ return this.transporter.request(request, requestOptions);
532
542
  },
533
543
  /**
534
544
  * Disables a task.
@@ -555,7 +565,7 @@ function createIngestionClient({
555
565
  queryParameters,
556
566
  headers
557
567
  };
558
- return transporter.request(request, requestOptions);
568
+ return this.transporter.request(request, requestOptions);
559
569
  },
560
570
  /**
561
571
  * Disables a task using the v1 endpoint, please use `disableTask` instead.
@@ -582,7 +592,7 @@ function createIngestionClient({
582
592
  queryParameters,
583
593
  headers
584
594
  };
585
- return transporter.request(request, requestOptions);
595
+ return this.transporter.request(request, requestOptions);
586
596
  },
587
597
  /**
588
598
  * Enables a task.
@@ -609,7 +619,7 @@ function createIngestionClient({
609
619
  queryParameters,
610
620
  headers
611
621
  };
612
- return transporter.request(request, requestOptions);
622
+ return this.transporter.request(request, requestOptions);
613
623
  },
614
624
  /**
615
625
  * Enables a task using the v1 endpoint, please use `enableTask` instead.
@@ -636,7 +646,7 @@ function createIngestionClient({
636
646
  queryParameters,
637
647
  headers
638
648
  };
639
- return transporter.request(request, requestOptions);
649
+ return this.transporter.request(request, requestOptions);
640
650
  },
641
651
  /**
642
652
  * Generates code for the selected model based on the given prompt.
@@ -675,7 +685,7 @@ function createIngestionClient({
675
685
  headers,
676
686
  data: generateTransformationCodePayload
677
687
  };
678
- return transporter.request(request, requestOptions);
688
+ return this.transporter.request(request, requestOptions);
679
689
  },
680
690
  /**
681
691
  * Retrieves an authentication resource by its ID.
@@ -705,7 +715,7 @@ function createIngestionClient({
705
715
  queryParameters,
706
716
  headers
707
717
  };
708
- return transporter.request(request, requestOptions);
718
+ return this.transporter.request(request, requestOptions);
709
719
  },
710
720
  /**
711
721
  * Retrieves a destination by its ID.
@@ -735,7 +745,7 @@ function createIngestionClient({
735
745
  queryParameters,
736
746
  headers
737
747
  };
738
- return transporter.request(request, requestOptions);
748
+ return this.transporter.request(request, requestOptions);
739
749
  },
740
750
  /**
741
751
  * Retrieves a single task run event by its ID.
@@ -766,7 +776,7 @@ function createIngestionClient({
766
776
  queryParameters,
767
777
  headers
768
778
  };
769
- return transporter.request(request, requestOptions);
779
+ return this.transporter.request(request, requestOptions);
770
780
  },
771
781
  /**
772
782
  * Retrieve a single task run by its ID.
@@ -793,7 +803,7 @@ function createIngestionClient({
793
803
  queryParameters,
794
804
  headers
795
805
  };
796
- return transporter.request(request, requestOptions);
806
+ return this.transporter.request(request, requestOptions);
797
807
  },
798
808
  /**
799
809
  * Retrieve a source by its ID.
@@ -820,7 +830,7 @@ function createIngestionClient({
820
830
  queryParameters,
821
831
  headers
822
832
  };
823
- return transporter.request(request, requestOptions);
833
+ return this.transporter.request(request, requestOptions);
824
834
  },
825
835
  /**
826
836
  * Retrieves a task by its ID.
@@ -847,7 +857,7 @@ function createIngestionClient({
847
857
  queryParameters,
848
858
  headers
849
859
  };
850
- return transporter.request(request, requestOptions);
860
+ return this.transporter.request(request, requestOptions);
851
861
  },
852
862
  /**
853
863
  * Retrieves a task by its ID using the v1 endpoint, please use `getTask` instead.
@@ -874,7 +884,7 @@ function createIngestionClient({
874
884
  queryParameters,
875
885
  headers
876
886
  };
877
- return transporter.request(request, requestOptions);
887
+ return this.transporter.request(request, requestOptions);
878
888
  },
879
889
  /**
880
890
  * Retrieves a transformation by its ID.
@@ -904,7 +914,7 @@ function createIngestionClient({
904
914
  queryParameters,
905
915
  headers
906
916
  };
907
- return transporter.request(request, requestOptions);
917
+ return this.transporter.request(request, requestOptions);
908
918
  },
909
919
  /**
910
920
  * Retrieves a list of all authentication resources.
@@ -951,7 +961,7 @@ function createIngestionClient({
951
961
  queryParameters,
952
962
  headers
953
963
  };
954
- return transporter.request(request, requestOptions);
964
+ return this.transporter.request(request, requestOptions);
955
965
  },
956
966
  /**
957
967
  * Retrieves a list of destinations.
@@ -998,7 +1008,7 @@ function createIngestionClient({
998
1008
  queryParameters,
999
1009
  headers
1000
1010
  };
1001
- return transporter.request(request, requestOptions);
1011
+ return this.transporter.request(request, requestOptions);
1002
1012
  },
1003
1013
  /**
1004
1014
  * Retrieves a list of events for a task run, identified by it\'s ID.
@@ -1057,7 +1067,7 @@ function createIngestionClient({
1057
1067
  queryParameters,
1058
1068
  headers
1059
1069
  };
1060
- return transporter.request(request, requestOptions);
1070
+ return this.transporter.request(request, requestOptions);
1061
1071
  },
1062
1072
  /**
1063
1073
  * Retrieve a list of task runs.
@@ -1116,7 +1126,7 @@ function createIngestionClient({
1116
1126
  queryParameters,
1117
1127
  headers
1118
1128
  };
1119
- return transporter.request(request, requestOptions);
1129
+ return this.transporter.request(request, requestOptions);
1120
1130
  },
1121
1131
  /**
1122
1132
  * Retrieves a list of sources.
@@ -1163,7 +1173,7 @@ function createIngestionClient({
1163
1173
  queryParameters,
1164
1174
  headers
1165
1175
  };
1166
- return transporter.request(request, requestOptions);
1176
+ return this.transporter.request(request, requestOptions);
1167
1177
  },
1168
1178
  /**
1169
1179
  * Retrieves a list of tasks.
@@ -1222,7 +1232,7 @@ function createIngestionClient({
1222
1232
  queryParameters,
1223
1233
  headers
1224
1234
  };
1225
- return transporter.request(request, requestOptions);
1235
+ return this.transporter.request(request, requestOptions);
1226
1236
  },
1227
1237
  /**
1228
1238
  * Retrieves a list of tasks using the v1 endpoint, please use `getTasks` instead.
@@ -1281,7 +1291,7 @@ function createIngestionClient({
1281
1291
  queryParameters,
1282
1292
  headers
1283
1293
  };
1284
- return transporter.request(request, requestOptions);
1294
+ return this.transporter.request(request, requestOptions);
1285
1295
  },
1286
1296
  /**
1287
1297
  * Retrieves a list of existing LLM transformation helpers.
@@ -1303,7 +1313,7 @@ function createIngestionClient({
1303
1313
  queryParameters,
1304
1314
  headers
1305
1315
  };
1306
- return transporter.request(request, requestOptions);
1316
+ return this.transporter.request(request, requestOptions);
1307
1317
  },
1308
1318
  /**
1309
1319
  * Retrieves a list of transformations.
@@ -1342,7 +1352,7 @@ function createIngestionClient({
1342
1352
  queryParameters,
1343
1353
  headers
1344
1354
  };
1345
- return transporter.request(request, requestOptions);
1355
+ return this.transporter.request(request, requestOptions);
1346
1356
  },
1347
1357
  /**
1348
1358
  * Push a `batch` request payload through the Pipeline. You can check the status of task pushes with the observability endpoints.
@@ -1380,7 +1390,7 @@ function createIngestionClient({
1380
1390
  headers,
1381
1391
  data: pushTaskPayload
1382
1392
  };
1383
- return transporter.request(request, requestOptions);
1393
+ return this.transporter.request(request, requestOptions);
1384
1394
  },
1385
1395
  /**
1386
1396
  * Runs all tasks linked to a source, only available for Shopify sources. It will create 1 run per task.
@@ -1409,7 +1419,7 @@ function createIngestionClient({
1409
1419
  headers,
1410
1420
  data: runSourcePayload ? runSourcePayload : {}
1411
1421
  };
1412
- return transporter.request(request, requestOptions);
1422
+ return this.transporter.request(request, requestOptions);
1413
1423
  },
1414
1424
  /**
1415
1425
  * Runs a task. You can check the status of task runs with the observability endpoints.
@@ -1436,7 +1446,7 @@ function createIngestionClient({
1436
1446
  queryParameters,
1437
1447
  headers
1438
1448
  };
1439
- return transporter.request(request, requestOptions);
1449
+ return this.transporter.request(request, requestOptions);
1440
1450
  },
1441
1451
  /**
1442
1452
  * Runs a task using the v1 endpoint, please use `runTask` instead. You can check the status of task runs with the observability endpoints.
@@ -1463,7 +1473,7 @@ function createIngestionClient({
1463
1473
  queryParameters,
1464
1474
  headers
1465
1475
  };
1466
- return transporter.request(request, requestOptions);
1476
+ return this.transporter.request(request, requestOptions);
1467
1477
  },
1468
1478
  /**
1469
1479
  * Searches for authentication resources.
@@ -1495,7 +1505,7 @@ function createIngestionClient({
1495
1505
  headers,
1496
1506
  data: authenticationSearch
1497
1507
  };
1498
- return transporter.request(request, requestOptions);
1508
+ return this.transporter.request(request, requestOptions);
1499
1509
  },
1500
1510
  /**
1501
1511
  * Searches for destinations.
@@ -1525,7 +1535,7 @@ function createIngestionClient({
1525
1535
  headers,
1526
1536
  data: destinationSearch
1527
1537
  };
1528
- return transporter.request(request, requestOptions);
1538
+ return this.transporter.request(request, requestOptions);
1529
1539
  },
1530
1540
  /**
1531
1541
  * Searches for sources.
@@ -1555,7 +1565,7 @@ function createIngestionClient({
1555
1565
  headers,
1556
1566
  data: sourceSearch
1557
1567
  };
1558
- return transporter.request(request, requestOptions);
1568
+ return this.transporter.request(request, requestOptions);
1559
1569
  },
1560
1570
  /**
1561
1571
  * Searches for tasks.
@@ -1585,7 +1595,7 @@ function createIngestionClient({
1585
1595
  headers,
1586
1596
  data: taskSearch
1587
1597
  };
1588
- return transporter.request(request, requestOptions);
1598
+ return this.transporter.request(request, requestOptions);
1589
1599
  },
1590
1600
  /**
1591
1601
  * Searches for tasks using the v1 endpoint, please use `searchTasks` instead.
@@ -1615,7 +1625,7 @@ function createIngestionClient({
1615
1625
  headers,
1616
1626
  data: taskSearch
1617
1627
  };
1618
- return transporter.request(request, requestOptions);
1628
+ return this.transporter.request(request, requestOptions);
1619
1629
  },
1620
1630
  /**
1621
1631
  * Searches for transformations.
@@ -1647,7 +1657,7 @@ function createIngestionClient({
1647
1657
  headers,
1648
1658
  data: transformationSearch
1649
1659
  };
1650
- return transporter.request(request, requestOptions);
1660
+ return this.transporter.request(request, requestOptions);
1651
1661
  },
1652
1662
  /**
1653
1663
  * Triggers a stream-listing request for a source. Triggering stream-listing requests only works with sources with `type: docker` and `imageType: singer`.
@@ -1674,7 +1684,7 @@ function createIngestionClient({
1674
1684
  queryParameters,
1675
1685
  headers
1676
1686
  };
1677
- return transporter.request(request, requestOptions);
1687
+ return this.transporter.request(request, requestOptions);
1678
1688
  },
1679
1689
  /**
1680
1690
  * Try a transformation before creating it.
@@ -1707,7 +1717,7 @@ function createIngestionClient({
1707
1717
  headers,
1708
1718
  data: transformationTry
1709
1719
  };
1710
- return transporter.request(request, requestOptions);
1720
+ return this.transporter.request(request, requestOptions);
1711
1721
  },
1712
1722
  /**
1713
1723
  * Try a transformation before updating it.
@@ -1750,7 +1760,7 @@ function createIngestionClient({
1750
1760
  headers,
1751
1761
  data: transformationTry
1752
1762
  };
1753
- return transporter.request(request, requestOptions);
1763
+ return this.transporter.request(request, requestOptions);
1754
1764
  },
1755
1765
  /**
1756
1766
  * Updates an authentication resource.
@@ -1785,7 +1795,7 @@ function createIngestionClient({
1785
1795
  headers,
1786
1796
  data: authenticationUpdate
1787
1797
  };
1788
- return transporter.request(request, requestOptions);
1798
+ return this.transporter.request(request, requestOptions);
1789
1799
  },
1790
1800
  /**
1791
1801
  * Updates the destination by its ID.
@@ -1820,7 +1830,7 @@ function createIngestionClient({
1820
1830
  headers,
1821
1831
  data: destinationUpdate
1822
1832
  };
1823
- return transporter.request(request, requestOptions);
1833
+ return this.transporter.request(request, requestOptions);
1824
1834
  },
1825
1835
  /**
1826
1836
  * Updates a source by its ID.
@@ -1852,7 +1862,7 @@ function createIngestionClient({
1852
1862
  headers,
1853
1863
  data: sourceUpdate
1854
1864
  };
1855
- return transporter.request(request, requestOptions);
1865
+ return this.transporter.request(request, requestOptions);
1856
1866
  },
1857
1867
  /**
1858
1868
  * Updates a task by its ID.
@@ -1879,7 +1889,7 @@ function createIngestionClient({
1879
1889
  headers,
1880
1890
  data: taskUpdate
1881
1891
  };
1882
- return transporter.request(request, requestOptions);
1892
+ return this.transporter.request(request, requestOptions);
1883
1893
  },
1884
1894
  /**
1885
1895
  * Updates a task by its ID using the v1 endpoint, please use `updateTask` instead.
@@ -1906,7 +1916,7 @@ function createIngestionClient({
1906
1916
  headers,
1907
1917
  data: taskUpdate
1908
1918
  };
1909
- return transporter.request(request, requestOptions);
1919
+ return this.transporter.request(request, requestOptions);
1910
1920
  },
1911
1921
  /**
1912
1922
  * Updates a transformation by its ID.
@@ -1942,7 +1952,7 @@ function createIngestionClient({
1942
1952
  headers,
1943
1953
  data: transformationCreate
1944
1954
  };
1945
- return transporter.request(request, requestOptions);
1955
+ return this.transporter.request(request, requestOptions);
1946
1956
  },
1947
1957
  /**
1948
1958
  * Validates a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -1966,7 +1976,7 @@ function createIngestionClient({
1966
1976
  headers,
1967
1977
  data: sourceCreate ? sourceCreate : {}
1968
1978
  };
1969
- return transporter.request(request, requestOptions);
1979
+ return this.transporter.request(request, requestOptions);
1970
1980
  },
1971
1981
  /**
1972
1982
  * Validates an update of a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -1998,7 +2008,7 @@ function createIngestionClient({
1998
2008
  headers,
1999
2009
  data: sourceUpdate
2000
2010
  };
2001
- return transporter.request(request, requestOptions);
2011
+ return this.transporter.request(request, requestOptions);
2002
2012
  }
2003
2013
  };
2004
2014
  }