emissions-api-sdk 1.0.12 → 1.0.14

package/dist/coverage/lcov.info

@@ -12,59 +12,59 @@ FN:269,(anonymous_9)
 FN:303,(anonymous_10)
 FNF:10
 FNH:8
-FNDA:43,(anonymous_1)
-FNDA:48,(anonymous_2)
-FNDA:66,(anonymous_3)
-FNDA:77,(anonymous_4)
+FNDA:50,(anonymous_1)
+FNDA:55,(anonymous_2)
+FNDA:80,(anonymous_3)
+FNDA:91,(anonymous_4)
 FNDA:6,(anonymous_5)
 FNDA:4,(anonymous_6)
 FNDA:0,(anonymous_7)
 FNDA:0,(anonymous_8)
 FNDA:4,(anonymous_9)
 FNDA:8,(anonymous_10)
-DA:1,5
-DA:3,5
-DA:4,5
-DA:6,5
-DA:7,5
-DA:25,43
-DA:26,43
-DA:27,43
-DA:28,43
+DA:1,7
+DA:3,7
+DA:4,7
+DA:6,7
+DA:7,7
+DA:25,50
+DA:26,50
+DA:27,50
+DA:28,50
 DA:29,1
 DA:30,1
 DA:31,1
-DA:33,42
-DA:34,42
-DA:35,42
-DA:38,43
-DA:39,43
-DA:40,43
-DA:41,43
-DA:42,43
-DA:43,43
-DA:88,48
+DA:33,49
+DA:34,49
+DA:35,49
+DA:38,50
+DA:39,50
+DA:40,50
+DA:41,50
+DA:42,50
+DA:43,50
+DA:88,55
 DA:89,1
-DA:93,47
+DA:93,54
 DA:94,1
-DA:98,46
+DA:98,53
 DA:99,1
-DA:103,45
+DA:103,52
 DA:104,1
-DA:108,44
+DA:108,51
 DA:109,1
-DA:114,43
-DA:116,43
+DA:114,50
+DA:116,50
 DA:117,1
 DA:118,1
-DA:119,42
+DA:119,49
 DA:120,6
-DA:122,36
-DA:124,43
-DA:138,66
-DA:160,77
+DA:122,43
+DA:124,50
+DA:138,80
+DA:160,91
 DA:161,1
-DA:165,76
+DA:165,90
 DA:181,6
 DA:182,5
 DA:183,5
@@ -89,54 +89,54 @@ LF:63
 LH:61
 BRDA:23,0,0,0
 BRDA:25,1,0,7
-BRDA:25,2,0,37
+BRDA:25,2,0,44
 BRDA:25,3,0,7
-BRDA:25,4,0,43
+BRDA:25,4,0,50
 BRDA:28,5,0,1
-BRDA:28,5,1,42
+BRDA:28,5,1,49
 BRDA:40,6,0,0
-BRDA:40,6,1,43
-BRDA:40,7,0,43
-BRDA:40,7,1,43
+BRDA:40,6,1,50
+BRDA:40,7,0,50
+BRDA:40,7,1,50
 BRDA:41,8,0,2
-BRDA:41,8,1,41
-BRDA:41,9,0,43
-BRDA:41,9,1,43
+BRDA:41,8,1,48
+BRDA:41,9,0,50
+BRDA:41,9,1,50
 BRDA:41,10,0,4
-BRDA:41,10,1,37
+BRDA:41,10,1,44
 BRDA:43,11,0,0
-BRDA:43,11,1,43
+BRDA:43,11,1,50
 BRDA:88,12,0,1
-BRDA:88,12,1,47
-BRDA:88,13,0,48
+BRDA:88,12,1,54
+BRDA:88,13,0,55
 BRDA:88,13,1,1
 BRDA:93,14,0,1
-BRDA:93,14,1,46
-BRDA:93,15,0,47
+BRDA:93,14,1,53
+BRDA:93,15,0,54
 BRDA:93,15,1,2
 BRDA:98,16,0,1
-BRDA:98,16,1,45
-BRDA:98,17,0,46
-BRDA:98,17,1,37
-BRDA:98,17,2,36
+BRDA:98,16,1,52
+BRDA:98,17,0,53
+BRDA:98,17,1,44
+BRDA:98,17,2,43
 BRDA:103,18,0,1
-BRDA:103,18,1,44
-BRDA:103,19,0,45
+BRDA:103,18,1,51
+BRDA:103,19,0,52
 BRDA:103,19,1,8
 BRDA:108,20,0,1
-BRDA:108,20,1,43
-BRDA:108,21,0,44
+BRDA:108,20,1,50
+BRDA:108,21,0,51
 BRDA:108,21,1,7
 BRDA:116,22,0,1
-BRDA:116,22,1,42
-BRDA:116,23,0,43
+BRDA:116,22,1,49
+BRDA:116,23,0,50
 BRDA:116,23,1,1
 BRDA:119,24,0,6
-BRDA:119,24,1,36
-BRDA:119,25,0,42
+BRDA:119,24,1,43
+BRDA:119,25,0,49
 BRDA:119,25,1,6
 BRDA:160,26,0,1
-BRDA:160,26,1,76
+BRDA:160,26,1,90
 BRDA:181,27,0,5
 BRDA:181,27,1,1
 BRDA:183,28,0,3
@@ -162,32 +162,38 @@ TN:
 SF:src/Constants.ts
 FNF:0
 FNH:0
-DA:1,5
-DA:2,5
-DA:3,5
-DA:4,5
-DA:5,5
-DA:6,5
-DA:7,5
-DA:8,5
-DA:9,5
-DA:10,5
-DA:11,5
-DA:12,5
-DA:13,5
-DA:14,5
-DA:16,5
-DA:18,5
-DA:20,5
-DA:21,5
-DA:22,5
-DA:24,5
-DA:25,5
-DA:26,5
-DA:27,5
-DA:28,5
-LF:24
-LH:24
+DA:1,11
+DA:2,11
+DA:3,11
+DA:4,11
+DA:5,11
+DA:6,11
+DA:7,11
+DA:8,11
+DA:9,11
+DA:10,11
+DA:11,11
+DA:12,11
+DA:13,11
+DA:14,11
+DA:15,11
+DA:16,11
+DA:17,11
+DA:18,11
+DA:19,11
+DA:21,11
+DA:23,11
+DA:25,11
+DA:26,11
+DA:27,11
+DA:29,11
+DA:30,11
+DA:31,11
+DA:32,11
+DA:33,11
+DA:34,11
+LF:30
+LH:30
 BRF:0
 BRH:0
 end_of_record
@@ -197,15 +203,15 @@ FN:30,makeApiRequest
 FNF:1
 FNH:1
 FNDA:3,makeApiRequest
-DA:1,3
-DA:3,3
-DA:4,3
-DA:30,3
+DA:1,5
+DA:3,5
+DA:4,5
+DA:30,5
 DA:31,3
 DA:32,3
 DA:34,3
-DA:48,3
-DA:49,2
+DA:49,3
+DA:50,2
 LF:9
 LH:9
 BRF:0
@@ -216,20 +222,112 @@ SF:src/utils.ts
 FN:14,findExpiryTime
 FNF:1
 FNH:1
-FNDA:38,findExpiryTime
-DA:14,5
-DA:15,38
-DA:16,38
-DA:17,38
-DA:18,38
+FNDA:45,findExpiryTime
+DA:14,7
+DA:15,45
+DA:16,45
+DA:17,45
+DA:18,45
 LF:5
 LH:5
 BRDA:17,0,0,0
-BRDA:17,0,1,38
+BRDA:17,0,1,45
 BRF:2
 BRH:1
 end_of_record
 TN:
+SF:src/api/AuditExport.ts
+FN:32,trigger
+FN:56,getStatus
+FN:80,download
+FNF:3
+FNH:3
+FNDA:1,trigger
+FNDA:1,getStatus
+FNDA:1,download
+DA:2,1
+DA:3,1
+DA:15,1
+DA:32,1
+DA:35,1
+DA:36,1
+DA:38,1
+DA:56,1
+DA:59,1
+DA:60,1
+DA:62,1
+DA:80,1
+DA:81,1
+DA:82,1
+DA:84,1
+LF:15
+LH:15
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/api/AuditLog.ts
+FN:14,handleAuditLogError
+FN:53,getAuditConfig
+FN:87,updateAuditConfig
+FNF:3
+FNH:3
+FNDA:8,handleAuditLogError
+FNDA:5,getAuditConfig
+FNDA:7,updateAuditConfig
+DA:1,2
+DA:2,2
+DA:3,2
+DA:5,2
+DA:15,8
+DA:16,6
+DA:17,6
+DA:20,6
+DA:21,1
+DA:25,5
+DA:26,1
+DA:30,4
+DA:31,2
+DA:36,4
+DA:53,2
+DA:54,5
+DA:55,5
+DA:57,5
+DA:58,5
+DA:63,3
+DA:87,2
+DA:90,7
+DA:91,7
+DA:93,7
+DA:94,7
+DA:100,5
+LF:26
+LH:26
+BRDA:14,0,0,3
+BRDA:15,1,0,6
+BRDA:15,1,1,2
+BRDA:15,2,0,8
+BRDA:15,2,1,6
+BRDA:20,3,0,1
+BRDA:20,3,1,5
+BRDA:20,4,0,6
+BRDA:20,4,1,1
+BRDA:25,5,0,1
+BRDA:25,5,1,4
+BRDA:26,6,0,0
+BRDA:26,6,1,1
+BRDA:26,7,0,1
+BRDA:26,7,1,1
+BRDA:30,8,0,2
+BRDA:30,8,1,2
+BRDA:31,9,0,0
+BRDA:31,9,1,2
+BRDA:31,10,0,2
+BRDA:31,10,1,2
+BRF:21
+BRH:19
+end_of_record
+TN:
 SF:src/api/Calculation.ts
 FN:35,calculate
 FNF:1
@@ -249,17 +347,17 @@ BRH:0
 end_of_record
 TN:
 SF:src/api/EconomicActivity.ts
-FN:34,calculate
+FN:103,calculate
 FNF:1
 FNH:1
-FNDA:1,calculate
+FNDA:2,calculate
 DA:1,1
 DA:2,1
 DA:6,1
-DA:34,1
-DA:37,1
-DA:38,1
-DA:40,1
+DA:103,1
+DA:106,2
+DA:107,2
+DA:109,2
 LF:7
 LH:7
 BRF:0
@@ -268,7 +366,7 @@ end_of_record
 TN:
 SF:src/api/Factor.ts
 FN:41,retrieveFactor
-FN:128,search
+FN:144,search
 FNF:2
 FNH:2
 FNDA:1,retrieveFactor
@@ -280,10 +378,10 @@ DA:41,1
 DA:44,1
 DA:45,1
 DA:47,1
-DA:128,1
-DA:131,1
-DA:132,1
-DA:134,1
+DA:144,1
+DA:147,1
+DA:148,1
+DA:150,1
 LF:11
 LH:11
 BRF:0
@@ -422,18 +520,36 @@ BRF:0
 BRH:0
 end_of_record
 TN:
+SF:src/api/PhysicalActivity.ts
+FN:81,calculate
+FNF:1
+FNH:1
+FNDA:3,calculate
+DA:1,1
+DA:2,1
+DA:6,1
+DA:81,1
+DA:84,3
+DA:85,3
+DA:87,3
+LF:7
+LH:7
+BRF:0
+BRH:0
+end_of_record
+TN:
 SF:src/api/RealEstate.ts
-FN:34,calculate
+FN:58,calculate
 FNF:1
 FNH:1
-FNDA:1,calculate
+FNDA:2,calculate
 DA:1,1
 DA:2,1
 DA:6,1
-DA:34,1
-DA:37,1
-DA:38,1
-DA:40,1
+DA:58,1
+DA:61,2
+DA:62,2
+DA:64,2
 LF:7
 LH:7
 BRF:0
@@ -477,17 +593,17 @@ BRH:0
 end_of_record
 TN:
 SF:src/api/TypeRecommender.ts
-FN:102,search
+FN:119,search
 FNF:1
 FNH:1
 FNDA:1,search
 DA:1,1
 DA:2,1
 DA:5,1
-DA:102,1
-DA:105,1
-DA:106,1
-DA:108,1
+DA:119,1
+DA:122,1
+DA:123,1
+DA:125,1
 LF:7
 LH:7
 BRF:0
@@ -528,6 +644,17 @@ BRF:0
 BRH:0
 end_of_record
 TN:
+SF:test/mocks/AttributionRequest.ts
+FNF:0
+FNH:0
+DA:3,1
+DA:23,1
+LF:2
+LH:2
+BRF:0
+BRH:0
+end_of_record
+TN:
 SF:test/mocks/CommonRequest.ts
 FNF:0
 FNH:0
@@ -539,6 +666,17 @@ BRF:0
 BRH:0
 end_of_record
 TN:
+SF:test/mocks/EconomicActivityAttributionRequest.ts
+FNF:0
+FNH:0
+DA:3,1
+DA:22,1
+LF:2
+LH:2
+BRF:0
+BRH:0
+end_of_record
+TN:
 SF:test/mocks/FactorRequest.ts
 FNF:0
 FNH:0
@@ -572,6 +710,28 @@ BRF:0
 BRH:0
 end_of_record
 TN:
+SF:test/mocks/PhysicalActivityEVICRequest.ts
+FNF:0
+FNH:0
+DA:3,1
+DA:22,1
+LF:2
+LH:2
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:test/mocks/PhysicalActivityRequest.ts
+FNF:0
+FNH:0
+DA:3,1
+DA:23,1
+LF:2
+LH:2
+BRF:0
+BRH:0
+end_of_record
+TN:
 SF:test/mocks/SearchRequest.ts
 FNF:0
 FNH:0

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TypeRecommender = exports.Metadata = exports.RealEstate = exports.EconomicActivity = exports.FactorSets = exports.Factor = exports.Usage = exports.TransportationAndDistribution = exports.Calculation = exports.Stationary = exports.Mobile = exports.Fugitive = exports.Location = exports.Client = void 0;
+exports.AuditExport = exports.AuditLog = exports.TypeRecommender = exports.Metadata = exports.PhysicalActivity = exports.RealEstate = exports.EconomicActivity = exports.FactorSets = exports.Factor = exports.Usage = exports.TransportationAndDistribution = exports.Calculation = exports.Stationary = exports.Mobile = exports.Fugitive = exports.Location = exports.Client = void 0;
 var Client_1 = require("./Client");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return Client_1.Client; } });
 exports.Location = __importStar(require("./api/Location"));
@@ -47,5 +47,8 @@ exports.Factor = __importStar(require("./api/Factor"));
 exports.FactorSets = __importStar(require("./api/FactorSets"));
 exports.EconomicActivity = __importStar(require("./api/EconomicActivity"));
 exports.RealEstate = __importStar(require("./api/RealEstate"));
+exports.PhysicalActivity = __importStar(require("./api/PhysicalActivity"));
 exports.Metadata = __importStar(require("./api/Metadata"));
 exports.TypeRecommender = __importStar(require("./api/TypeRecommender"));
+exports.AuditLog = __importStar(require("./api/AuditLog"));
+exports.AuditExport = __importStar(require("./api/AuditExport"));

package/dist/interfaces/response/AuditExportResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interfaces/response/AuditLogResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/request.js

@@ -38,6 +38,7 @@ async function makeApiRequest(config) {
         url: config.url,
         data: config.data,
         params: config.params,
+        responseType: config.responseType,
         headers: {
             ...client.getAuthHeader(),
             ...config.headers,

package/dist/types/Constants.d.ts

@@ -12,6 +12,11 @@ export declare const FACTOR_SET_API_PATH = "/v3/carbon/factorset";
 export declare const SEARCH_API_PATH = "/v3/carbon/factor/search";
 export declare const ECONOMIC_ACTIVITY_API_PATH = "/v3/carbon/economic-activity";
 export declare const REAL_ESTATE_API_PATH = "/v3/carbon/real-estate";
+export declare const PHYSICAL_ACTIVITY_API_PATH = "/v3/carbon/physical-activity";
+export declare const AUDIT_LOG_API_PATH = "/v3/carbon/admin/audit-log";
+export declare const AUDIT_EXPORT_API_PATH = "/v3/carbon/audit";
+export declare const AUDIT_EXPORT_STATUS_API_PATH = "/v3/carbon/audit/status";
+export declare const AUDIT_EXPORT_DOWNLOAD_API_PATH = "/v3/carbon/audit/download";
 export declare const TYPE_RECOMMENDER_API_PATH = "/v3/carbon/recommender/type/search";
 export declare const USAGE_API = "/v3/carbon/usage";
 export declare const METADATA_TYPES_ENDPOINT = "/v3/carbon/metadata/types";
@@ -19,6 +24,7 @@ export declare const METADATA_AREA_ENDPOINT = "/v3/carbon/metadata/area";
 export declare const METADATA_UNITS_ENDPOINT = "/v3/carbon/metadata/units";
 export declare const GET = "GET";
 export declare const POST = "POST";
+export declare const PUT = "PUT";
 export declare const CLIENT_SOURCE_HEADER = "X-Client-Source";
 export declare const CLIENT_SOURCE_EXCEL = "excel";
 export declare const CLIENT_SOURCE_SDK = "node-sdk";

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

@@ -0,0 +1,42 @@
+import { Buffer } from "node:buffer";
+import { AuditExportRequest, AuditExportResponse, AuditExportStatusResponse } from "../interfaces/response/AuditExportResponse";
+/**
+ * Triggers an asynchronous audit data export.
+ *
+ * @export
+ * @param {AuditExportRequest} payload - Date range and optional API-name filter for the export
+ * @return {Promise<AuditExportResponse>} The accepted export request, including its request ID
+ * @throws {Error} Throws if the request is invalid, the caller is not an admin, or a matching export already exists
+ *
+ * @example
+ * const auditExport = await trigger({
+ *   fromDate: "2025-01-01",
+ *   toDate: "2025-03-31",
+ *   apiName: "location"
+ * });
+ */
+export declare function trigger(payload: AuditExportRequest): Promise<AuditExportResponse>;
+/**
+ * Retrieves the processing status of an audit export.
+ *
+ * @export
+ * @param {string} requestId - Request ID returned by trigger
+ * @return {Promise<AuditExportStatusResponse>} Current export status and, when complete, download details
+ * @throws {Error} Throws if the request ID is invalid or the caller is not an admin
+ *
+ * @example
+ * const status = await getStatus(auditExport.requestId);
+ */
+export declare function getStatus(requestId: string): Promise<AuditExportStatusResponse>;
+/**
+ * Downloads a completed audit export as a ZIP archive.
+ *
+ * @export
+ * @param {string} requestId - Request ID returned by trigger
+ * @return {Promise<Buffer>} ZIP archive containing audit-export.csv
+ * @throws {Error} Throws while processing, when the export failed or expired, or if the caller is not an admin
+ *
+ * @example
+ * const auditExportZip = await download(auditExport.requestId);
+ */
+export declare function download(requestId: string): Promise<Buffer>;

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

@@ -0,0 +1,37 @@
+import { AuditLogRequest, AuditLogResponse } from "../interfaces/response/AuditLogResponse";
+/**
+ * Retrieves the audit log configuration for the organization.
+ *
+ * Controls whether the organization's API requests and responses are stored for auditing.
+ * Organizations can disable this if they don't need their API calls to be audited.
+ *
+ * @export
+ * @return {Promise<AuditLogResponse>} Current audit log configuration
+ * @throws {Error} Throws error for 403 (Forbidden) or other failures
+ *
+ * @example
+ * const config = await getConfig();
+ * // Output: { logRequest: true, logResponse: false }
+ */
+export declare function getAuditConfig(): Promise<AuditLogResponse>;
+/**
+ * Updates the audit log configuration for the organization.
+ *
+ * Controls whether the organization's API requests and responses are stored for auditing.
+ * Organizations can disable this if they don't need their API calls to be audited.
+ *
+ * Note: If the configuration is already set to the requested values, the API will return
+ * a 409 Conflict status with a message indicating no change was made. This is handled
+ * gracefully and the current configuration is returned.
+ *
+ * @export
+ * @param {AuditLogRequest} payload - Audit log configuration
+ * @return {Promise<AuditLogResponse>} Updated configuration or current configuration if no change
+ * @throws {Error} Throws error for 400 (Bad Request), 403 (Forbidden), or other failures
+ *
+ * @example
+ * const result = await update({ logRequest: false, logResponse: false });
+ * // If already set to these values:
+ * // { logRequest: false, logResponse: false, message: "No change in audit log configuration" }
+ */
+export declare function updateAuditConfig(payload: AuditLogRequest): Promise<AuditLogResponse>;