@cravery/firebase 0.0.38 → 0.0.39

package/dist/lib/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./monitoring";
 export * from "./strip-undefined";
 export * from "./timestamp";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/lib/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./monitoring"), exports);
 __exportStar(require("./strip-undefined"), exports);
 __exportStar(require("./timestamp"), exports);
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,oDAAkC;AAClC,8CAA4B"}

package/dist/lib/monitoring.d.ts

@@ -0,0 +1,15 @@
+import { ObservableGauge } from "@opentelemetry/api";
+type Attributes = Record<string, string>;
+export declare const incrementCounter: (name: string, attributes?: Attributes, value?: number) => void;
+export declare const recordTiming: (name: string, durationMs: number, attributes?: Attributes) => void;
+export declare const withTiming: <T>(name: string, fn: () => Promise<T>, attributes?: Attributes) => Promise<T>;
+export declare const registerGauge: (name: string, callback: () => number | Promise<number>, attributes?: Attributes) => ObservableGauge;
+export declare const createMetricsScope: (defaultAttributes: Attributes) => {
+    incrementCounter: (name: string, attributes?: Attributes, value?: number) => void;
+    recordTiming: (name: string, durationMs: number, attributes?: Attributes) => void;
+    withTiming: <T>(name: string, fn: () => Promise<T>, attributes?: Attributes) => Promise<T>;
+    registerGauge: (name: string, callback: () => number | Promise<number>, attributes?: Attributes) => ObservableGauge;
+};
+export declare const shutdown: () => Promise<void>;
+export {};
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/lib/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../src/lib/monitoring.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,eAAe,EAAS,MAAM,oBAAoB,CAAC;AA8ChF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzC,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,aAAa,UAAU,EACvB,cAAS,KACR,IAEF,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,YAAY,MAAM,EAClB,aAAa,UAAU,KACtB,IAEF,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,CAAC,EAChC,MAAM,MAAM,EACZ,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,aAAa,UAAU,KACtB,OAAO,CAAC,CAAC,CAKX,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,UAAU,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EACxC,aAAa,UAAU,KACtB,eAOF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,mBAAmB,UAAU;6BACrC,MAAM,eAAe,UAAU;yBAGnC,MAAM,cAAc,MAAM,eAAe,UAAU;iBAG3D,CAAC,QAAQ,MAAM,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,eAAe,UAAU;0BAInE,MAAM,YACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAC3B,UAAU;CAEzB,CAAC;AAEH,eAAO,MAAM,QAAQ,QAAO,OAAO,CAAC,IAAI,CAA6B,CAAC"}

package/dist/lib/monitoring.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdown = exports.createMetricsScope = exports.registerGauge = exports.withTiming = exports.recordTiming = exports.incrementCounter = void 0;
+const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
+const resources_1 = require("@opentelemetry/resources");
+const opentelemetry_cloud_monitoring_exporter_1 = require("@google-cloud/opentelemetry-cloud-monitoring-exporter");
+const resource = (0, resources_1.resourceFromAttributes)({
+    "service.name": "cravery-backend",
+});
+const exporter = new opentelemetry_cloud_monitoring_exporter_1.MetricExporter();
+const meterProvider = new sdk_metrics_1.MeterProvider({
+    resource,
+    readers: [
+        new sdk_metrics_1.PeriodicExportingMetricReader({
+            exporter,
+            exportIntervalMillis: 60000,
+        }),
+    ],
+});
+const meter = meterProvider.getMeter("cravery");
+const counters = new Map();
+const histograms = new Map();
+const getCounter = (name, description) => {
+    if (!counters.has(name)) {
+        counters.set(name, meter.createCounter(`cravery.${name}`, { description }));
+    }
+    return counters.get(name);
+};
+const getHistogram = (name, description) => {
+    if (!histograms.has(name)) {
+        histograms.set(name, meter.createHistogram(`cravery.${name}`, {
+            description,
+            unit: "ms",
+        }));
+    }
+    return histograms.get(name);
+};
+const incrementCounter = (name, attributes, value = 1) => {
+    getCounter(name).add(value, attributes);
+};
+exports.incrementCounter = incrementCounter;
+const recordTiming = (name, durationMs, attributes) => {
+    getHistogram(name).record(durationMs, attributes);
+};
+exports.recordTiming = recordTiming;
+const withTiming = async (name, fn, attributes) => {
+    const start = Date.now();
+    const result = await fn();
+    (0, exports.recordTiming)(name, Date.now() - start, attributes);
+    return result;
+};
+exports.withTiming = withTiming;
+const registerGauge = (name, callback, attributes) => {
+    const gauge = meter.createObservableGauge(`cravery.${name}`);
+    gauge.addCallback(async (observableResult) => {
+        const value = await callback();
+        observableResult.observe(value, attributes);
+    });
+    return gauge;
+};
+exports.registerGauge = registerGauge;
+const createMetricsScope = (defaultAttributes) => ({
+    incrementCounter: (name, attributes, value = 1) => (0, exports.incrementCounter)(name, Object.assign(Object.assign({}, defaultAttributes), attributes), value),
+    recordTiming: (name, durationMs, attributes) => (0, exports.recordTiming)(name, durationMs, Object.assign(Object.assign({}, defaultAttributes), attributes)),
+    withTiming: (name, fn, attributes) => (0, exports.withTiming)(name, fn, Object.assign(Object.assign({}, defaultAttributes), attributes)),
+    registerGauge: (name, callback, attributes) => (0, exports.registerGauge)(name, callback, Object.assign(Object.assign({}, defaultAttributes), attributes)),
+});
+exports.createMetricsScope = createMetricsScope;
+const shutdown = () => meterProvider.shutdown();
+exports.shutdown = shutdown;
+//# sourceMappingURL=monitoring.js.map

package/dist/lib/monitoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../../src/lib/monitoring.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cravery/firebase",
-  "version": "0.0.38",
+  "version": "0.0.39",
   "description": "Shared Firebase Admin SDK utilities for Cravery",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,6 +28,10 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@cravery/core": "^0.0.61"
+    "@cravery/core": "^0.0.61",
+    "@google-cloud/opentelemetry-cloud-monitoring-exporter": "^0.21.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/resources": "^2.4.0",
+    "@opentelemetry/sdk-metrics": "^2.4.0"
   }
 }

package/src/lib/index.ts

@@ -1,2 +1,3 @@
+export * from "./monitoring";
 export * from "./strip-undefined";
 export * from "./timestamp";

package/src/lib/monitoring.ts

@@ -0,0 +1,112 @@
+import {
+  MeterProvider,
+  PeriodicExportingMetricReader,
+} from "@opentelemetry/sdk-metrics";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { MetricExporter } from "@google-cloud/opentelemetry-cloud-monitoring-exporter";
+import { Counter, Histogram, ObservableGauge, Meter } from "@opentelemetry/api";
+
+const resource = resourceFromAttributes({
+  "service.name": "cravery-backend",
+});
+
+const exporter = new MetricExporter();
+
+const meterProvider = new MeterProvider({
+  resource,
+  readers: [
+    new PeriodicExportingMetricReader({
+      exporter,
+      exportIntervalMillis: 60000,
+    }),
+  ],
+});
+
+const meter: Meter = meterProvider.getMeter("cravery");
+
+const counters = new Map<string, Counter>();
+const histograms = new Map<string, Histogram>();
+
+const getCounter = (name: string, description?: string): Counter => {
+  if (!counters.has(name)) {
+    counters.set(
+      name,
+      meter.createCounter(`cravery.${name}`, { description }),
+    );
+  }
+  return counters.get(name)!;
+};
+
+const getHistogram = (name: string, description?: string): Histogram => {
+  if (!histograms.has(name)) {
+    histograms.set(
+      name,
+      meter.createHistogram(`cravery.${name}`, {
+        description,
+        unit: "ms",
+      }),
+    );
+  }
+  return histograms.get(name)!;
+};
+
+type Attributes = Record<string, string>;
+
+export const incrementCounter = (
+  name: string,
+  attributes?: Attributes,
+  value = 1,
+): void => {
+  getCounter(name).add(value, attributes);
+};
+
+export const recordTiming = (
+  name: string,
+  durationMs: number,
+  attributes?: Attributes,
+): void => {
+  getHistogram(name).record(durationMs, attributes);
+};
+
+export const withTiming = async <T>(
+  name: string,
+  fn: () => Promise<T>,
+  attributes?: Attributes,
+): Promise<T> => {
+  const start = Date.now();
+  const result = await fn();
+  recordTiming(name, Date.now() - start, attributes);
+  return result;
+};
+
+export const registerGauge = (
+  name: string,
+  callback: () => number | Promise<number>,
+  attributes?: Attributes,
+): ObservableGauge => {
+  const gauge = meter.createObservableGauge(`cravery.${name}`);
+  gauge.addCallback(async (observableResult) => {
+    const value = await callback();
+    observableResult.observe(value, attributes);
+  });
+  return gauge;
+};
+
+export const createMetricsScope = (defaultAttributes: Attributes) => ({
+  incrementCounter: (name: string, attributes?: Attributes, value = 1) =>
+    incrementCounter(name, { ...defaultAttributes, ...attributes }, value),
+
+  recordTiming: (name: string, durationMs: number, attributes?: Attributes) =>
+    recordTiming(name, durationMs, { ...defaultAttributes, ...attributes }),
+
+  withTiming: <T>(name: string, fn: () => Promise<T>, attributes?: Attributes) =>
+    withTiming(name, fn, { ...defaultAttributes, ...attributes }),
+
+  registerGauge: (
+    name: string,
+    callback: () => number | Promise<number>,
+    attributes?: Attributes,
+  ) => registerGauge(name, callback, { ...defaultAttributes, ...attributes }),
+});
+
+export const shutdown = (): Promise<void> => meterProvider.shutdown();