@spinajs/log 2.0.481 → 2.0.484

package/lib/cjs/targets/BrowserConsoleTarget.d.ts

@@ -0,0 +1,48 @@
+import { IColoredConsoleTargetOptions, ILogEntry, LogTarget } from "@spinajs/log-common";
+/**
+ * Browser counterpart of ColoredConsoleTarget: same "ConsoleTarget" DI name so
+ * existing logger configs resolve it unchanged, but no chalk (Node-only) — the
+ * browser devtools console provides its own styling per console method.
+ *
+ * Registered ONLY by the browser entry (index.browser.ts); never add it to
+ * targets/index.ts or it would fight ColoredConsoleTarget over "ConsoleTarget"
+ * on Node.
+ */
+export declare class BrowserConsoleTarget extends LogTarget<IColoredConsoleTargetOptions> {
+    protected StdConsoleCallbackMap: {
+        5: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        6: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        999: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        2: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        3: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        0: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        1: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+        4: {
+            (...data: any[]): void;
+            (message?: any, ...optionalParams: any[]): void;
+        };
+    };
+    write(data: ILogEntry): Promise<void>;
+}
+//# sourceMappingURL=BrowserConsoleTarget.d.ts.map

package/lib/cjs/targets/BrowserConsoleTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserConsoleTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/BrowserConsoleTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,SAAS,EAET,SAAS,EACV,MAAM,qBAAqB,CAAC;AAI7B;;;;;;;;GAQG;AACH,qBAEa,oBAAqB,SAAQ,SAAS,CAAC,4BAA4B,CAAC;IAC/E,SAAS,CAAC,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAY7B;IAEW,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CASnD"}

package/lib/cjs/targets/BrowserConsoleTarget.js

@@ -0,0 +1,48 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserConsoleTarget = void 0;
+const log_common_1 = require("@spinajs/log-common");
+const di_1 = require("@spinajs/di");
+const configuration_common_1 = require("@spinajs/configuration-common");
+/**
+ * Browser counterpart of ColoredConsoleTarget: same "ConsoleTarget" DI name so
+ * existing logger configs resolve it unchanged, but no chalk (Node-only) — the
+ * browser devtools console provides its own styling per console method.
+ *
+ * Registered ONLY by the browser entry (index.browser.ts); never add it to
+ * targets/index.ts or it would fight ColoredConsoleTarget over "ConsoleTarget"
+ * on Node.
+ */
+let BrowserConsoleTarget = class BrowserConsoleTarget extends log_common_1.LogTarget {
+    constructor() {
+        super(...arguments);
+        this.StdConsoleCallbackMap = {
+            [log_common_1.LogLevel.Error]: console.error,
+            [log_common_1.LogLevel.Fatal]: console.error,
+            [log_common_1.LogLevel.Security]: console.error,
+            [log_common_1.LogLevel.Info]: console.log,
+            [log_common_1.LogLevel.Success]: console.log,
+            [log_common_1.LogLevel.Trace]: console.debug,
+            [log_common_1.LogLevel.Debug]: console.debug,
+            [log_common_1.LogLevel.Warn]: console.warn,
+        };
+    }
+    async write(data) {
+        if (!this.Options.enabled) {
+            return;
+        }
+        this.StdConsoleCallbackMap[data.Level]((0, configuration_common_1.format)(data.Variables, this.Options.layout));
+    }
+};
+exports.BrowserConsoleTarget = BrowserConsoleTarget;
+exports.BrowserConsoleTarget = BrowserConsoleTarget = __decorate([
+    (0, di_1.Singleton)(),
+    (0, di_1.Injectable)("ConsoleTarget")
+], BrowserConsoleTarget);
+//# sourceMappingURL=BrowserConsoleTarget.js.map

package/lib/cjs/targets/BrowserConsoleTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserConsoleTarget.js","sourceRoot":"","sources":["../../../src/targets/BrowserConsoleTarget.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAK6B;AAC7B,oCAAoD;AACpD,wEAAuD;AAEvD;;;;;;;;GAQG;AAGI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,sBAAuC;IAA1E;;QACK,0BAAqB,GAAG;YAChC,CAAC,qBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,qBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,qBAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,KAAK;YAElC,CAAC,qBAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG;YAC5B,CAAC,qBAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG;YAE/B,CAAC,qBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,qBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAE/B,CAAC,qBAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI;SAC9B,CAAC;IAWJ,CAAC;IATQ,KAAK,CAAC,KAAK,CAAC,IAAe;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CACpC,IAAA,6BAAM,EAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF,CAAA;AAxBY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,cAAS,GAAE;IACX,IAAA,eAAU,EAAC,eAAe,CAAC;GACf,oBAAoB,CAwBhC"}

package/lib/cjs/targets/ColoredConsoleTarget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColoredConsoleTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/ColoredConsoleTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,SAAS,EACT,SAAS,EACV,MAAM,qBAAqB,CAAC;AAM7B,eAAO,MAAM,aAAa;;;;;;;;;CASzB,CAAC;AAEF,qBAEa,oBAAqB,SAAQ,SAAS,CAAC,4BAA4B,CAAC;IAC/E,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAM;IAE5B,SAAS,CAAC,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAY7B;IAEW,OAAO;IAaP,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAenD"}
+{"version":3,"file":"ColoredConsoleTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/ColoredConsoleTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,SAAS,EACT,SAAS,EACV,MAAM,qBAAqB,CAAC;AAmB7B,eAAO,MAAM,aAAa;;;;;;;;;CASzB,CAAC;AAEF,qBAEa,oBAAqB,SAAQ,SAAS,CAAC,4BAA4B,CAAC;IAC/E,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,CAAM;IAE5B,SAAS,CAAC,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAY7B;IAEW,OAAO;IAaP,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAenD"}

package/lib/cjs/targets/ColoredConsoleTarget.js

@@ -5,16 +5,25 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ColoredConsoleTarget = exports.DEFAULT_THEME = void 0;
 const log_common_1 = require("@spinajs/log-common");
 const di_1 = require("@spinajs/di");
 const index_js_1 = require("./../index.js");
-const chalk_1 = __importDefault(require("chalk"));
 const configuration_1 = require("@spinajs/configuration");
+/**
+ * Minimal, dependency-free ANSI colour helpers ( replaces chalk ).
+ * Console target is Node-only, so raw escape codes are fine.
+ */
+const ANSI_RESET = "\x1b[0m";
+const ansi = (open) => (text) => `${open}${text}${ANSI_RESET}`;
+const gray = ansi("\x1b[90m");
+const white = ansi("\x1b[37m");
+const whiteBgGreen = ansi("\x1b[37m\x1b[42m");
+const yellow = ansi("\x1b[33m");
+const red = ansi("\x1b[31m");
+const whiteBgRed = ansi("\x1b[37m\x1b[41m");
+const yellowBgRed = ansi("\x1b[33m\x1b[41m");
 exports.DEFAULT_THEME = {
     security: ["red", "bgBrightWhite"],
     fatal: "red",
@@ -41,14 +50,14 @@ let ColoredConsoleTarget = class ColoredConsoleTarget extends log_common_1.LogTa
         };
     }
     async resolve() {
-        this.theme[index_js_1.LogLevel.Trace] = chalk_1.default.gray;
-        this.theme[index_js_1.LogLevel.Debug] = chalk_1.default.gray;
-        this.theme[index_js_1.LogLevel.Info] = chalk_1.default.white;
-        this.theme[index_js_1.LogLevel.Success] = chalk_1.default.white.bgGreen;
-        this.theme[index_js_1.LogLevel.Warn] = chalk_1.default.yellow;
-        this.theme[index_js_1.LogLevel.Error] = chalk_1.default.red;
-        this.theme[index_js_1.LogLevel.Fatal] = chalk_1.default.white.bgRed;
-        this.theme[index_js_1.LogLevel.Security] = chalk_1.default.yellow.bgRed;
+        this.theme[index_js_1.LogLevel.Trace] = gray;
+        this.theme[index_js_1.LogLevel.Debug] = gray;
+        this.theme[index_js_1.LogLevel.Info] = white;
+        this.theme[index_js_1.LogLevel.Success] = whiteBgGreen;
+        this.theme[index_js_1.LogLevel.Warn] = yellow;
+        this.theme[index_js_1.LogLevel.Error] = red;
+        this.theme[index_js_1.LogLevel.Fatal] = whiteBgRed;
+        this.theme[index_js_1.LogLevel.Security] = yellowBgRed;
         super.resolve();
     }
     async write(data) {

package/lib/cjs/targets/ColoredConsoleTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"ColoredConsoleTarget.js","sourceRoot":"","sources":["../../../src/targets/ColoredConsoleTarget.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,oDAI6B;AAC7B,oCAAoD;AACpD,4CAAyC;AACzC,kDAA0B;AAC1B,0DAAgD;AAEnC,QAAA,aAAa,GAAG;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC;IAClC,KAAK,EAAE,KAAK;IACZ,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;CACd,CAAC;AAIK,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,sBAAuC;IAA1E;;QACK,UAAK,GAAU,EAAE,CAAC;QAElB,0BAAqB,GAAG;YAChC,CAAC,mBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,mBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,mBAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,KAAK;YAElC,CAAC,mBAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,GAAG;YAC5B,CAAC,mBAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG;YAE/B,CAAC,mBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAC/B,CAAC,mBAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK;YAE/B,CAAC,mBAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI;SAC9B,CAAC;IA8BJ,CAAC;IA5BQ,KAAK,CAAC,OAAO;QAClB,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,IAAI,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,OAAO,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,IAAI,CAAC,GAAG,eAAK,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,QAAQ,CAAC,GAAG,eAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAEnD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAe;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QACpC;;WAEG;QACH,oBAAoB;QACnB,IAAI,CAAC,KAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAC7B,IAAA,sBAAM,EAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAC5C,CACF,CAAC;IACJ,CAAC;CACF,CAAA;AA7CY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,cAAS,GAAE;IACX,IAAA,eAAU,EAAC,eAAe,CAAC;GACf,oBAAoB,CA6ChC"}
+{"version":3,"file":"ColoredConsoleTarget.js","sourceRoot":"","sources":["../../../src/targets/ColoredConsoleTarget.ts"],"names":[],"mappings":"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"}

package/lib/cjs/targets/FileTarget.d.ts

@@ -1,28 +1,104 @@
-import fs from "fs";
 import { IInstanceCheck } from "@spinajs/di";
-import { IFileTargetOptions, Log, ILogEntry, LogTarget } from "@spinajs/log-common";
-declare enum FileTargetStatus {
-    WRITTING = 0,
-    PENDING = 1,
-    IDLE = 2
-}
+import { fs } from "@spinajs/fs";
+import { IFileTargetOptions, Log, ILogEntry, LogTarget, BatchQueue } from "@spinajs/log-common";
+import { LogArchiveService } from "../archive/LogArchiveService.js";
+import { ILogArchiveContext } from "../archive/context.js";
+/**
+ * Writes log messages to a file through the @spinajs/fs abstraction.
+ *
+ * Messages are buffered in memory and flushed as a single batched append,
+ * either when the buffer reaches `maxBufferSize` or on a periodic flush tick.
+ * Rotation / archiving / retention is delegated to {@link LogArchiveService}.
+ *
+ * A single async write-lock ( a promise-chain mutex ) serializes every flush
+ * and every rotation, so a rename can never race an in-flight append.
+ *
+ * PerInstanceCheck: multiple file targets can point at different files, but two
+ * targets with the same name share one writer.
+ */
 export declare class FileTarget extends LogTarget<IFileTargetOptions> implements IInstanceCheck {
     protected Log: Log;
-    LogDirPath: string;
-    ArchiveDirPath: string;
-    protected WriteStream: fs.WriteStream;
-    protected Buffer: string[];
-    protected WriteBuffer: string[];
-    protected ArchiveTimer: NodeJS.Timeout;
-    protected FlushTimer: NodeJS.Timeout;
-    protected Status: FileTargetStatus;
-    protected ArchiveStatus: FileTargetStatus;
+    /**
+     * fs provider holding the active log file.
+     */
+    protected Fs: fs;
+    /**
+     * fs provider archives are moved to ( defaults to `Fs` ).
+     */
+    protected ArchiveFs: fs;
+    /**
+     * Directory ( relative to ArchiveFs ) archives are stored in.
+     */
+    protected ArchiveDir: string;
+    protected ArchiveService: LogArchiveService;
+    protected Context: ILogArchiveContext;
+    /**
+     * Buffered-batch queue owning accumulation, the flush tick and the hard queue
+     * cap. It delegates the actual batched append to {@link append} via onFlush.
+     */
+    protected Queue: BatchQueue<string>;
+    /**
+     * Set true when the queue drops overflow, so the drop warning is emitted ONCE
+     * per overflow episode and reset when a batch appends successfully.
+     */
+    protected Overflowed: boolean;
+    /**
+     * Async initialization ( fs resolution + mkdir + archive start ). write()
+     * and flush() await this so nothing touches the fs before it is ready.
+     */
+    protected Ready: Promise<void>;
+    /**
+     * Promise-chain mutex tail. Every critical section ( flush, rotation ) chains
+     * onto this so they run strictly one at a time.
+     */
+    protected WriteLock: Promise<unknown>;
+    protected Disposed: boolean;
     __checkInstance__(creationOptions: IFileTargetOptions[]): boolean;
     resolve(): void;
-    protected flush(): void;
-    dispose(): Promise<void>;
+    /**
+     * Resolves fs providers, ensures directories exist, builds the archive
+     * context and starts the archive service.
+     */
+    protected init(): Promise<void>;
     write(data: ILogEntry): Promise<void>;
-    protected archive(): void;
+    /**
+     * Builds the single line appended for one entry. Overridable so subclasses can
+     * change ONLY the per-entry serialization while reusing the whole FileTarget
+     * pipeline ( batched append, write-lock, rotation, retention, zip ). The base
+     * renders the configured string `layout`.
+     */
+    protected formatEntry(data: ILogEntry): string;
+    /**
+     * Flushes any buffered messages. Delegates to the queue's forceFlush so a
+     * caller ( eg. dispose or a test ) can await the drain.
+     */
+    protected flush(): Promise<void>;
+    forceFlush(): Promise<void>;
+    /**
+     * Appends one batch as a single write, guarded by the write-lock ( the SAME
+     * lock rotation uses, so a rename can never race an append ). On failure the
+     * batch is requeued at the FRONT so nothing is lost ( never-drop, bounded by
+     * maxQueue ). This ALWAYS resolves ( never rejects ) so queue.shutdown() -
+     * driven by dispose() - never rejects.
+     */
+    protected append(batch: string[]): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Runs `fn` under the shared write-lock. Flush and rotation both go through
+     * here, so a rename can never overlap an append.
+     */
+    protected withWriteLock<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Active log path relative to the fs provider base path. Recomputed each call
+     * so dynamic ( eg. date-based ) paths work.
+     */
+    protected activePath(): string;
+    /**
+     * Normalizes a configured path to forward slashes and strips a leading
+     * separator. Paths are interpreted relative to the fs provider base path -
+     * the provider itself sandboxes and resolves them, so we only canonicalize
+     * separators here.
+     */
+    protected normalize(p: string): string;
 }
-export {};
 //# sourceMappingURL=FileTarget.d.ts.map

package/lib/cjs/targets/FileTarget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/FileTarget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,CAAC;AAOpB,OAAO,EAAE,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAU,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAI5F,aAAK,gBAAgB;IACnB,QAAQ,IAAA;IACR,OAAO,IAAA;IACP,IAAI,IAAA;CACL;AAID,qBAEa,UAAW,SAAQ,SAAS,CAAC,kBAAkB,CAAE,YAAW,cAAc;IAErF,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IAE9B,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAChC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAM;IAErC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC;IACvC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC;IAErC,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAyB;IAC3D,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAyB;IAElE,iBAAiB,CAAC,eAAe,EAAE,kBAAkB,EAAE,GAAG,OAAO;IAI1D,OAAO;IA+Dd,SAAS,CAAC,KAAK;IA0BF,OAAO;IAYP,KAAK,CAAC,IAAI,EAAE,SAAS;IA2BlC,SAAS,CAAC,OAAO;CAyGlB"}
+{"version":3,"file":"FileTarget.d.ts","sourceRoot":"","sources":["../../../src/targets/FileTarget.ts"],"names":[],"mappings":"AAIA,OAAO,EAAM,cAAc,EAAgC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAU,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;;;;;;;;;;;GAYG;AACH,qBAEa,UAAW,SAAQ,SAAS,CAAC,kBAAkB,CAAE,YAAW,cAAc;IAErF,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,UAAU,SAAM;IAE1B,SAAS,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC5C,SAAS,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAEtC;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,UAAU,UAAS;IAE7B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAqB;IAE1D,SAAS,CAAC,QAAQ,UAAS;IAE3B,iBAAiB,CAAC,eAAe,EAAE,kBAAkB,EAAE,GAAG,OAAO;IAI1D,OAAO,IAAI,IAAI;IA+CtB;;;OAGG;cACa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCxB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlD;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI9C;;;OAGG;cACa,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;OAMG;cACa,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASrC;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAO5D;;;OAGG;IACH,SAAS,CAAC,UAAU,IAAI,MAAM;IAK9B;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAGvC"}