@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.
@@ -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.1";
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,20 @@ 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
+ if (!authMode || authMode === "WithinHeaders") {
92
+ this.transporter.baseHeaders["x-algolia-api-key"] = apiKey;
93
+ } else {
94
+ this.transporter.baseQueryParameters["x-algolia-api-key"] = apiKey;
95
+ }
82
96
  },
83
97
  /**
84
98
  * Creates a new authentication resource.
@@ -114,7 +128,7 @@ function createIngestionClient({
114
128
  headers,
115
129
  data: authenticationCreate
116
130
  };
117
- return transporter.request(request, requestOptions);
131
+ return this.transporter.request(request, requestOptions);
118
132
  },
119
133
  /**
120
134
  * Creates a new destination.
@@ -150,7 +164,7 @@ function createIngestionClient({
150
164
  headers,
151
165
  data: destinationCreate
152
166
  };
153
- return transporter.request(request, requestOptions);
167
+ return this.transporter.request(request, requestOptions);
154
168
  },
155
169
  /**
156
170
  * Creates a new source.
@@ -183,7 +197,7 @@ function createIngestionClient({
183
197
  headers,
184
198
  data: sourceCreate
185
199
  };
186
- return transporter.request(request, requestOptions);
200
+ return this.transporter.request(request, requestOptions);
187
201
  },
188
202
  /**
189
203
  * Creates a new task.
@@ -214,7 +228,7 @@ function createIngestionClient({
214
228
  headers,
215
229
  data: taskCreate
216
230
  };
217
- return transporter.request(request, requestOptions);
231
+ return this.transporter.request(request, requestOptions);
218
232
  },
219
233
  /**
220
234
  * Creates a new task using the v1 endpoint, please use `createTask` instead.
@@ -248,7 +262,7 @@ function createIngestionClient({
248
262
  headers,
249
263
  data: taskCreate
250
264
  };
251
- return transporter.request(request, requestOptions);
265
+ return this.transporter.request(request, requestOptions);
252
266
  },
253
267
  /**
254
268
  * Creates a new transformation.
@@ -276,7 +290,7 @@ function createIngestionClient({
276
290
  headers,
277
291
  data: transformationCreate
278
292
  };
279
- return transporter.request(request, requestOptions);
293
+ return this.transporter.request(request, requestOptions);
280
294
  },
281
295
  /**
282
296
  * This method allow you to send requests to the Algolia REST API.
@@ -299,7 +313,7 @@ function createIngestionClient({
299
313
  queryParameters,
300
314
  headers
301
315
  };
302
- return transporter.request(request, requestOptions);
316
+ return this.transporter.request(request, requestOptions);
303
317
  },
304
318
  /**
305
319
  * This method allow you to send requests to the Algolia REST API.
@@ -322,7 +336,7 @@ function createIngestionClient({
322
336
  queryParameters,
323
337
  headers
324
338
  };
325
- return transporter.request(request, requestOptions);
339
+ return this.transporter.request(request, requestOptions);
326
340
  },
327
341
  /**
328
342
  * This method allow you to send requests to the Algolia REST API.
@@ -347,7 +361,7 @@ function createIngestionClient({
347
361
  headers,
348
362
  data: body ? body : {}
349
363
  };
350
- return transporter.request(request, requestOptions);
364
+ return this.transporter.request(request, requestOptions);
351
365
  },
352
366
  /**
353
367
  * This method allow you to send requests to the Algolia REST API.
@@ -372,7 +386,7 @@ function createIngestionClient({
372
386
  headers,
373
387
  data: body ? body : {}
374
388
  };
375
- return transporter.request(request, requestOptions);
389
+ return this.transporter.request(request, requestOptions);
376
390
  },
377
391
  /**
378
392
  * Deletes an authentication resource. You can\'t delete authentication resources that are used by a source or a destination.
@@ -402,7 +416,7 @@ function createIngestionClient({
402
416
  queryParameters,
403
417
  headers
404
418
  };
405
- return transporter.request(request, requestOptions);
419
+ return this.transporter.request(request, requestOptions);
406
420
  },
407
421
  /**
408
422
  * Deletes a destination by its ID. You can\'t delete destinations that are referenced in tasks.
@@ -432,7 +446,7 @@ function createIngestionClient({
432
446
  queryParameters,
433
447
  headers
434
448
  };
435
- return transporter.request(request, requestOptions);
449
+ return this.transporter.request(request, requestOptions);
436
450
  },
437
451
  /**
438
452
  * Deletes a source by its ID. You can\'t delete sources that are referenced in tasks.
@@ -459,7 +473,7 @@ function createIngestionClient({
459
473
  queryParameters,
460
474
  headers
461
475
  };
462
- return transporter.request(request, requestOptions);
476
+ return this.transporter.request(request, requestOptions);
463
477
  },
464
478
  /**
465
479
  * Deletes a task by its ID.
@@ -481,7 +495,7 @@ function createIngestionClient({
481
495
  queryParameters,
482
496
  headers
483
497
  };
484
- return transporter.request(request, requestOptions);
498
+ return this.transporter.request(request, requestOptions);
485
499
  },
486
500
  /**
487
501
  * Deletes a task by its ID using the v1 endpoint, please use `deleteTask` instead.
@@ -503,7 +517,7 @@ function createIngestionClient({
503
517
  queryParameters,
504
518
  headers
505
519
  };
506
- return transporter.request(request, requestOptions);
520
+ return this.transporter.request(request, requestOptions);
507
521
  },
508
522
  /**
509
523
  * Deletes a transformation by its ID.
@@ -528,7 +542,7 @@ function createIngestionClient({
528
542
  queryParameters,
529
543
  headers
530
544
  };
531
- return transporter.request(request, requestOptions);
545
+ return this.transporter.request(request, requestOptions);
532
546
  },
533
547
  /**
534
548
  * Disables a task.
@@ -555,7 +569,7 @@ function createIngestionClient({
555
569
  queryParameters,
556
570
  headers
557
571
  };
558
- return transporter.request(request, requestOptions);
572
+ return this.transporter.request(request, requestOptions);
559
573
  },
560
574
  /**
561
575
  * Disables a task using the v1 endpoint, please use `disableTask` instead.
@@ -582,7 +596,7 @@ function createIngestionClient({
582
596
  queryParameters,
583
597
  headers
584
598
  };
585
- return transporter.request(request, requestOptions);
599
+ return this.transporter.request(request, requestOptions);
586
600
  },
587
601
  /**
588
602
  * Enables a task.
@@ -609,7 +623,7 @@ function createIngestionClient({
609
623
  queryParameters,
610
624
  headers
611
625
  };
612
- return transporter.request(request, requestOptions);
626
+ return this.transporter.request(request, requestOptions);
613
627
  },
614
628
  /**
615
629
  * Enables a task using the v1 endpoint, please use `enableTask` instead.
@@ -636,7 +650,7 @@ function createIngestionClient({
636
650
  queryParameters,
637
651
  headers
638
652
  };
639
- return transporter.request(request, requestOptions);
653
+ return this.transporter.request(request, requestOptions);
640
654
  },
641
655
  /**
642
656
  * Generates code for the selected model based on the given prompt.
@@ -675,7 +689,7 @@ function createIngestionClient({
675
689
  headers,
676
690
  data: generateTransformationCodePayload
677
691
  };
678
- return transporter.request(request, requestOptions);
692
+ return this.transporter.request(request, requestOptions);
679
693
  },
680
694
  /**
681
695
  * Retrieves an authentication resource by its ID.
@@ -705,7 +719,7 @@ function createIngestionClient({
705
719
  queryParameters,
706
720
  headers
707
721
  };
708
- return transporter.request(request, requestOptions);
722
+ return this.transporter.request(request, requestOptions);
709
723
  },
710
724
  /**
711
725
  * Retrieves a destination by its ID.
@@ -735,7 +749,7 @@ function createIngestionClient({
735
749
  queryParameters,
736
750
  headers
737
751
  };
738
- return transporter.request(request, requestOptions);
752
+ return this.transporter.request(request, requestOptions);
739
753
  },
740
754
  /**
741
755
  * Retrieves a single task run event by its ID.
@@ -766,7 +780,7 @@ function createIngestionClient({
766
780
  queryParameters,
767
781
  headers
768
782
  };
769
- return transporter.request(request, requestOptions);
783
+ return this.transporter.request(request, requestOptions);
770
784
  },
771
785
  /**
772
786
  * Retrieve a single task run by its ID.
@@ -793,7 +807,7 @@ function createIngestionClient({
793
807
  queryParameters,
794
808
  headers
795
809
  };
796
- return transporter.request(request, requestOptions);
810
+ return this.transporter.request(request, requestOptions);
797
811
  },
798
812
  /**
799
813
  * Retrieve a source by its ID.
@@ -820,7 +834,7 @@ function createIngestionClient({
820
834
  queryParameters,
821
835
  headers
822
836
  };
823
- return transporter.request(request, requestOptions);
837
+ return this.transporter.request(request, requestOptions);
824
838
  },
825
839
  /**
826
840
  * Retrieves a task by its ID.
@@ -847,7 +861,7 @@ function createIngestionClient({
847
861
  queryParameters,
848
862
  headers
849
863
  };
850
- return transporter.request(request, requestOptions);
864
+ return this.transporter.request(request, requestOptions);
851
865
  },
852
866
  /**
853
867
  * Retrieves a task by its ID using the v1 endpoint, please use `getTask` instead.
@@ -874,7 +888,7 @@ function createIngestionClient({
874
888
  queryParameters,
875
889
  headers
876
890
  };
877
- return transporter.request(request, requestOptions);
891
+ return this.transporter.request(request, requestOptions);
878
892
  },
879
893
  /**
880
894
  * Retrieves a transformation by its ID.
@@ -904,7 +918,7 @@ function createIngestionClient({
904
918
  queryParameters,
905
919
  headers
906
920
  };
907
- return transporter.request(request, requestOptions);
921
+ return this.transporter.request(request, requestOptions);
908
922
  },
909
923
  /**
910
924
  * Retrieves a list of all authentication resources.
@@ -951,7 +965,7 @@ function createIngestionClient({
951
965
  queryParameters,
952
966
  headers
953
967
  };
954
- return transporter.request(request, requestOptions);
968
+ return this.transporter.request(request, requestOptions);
955
969
  },
956
970
  /**
957
971
  * Retrieves a list of destinations.
@@ -998,7 +1012,7 @@ function createIngestionClient({
998
1012
  queryParameters,
999
1013
  headers
1000
1014
  };
1001
- return transporter.request(request, requestOptions);
1015
+ return this.transporter.request(request, requestOptions);
1002
1016
  },
1003
1017
  /**
1004
1018
  * Retrieves a list of events for a task run, identified by it\'s ID.
@@ -1057,7 +1071,7 @@ function createIngestionClient({
1057
1071
  queryParameters,
1058
1072
  headers
1059
1073
  };
1060
- return transporter.request(request, requestOptions);
1074
+ return this.transporter.request(request, requestOptions);
1061
1075
  },
1062
1076
  /**
1063
1077
  * Retrieve a list of task runs.
@@ -1116,7 +1130,7 @@ function createIngestionClient({
1116
1130
  queryParameters,
1117
1131
  headers
1118
1132
  };
1119
- return transporter.request(request, requestOptions);
1133
+ return this.transporter.request(request, requestOptions);
1120
1134
  },
1121
1135
  /**
1122
1136
  * Retrieves a list of sources.
@@ -1163,7 +1177,7 @@ function createIngestionClient({
1163
1177
  queryParameters,
1164
1178
  headers
1165
1179
  };
1166
- return transporter.request(request, requestOptions);
1180
+ return this.transporter.request(request, requestOptions);
1167
1181
  },
1168
1182
  /**
1169
1183
  * Retrieves a list of tasks.
@@ -1222,7 +1236,7 @@ function createIngestionClient({
1222
1236
  queryParameters,
1223
1237
  headers
1224
1238
  };
1225
- return transporter.request(request, requestOptions);
1239
+ return this.transporter.request(request, requestOptions);
1226
1240
  },
1227
1241
  /**
1228
1242
  * Retrieves a list of tasks using the v1 endpoint, please use `getTasks` instead.
@@ -1281,7 +1295,7 @@ function createIngestionClient({
1281
1295
  queryParameters,
1282
1296
  headers
1283
1297
  };
1284
- return transporter.request(request, requestOptions);
1298
+ return this.transporter.request(request, requestOptions);
1285
1299
  },
1286
1300
  /**
1287
1301
  * Retrieves a list of existing LLM transformation helpers.
@@ -1303,7 +1317,7 @@ function createIngestionClient({
1303
1317
  queryParameters,
1304
1318
  headers
1305
1319
  };
1306
- return transporter.request(request, requestOptions);
1320
+ return this.transporter.request(request, requestOptions);
1307
1321
  },
1308
1322
  /**
1309
1323
  * Retrieves a list of transformations.
@@ -1342,7 +1356,7 @@ function createIngestionClient({
1342
1356
  queryParameters,
1343
1357
  headers
1344
1358
  };
1345
- return transporter.request(request, requestOptions);
1359
+ return this.transporter.request(request, requestOptions);
1346
1360
  },
1347
1361
  /**
1348
1362
  * Push a `batch` request payload through the Pipeline. You can check the status of task pushes with the observability endpoints.
@@ -1380,7 +1394,7 @@ function createIngestionClient({
1380
1394
  headers,
1381
1395
  data: pushTaskPayload
1382
1396
  };
1383
- return transporter.request(request, requestOptions);
1397
+ return this.transporter.request(request, requestOptions);
1384
1398
  },
1385
1399
  /**
1386
1400
  * Runs all tasks linked to a source, only available for Shopify sources. It will create 1 run per task.
@@ -1409,7 +1423,7 @@ function createIngestionClient({
1409
1423
  headers,
1410
1424
  data: runSourcePayload ? runSourcePayload : {}
1411
1425
  };
1412
- return transporter.request(request, requestOptions);
1426
+ return this.transporter.request(request, requestOptions);
1413
1427
  },
1414
1428
  /**
1415
1429
  * Runs a task. You can check the status of task runs with the observability endpoints.
@@ -1436,7 +1450,7 @@ function createIngestionClient({
1436
1450
  queryParameters,
1437
1451
  headers
1438
1452
  };
1439
- return transporter.request(request, requestOptions);
1453
+ return this.transporter.request(request, requestOptions);
1440
1454
  },
1441
1455
  /**
1442
1456
  * 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 +1477,7 @@ function createIngestionClient({
1463
1477
  queryParameters,
1464
1478
  headers
1465
1479
  };
1466
- return transporter.request(request, requestOptions);
1480
+ return this.transporter.request(request, requestOptions);
1467
1481
  },
1468
1482
  /**
1469
1483
  * Searches for authentication resources.
@@ -1495,7 +1509,7 @@ function createIngestionClient({
1495
1509
  headers,
1496
1510
  data: authenticationSearch
1497
1511
  };
1498
- return transporter.request(request, requestOptions);
1512
+ return this.transporter.request(request, requestOptions);
1499
1513
  },
1500
1514
  /**
1501
1515
  * Searches for destinations.
@@ -1525,7 +1539,7 @@ function createIngestionClient({
1525
1539
  headers,
1526
1540
  data: destinationSearch
1527
1541
  };
1528
- return transporter.request(request, requestOptions);
1542
+ return this.transporter.request(request, requestOptions);
1529
1543
  },
1530
1544
  /**
1531
1545
  * Searches for sources.
@@ -1555,7 +1569,7 @@ function createIngestionClient({
1555
1569
  headers,
1556
1570
  data: sourceSearch
1557
1571
  };
1558
- return transporter.request(request, requestOptions);
1572
+ return this.transporter.request(request, requestOptions);
1559
1573
  },
1560
1574
  /**
1561
1575
  * Searches for tasks.
@@ -1585,7 +1599,7 @@ function createIngestionClient({
1585
1599
  headers,
1586
1600
  data: taskSearch
1587
1601
  };
1588
- return transporter.request(request, requestOptions);
1602
+ return this.transporter.request(request, requestOptions);
1589
1603
  },
1590
1604
  /**
1591
1605
  * Searches for tasks using the v1 endpoint, please use `searchTasks` instead.
@@ -1615,7 +1629,7 @@ function createIngestionClient({
1615
1629
  headers,
1616
1630
  data: taskSearch
1617
1631
  };
1618
- return transporter.request(request, requestOptions);
1632
+ return this.transporter.request(request, requestOptions);
1619
1633
  },
1620
1634
  /**
1621
1635
  * Searches for transformations.
@@ -1647,7 +1661,7 @@ function createIngestionClient({
1647
1661
  headers,
1648
1662
  data: transformationSearch
1649
1663
  };
1650
- return transporter.request(request, requestOptions);
1664
+ return this.transporter.request(request, requestOptions);
1651
1665
  },
1652
1666
  /**
1653
1667
  * Triggers a stream-listing request for a source. Triggering stream-listing requests only works with sources with `type: docker` and `imageType: singer`.
@@ -1674,7 +1688,7 @@ function createIngestionClient({
1674
1688
  queryParameters,
1675
1689
  headers
1676
1690
  };
1677
- return transporter.request(request, requestOptions);
1691
+ return this.transporter.request(request, requestOptions);
1678
1692
  },
1679
1693
  /**
1680
1694
  * Try a transformation before creating it.
@@ -1707,7 +1721,7 @@ function createIngestionClient({
1707
1721
  headers,
1708
1722
  data: transformationTry
1709
1723
  };
1710
- return transporter.request(request, requestOptions);
1724
+ return this.transporter.request(request, requestOptions);
1711
1725
  },
1712
1726
  /**
1713
1727
  * Try a transformation before updating it.
@@ -1750,7 +1764,7 @@ function createIngestionClient({
1750
1764
  headers,
1751
1765
  data: transformationTry
1752
1766
  };
1753
- return transporter.request(request, requestOptions);
1767
+ return this.transporter.request(request, requestOptions);
1754
1768
  },
1755
1769
  /**
1756
1770
  * Updates an authentication resource.
@@ -1785,7 +1799,7 @@ function createIngestionClient({
1785
1799
  headers,
1786
1800
  data: authenticationUpdate
1787
1801
  };
1788
- return transporter.request(request, requestOptions);
1802
+ return this.transporter.request(request, requestOptions);
1789
1803
  },
1790
1804
  /**
1791
1805
  * Updates the destination by its ID.
@@ -1820,7 +1834,7 @@ function createIngestionClient({
1820
1834
  headers,
1821
1835
  data: destinationUpdate
1822
1836
  };
1823
- return transporter.request(request, requestOptions);
1837
+ return this.transporter.request(request, requestOptions);
1824
1838
  },
1825
1839
  /**
1826
1840
  * Updates a source by its ID.
@@ -1852,7 +1866,7 @@ function createIngestionClient({
1852
1866
  headers,
1853
1867
  data: sourceUpdate
1854
1868
  };
1855
- return transporter.request(request, requestOptions);
1869
+ return this.transporter.request(request, requestOptions);
1856
1870
  },
1857
1871
  /**
1858
1872
  * Updates a task by its ID.
@@ -1879,7 +1893,7 @@ function createIngestionClient({
1879
1893
  headers,
1880
1894
  data: taskUpdate
1881
1895
  };
1882
- return transporter.request(request, requestOptions);
1896
+ return this.transporter.request(request, requestOptions);
1883
1897
  },
1884
1898
  /**
1885
1899
  * Updates a task by its ID using the v1 endpoint, please use `updateTask` instead.
@@ -1906,7 +1920,7 @@ function createIngestionClient({
1906
1920
  headers,
1907
1921
  data: taskUpdate
1908
1922
  };
1909
- return transporter.request(request, requestOptions);
1923
+ return this.transporter.request(request, requestOptions);
1910
1924
  },
1911
1925
  /**
1912
1926
  * Updates a transformation by its ID.
@@ -1942,7 +1956,7 @@ function createIngestionClient({
1942
1956
  headers,
1943
1957
  data: transformationCreate
1944
1958
  };
1945
- return transporter.request(request, requestOptions);
1959
+ return this.transporter.request(request, requestOptions);
1946
1960
  },
1947
1961
  /**
1948
1962
  * Validates a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -1966,7 +1980,7 @@ function createIngestionClient({
1966
1980
  headers,
1967
1981
  data: sourceCreate ? sourceCreate : {}
1968
1982
  };
1969
- return transporter.request(request, requestOptions);
1983
+ return this.transporter.request(request, requestOptions);
1970
1984
  },
1971
1985
  /**
1972
1986
  * 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 +2012,7 @@ function createIngestionClient({
1998
2012
  headers,
1999
2013
  data: sourceUpdate
2000
2014
  };
2001
- return transporter.request(request, requestOptions);
2015
+ return this.transporter.request(request, requestOptions);
2002
2016
  }
2003
2017
  };
2004
2018
  }