emissions-api-sdk 1.0.5 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # IBM Envizi - Emissions API Node.js SDK
 
-IBM Envizi - Emissions API (Emissions API) is a managed factor database and calculation engine for embedding greenhouse gas (GHG) emissions calculations into operational decision making.
+[IBM Envizi - Emissions API](https://www.ibm.com/products/envizi/emissions-api) (Emissions API) is a managed factor database and calculation engine for embedding greenhouse gas (GHG) emissions calculations into operational decision making.
 
 The `emissions-api-sdk` is a Node.js SDK for using Emissions API in your projects.
 
@@ -8,7 +8,7 @@ The `emissions-api-sdk` is a Node.js SDK for using Emissions API in your project
 
 To get started with the Emissions API follow these steps:
 
-- Sign up for the preview waitlist [IBMid sign up](https://www.ibm.com/account/reg/us-en/signup?formid=urx-53659) page.
+- Sign up for the preview waitlist [IBMid sign up](https://www.ibm.com/account/reg/us-en/signup?formid=urx-53999) page.
 - You will be sent an invite email to join to create an account.
 - Read the [Introduction](https://developer.ibm.com/apis/catalog/ghgemissions--ibm-envizi-emissions-api/Introduction) page to get an overview of the Emissions API.
 
@@ -48,42 +48,35 @@ const result = await LocationEmission.calculate({
 
 ## Metadata APIs
 
-The SDK provides Metadata APIs to discover available emission types, geographical areas, and units:
-
-### Get Available Types
+The Metadata API provides a unified way to query metadata for any endpoint:
 
 ```javascript
-import { LocationEmission } from 'emissions-api-sdk';
-
-// Get all available Location emission types
-const types = await LocationEmission.getTypes();
-```
+import { Metadata } from 'emissions-api-sdk';
 
-### Get Supported Areas
+// Get types for any endpoint (defaults to 'calculation')
+const allTypes = await Metadata.getTypes();
+const locationTypes = await Metadata.getTypes('location');
+const stationaryTypes = await Metadata.postTypes('stationary');
 
-```javascript
-import { LocationEmission } from 'emissions-api-sdk';
+// Get areas for any endpoint
+const allAreas = await Metadata.getArea();
+const mobileAreas = await Metadata.getArea('mobile');
+const fugitiveAreas = await Metadata.postArea('fugitive');
 
-// Get supported geographical areas
-const areas = await LocationEmission.getArea();
+// Get units for any type
+const allUnits = await Metadata.getUnits(); // All units
+const typeUnits = await Metadata.getUnits('Natural Gas'); // Units for specific type
 ```
 
-### Get Valid Units
-
-```javascript
-import { LocationEmission } from 'emissions-api-sdk';
-
-// Get valid units for a specific emission type
-const units = await LocationEmission.getUnits("electricity");
-```
+**Supported endpoints**: `calculation`, `location`, `stationary`, `mobile`, `fugitive`, `factor`, `search`, `transportation-and-distribution`, `economic-activity`, `real-estate`
 
 ### Get Organization Usage
 ```javascript
 import { Usage } from 'emissions-api-sdk';
 
-// Retrieves current billing period or historical usage data for the Organization 
+// Retrieves current billing period or historical usage data for the Organization
 // History Flag to retrieve current billing or historical usage data.
-const units = await Usage.getUsage(true);
+const usage = await Usage.getUsage(true);
 ```
 
 ## Authentication
@@ -126,4 +119,4 @@ Other resources:
 
 ## License
 
-This project is licensed under the terms of the [LICENSE](LICENSE) file.
+This project is licensed under the terms of the [LICENSE](LICENSE) file.

package/dist/Constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLIENT_SOURCE_SDK = exports.CLIENT_SOURCE_EXCEL = exports.CLIENT_SOURCE_HEADER = exports.POST = exports.GET = exports.USAGE_API = exports.ECONOMIC_ACTIVITY_API_UNITS = exports.REAL_ESTATE_API_UNITS = exports.TRANSPORTATION_AND_DISTRIBUTION_API_UNITS = exports.FACTOR_API_UNITS = exports.GENERAL_API_UNITS = exports.STATIONARY_API_UNITS = exports.MOBILE_API_UNITS = exports.LOCATION_API_UNITS = exports.FUGITIVE_API_UNITS = exports.ECONOMIC_ACTIVITY_API_AREA = exports.REAL_ESTATE_API_AREA = exports.FACTOR_API_AREA = exports.SEARCH_API_AREA = exports.TRANSPORTATION_AND_DISTRIBUTION_API_AREA = exports.STATIONARY_API_AREA = exports.MOBILE_API_AREA = exports.LOCATION_API_AREA = exports.GENERAL_API_AREA = exports.FUGITIVE_API_AREA = exports.ECONOMIC_ACTIVITY_API_TYPES = exports.REAL_ESTATE_API_TYPES = exports.TRANSPORTATION_AND_DISTRIBUTION_API_TYPES = exports.FACTOR_API_TYPES = exports.STATIONARY_API_TYPES = exports.MOBILE_API_TYPES = exports.FUGITIVE_API_TYPES = exports.LOCATION_TYPES = exports.CALCULATION_TYPES = exports.REAL_ESTATE_API_PATH = exports.ECONOMIC_ACTIVITY_API_PATH = exports.SEARCH_API_PATH = exports.FACTOR_SET_API_PATH = exports.FACTOR_API_PATH = exports.TRANSPORTATION_AND_DISTRIBUTION_API_PATH = exports.GENERIC_CALCULATION_API_PATH = exports.STATIONARY_API_PATH = exports.FUGITIVE_API_PATH = exports.LOCATION_API_PATH = exports.MOBILE_API_PATH = exports.TOKEN_GENERATION_API = exports.API_DOMAIN = void 0;
+exports.CLIENT_SOURCE_SDK = exports.CLIENT_SOURCE_EXCEL = exports.CLIENT_SOURCE_HEADER = exports.POST = exports.GET = exports.METADATA_UNITS_ENDPOINT = exports.METADATA_AREA_ENDPOINT = exports.METADATA_TYPES_ENDPOINT = exports.USAGE_API = exports.REAL_ESTATE_API_PATH = exports.ECONOMIC_ACTIVITY_API_PATH = exports.SEARCH_API_PATH = exports.FACTOR_SET_API_PATH = exports.FACTOR_API_PATH = exports.TRANSPORTATION_AND_DISTRIBUTION_API_PATH = exports.GENERIC_CALCULATION_API_PATH = exports.STATIONARY_API_PATH = exports.FUGITIVE_API_PATH = exports.LOCATION_API_PATH = exports.MOBILE_API_PATH = exports.TOKEN_GENERATION_API = exports.API_DOMAIN = void 0;
 exports.API_DOMAIN = "https://api.ibm.com/ghgemissions/run";
 exports.TOKEN_GENERATION_API = "https://api.ibm.com/saascore/run/authentication-retrieve/api-key";
 exports.MOBILE_API_PATH = "/v3/carbon/mobile";
@@ -14,35 +14,10 @@ exports.FACTOR_SET_API_PATH = "/v3/carbon/factorset";
 exports.SEARCH_API_PATH = "/v3/carbon/factor/search";
 exports.ECONOMIC_ACTIVITY_API_PATH = "/v3/carbon/economic-activity";
 exports.REAL_ESTATE_API_PATH = "/v3/carbon/real-estate";
-exports.CALCULATION_TYPES = "/v3/carbon/calculation/types";
-exports.LOCATION_TYPES = "/v3/carbon/location/types";
-exports.FUGITIVE_API_TYPES = "/v3/carbon/fugitive/types";
-exports.MOBILE_API_TYPES = "/v3/carbon/mobile/types";
-exports.STATIONARY_API_TYPES = "/v3/carbon/stationary/types";
-exports.FACTOR_API_TYPES = "/v3/carbon/factor/types";
-exports.TRANSPORTATION_AND_DISTRIBUTION_API_TYPES = "/v3/carbon/transportation-and-distribution/types";
-exports.REAL_ESTATE_API_TYPES = "/v3/carbon/real-estate/types";
-exports.ECONOMIC_ACTIVITY_API_TYPES = "/v3/carbon/economic-activity/types";
-exports.FUGITIVE_API_AREA = "/v3/carbon/fugitive/area";
-exports.GENERAL_API_AREA = "/v3/carbon/calculation/area";
-exports.LOCATION_API_AREA = "/v3/carbon/location/area";
-exports.MOBILE_API_AREA = "/v3/carbon/mobile/area";
-exports.STATIONARY_API_AREA = "/v3/carbon/stationary/area";
-exports.TRANSPORTATION_AND_DISTRIBUTION_API_AREA = "/v3/carbon/transportation-and-distribution/area";
-exports.SEARCH_API_AREA = "/v3/carbon/factor/search/area";
-exports.FACTOR_API_AREA = "/v3/carbon/factor/area";
-exports.REAL_ESTATE_API_AREA = "/v3/carbon/real-estate/area";
-exports.ECONOMIC_ACTIVITY_API_AREA = "/v3/carbon/economic-activity/area";
-exports.FUGITIVE_API_UNITS = "/v3/carbon/fugitive/units";
-exports.LOCATION_API_UNITS = "/v3/carbon/location/units";
-exports.MOBILE_API_UNITS = "/v3/carbon/mobile/units";
-exports.STATIONARY_API_UNITS = "/v3/carbon/stationary/units";
-exports.GENERAL_API_UNITS = "/v3/carbon/calculation/units";
-exports.FACTOR_API_UNITS = "/v3/carbon/factor/units";
-exports.TRANSPORTATION_AND_DISTRIBUTION_API_UNITS = "/v3/carbon/transportation-and-distribution/units";
-exports.REAL_ESTATE_API_UNITS = "/v3/carbon/real-estate/units";
-exports.ECONOMIC_ACTIVITY_API_UNITS = "/v3/carbon/economic-activity/units";
 exports.USAGE_API = "/v3/carbon/usage";
+exports.METADATA_TYPES_ENDPOINT = "/v3/carbon/metadata/types";
+exports.METADATA_AREA_ENDPOINT = "/v3/carbon/metadata/area";
+exports.METADATA_UNITS_ENDPOINT = "/v3/carbon/metadata/units";
 exports.GET = "GET";
 exports.POST = "POST";
 exports.CLIENT_SOURCE_HEADER = "X-Client-Source";

package/dist/api/Calculation.js

@@ -1,9 +1,6 @@
 "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");
@@ -42,63 +39,3 @@ async function calculate(payload) {
         data: payload,
     });
 }
-/**
- * Retrieves available calculation types by making a GET request to the calculation types API endpoint.
- *
- * @export
- * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available 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.CALCULATION_TYPES;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the calculation API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse 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.GENERAL_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves available units for a specific calculation type.
- *
- * @export
- * @param {string} type - The calculation type to get units for
- * @return {Promise<UnitResponse>} A promise that resolves to a UnitResponse 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");
- */
-async function getUnits(type) {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.GENERAL_API_UNITS;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url,
-        params: { type }
-    });
-}

package/dist/api/EconomicActivity.js

@@ -1,9 +1,6 @@
 "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");
@@ -41,60 +38,3 @@ async function calculate(payload) {
         data: payload,
     });
 }
-/**
- * Retrieves available economic activity emission calculation types by making a GET request to the API endpoint.
- *
- * @export
- * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available economic activity 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.ECONOMIC_ACTIVITY_API_TYPES;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the economic activity emissions API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse 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.ECONOMIC_ACTIVITY_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves available units for a specific economic activity emission type.
- *
- * @export
- * @param {string} type - The economic activity emission type to get units for (e.g., "accomodation")
- * @return {Promise<UnitResponse>} A promise that resolves to a UnitResponse containing the available units
- * @throws {Error} May throw an error if the API request fails
- *
- * @example
- * // Get units for the "accomodation" emission economic activity type without subtype
- * const units = await getUnits("accomodation");
- */
-async function getUnits(type) {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.ECONOMIC_ACTIVITY_API_UNITS;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url,
-        params: { type }
-    });
-}

package/dist/api/Factor.js

@@ -2,10 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.retrieveFactor = retrieveFactor;
 exports.search = search;
-exports.getTypes = getTypes;
-exports.getSearchArea = getSearchArea;
-exports.getArea = getArea;
-exports.getUnits = getUnits;
 const Client_1 = require("../Client");
 const Constants_1 = require("../Constants");
 const request_1 = require("../request");
@@ -80,81 +76,3 @@ async function search(payload) {
         data: payload,
     });
 }
-/**
- * Retrieves available emission factor types by making a GET request to the API endpoint.
- *
- * @export
- * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available emission factor 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.FACTOR_API_TYPES;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the factor search API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse containing the supported geographical areas
- * @throws {Error} May throw an error if the API request fails
- *
- * @example
- * const areas = await getSearchArea();
- */
-async function getSearchArea() {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.SEARCH_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the factor API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse 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.FACTOR_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * 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<UnitResponse>} A promise that resolves to a UnitResponse 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");
- */
-async function getUnits(type) {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.FACTOR_API_UNITS;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url,
-        params: { type }
-    });
-}

package/dist/api/Fugitive.js

@@ -1,9 +1,6 @@
 "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");
@@ -41,63 +38,3 @@ async function calculate(payload) {
         data: payload,
     });
 }
-/**
- * Retrieves available fugitive emission calculation types by making a GET request to the API endpoint.
- *
- * @export
- * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available fugitive 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.FUGITIVE_API_TYPES;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the fugitive emissions API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse 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.FUGITIVE_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * 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<UnitResponse>} A promise that resolves to a UnitResponse 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");
- */
-async function getUnits(type) {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.FUGITIVE_API_UNITS;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url,
-        params: { type }
-    });
-}

package/dist/api/Location.js

@@ -1,9 +1,6 @@
 "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");
@@ -42,61 +39,3 @@ async function calculate(payload) {
         data: payload,
     });
 }
-/**
- * Retrieves available location-based calculation types by making a GET request to the location types API endpoint.
- *
- * @export
- * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available location-based 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.LOCATION_TYPES;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * Retrieves information about geographical areas supported by the location-based calculation API.
- *
- * @export
- * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse 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.LOCATION_API_AREA;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url
-    });
-}
-/**
- * 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<UnitResponse>} A promise that resolves to a UnitResponse 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");
- */
-async function getUnits(type) {
-    const client = Client_1.Client.getInstance();
-    const url = client.getDomain() + Constants_1.LOCATION_API_UNITS;
-    return (0, request_1.makeApiRequest)({
-        method: Constants_1.GET,
-        url,
-        params: { type }
-    });
-}

package/dist/api/Metadata.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTypes = getTypes;
+exports.postTypes = postTypes;
+exports.getArea = getArea;
+exports.postArea = postArea;
+exports.getUnits = getUnits;
+exports.postUnits = postUnits;
+const Client_1 = require("../Client");
+const Constants_1 = require("../Constants");
+const request_1 = require("../request");
+/**
+ * Retrieves available emission source types for a specific endpoint using GET request.
+ *
+ * @export
+ * @param {string} [endpoint] - The endpoint name to retrieve types for. Defaults to 'calculation' if not provided.
+ * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get types for calculation endpoint (default)
+ * const types = await getTypes();
+ *
+ * // Get types for a specific endpoint
+ * const locationTypes = await getTypes('location');
+ */
+async function getTypes(endpoint) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_TYPES_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url,
+        params: endpoint ? { endpoint } : undefined,
+    });
+}
+/**
+ * Retrieves available emission source types for a specific endpoint using POST request.
+ *
+ * @export
+ * @param {string} [endpoint] - The endpoint name to retrieve types for. Defaults to 'calculation' if not provided.
+ * @return {Promise<TypeResponse>} A promise that resolves to a TypeResponse containing the available types
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get types for calculation endpoint (default)
+ * const types = await postTypes();
+ *
+ * // Get types for a specific endpoint
+ * const stationaryTypes = await postTypes('stationary');
+ */
+async function postTypes(endpoint) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_TYPES_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.POST,
+        url,
+        data: endpoint ? { endpoint } : {},
+    });
+}
+/**
+ * Retrieves available geographic locations for a specific endpoint using GET request.
+ *
+ * @export
+ * @param {string} [endpoint] - The endpoint name to retrieve locations for. Defaults to 'calculation' if not provided.
+ * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse containing the available locations
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get areas for calculation endpoint (default)
+ * const areas = await getArea();
+ *
+ * // Get areas for a specific endpoint
+ * const mobileAreas = await getArea('mobile');
+ */
+async function getArea(endpoint) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_AREA_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url,
+        params: endpoint ? { endpoint } : undefined,
+    });
+}
+/**
+ * Retrieves available geographic locations for a specific endpoint using POST request.
+ *
+ * @export
+ * @param {string} [endpoint] - The endpoint name to retrieve locations for. Defaults to 'calculation' if not provided.
+ * @return {Promise<AreaResponse>} A promise that resolves to an AreaResponse containing the available locations
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get areas for calculation endpoint (default)
+ * const areas = await postArea();
+ *
+ * // Get areas for a specific endpoint
+ * const fugitiveAreas = await postArea('fugitive');
+ */
+async function postArea(endpoint) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_AREA_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.POST,
+        url,
+        data: endpoint ? { endpoint } : {},
+    });
+}
+/**
+ * Retrieves available measurement units for a specific type using GET request.
+ *
+ * @export
+ * @param {string} [type] - The emission source type to retrieve units for. If not provided, returns the full UOM table.
+ * @return {Promise<UnitResponse>} A promise that resolves to a UnitResponse containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get all units
+ * const allUnits = await getUnits();
+ *
+ * // Get units for a specific type
+ * const naturalGasUnits = await getUnits('Natural Gas');
+ */
+async function getUnits(type) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_UNITS_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.GET,
+        url,
+        params: type ? { type } : undefined,
+    });
+}
+/**
+ * Retrieves available measurement units for a specific type using POST request.
+ *
+ * @export
+ * @param {string} [type] - The emission source type to retrieve units for. If not provided, returns the full UOM table.
+ * @return {Promise<UnitResponse>} A promise that resolves to a UnitResponse containing the available units
+ * @throws {Error} May throw an error if the API request fails
+ *
+ * @example
+ * // Get all units
+ * const allUnits = await postUnits();
+ *
+ * // Get units for a specific type
+ * const jetKeroseneUnits = await postUnits('Jet Kerosene');
+ */
+async function postUnits(type) {
+    const client = Client_1.Client.getInstance();
+    const url = client.getDomain() + Constants_1.METADATA_UNITS_ENDPOINT;
+    return (0, request_1.makeApiRequest)({
+        method: Constants_1.POST,
+        url,
+        data: type ? { type } : {},
+    });
+}