release: v1.1.1

package.json

@@ -1,10 +1,11 @@
 {
   "name": "@nhcarrigan/logger",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Our custom logging package, which pipes logs to our alerts server.",
   "type": "module",
   "main": "prod/index.js",
   "scripts": {
+    "prepublish": "pnpm lint && pnpm build",
     "lint": "eslint src --max-warnings 0",
     "build": "rm -rf prod && tsc",
     "test": "echo \"Error: no test specified\" && exit 0"

src/index.ts

@@ -71,4 +71,34 @@ export class Logger {
       method: "POST",
     });
   }
+
+  /**
+   * Sends a counter metric to the alerting service.
+   * The alerting service is configured to handle aggregation, so you can send
+   * summative counts or individual increments. (e.g. Send a count of all users, or send a count of 1 every time a user joins).
+   * @param name -- The name of the metric to track.
+   * @param value -- The value of the metric to insert.
+   * @param metadata -- Any metadata to attach to the metric.
+   */
+  public async metric(
+    name: string,
+    value: number,
+    metadata: Record<string, string | number | boolean>,
+  ): Promise<void> {
+    await fetch(`${this.url}/metric`, {
+      body: JSON.stringify({
+        application: this.application,
+        metadata:    metadata,
+        name:        name,
+        value:       value,
+      }),
+      headers: {
+        // eslint-disable-next-line @typescript-eslint/naming-convention -- Standard header name.
+        "Authorization": this.token,
+        // eslint-disable-next-line @typescript-eslint/naming-convention -- Standard header name.
+        "Content-Type":  "application/json",
+      },
+      method: "POST",
+    });
+  }
 }