@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.
@@ -32,7 +32,7 @@ var import_requester_node_http = require("@algolia/requester-node-http");
32
32
 
33
33
  // src/ingestionClient.ts
34
34
  var import_client_common = require("@algolia/client-common");
35
- var apiClientVersion = "1.2.5";
35
+ var apiClientVersion = "1.3.0";
36
36
  var REGIONS = ["eu", "us"];
37
37
  function getDefaultHosts(region) {
38
38
  const url = "data.{region}.algolia.com".replace("{region}", region);
@@ -56,26 +56,25 @@ function createIngestionClient({
56
56
  ...options
57
57
  }) {
58
58
  const auth = (0, import_client_common.createAuth)(appIdOption, apiKeyOption, authMode);
59
- const transporter = (0, import_client_common.createTransporter)({
60
- hosts: getDefaultHosts(regionOption),
61
- ...options,
62
- algoliaAgent: (0, import_client_common.getAlgoliaAgent)({
63
- algoliaAgents,
64
- client: "Ingestion",
65
- version: apiClientVersion
66
- }),
67
- baseHeaders: {
68
- "content-type": "text/plain",
69
- ...auth.headers(),
70
- ...options.baseHeaders
71
- },
72
- baseQueryParameters: {
73
- ...auth.queryParameters(),
74
- ...options.baseQueryParameters
75
- }
76
- });
77
59
  return {
78
- transporter,
60
+ transporter: (0, import_client_common.createTransporter)({
61
+ hosts: getDefaultHosts(regionOption),
62
+ ...options,
63
+ algoliaAgent: (0, import_client_common.getAlgoliaAgent)({
64
+ algoliaAgents,
65
+ client: "Ingestion",
66
+ version: apiClientVersion
67
+ }),
68
+ baseHeaders: {
69
+ "content-type": "text/plain",
70
+ ...auth.headers(),
71
+ ...options.baseHeaders
72
+ },
73
+ baseQueryParameters: {
74
+ ...auth.queryParameters(),
75
+ ...options.baseQueryParameters
76
+ }
77
+ }),
79
78
  /**
80
79
  * The `appId` currently in use.
81
80
  */
@@ -84,13 +83,15 @@ function createIngestionClient({
84
83
  * Clears the cache of the transporter for the `requestsCache` and `responsesCache` properties.
85
84
  */
86
85
  clearCache() {
87
- return Promise.all([transporter.requestsCache.clear(), transporter.responsesCache.clear()]).then(() => void 0);
86
+ return Promise.all([this.transporter.requestsCache.clear(), this.transporter.responsesCache.clear()]).then(
87
+ () => void 0
88
+ );
88
89
  },
89
90
  /**
90
91
  * Get the value of the `algoliaAgent`, used by our libraries internally and telemetry system.
91
92
  */
92
93
  get _ua() {
93
- return transporter.algoliaAgent.value;
94
+ return this.transporter.algoliaAgent.value;
94
95
  },
95
96
  /**
96
97
  * Adds a `segment` to the `x-algolia-agent` sent with every requests.
@@ -99,7 +100,16 @@ function createIngestionClient({
99
100
  * @param version - The version of the agent.
100
101
  */
101
102
  addAlgoliaAgent(segment, version) {
102
- transporter.algoliaAgent.add({ segment, version });
103
+ this.transporter.algoliaAgent.add({ segment, version });
104
+ },
105
+ /**
106
+ * Helper method to switch the API key used to authenticate the requests.
107
+ *
108
+ * @param params - Method params.
109
+ * @param params.apiKey - The new API Key to use.
110
+ */
111
+ setClientApiKey({ apiKey }) {
112
+ this.transporter.baseHeaders["x-algolia-api-key"] = apiKey;
103
113
  },
104
114
  /**
105
115
  * Creates a new authentication resource.
@@ -135,7 +145,7 @@ function createIngestionClient({
135
145
  headers,
136
146
  data: authenticationCreate
137
147
  };
138
- return transporter.request(request, requestOptions);
148
+ return this.transporter.request(request, requestOptions);
139
149
  },
140
150
  /**
141
151
  * Creates a new destination.
@@ -171,7 +181,7 @@ function createIngestionClient({
171
181
  headers,
172
182
  data: destinationCreate
173
183
  };
174
- return transporter.request(request, requestOptions);
184
+ return this.transporter.request(request, requestOptions);
175
185
  },
176
186
  /**
177
187
  * Creates a new source.
@@ -204,7 +214,7 @@ function createIngestionClient({
204
214
  headers,
205
215
  data: sourceCreate
206
216
  };
207
- return transporter.request(request, requestOptions);
217
+ return this.transporter.request(request, requestOptions);
208
218
  },
209
219
  /**
210
220
  * Creates a new task.
@@ -235,7 +245,7 @@ function createIngestionClient({
235
245
  headers,
236
246
  data: taskCreate
237
247
  };
238
- return transporter.request(request, requestOptions);
248
+ return this.transporter.request(request, requestOptions);
239
249
  },
240
250
  /**
241
251
  * Creates a new task using the v1 endpoint, please use `createTask` instead.
@@ -269,7 +279,7 @@ function createIngestionClient({
269
279
  headers,
270
280
  data: taskCreate
271
281
  };
272
- return transporter.request(request, requestOptions);
282
+ return this.transporter.request(request, requestOptions);
273
283
  },
274
284
  /**
275
285
  * Creates a new transformation.
@@ -297,7 +307,7 @@ function createIngestionClient({
297
307
  headers,
298
308
  data: transformationCreate
299
309
  };
300
- return transporter.request(request, requestOptions);
310
+ return this.transporter.request(request, requestOptions);
301
311
  },
302
312
  /**
303
313
  * This method allow you to send requests to the Algolia REST API.
@@ -320,7 +330,7 @@ function createIngestionClient({
320
330
  queryParameters,
321
331
  headers
322
332
  };
323
- return transporter.request(request, requestOptions);
333
+ return this.transporter.request(request, requestOptions);
324
334
  },
325
335
  /**
326
336
  * This method allow you to send requests to the Algolia REST API.
@@ -343,7 +353,7 @@ function createIngestionClient({
343
353
  queryParameters,
344
354
  headers
345
355
  };
346
- return transporter.request(request, requestOptions);
356
+ return this.transporter.request(request, requestOptions);
347
357
  },
348
358
  /**
349
359
  * This method allow you to send requests to the Algolia REST API.
@@ -368,7 +378,7 @@ function createIngestionClient({
368
378
  headers,
369
379
  data: body ? body : {}
370
380
  };
371
- return transporter.request(request, requestOptions);
381
+ return this.transporter.request(request, requestOptions);
372
382
  },
373
383
  /**
374
384
  * This method allow you to send requests to the Algolia REST API.
@@ -393,7 +403,7 @@ function createIngestionClient({
393
403
  headers,
394
404
  data: body ? body : {}
395
405
  };
396
- return transporter.request(request, requestOptions);
406
+ return this.transporter.request(request, requestOptions);
397
407
  },
398
408
  /**
399
409
  * Deletes an authentication resource. You can\'t delete authentication resources that are used by a source or a destination.
@@ -423,7 +433,7 @@ function createIngestionClient({
423
433
  queryParameters,
424
434
  headers
425
435
  };
426
- return transporter.request(request, requestOptions);
436
+ return this.transporter.request(request, requestOptions);
427
437
  },
428
438
  /**
429
439
  * Deletes a destination by its ID. You can\'t delete destinations that are referenced in tasks.
@@ -453,7 +463,7 @@ function createIngestionClient({
453
463
  queryParameters,
454
464
  headers
455
465
  };
456
- return transporter.request(request, requestOptions);
466
+ return this.transporter.request(request, requestOptions);
457
467
  },
458
468
  /**
459
469
  * Deletes a source by its ID. You can\'t delete sources that are referenced in tasks.
@@ -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.
@@ -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 task by its ID using the v1 endpoint, please use `deleteTask` instead.
@@ -524,7 +534,7 @@ function createIngestionClient({
524
534
  queryParameters,
525
535
  headers
526
536
  };
527
- return transporter.request(request, requestOptions);
537
+ return this.transporter.request(request, requestOptions);
528
538
  },
529
539
  /**
530
540
  * Deletes a transformation by its ID.
@@ -549,7 +559,7 @@ function createIngestionClient({
549
559
  queryParameters,
550
560
  headers
551
561
  };
552
- return transporter.request(request, requestOptions);
562
+ return this.transporter.request(request, requestOptions);
553
563
  },
554
564
  /**
555
565
  * Disables a task.
@@ -576,7 +586,7 @@ function createIngestionClient({
576
586
  queryParameters,
577
587
  headers
578
588
  };
579
- return transporter.request(request, requestOptions);
589
+ return this.transporter.request(request, requestOptions);
580
590
  },
581
591
  /**
582
592
  * Disables a task using the v1 endpoint, please use `disableTask` instead.
@@ -603,7 +613,7 @@ function createIngestionClient({
603
613
  queryParameters,
604
614
  headers
605
615
  };
606
- return transporter.request(request, requestOptions);
616
+ return this.transporter.request(request, requestOptions);
607
617
  },
608
618
  /**
609
619
  * Enables a task.
@@ -630,7 +640,7 @@ function createIngestionClient({
630
640
  queryParameters,
631
641
  headers
632
642
  };
633
- return transporter.request(request, requestOptions);
643
+ return this.transporter.request(request, requestOptions);
634
644
  },
635
645
  /**
636
646
  * Enables a task using the v1 endpoint, please use `enableTask` instead.
@@ -657,7 +667,7 @@ function createIngestionClient({
657
667
  queryParameters,
658
668
  headers
659
669
  };
660
- return transporter.request(request, requestOptions);
670
+ return this.transporter.request(request, requestOptions);
661
671
  },
662
672
  /**
663
673
  * Generates code for the selected model based on the given prompt.
@@ -696,7 +706,7 @@ function createIngestionClient({
696
706
  headers,
697
707
  data: generateTransformationCodePayload
698
708
  };
699
- return transporter.request(request, requestOptions);
709
+ return this.transporter.request(request, requestOptions);
700
710
  },
701
711
  /**
702
712
  * Retrieves an authentication resource by its ID.
@@ -726,7 +736,7 @@ function createIngestionClient({
726
736
  queryParameters,
727
737
  headers
728
738
  };
729
- return transporter.request(request, requestOptions);
739
+ return this.transporter.request(request, requestOptions);
730
740
  },
731
741
  /**
732
742
  * Retrieves a destination by its ID.
@@ -756,7 +766,7 @@ function createIngestionClient({
756
766
  queryParameters,
757
767
  headers
758
768
  };
759
- return transporter.request(request, requestOptions);
769
+ return this.transporter.request(request, requestOptions);
760
770
  },
761
771
  /**
762
772
  * Retrieves a single task run event by its ID.
@@ -787,7 +797,7 @@ function createIngestionClient({
787
797
  queryParameters,
788
798
  headers
789
799
  };
790
- return transporter.request(request, requestOptions);
800
+ return this.transporter.request(request, requestOptions);
791
801
  },
792
802
  /**
793
803
  * Retrieve a single task run by its ID.
@@ -814,7 +824,7 @@ function createIngestionClient({
814
824
  queryParameters,
815
825
  headers
816
826
  };
817
- return transporter.request(request, requestOptions);
827
+ return this.transporter.request(request, requestOptions);
818
828
  },
819
829
  /**
820
830
  * Retrieve a source by its ID.
@@ -841,7 +851,7 @@ function createIngestionClient({
841
851
  queryParameters,
842
852
  headers
843
853
  };
844
- return transporter.request(request, requestOptions);
854
+ return this.transporter.request(request, requestOptions);
845
855
  },
846
856
  /**
847
857
  * Retrieves a task by its ID.
@@ -868,7 +878,7 @@ function createIngestionClient({
868
878
  queryParameters,
869
879
  headers
870
880
  };
871
- return transporter.request(request, requestOptions);
881
+ return this.transporter.request(request, requestOptions);
872
882
  },
873
883
  /**
874
884
  * Retrieves a task by its ID using the v1 endpoint, please use `getTask` instead.
@@ -895,7 +905,7 @@ function createIngestionClient({
895
905
  queryParameters,
896
906
  headers
897
907
  };
898
- return transporter.request(request, requestOptions);
908
+ return this.transporter.request(request, requestOptions);
899
909
  },
900
910
  /**
901
911
  * Retrieves a transformation by its ID.
@@ -925,7 +935,7 @@ function createIngestionClient({
925
935
  queryParameters,
926
936
  headers
927
937
  };
928
- return transporter.request(request, requestOptions);
938
+ return this.transporter.request(request, requestOptions);
929
939
  },
930
940
  /**
931
941
  * Retrieves a list of all authentication resources.
@@ -972,7 +982,7 @@ function createIngestionClient({
972
982
  queryParameters,
973
983
  headers
974
984
  };
975
- return transporter.request(request, requestOptions);
985
+ return this.transporter.request(request, requestOptions);
976
986
  },
977
987
  /**
978
988
  * Retrieves a list of destinations.
@@ -1019,7 +1029,7 @@ function createIngestionClient({
1019
1029
  queryParameters,
1020
1030
  headers
1021
1031
  };
1022
- return transporter.request(request, requestOptions);
1032
+ return this.transporter.request(request, requestOptions);
1023
1033
  },
1024
1034
  /**
1025
1035
  * Retrieves a list of events for a task run, identified by it\'s ID.
@@ -1078,7 +1088,7 @@ function createIngestionClient({
1078
1088
  queryParameters,
1079
1089
  headers
1080
1090
  };
1081
- return transporter.request(request, requestOptions);
1091
+ return this.transporter.request(request, requestOptions);
1082
1092
  },
1083
1093
  /**
1084
1094
  * Retrieve a list of task runs.
@@ -1137,7 +1147,7 @@ function createIngestionClient({
1137
1147
  queryParameters,
1138
1148
  headers
1139
1149
  };
1140
- return transporter.request(request, requestOptions);
1150
+ return this.transporter.request(request, requestOptions);
1141
1151
  },
1142
1152
  /**
1143
1153
  * Retrieves a list of sources.
@@ -1184,7 +1194,7 @@ function createIngestionClient({
1184
1194
  queryParameters,
1185
1195
  headers
1186
1196
  };
1187
- return transporter.request(request, requestOptions);
1197
+ return this.transporter.request(request, requestOptions);
1188
1198
  },
1189
1199
  /**
1190
1200
  * Retrieves a list of tasks.
@@ -1243,7 +1253,7 @@ function createIngestionClient({
1243
1253
  queryParameters,
1244
1254
  headers
1245
1255
  };
1246
- return transporter.request(request, requestOptions);
1256
+ return this.transporter.request(request, requestOptions);
1247
1257
  },
1248
1258
  /**
1249
1259
  * Retrieves a list of tasks using the v1 endpoint, please use `getTasks` instead.
@@ -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 existing LLM transformation helpers.
@@ -1324,7 +1334,7 @@ function createIngestionClient({
1324
1334
  queryParameters,
1325
1335
  headers
1326
1336
  };
1327
- return transporter.request(request, requestOptions);
1337
+ return this.transporter.request(request, requestOptions);
1328
1338
  },
1329
1339
  /**
1330
1340
  * Retrieves a list of transformations.
@@ -1363,7 +1373,7 @@ function createIngestionClient({
1363
1373
  queryParameters,
1364
1374
  headers
1365
1375
  };
1366
- return transporter.request(request, requestOptions);
1376
+ return this.transporter.request(request, requestOptions);
1367
1377
  },
1368
1378
  /**
1369
1379
  * Push a `batch` request payload through the Pipeline. You can check the status of task pushes with the observability endpoints.
@@ -1401,7 +1411,7 @@ function createIngestionClient({
1401
1411
  headers,
1402
1412
  data: pushTaskPayload
1403
1413
  };
1404
- return transporter.request(request, requestOptions);
1414
+ return this.transporter.request(request, requestOptions);
1405
1415
  },
1406
1416
  /**
1407
1417
  * Runs all tasks linked to a source, only available for Shopify sources. It will create 1 run per task.
@@ -1430,7 +1440,7 @@ function createIngestionClient({
1430
1440
  headers,
1431
1441
  data: runSourcePayload ? runSourcePayload : {}
1432
1442
  };
1433
- return transporter.request(request, requestOptions);
1443
+ return this.transporter.request(request, requestOptions);
1434
1444
  },
1435
1445
  /**
1436
1446
  * Runs a task. You can check the status of task runs with the observability endpoints.
@@ -1457,7 +1467,7 @@ function createIngestionClient({
1457
1467
  queryParameters,
1458
1468
  headers
1459
1469
  };
1460
- return transporter.request(request, requestOptions);
1470
+ return this.transporter.request(request, requestOptions);
1461
1471
  },
1462
1472
  /**
1463
1473
  * Runs a task using the v1 endpoint, please use `runTask` instead. You can check the status of task runs with the observability endpoints.
@@ -1484,7 +1494,7 @@ function createIngestionClient({
1484
1494
  queryParameters,
1485
1495
  headers
1486
1496
  };
1487
- return transporter.request(request, requestOptions);
1497
+ return this.transporter.request(request, requestOptions);
1488
1498
  },
1489
1499
  /**
1490
1500
  * Searches for authentication resources.
@@ -1516,7 +1526,7 @@ function createIngestionClient({
1516
1526
  headers,
1517
1527
  data: authenticationSearch
1518
1528
  };
1519
- return transporter.request(request, requestOptions);
1529
+ return this.transporter.request(request, requestOptions);
1520
1530
  },
1521
1531
  /**
1522
1532
  * Searches for destinations.
@@ -1546,7 +1556,7 @@ function createIngestionClient({
1546
1556
  headers,
1547
1557
  data: destinationSearch
1548
1558
  };
1549
- return transporter.request(request, requestOptions);
1559
+ return this.transporter.request(request, requestOptions);
1550
1560
  },
1551
1561
  /**
1552
1562
  * Searches for sources.
@@ -1576,7 +1586,7 @@ function createIngestionClient({
1576
1586
  headers,
1577
1587
  data: sourceSearch
1578
1588
  };
1579
- return transporter.request(request, requestOptions);
1589
+ return this.transporter.request(request, requestOptions);
1580
1590
  },
1581
1591
  /**
1582
1592
  * Searches for tasks.
@@ -1606,7 +1616,7 @@ function createIngestionClient({
1606
1616
  headers,
1607
1617
  data: taskSearch
1608
1618
  };
1609
- return transporter.request(request, requestOptions);
1619
+ return this.transporter.request(request, requestOptions);
1610
1620
  },
1611
1621
  /**
1612
1622
  * Searches for tasks using the v1 endpoint, please use `searchTasks` instead.
@@ -1636,7 +1646,7 @@ function createIngestionClient({
1636
1646
  headers,
1637
1647
  data: taskSearch
1638
1648
  };
1639
- return transporter.request(request, requestOptions);
1649
+ return this.transporter.request(request, requestOptions);
1640
1650
  },
1641
1651
  /**
1642
1652
  * Searches for transformations.
@@ -1668,7 +1678,7 @@ function createIngestionClient({
1668
1678
  headers,
1669
1679
  data: transformationSearch
1670
1680
  };
1671
- return transporter.request(request, requestOptions);
1681
+ return this.transporter.request(request, requestOptions);
1672
1682
  },
1673
1683
  /**
1674
1684
  * Triggers a stream-listing request for a source. Triggering stream-listing requests only works with sources with `type: docker` and `imageType: singer`.
@@ -1695,7 +1705,7 @@ function createIngestionClient({
1695
1705
  queryParameters,
1696
1706
  headers
1697
1707
  };
1698
- return transporter.request(request, requestOptions);
1708
+ return this.transporter.request(request, requestOptions);
1699
1709
  },
1700
1710
  /**
1701
1711
  * Try a transformation before creating it.
@@ -1728,7 +1738,7 @@ function createIngestionClient({
1728
1738
  headers,
1729
1739
  data: transformationTry
1730
1740
  };
1731
- return transporter.request(request, requestOptions);
1741
+ return this.transporter.request(request, requestOptions);
1732
1742
  },
1733
1743
  /**
1734
1744
  * Try a transformation before updating it.
@@ -1771,7 +1781,7 @@ function createIngestionClient({
1771
1781
  headers,
1772
1782
  data: transformationTry
1773
1783
  };
1774
- return transporter.request(request, requestOptions);
1784
+ return this.transporter.request(request, requestOptions);
1775
1785
  },
1776
1786
  /**
1777
1787
  * Updates an authentication resource.
@@ -1806,7 +1816,7 @@ function createIngestionClient({
1806
1816
  headers,
1807
1817
  data: authenticationUpdate
1808
1818
  };
1809
- return transporter.request(request, requestOptions);
1819
+ return this.transporter.request(request, requestOptions);
1810
1820
  },
1811
1821
  /**
1812
1822
  * Updates the destination by its ID.
@@ -1841,7 +1851,7 @@ function createIngestionClient({
1841
1851
  headers,
1842
1852
  data: destinationUpdate
1843
1853
  };
1844
- return transporter.request(request, requestOptions);
1854
+ return this.transporter.request(request, requestOptions);
1845
1855
  },
1846
1856
  /**
1847
1857
  * Updates a source by its ID.
@@ -1873,7 +1883,7 @@ function createIngestionClient({
1873
1883
  headers,
1874
1884
  data: sourceUpdate
1875
1885
  };
1876
- return transporter.request(request, requestOptions);
1886
+ return this.transporter.request(request, requestOptions);
1877
1887
  },
1878
1888
  /**
1879
1889
  * Updates a task by its ID.
@@ -1900,7 +1910,7 @@ function createIngestionClient({
1900
1910
  headers,
1901
1911
  data: taskUpdate
1902
1912
  };
1903
- return transporter.request(request, requestOptions);
1913
+ return this.transporter.request(request, requestOptions);
1904
1914
  },
1905
1915
  /**
1906
1916
  * Updates a task by its ID using the v1 endpoint, please use `updateTask` instead.
@@ -1927,7 +1937,7 @@ function createIngestionClient({
1927
1937
  headers,
1928
1938
  data: taskUpdate
1929
1939
  };
1930
- return transporter.request(request, requestOptions);
1940
+ return this.transporter.request(request, requestOptions);
1931
1941
  },
1932
1942
  /**
1933
1943
  * Updates a transformation by its ID.
@@ -1963,7 +1973,7 @@ function createIngestionClient({
1963
1973
  headers,
1964
1974
  data: transformationCreate
1965
1975
  };
1966
- return transporter.request(request, requestOptions);
1976
+ return this.transporter.request(request, requestOptions);
1967
1977
  },
1968
1978
  /**
1969
1979
  * Validates a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -1987,7 +1997,7 @@ function createIngestionClient({
1987
1997
  headers,
1988
1998
  data: sourceCreate ? sourceCreate : {}
1989
1999
  };
1990
- return transporter.request(request, requestOptions);
2000
+ return this.transporter.request(request, requestOptions);
1991
2001
  },
1992
2002
  /**
1993
2003
  * Validates an update of a source payload to ensure it can be created and that the data source can be reached by Algolia.
@@ -2019,7 +2029,7 @@ function createIngestionClient({
2019
2029
  headers,
2020
2030
  data: sourceUpdate
2021
2031
  };
2022
- return transporter.request(request, requestOptions);
2032
+ return this.transporter.request(request, requestOptions);
2023
2033
  }
2024
2034
  };
2025
2035
  }