emissions-api-sdk 1.0.0 → 1.0.1

package/dist/api/Stationary.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculate = calculate;
+exports.getTypes = getTypes;
+exports.getArea = getArea;
+exports.getUnits = getUnits;
 const Client_1 = require("../Client");
 const Constants_1 = require("../Constants");
 const request_1 = require("../request");
@@ -14,20 +17,20 @@ const request_1 = require("../request");
  *
  * @example
  * const request = {
-             "time" : {
-                "date": "2025-01-04"
-            },
-            "location": {
-                "country": "usa",
-                                "stateProvince": "new york"
-            },
-            "activity": {
-                            "type":"Coal - Lignite",
-                            "unit": "KJ",
-                            "value": 3
-            },
-            "includeDetails": true
-      };
+    "time" : {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa",
+      "stateProvince": "new york"
+    },
+    "activity": {
+      "type":"Coal - Lignite",
+      "unit": "KJ",
+      "value": 3
+    },
+    "includeDetails": true
+  };
  * const result = await calculate(request);
  */
 async function calculate(payload) {
@@ -39,3 +42,63 @@ async function calculate(payload) {
         data: payload,
     });
 }
+/**
+ * Retrieves available stationary emission calculation types by making a GET request to the API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available stationary emission types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const types = await getTypes();
+ */
+async function getTypes() {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.STATIONARY_API_TYPES;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url
+    });
+}
+/**
+ * Retrieves information about geographical areas supported by the stationary emissions API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+async function getArea() {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.STATIONARY_API_AREA;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url
+    });
+}
+/**
+ * Retrieves available units for a specific stationary emission type.
+ *
+ * @export
+ * @param {string} type - The stationary emission type to get units for (e.g., "Coal - Lignite")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * Get units for the "Petroleum Based Greases - NC:A" emission stationary type with subtype
+ * const units = await getUnits("Petroleum Based Greases - NC:A");
+
+ * Get units for the "Jet Kerosene" emission stationary type without subtype
+ * const units = await getUnits("Jet Kerosene");
+ */
+async function getUnits(type) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.STATIONARY_API_UNITS;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url,
+        params: { type }
+    });
+}

package/dist/api/TransportationAndDistribution.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculate = calculate;
+exports.getTypes = getTypes;
+exports.getArea = getArea;
+exports.getUnits = getUnits;
 const Client_1 = require("../Client");
 const Constants_1 = require("../Constants");
 const request_1 = require("../request");
@@ -14,18 +17,18 @@ const request_1 = require("../request");
  *
  * @example
  * const request = {
-             "time" : {
-                "date": "2025-01-04"
-            },
-            "location": {
-                "country": "usa"
-            },
-            "activity": {
-                "type": "Freight - Cargo Ship - Bulk Carrier - 0-9999 dwt",
-                            "unit": ["t","km"],
-                            "value": [1.0,1.0]
-            },
-            "includeDetails": true
+    "time" : {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa"
+    },
+    "activity": {
+      "type": "Freight - Cargo Ship - Bulk Carrier - 0-9999 dwt",
+      "unit": ["t","km"],
+      "value": [1.0,1.0]
+    },
+    "includeDetails": true
   };
  * const result = await calculate(request);
  */
@@ -38,3 +41,63 @@ async function calculate(payload) {
         data: payload,
     });
 }
+/**
+ * Retrieves available transportation and distribution calculation types by making a GET request to the API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available transportation and distribution calculation types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const types = await getTypes();
+ */
+async function getTypes() {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.TRANSPORTATION_AND_DISTRIBUTION_API_TYPES;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url
+    });
+}
+/**
+ * Retrieves information about geographical areas supported by the transportation and distribution API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+async function getArea() {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.TRANSPORTATION_AND_DISTRIBUTION_API_AREA;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url
+    });
+}
+/**
+ * Retrieves available units for a specific transportation and distribution calculation type.
+ *
+ * @export
+ * @param {string} type - The transportation and distribution calculation type to get units for (e.g., "Freight - Cargo Ship")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get units for the "Business Travel - Cars:Diesel - Small" transportation and distribution type without subtype
+ * const units = await getUnits("Business Travel - Cars:Diesel - Small");
+ *
+ * // Get units for the "Business Travel - Cars" transportation and distribution type with subtype
+ * const units = await getUnits("Business Travel - Cars");
+ */
+async function getUnits(type) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.TRANSPORTATION_AND_DISTRIBUTION_API_UNITS;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url,
+        params: { type }
+    });
+}

package/dist/types/Constants.d.ts

@@ -9,6 +9,28 @@ export declare const TRANSPORTATION_AND_DISTRIBUTION_API_PATH = "/v3/carbon/tran
 export declare const FACTOR_API_PATH = "/v3/carbon/factor";
 export declare const FACTOR_SET_API_PATH = "/v3/carbon/factorset";
 export declare const SEARCH_API_PATH = "/v3/carbon/factor/search";
+export declare const CALCULATION_TYPES = "/v3/carbon/calculation/types";
+export declare const LOCATION_TYPES = "/v3/carbon/location/types";
+export declare const FUGITIVE_API_TYPES = "/v3/carbon/fugitive/types";
+export declare const MOBILE_API_TYPES = "/v3/carbon/mobile/types";
+export declare const STATIONARY_API_TYPES = "/v3/carbon/stationary/types";
+export declare const FACTOR_API_TYPES = "/v3/carbon/factor/types";
+export declare const TRANSPORTATION_AND_DISTRIBUTION_API_TYPES = "/v3/carbon/transportation-and-distribution/types";
+export declare const FUGITIVE_API_AREA = "/v3/carbon/fugitive/area";
+export declare const GENERAL_API_AREA = "/v3/carbon/calculation/area";
+export declare const LOCATION_API_AREA = "/v3/carbon/location/area";
+export declare const MOBILE_API_AREA = "/v3/carbon/mobile/area";
+export declare const STATIONARY_API_AREA = "/v3/carbon/stationary/area";
+export declare const TRANSPORTATION_AND_DISTRIBUTION_API_AREA = "/v3/carbon/transportation-and-distribution/area";
+export declare const SEARCH_API_AREA = "/v3/carbon/factor/search/area";
+export declare const FACTOR_API_AREA = "/v3/carbon/factor/area";
+export declare const FUGITIVE_API_UNITS = "/v3/carbon/fugitive/units";
+export declare const LOCATION_API_UNITS = "/v3/carbon/location/units";
+export declare const MOBILE_API_UNITS = "/v3/carbon/mobile/units";
+export declare const STATIONARY_API_UNITS = "/v3/carbon/stationary/units";
+export declare const GENERAL_API_UNITS = "/v3/carbon/calculation/units";
+export declare const FACTOR_API_UNITS = "/v3/carbon/factor/units";
+export declare const TRANSPORTATION_AND_DISTRIBUTION_API_UNITS = "/v3/carbon/transportation-and-distribution/units";
 export declare const GET = "GET";
 export declare const POST = "POST";
 export declare const CLIENT_SOURCE_HEADER = "X-Client-Source";

package/dist/types/api/Calculation.d.ts

@@ -9,20 +9,58 @@ import { CalculationRequest } from "../interfaces/Api";
  *
  * @example
  * const calculationRequest = {
-             "time" : {
-                "date": "2025-01-04"
-            },
-            "location": {
-                "country": "usa",
-                                "stateProvince": "new york"
-            },
-            "activity": {
-                            "type":"Waste Combusted - Steel Cans:Default factor",
-                            "unit": "kg",
-                            "value": 1223123.121
-            },
-            "includeDetails": true
-        };
+    "time" : {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa",
+      "stateProvince": "new york"
+    },
+    "activity": {
+      "type":"Waste Combusted - Steel Cans:Default factor",
+      "unit": "kg",
+      "value": 1223123.121
+    },
+    "includeDetails": true
+  };
  * const result = await calculate(calculationRequest);
  */
 export declare function calculate(payload: CalculationRequest): Promise<string>;
+/**
+ * Retrieves available calculation types by making a GET request to the calculation types API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available calculation types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const types = await getTypes();
+ */
+export declare function getTypes(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the calculation API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getArea(): Promise<string>;
+/**
+ * Retrieves available units for a specific calculation type.
+ *
+ * @export
+ * @param {string} type - The calculation type to get units for
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get units for the "Natural Gas - Scope 3:AAA" emission calculation type with subtype
+ * const units = await getUnits("Natural Gas - Scope 3:AAA");
+
+ * // Get units for the "HFC-263fb" emission calculation type without subtype
+ * const units = await getUnits("HFC-263fb");
+ */
+export declare function getUnits(type: string): Promise<string>;

package/dist/types/api/Factor.d.ts

@@ -9,27 +9,26 @@ import { FactorRequest, SearchRequest } from "../interfaces/Api";
  *
  * @example
  * const factorRequest = {
-    
     "activity": {
-         "factorId": 12345
+      "factorId": 12345
     }
   };
   
-  or
+  OR
 
   const factorRequest = {
-             "time" : {
-                "date": "2025-01-04"
-            },
-            "location": {
-                "country": "usa",
-                                "stateProvince": "new york"
-            },
-            "activity": {
-                            "type":"natural gas"
-            },
-            "includeDetails": true
-        };
+    "time" : {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa",
+      "stateProvince": "new york"
+    },
+    "activity": {
+      "type":"natural gas"
+    },
+    "includeDetails": true
+  };
  * const factor = await retrieveFactor(factorRequest);
  */
 export declare function retrieveFactor(payload: FactorRequest): Promise<string>;
@@ -48,10 +47,59 @@ export declare function retrieveFactor(payload: FactorRequest): Promise<string>;
     },
     "activity": {
       "search" : "travel"},
-  "location": {
+    "location": {
       "country": "USA"
     }
   };
  * const results = await search(searchRequest);
  */
 export declare function search(payload: SearchRequest): Promise<string>;
+/**
+ * Retrieves available emission factor types by making a GET request to the API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available emission factor types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const types = await getTypes();
+ */
+export declare function getTypes(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the factor search API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getSearchArea(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the factor API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getArea(): Promise<string>;
+/**
+ * Retrieves available units for a specific emission factor type.
+ *
+ * @export
+ * @param {string} type - The emission factor type to get units for (e.g., "Natural Gas - Scope 3:AAA")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get units for the "Natural Gas - Scope 3:AAA" emission factor type with subtype
+ * const units = await getUnits("Natural Gas - Scope 3:AAA");
+
+ * // Get units for the "HFC-263fb" emission factor type without subtype
+ * const units = await getUnits("HFC-263fb");
+ */
+export declare function getUnits(type: string): Promise<string>;

package/dist/types/api/Fugitive.d.ts

@@ -9,19 +9,57 @@ import { CommonRequest } from "../interfaces/Api";
  *
  * @example
  * const request = {
-      "time": {
-        "date": "2025-01-04"
-      },
-      "location": {
-        "country": "usa"
-      },
-      "activity": {
-        "type": "R134A",
-        "value": 150,
-        "unit": "kg"
-      },
-      "includeDetails": false
+    "time": {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa"
+    },
+    "activity": {
+      "type": "R134A",
+      "value": 150,
+      "unit": "kg"
+    },
+    "includeDetails": false
   };
  * const result = await calculate(request);
  */
 export declare function calculate(payload: CommonRequest): Promise<string>;
+/**
+ * Retrieves available fugitive emission calculation types by making a GET request to the API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available fugitive emission types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const types = await getTypes();
+ */
+export declare function getTypes(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the fugitive emissions API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getArea(): Promise<string>;
+/**
+ * Retrieves available units for a specific fugitive emission type.
+ *
+ * @export
+ * @param {string} type - The fugitive emission type to get units for (e.g., "R134A")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get units for the "Natural Gas - Scope 3:AAA" emission fugitive type with subtype
+ * const units = await getUnits("Natural Gas - Scope 3:AAA");
+
+ * // Get units for the "R-426A" emission fugitive type without subtype
+ * const units = await getUnits("R-426A");
+ */
+export declare function getUnits(type: string): Promise<string>;

package/dist/types/api/Location.d.ts

@@ -9,20 +9,56 @@ import { LocationRequest } from "../interfaces/Api";
  *
  * @example
  * const calculationRequest = {
-             "time" : {
-                "date": "2025-01-04"
-            },
-            "location": {
-                "country": "usa",
-                                "stateProvince": "new york"
-            },
-            "activity": {
-                            "type":"electricity",
-                            "unit": "kwh",
-                            "value": 14123143
-            },
-            "includeDetails": true
-        };
+    "time" : {
+      "date": "2025-01-04"
+    },
+    "location": {
+      "country": "usa",
+      "stateProvince": "new york"
+    },
+    "activity": {
+      "type":"electricity",
+      "unit": "kwh",
+      "value": 14123143
+    },
+    "includeDetails": true
+  };
  * const result = await calculate(calculationRequest);
  */
 export declare function calculate(payload: LocationRequest): Promise<string>;
+/**
+ * Retrieves available location-based calculation types by making a GET request to the location types API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available location-based calculation types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ *
+ * const types = await getTypes();
+ */
+export declare function getTypes(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the location-based calculation API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getArea(): Promise<string>;
+/**
+ * Retrieves available units for a specific location-based calculation type.
+ *
+ * @export
+ * @param {string} type - The location-based calculation type to get units for (e.g., "electricity")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get units for the "electricity" location type
+ * const units = await getUnits("electricity");
+ */
+export declare function getUnits(type: string): Promise<string>;

package/dist/types/api/Mobile.d.ts

@@ -26,3 +26,44 @@ import { CommonRequest } from "../interfaces/Api";
  * const result = await calculate(request);
  */
 export declare function calculate(payload: CommonRequest): Promise<string>;
+/**
+ * Retrieves available mobile emission calculation types by making a GET request to the API endpoint.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the available mobile emission types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get all available mobile emission types
+ * const types = await getTypes();
+ * const typesData = JSON.parse(types);
+ * console.log("Available mobile emission types:", typesData);
+ */
+export declare function getTypes(): Promise<string>;
+/**
+ * Retrieves information about geographical areas supported by the mobile emissions API.
+ *
+ * @export
+ * @return {Promise<string>} A promise that resolves to a string containing the supported geographical areas
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * const areas = await getArea();
+ */
+export declare function getArea(): Promise<string>;
+/**
+ * Retrieves available units for a specific mobile emission type.
+ *
+ * @export
+ * @param {string} type - The mobile emission type to get units for (e.g., "Diesel Fuel")
+ * @return {Promise<string>} A promise that resolves to a string containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * Get units for the "Cars:B20:(NE)" emission mobile type with subtype
+ * const units = await getUnits("Cars:B20:(NE)");
+
+ * Get units for the "Cars by Size - Large Car - Hybrid" emission mobile type without subtype
+ * const units = await getUnits("Cars by Size - Large Car - Hybrid");
+ */
+export declare function getUnits(type: string): Promise<string>;