Class CompactTransport

src/utils/logging/CompactTransport.ts:36–122

 * @implements {ICompactTransport}
 */
export class CompactTransport implements ICompactTransport {
	private sessionStart: number
	private lastTimestamp: number
	private filePath?: string
	private initialized: boolean = false

	/**
	 * Creates a new CompactTransport instance
	 * @param config - Optional transport configuration
	 */
	constructor(readonly config: CompactTransportConfig = DEFAULT_CONFIG) {
		this.sessionStart = Date.now()
		this.lastTimestamp = this.sessionStart

		if (config.fileOutput?.enabled) {
			this.filePath = config.fileOutput.path
		}
	}

	/**
	 * Ensures the log file is initialized with proper directory structure and session start marker
	 * @private
	 * @throws {Error} If file initialization fails
	 */
	private ensureInitialized(): void {
		if (this.initialized || !this.filePath) return

		try {
			mkdirSync(dirname(this.filePath), { recursive: true })
			writeFileSync(this.filePath, "", { flag: "w" })

			const sessionStart = {
				t: 0,
				l: "info",
				m: "Log session started",
				d: { timestamp: new Date(this.sessionStart).toISOString() },
			}
			writeFileSync(this.filePath, JSON.stringify(sessionStart) + "\n", { flag: "w" })

			this.initialized = true
		} catch (err) {
			throw new Error(`Failed to initialize log file: ${(err as Error).message}`)
		}
	}

	/**
	 * Writes a log entry to configured outputs (console and/or file)
	 * @param entry - The log entry to write
	 */
	write(entry: CompactLogEntry): void {
		const deltaT = entry.t - this.lastTimestamp
		this.lastTimestamp = entry.t

		const compact = {
			...entry,
			t: deltaT,
		}