@logtape/file 1.4.0-dev.444 → 1.4.0-dev.446

package/dist/timefilesink.d.cts

@@ -0,0 +1,104 @@
+import { AsyncFileSinkDriver, FileSinkDriver, FileSinkOptions } from "./filesink.base.cjs";
+import { Sink } from "@logtape/logtape";
+
+//#region src/timefilesink.d.ts
+
+/**
+ * The rotation interval for time-based file sinks.
+ */
+type TimeRotationInterval = "hourly" | "daily" | "weekly";
+/**
+ * Options for the {@link getBaseTimeRotatingFileSink} function.
+ */
+interface TimeRotatingFileSinkOptions extends Omit<FileSinkOptions, "lazy"> {
+  /**
+   * The directory to write log files to.
+   */
+  directory: string;
+  /**
+   * A function that generates the filename for the log file based on the date.
+   * Default depends on `interval`:
+   * - `"daily"`: `YYYY-MM-DD.log` (e.g., `2025-01-15.log`)
+   * - `"hourly"`: `YYYY-MM-DD-HH.log` (e.g., `2025-01-15-09.log`)
+   * - `"weekly"`: `YYYY-WW.log` (e.g., `2025-W03.log`)
+   */
+  filename?: (date: Date) => string;
+  /**
+   * The rotation interval.  Defaults to `"daily"`.
+   */
+  interval?: TimeRotationInterval;
+  /**
+   * The maximum age of log files in milliseconds.  Files older than this
+   * will be deleted.  If not specified, old files are not deleted.
+   */
+  maxAgeMs?: number;
+}
+/**
+ * A platform-specific time-rotating file sink driver.
+ */
+interface TimeRotatingFileSinkDriver<TFile> extends FileSinkDriver<TFile> {
+  /**
+   * Read the contents of a directory.
+   * @param path A path to the directory.
+   * @returns An array of filenames in the directory.
+   */
+  readdirSync(path: string): string[];
+  /**
+   * Delete a file.
+   * @param path A path to the file to delete.
+   */
+  unlinkSync(path: string): void;
+  /**
+   * Create a directory if it doesn't exist.
+   * @param path A path to the directory to create.
+   * @param options Options for directory creation.
+   */
+  mkdirSync(path: string, options?: {
+    recursive?: boolean;
+  }): void;
+  /**
+   * Join path segments.
+   * @param paths Path segments to join.
+   * @returns The joined path.
+   */
+  joinPath(...paths: string[]): string;
+}
+/**
+ * A platform-specific async time-rotating file sink driver.
+ * @since 1.4.0
+ */
+interface AsyncTimeRotatingFileSinkDriver<TFile> extends AsyncFileSinkDriver<TFile> {
+  /**
+   * Read the contents of a directory.
+   * @param path A path to the directory.
+   * @returns An array of filenames in the directory.
+   */
+  readdirSync(path: string): string[];
+  /**
+   * Delete a file.
+   * @param path A path to the file to delete.
+   */
+  unlinkSync(path: string): void;
+  /**
+   * Create a directory if it doesn't exist.
+   * @param path A path to the directory to create.
+   * @param options Options for directory creation.
+   */
+  mkdirSync(path: string, options?: {
+    recursive?: boolean;
+  }): void;
+  /**
+   * Join path segments.
+   * @param paths Path segments to join.
+   * @returns The joined path.
+   */
+  joinPath(...paths: string[]): string;
+}
+/**
+ * Get the ISO week number of a date.
+ * @param date The date to get the week number of.
+ * @returns The ISO week number (1-53).
+ */
+//#endregion
+export { AsyncTimeRotatingFileSinkDriver, TimeRotatingFileSinkDriver, TimeRotatingFileSinkOptions, TimeRotationInterval };
+//# sourceMappingURL=timefilesink.d.cts.map

package/dist/timefilesink.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timefilesink.d.cts","names":[],"sources":["../src/timefilesink.ts"],"sourcesContent":[],"mappings":";;;;;;;AAcA;AAKiB,KALL,oBAAA,GAMV,QAAA,GAAA,OAAA,GAAA,QAAA;;;;AAkBW,UAnBI,2BAAA,SACP,IAkBG,CAlBE,eAkBF,EAAA,MAAA,CAAA,CAAA;EAAoB;AAlBnB;AA8Bd;EAA2C,SAAA,EAAA,MAAA;EAAA;;AACnB;AAiCxB;;;;EAC6B,QAAA,CAAA,EAAA,CAAA,IAAA,EApDT,IAoDS,EAAA,GAAA,MAAA;;;;aA/ChB;;;;;;;;;;UAYI,0CACP,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiCR,+CACP,oBAAoB"}

package/dist/timefilesink.d.ts

@@ -0,0 +1,104 @@
+import { AsyncFileSinkDriver, FileSinkDriver, FileSinkOptions } from "./filesink.base.js";
+import { Sink } from "@logtape/logtape";
+
+//#region src/timefilesink.d.ts
+
+/**
+ * The rotation interval for time-based file sinks.
+ */
+type TimeRotationInterval = "hourly" | "daily" | "weekly";
+/**
+ * Options for the {@link getBaseTimeRotatingFileSink} function.
+ */
+interface TimeRotatingFileSinkOptions extends Omit<FileSinkOptions, "lazy"> {
+  /**
+   * The directory to write log files to.
+   */
+  directory: string;
+  /**
+   * A function that generates the filename for the log file based on the date.
+   * Default depends on `interval`:
+   * - `"daily"`: `YYYY-MM-DD.log` (e.g., `2025-01-15.log`)
+   * - `"hourly"`: `YYYY-MM-DD-HH.log` (e.g., `2025-01-15-09.log`)
+   * - `"weekly"`: `YYYY-WW.log` (e.g., `2025-W03.log`)
+   */
+  filename?: (date: Date) => string;
+  /**
+   * The rotation interval.  Defaults to `"daily"`.
+   */
+  interval?: TimeRotationInterval;
+  /**
+   * The maximum age of log files in milliseconds.  Files older than this
+   * will be deleted.  If not specified, old files are not deleted.
+   */
+  maxAgeMs?: number;
+}
+/**
+ * A platform-specific time-rotating file sink driver.
+ */
+interface TimeRotatingFileSinkDriver<TFile> extends FileSinkDriver<TFile> {
+  /**
+   * Read the contents of a directory.
+   * @param path A path to the directory.
+   * @returns An array of filenames in the directory.
+   */
+  readdirSync(path: string): string[];
+  /**
+   * Delete a file.
+   * @param path A path to the file to delete.
+   */
+  unlinkSync(path: string): void;
+  /**
+   * Create a directory if it doesn't exist.
+   * @param path A path to the directory to create.
+   * @param options Options for directory creation.
+   */
+  mkdirSync(path: string, options?: {
+    recursive?: boolean;
+  }): void;
+  /**
+   * Join path segments.
+   * @param paths Path segments to join.
+   * @returns The joined path.
+   */
+  joinPath(...paths: string[]): string;
+}
+/**
+ * A platform-specific async time-rotating file sink driver.
+ * @since 1.4.0
+ */
+interface AsyncTimeRotatingFileSinkDriver<TFile> extends AsyncFileSinkDriver<TFile> {
+  /**
+   * Read the contents of a directory.
+   * @param path A path to the directory.
+   * @returns An array of filenames in the directory.
+   */
+  readdirSync(path: string): string[];
+  /**
+   * Delete a file.
+   * @param path A path to the file to delete.
+   */
+  unlinkSync(path: string): void;
+  /**
+   * Create a directory if it doesn't exist.
+   * @param path A path to the directory to create.
+   * @param options Options for directory creation.
+   */
+  mkdirSync(path: string, options?: {
+    recursive?: boolean;
+  }): void;
+  /**
+   * Join path segments.
+   * @param paths Path segments to join.
+   * @returns The joined path.
+   */
+  joinPath(...paths: string[]): string;
+}
+/**
+ * Get the ISO week number of a date.
+ * @param date The date to get the week number of.
+ * @returns The ISO week number (1-53).
+ */
+//#endregion
+export { AsyncTimeRotatingFileSinkDriver, TimeRotatingFileSinkDriver, TimeRotatingFileSinkOptions, TimeRotationInterval };
+//# sourceMappingURL=timefilesink.d.ts.map

package/dist/timefilesink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timefilesink.d.ts","names":[],"sources":["../src/timefilesink.ts"],"sourcesContent":[],"mappings":";;;;;;;AAcA;AAKiB,KALL,oBAAA,GAMV,QAAA,GAAA,OAAA,GAAA,QAAA;;;;AAkBW,UAnBI,2BAAA,SACP,IAkBG,CAlBE,eAkBF,EAAA,MAAA,CAAA,CAAA;EAAoB;AAlBnB;AA8Bd;EAA2C,SAAA,EAAA,MAAA;EAAA;;AACnB;AAiCxB;;;;EAC6B,QAAA,CAAA,EAAA,CAAA,IAAA,EApDT,IAoDS,EAAA,GAAA,MAAA;;;;aA/ChB;;;;;;;;;;UAYI,0CACP,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAiCR,+CACP,oBAAoB"}

package/dist/timefilesink.js

@@ -0,0 +1,208 @@
+import { defaultTextFormatter } from "@logtape/logtape";
+
+//#region src/timefilesink.ts
+/**
+* Get the ISO week number of a date.
+* @param date The date to get the week number of.
+* @returns The ISO week number (1-53).
+*/
+function getISOWeek(date) {
+	const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+	const dayNum = d.getUTCDay() || 7;
+	d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+	const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+	return Math.ceil(((d.getTime() - yearStart.getTime()) / 864e5 + 1) / 7);
+}
+/**
+* Get the ISO week year of a date.  This may differ from the calendar year
+* for dates near the start or end of a year.
+* @param date The date to get the ISO week year of.
+* @returns The ISO week year.
+*/
+function getISOWeekYear(date) {
+	const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+	const dayNum = d.getUTCDay() || 7;
+	d.setUTCDate(d.getUTCDate() + 4 - dayNum);
+	return d.getUTCFullYear();
+}
+/**
+* Get the default filename generator for the given interval.
+* @param interval The rotation interval.
+* @returns A function that generates a filename for a given date.
+*/
+function getDefaultFilename(interval) {
+	switch (interval) {
+		case "hourly": return (date) => {
+			const yyyy = date.getFullYear();
+			const mm = String(date.getMonth() + 1).padStart(2, "0");
+			const dd = String(date.getDate()).padStart(2, "0");
+			const hh = String(date.getHours()).padStart(2, "0");
+			return `${yyyy}-${mm}-${dd}-${hh}.log`;
+		};
+		case "daily": return (date) => {
+			const yyyy = date.getFullYear();
+			const mm = String(date.getMonth() + 1).padStart(2, "0");
+			const dd = String(date.getDate()).padStart(2, "0");
+			return `${yyyy}-${mm}-${dd}.log`;
+		};
+		case "weekly": return (date) => {
+			const yyyy = getISOWeekYear(date);
+			const week = getISOWeek(date);
+			return `${yyyy}-W${String(week).padStart(2, "0")}.log`;
+		};
+	}
+}
+/**
+* Get the rotation key for the given date and interval.
+* The key is used to determine when to rotate to a new file.
+* @param date The date to get the rotation key of.
+* @param interval The rotation interval.
+* @returns A string key that changes when rotation should occur.
+*/
+function getRotationKey(date, interval) {
+	switch (interval) {
+		case "hourly": return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}`;
+		case "daily": return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`;
+		case "weekly": return `${getISOWeekYear(date)}-${getISOWeek(date)}`;
+	}
+}
+function getBaseTimeRotatingFileSink(options) {
+	const formatter = options.formatter ?? defaultTextFormatter;
+	const encoder = options.encoder ?? new TextEncoder();
+	const interval = options.interval ?? "daily";
+	const filenameGenerator = options.filename ?? getDefaultFilename(interval);
+	const maxAgeMs = options.maxAgeMs;
+	const bufferSize = options.bufferSize ?? 1024 * 8;
+	const flushInterval = options.flushInterval ?? 5e3;
+	const directory = options.directory;
+	try {
+		options.mkdirSync(directory, { recursive: true });
+	} catch {}
+	let currentFilename = filenameGenerator(/* @__PURE__ */ new Date());
+	let currentPath = options.joinPath(directory, currentFilename);
+	let currentRotationKey = getRotationKey(/* @__PURE__ */ new Date(), interval);
+	let fd = options.openSync(currentPath);
+	let lastFlushTimestamp = Date.now();
+	let buffer = "";
+	function shouldRotate() {
+		const now = /* @__PURE__ */ new Date();
+		const newKey = getRotationKey(now, interval);
+		return newKey !== currentRotationKey;
+	}
+	function performRotation() {
+		options.closeSync(fd);
+		const now = /* @__PURE__ */ new Date();
+		currentFilename = filenameGenerator(now);
+		currentPath = options.joinPath(directory, currentFilename);
+		currentRotationKey = getRotationKey(now, interval);
+		fd = options.openSync(currentPath);
+	}
+	function cleanupOldFiles() {
+		if (maxAgeMs === void 0) return;
+		const now = Date.now();
+		let files;
+		try {
+			files = options.readdirSync(directory);
+		} catch {
+			return;
+		}
+		for (const file of files) {
+			if (!file.endsWith(".log")) continue;
+			if (file === currentFilename) continue;
+			const filePath = options.joinPath(directory, file);
+			const dateMatch = file.match(/^(\d{4})-(\d{2})-(\d{2})(?:-(\d{2}))?\.log$/);
+			const weekMatch = file.match(/^(\d{4})-W(\d{2})\.log$/);
+			let fileDate = null;
+			if (dateMatch) {
+				const [, year, month, day, hour] = dateMatch;
+				fileDate = new Date(parseInt(year, 10), parseInt(month, 10) - 1, parseInt(day, 10), hour ? parseInt(hour, 10) : 0);
+			} else if (weekMatch) {
+				const [, year, week] = weekMatch;
+				const jan4 = new Date(parseInt(year, 10), 0, 4);
+				const dayOfWeek = jan4.getDay() || 7;
+				fileDate = new Date(jan4);
+				fileDate.setDate(jan4.getDate() - dayOfWeek + 1 + (parseInt(week, 10) - 1) * 7);
+			}
+			if (fileDate && now - fileDate.getTime() > maxAgeMs) try {
+				options.unlinkSync(filePath);
+			} catch {}
+		}
+	}
+	if (!options.nonBlocking) {
+		function flushBuffer$1() {
+			if (buffer.length > 0) {
+				if (shouldRotate()) performRotation();
+				const bytes = encoder.encode(buffer);
+				buffer = "";
+				options.writeSync(fd, bytes);
+				options.flushSync(fd);
+				lastFlushTimestamp = Date.now();
+				cleanupOldFiles();
+			}
+		}
+		const sink = (record) => {
+			buffer += formatter(record);
+			const shouldFlushBySize = buffer.length >= bufferSize;
+			const shouldFlushByTime = flushInterval > 0 && record.timestamp - lastFlushTimestamp >= flushInterval;
+			if (shouldFlushBySize || shouldFlushByTime) flushBuffer$1();
+		};
+		sink[Symbol.dispose] = () => {
+			flushBuffer$1();
+			options.closeSync(fd);
+		};
+		return sink;
+	}
+	const asyncOptions = options;
+	let disposed = false;
+	let activeFlush = null;
+	let flushTimer = null;
+	async function flushBuffer() {
+		if (buffer.length === 0) return;
+		if (shouldRotate()) performRotation();
+		const data = buffer;
+		buffer = "";
+		try {
+			const bytes = encoder.encode(data);
+			asyncOptions.writeSync(fd, bytes);
+			await asyncOptions.flush(fd);
+			lastFlushTimestamp = Date.now();
+			cleanupOldFiles();
+		} catch {}
+	}
+	function scheduleFlush() {
+		if (activeFlush || disposed) return;
+		activeFlush = flushBuffer().finally(() => {
+			activeFlush = null;
+		});
+	}
+	function startFlushTimer() {
+		if (flushTimer !== null || disposed) return;
+		flushTimer = setInterval(() => {
+			scheduleFlush();
+		}, flushInterval);
+	}
+	const nonBlockingSink = (record) => {
+		if (disposed) return;
+		buffer += formatter(record);
+		const shouldFlushBySize = buffer.length >= bufferSize;
+		const shouldFlushByTime = flushInterval > 0 && record.timestamp - lastFlushTimestamp >= flushInterval;
+		if (shouldFlushBySize || shouldFlushByTime) scheduleFlush();
+		else if (flushTimer === null && flushInterval > 0) startFlushTimer();
+	};
+	nonBlockingSink[Symbol.asyncDispose] = async () => {
+		disposed = true;
+		if (flushTimer !== null) {
+			clearInterval(flushTimer);
+			flushTimer = null;
+		}
+		await flushBuffer();
+		try {
+			await asyncOptions.close(fd);
+		} catch {}
+	};
+	return nonBlockingSink;
+}
+
+//#endregion
+export { getBaseTimeRotatingFileSink };
+//# sourceMappingURL=timefilesink.js.map

package/dist/timefilesink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timefilesink.js","names":["date: Date","interval: TimeRotationInterval","options:\n    & TimeRotatingFileSinkOptions\n    & (\n      | TimeRotatingFileSinkDriver<TFile>\n      | AsyncTimeRotatingFileSinkDriver<TFile>\n    )","currentFilename: string","currentPath: string","currentRotationKey: string","fd: TFile","lastFlushTimestamp: number","buffer: string","files: string[]","fileDate: Date | null","flushBuffer","sink: Sink & Disposable","record: LogRecord","activeFlush: Promise<void> | null","flushTimer: ReturnType<typeof setInterval> | null","nonBlockingSink: Sink & AsyncDisposable"],"sources":["../src/timefilesink.ts"],"sourcesContent":["import {\n  defaultTextFormatter,\n  type LogRecord,\n  type Sink,\n} from \"@logtape/logtape\";\nimport type {\n  AsyncFileSinkDriver,\n  FileSinkDriver,\n  FileSinkOptions,\n} from \"./filesink.base.ts\";\n\n/**\n * The rotation interval for time-based file sinks.\n */\nexport type TimeRotationInterval = \"hourly\" | \"daily\" | \"weekly\";\n\n/**\n * Options for the {@link getBaseTimeRotatingFileSink} function.\n */\nexport interface TimeRotatingFileSinkOptions\n  extends Omit<FileSinkOptions, \"lazy\"> {\n  /**\n   * The directory to write log files to.\n   */\n  directory: string;\n\n  /**\n   * A function that generates the filename for the log file based on the date.\n   * Default depends on `interval`:\n   * - `\"daily\"`: `YYYY-MM-DD.log` (e.g., `2025-01-15.log`)\n   * - `\"hourly\"`: `YYYY-MM-DD-HH.log` (e.g., `2025-01-15-09.log`)\n   * - `\"weekly\"`: `YYYY-WW.log` (e.g., `2025-W03.log`)\n   */\n  filename?: (date: Date) => string;\n\n  /**\n   * The rotation interval.  Defaults to `\"daily\"`.\n   */\n  interval?: TimeRotationInterval;\n\n  /**\n   * The maximum age of log files in milliseconds.  Files older than this\n   * will be deleted.  If not specified, old files are not deleted.\n   */\n  maxAgeMs?: number;\n}\n\n/**\n * A platform-specific time-rotating file sink driver.\n */\nexport interface TimeRotatingFileSinkDriver<TFile>\n  extends FileSinkDriver<TFile> {\n  /**\n   * Read the contents of a directory.\n   * @param path A path to the directory.\n   * @returns An array of filenames in the directory.\n   */\n  readdirSync(path: string): string[];\n\n  /**\n   * Delete a file.\n   * @param path A path to the file to delete.\n   */\n  unlinkSync(path: string): void;\n\n  /**\n   * Create a directory if it doesn't exist.\n   * @param path A path to the directory to create.\n   * @param options Options for directory creation.\n   */\n  mkdirSync(path: string, options?: { recursive?: boolean }): void;\n\n  /**\n   * Join path segments.\n   * @param paths Path segments to join.\n   * @returns The joined path.\n   */\n  joinPath(...paths: string[]): string;\n}\n\n/**\n * A platform-specific async time-rotating file sink driver.\n * @since 1.4.0\n */\nexport interface AsyncTimeRotatingFileSinkDriver<TFile>\n  extends AsyncFileSinkDriver<TFile> {\n  /**\n   * Read the contents of a directory.\n   * @param path A path to the directory.\n   * @returns An array of filenames in the directory.\n   */\n  readdirSync(path: string): string[];\n\n  /**\n   * Delete a file.\n   * @param path A path to the file to delete.\n   */\n  unlinkSync(path: string): void;\n\n  /**\n   * Create a directory if it doesn't exist.\n   * @param path A path to the directory to create.\n   * @param options Options for directory creation.\n   */\n  mkdirSync(path: string, options?: { recursive?: boolean }): void;\n\n  /**\n   * Join path segments.\n   * @param paths Path segments to join.\n   * @returns The joined path.\n   */\n  joinPath(...paths: string[]): string;\n}\n\n/**\n * Get the ISO week number of a date.\n * @param date The date to get the week number of.\n * @returns The ISO week number (1-53).\n */\nexport function getISOWeek(date: Date): number {\n  const d = new Date(\n    Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()),\n  );\n  const dayNum = d.getUTCDay() || 7;\n  d.setUTCDate(d.getUTCDate() + 4 - dayNum);\n  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));\n  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);\n}\n\n/**\n * Get the ISO week year of a date.  This may differ from the calendar year\n * for dates near the start or end of a year.\n * @param date The date to get the ISO week year of.\n * @returns The ISO week year.\n */\nexport function getISOWeekYear(date: Date): number {\n  const d = new Date(\n    Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()),\n  );\n  const dayNum = d.getUTCDay() || 7;\n  d.setUTCDate(d.getUTCDate() + 4 - dayNum);\n  return d.getUTCFullYear();\n}\n\n/**\n * Get the default filename generator for the given interval.\n * @param interval The rotation interval.\n * @returns A function that generates a filename for a given date.\n */\nexport function getDefaultFilename(\n  interval: TimeRotationInterval,\n): (date: Date) => string {\n  switch (interval) {\n    case \"hourly\":\n      return (date: Date): string => {\n        const yyyy = date.getFullYear();\n        const mm = String(date.getMonth() + 1).padStart(2, \"0\");\n        const dd = String(date.getDate()).padStart(2, \"0\");\n        const hh = String(date.getHours()).padStart(2, \"0\");\n        return `${yyyy}-${mm}-${dd}-${hh}.log`;\n      };\n    case \"daily\":\n      return (date: Date): string => {\n        const yyyy = date.getFullYear();\n        const mm = String(date.getMonth() + 1).padStart(2, \"0\");\n        const dd = String(date.getDate()).padStart(2, \"0\");\n        return `${yyyy}-${mm}-${dd}.log`;\n      };\n    case \"weekly\":\n      return (date: Date): string => {\n        const yyyy = getISOWeekYear(date);\n        const week = getISOWeek(date);\n        return `${yyyy}-W${String(week).padStart(2, \"0\")}.log`;\n      };\n  }\n}\n\n/**\n * Get the rotation key for the given date and interval.\n * The key is used to determine when to rotate to a new file.\n * @param date The date to get the rotation key of.\n * @param interval The rotation interval.\n * @returns A string key that changes when rotation should occur.\n */\nfunction getRotationKey(date: Date, interval: TimeRotationInterval): string {\n  switch (interval) {\n    case \"hourly\":\n      return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}-${date.getHours()}`;\n    case \"daily\":\n      return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`;\n    case \"weekly\":\n      return `${getISOWeekYear(date)}-${getISOWeek(date)}`;\n  }\n}\n\n/**\n * Get a platform-independent time-rotating file sink.\n *\n * This sink writes log records to a file in a directory, rotating to a new\n * file based on time intervals.  The filename is generated based on the\n * current date/time and the configured interval.\n *\n * @template TFile The type of the file descriptor.\n * @param options The options for the sink and the file driver.\n * @returns A sink that writes to the file.  The sink is also a disposable\n *          object that closes the file when disposed.  If `nonBlocking` is\n *          enabled, returns a sink that also implements {@link AsyncDisposable}.\n */\nexport function getBaseTimeRotatingFileSink<TFile>(\n  options: TimeRotatingFileSinkOptions & TimeRotatingFileSinkDriver<TFile>,\n): Sink & Disposable;\nexport function getBaseTimeRotatingFileSink<TFile>(\n  options: TimeRotatingFileSinkOptions & AsyncTimeRotatingFileSinkDriver<TFile>,\n): Sink & AsyncDisposable;\nexport function getBaseTimeRotatingFileSink<TFile>(\n  options:\n    & TimeRotatingFileSinkOptions\n    & (\n      | TimeRotatingFileSinkDriver<TFile>\n      | AsyncTimeRotatingFileSinkDriver<TFile>\n    ),\n): Sink & (Disposable | AsyncDisposable) {\n  const formatter = options.formatter ?? defaultTextFormatter;\n  const encoder = options.encoder ?? new TextEncoder();\n  const interval = options.interval ?? \"daily\";\n  const filenameGenerator = options.filename ?? getDefaultFilename(interval);\n  const maxAgeMs = options.maxAgeMs;\n  const bufferSize = options.bufferSize ?? 1024 * 8;\n  const flushInterval = options.flushInterval ?? 5000;\n  const directory = options.directory;\n\n  // Ensure directory exists\n  try {\n    options.mkdirSync(directory, { recursive: true });\n  } catch {\n    // Directory might already exist\n  }\n\n  let currentFilename: string = filenameGenerator(new Date());\n  let currentPath: string = options.joinPath(directory, currentFilename);\n  let currentRotationKey: string = getRotationKey(new Date(), interval);\n  let fd: TFile = options.openSync(currentPath);\n  let lastFlushTimestamp: number = Date.now();\n  let buffer: string = \"\";\n\n  function shouldRotate(): boolean {\n    const now = new Date();\n    const newKey = getRotationKey(now, interval);\n    return newKey !== currentRotationKey;\n  }\n\n  function performRotation(): void {\n    options.closeSync(fd);\n    const now = new Date();\n    currentFilename = filenameGenerator(now);\n    currentPath = options.joinPath(directory, currentFilename);\n    currentRotationKey = getRotationKey(now, interval);\n    fd = options.openSync(currentPath);\n  }\n\n  function cleanupOldFiles(): void {\n    if (maxAgeMs === undefined) return;\n\n    const now = Date.now();\n    let files: string[];\n    try {\n      files = options.readdirSync(directory);\n    } catch {\n      return;\n    }\n\n    for (const file of files) {\n      if (!file.endsWith(\".log\")) continue;\n      if (file === currentFilename) continue;\n\n      const filePath = options.joinPath(directory, file);\n\n      // Try to parse the date from the filename\n      const dateMatch = file.match(\n        /^(\\d{4})-(\\d{2})-(\\d{2})(?:-(\\d{2}))?\\.log$/,\n      );\n      const weekMatch = file.match(/^(\\d{4})-W(\\d{2})\\.log$/);\n\n      let fileDate: Date | null = null;\n\n      if (dateMatch) {\n        const [, year, month, day, hour] = dateMatch;\n        fileDate = new Date(\n          parseInt(year!, 10),\n          parseInt(month!, 10) - 1,\n          parseInt(day!, 10),\n          hour ? parseInt(hour, 10) : 0,\n        );\n      } else if (weekMatch) {\n        const [, year, week] = weekMatch;\n        // Get the date of the first day of the week\n        const jan4 = new Date(parseInt(year!, 10), 0, 4);\n        const dayOfWeek = jan4.getDay() || 7;\n        fileDate = new Date(jan4);\n        fileDate.setDate(\n          jan4.getDate() - dayOfWeek + 1 + (parseInt(week!, 10) - 1) * 7,\n        );\n      }\n\n      if (fileDate && now - fileDate.getTime() > maxAgeMs) {\n        try {\n          options.unlinkSync(filePath);\n        } catch {\n          // Ignore errors when deleting files\n        }\n      }\n    }\n  }\n\n  if (!options.nonBlocking) {\n    // Blocking mode implementation\n    // deno-lint-ignore no-inner-declarations\n    function flushBuffer(): void {\n      if (buffer.length > 0) {\n        if (shouldRotate()) {\n          performRotation();\n        }\n        const bytes = encoder.encode(buffer);\n        buffer = \"\";\n        options.writeSync(fd, bytes);\n        options.flushSync(fd);\n        lastFlushTimestamp = Date.now();\n        cleanupOldFiles();\n      }\n    }\n\n    const sink: Sink & Disposable = (record: LogRecord) => {\n      buffer += formatter(record);\n\n      const shouldFlushBySize = buffer.length >= bufferSize;\n      const shouldFlushByTime = flushInterval > 0 &&\n        (record.timestamp - lastFlushTimestamp) >= flushInterval;\n\n      if (shouldFlushBySize || shouldFlushByTime) {\n        flushBuffer();\n      }\n    };\n\n    sink[Symbol.dispose] = () => {\n      flushBuffer();\n      options.closeSync(fd);\n    };\n\n    return sink;\n  }\n\n  // Non-blocking mode implementation\n  const asyncOptions = options as AsyncTimeRotatingFileSinkDriver<TFile>;\n  let disposed = false;\n  let activeFlush: Promise<void> | null = null;\n  let flushTimer: ReturnType<typeof setInterval> | null = null;\n\n  async function flushBuffer(): Promise<void> {\n    if (buffer.length === 0) return;\n\n    if (shouldRotate()) {\n      performRotation();\n    }\n\n    const data = buffer;\n    buffer = \"\";\n    try {\n      const bytes = encoder.encode(data);\n      asyncOptions.writeSync(fd, bytes);\n      await asyncOptions.flush(fd);\n      lastFlushTimestamp = Date.now();\n      cleanupOldFiles();\n    } catch {\n      // Silently ignore errors in non-blocking mode\n    }\n  }\n\n  function scheduleFlush(): void {\n    if (activeFlush || disposed) return;\n\n    activeFlush = flushBuffer().finally(() => {\n      activeFlush = null;\n    });\n  }\n\n  function startFlushTimer(): void {\n    if (flushTimer !== null || disposed) return;\n\n    flushTimer = setInterval(() => {\n      scheduleFlush();\n    }, flushInterval);\n  }\n\n  const nonBlockingSink: Sink & AsyncDisposable = (record: LogRecord) => {\n    if (disposed) return;\n    buffer += formatter(record);\n\n    const shouldFlushBySize = buffer.length >= bufferSize;\n    const shouldFlushByTime = flushInterval > 0 &&\n      (record.timestamp - lastFlushTimestamp) >= flushInterval;\n\n    if (shouldFlushBySize || shouldFlushByTime) {\n      scheduleFlush();\n    } else if (flushTimer === null && flushInterval > 0) {\n      startFlushTimer();\n    }\n  };\n\n  nonBlockingSink[Symbol.asyncDispose] = async () => {\n    disposed = true;\n    if (flushTimer !== null) {\n      clearInterval(flushTimer);\n      flushTimer = null;\n    }\n    await flushBuffer();\n    try {\n      await asyncOptions.close(fd);\n    } catch {\n      // Writer might already be closed or errored\n    }\n  };\n\n  return nonBlockingSink;\n}\n"],"mappings":";;;;;;;;AAuHA,SAAgB,WAAWA,MAAoB;CAC7C,MAAM,IAAI,IAAI,KACZ,KAAK,IAAI,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,CAAC;CAE/D,MAAM,SAAS,EAAE,WAAW,IAAI;AAChC,GAAE,WAAW,EAAE,YAAY,GAAG,IAAI,OAAO;CACzC,MAAM,YAAY,IAAI,KAAK,KAAK,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE;AAC7D,QAAO,KAAK,OAAO,EAAE,SAAS,GAAG,UAAU,SAAS,IAAI,QAAW,KAAK,EAAE;AAC3E;;;;;;;AAQD,SAAgB,eAAeA,MAAoB;CACjD,MAAM,IAAI,IAAI,KACZ,KAAK,IAAI,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,CAAC;CAE/D,MAAM,SAAS,EAAE,WAAW,IAAI;AAChC,GAAE,WAAW,EAAE,YAAY,GAAG,IAAI,OAAO;AACzC,QAAO,EAAE,gBAAgB;AAC1B;;;;;;AAOD,SAAgB,mBACdC,UACwB;AACxB,SAAQ,UAAR;EACE,KAAK,SACH,QAAO,CAACD,SAAuB;GAC7B,MAAM,OAAO,KAAK,aAAa;GAC/B,MAAM,KAAK,OAAO,KAAK,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI;GACvD,MAAM,KAAK,OAAO,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;GAClD,MAAM,KAAK,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GAAG,IAAI;AACnD,WAAQ,EAAE,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG;EAClC;EACH,KAAK,QACH,QAAO,CAACA,SAAuB;GAC7B,MAAM,OAAO,KAAK,aAAa;GAC/B,MAAM,KAAK,OAAO,KAAK,UAAU,GAAG,EAAE,CAAC,SAAS,GAAG,IAAI;GACvD,MAAM,KAAK,OAAO,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,IAAI;AAClD,WAAQ,EAAE,KAAK,GAAG,GAAG,GAAG,GAAG;EAC5B;EACH,KAAK,SACH,QAAO,CAACA,SAAuB;GAC7B,MAAM,OAAO,eAAe,KAAK;GACjC,MAAM,OAAO,WAAW,KAAK;AAC7B,WAAQ,EAAE,KAAK,IAAI,OAAO,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;EAClD;CACJ;AACF;;;;;;;;AASD,SAAS,eAAeA,MAAYC,UAAwC;AAC1E,SAAQ,UAAR;EACE,KAAK,SACH,SAAQ,EAAE,KAAK,aAAa,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,KAAK,UAAU,CAAC;EACvF,KAAK,QACH,SAAQ,EAAE,KAAK,aAAa,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,KAAK,SAAS,CAAC;EACpE,KAAK,SACH,SAAQ,EAAE,eAAe,KAAK,CAAC,GAAG,WAAW,KAAK,CAAC;CACtD;AACF;AAqBD,SAAgB,4BACdC,SAMuC;CACvC,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,UAAU,QAAQ,WAAW,IAAI;CACvC,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,oBAAoB,QAAQ,YAAY,mBAAmB,SAAS;CAC1E,MAAM,WAAW,QAAQ;CACzB,MAAM,aAAa,QAAQ,cAAc,OAAO;CAChD,MAAM,gBAAgB,QAAQ,iBAAiB;CAC/C,MAAM,YAAY,QAAQ;AAG1B,KAAI;AACF,UAAQ,UAAU,WAAW,EAAE,WAAW,KAAM,EAAC;CAClD,QAAO,CAEP;CAED,IAAIC,kBAA0B,kCAAkB,IAAI,OAAO;CAC3D,IAAIC,cAAsB,QAAQ,SAAS,WAAW,gBAAgB;CACtE,IAAIC,qBAA6B,+BAAe,IAAI,QAAQ,SAAS;CACrE,IAAIC,KAAY,QAAQ,SAAS,YAAY;CAC7C,IAAIC,qBAA6B,KAAK,KAAK;CAC3C,IAAIC,SAAiB;CAErB,SAAS,eAAwB;EAC/B,MAAM,sBAAM,IAAI;EAChB,MAAM,SAAS,eAAe,KAAK,SAAS;AAC5C,SAAO,WAAW;CACnB;CAED,SAAS,kBAAwB;AAC/B,UAAQ,UAAU,GAAG;EACrB,MAAM,sBAAM,IAAI;AAChB,oBAAkB,kBAAkB,IAAI;AACxC,gBAAc,QAAQ,SAAS,WAAW,gBAAgB;AAC1D,uBAAqB,eAAe,KAAK,SAAS;AAClD,OAAK,QAAQ,SAAS,YAAY;CACnC;CAED,SAAS,kBAAwB;AAC/B,MAAI,oBAAwB;EAE5B,MAAM,MAAM,KAAK,KAAK;EACtB,IAAIC;AACJ,MAAI;AACF,WAAQ,QAAQ,YAAY,UAAU;EACvC,QAAO;AACN;EACD;AAED,OAAK,MAAM,QAAQ,OAAO;AACxB,QAAK,KAAK,SAAS,OAAO,CAAE;AAC5B,OAAI,SAAS,gBAAiB;GAE9B,MAAM,WAAW,QAAQ,SAAS,WAAW,KAAK;GAGlD,MAAM,YAAY,KAAK,MACrB,8CACD;GACD,MAAM,YAAY,KAAK,MAAM,0BAA0B;GAEvD,IAAIC,WAAwB;AAE5B,OAAI,WAAW;IACb,MAAM,GAAG,MAAM,OAAO,KAAK,KAAK,GAAG;AACnC,eAAW,IAAI,KACb,SAAS,MAAO,GAAG,EACnB,SAAS,OAAQ,GAAG,GAAG,GACvB,SAAS,KAAM,GAAG,EAClB,OAAO,SAAS,MAAM,GAAG,GAAG;GAE/B,WAAU,WAAW;IACpB,MAAM,GAAG,MAAM,KAAK,GAAG;IAEvB,MAAM,OAAO,IAAI,KAAK,SAAS,MAAO,GAAG,EAAE,GAAG;IAC9C,MAAM,YAAY,KAAK,QAAQ,IAAI;AACnC,eAAW,IAAI,KAAK;AACpB,aAAS,QACP,KAAK,SAAS,GAAG,YAAY,KAAK,SAAS,MAAO,GAAG,GAAG,KAAK,EAC9D;GACF;AAED,OAAI,YAAY,MAAM,SAAS,SAAS,GAAG,SACzC,KAAI;AACF,YAAQ,WAAW,SAAS;GAC7B,QAAO,CAEP;EAEJ;CACF;AAED,MAAK,QAAQ,aAAa;EAGxB,SAASC,gBAAoB;AAC3B,OAAI,OAAO,SAAS,GAAG;AACrB,QAAI,cAAc,CAChB,kBAAiB;IAEnB,MAAM,QAAQ,QAAQ,OAAO,OAAO;AACpC,aAAS;AACT,YAAQ,UAAU,IAAI,MAAM;AAC5B,YAAQ,UAAU,GAAG;AACrB,yBAAqB,KAAK,KAAK;AAC/B,qBAAiB;GAClB;EACF;EAED,MAAMC,OAA0B,CAACC,WAAsB;AACrD,aAAU,UAAU,OAAO;GAE3B,MAAM,oBAAoB,OAAO,UAAU;GAC3C,MAAM,oBAAoB,gBAAgB,KACvC,OAAO,YAAY,sBAAuB;AAE7C,OAAI,qBAAqB,kBACvB,gBAAa;EAEhB;AAED,OAAK,OAAO,WAAW,MAAM;AAC3B,kBAAa;AACb,WAAQ,UAAU,GAAG;EACtB;AAED,SAAO;CACR;CAGD,MAAM,eAAe;CACrB,IAAI,WAAW;CACf,IAAIC,cAAoC;CACxC,IAAIC,aAAoD;CAExD,eAAe,cAA6B;AAC1C,MAAI,OAAO,WAAW,EAAG;AAEzB,MAAI,cAAc,CAChB,kBAAiB;EAGnB,MAAM,OAAO;AACb,WAAS;AACT,MAAI;GACF,MAAM,QAAQ,QAAQ,OAAO,KAAK;AAClC,gBAAa,UAAU,IAAI,MAAM;AACjC,SAAM,aAAa,MAAM,GAAG;AAC5B,wBAAqB,KAAK,KAAK;AAC/B,oBAAiB;EAClB,QAAO,CAEP;CACF;CAED,SAAS,gBAAsB;AAC7B,MAAI,eAAe,SAAU;AAE7B,gBAAc,aAAa,CAAC,QAAQ,MAAM;AACxC,iBAAc;EACf,EAAC;CACH;CAED,SAAS,kBAAwB;AAC/B,MAAI,eAAe,QAAQ,SAAU;AAErC,eAAa,YAAY,MAAM;AAC7B,kBAAe;EAChB,GAAE,cAAc;CAClB;CAED,MAAMC,kBAA0C,CAACH,WAAsB;AACrE,MAAI,SAAU;AACd,YAAU,UAAU,OAAO;EAE3B,MAAM,oBAAoB,OAAO,UAAU;EAC3C,MAAM,oBAAoB,gBAAgB,KACvC,OAAO,YAAY,sBAAuB;AAE7C,MAAI,qBAAqB,kBACvB,gBAAe;WACN,eAAe,QAAQ,gBAAgB,EAChD,kBAAiB;CAEpB;AAED,iBAAgB,OAAO,gBAAgB,YAAY;AACjD,aAAW;AACX,MAAI,eAAe,MAAM;AACvB,iBAAc,WAAW;AACzB,gBAAa;EACd;AACD,QAAM,aAAa;AACnB,MAAI;AACF,SAAM,aAAa,MAAM,GAAG;EAC7B,QAAO,CAEP;CACF;AAED,QAAO;AACR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logtape/file",
-  "version": "1.4.0-dev.444+0dedf000",
+  "version": "1.4.0-dev.446+9d8098ca",
   "description": "File sink and rotating file sink for LogTape",
   "keywords": [
     "logging",
@@ -60,7 +60,7 @@
     "dist/"
   ],
   "peerDependencies": {
-    "@logtape/logtape": "^1.4.0-dev.444+0dedf000"
+    "@logtape/logtape": "^1.4.0-dev.446+9d8098ca"
   },
   "devDependencies": {
     "@alinea/suite": "^0.6.3",