@algolia/ingestion 1.2.5 → 1.3.1

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.1";
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,20 @@ 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
+ if (!authMode || authMode === "WithinHeaders") {
91
+ this.transporter.baseHeaders["x-algolia-api-key"] = apiKey;
92
+ } else {
93
+ this.transporter.baseQueryParameters["x-algolia-api-key"] = apiKey;
94
+ }
81
95
  },
82
96
  /**
83
97
  * Creates a new authentication resource.
@@ -113,7 +127,7 @@ function createIngestionClient({
113
127
  headers,
114
128
  data: authenticationCreate
115
129
  };
116
- return transporter.request(request, requestOptions);
130
+ return this.transporter.request(request, requestOptions);
117
131
  },
118
132
  /**
119
133
  * Creates a new destination.
@@ -149,7 +163,7 @@ function createIngestionClient({
149
163
  headers,
150
164
  data: destinationCreate
151
165
  };
152
- return transporter.request(request, requestOptions);
166
+ return this.transporter.request(request, requestOptions);
153
167
  },
154
168
  /**
155
169
  * Creates a new source.
@@ -182,7 +196,7 @@ function createIngestionClient({
182
196
  headers,
183
197
  data: sourceCreate
184
198
  };
185
- return transporter.request(request, requestOptions);
199
+ return this.transporter.request(request, requestOptions);
186
200
  },
187
201
  /**
188
202
  * Creates a new task.
@@ -213,7 +227,7 @@ function createIngestionClient({
213
227
  headers,
214
228
  data: taskCreate
215
229
  };
216
- return transporter.request(request, requestOptions);
230
+ return this.transporter.request(request, requestOptions);
217
231
  },
218
232
  /**
219
233
  * Creates a new task using the v1 endpoint, please use `createTask` instead.
@@ -247,7 +261,7 @@ function createIngestionClient({
247
261
  headers,
248
262
  data: taskCreate
249
263
  };
250
- return transporter.request(request, requestOptions);
264
+ return this.transporter.request(request, requestOptions);
251
265
  },
252
266
  /**
253
267
  * Creates a new transformation.
@@ -275,7 +289,7 @@ function createIngestionClient({
275
289
  headers,
276
290
  data: transformationCreate
277
291
  };
278
- return transporter.request(request, requestOptions);
292
+ return this.transporter.request(request, requestOptions);
279
293
  },
280
294
  /**
281
295
  * This method allow you to send requests to the Algolia REST API.
@@ -298,7 +312,7 @@ function createIngestionClient({
298
312
  queryParameters,
299
313
  headers
300
314
  };
301
- return transporter.request(request, requestOptions);
315
+ return this.transporter.request(request, requestOptions);
302
316
  },
303
317
  /**
304
318
  * This method allow you to send requests to the Algolia REST API.
@@ -321,7 +335,7 @@ function createIngestionClient({
321
335
  queryParameters,
322
336
  headers
323
337
  };
324
- return transporter.request(request, requestOptions);
338
+ return this.transporter.request(request, requestOptions);
325
339
  },
326
340
  /**
327
341
  * This method allow you to send requests to the Algolia REST API.
@@ -346,7 +360,7 @@ function createIngestionClient({
346
360
  headers,
347
361
  data: body ? body : {}
348
362
  };
349
- return transporter.request(request, requestOptions);
363
+ return this.transporter.request(request, requestOptions);
350
364
  },
351
365
  /**
352
366
  * This method allow you to send requests to the Algolia REST API.
@@ -371,7 +385,7 @@ function createIngestionClient({
371
385
  headers,
372
386
  data: body ? body : {}
373
387
  };
374
- return transporter.request(request, requestOptions);
388
+ return this.transporter.request(request, requestOptions);
375
389
  },
376
390
  /**
377
391
  * Deletes an authentication resource. You can\'t delete authentication resources that are used by a source or a destination.
@@ -401,7 +415,7 @@ function createIngestionClient({
401
415
  queryParameters,
402
416
  headers
403
417
  };
404
- return transporter.request(request, requestOptions);
418
+ return this.transporter.request(request, requestOptions);
405
419
  },
406
420
  /**
407
421
  * Deletes a destination by its ID. You can\'t delete destinations that are referenced in tasks.
@@ -431,7 +445,7 @@ function createIngestionClient({
431
445
  queryParameters,
432
446
  headers
433
447
  };
434
- return transporter.request(request, requestOptions);
448
+ return this.transporter.request(request, requestOptions);
435
449
  },
436
450
  /**
437
451
  * Deletes a source by its ID. You can\'t delete sources that are referenced in tasks.
@@ -458,7 +472,7 @@ function createIngestionClient({
458
472
  queryParameters,
459
473
  headers
460
474
  };
461
- return transporter.request(request, requestOptions);
475
+ return this.transporter.request(request, requestOptions);
462
476
  },
463
477
  /**
464
478
  * Deletes a task by its ID.
@@ -480,7 +494,7 @@ function createIngestionClient({
480
494
  queryParameters,
481
495
  headers
482
496
  };
483
- return transporter.request(request, requestOptions);
497
+ return this.transporter.request(request, requestOptions);
484
498
  },
485
499
  /**
486
500
  * Deletes a task by its ID using the v1 endpoint, please use `deleteTask` instead.
@@ -502,7 +516,7 @@ function createIngestionClient({
502
516
  queryParameters,
503
517
  headers
504
518
  };
505
- return transporter.request(request, requestOptions);
519
+ return this.transporter.request(request, requestOptions);
506
520
  },
507
521
  /**
508
522
  * Deletes a transformation by its ID.
@@ -527,7 +541,7 @@ function createIngestionClient({
527
541
  queryParameters,
528
542
  headers
529
543
  };
530
- return transporter.request(request, requestOptions);
544
+ return this.transporter.request(request, requestOptions);
531
545
  },
532
546
  /**
533
547
  * Disables a task.
@@ -554,7 +568,7 @@ function createIngestionClient({
554
568
  queryParameters,
555
569
  headers
556
570
  };
557
- return transporter.request(request, requestOptions);
571
+ return this.transporter.request(request, requestOptions);
558
572
  },
559
573
  /**
560
574
  * Disables a task using the v1 endpoint, please use `disableTask` instead.
@@ -581,7 +595,7 @@ function createIngestionClient({
581
595
  queryParameters,
582
596
  headers
583
597
  };
584
- return transporter.request(request, requestOptions);
598
+ return this.transporter.request(request, requestOptions);
585
599
  },
586
600
  /**
587
601
  * Enables a task.
@@ -608,7 +622,7 @@ function createIngestionClient({
608
622
  queryParameters,
609
623
  headers
610
624
  };
611
- return transporter.request(request, requestOptions);
625
+ return this.transporter.request(request, requestOptions);
612
626
  },
613
627
  /**
614
628
  * Enables a task using the v1 endpoint, please use `enableTask` instead.
@@ -635,7 +649,7 @@ function createIngestionClient({
635
649
  queryParameters,
636
650
  headers
637
651
  };
638
- return transporter.request(request, requestOptions);
652
+ return this.transporter.request(request, requestOptions);
639
653
  },
640
654
  /**
641
655
  * Generates code for the selected model based on the given prompt.
@@ -674,7 +688,7 @@ function createIngestionClient({
674
688
  headers,
675
689
  data: generateTransformationCodePayload
676
690
  };
677
- return transporter.request(request, requestOptions);
691
+ return this.transporter.request(request, requestOptions);
678
692
  },
679
693
  /**
680
694
  * Retrieves an authentication resource by its ID.
@@ -704,7 +718,7 @@ function createIngestionClient({
704
718
  queryParameters,
705
719
  headers
706
720
  };
707
- return transporter.request(request, requestOptions);
721
+ return this.transporter.request(request, requestOptions);
708
722
  },
709
723
  /**
710
724
  * Retrieves a destination by its ID.
@@ -734,7 +748,7 @@ function createIngestionClient({
734
748
  queryParameters,
735
749
  headers
736
750
  };
737
- return transporter.request(request, requestOptions);
751
+ return this.transporter.request(request, requestOptions);
738
752
  },
739
753
  /**
740
754
  * Retrieves a single task run event by its ID.
@@ -765,7 +779,7 @@ function createIngestionClient({
765
779
  queryParameters,
766
780
  headers
767
781
  };
768
- return transporter.request(request, requestOptions);
782
+ return this.transporter.request(request, requestOptions);
769
783
  },
770
784
  /**
771
785
  * Retrieve a single task run by its ID.
@@ -792,7 +806,7 @@ function createIngestionClient({
792
806
  queryParameters,
793
807
  headers
794
808
  };
795
- return transporter.request(request, requestOptions);
809
+ return this.transporter.request(request, requestOptions);
796
810
  },
797
811
  /**
798
812
  * Retrieve a source by its ID.
@@ -819,7 +833,7 @@ function createIngestionClient({
819
833
  queryParameters,
820
834
  headers
821
835
  };
822
- return transporter.request(request, requestOptions);
836
+ return this.transporter.request(request, requestOptions);
823
837
  },
824
838
  /**
825
839
  * Retrieves a task by its ID.
@@ -846,7 +860,7 @@ function createIngestionClient({
846
860
  queryParameters,
847
861
  headers
848
862
  };
849
- return transporter.request(request, requestOptions);
863
+ return this.transporter.request(request, requestOptions);
850
864
  },
851
865
  /**
852
866
  * Retrieves a task by its ID using the v1 endpoint, please use `getTask` instead.
@@ -873,7 +887,7 @@ function createIngestionClient({
873
887
  queryParameters,
874
888
  headers
875
889
  };
876
- return transporter.request(request, requestOptions);
890
+ return this.transporter.request(request, requestOptions);
877
891
  },
878
892
  /**
879
893
  * Retrieves a transformation by its ID.
@@ -903,7 +917,7 @@ function createIngestionClient({
903
917
  queryParameters,
904
918
  headers
905
919
  };
906
- return transporter.request(request, requestOptions);
920
+ return this.transporter.request(request, requestOptions);
907
921
  },
908
922
  /**
909
923
  * Retrieves a list of all authentication resources.
@@ -950,7 +964,7 @@ function createIngestionClient({
950
964
  queryParameters,
951
965
  headers
952
966
  };
953
- return transporter.request(request, requestOptions);
967
+ return this.transporter.request(request, requestOptions);
954
968
  },
955
969
  /**
956
970
  * Retrieves a list of destinations.
@@ -997,7 +1011,7 @@ function createIngestionClient({
997
1011
  queryParameters,
998
1012
  headers
999
1013
  };
1000
- return transporter.request(request, requestOptions);
1014
+ return this.transporter.request(request, requestOptions);
1001
1015
  },
1002
1016
  /**
1003
1017
  * Retrieves a list of events for a task run, identified by it\'s ID.
@@ -1056,7 +1070,7 @@ function createIngestionClient({
1056
1070
  queryParameters,
1057
1071
  headers
1058
1072
  };
1059
- return transporter.request(request, requestOptions);
1073
+ return this.transporter.request(request, requestOptions);
1060
1074
  },
1061
1075
  /**
1062
1076
  * Retrieve a list of task runs.
@@ -1115,7 +1129,7 @@ function createIngestionClient({
1115
1129
  queryParameters,
1116
1130
  headers
1117
1131
  };
1118
- return transporter.request(request, requestOptions);
1132
+ return this.transporter.request(request, requestOptions);
1119
1133
  },
1120
1134
  /**
1121
1135
  * Retrieves a list of sources.
@@ -1162,7 +1176,7 @@ function createIngestionClient({
1162
1176
  queryParameters,
1163
1177
  headers
1164
1178
  };
1165
- return transporter.request(request, requestOptions);
1179
+ return this.transporter.request(request, requestOptions);
1166
1180
  },
1167
1181
  /**
1168
1182
  * Retrieves a list of tasks.
@@ -1221,7 +1235,7 @@ function createIngestionClient({
1221
1235
  queryParameters,
1222
1236
  headers
1223
1237
  };
1224
- return transporter.request(request, requestOptions);
1238
+ return this.transporter.request(request, requestOptions);
1225
1239
  },
1226
1240
  /**
1227
1241
  * Retrieves a list of tasks using the v1 endpoint, please use `getTasks` instead.
@@ -1280,7 +1294,7 @@ function createIngestionClient({
1280
1294
  queryParameters,
1281
1295
  headers
1282
1296
  };
1283
- return transporter.request(request, requestOptions);
1297
+ return this.transporter.request(request, requestOptions);
1284
1298
  },
1285
1299
  /**
1286
1300
  * Retrieves a list of existing LLM transformation helpers.
@@ -1302,7 +1316,7 @@ function createIngestionClient({
1302
1316
  queryParameters,
1303
1317
  headers
1304
1318
  };
1305
- return transporter.request(request, requestOptions);
1319
+ return this.transporter.request(request, requestOptions);
1306
1320
  },
1307
1321
  /**
1308
1322
  * Retrieves a list of transformations.
@@ -1341,7 +1355,7 @@ function createIngestionClient({
1341
1355
  queryParameters,
1342
1356
  headers
1343
1357
  };
1344
- return transporter.request(request, requestOptions);
1358
+ return this.transporter.request(request, requestOptions);
1345
1359
  },
1346
1360
  /**
1347
1361
  * Push a `batch` request payload through the Pipeline. You can check the status of task pushes with the observability endpoints.
@@ -1379,7 +1393,7 @@ function createIngestionClient({
1379
1393
  headers,
1380
1394
  data: pushTaskPayload
1381
1395
  };
1382
- return transporter.request(request, requestOptions);
1396
+ return this.transporter.request(request, requestOptions);
1383
1397
  },
1384
1398
  /**
1385
1399
  * Runs all tasks linked to a source, only available for Shopify sources. It will create 1 run per task.
@@ -1408,7 +1422,7 @@ function createIngestionClient({
1408
1422
  headers,
1409
1423
  data: runSourcePayload ? runSourcePayload : {}
1410
1424
  };
1411
- return transporter.request(request, requestOptions);
1425
+ return this.transporter.request(request, requestOptions);
1412
1426
  },
1413
1427
  /**
1414
1428
  * Runs a task. You can check the status of task runs with the observability endpoints.
@@ -1435,7 +1449,7 @@ function createIngestionClient({
1435
1449
  queryParameters,
1436
1450
  headers
1437
1451
  };
1438
- return transporter.request(request, requestOptions);
1452
+ return this.transporter.request(request, requestOptions);
1439
1453
  },
1440
1454
  /**
1441
1455
  * 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 +1476,7 @@ function createIngestionClient({
1462
1476
  queryParameters,
1463
1477
  headers
1464
1478
  };
1465
- return transporter.request(request, requestOptions);
1479
+ return this.transporter.request(request, requestOptions);
1466
1480
  },
1467
1481
  /**
1468
1482
  * Searches for authentication resources.
@@ -1494,7 +1508,7 @@ function createIngestionClient({
1494
1508
  headers,
1495
1509
  data: authenticationSearch
1496
1510
  };
1497
- return transporter.request(request, requestOptions);
1511
+ return this.transporter.request(request, requestOptions);
1498
1512
  },
1499
1513
  /**
1500
1514
  * Searches for destinations.
@@ -1524,7 +1538,7 @@ function createIngestionClient({
1524
1538
  headers,
1525
1539
  data: destinationSearch
1526
1540
  };
1527
- return transporter.request(request, requestOptions);
1541
+ return this.transporter.request(request, requestOptions);
1528
1542
  },
1529
1543
  /**
1530
1544
  * Searches for sources.
@@ -1554,7 +1568,7 @@ function createIngestionClient({
1554
1568
  headers,
1555
1569
  data: sourceSearch
1556
1570
  };
1557
- return transporter.request(request, requestOptions);
1571
+ return this.transporter.request(request, requestOptions);
1558
1572
  },
1559
1573
  /**
1560
1574
  * Searches for tasks.
@@ -1584,7 +1598,7 @@ function createIngestionClient({
1584
1598
  headers,
1585
1599
  data: taskSearch
1586
1600
  };
1587
- return transporter.request(request, requestOptions);
1601
+ return this.transporter.request(request, requestOptions);
1588
1602
  },
1589
1603
  /**
1590
1604
  * Searches for tasks using the v1 endpoint, please use `searchTasks` instead.
@@ -1614,7 +1628,7 @@ function createIngestionClient({
1614
1628
  headers,
1615
1629
  data: taskSearch
1616
1630
  };
1617
- return transporter.request(request, requestOptions);
1631
+ return this.transporter.request(request, requestOptions);
1618
1632
  },
1619
1633
  /**
1620
1634
  * Searches for transformations.
@@ -1646,7 +1660,7 @@ function createIngestionClient({
1646
1660
  headers,
1647
1661
  data: transformationSearch
1648
1662
  };
1649
- return transporter.request(request, requestOptions);
1663
+ return this.transporter.request(request, requestOptions);
1650
1664
  },
1651
1665
  /**
1652
1666
  * Triggers a stream-listing request for a source. Triggering stream-listing requests only works with sources with `type: docker` and `imageType: singer`.
@@ -1673,7 +1687,7 @@ function createIngestionClient({
1673
1687
  queryParameters,
1674
1688
  headers
1675
1689
  };
1676
- return transporter.request(request, requestOptions);
1690
+ return this.transporter.request(request, requestOptions);
1677
1691
  },
1678
1692
  /**
1679
1693
  * Try a transformation before creating it.
@@ -1706,7 +1720,7 @@ function createIngestionClient({
1706
1720
  headers,
1707
1721
  data: transformationTry
1708
1722
  };
1709
- return transporter.request(request, requestOptions);
1723
+ return this.transporter.request(request, requestOptions);
1710
1724
  },
1711
1725
  /**
1712
1726
  * Try a transformation before updating it.
@@ -1749,7 +1763,7 @@ function createIngestionClient({
1749
1763
  headers,
1750
1764
  data: transformationTry
1751
1765
  };
1752
- return transporter.request(request, requestOptions);
1766
+ return this.transporter.request(request, requestOptions);
1753
1767
  },
1754
1768
  /**
1755
1769
  * Updates an authentication resource.
@@ -1784,7 +1798,7 @@ function createIngestionClient({
1784
1798
  headers,
1785
1799
  data: authenticationUpdate
1786
1800
  };
1787
- return transporter.request(request, requestOptions);
1801
+ return this.transporter.request(request, requestOptions);
1788
1802
  },
1789
1803
  /**
1790
1804
  * Updates the destination by its ID.
@@ -1819,7 +1833,7 @@ function createIngestionClient({
1819
1833
  headers,
1820
1834
  data: destinationUpdate
1821
1835
  };
1822
- return transporter.request(request, requestOptions);
1836
+ return this.transporter.request(request, requestOptions);
1823
1837
  },
1824
1838
  /**
1825
1839
  * Updates a source by its ID.
@@ -1851,7 +1865,7 @@ function createIngestionClient({
1851
1865
  headers,
1852
1866
  data: sourceUpdate
1853
1867
  };
1854
- return transporter.request(request, requestOptions);
1868
+ return this.transporter.request(request, requestOptions);
1855
1869
  },
1856
1870
  /**
1857
1871
  * Updates a task by its ID.
@@ -1878,7 +1892,7 @@ function createIngestionClient({
1878
1892
  headers,
1879
1893
  data: taskUpdate
1880
1894
  };
1881
- return transporter.request(request, requestOptions);
1895
+ return this.transporter.request(request, requestOptions);
1882
1896
  },
1883
1897
  /**
1884
1898
  * Updates a task by its ID using the v1 endpoint, please use `updateTask` instead.
@@ -1905,7 +1919,7 @@ function createIngestionClient({
1905
1919
  headers,
1906
1920
  data: taskUpdate
1907
1921
  };
1908
- return transporter.request(request, requestOptions);
1922
+ return this.transporter.request(request, requestOptions);
1909
1923
  },
1910
1924
  /**
1911
1925
  * Updates a transformation by its ID.
@@ -1941,7 +1955,7 @@ function createIngestionClient({
1941
1955
  headers,
1942
1956
  data: transformationCreate
1943
1957
  };
1944
- return transporter.request(request, requestOptions);
1958
+ return this.transporter.request(request, requestOptions);
1945
1959
  },
1946
1960
  /**
1947
1961
  * Validates a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -1965,7 +1979,7 @@ function createIngestionClient({
1965
1979
  headers,
1966
1980
  data: sourceCreate ? sourceCreate : {}
1967
1981
  };
1968
- return transporter.request(request, requestOptions);
1982
+ return this.transporter.request(request, requestOptions);
1969
1983
  },
1970
1984
  /**
1971
1985
  * 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 +2011,7 @@ function createIngestionClient({
1997
2011
  headers,
1998
2012
  data: sourceUpdate
1999
2013
  };
2000
- return transporter.request(request, requestOptions);
2014
+ return this.transporter.request(request, requestOptions);
2001
2015
  }
2002
2016
  };
2003
2017
  }