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