emissions-api-sdk 1.0.0 → 1.0.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.
Files changed (129) hide show
  1. package/README.md +33 -2
  2. package/dist/Constants.js +23 -1
  3. package/dist/api/Calculation.js +77 -14
  4. package/dist/api/Factor.js +97 -16
  5. package/dist/api/Fugitive.js +75 -12
  6. package/dist/api/Location.js +75 -14
  7. package/dist/api/Mobile.js +66 -0
  8. package/dist/api/Stationary.js +77 -14
  9. package/dist/api/TransportationAndDistribution.js +75 -12
  10. package/dist/types/Constants.d.ts +22 -0
  11. package/dist/types/api/Calculation.d.ts +52 -14
  12. package/dist/types/api/Factor.d.ts +64 -16
  13. package/dist/types/api/Fugitive.d.ts +50 -12
  14. package/dist/types/api/Location.d.ts +50 -14
  15. package/dist/types/api/Mobile.d.ts +41 -0
  16. package/dist/types/api/Stationary.d.ts +52 -14
  17. package/dist/types/api/TransportationAndDistribution.d.ts +50 -12
  18. package/docs/.nojekyll +0 -0
  19. package/docs/_sources/authentication.rst.txt +164 -0
  20. package/docs/_sources/client.rst.txt +137 -0
  21. package/docs/_sources/getting_started.rst.txt +164 -0
  22. package/docs/_sources/index.rst.txt +29 -0
  23. package/docs/_sources/reference.rst.txt +129 -0
  24. package/docs/_sources/sdk.rst.txt +13 -0
  25. package/docs/_static/basic.css +906 -0
  26. package/docs/_static/custom.css +16 -0
  27. package/docs/_static/debug.css +69 -0
  28. package/docs/_static/doctools.js +149 -0
  29. package/docs/_static/documentation_options.js +13 -0
  30. package/docs/_static/file.png +0 -0
  31. package/docs/_static/language_data.js +192 -0
  32. package/docs/_static/minus.png +0 -0
  33. package/docs/_static/plus.png +0 -0
  34. package/docs/_static/pygments.css +250 -0
  35. package/docs/_static/scripts/furo-extensions.js +0 -0
  36. package/docs/_static/scripts/furo.js +3 -0
  37. package/docs/_static/scripts/furo.js.LICENSE.txt +7 -0
  38. package/docs/_static/scripts/furo.js.map +1 -0
  39. package/docs/_static/searchtools.js +635 -0
  40. package/docs/_static/skeleton.css +296 -0
  41. package/docs/_static/sphinx_highlight.js +154 -0
  42. package/docs/_static/sphinx_js.css +0 -0
  43. package/docs/_static/styles/furo-extensions.css +2 -0
  44. package/docs/_static/styles/furo-extensions.css.map +1 -0
  45. package/docs/_static/styles/furo.css +2 -0
  46. package/docs/_static/styles/furo.css.map +1 -0
  47. package/docs/authentication.html +513 -0
  48. package/docs/client.html +467 -0
  49. package/docs/genindex.html +482 -0
  50. package/docs/getting_started.html +481 -0
  51. package/docs/index.html +334 -0
  52. package/docs/objects.inv +0 -0
  53. package/docs/reference.html +1568 -0
  54. package/docs/sdk.html +324 -0
  55. package/docs/search.html +287 -0
  56. package/docs/searchindex.js +1 -0
  57. package/package.json +1 -1
  58. package/sphinx-build/Makefile +49 -0
  59. package/sphinx-build/source/_static/custom.css +16 -0
  60. package/sphinx-build/source/authentication.rst +164 -0
  61. package/sphinx-build/source/client.rst +137 -0
  62. package/sphinx-build/source/conf.py +56 -0
  63. package/sphinx-build/source/getting_started.rst +164 -0
  64. package/sphinx-build/source/index.rst +29 -0
  65. package/sphinx-build/source/reference.rst +129 -0
  66. package/sphinx-build/source/sdk.rst +13 -0
  67. package/src/Constants.ts +26 -0
  68. package/src/api/Calculation.ts +84 -15
  69. package/src/api/Factor.ts +108 -19
  70. package/src/api/Fugitive.ts +83 -13
  71. package/src/api/Location.ts +84 -15
  72. package/src/api/Mobile.ts +75 -1
  73. package/src/api/Stationary.ts +85 -15
  74. package/src/api/TransportationAndDistribution.ts +84 -13
  75. package/test/apiTest.test.ts +172 -5
  76. package/dist/api/Factors.js +0 -98
  77. package/dist/api/FugitiveEmission.js +0 -40
  78. package/dist/api/GenericCalculation.js +0 -41
  79. package/dist/api/LocationEmission.js +0 -41
  80. package/dist/api/MobileEmission.js +0 -41
  81. package/dist/api/StationaryEmission.js +0 -41
  82. package/dist/api/TransportationDistributionEmission.js +0 -40
  83. package/dist/coverage/clover.xml +0 -225
  84. package/dist/coverage/coverage-final.json +0 -19
  85. package/dist/coverage/lcov-report/base.css +0 -224
  86. package/dist/coverage/lcov-report/block-navigation.js +0 -87
  87. package/dist/coverage/lcov-report/favicon.png +0 -0
  88. package/dist/coverage/lcov-report/index.html +0 -161
  89. package/dist/coverage/lcov-report/prettify.css +0 -1
  90. package/dist/coverage/lcov-report/prettify.js +0 -2
  91. package/dist/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  92. package/dist/coverage/lcov-report/sorter.js +0 -210
  93. package/dist/coverage/lcov-report/src/Client.ts.html +0 -838
  94. package/dist/coverage/lcov-report/src/Constants.ts.html +0 -130
  95. package/dist/coverage/lcov-report/src/api/Calculation.ts.html +0 -217
  96. package/dist/coverage/lcov-report/src/api/Factor.ts.html +0 -343
  97. package/dist/coverage/lcov-report/src/api/FactorSets.ts.html +0 -154
  98. package/dist/coverage/lcov-report/src/api/Factors.ts.html +0 -403
  99. package/dist/coverage/lcov-report/src/api/Fugitive.ts.html +0 -214
  100. package/dist/coverage/lcov-report/src/api/FugitiveEmission.ts.html +0 -214
  101. package/dist/coverage/lcov-report/src/api/GenericCalculation.ts.html +0 -217
  102. package/dist/coverage/lcov-report/src/api/Location.ts.html +0 -214
  103. package/dist/coverage/lcov-report/src/api/LocationEmission.ts.html +0 -214
  104. package/dist/coverage/lcov-report/src/api/Mobile.ts.html +0 -220
  105. package/dist/coverage/lcov-report/src/api/MobileEmission.ts.html +0 -220
  106. package/dist/coverage/lcov-report/src/api/Stationary.ts.html +0 -220
  107. package/dist/coverage/lcov-report/src/api/StationaryEmission.ts.html +0 -220
  108. package/dist/coverage/lcov-report/src/api/TransportationAndDistribution.ts.html +0 -211
  109. package/dist/coverage/lcov-report/src/api/TransportationDistributionEmission.ts.html +0 -211
  110. package/dist/coverage/lcov-report/src/api/index.html +0 -221
  111. package/dist/coverage/lcov-report/src/index.html +0 -161
  112. package/dist/coverage/lcov-report/src/request.ts.html +0 -235
  113. package/dist/coverage/lcov-report/src/utils.ts.html +0 -139
  114. package/dist/coverage/lcov-report/test/index.html +0 -116
  115. package/dist/coverage/lcov-report/test/mocks/CommonRequest.ts.html +0 -142
  116. package/dist/coverage/lcov-report/test/mocks/FactorRequest.ts.html +0 -133
  117. package/dist/coverage/lcov-report/test/mocks/GenericCalculationRequest.ts.html +0 -142
  118. package/dist/coverage/lcov-report/test/mocks/LocationRequest.ts.html +0 -139
  119. package/dist/coverage/lcov-report/test/mocks/SearchRequest.ts.html +0 -142
  120. package/dist/coverage/lcov-report/test/mocks/index.html +0 -176
  121. package/dist/coverage/lcov-report/test/testUtils.ts.html +0 -97
  122. package/dist/coverage/lcov.info +0 -404
  123. package/dist/types/api/Factors.d.ts +0 -68
  124. package/dist/types/api/FugitiveEmission.d.ts +0 -27
  125. package/dist/types/api/GenericCalculation.d.ts +0 -28
  126. package/dist/types/api/LocationEmission.d.ts +0 -28
  127. package/dist/types/api/MobileEmission.d.ts +0 -28
  128. package/dist/types/api/StationaryEmission.d.ts +0 -28
  129. package/dist/types/api/TransportationDistributionEmission.d.ts +0 -27
@@ -1,68 +0,0 @@
1
- import { FactorRequest, SearchRequest } from "../interfaces/Api";
2
- /**
3
- * Retrieves a factor details by making a POST request to the factor API endpoint.
4
- *
5
- * @export
6
- * @param {FactorRequest} payload - The factor request data to be sent to the API
7
- * @return {Promise<string>} A promise that resolves to the factor string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const factorRequest = {
12
-
13
- "activity": {
14
- "factorId": 12345
15
- }
16
- };
17
-
18
- or
19
-
20
- const factorRequest = {
21
- "time" : {
22
- "date": "2025-01-04"
23
- },
24
- "location": {
25
- "country": "usa",
26
- "stateProvince": "new york"
27
- },
28
- "activity": {
29
- "type":"natural gas"
30
- },
31
- "includeDetails": true
32
- };
33
- * const factor = await retrieveFactor(factorRequest);
34
- */
35
- export declare function retrieveFactor(payload: FactorRequest): Promise<string>;
36
- /**
37
- * Retrieves factor sets by making a GET request to the factor set API endpoint.
38
- *
39
- * @export
40
- * @return {Promise<string>} A promise that resolves to the factor sets string returned by the API
41
- * @throws {Error} May throw an error if the API request fails
42
- *
43
- * @example
44
- * const factorSets = await getFactorSets();
45
- */
46
- export declare function getFactorSets(): Promise<string>;
47
- /**
48
- * Performs a search operation by making a POST request to the search API endpoint.
49
- *
50
- * @export
51
- * @param {SearchRequest} payload - The search request data to be sent to the API
52
- * @return {Promise<string>} A promise that resolves to the search results string returned by the API
53
- * @throws {Error} May throw an error if the API request fails
54
- *
55
- * @example
56
- * const searchRequest = {
57
- "time":{
58
- "date": "2020-06-10"
59
- },
60
- "activity": {
61
- "search" : "travel"},
62
- "location": {
63
- "country": "USA"
64
- }
65
- };
66
- * const results = await Search(searchRequest);
67
- */
68
- export declare function Search(payload: SearchRequest): Promise<string>;
@@ -1,27 +0,0 @@
1
- import { CommonRequest } from "../interfaces/Api";
2
- /**
3
- * Performs scope 1 fugitve emission calculations by making a POST request to the fugitive API endpoint.
4
- *
5
- * @export
6
- * @param {CommonRequest} payload - The request data to be sent to the API
7
- * @return {Promise<string>} A promise that resolves to the calculation result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const request = {
12
- "time": {
13
- "date": "2025-01-04"
14
- },
15
- "location": {
16
- "country": "usa"
17
- },
18
- "activity": {
19
- "type": "R134A",
20
- "value": 150,
21
- "unit": "kg"
22
- },
23
- "includeDetails": false
24
- };
25
- * const result = await calculate(request);
26
- */
27
- export declare function calculate(payload: CommonRequest): Promise<string>;
@@ -1,28 +0,0 @@
1
- import { GenericCalculationRequest } from "../interfaces/Api";
2
- /**
3
- * Performs emission calculations by making a POST request to the generic calculation API endpoint.
4
- *
5
- * @export
6
- * @param {GenericCalculationRequest} payload - The calculation request data to be sent to the API
7
- * @return {Promise<string>} A promise that resolves to the calculation result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const calculationRequest = {
12
- "time" : {
13
- "date": "2025-01-04"
14
- },
15
- "location": {
16
- "country": "usa",
17
- "stateProvince": "new york"
18
- },
19
- "activity": {
20
- "type":"Waste Combusted - Steel Cans:Default factor",
21
- "unit": "kg",
22
- "value": 1223123.121
23
- },
24
- "includeDetails": true
25
- };
26
- * const result = await calculate(calculationRequest);
27
- */
28
- export declare function calculate(payload: GenericCalculationRequest): Promise<string>;
@@ -1,28 +0,0 @@
1
- import { LocationRequest } from "../interfaces/Api";
2
- /**
3
- * Performs scope 2 purchased energy Emission calculations by making a POST request to the location API endpoint.
4
- *
5
- * @export
6
- * @param {LocationRequest} payload - The location request data to be sent to the API
7
- * @return {Promise<string>} A promise that resolves to the purchased energy emission result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const calculationRequest = {
12
- "time" : {
13
- "date": "2025-01-04"
14
- },
15
- "location": {
16
- "country": "usa",
17
- "stateProvince": "new york"
18
- },
19
- "activity": {
20
- "type":"electricity",
21
- "unit": "kwh",
22
- "value": 14123143
23
- },
24
- "includeDetails": true
25
- };
26
- * const result = await calculate(calculationRequest);
27
- */
28
- export declare function calculate(payload: LocationRequest): Promise<string>;
@@ -1,28 +0,0 @@
1
- import { CommonRequest } from "../interfaces/Api";
2
- /**
3
- * Performs Scope 1 mobile emissions related calculations by making a POST request to the mobile API endpoint.
4
- *
5
- * @export
6
- * @param {CommonRequest} payload - The request data to be sent to the mobile API
7
- * @return {Promise<string>} A promise that resolves to the calculation result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const request = {
12
- "time": {
13
- "date": "2022-01-01"
14
- },
15
- "location": {
16
- "country": "USA",
17
- "stateProvince": "new york"
18
- },
19
- "activity": {
20
- "type": "Diesel Fuel",
21
- "value": 1500000,
22
- "unit": "l"
23
- },
24
- "includeDetails": false
25
- };
26
- * const result = await calculate(request);
27
- */
28
- export declare function calculate(payload: CommonRequest): Promise<string>;
@@ -1,28 +0,0 @@
1
- import { CommonRequest } from "../interfaces/Api";
2
- /**
3
- * Performs Scope 1 stationary calculations by making a POST request to the stationary API endpoint.
4
- *
5
- * @export
6
- * @param {CommonRequest} payload - The request data to be sent to the stationary API
7
- * @return {Promise<string>} A promise that resolves to the calculation result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const request = {
12
- "time" : {
13
- "date": "2025-01-04"
14
- },
15
- "location": {
16
- "country": "usa",
17
- "stateProvince": "new york"
18
- },
19
- "activity": {
20
- "type":"Coal - Lignite",
21
- "unit": "KJ",
22
- "value": 3
23
- },
24
- "includeDetails": true
25
- };
26
- * const result = await calculate(request);
27
- */
28
- export declare function calculate(payload: CommonRequest): Promise<string>;
@@ -1,27 +0,0 @@
1
- import { GenericCalculationRequest } from "../interfaces/Api";
2
- /**
3
- * Performs Scope 2 transportation and distribution emission calculations by making a POST request to the transportation and distribution API endpoint.
4
- *
5
- * @export
6
- * @param {GenericCalculationRequest} payload - The calculation request data for transportation and distribution operations
7
- * @return {Promise<string>} A promise that resolves to the calculation result string returned by the API
8
- * @throws {Error} May throw an error if the API request fails
9
- *
10
- * @example
11
- * const request = {
12
- "time" : {
13
- "date": "2025-01-04"
14
- },
15
- "location": {
16
- "country": "usa"
17
- },
18
- "activity": {
19
- "type": "Freight - Cargo Ship - Bulk Carrier - 0-9999 dwt",
20
- "unit": ["t","km"],
21
- "value": [1.0,1.0]
22
- },
23
- "includeDetails": true
24
- };
25
- * const result = await calculate(request);
26
- */
27
- export declare function calculate(payload: GenericCalculationRequest): Promise<string>;