@spinajs/log 2.0.480 → 2.0.482
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +744 -0
- package/lib/cjs/archive/LogArchiveService.d.ts +75 -0
- package/lib/cjs/archive/LogArchiveService.d.ts.map +1 -0
- package/lib/cjs/archive/LogArchiveService.js +189 -0
- package/lib/cjs/archive/LogArchiveService.js.map +1 -0
- package/lib/cjs/archive/archive-strategy.d.ts +32 -0
- package/lib/cjs/archive/archive-strategy.d.ts.map +1 -0
- package/lib/cjs/archive/archive-strategy.js +43 -0
- package/lib/cjs/archive/archive-strategy.js.map +1 -0
- package/lib/cjs/archive/context.d.ts +50 -0
- package/lib/cjs/archive/context.d.ts.map +1 -0
- package/lib/cjs/archive/context.js +3 -0
- package/lib/cjs/archive/context.js.map +1 -0
- package/lib/cjs/archive/index.d.ts +10 -0
- package/lib/cjs/archive/index.d.ts.map +1 -0
- package/lib/cjs/archive/index.js +26 -0
- package/lib/cjs/archive/index.js.map +1 -0
- package/lib/cjs/archive/retention-strategy.d.ts +26 -0
- package/lib/cjs/archive/retention-strategy.d.ts.map +1 -0
- package/lib/cjs/archive/retention-strategy.js +42 -0
- package/lib/cjs/archive/retention-strategy.js.map +1 -0
- package/lib/cjs/archive/strategies/AgeLogRetentionStrategy.d.ts +10 -0
- package/lib/cjs/archive/strategies/AgeLogRetentionStrategy.d.ts.map +1 -0
- package/lib/cjs/archive/strategies/AgeLogRetentionStrategy.js +46 -0
- package/lib/cjs/archive/strategies/AgeLogRetentionStrategy.js.map +1 -0
- package/lib/cjs/archive/strategies/CountLogRetentionStrategy.d.ts +10 -0
- package/lib/cjs/archive/strategies/CountLogRetentionStrategy.d.ts.map +1 -0
- package/lib/cjs/archive/strategies/CountLogRetentionStrategy.js +42 -0
- package/lib/cjs/archive/strategies/CountLogRetentionStrategy.js.map +1 -0
- package/lib/cjs/archive/strategies/CronLogArchiveStrategy.d.ts +15 -0
- package/lib/cjs/archive/strategies/CronLogArchiveStrategy.d.ts.map +1 -0
- package/lib/cjs/archive/strategies/CronLogArchiveStrategy.js +52 -0
- package/lib/cjs/archive/strategies/CronLogArchiveStrategy.js.map +1 -0
- package/lib/cjs/archive/strategies/SizeLogArchiveStrategy.d.ts +18 -0
- package/lib/cjs/archive/strategies/SizeLogArchiveStrategy.d.ts.map +1 -0
- package/lib/cjs/archive/strategies/SizeLogArchiveStrategy.js +63 -0
- package/lib/cjs/archive/strategies/SizeLogArchiveStrategy.js.map +1 -0
- package/lib/cjs/archive/strategies/util.d.ts +28 -0
- package/lib/cjs/archive/strategies/util.d.ts.map +1 -0
- package/lib/cjs/archive/strategies/util.js +59 -0
- package/lib/cjs/archive/strategies/util.js.map +1 -0
- package/lib/cjs/bootstrap.d.ts.map +1 -1
- package/lib/cjs/bootstrap.js +24 -1
- package/lib/cjs/bootstrap.js.map +1 -1
- package/lib/cjs/callsite.d.ts +26 -0
- package/lib/cjs/callsite.d.ts.map +1 -0
- package/lib/cjs/callsite.js +60 -0
- package/lib/cjs/callsite.js.map +1 -0
- package/lib/cjs/config/log.d.ts +96 -0
- package/lib/cjs/config/log.d.ts.map +1 -0
- package/lib/cjs/config/log.js +75 -0
- package/lib/cjs/config/log.js.map +1 -0
- package/lib/cjs/context.browser.d.ts +46 -0
- package/lib/cjs/context.browser.d.ts.map +1 -0
- package/lib/cjs/context.browser.js +85 -0
- package/lib/cjs/context.browser.js.map +1 -0
- package/lib/cjs/context.d.ts +61 -0
- package/lib/cjs/context.d.ts.map +1 -0
- package/lib/cjs/context.js +92 -0
- package/lib/cjs/context.js.map +1 -0
- package/lib/cjs/filters/LevelFilter.d.ts +24 -0
- package/lib/cjs/filters/LevelFilter.d.ts.map +1 -0
- package/lib/cjs/filters/LevelFilter.js +39 -0
- package/lib/cjs/filters/LevelFilter.js.map +1 -0
- package/lib/cjs/filters/MatchFilter.d.ts +30 -0
- package/lib/cjs/filters/MatchFilter.d.ts.map +1 -0
- package/lib/cjs/filters/MatchFilter.js +65 -0
- package/lib/cjs/filters/MatchFilter.js.map +1 -0
- package/lib/cjs/filters/RateLimitFilter.d.ts +37 -0
- package/lib/cjs/filters/RateLimitFilter.d.ts.map +1 -0
- package/lib/cjs/filters/RateLimitFilter.js +70 -0
- package/lib/cjs/filters/RateLimitFilter.js.map +1 -0
- package/lib/cjs/filters/index.d.ts +4 -0
- package/lib/cjs/filters/index.d.ts.map +1 -0
- package/lib/cjs/filters/index.js +20 -0
- package/lib/cjs/filters/index.js.map +1 -0
- package/lib/cjs/index.browser.d.ts +14 -0
- package/lib/cjs/index.browser.d.ts.map +1 -0
- package/lib/cjs/index.browser.js +46 -0
- package/lib/cjs/index.browser.js.map +1 -0
- package/lib/cjs/index.d.ts +8 -0
- package/lib/cjs/index.d.ts.map +1 -1
- package/lib/cjs/index.js +8 -0
- package/lib/cjs/index.js.map +1 -1
- package/lib/cjs/log.d.ts +60 -1
- package/lib/cjs/log.d.ts.map +1 -1
- package/lib/cjs/log.js +294 -32
- package/lib/cjs/log.js.map +1 -1
- package/lib/cjs/perf/LogMetricSink.d.ts +28 -0
- package/lib/cjs/perf/LogMetricSink.d.ts.map +1 -0
- package/lib/cjs/perf/LogMetricSink.js +120 -0
- package/lib/cjs/perf/LogMetricSink.js.map +1 -0
- package/lib/cjs/perf/measure.d.ts +9 -0
- package/lib/cjs/perf/measure.d.ts.map +1 -0
- package/lib/cjs/perf/measure.js +21 -0
- package/lib/cjs/perf/measure.js.map +1 -0
- package/lib/cjs/perf.d.ts +9 -0
- package/lib/cjs/perf.d.ts.map +1 -0
- package/lib/cjs/perf.js +18 -0
- package/lib/cjs/perf.js.map +1 -0
- package/lib/cjs/schemas/log.configuration.d.ts +151 -18
- package/lib/cjs/schemas/log.configuration.d.ts.map +1 -1
- package/lib/cjs/schemas/log.configuration.js +154 -21
- package/lib/cjs/schemas/log.configuration.js.map +1 -1
- package/lib/cjs/targets/BrowserConsoleTarget.d.ts +48 -0
- package/lib/cjs/targets/BrowserConsoleTarget.d.ts.map +1 -0
- package/lib/cjs/targets/BrowserConsoleTarget.js +48 -0
- package/lib/cjs/targets/BrowserConsoleTarget.js.map +1 -0
- package/lib/cjs/targets/ColoredConsoleTarget.d.ts.map +1 -1
- package/lib/cjs/targets/ColoredConsoleTarget.js +21 -12
- package/lib/cjs/targets/ColoredConsoleTarget.js.map +1 -1
- package/lib/cjs/targets/FileTarget.d.ts +96 -20
- package/lib/cjs/targets/FileTarget.d.ts.map +1 -1
- package/lib/cjs/targets/FileTarget.js +188 -225
- package/lib/cjs/targets/FileTarget.js.map +1 -1
- package/lib/cjs/targets/JsonFileTarget.d.ts +19 -0
- package/lib/cjs/targets/JsonFileTarget.d.ts.map +1 -0
- package/lib/cjs/targets/JsonFileTarget.js +44 -0
- package/lib/cjs/targets/JsonFileTarget.js.map +1 -0
- package/lib/cjs/targets/JsonTarget.d.ts +27 -0
- package/lib/cjs/targets/JsonTarget.d.ts.map +1 -0
- package/lib/cjs/targets/JsonTarget.js +46 -0
- package/lib/cjs/targets/JsonTarget.js.map +1 -0
- package/lib/cjs/targets/MemoryTarget.d.ts +33 -0
- package/lib/cjs/targets/MemoryTarget.d.ts.map +1 -0
- package/lib/cjs/targets/MemoryTarget.js +63 -0
- package/lib/cjs/targets/MemoryTarget.js.map +1 -0
- package/lib/cjs/targets/index.d.ts +7 -0
- package/lib/cjs/targets/index.d.ts.map +1 -1
- package/lib/cjs/targets/index.js +7 -0
- package/lib/cjs/targets/index.js.map +1 -1
- package/lib/cjs/targets/wrappers/AutoFlushTarget.d.ts +37 -0
- package/lib/cjs/targets/wrappers/AutoFlushTarget.d.ts.map +1 -0
- package/lib/cjs/targets/wrappers/AutoFlushTarget.js +48 -0
- package/lib/cjs/targets/wrappers/AutoFlushTarget.js.map +1 -0
- package/lib/cjs/targets/wrappers/FallbackGroupTarget.d.ts +45 -0
- package/lib/cjs/targets/wrappers/FallbackGroupTarget.d.ts.map +1 -0
- package/lib/cjs/targets/wrappers/FallbackGroupTarget.js +94 -0
- package/lib/cjs/targets/wrappers/FallbackGroupTarget.js.map +1 -0
- package/lib/cjs/targets/wrappers/RetryingTarget.d.ts +44 -0
- package/lib/cjs/targets/wrappers/RetryingTarget.d.ts.map +1 -0
- package/lib/cjs/targets/wrappers/RetryingTarget.js +61 -0
- package/lib/cjs/targets/wrappers/RetryingTarget.js.map +1 -0
- package/lib/cjs/targets/wrappers/SplitGroupTarget.d.ts +30 -0
- package/lib/cjs/targets/wrappers/SplitGroupTarget.d.ts.map +1 -0
- package/lib/cjs/targets/wrappers/SplitGroupTarget.js +52 -0
- package/lib/cjs/targets/wrappers/SplitGroupTarget.js.map +1 -0
- package/lib/cjs/traceparent.d.ts +63 -0
- package/lib/cjs/traceparent.d.ts.map +1 -0
- package/lib/cjs/traceparent.js +107 -0
- package/lib/cjs/traceparent.js.map +1 -0
- package/lib/mjs/archive/LogArchiveService.d.ts +75 -0
- package/lib/mjs/archive/LogArchiveService.d.ts.map +1 -0
- package/lib/mjs/archive/LogArchiveService.js +186 -0
- package/lib/mjs/archive/LogArchiveService.js.map +1 -0
- package/lib/mjs/archive/archive-strategy.d.ts +32 -0
- package/lib/mjs/archive/archive-strategy.d.ts.map +1 -0
- package/lib/mjs/archive/archive-strategy.js +39 -0
- package/lib/mjs/archive/archive-strategy.js.map +1 -0
- package/lib/mjs/archive/context.d.ts +50 -0
- package/lib/mjs/archive/context.d.ts.map +1 -0
- package/lib/mjs/archive/context.js +2 -0
- package/lib/mjs/archive/context.js.map +1 -0
- package/lib/mjs/archive/index.d.ts +10 -0
- package/lib/mjs/archive/index.d.ts.map +1 -0
- package/lib/mjs/archive/index.js +10 -0
- package/lib/mjs/archive/index.js.map +1 -0
- package/lib/mjs/archive/retention-strategy.d.ts +26 -0
- package/lib/mjs/archive/retention-strategy.d.ts.map +1 -0
- package/lib/mjs/archive/retention-strategy.js +38 -0
- package/lib/mjs/archive/retention-strategy.js.map +1 -0
- package/lib/mjs/archive/strategies/AgeLogRetentionStrategy.d.ts +10 -0
- package/lib/mjs/archive/strategies/AgeLogRetentionStrategy.d.ts.map +1 -0
- package/lib/mjs/archive/strategies/AgeLogRetentionStrategy.js +43 -0
- package/lib/mjs/archive/strategies/AgeLogRetentionStrategy.js.map +1 -0
- package/lib/mjs/archive/strategies/CountLogRetentionStrategy.d.ts +10 -0
- package/lib/mjs/archive/strategies/CountLogRetentionStrategy.d.ts.map +1 -0
- package/lib/mjs/archive/strategies/CountLogRetentionStrategy.js +39 -0
- package/lib/mjs/archive/strategies/CountLogRetentionStrategy.js.map +1 -0
- package/lib/mjs/archive/strategies/CronLogArchiveStrategy.d.ts +15 -0
- package/lib/mjs/archive/strategies/CronLogArchiveStrategy.d.ts.map +1 -0
- package/lib/mjs/archive/strategies/CronLogArchiveStrategy.js +49 -0
- package/lib/mjs/archive/strategies/CronLogArchiveStrategy.js.map +1 -0
- package/lib/mjs/archive/strategies/SizeLogArchiveStrategy.d.ts +18 -0
- package/lib/mjs/archive/strategies/SizeLogArchiveStrategy.d.ts.map +1 -0
- package/lib/mjs/archive/strategies/SizeLogArchiveStrategy.js +60 -0
- package/lib/mjs/archive/strategies/SizeLogArchiveStrategy.js.map +1 -0
- package/lib/mjs/archive/strategies/util.d.ts +28 -0
- package/lib/mjs/archive/strategies/util.d.ts.map +1 -0
- package/lib/mjs/archive/strategies/util.js +54 -0
- package/lib/mjs/archive/strategies/util.js.map +1 -0
- package/lib/mjs/bootstrap.d.ts.map +1 -1
- package/lib/mjs/bootstrap.js +25 -2
- package/lib/mjs/bootstrap.js.map +1 -1
- package/lib/mjs/callsite.d.ts +26 -0
- package/lib/mjs/callsite.d.ts.map +1 -0
- package/lib/mjs/callsite.js +57 -0
- package/lib/mjs/callsite.js.map +1 -0
- package/lib/mjs/config/log.d.ts +96 -0
- package/lib/mjs/config/log.d.ts.map +1 -0
- package/lib/mjs/config/log.js +72 -0
- package/lib/mjs/config/log.js.map +1 -0
- package/lib/mjs/context.browser.d.ts +46 -0
- package/lib/mjs/context.browser.d.ts.map +1 -0
- package/lib/mjs/context.browser.js +81 -0
- package/lib/mjs/context.browser.js.map +1 -0
- package/lib/mjs/context.d.ts +61 -0
- package/lib/mjs/context.d.ts.map +1 -0
- package/lib/mjs/context.js +88 -0
- package/lib/mjs/context.js.map +1 -0
- package/lib/mjs/filters/LevelFilter.d.ts +24 -0
- package/lib/mjs/filters/LevelFilter.d.ts.map +1 -0
- package/lib/mjs/filters/LevelFilter.js +36 -0
- package/lib/mjs/filters/LevelFilter.js.map +1 -0
- package/lib/mjs/filters/MatchFilter.d.ts +30 -0
- package/lib/mjs/filters/MatchFilter.d.ts.map +1 -0
- package/lib/mjs/filters/MatchFilter.js +62 -0
- package/lib/mjs/filters/MatchFilter.js.map +1 -0
- package/lib/mjs/filters/RateLimitFilter.d.ts +37 -0
- package/lib/mjs/filters/RateLimitFilter.d.ts.map +1 -0
- package/lib/mjs/filters/RateLimitFilter.js +67 -0
- package/lib/mjs/filters/RateLimitFilter.js.map +1 -0
- package/lib/mjs/filters/index.d.ts +4 -0
- package/lib/mjs/filters/index.d.ts.map +1 -0
- package/lib/mjs/filters/index.js +4 -0
- package/lib/mjs/filters/index.js.map +1 -0
- package/lib/mjs/index.browser.d.ts +14 -0
- package/lib/mjs/index.browser.d.ts.map +1 -0
- package/lib/mjs/index.browser.js +30 -0
- package/lib/mjs/index.browser.js.map +1 -0
- package/lib/mjs/index.d.ts +8 -0
- package/lib/mjs/index.d.ts.map +1 -1
- package/lib/mjs/index.js +8 -0
- package/lib/mjs/index.js.map +1 -1
- package/lib/mjs/log.d.ts +60 -1
- package/lib/mjs/log.d.ts.map +1 -1
- package/lib/mjs/log.js +295 -33
- package/lib/mjs/log.js.map +1 -1
- package/lib/mjs/perf/LogMetricSink.d.ts +28 -0
- package/lib/mjs/perf/LogMetricSink.d.ts.map +1 -0
- package/lib/mjs/perf/LogMetricSink.js +117 -0
- package/lib/mjs/perf/LogMetricSink.js.map +1 -0
- package/lib/mjs/perf/measure.d.ts +9 -0
- package/lib/mjs/perf/measure.d.ts.map +1 -0
- package/lib/mjs/perf/measure.js +18 -0
- package/lib/mjs/perf/measure.js.map +1 -0
- package/lib/mjs/perf.d.ts +9 -0
- package/lib/mjs/perf.d.ts.map +1 -0
- package/lib/mjs/perf.js +15 -0
- package/lib/mjs/perf.js.map +1 -0
- package/lib/mjs/schemas/log.configuration.d.ts +151 -18
- package/lib/mjs/schemas/log.configuration.d.ts.map +1 -1
- package/lib/mjs/schemas/log.configuration.js +154 -21
- package/lib/mjs/schemas/log.configuration.js.map +1 -1
- package/lib/mjs/targets/BrowserConsoleTarget.d.ts +48 -0
- package/lib/mjs/targets/BrowserConsoleTarget.d.ts.map +1 -0
- package/lib/mjs/targets/BrowserConsoleTarget.js +45 -0
- package/lib/mjs/targets/BrowserConsoleTarget.js.map +1 -0
- package/lib/mjs/targets/ColoredConsoleTarget.d.ts.map +1 -1
- package/lib/mjs/targets/ColoredConsoleTarget.js +21 -9
- package/lib/mjs/targets/ColoredConsoleTarget.js.map +1 -1
- package/lib/mjs/targets/FileTarget.d.ts +96 -20
- package/lib/mjs/targets/FileTarget.d.ts.map +1 -1
- package/lib/mjs/targets/FileTarget.js +191 -192
- package/lib/mjs/targets/FileTarget.js.map +1 -1
- package/lib/mjs/targets/JsonFileTarget.d.ts +19 -0
- package/lib/mjs/targets/JsonFileTarget.d.ts.map +1 -0
- package/lib/mjs/targets/JsonFileTarget.js +41 -0
- package/lib/mjs/targets/JsonFileTarget.js.map +1 -0
- package/lib/mjs/targets/JsonTarget.d.ts +27 -0
- package/lib/mjs/targets/JsonTarget.d.ts.map +1 -0
- package/lib/mjs/targets/JsonTarget.js +43 -0
- package/lib/mjs/targets/JsonTarget.js.map +1 -0
- package/lib/mjs/targets/MemoryTarget.d.ts +33 -0
- package/lib/mjs/targets/MemoryTarget.d.ts.map +1 -0
- package/lib/mjs/targets/MemoryTarget.js +60 -0
- package/lib/mjs/targets/MemoryTarget.js.map +1 -0
- package/lib/mjs/targets/index.d.ts +7 -0
- package/lib/mjs/targets/index.d.ts.map +1 -1
- package/lib/mjs/targets/index.js +7 -0
- package/lib/mjs/targets/index.js.map +1 -1
- package/lib/mjs/targets/wrappers/AutoFlushTarget.d.ts +37 -0
- package/lib/mjs/targets/wrappers/AutoFlushTarget.d.ts.map +1 -0
- package/lib/mjs/targets/wrappers/AutoFlushTarget.js +45 -0
- package/lib/mjs/targets/wrappers/AutoFlushTarget.js.map +1 -0
- package/lib/mjs/targets/wrappers/FallbackGroupTarget.d.ts +45 -0
- package/lib/mjs/targets/wrappers/FallbackGroupTarget.d.ts.map +1 -0
- package/lib/mjs/targets/wrappers/FallbackGroupTarget.js +91 -0
- package/lib/mjs/targets/wrappers/FallbackGroupTarget.js.map +1 -0
- package/lib/mjs/targets/wrappers/RetryingTarget.d.ts +44 -0
- package/lib/mjs/targets/wrappers/RetryingTarget.d.ts.map +1 -0
- package/lib/mjs/targets/wrappers/RetryingTarget.js +58 -0
- package/lib/mjs/targets/wrappers/RetryingTarget.js.map +1 -0
- package/lib/mjs/targets/wrappers/SplitGroupTarget.d.ts +30 -0
- package/lib/mjs/targets/wrappers/SplitGroupTarget.d.ts.map +1 -0
- package/lib/mjs/targets/wrappers/SplitGroupTarget.js +49 -0
- package/lib/mjs/targets/wrappers/SplitGroupTarget.js.map +1 -0
- package/lib/mjs/traceparent.d.ts +63 -0
- package/lib/mjs/traceparent.d.ts.map +1 -0
- package/lib/mjs/traceparent.js +100 -0
- package/lib/mjs/traceparent.js.map +1 -0
- package/lib/tsconfig.cjs.tsbuildinfo +1 -1
- package/lib/tsconfig.mjs.tsbuildinfo +1 -1
- package/package.json +25 -15
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { ILogEntry } from "@spinajs/log-common";
|
|
2
|
+
import { FileTarget } from "./FileTarget.js";
|
|
3
|
+
/**
|
|
4
|
+
* Emits newline-delimited JSON ( NDJSON ) to a file through the FileTarget
|
|
5
|
+
* pipeline ( batched append, write-lock, rotation, retention, zip ): one
|
|
6
|
+
* structured JSON object per log entry so log collectors ( Loki, Elastic,
|
|
7
|
+
* Datadog ) can index fields directly rather than regex-parsing a layout.
|
|
8
|
+
*
|
|
9
|
+
* It subclasses the concrete FileTarget and overrides ONLY the per-entry
|
|
10
|
+
* serialization, reusing IFileTargetOptions unchanged. The inherited `layout`
|
|
11
|
+
* option is intentionally IGNORED ( JSON, not a string layout ). `time` is
|
|
12
|
+
* event-time: it is stamped in formatEntry, which runs in write() before the
|
|
13
|
+
* entry is buffered, so it reflects when the event was logged, not when the
|
|
14
|
+
* batch is flushed to disk.
|
|
15
|
+
*/
|
|
16
|
+
export declare class JsonFileTarget extends FileTarget {
|
|
17
|
+
protected formatEntry(data: ILogEntry): string;
|
|
18
|
+
}
|
|
19
|
+
//# sourceMappingURL=JsonFileTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JsonFileTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/JsonFileTarget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA2C,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,qBAEa,cAAe,SAAQ,UAAU;IAC5C,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;CAW/C"}
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
import { Injectable, PerInstanceCheck } from "@spinajs/di";
|
|
8
|
+
import { LogLevelToSeverityNumber, safeStringify } from "@spinajs/log-common";
|
|
9
|
+
import { FileTarget } from "./FileTarget.js";
|
|
10
|
+
/**
|
|
11
|
+
* Emits newline-delimited JSON ( NDJSON ) to a file through the FileTarget
|
|
12
|
+
* pipeline ( batched append, write-lock, rotation, retention, zip ): one
|
|
13
|
+
* structured JSON object per log entry so log collectors ( Loki, Elastic,
|
|
14
|
+
* Datadog ) can index fields directly rather than regex-parsing a layout.
|
|
15
|
+
*
|
|
16
|
+
* It subclasses the concrete FileTarget and overrides ONLY the per-entry
|
|
17
|
+
* serialization, reusing IFileTargetOptions unchanged. The inherited `layout`
|
|
18
|
+
* option is intentionally IGNORED ( JSON, not a string layout ). `time` is
|
|
19
|
+
* event-time: it is stamped in formatEntry, which runs in write() before the
|
|
20
|
+
* entry is buffered, so it reflects when the event was logged, not when the
|
|
21
|
+
* batch is flushed to disk.
|
|
22
|
+
*/
|
|
23
|
+
let JsonFileTarget = class JsonFileTarget extends FileTarget {
|
|
24
|
+
formatEntry(data) {
|
|
25
|
+
// data.Variables already carries level ( uppercase string ), logger,
|
|
26
|
+
// message, a structured error ( from the serializer registry ) and any
|
|
27
|
+
// merged fields. safeStringify / JSON.stringify naturally omit undefined
|
|
28
|
+
// ( eg. error when absent ).
|
|
29
|
+
return safeStringify({
|
|
30
|
+
time: new Date().toISOString(),
|
|
31
|
+
severityNumber: LogLevelToSeverityNumber[data.Level],
|
|
32
|
+
...data.Variables,
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
JsonFileTarget = __decorate([
|
|
37
|
+
PerInstanceCheck(),
|
|
38
|
+
Injectable("JsonFileTarget")
|
|
39
|
+
], JsonFileTarget);
|
|
40
|
+
export { JsonFileTarget };
|
|
41
|
+
//# sourceMappingURL=JsonFileTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JsonFileTarget.js","sourceRoot":"","sources":["../../../src/targets/JsonFileTarget.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAa,wBAAwB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,UAAU;IAClC,WAAW,CAAC,IAAe;QACnC,qEAAqE;QACrE,uEAAuE;QACvE,yEAAyE;QACzE,6BAA6B;QAC7B,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,cAAc,EAAE,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;YACpD,GAAG,IAAI,CAAC,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAZY,cAAc;IAF1B,gBAAgB,EAAE;IAClB,UAAU,CAAC,gBAAgB,CAAC;GAChB,cAAc,CAY1B"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { ICommonTargetOptions, ILogEntry, LogTarget } from "@spinajs/log-common";
|
|
2
|
+
/**
|
|
3
|
+
* Emits NDJSON ( newline-delimited JSON ) to stdout for machine ingestion:
|
|
4
|
+
* one structured JSON object per log entry instead of a formatted string, so
|
|
5
|
+
* log collectors ( Loki, Elastic, Datadog, container stdout ) can index fields
|
|
6
|
+
* directly rather than regex-parsing a layout.
|
|
7
|
+
*
|
|
8
|
+
* The inherited `layout` option is intentionally IGNORED - JSON is not a string
|
|
9
|
+
* layout. `time` is stamped at write; because this target is synchronous /
|
|
10
|
+
* unbuffered that is ~event time. An event-time-stamped, file-backed variant
|
|
11
|
+
* will come with the batching base in a later phase.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* Options for {@link JsonTarget}.
|
|
15
|
+
*/
|
|
16
|
+
export interface IJsonTargetOptions extends ICommonTargetOptions {
|
|
17
|
+
/**
|
|
18
|
+
* Which stream to write to. A single stream is the 12-factor norm for machine
|
|
19
|
+
* logs. Default is "stdout".
|
|
20
|
+
*/
|
|
21
|
+
stream?: "stdout" | "stderr";
|
|
22
|
+
}
|
|
23
|
+
export declare class JsonTarget extends LogTarget<IJsonTargetOptions> {
|
|
24
|
+
constructor(options: IJsonTargetOptions);
|
|
25
|
+
write(data: ILogEntry): void;
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=JsonTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JsonTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/JsonTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAA4B,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAG1H;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B;AAED,qBAEa,UAAW,SAAQ,SAAS,CAAC,kBAAkB,CAAC;gBAC/C,OAAO,EAAE,kBAAkB;IAMhC,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAoBpC"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
8
|
+
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
9
|
+
};
|
|
10
|
+
import { LogLevelToSeverityNumber, LogTarget, safeStringify } from "@spinajs/log-common";
|
|
11
|
+
import { Injectable, Singleton } from "@spinajs/di";
|
|
12
|
+
let JsonTarget = class JsonTarget extends LogTarget {
|
|
13
|
+
constructor(options) {
|
|
14
|
+
super(options);
|
|
15
|
+
this.Options = Object.assign({ stream: "stdout" }, this.Options);
|
|
16
|
+
}
|
|
17
|
+
write(data) {
|
|
18
|
+
if (!this.Options.enabled) {
|
|
19
|
+
return;
|
|
20
|
+
}
|
|
21
|
+
// data.Variables already carries level ( uppercase string ), logger,
|
|
22
|
+
// message, a structured error ( from the serializer registry ), and any
|
|
23
|
+
// merged fields. safeStringify / JSON.stringify naturally omit undefined
|
|
24
|
+
// ( eg. error when absent ).
|
|
25
|
+
const record = { time: new Date().toISOString(), severityNumber: LogLevelToSeverityNumber[data.Level], ...data.Variables };
|
|
26
|
+
const line = safeStringify(record) + "\n";
|
|
27
|
+
if (typeof process !== "undefined" && process.stdout && typeof process.stdout.write === "function") {
|
|
28
|
+
const out = this.Options.stream === "stderr" && process.stderr ? process.stderr : process.stdout;
|
|
29
|
+
out.write(line);
|
|
30
|
+
}
|
|
31
|
+
else {
|
|
32
|
+
// browser fallback
|
|
33
|
+
console.log(line.replace(/\n$/, ""));
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
};
|
|
37
|
+
JsonTarget = __decorate([
|
|
38
|
+
Singleton(),
|
|
39
|
+
Injectable("JsonTarget"),
|
|
40
|
+
__metadata("design:paramtypes", [Object])
|
|
41
|
+
], JsonTarget);
|
|
42
|
+
export { JsonTarget };
|
|
43
|
+
//# sourceMappingURL=JsonTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"JsonTarget.js","sourceRoot":"","sources":["../../../src/targets/JsonTarget.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAmC,wBAAwB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1H,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA2B7C,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,SAA6B;IAC3D,YAAY,OAA2B;QACrC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,IAAe;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,6BAA6B;QAC7B,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3H,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAE1C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACnG,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACjG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,mBAAmB;YACnB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;CACF,CAAA;AA3BY,UAAU;IAFtB,SAAS,EAAE;IACX,UAAU,CAAC,YAAY,CAAC;;GACZ,UAAU,CA2BtB"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { ICommonTargetOptions, ILogEntry, LogTarget } from "@spinajs/log-common";
|
|
2
|
+
/**
|
|
3
|
+
* Options for {@link MemoryTarget}.
|
|
4
|
+
*/
|
|
5
|
+
export interface IMemoryTargetOptions extends ICommonTargetOptions {
|
|
6
|
+
/**
|
|
7
|
+
* Max number of log entries retained in the ring buffer. Once exceeded, the
|
|
8
|
+
* oldest entries are dropped. Default is 100.
|
|
9
|
+
*/
|
|
10
|
+
limit: number;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Ring-buffer target that keeps the last N log entries in memory. Lets a debug
|
|
14
|
+
* / health endpoint or a crash handler read recent log context back in-process
|
|
15
|
+
* ( eg. capturing all levels incl. trace ) without parsing the log file.
|
|
16
|
+
*
|
|
17
|
+
* Pure and browser-safe - no filesystem, no timers, no external deps.
|
|
18
|
+
*/
|
|
19
|
+
export declare class MemoryTarget extends LogTarget<IMemoryTargetOptions> {
|
|
20
|
+
protected Buffer: ILogEntry[];
|
|
21
|
+
constructor(options: IMemoryTargetOptions);
|
|
22
|
+
write(data: ILogEntry): void;
|
|
23
|
+
/**
|
|
24
|
+
* Returns a shallow copy of the retained entries ( oldest first ) so callers
|
|
25
|
+
* cannot mutate the ring buffer.
|
|
26
|
+
*/
|
|
27
|
+
getRecords(): ILogEntry[];
|
|
28
|
+
/**
|
|
29
|
+
* Empties the buffer.
|
|
30
|
+
*/
|
|
31
|
+
clear(): void;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=MemoryTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MemoryTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/MemoryTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjF;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,qBAEa,YAAa,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAC/D,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM;gBAEvB,OAAO,EAAE,oBAAoB;IAalC,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAcnC;;;OAGG;IACI,UAAU,IAAI,SAAS,EAAE;IAIhC;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
8
|
+
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
9
|
+
};
|
|
10
|
+
import { LogTarget } from "@spinajs/log-common";
|
|
11
|
+
import { Injectable, Singleton } from "@spinajs/di";
|
|
12
|
+
/**
|
|
13
|
+
* Ring-buffer target that keeps the last N log entries in memory. Lets a debug
|
|
14
|
+
* / health endpoint or a crash handler read recent log context back in-process
|
|
15
|
+
* ( eg. capturing all levels incl. trace ) without parsing the log file.
|
|
16
|
+
*
|
|
17
|
+
* Pure and browser-safe - no filesystem, no timers, no external deps.
|
|
18
|
+
*/
|
|
19
|
+
let MemoryTarget = class MemoryTarget extends LogTarget {
|
|
20
|
+
constructor(options) {
|
|
21
|
+
super(options);
|
|
22
|
+
this.Buffer = [];
|
|
23
|
+
// apply defaults over the ( already layout-merged ) options, mirroring the
|
|
24
|
+
// Loki target's Object.assign approach.
|
|
25
|
+
this.Options = Object.assign({
|
|
26
|
+
limit: 100,
|
|
27
|
+
}, this.Options);
|
|
28
|
+
}
|
|
29
|
+
write(data) {
|
|
30
|
+
if (!this.Options.enabled) {
|
|
31
|
+
return;
|
|
32
|
+
}
|
|
33
|
+
this.Buffer.push(data);
|
|
34
|
+
// drop oldest while over the cap. splice ( rather than a single shift )
|
|
35
|
+
// handles a limit lowered at runtime, not just push-by-one growth.
|
|
36
|
+
if (this.Buffer.length > this.Options.limit) {
|
|
37
|
+
this.Buffer.splice(0, this.Buffer.length - this.Options.limit);
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Returns a shallow copy of the retained entries ( oldest first ) so callers
|
|
42
|
+
* cannot mutate the ring buffer.
|
|
43
|
+
*/
|
|
44
|
+
getRecords() {
|
|
45
|
+
return [...this.Buffer];
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Empties the buffer.
|
|
49
|
+
*/
|
|
50
|
+
clear() {
|
|
51
|
+
this.Buffer = [];
|
|
52
|
+
}
|
|
53
|
+
};
|
|
54
|
+
MemoryTarget = __decorate([
|
|
55
|
+
Singleton(),
|
|
56
|
+
Injectable("MemoryTarget"),
|
|
57
|
+
__metadata("design:paramtypes", [Object])
|
|
58
|
+
], MemoryTarget);
|
|
59
|
+
export { MemoryTarget };
|
|
60
|
+
//# sourceMappingURL=MemoryTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"MemoryTarget.js","sourceRoot":"","sources":["../../../src/targets/MemoryTarget.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAmC,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAapD;;;;;;GAMG;AAGI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,SAA+B;IAG/D,YAAY,OAA6B;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHP,WAAM,GAAgB,EAAE,CAAC;QAKjC,2EAA2E;QAC3E,wCAAwC;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAC1B;YACE,KAAK,EAAE,GAAG;SACX,EACD,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,IAAe;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvB,wEAAwE;QACxE,mEAAmE;QACnE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,UAAU;QACf,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF,CAAA;AA5CY,YAAY;IAFxB,SAAS,EAAE;IACX,UAAU,CAAC,cAAc,CAAC;;GACd,YAAY,CA4CxB"}
|
|
@@ -1,4 +1,11 @@
|
|
|
1
1
|
export * from "./BlackHoleTarget.js";
|
|
2
2
|
export * from "./ColoredConsoleTarget.js";
|
|
3
3
|
export * from "./FileTarget.js";
|
|
4
|
+
export * from "./JsonFileTarget.js";
|
|
5
|
+
export * from "./JsonTarget.js";
|
|
6
|
+
export * from "./MemoryTarget.js";
|
|
7
|
+
export * from "./wrappers/SplitGroupTarget.js";
|
|
8
|
+
export * from "./wrappers/AutoFlushTarget.js";
|
|
9
|
+
export * from "./wrappers/RetryingTarget.js";
|
|
10
|
+
export * from "./wrappers/FallbackGroupTarget.js";
|
|
4
11
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/targets/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/targets/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC"}
|
package/lib/mjs/targets/index.js
CHANGED
|
@@ -1,4 +1,11 @@
|
|
|
1
1
|
export * from "./BlackHoleTarget.js";
|
|
2
2
|
export * from "./ColoredConsoleTarget.js";
|
|
3
3
|
export * from "./FileTarget.js";
|
|
4
|
+
export * from "./JsonFileTarget.js";
|
|
5
|
+
export * from "./JsonTarget.js";
|
|
6
|
+
export * from "./MemoryTarget.js";
|
|
7
|
+
export * from "./wrappers/SplitGroupTarget.js";
|
|
8
|
+
export * from "./wrappers/AutoFlushTarget.js";
|
|
9
|
+
export * from "./wrappers/RetryingTarget.js";
|
|
10
|
+
export * from "./wrappers/FallbackGroupTarget.js";
|
|
4
11
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/targets/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/targets/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { ICommonTargetOptions, ILogEntry, ITargetsOption, LogTarget } from "@spinajs/log-common";
|
|
2
|
+
/**
|
|
3
|
+
* Options for {@link AutoFlushTarget}.
|
|
4
|
+
*/
|
|
5
|
+
export interface IAutoFlushTargetOptions extends ICommonTargetOptions {
|
|
6
|
+
options: {
|
|
7
|
+
/**
|
|
8
|
+
* Inline child target this wrapper decorates. Resolved through DI exactly
|
|
9
|
+
* like a top-level target.
|
|
10
|
+
*/
|
|
11
|
+
target: ITargetsOption;
|
|
12
|
+
/**
|
|
13
|
+
* Severity ( inclusive ) at or above which the inner target is force-flushed
|
|
14
|
+
* right after the entry is written, so a crash-level event is never left
|
|
15
|
+
* buffered. Default `"error"`.
|
|
16
|
+
*/
|
|
17
|
+
flushLevel?: string;
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Wraps ONE inner target and force-flushes it whenever an entry at or above
|
|
22
|
+
* `flushLevel` ( default error ) is written, so a high-severity / crash-level
|
|
23
|
+
* event is never left sitting in a buffer. The inner target is declared inline
|
|
24
|
+
* and owned by this wrapper ( resolve / flush / dispose ).
|
|
25
|
+
*
|
|
26
|
+
* Pure / browser-safe - just delegates to its child.
|
|
27
|
+
*/
|
|
28
|
+
export declare class AutoFlushTarget extends LogTarget<IAutoFlushTargetOptions> {
|
|
29
|
+
protected Inner: LogTarget<ICommonTargetOptions>;
|
|
30
|
+
/** Resolved numeric severity threshold at/above which we force-flush. */
|
|
31
|
+
protected Threshold: number;
|
|
32
|
+
resolve(): void;
|
|
33
|
+
write(entry: ILogEntry): Promise<void>;
|
|
34
|
+
forceFlush(): Promise<void>;
|
|
35
|
+
dispose(): Promise<void>;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=AutoFlushTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AutoFlushTarget.d.ts","sourceRoot":"","sources":["../../../../src/targets/wrappers/AutoFlushTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAGhH;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,OAAO,EAAE;QACP;;;WAGG;QACH,MAAM,EAAE,cAAc,CAAC;QAEvB;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,qBAEa,eAAgB,SAAQ,SAAS,CAAC,uBAAuB,CAAC;IACrE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAEjD,yEAAyE;IACzE,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAErB,OAAO,IAAI,IAAI;IAOT,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
import { LogTarget, StrToLogLevel } from "@spinajs/log-common";
|
|
8
|
+
import { DI, Injectable, Singleton } from "@spinajs/di";
|
|
9
|
+
/**
|
|
10
|
+
* Wraps ONE inner target and force-flushes it whenever an entry at or above
|
|
11
|
+
* `flushLevel` ( default error ) is written, so a high-severity / crash-level
|
|
12
|
+
* event is never left sitting in a buffer. The inner target is declared inline
|
|
13
|
+
* and owned by this wrapper ( resolve / flush / dispose ).
|
|
14
|
+
*
|
|
15
|
+
* Pure / browser-safe - just delegates to its child.
|
|
16
|
+
*/
|
|
17
|
+
let AutoFlushTarget = class AutoFlushTarget extends LogTarget {
|
|
18
|
+
resolve() {
|
|
19
|
+
this.Inner = DI.resolve(this.Options.options.target.type, [this.Options.options.target]);
|
|
20
|
+
this.Threshold = StrToLogLevel[(this.Options.options.flushLevel ?? "error")];
|
|
21
|
+
super.resolve();
|
|
22
|
+
}
|
|
23
|
+
async write(entry) {
|
|
24
|
+
if (!this.Options.enabled) {
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
// wrap in Promise.resolve because some targets' write is sync / void.
|
|
28
|
+
await Promise.resolve(this.Inner.write(entry));
|
|
29
|
+
if (entry.Level >= this.Threshold) {
|
|
30
|
+
await this.Inner.forceFlush();
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
forceFlush() {
|
|
34
|
+
return this.Inner.forceFlush();
|
|
35
|
+
}
|
|
36
|
+
async dispose() {
|
|
37
|
+
await this.Inner.dispose?.();
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
AutoFlushTarget = __decorate([
|
|
41
|
+
Singleton(),
|
|
42
|
+
Injectable("AutoFlushTarget")
|
|
43
|
+
], AutoFlushTarget);
|
|
44
|
+
export { AutoFlushTarget };
|
|
45
|
+
//# sourceMappingURL=AutoFlushTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"AutoFlushTarget.js","sourceRoot":"","sources":["../../../../src/targets/wrappers/AutoFlushTarget.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAmD,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsBxD;;;;;;;GAOG;AAGI,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,SAAkC;IAM9D,OAAO;QACZ,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,OAAO,CAAkC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1H,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAA+B,CAAC,CAAC;QAE3G,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAgB;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,sEAAsE;QACtE,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/C,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAEM,UAAU;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAO,IAAI,CAAC,KAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACxC,CAAC;CACF,CAAA;AAjCY,eAAe;IAF3B,SAAS,EAAE;IACX,UAAU,CAAC,iBAAiB,CAAC;GACjB,eAAe,CAiC3B"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { ICommonTargetOptions, ILogEntry, ITargetsOption, Log, LogTarget } from "@spinajs/log-common";
|
|
2
|
+
/**
|
|
3
|
+
* Options for {@link FallbackGroupTarget}.
|
|
4
|
+
*/
|
|
5
|
+
export interface IFallbackGroupTargetOptions extends ICommonTargetOptions {
|
|
6
|
+
options: {
|
|
7
|
+
/**
|
|
8
|
+
* ORDERED inline child target definitions: the PRIMARY first, then one or
|
|
9
|
+
* more fallbacks. Each is resolved through DI exactly like a top-level
|
|
10
|
+
* target, so any registered target type ( File, Loki, another wrapper ... )
|
|
11
|
+
* can be nested here.
|
|
12
|
+
*/
|
|
13
|
+
targets: ITargetsOption[];
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Failover wrapper: an ORDERED list of targets ( primary first, fallbacks
|
|
18
|
+
* after ). It handles TWO complementary failure modes so a durable fallback
|
|
19
|
+
* catches exactly what a down primary never delivered — with no duplicates:
|
|
20
|
+
*
|
|
21
|
+
* - **A ( immediate write rejection ).** `write()` tries the primary; if it
|
|
22
|
+
* REJECTS ( see the contract on {@link LogTarget.write} ) it advances to the
|
|
23
|
+
* next target, and so on, resolving on the first success. If every target
|
|
24
|
+
* rejects the last rejection is swallowed ( warn-only ) so logging never
|
|
25
|
+
* throws into the caller.
|
|
26
|
+
*
|
|
27
|
+
* - **D ( later async drop ).** Self-healing network targets ( Loki / OTLP )
|
|
28
|
+
* RESOLVE `write()` immediately and only later GIVE UP on an entry ( buffer
|
|
29
|
+
* overflow or a non-retryable delivery failure ). resolve() wires each
|
|
30
|
+
* target's {@link LogTarget.OnDropped} hook to the NEXT target's write, so
|
|
31
|
+
* those late drops spill down the chain to the fallback. The last target has
|
|
32
|
+
* no successor, so its OnDropped stays null.
|
|
33
|
+
*
|
|
34
|
+
* The inner targets are declared inline and owned by this wrapper ( resolve /
|
|
35
|
+
* flush / dispose ). Pure / browser-safe - just delegates to its children.
|
|
36
|
+
*/
|
|
37
|
+
export declare class FallbackGroupTarget extends LogTarget<IFallbackGroupTargetOptions> {
|
|
38
|
+
protected Log: Log;
|
|
39
|
+
protected Inner: LogTarget<ICommonTargetOptions>[];
|
|
40
|
+
resolve(): void;
|
|
41
|
+
write(entry: ILogEntry): Promise<void>;
|
|
42
|
+
forceFlush(): Promise<void>;
|
|
43
|
+
dispose(): Promise<void>;
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=FallbackGroupTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FallbackGroupTarget.d.ts","sourceRoot":"","sources":["../../../../src/targets/wrappers/FallbackGroupTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAU,GAAG,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG9G;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,OAAO,EAAE;QACP;;;;;WAKG;QACH,OAAO,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAEa,mBAAoB,SAAQ,SAAS,CAAC,2BAA2B,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAM;IAEjD,OAAO,IAAI,IAAI;IAoBT,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtC"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
8
|
+
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
9
|
+
};
|
|
10
|
+
import { Logger, Log, LogTarget } from "@spinajs/log-common";
|
|
11
|
+
import { DI, Injectable, Singleton } from "@spinajs/di";
|
|
12
|
+
/**
|
|
13
|
+
* Failover wrapper: an ORDERED list of targets ( primary first, fallbacks
|
|
14
|
+
* after ). It handles TWO complementary failure modes so a durable fallback
|
|
15
|
+
* catches exactly what a down primary never delivered — with no duplicates:
|
|
16
|
+
*
|
|
17
|
+
* - **A ( immediate write rejection ).** `write()` tries the primary; if it
|
|
18
|
+
* REJECTS ( see the contract on {@link LogTarget.write} ) it advances to the
|
|
19
|
+
* next target, and so on, resolving on the first success. If every target
|
|
20
|
+
* rejects the last rejection is swallowed ( warn-only ) so logging never
|
|
21
|
+
* throws into the caller.
|
|
22
|
+
*
|
|
23
|
+
* - **D ( later async drop ).** Self-healing network targets ( Loki / OTLP )
|
|
24
|
+
* RESOLVE `write()` immediately and only later GIVE UP on an entry ( buffer
|
|
25
|
+
* overflow or a non-retryable delivery failure ). resolve() wires each
|
|
26
|
+
* target's {@link LogTarget.OnDropped} hook to the NEXT target's write, so
|
|
27
|
+
* those late drops spill down the chain to the fallback. The last target has
|
|
28
|
+
* no successor, so its OnDropped stays null.
|
|
29
|
+
*
|
|
30
|
+
* The inner targets are declared inline and owned by this wrapper ( resolve /
|
|
31
|
+
* flush / dispose ). Pure / browser-safe - just delegates to its children.
|
|
32
|
+
*/
|
|
33
|
+
let FallbackGroupTarget = class FallbackGroupTarget extends LogTarget {
|
|
34
|
+
constructor() {
|
|
35
|
+
super(...arguments);
|
|
36
|
+
this.Inner = [];
|
|
37
|
+
}
|
|
38
|
+
resolve() {
|
|
39
|
+
// resolve each child via DI exactly like FrameworkLogger.resolveLogTargets
|
|
40
|
+
// does - the child's ITargetsOption is passed as the single ctor arg.
|
|
41
|
+
this.Inner = this.Options.options.targets.map((t) => DI.resolve(t.type, [t]));
|
|
42
|
+
// mechanism D: wire the drop-hook chain. For each consecutive pair, entries
|
|
43
|
+
// target[i] GIVES UP on flow to target[i+1].write. The last target has no
|
|
44
|
+
// fallback -> its OnDropped stays null.
|
|
45
|
+
for (let i = 0; i < this.Inner.length - 1; i++) {
|
|
46
|
+
const next = this.Inner[i + 1];
|
|
47
|
+
this.Inner[i].OnDropped = (entry) => {
|
|
48
|
+
void Promise.resolve(next.write(entry)).catch(() => {
|
|
49
|
+
/* fallback itself gave up - nothing more to do */
|
|
50
|
+
});
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
super.resolve();
|
|
54
|
+
}
|
|
55
|
+
async write(entry) {
|
|
56
|
+
if (!this.Options.enabled) {
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
// mechanism A: try each target in order; resolve on the first success. Only
|
|
60
|
+
// advance to the next when the current one REJECTS.
|
|
61
|
+
for (const t of this.Inner) {
|
|
62
|
+
try {
|
|
63
|
+
await Promise.resolve(t.write(entry));
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
/* rejected -> try the next fallback */
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
// every target rejected - swallow ( warn-only ) so logging never throws.
|
|
71
|
+
this.Log?.warn(`FallbackGroupTarget ${this.Options.name}: all ${this.Inner.length} targets rejected the entry.`);
|
|
72
|
+
}
|
|
73
|
+
forceFlush() {
|
|
74
|
+
return Promise.allSettled(this.Inner.map((t) => t.forceFlush())).then(() => undefined);
|
|
75
|
+
}
|
|
76
|
+
async dispose() {
|
|
77
|
+
// the wrapper owns its children ( they are not in the logger's Targets list )
|
|
78
|
+
// so it drives their teardown.
|
|
79
|
+
await Promise.allSettled(this.Inner.map((t) => t.dispose?.()));
|
|
80
|
+
}
|
|
81
|
+
};
|
|
82
|
+
__decorate([
|
|
83
|
+
Logger("FallbackGroupTarget"),
|
|
84
|
+
__metadata("design:type", Log)
|
|
85
|
+
], FallbackGroupTarget.prototype, "Log", void 0);
|
|
86
|
+
FallbackGroupTarget = __decorate([
|
|
87
|
+
Singleton(),
|
|
88
|
+
Injectable("FallbackGroupTarget")
|
|
89
|
+
], FallbackGroupTarget);
|
|
90
|
+
export { FallbackGroupTarget };
|
|
91
|
+
//# sourceMappingURL=FallbackGroupTarget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"FallbackGroupTarget.js","sourceRoot":"","sources":["../../../../src/targets/wrappers/FallbackGroupTarget.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAmD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9G,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBxD;;;;;;;;;;;;;;;;;;;;GAoBG;AAGI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,SAAsC;IAAxE;;QAIK,UAAK,GAAsC,EAAE,CAAC;IAmD1D,CAAC;IAjDQ,OAAO;QACZ,2EAA2E;QAC3E,sEAAsE;QACtE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAkC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/G,4EAA4E;QAC5E,0EAA0E;QAC1E,wCAAwC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,KAAgB,EAAE,EAAE;gBAC7C,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACjD,kDAAkD;gBACpD,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,KAAgB;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,4EAA4E;QAC5E,oDAAoD;QACpD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtC,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,uCAAuC;YACzC,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,uBAAuB,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,8BAA8B,CAAC,CAAC;IACnH,CAAC;IAEM,UAAU;QACf,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzF,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,8EAA8E;QAC9E,+BAA+B;QAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF,CAAA;AArDW;IADT,MAAM,CAAC,qBAAqB,CAAC;8BACf,GAAG;gDAAC;AAFR,mBAAmB;IAF/B,SAAS,EAAE;IACX,UAAU,CAAC,qBAAqB,CAAC;GACrB,mBAAmB,CAuD/B"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { ICommonTargetOptions, ILogEntry, ITargetsOption, LogTarget } from "@spinajs/log-common";
|
|
2
|
+
import { ResiliencePipeline } from "@spinajs/util";
|
|
3
|
+
/**
|
|
4
|
+
* Options for {@link RetryingTarget}.
|
|
5
|
+
*/
|
|
6
|
+
export interface IRetryingTargetOptions extends ICommonTargetOptions {
|
|
7
|
+
options: {
|
|
8
|
+
/**
|
|
9
|
+
* Inline child target this wrapper decorates. Resolved through DI exactly
|
|
10
|
+
* like a top-level target.
|
|
11
|
+
*/
|
|
12
|
+
target: ITargetsOption;
|
|
13
|
+
/**
|
|
14
|
+
* Total number of write attempts ( the first try plus retries ). Default 3.
|
|
15
|
+
*/
|
|
16
|
+
maxAttempts?: number;
|
|
17
|
+
/**
|
|
18
|
+
* Base delay in milliseconds between retries ( exponential backoff + jitter
|
|
19
|
+
* is applied on top ). Default 100.
|
|
20
|
+
*/
|
|
21
|
+
delayMs?: number;
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Wraps ONE inner target and RETRIES its `write` when it REJECTS, using the
|
|
26
|
+
* `@spinajs/util` resilience pipeline ( exponential backoff + jitter ). Only
|
|
27
|
+
* useful for targets that surface failure by rejecting ( console / custom /
|
|
28
|
+
* strict ) — self-healing targets ( File / Loki / OTLP ) own their reliability
|
|
29
|
+
* and resolve, so wrapping them is a no-op. See the write() rejection contract
|
|
30
|
+
* on {@link LogTarget.write}.
|
|
31
|
+
*
|
|
32
|
+
* The inner target is declared inline and owned by this wrapper ( resolve /
|
|
33
|
+
* flush / dispose ). Pure / browser-safe - just delegates to its child.
|
|
34
|
+
*/
|
|
35
|
+
export declare class RetryingTarget extends LogTarget<IRetryingTargetOptions> {
|
|
36
|
+
protected Inner: LogTarget<ICommonTargetOptions>;
|
|
37
|
+
/** Reusable retry pipeline guarding the inner write. */
|
|
38
|
+
protected RetryPipeline: ResiliencePipeline<void>;
|
|
39
|
+
resolve(): void;
|
|
40
|
+
write(entry: ILogEntry): Promise<void>;
|
|
41
|
+
forceFlush(): Promise<void>;
|
|
42
|
+
dispose(): Promise<void>;
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=RetryingTarget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RetryingTarget.d.ts","sourceRoot":"","sources":["../../../../src/targets/wrappers/RetryingTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEjG,OAAO,EAAe,kBAAkB,EAAuC,MAAM,eAAe,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,OAAO,EAAE;QACP;;;WAGG;QACH,MAAM,EAAE,cAAc,CAAC;QAEvB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,qBAEa,cAAe,SAAQ,SAAS,CAAC,sBAAsB,CAAC;IACnE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAEjD,wDAAwD;IACxD,SAAS,CAAC,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE3C,OAAO,IAAI,IAAI;IAoBf,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
2
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
3
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
4
|
+
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
5
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
6
|
+
};
|
|
7
|
+
import { LogTarget } from "@spinajs/log-common";
|
|
8
|
+
import { DI, Injectable, Singleton } from "@spinajs/di";
|
|
9
|
+
import { BackoffType, ResiliencePipelineBuilder, TimeSpan } from "@spinajs/util";
|
|
10
|
+
/**
|
|
11
|
+
* Wraps ONE inner target and RETRIES its `write` when it REJECTS, using the
|
|
12
|
+
* `@spinajs/util` resilience pipeline ( exponential backoff + jitter ). Only
|
|
13
|
+
* useful for targets that surface failure by rejecting ( console / custom /
|
|
14
|
+
* strict ) — self-healing targets ( File / Loki / OTLP ) own their reliability
|
|
15
|
+
* and resolve, so wrapping them is a no-op. See the write() rejection contract
|
|
16
|
+
* on {@link LogTarget.write}.
|
|
17
|
+
*
|
|
18
|
+
* The inner target is declared inline and owned by this wrapper ( resolve /
|
|
19
|
+
* flush / dispose ). Pure / browser-safe - just delegates to its child.
|
|
20
|
+
*/
|
|
21
|
+
let RetryingTarget = class RetryingTarget extends LogTarget {
|
|
22
|
+
resolve() {
|
|
23
|
+
this.Inner = DI.resolve(this.Options.options.target.type, [this.Options.options.target]);
|
|
24
|
+
const maxAttempts = this.Options.options.maxAttempts ?? 3;
|
|
25
|
+
const delayMs = this.Options.options.delayMs ?? 100;
|
|
26
|
+
// MaxRetryAttempts counts RETRIES ( on top of the first attempt ), so
|
|
27
|
+
// subtract one from the total attempt budget.
|
|
28
|
+
this.RetryPipeline = new ResiliencePipelineBuilder()
|
|
29
|
+
.addRetry({
|
|
30
|
+
MaxRetryAttempts: Math.max(0, maxAttempts - 1),
|
|
31
|
+
Delay: TimeSpan.fromMilliseconds(delayMs),
|
|
32
|
+
BackoffType: BackoffType.Exponential,
|
|
33
|
+
UseJitter: true,
|
|
34
|
+
})
|
|
35
|
+
.build();
|
|
36
|
+
super.resolve();
|
|
37
|
+
}
|
|
38
|
+
write(entry) {
|
|
39
|
+
if (!this.Options.enabled) {
|
|
40
|
+
return Promise.resolve();
|
|
41
|
+
}
|
|
42
|
+
// wrap in Promise.resolve because some targets' write is sync / void. The
|
|
43
|
+
// pipeline retries whenever the inner write REJECTS.
|
|
44
|
+
return this.RetryPipeline.execute(() => Promise.resolve(this.Inner.write(entry)).then(() => undefined));
|
|
45
|
+
}
|
|
46
|
+
forceFlush() {
|
|
47
|
+
return this.Inner.forceFlush();
|
|
48
|
+
}
|
|
49
|
+
async dispose() {
|
|
50
|
+
await this.Inner.dispose?.();
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
RetryingTarget = __decorate([
|
|
54
|
+
Singleton(),
|
|
55
|
+
Injectable("RetryingTarget")
|
|
56
|
+
], RetryingTarget);
|
|
57
|
+
export { RetryingTarget };
|
|
58
|
+
//# sourceMappingURL=RetryingTarget.js.map
|