@coast/service-common-nest 1.0.80 → 2.0.1

package/dist/lib/{logger/MetricsConfig.d.ts → observe/CollectMetricsOptions.d.ts}

@@ -1,4 +1,4 @@
 import { MetricTags } from './MetricTags';
-export interface MetricsConfig<T = unknown> {
+export interface CollectMetricsOptions<T = unknown> {
     extraTags?: ((self: T) => MetricTags) | MetricTags;
 }

package/dist/lib/observe/CollectMetricsOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=CollectMetricsOptions.js.map

package/dist/lib/observe/CollectMetricsOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollectMetricsOptions.js","sourceRoot":"","sources":["../../../lib/observe/CollectMetricsOptions.ts"],"names":[],"mappings":""}

package/dist/lib/observe/ExtraLogFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtraLogFields.js","sourceRoot":"","sources":["../../../lib/observe/ExtraLogFields.ts"],"names":[],"mappings":""}

package/dist/lib/observe/LogExecutionOptions.d.ts

@@ -0,0 +1,5 @@
+import { ExtraLogFields } from './ExtraLogFields';
+export interface LogExecutionOptions<T = unknown> {
+    samplePercentage?: number;
+    extraLogFields?: ((self: T) => ExtraLogFields) | ExtraLogFields;
+}

package/dist/lib/{logger/LogMethodOptions.js → observe/LogExecutionOptions.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=LogMethodOptions.js.map
+//# sourceMappingURL=LogExecutionOptions.js.map

package/dist/lib/observe/LogExecutionOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogExecutionOptions.js","sourceRoot":"","sources":["../../../lib/observe/LogExecutionOptions.ts"],"names":[],"mappings":""}

package/dist/lib/{logger → observe}/MetricTags.js.map

@@ -1 +1 @@
-{"version":3,"file":"MetricTags.js","sourceRoot":"","sources":["../../../lib/logger/MetricTags.ts"],"names":[],"mappings":""}
+{"version":3,"file":"MetricTags.js","sourceRoot":"","sources":["../../../lib/observe/MetricTags.ts"],"names":[],"mappings":""}

package/dist/lib/observe/ObserveMethod.d.ts

@@ -0,0 +1,2 @@
+import { ObserveMethodOptions } from './ObserveMethodOptions';
+export declare function ObserveMethod<T = unknown>(options?: ObserveMethodOptions<T>): MethodDecorator;

package/dist/lib/{logger/LogMethod.js → observe/ObserveMethod.js}

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogMethod = LogMethod;
+exports.ObserveMethod = ObserveMethod;
 const DeepLogObject_1 = require("@coast/service-common/logger/DeepLogObject");
 const RedactionUtils_1 = require("@coast/service-common/logger/redaction/RedactionUtils");
 const SensitiveSymbol_1 = require("@coast/service-common/logger/redaction/SensitiveSymbol");
@@ -11,53 +11,70 @@ const common_1 = require("@nestjs/common");
 const lodash_1 = __importDefault(require("lodash"));
 const Constants_1 = require("../Constants");
 const CoastMetrics_1 = require("../metrics/CoastMetrics");
-function LogMethod(options) {
-    const extraLogFieldsOption = options?.extraLogFields;
-    const metrics = options?.metrics;
-    const extraTagsOption = metrics?.extraTags;
-    const injectLogger = (0, common_1.Inject)(Constants_1.Constants.COAST_LOGGER);
-    const injectMetrics = metrics !== undefined ? (0, common_1.Inject)(CoastMetrics_1.CoastMetrics) : undefined;
+function ObserveMethod(options) {
+    const logExecutionOption = options?.logExecution ?? true;
+    const collectMetricsOption = options?.collectMetrics ?? false;
+    const logExecutionEnabled = logExecutionOption !== false;
+    const collectMetricsEnabled = collectMetricsOption !== false;
+    const logExecutionConfig = typeof logExecutionOption === 'object' ? logExecutionOption : {};
+    const collectMetricsConfig = typeof collectMetricsOption === 'object' ? collectMetricsOption : {};
+    const samplePercentage = logExecutionConfig.samplePercentage;
+    const extraLogFieldsOption = logExecutionConfig.extraLogFields;
+    const extraTagsOption = collectMetricsConfig.extraTags;
+    const injectLogger = logExecutionEnabled ? (0, common_1.Inject)(Constants_1.Constants.COAST_LOGGER) : undefined;
+    const injectMetrics = collectMetricsEnabled ? (0, common_1.Inject)(CoastMetrics_1.CoastMetrics) : undefined;
     return (target, method, descriptor) => {
         if (descriptor === undefined) {
             descriptor = Object.getOwnPropertyDescriptor(target, method);
         }
-        injectLogger(target, 'logger');
+        if (injectLogger !== undefined) {
+            injectLogger(target, 'logger');
+        }
         if (injectMetrics !== undefined) {
             injectMetrics(target, 'metrics');
         }
         const originalMethod = descriptor?.value;
         if (!lodash_1.default.isNil(descriptor)) {
             descriptor.value = function () {
-                const coastLogger = this.logger;
-                const coastMetrics = metrics !== undefined ? this.metrics : undefined;
-                const resolvedExtras = resolveOption(extraLogFieldsOption, this, coastLogger, 'extraLogFields');
-                const resolvedTags = resolveOption(extraTagsOption, this, coastLogger, 'metrics.extraTags');
+                const coastLogger = logExecutionEnabled ? this.logger : undefined;
+                const coastMetrics = collectMetricsEnabled ? this.metrics : undefined;
+                const shouldLog = coastLogger !== undefined && isSampledIn(samplePercentage);
+                const resolvedExtras = shouldLog
+                    ? resolveOption(extraLogFieldsOption, this, coastLogger, 'logExecution.extraLogFields')
+                    : undefined;
+                const resolvedTags = coastMetrics !== undefined
+                    ? resolveOption(extraTagsOption, this, coastLogger, 'collectMetrics.extraTags')
+                    : undefined;
                 const className = target.constructor?.name;
                 let callSucceeded = true;
                 let capturedError;
-                const sensitiveParameters = Reflect.getOwnMetadata(SensitiveSymbol_1.SENSITIVE, target, method);
-                const indexesToSkip = new Set([]);
-                if (sensitiveParameters) {
-                    sensitiveParameters.keys.map((i) => i.index).forEach((idx) => indexesToSkip.add(idx));
-                }
-                const loggableArguments = [];
-                for (let i = 0; i < arguments.length; i++) {
-                    if (!indexesToSkip.has(i)) {
-                        loggableArguments.push({ value: arguments[i], redaction: undefined });
+                if (shouldLog) {
+                    const sensitiveParameters = Reflect.getOwnMetadata(SensitiveSymbol_1.SENSITIVE, target, method);
+                    const indexesToSkip = new Set([]);
+                    if (sensitiveParameters) {
+                        sensitiveParameters.keys.map((i) => i.index).forEach((idx) => indexesToSkip.add(idx));
                     }
-                    else {
-                        loggableArguments.push({
-                            value: arguments[i],
-                            redaction: sensitiveParameters.keys.find((key) => key.index === i)?.redaction,
-                        });
+                    const loggableArguments = [];
+                    for (let i = 0; i < arguments.length; i++) {
+                        if (!indexesToSkip.has(i)) {
+                            loggableArguments.push({ value: arguments[i], redaction: undefined });
+                        }
+                        else {
+                            loggableArguments.push({
+                                value: arguments[i],
+                                redaction: sensitiveParameters.keys.find((key) => key.index === i)?.redaction,
+                            });
+                        }
                     }
+                    logMethodStart(className, method.toString(), coastLogger, loggableArguments, resolvedExtras);
                 }
-                logMethodStart(className, method.toString(), coastLogger, loggableArguments, resolvedExtras);
                 const startTime = process.hrtime.bigint();
                 const finish = () => {
                     const endTime = process.hrtime.bigint();
                     const latencyMs = Number(endTime - startTime) / 1_000_000;
-                    logMethodResult(className, method, callSucceeded, latencyMs, coastLogger, resolvedExtras, capturedError);
+                    if (shouldLog) {
+                        logMethodResult(className, method, callSucceeded, latencyMs, coastLogger, resolvedExtras, capturedError);
+                    }
                     if (coastMetrics !== undefined) {
                         emitMethodMetrics(className, method, callSucceeded, latencyMs, coastMetrics, resolvedTags, capturedError);
                     }
@@ -87,6 +104,12 @@ function LogMethod(options) {
         return descriptor;
     };
 }
+function isSampledIn(samplePercentage) {
+    if (samplePercentage === undefined) {
+        return true;
+    }
+    return Math.random() * 100 < samplePercentage;
+}
 function resolveOption(option, self, coastLogger, fieldName) {
     if (typeof option !== 'function') {
         return option;
@@ -96,7 +119,7 @@ function resolveOption(option, self, coastLogger, fieldName) {
     }
     catch (e) {
         coastLogger?.warn({
-            msg: `LogMethod ${fieldName} resolver threw; falling back without it`,
+            msg: `ObserveMethod ${fieldName} resolver threw; falling back without it`,
             errorClass: e instanceof Error ? e.constructor.name : undefined,
         });
         return undefined;
@@ -146,4 +169,4 @@ function emitMethodMetrics(className, methodName, callSucceeded, latencyMs, coas
     coastMetrics.counter('method.invocations', 1, attrs);
     coastMetrics.histogram('method.latency_ms', latencyMs, attrs);
 }
-//# sourceMappingURL=LogMethod.js.map
+//# sourceMappingURL=ObserveMethod.js.map

package/dist/lib/observe/ObserveMethod.js.map

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

package/dist/lib/observe/ObserveMethodOptions.d.ts

@@ -0,0 +1,6 @@
+import { CollectMetricsOptions } from './CollectMetricsOptions';
+import { LogExecutionOptions } from './LogExecutionOptions';
+export interface ObserveMethodOptions<T = unknown> {
+    logExecution?: boolean | LogExecutionOptions<T>;
+    collectMetrics?: boolean | CollectMetricsOptions<T>;
+}

package/dist/lib/{logger/MetricsConfig.js → observe/ObserveMethodOptions.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=MetricsConfig.js.map
+//# sourceMappingURL=ObserveMethodOptions.js.map

package/dist/lib/observe/ObserveMethodOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserveMethodOptions.js","sourceRoot":"","sources":["../../../lib/observe/ObserveMethodOptions.ts"],"names":[],"mappings":""}

package/dist/lib/observe/test/FakeUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeUser.js","sourceRoot":"","sources":["../../../../lib/observe/test/FakeUser.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,gFAA6E;AAE7E,MAAa,QAAQ;IAArB;QACW,WAAM,GAAG,QAAQ,CAAC;QAGlB,cAAS,GAAG,mBAAmB,CAAC;IAC3C,CAAC;CAAA;AALD,4BAKC;AADU;IADN,IAAA,qBAAS,GAAE;;2CAC2B"}

package/dist/lib/observe/test/ObserveMethodMetricsTestModule.d.ts

@@ -0,0 +1,2 @@
+export declare class ObserveMethodMetricsTestModule {
+}

package/dist/lib/{logger/test/LogMethodMetricsTestModule.js → observe/test/ObserveMethodMetricsTestModule.js}

@@ -6,21 +6,21 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogMethodMetricsTestModule = void 0;
+exports.ObserveMethodMetricsTestModule = void 0;
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
+const LoggerModule_1 = require("../../logger/LoggerModule");
 const CoastMetrics_1 = require("../../metrics/CoastMetrics");
-const LoggerModule_1 = require("../LoggerModule");
-const TestMetricsLoggedMethods_1 = require("./TestMetricsLoggedMethods");
+const TestObserveMetricsMethods_1 = require("./TestObserveMetricsMethods");
 const stubMetricService = {
     getGauge: () => ({ record: () => { } }),
     getHistogram: () => ({ record: () => { } }),
     getCounter: () => ({ add: () => { } }),
 };
-let LogMethodMetricsTestModule = class LogMethodMetricsTestModule {
+let ObserveMethodMetricsTestModule = class ObserveMethodMetricsTestModule {
 };
-exports.LogMethodMetricsTestModule = LogMethodMetricsTestModule;
-exports.LogMethodMetricsTestModule = LogMethodMetricsTestModule = __decorate([
+exports.ObserveMethodMetricsTestModule = ObserveMethodMetricsTestModule;
+exports.ObserveMethodMetricsTestModule = ObserveMethodMetricsTestModule = __decorate([
     (0, common_1.Module)({
         imports: [
             config_1.ConfigModule.forRoot({
@@ -35,7 +35,7 @@ exports.LogMethodMetricsTestModule = LogMethodMetricsTestModule = __decorate([
                 }),
             }),
         ],
-        providers: [{ provide: CoastMetrics_1.CoastMetrics, useValue: new CoastMetrics_1.CoastMetrics(stubMetricService) }, TestMetricsLoggedMethods_1.TestMetricsLoggedMethods],
+        providers: [{ provide: CoastMetrics_1.CoastMetrics, useValue: new CoastMetrics_1.CoastMetrics(stubMetricService) }, TestObserveMetricsMethods_1.TestObserveMetricsMethods],
     })
-], LogMethodMetricsTestModule);
-//# sourceMappingURL=LogMethodMetricsTestModule.js.map
+], ObserveMethodMetricsTestModule);
+//# sourceMappingURL=ObserveMethodMetricsTestModule.js.map

package/dist/lib/observe/test/ObserveMethodMetricsTestModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserveMethodMetricsTestModule.js","sourceRoot":"","sources":["../../../../lib/observe/test/ObserveMethodMetricsTestModule.ts"],"names":[],"mappings":";;;;;;;;;AACA,2CAAwC;AACxC,2CAA6D;AAG7D,4DAAyD;AACzD,6DAA0D;AAC1D,2EAAwE;AAExE,MAAM,iBAAiB,GAAG;IACtB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAS,EAAE,GAAE,CAAC,EAAE,CAAC;IAC5C,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAS,EAAE,GAAE,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAS,EAAE,GAAE,CAAC,EAAE,CAAC;CAClB,CAAC;AAkBvB,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;CAAG,CAAA;AAAjC,wEAA8B;yCAA9B,8BAA8B;IAhB1C,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE;YACL,qBAAY,CAAC,OAAO,CAAC;gBACjB,QAAQ,EAAE,IAAI;aACjB,CAAC;YACF,2BAAY,CAAC,YAAY,CAAC;gBACtB,OAAO,EAAE,CAAC,qBAAY,CAAC;gBACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,KAAK,EAAE,aAA4B,EAAE,EAAE,CAAC,CAAC;oBACjD,KAAK,EAAE,aAAa,CAAC,GAAG,CAAW,WAAW,CAAC;oBAC/C,MAAM,EAAE,aAAa,CAAC,GAAG,CAAU,YAAY,CAAC;iBACnD,CAAC;aACL,CAAC;SACL;QACD,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,2BAAY,EAAE,QAAQ,EAAE,IAAI,2BAAY,CAAC,iBAAiB,CAAC,EAAE,EAAE,qDAAyB,CAAC;KACnH,CAAC;GACW,8BAA8B,CAAG"}

package/dist/lib/observe/test/ObserveMethodTestModule.d.ts

@@ -0,0 +1,2 @@
+export declare class ObserveMethodTestModule {
+}

package/dist/lib/{logger/test/LogMethodTestModule.js → observe/test/ObserveMethodTestModule.js}

@@ -6,15 +6,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogMethodTestModule = void 0;
+exports.ObserveMethodTestModule = void 0;
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
-const LoggerModule_1 = require("../LoggerModule");
-const TestLoggedMethods_1 = require("./TestLoggedMethods");
-let LogMethodTestModule = class LogMethodTestModule {
+const LoggerModule_1 = require("../../logger/LoggerModule");
+const TestObservedMethods_1 = require("./TestObservedMethods");
+let ObserveMethodTestModule = class ObserveMethodTestModule {
 };
-exports.LogMethodTestModule = LogMethodTestModule;
-exports.LogMethodTestModule = LogMethodTestModule = __decorate([
+exports.ObserveMethodTestModule = ObserveMethodTestModule;
+exports.ObserveMethodTestModule = ObserveMethodTestModule = __decorate([
     (0, common_1.Module)({
         imports: [
             config_1.ConfigModule.forRoot({
@@ -29,7 +29,7 @@ exports.LogMethodTestModule = LogMethodTestModule = __decorate([
                 }),
             }),
         ],
-        providers: [TestLoggedMethods_1.TestLoggedMethods],
+        providers: [TestObservedMethods_1.TestObservedMethods],
     })
-], LogMethodTestModule);
-//# sourceMappingURL=LogMethodTestModule.js.map
+], ObserveMethodTestModule);
+//# sourceMappingURL=ObserveMethodTestModule.js.map

package/dist/lib/observe/test/ObserveMethodTestModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObserveMethodTestModule.js","sourceRoot":"","sources":["../../../../lib/observe/test/ObserveMethodTestModule.ts"],"names":[],"mappings":";;;;;;;;;AACA,2CAAwC;AACxC,2CAA6D;AAE7D,4DAAyD;AACzD,+DAA4D;AAkBrD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;CAAG,CAAA;AAA1B,0DAAuB;kCAAvB,uBAAuB;IAhBnC,IAAA,eAAM,EAAC;QACJ,OAAO,EAAE;YACL,qBAAY,CAAC,OAAO,CAAC;gBACjB,QAAQ,EAAE,IAAI;aACjB,CAAC;YACF,2BAAY,CAAC,YAAY,CAAC;gBACtB,OAAO,EAAE,CAAC,qBAAY,CAAC;gBACvB,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,KAAK,EAAE,aAA4B,EAAE,EAAE,CAAC,CAAC;oBACjD,KAAK,EAAE,aAAa,CAAC,GAAG,CAAW,WAAW,CAAC;oBAC/C,MAAM,EAAE,aAAa,CAAC,GAAG,CAAU,YAAY,CAAC;iBACnD,CAAC;aACL,CAAC;SACL;QACD,SAAS,EAAE,CAAC,yCAAmB,CAAC;KACnC,CAAC;GACW,uBAAuB,CAAG"}

package/dist/lib/{logger/test/TestMetricsLoggedMethods.d.ts → observe/test/TestObserveMetricsMethods.d.ts}

@@ -1,7 +1,7 @@
 interface Named {
     name: string;
 }
-export declare class TestMetricsLoggedMethods implements Named {
+export declare class TestObserveMetricsMethods implements Named {
     readonly name = "metrics_test_class";
     metricsNoTags(): void;
     metricsWithTagsAndLogFields(): void;

package/dist/lib/{logger/test/TestMetricsLoggedMethods.js → observe/test/TestObserveMetricsMethods.js}

@@ -9,16 +9,16 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestMetricsLoggedMethods = void 0;
+exports.TestObserveMetricsMethods = void 0;
 const common_1 = require("@nestjs/common");
-const LogMethod_1 = require("../LogMethod");
+const ObserveMethod_1 = require("../ObserveMethod");
 class FakeError extends Error {
     constructor() {
         super('metrics test boom');
         this.name = 'FakeError';
     }
 }
-let TestMetricsLoggedMethods = class TestMetricsLoggedMethods {
+let TestObserveMetricsMethods = class TestObserveMetricsMethods {
     constructor() {
         this.name = 'metrics_test_class';
     }
@@ -39,61 +39,61 @@ let TestMetricsLoggedMethods = class TestMetricsLoggedMethods {
     metricsWithFunctionTags() { }
     metricsWithThrowingTagsResolver() { }
 };
-exports.TestMetricsLoggedMethods = TestMetricsLoggedMethods;
+exports.TestObserveMetricsMethods = TestObserveMetricsMethods;
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: {} }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: true }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsNoTags", null);
+], TestObserveMetricsMethods.prototype, "metricsNoTags", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({
-        extraLogFields: { requestId: 'high-cardinality-ok' },
-        metrics: { extraTags: { toolName: 'create_automation' } },
+    (0, ObserveMethod_1.ObserveMethod)({
+        logExecution: { extraLogFields: { requestId: 'high-cardinality-ok' } },
+        collectMetrics: { extraTags: { toolName: 'create_automation' } },
     }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsWithTagsAndLogFields", null);
+], TestObserveMetricsMethods.prototype, "metricsWithTagsAndLogFields", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: { extraTags: { toolName: 'async_resolve' } } }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: { extraTags: { toolName: 'async_resolve' } } }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", Promise)
-], TestMetricsLoggedMethods.prototype, "metricsAsyncResolve", null);
+], TestObserveMetricsMethods.prototype, "metricsAsyncResolve", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: { extraTags: { toolName: 'async_reject' } } }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: { extraTags: { toolName: 'async_reject' } } }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", Promise)
-], TestMetricsLoggedMethods.prototype, "metricsAsyncReject", null);
+], TestObserveMetricsMethods.prototype, "metricsAsyncReject", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: { extraTags: { toolName: 'sync_throw' } } }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: { extraTags: { toolName: 'sync_throw' } } }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsSyncThrow", null);
+], TestObserveMetricsMethods.prototype, "metricsSyncThrow", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: { extraTags: { method: 'overridden', toolName: 'collision' } } }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: { extraTags: { method: 'overridden', toolName: 'collision' } } }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsTagsCollision", null);
+], TestObserveMetricsMethods.prototype, "metricsTagsCollision", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)(),
+    (0, ObserveMethod_1.ObserveMethod)(),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "noMetricsConfig", null);
+], TestObserveMetricsMethods.prototype, "noMetricsConfig", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({ metrics: { extraTags: (self) => ({ toolName: self.name }) } }),
+    (0, ObserveMethod_1.ObserveMethod)({ logExecution: false, collectMetrics: { extraTags: (self) => ({ toolName: self.name }) } }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsWithFunctionTags", null);
+], TestObserveMetricsMethods.prototype, "metricsWithFunctionTags", null);
 __decorate([
-    (0, LogMethod_1.LogMethod)({
-        metrics: {
+    (0, ObserveMethod_1.ObserveMethod)({
+        collectMetrics: {
             extraTags: () => {
                 throw new Error('tags resolver boom');
             },
@@ -102,8 +102,8 @@ __decorate([
     __metadata("design:type", Function),
     __metadata("design:paramtypes", []),
     __metadata("design:returntype", void 0)
-], TestMetricsLoggedMethods.prototype, "metricsWithThrowingTagsResolver", null);
-exports.TestMetricsLoggedMethods = TestMetricsLoggedMethods = __decorate([
+], TestObserveMetricsMethods.prototype, "metricsWithThrowingTagsResolver", null);
+exports.TestObserveMetricsMethods = TestObserveMetricsMethods = __decorate([
     (0, common_1.Injectable)()
-], TestMetricsLoggedMethods);
-//# sourceMappingURL=TestMetricsLoggedMethods.js.map
+], TestObserveMetricsMethods);
+//# sourceMappingURL=TestObserveMetricsMethods.js.map

package/dist/lib/observe/test/TestObserveMetricsMethods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestObserveMetricsMethods.js","sourceRoot":"","sources":["../../../../lib/observe/test/TestObserveMetricsMethods.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,oDAAiD;AAEjD,MAAM,SAAU,SAAQ,KAAK;IACzB;QACI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC5B,CAAC;CACJ;AAOM,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IAA/B;QACa,SAAI,GAAG,oBAAoB,CAAC;IA4ChD,CAAC;IAzCG,aAAa,KAAU,CAAC;IAMxB,2BAA2B,KAAU,CAAC;IAGhC,AAAN,KAAK,CAAC,mBAAmB;QACrB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IAGK,AAAN,KAAK,CAAC,kBAAkB;QACpB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,EAAE,CAAC;IAC1B,CAAC;IAGD,gBAAgB;QACZ,MAAM,IAAI,SAAS,EAAE,CAAC;IAC1B,CAAC;IAGD,oBAAoB,KAAU,CAAC;IAG/B,eAAe,KAAU,CAAC;IAG1B,uBAAuB,KAAU,CAAC;IASlC,+BAA+B,KAAU,CAAC;CAC7C,CAAA;AA7CY,8DAAyB;AAIlC;IADC,IAAA,6BAAa,EAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;;;;8DACrC;AAMxB;IAJC,IAAA,6BAAa,EAAC;QACX,YAAY,EAAE,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,EAAE;QACtE,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,EAAE;KACnE,CAAC;;;;4EACoC;AAGhC;IADL,IAAA,6BAAa,EAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;;;;oEAGpG;AAGK;IADL,IAAA,6BAAa,EAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;;;;mEAInG;AAGD;IADC,IAAA,6BAAa,EAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;;;;iEAGjG;AAGD;IADC,IAAA,6BAAa,EAAC,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;;;;qEACxF;AAG/B;IADC,IAAA,6BAAa,GAAE;;;;gEACU;AAG1B;IADC,IAAA,6BAAa,EAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;;;;wEAChF;AASlC;IAPC,IAAA,6BAAa,EAAC;QACX,cAAc,EAAE;YACZ,SAAS,EAAE,GAAG,EAAE;gBACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1C,CAAC;SACJ;KACJ,CAAC;;;;gFACwC;oCA5CjC,yBAAyB;IADrC,IAAA,mBAAU,GAAE;GACA,yBAAyB,CA6CrC"}

package/dist/lib/{logger/test/TestLoggedMethods.d.ts → observe/test/TestObservedMethods.d.ts}

@@ -2,7 +2,7 @@ import { FakeUser } from './FakeUser';
 interface Named {
     name: string;
 }
-export declare class TestLoggedMethods implements Named {
+export declare class TestObservedMethods implements Named {
     readonly name = "test_class";
     counter: number;
     logStartAndEnd(): void;
@@ -32,5 +32,8 @@ export declare class TestLoggedMethods implements Named {
     logAsyncWithFunctionExtras(): Promise<void>;
     logMutatesCounter(): void;
     logWithThrowingResolver(): void;
+    logExecutionDisabled(): void;
+    logSampledOut(): void;
+    logSampledIn(): void;
 }
 export {};