@dvsa/appdev-api-common 0.7.0 → 0.8.0

package/http/decorators.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from "@aws-lambda-powertools/logger";
+export declare function LogDurationWithAccessor<T extends {
+    logger: Logger;
+}>(getLogger: (self: T) => Logger, label?: string): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Timed<T extends {
+    logger: Logger;
+}>(label?: string): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/http/decorators.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogDurationWithAccessor = LogDurationWithAccessor;
+exports.Timed = Timed;
+const node_perf_hooks_1 = require("node:perf_hooks");
+function LogDurationWithAccessor(getLogger, label) {
+    return (_target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        // biome-ignore lint/suspicious/noExplicitAny: "any" is correct for this context
+        descriptor.value = function (...args) {
+            const logger = getLogger(this);
+            const labelToUse = label || propertyKey;
+            const start = node_perf_hooks_1.performance.now();
+            try {
+                const result = originalMethod.apply(this, args);
+                // async route, if it's a Promise.
+                if (result instanceof Promise) {
+                    return result
+                        .then((res) => {
+                        const duration = (node_perf_hooks_1.performance.now() - start).toFixed(2);
+                        logger.debug(`[${labelToUse}] took ${duration}ms`);
+                        return res;
+                    })
+                        .catch((err) => {
+                        const duration = (node_perf_hooks_1.performance.now() - start).toFixed(2);
+                        logger.debug(`[${labelToUse}] failed after ${duration}ms`);
+                        throw err;
+                    });
+                }
+                // Otherwise, sync method: log and return
+                const duration = (node_perf_hooks_1.performance.now() - start).toFixed(2);
+                logger.debug(`[${labelToUse}] took ${duration}ms`);
+                return result;
+            }
+            catch (err) {
+                const duration = (node_perf_hooks_1.performance.now() - start).toFixed(2);
+                logger.debug(`[${labelToUse}] failed after ${duration}ms`);
+                throw err;
+            }
+        };
+        return descriptor;
+    };
+}
+function Timed(label) {
+    return LogDurationWithAccessor((cls) => {
+        if (!cls.logger) {
+            throw new Error(`[${label}] Logger not found on decorated class.`);
+        }
+        return cls.logger;
+    }, label);
+}

package/http/index.d.ts

@@ -0,0 +1,10 @@
+export declare class HTTPError extends Error {
+    response: Response;
+    constructor(message: string, response: Response);
+}
+export declare class HTTP {
+    static get(url: string, options?: RequestInit): Promise<Response>;
+    static post<T>(url: string, body: T, options?: RequestInit): Promise<Response>;
+    static put<T>(url: string, body: T, options?: RequestInit): Promise<Response>;
+    static delete(url: string, options?: RequestInit): Promise<Response>;
+}

package/http/index.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP = exports.HTTPError = void 0;
+class HTTPError extends Error {
+    response;
+    constructor(message, response) {
+        super(message);
+        this.response = response;
+        this.name = "HTTPError";
+        this.response = response;
+    }
+}
+exports.HTTPError = HTTPError;
+// biome-ignore lint/complexity/noStaticOnlyClass: makes sense for an HTTP utility to encompass all methods
+class HTTP {
+    static async get(url, options) {
+        const response = await fetch(url, { method: "GET", ...options });
+        if (!response.ok) {
+            throw new HTTPError(`HTTP GET request failed with status ${response.status}`, response);
+        }
+        return response;
+    }
+    static async post(url, body, options) {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...options?.headers },
+            body: JSON.stringify(body),
+            ...options,
+        });
+        if (!response.ok) {
+            throw new HTTPError(`HTTP POST request failed with status ${response.status}`, response);
+        }
+        return response;
+    }
+    static async put(url, body, options) {
+        const response = await fetch(url, {
+            method: "PUT",
+            headers: { "Content-Type": "application/json", ...options?.headers },
+            body: JSON.stringify(body),
+            ...options,
+        });
+        if (!response.ok) {
+            throw new HTTPError(`HTTP PUT request failed with status ${response.status}`, response);
+        }
+        return response;
+    }
+    static async delete(url, options) {
+        const response = await fetch(url, { method: "DELETE", ...options });
+        if (!response.ok) {
+            throw new HTTPError(`HTTP DELETE request failed with status ${response.status}`, response);
+        }
+        return response;
+    }
+}
+exports.HTTP = HTTP;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dvsa/appdev-api-common",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"keywords": ["dvsa", "nodejs", "typescript"],
 	"author": "DVSA",
 	"description": "Utils library for common API functionality",
@@ -29,6 +29,7 @@
 		"jose": "^5.9.6"
 	},
 	"devDependencies": {
+		"@aws-lambda-powertools/logger": "^2.22.0",
 		"@biomejs/biome": "1.9.3",
 		"@dvsa/biome-config": "0.3.0",
 		"@types/aws-lambda": "^8.10.145",