@logtape/file 1.0.0-dev.246 → 1.0.0-dev.248

package/dist/filesink.deno.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.deno.d.cts","names":[],"sources":["../filesink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;AAeC,cAfY,UAeZ,EAfwB,sBAexB,CAf+C,IAAA,CAAK,MAepD,CAAA;;;AAf8C;AA2B/C;;;;;AAGoB;AAmBpB;AAAmC,iBAtBnB,WAAA,CAsBmB,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EApBxB,eAoBwB,CAAA,EAnBhC,IAmBgC,GAnBzB,UAmByB;;;;AAGf;;;;;;;;;;;;iBAHJ,mBAAA,yBAEL,0BACR,OAAO"}
+{"version":3,"file":"filesink.deno.d.cts","names":[],"sources":["../filesink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;AAsBC,cAtBY,UAsBZ,EAtBwB,sBAsBxB,CAtB+C,IAAA,CAAK,MAsBpD,CAAA;;;AAtB8C;AA4B/C;AAeC,cAfY,eAeZ,EAf6B,2BAe7B,CAfyD,IAAA,CAAK,MAe9D,CAAA;;;AAfwD;AA4BzD;;;;;AAGoB;AACpB;;AAEW,iBANK,WAAA,CAML,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAJC,eAID,CAAA,EAHR,IAGQ,GAHD,UAGC;AACR,iBAHa,WAAA,CAGb,IAAA,EAAA,MAAA,EAAA,OAAA,EADQ,eACR,GAAA;EAAI,WAAG,EAAA,IAAA;AAAe,CAAA,CAAA,EAAtB,IAAsB,GAAf,eAAe;AA2BzB;;;;;AAGoB;AACpB;;;;;AAGyB;;;;;iBAPT,mBAAA,yBAEJ,0BACT,OAAO;iBACM,mBAAA,wBAEL;;IACR,OAAO"}

package/dist/filesink.deno.d.ts

@@ -1,4 +1,4 @@
-import { FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.js";
+import { AsyncRotatingFileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.js";
 import { Sink } from "@logtape/logtape";
 
 //#region filesink.deno.d.ts
@@ -7,6 +7,11 @@ import { Sink } from "@logtape/logtape";
  * A Deno-specific file sink driver.
  */
 declare const denoDriver: RotatingFileSinkDriver<Deno.FsFile>;
+/**
+ * A Deno-specific async file sink driver.
+ * @since 1.0.0
+ */
+declare const denoAsyncDriver: AsyncRotatingFileSinkDriver<Deno.FsFile>;
 /**
  * Get a file sink.
  *
@@ -15,9 +20,13 @@ declare const denoDriver: RotatingFileSinkDriver<Deno.FsFile>;
  * @param path A path to the file to write to.
  * @param options The options for the sink.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Disposable;
+declare function getFileSink(path: string, options: FileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 /**
  * Get a rotating file sink.
  *
@@ -31,10 +40,14 @@ declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Di
  * @param path A path to the file to write to.
  * @param options The options for the sink and the file driver.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getRotatingFileSink(path: string, options?: RotatingFileSinkOptions): Sink & Disposable;
+declare function getRotatingFileSink(path: string, options: RotatingFileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 //# sourceMappingURL=filesink.deno.d.ts.map
 //#endregion
-export { denoDriver, getFileSink, getRotatingFileSink };
+export { denoAsyncDriver, denoDriver, getFileSink, getRotatingFileSink };
 //# sourceMappingURL=filesink.deno.d.ts.map

package/dist/filesink.deno.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.deno.d.ts","names":[],"sources":["../filesink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAYA;AAeC,cAfY,UAeZ,EAfwB,sBAexB,CAf+C,IAAA,CAAK,MAepD,CAAA;;;AAf8C;AA2B/C;;;;;AAGoB;AAmBpB;AAAmC,iBAtBnB,WAAA,CAsBmB,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EApBxB,eAoBwB,CAAA,EAnBhC,IAmBgC,GAnBzB,UAmByB;;;;AAGf;;;;;;;;;;;;iBAHJ,mBAAA,yBAEL,0BACR,OAAO"}
+{"version":3,"file":"filesink.deno.d.ts","names":[],"sources":["../filesink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;AAsBC,cAtBY,UAsBZ,EAtBwB,sBAsBxB,CAtB+C,IAAA,CAAK,MAsBpD,CAAA;;;AAtB8C;AA4B/C;AAeC,cAfY,eAeZ,EAf6B,2BAe7B,CAfyD,IAAA,CAAK,MAe9D,CAAA;;;AAfwD;AA4BzD;;;;;AAGoB;AACpB;;AAEW,iBANK,WAAA,CAML,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAJC,eAID,CAAA,EAHR,IAGQ,GAHD,UAGC;AACR,iBAHa,WAAA,CAGb,IAAA,EAAA,MAAA,EAAA,OAAA,EADQ,eACR,GAAA;EAAI,WAAG,EAAA,IAAA;AAAe,CAAA,CAAA,EAAtB,IAAsB,GAAf,eAAe;AA2BzB;;;;;AAGoB;AACpB;;;;;AAGyB;;;;;iBAPT,mBAAA,yBAEJ,0BACT,OAAO;iBACM,mBAAA,wBAEL;;IACR,OAAO"}

package/dist/filesink.deno.js

@@ -14,6 +14,9 @@ const denoDriver = {
 	writeSync(fd, chunk) {
 		fd.writeSync(chunk);
 	},
+	writeManySync(fd, chunks) {
+		for (const chunk of chunks) fd.writeSync(chunk);
+	},
 	flushSync(fd) {
 		fd.syncSync();
 	},
@@ -24,37 +27,36 @@ const denoDriver = {
 	renameSync: globalThis?.Deno.renameSync
 };
 /**
-* Get a file sink.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
+* A Deno-specific async file sink driver.
+* @since 1.0.0
 */
+const denoAsyncDriver = {
+	...denoDriver,
+	async writeMany(fd, chunks) {
+		for (const chunk of chunks) await fd.write(chunk);
+	},
+	async flush(fd) {
+		await fd.sync();
+	},
+	close(fd) {
+		return Promise.resolve(fd.close());
+	}
+};
 function getFileSink(path, options = {}) {
+	if (options.nonBlocking) return getBaseFileSink(path, {
+		...options,
+		...denoAsyncDriver
+	});
 	return getBaseFileSink(path, {
 		...options,
 		...denoDriver
 	});
 }
-/**
-* Get a rotating file sink.
-*
-* This sink writes log records to a file, and rotates the file when it reaches
-* the `maxSize`.  The rotated files are named with the original file name
-* followed by a dot and a number, starting from 1.  The number is incremented
-* for each rotation, and the maximum number of files to keep is `maxFiles`.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink and the file driver.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
-*/
 function getRotatingFileSink(path, options = {}) {
+	if (options.nonBlocking) return getBaseRotatingFileSink(path, {
+		...options,
+		...denoAsyncDriver
+	});
 	return getBaseRotatingFileSink(path, {
 		...options,
 		...denoDriver
@@ -62,5 +64,5 @@ function getRotatingFileSink(path, options = {}) {
 }
 
 //#endregion
-export { denoDriver, getFileSink, getRotatingFileSink };
+export { denoAsyncDriver, denoDriver, getFileSink, getRotatingFileSink };
 //# sourceMappingURL=filesink.deno.js.map

package/dist/filesink.deno.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.deno.js","names":["denoDriver: RotatingFileSinkDriver<Deno.FsFile>","path: string","options: FileSinkOptions","options: RotatingFileSinkOptions"],"sources":["../filesink.deno.ts"],"sourcesContent":["import type { Sink } from \"@logtape/logtape\";\nimport {\n  type FileSinkOptions,\n  getBaseFileSink,\n  getBaseRotatingFileSink,\n  type RotatingFileSinkDriver,\n  type RotatingFileSinkOptions,\n} from \"./filesink.base.ts\";\n\n/**\n * A Deno-specific file sink driver.\n */\nexport const denoDriver: RotatingFileSinkDriver<Deno.FsFile> = {\n  openSync(path: string) {\n    return Deno.openSync(path, { create: true, append: true });\n  },\n  writeSync(fd, chunk) {\n    fd.writeSync(chunk);\n  },\n  flushSync(fd) {\n    fd.syncSync();\n  },\n  closeSync(fd) {\n    fd.close();\n  },\n  statSync: globalThis?.Deno.statSync,\n  renameSync: globalThis?.Deno.renameSync,\n};\n\n/**\n * Get a file sink.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\n * @param options The options for the sink.\n * @returns A sink that writes to the file.  The sink is also a disposable\n *          object that closes the file when disposed.\n */\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions = {},\n): Sink & Disposable {\n  return getBaseFileSink(path, { ...options, ...denoDriver });\n}\n\n/**\n * Get a rotating file sink.\n *\n * This sink writes log records to a file, and rotates the file when it reaches\n * the `maxSize`.  The rotated files are named with the original file name\n * followed by a dot and a number, starting from 1.  The number is incremented\n * for each rotation, and the maximum number of files to keep is `maxFiles`.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\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.\n */\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions = {},\n): Sink & Disposable {\n  return getBaseRotatingFileSink(path, { ...options, ...denoDriver });\n}\n\n// cSpell: ignore filesink\n"],"mappings":";;;;;;AAYA,MAAaA,aAAkD;CAC7D,SAASC,MAAc;AACrB,SAAO,KAAK,SAAS,MAAM;GAAE,QAAQ;GAAM,QAAQ;EAAM,EAAC;CAC3D;CACD,UAAU,IAAI,OAAO;AACnB,KAAG,UAAU,MAAM;CACpB;CACD,UAAU,IAAI;AACZ,KAAG,UAAU;CACd;CACD,UAAU,IAAI;AACZ,KAAG,OAAO;CACX;CACD,UAAU,YAAY,KAAK;CAC3B,YAAY,YAAY,KAAK;AAC9B;;;;;;;;;;;AAYD,SAAgB,YACdA,MACAC,UAA2B,CAAE,GACV;AACnB,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AAC5D;;;;;;;;;;;;;;;;AAiBD,SAAgB,oBACdD,MACAE,UAAmC,CAAE,GAClB;AACnB,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AACpE"}
+{"version":3,"file":"filesink.deno.js","names":["denoDriver: RotatingFileSinkDriver<Deno.FsFile>","path: string","fd: Deno.FsFile","chunks: Uint8Array[]","denoAsyncDriver: AsyncRotatingFileSinkDriver<Deno.FsFile>","options: FileSinkOptions","options: RotatingFileSinkOptions"],"sources":["../filesink.deno.ts"],"sourcesContent":["import type { Sink } from \"@logtape/logtape\";\nimport {\n  type AsyncRotatingFileSinkDriver,\n  type FileSinkOptions,\n  getBaseFileSink,\n  getBaseRotatingFileSink,\n  type RotatingFileSinkDriver,\n  type RotatingFileSinkOptions,\n} from \"./filesink.base.ts\";\n\n/**\n * A Deno-specific file sink driver.\n */\nexport const denoDriver: RotatingFileSinkDriver<Deno.FsFile> = {\n  openSync(path: string) {\n    return Deno.openSync(path, { create: true, append: true });\n  },\n  writeSync(fd, chunk) {\n    fd.writeSync(chunk);\n  },\n  writeManySync(fd: Deno.FsFile, chunks: Uint8Array[]): void {\n    // Deno doesn't have writev, but we can optimize by writing all chunks\n    // then doing a single sync operation\n    for (const chunk of chunks) {\n      fd.writeSync(chunk);\n    }\n  },\n  flushSync(fd) {\n    fd.syncSync();\n  },\n  closeSync(fd) {\n    fd.close();\n  },\n  statSync: globalThis?.Deno.statSync,\n  renameSync: globalThis?.Deno.renameSync,\n};\n\n/**\n * A Deno-specific async file sink driver.\n * @since 1.0.0\n */\nexport const denoAsyncDriver: AsyncRotatingFileSinkDriver<Deno.FsFile> = {\n  ...denoDriver,\n  async writeMany(fd: Deno.FsFile, chunks: Uint8Array[]): Promise<void> {\n    // Deno doesn't have async writev, but we can write all chunks\n    // then do a single async sync\n    for (const chunk of chunks) {\n      await fd.write(chunk);\n    }\n  },\n  async flush(fd) {\n    await fd.sync();\n  },\n  close(fd) {\n    return Promise.resolve(fd.close());\n  },\n};\n\n/**\n * Get a file sink.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\n * @param options The options for the sink.\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 enabled,\n *          returns a sink that also implements {@link AsyncDisposable}.\n */\nexport function getFileSink(\n  path: string,\n  options?: FileSinkOptions,\n): Sink & Disposable;\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions & { nonBlocking: true },\n): Sink & AsyncDisposable;\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions = {},\n): Sink & (Disposable | AsyncDisposable) {\n  if (options.nonBlocking) {\n    return getBaseFileSink(path, { ...options, ...denoAsyncDriver });\n  }\n  return getBaseFileSink(path, { ...options, ...denoDriver });\n}\n\n/**\n * Get a rotating file sink.\n *\n * This sink writes log records to a file, and rotates the file when it reaches\n * the `maxSize`.  The rotated files are named with the original file name\n * followed by a dot and a number, starting from 1.  The number is incremented\n * for each rotation, and the maximum number of files to keep is `maxFiles`.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\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 enabled,\n *          returns a sink that also implements {@link AsyncDisposable}.\n */\nexport function getRotatingFileSink(\n  path: string,\n  options?: RotatingFileSinkOptions,\n): Sink & Disposable;\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions & { nonBlocking: true },\n): Sink & AsyncDisposable;\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions = {},\n): Sink & (Disposable | AsyncDisposable) {\n  if (options.nonBlocking) {\n    return getBaseRotatingFileSink(path, { ...options, ...denoAsyncDriver });\n  }\n  return getBaseRotatingFileSink(path, { ...options, ...denoDriver });\n}\n\n// cSpell: ignore filesink\n"],"mappings":";;;;;;AAaA,MAAaA,aAAkD;CAC7D,SAASC,MAAc;AACrB,SAAO,KAAK,SAAS,MAAM;GAAE,QAAQ;GAAM,QAAQ;EAAM,EAAC;CAC3D;CACD,UAAU,IAAI,OAAO;AACnB,KAAG,UAAU,MAAM;CACpB;CACD,cAAcC,IAAiBC,QAA4B;AAGzD,OAAK,MAAM,SAAS,OAClB,IAAG,UAAU,MAAM;CAEtB;CACD,UAAU,IAAI;AACZ,KAAG,UAAU;CACd;CACD,UAAU,IAAI;AACZ,KAAG,OAAO;CACX;CACD,UAAU,YAAY,KAAK;CAC3B,YAAY,YAAY,KAAK;AAC9B;;;;;AAMD,MAAaC,kBAA4D;CACvE,GAAG;CACH,MAAM,UAAUF,IAAiBC,QAAqC;AAGpE,OAAK,MAAM,SAAS,OAClB,OAAM,GAAG,MAAM,MAAM;CAExB;CACD,MAAM,MAAM,IAAI;AACd,QAAM,GAAG,MAAM;CAChB;CACD,MAAM,IAAI;AACR,SAAO,QAAQ,QAAQ,GAAG,OAAO,CAAC;CACnC;AACF;AAqBD,SAAgB,YACdF,MACAI,UAA2B,CAAE,GACU;AACvC,KAAI,QAAQ,YACV,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAiB,EAAC;AAElE,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AAC5D;AA0BD,SAAgB,oBACdJ,MACAK,UAAmC,CAAE,GACE;AACvC,KAAI,QAAQ,YACV,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAiB,EAAC;AAE1E,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AACpE"}

package/dist/filesink.node.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const require_filesink_base = require('./filesink.base.cjs');
 const node_fs = require_rolldown_runtime.__toESM(require("node:fs"));
+const node_util = require_rolldown_runtime.__toESM(require("node:util"));
 
 //#region filesink.node.ts
 /**
@@ -11,43 +12,51 @@ const nodeDriver = {
 		return node_fs.default.openSync(path, "a");
 	},
 	writeSync: node_fs.default.writeSync,
+	writeManySync(fd, chunks) {
+		if (chunks.length === 0) return;
+		if (chunks.length === 1) {
+			node_fs.default.writeSync(fd, chunks[0]);
+			return;
+		}
+		node_fs.default.writevSync(fd, chunks);
+	},
 	flushSync: node_fs.default.fsyncSync,
 	closeSync: node_fs.default.closeSync,
 	statSync: node_fs.default.statSync,
 	renameSync: node_fs.default.renameSync
 };
 /**
-* Get a file sink.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
+* A Node.js-specific async file sink driver.
+* @since 1.0.0
 */
+const nodeAsyncDriver = {
+	...nodeDriver,
+	async writeMany(fd, chunks) {
+		if (chunks.length === 0) return;
+		if (chunks.length === 1) {
+			await (0, node_util.promisify)(node_fs.default.write)(fd, chunks[0]);
+			return;
+		}
+		await (0, node_util.promisify)(node_fs.default.writev)(fd, chunks);
+	},
+	flush: (0, node_util.promisify)(node_fs.default.fsync),
+	close: (0, node_util.promisify)(node_fs.default.close)
+};
 function getFileSink(path, options = {}) {
+	if (options.nonBlocking) return require_filesink_base.getBaseFileSink(path, {
+		...options,
+		...nodeAsyncDriver
+	});
 	return require_filesink_base.getBaseFileSink(path, {
 		...options,
 		...nodeDriver
 	});
 }
-/**
-* Get a rotating file sink.
-*
-* This sink writes log records to a file, and rotates the file when it reaches
-* the `maxSize`.  The rotated files are named with the original file name
-* followed by a dot and a number, starting from 1.  The number is incremented
-* for each rotation, and the maximum number of files to keep is `maxFiles`.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink and the file driver.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
-*/
 function getRotatingFileSink(path, options = {}) {
+	if (options.nonBlocking) return require_filesink_base.getBaseRotatingFileSink(path, {
+		...options,
+		...nodeAsyncDriver
+	});
 	return require_filesink_base.getBaseRotatingFileSink(path, {
 		...options,
 		...nodeDriver
@@ -57,4 +66,5 @@ function getRotatingFileSink(path, options = {}) {
 //#endregion
 exports.getFileSink = getFileSink;
 exports.getRotatingFileSink = getRotatingFileSink;
+exports.nodeAsyncDriver = nodeAsyncDriver;
 exports.nodeDriver = nodeDriver;

package/dist/filesink.node.d.cts

@@ -1,4 +1,4 @@
-import { FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.cjs";
+import { AsyncRotatingFileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.cjs";
 import { Sink } from "@logtape/logtape";
 
 //#region filesink.node.d.ts
@@ -7,6 +7,11 @@ import { Sink } from "@logtape/logtape";
  * A Node.js-specific file sink driver.
  */
 declare const nodeDriver: RotatingFileSinkDriver<number | void>;
+/**
+ * A Node.js-specific async file sink driver.
+ * @since 1.0.0
+ */
+declare const nodeAsyncDriver: AsyncRotatingFileSinkDriver<number | void>;
 /**
  * Get a file sink.
  *
@@ -15,9 +20,13 @@ declare const nodeDriver: RotatingFileSinkDriver<number | void>;
  * @param path A path to the file to write to.
  * @param options The options for the sink.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Disposable;
+declare function getFileSink(path: string, options: FileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 /**
  * Get a rotating file sink.
  *
@@ -31,10 +40,14 @@ declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Di
  * @param path A path to the file to write to.
  * @param options The options for the sink and the file driver.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getRotatingFileSink(path: string, options?: RotatingFileSinkOptions): Sink & Disposable;
+declare function getRotatingFileSink(path: string, options: RotatingFileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 //# sourceMappingURL=filesink.node.d.ts.map
 //#endregion
-export { getFileSink, getRotatingFileSink, nodeDriver };
+export { getFileSink, getRotatingFileSink, nodeAsyncDriver, nodeDriver };
 //# sourceMappingURL=filesink.node.d.cts.map

package/dist/filesink.node.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.node.d.cts","names":[],"sources":["../filesink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;AAqBgB,cArBH,UAqBc,EArBF,sBAqBE,CAAA,MAAA,GAAA,IAAA,CAAA;;;;;AAGP;AAmBpB;;;;;AAGoB,iBAzBJ,WAAA,CAyBI,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAvBT,eAuBS,CAAA,EAtBjB,IAsBiB,GAtBV,UAsBU;;;;;;;;;;;;;;;;iBAHJ,mBAAA,yBAEL,0BACR,OAAO"}
+{"version":3,"file":"filesink.node.d.cts","names":[],"sources":["../filesink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;AAwBa,cAxBA,UAqCZ,EArCwB,sBAwBK,CAAA,MAA2B,GAAA,IAAA,CAAA;AA0BzD;;;;AAGU,cA7BG,eA6BH,EA7BoB,2BA6BpB,CAAA,MAAA,GAAA,IAAA,CAAA;AAAU;AACpB;;;;;AAGyB;AA2BzB;;;;AAGU,iBArCM,WAAA,CAqCN,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAnCE,eAmCF,CAAA,EAlCP,IAkCO,GAlCA,UAkCA;AAAU,iBAjCJ,WAAA,CAiCI,IAAA,EAAA,MAAA,EAAA,OAAA,EA/BT,eA+BS,GAAA;EACJ,WAAA,EAAA,IAAA;CAAmB,CAAA,EA/BhC,IA+BgC,GA/BzB,eA+ByB;;;;AAGV;;;;;;;;;;;;;iBAPT,mBAAA,yBAEJ,0BACT,OAAO;iBACM,mBAAA,wBAEL;;IACR,OAAO"}

package/dist/filesink.node.d.ts

@@ -1,4 +1,4 @@
-import { FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.js";
+import { AsyncRotatingFileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.js";
 import { Sink } from "@logtape/logtape";
 
 //#region filesink.node.d.ts
@@ -7,6 +7,11 @@ import { Sink } from "@logtape/logtape";
  * A Node.js-specific file sink driver.
  */
 declare const nodeDriver: RotatingFileSinkDriver<number | void>;
+/**
+ * A Node.js-specific async file sink driver.
+ * @since 1.0.0
+ */
+declare const nodeAsyncDriver: AsyncRotatingFileSinkDriver<number | void>;
 /**
  * Get a file sink.
  *
@@ -15,9 +20,13 @@ declare const nodeDriver: RotatingFileSinkDriver<number | void>;
  * @param path A path to the file to write to.
  * @param options The options for the sink.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Disposable;
+declare function getFileSink(path: string, options: FileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 /**
  * Get a rotating file sink.
  *
@@ -31,10 +40,14 @@ declare function getFileSink(path: string, options?: FileSinkOptions): Sink & Di
  * @param path A path to the file to write to.
  * @param options The options for the sink and the file driver.
  * @returns A sink that writes to the file.  The sink is also a disposable
- *          object that closes the file when disposed.
+ *          object that closes the file when disposed. If `nonBlocking` is enabled,
+ *          returns a sink that also implements {@link AsyncDisposable}.
  */
 declare function getRotatingFileSink(path: string, options?: RotatingFileSinkOptions): Sink & Disposable;
+declare function getRotatingFileSink(path: string, options: RotatingFileSinkOptions & {
+  nonBlocking: true;
+}): Sink & AsyncDisposable;
 //# sourceMappingURL=filesink.node.d.ts.map
 //#endregion
-export { getFileSink, getRotatingFileSink, nodeDriver };
+export { getFileSink, getRotatingFileSink, nodeAsyncDriver, nodeDriver };
 //# sourceMappingURL=filesink.node.d.ts.map

package/dist/filesink.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.node.d.ts","names":[],"sources":["../filesink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAaA;AAqBgB,cArBH,UAqBc,EArBF,sBAqBE,CAAA,MAAA,GAAA,IAAA,CAAA;;;;;AAGP;AAmBpB;;;;;AAGoB,iBAzBJ,WAAA,CAyBI,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAvBT,eAuBS,CAAA,EAtBjB,IAsBiB,GAtBV,UAsBU;;;;;;;;;;;;;;;;iBAHJ,mBAAA,yBAEL,0BACR,OAAO"}
+{"version":3,"file":"filesink.node.d.ts","names":[],"sources":["../filesink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAeA;AAwBa,cAxBA,UAqCZ,EArCwB,sBAwBK,CAAA,MAA2B,GAAA,IAAA,CAAA;AA0BzD;;;;AAGU,cA7BG,eA6BH,EA7BoB,2BA6BpB,CAAA,MAAA,GAAA,IAAA,CAAA;AAAU;AACpB;;;;;AAGyB;AA2BzB;;;;AAGU,iBArCM,WAAA,CAqCN,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAnCE,eAmCF,CAAA,EAlCP,IAkCO,GAlCA,UAkCA;AAAU,iBAjCJ,WAAA,CAiCI,IAAA,EAAA,MAAA,EAAA,OAAA,EA/BT,eA+BS,GAAA;EACJ,WAAA,EAAA,IAAA;CAAmB,CAAA,EA/BhC,IA+BgC,GA/BzB,eA+ByB;;;;AAGV;;;;;;;;;;;;;iBAPT,mBAAA,yBAEJ,0BACT,OAAO;iBACM,mBAAA,wBAEL;;IACR,OAAO"}

package/dist/filesink.node.js

@@ -1,5 +1,6 @@
 import { getBaseFileSink, getBaseRotatingFileSink } from "./filesink.base.js";
 import fs from "node:fs";
+import { promisify } from "node:util";
 
 //#region filesink.node.ts
 /**
@@ -10,43 +11,51 @@ const nodeDriver = {
 		return fs.openSync(path, "a");
 	},
 	writeSync: fs.writeSync,
+	writeManySync(fd, chunks) {
+		if (chunks.length === 0) return;
+		if (chunks.length === 1) {
+			fs.writeSync(fd, chunks[0]);
+			return;
+		}
+		fs.writevSync(fd, chunks);
+	},
 	flushSync: fs.fsyncSync,
 	closeSync: fs.closeSync,
 	statSync: fs.statSync,
 	renameSync: fs.renameSync
 };
 /**
-* Get a file sink.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
+* A Node.js-specific async file sink driver.
+* @since 1.0.0
 */
+const nodeAsyncDriver = {
+	...nodeDriver,
+	async writeMany(fd, chunks) {
+		if (chunks.length === 0) return;
+		if (chunks.length === 1) {
+			await promisify(fs.write)(fd, chunks[0]);
+			return;
+		}
+		await promisify(fs.writev)(fd, chunks);
+	},
+	flush: promisify(fs.fsync),
+	close: promisify(fs.close)
+};
 function getFileSink(path, options = {}) {
+	if (options.nonBlocking) return getBaseFileSink(path, {
+		...options,
+		...nodeAsyncDriver
+	});
 	return getBaseFileSink(path, {
 		...options,
 		...nodeDriver
 	});
 }
-/**
-* Get a rotating file sink.
-*
-* This sink writes log records to a file, and rotates the file when it reaches
-* the `maxSize`.  The rotated files are named with the original file name
-* followed by a dot and a number, starting from 1.  The number is incremented
-* for each rotation, and the maximum number of files to keep is `maxFiles`.
-*
-* Note that this function is unavailable in the browser.
-*
-* @param path A path to the file to write to.
-* @param options The options for the sink and the file driver.
-* @returns A sink that writes to the file.  The sink is also a disposable
-*          object that closes the file when disposed.
-*/
 function getRotatingFileSink(path, options = {}) {
+	if (options.nonBlocking) return getBaseRotatingFileSink(path, {
+		...options,
+		...nodeAsyncDriver
+	});
 	return getBaseRotatingFileSink(path, {
 		...options,
 		...nodeDriver
@@ -54,5 +63,5 @@ function getRotatingFileSink(path, options = {}) {
 }
 
 //#endregion
-export { getFileSink, getRotatingFileSink, nodeDriver };
+export { getFileSink, getRotatingFileSink, nodeAsyncDriver, nodeDriver };
 //# sourceMappingURL=filesink.node.js.map

package/dist/filesink.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesink.node.js","names":["nodeDriver: RotatingFileSinkDriver<number | void>","path: string","options: FileSinkOptions","options: RotatingFileSinkOptions"],"sources":["../filesink.node.ts"],"sourcesContent":["import type { Sink } from \"@logtape/logtape\";\nimport fs from \"node:fs\";\nimport {\n  type FileSinkOptions,\n  getBaseFileSink,\n  getBaseRotatingFileSink,\n  type RotatingFileSinkDriver,\n  type RotatingFileSinkOptions,\n} from \"./filesink.base.ts\";\n\n/**\n * A Node.js-specific file sink driver.\n */\nexport const nodeDriver: RotatingFileSinkDriver<number | void> = {\n  openSync(path: string) {\n    return fs.openSync(path, \"a\");\n  },\n  writeSync: fs.writeSync,\n  flushSync: fs.fsyncSync,\n  closeSync: fs.closeSync,\n  statSync: fs.statSync,\n  renameSync: fs.renameSync,\n};\n\n/**\n * Get a file sink.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\n * @param options The options for the sink.\n * @returns A sink that writes to the file.  The sink is also a disposable\n *          object that closes the file when disposed.\n */\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions = {},\n): Sink & Disposable {\n  return getBaseFileSink(path, { ...options, ...nodeDriver });\n}\n\n/**\n * Get a rotating file sink.\n *\n * This sink writes log records to a file, and rotates the file when it reaches\n * the `maxSize`.  The rotated files are named with the original file name\n * followed by a dot and a number, starting from 1.  The number is incremented\n * for each rotation, and the maximum number of files to keep is `maxFiles`.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\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.\n */\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions = {},\n): Sink & Disposable {\n  return getBaseRotatingFileSink(path, { ...options, ...nodeDriver });\n}\n\n// cSpell: ignore filesink\n"],"mappings":";;;;;;;AAaA,MAAaA,aAAoD;CAC/D,SAASC,MAAc;AACrB,SAAO,GAAG,SAAS,MAAM,IAAI;CAC9B;CACD,WAAW,GAAG;CACd,WAAW,GAAG;CACd,WAAW,GAAG;CACd,UAAU,GAAG;CACb,YAAY,GAAG;AAChB;;;;;;;;;;;AAYD,SAAgB,YACdA,MACAC,UAA2B,CAAE,GACV;AACnB,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AAC5D;;;;;;;;;;;;;;;;AAiBD,SAAgB,oBACdD,MACAE,UAAmC,CAAE,GAClB;AACnB,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AACpE"}
+{"version":3,"file":"filesink.node.js","names":["nodeDriver: RotatingFileSinkDriver<number | void>","path: string","fd: number","chunks: Uint8Array[]","nodeAsyncDriver: AsyncRotatingFileSinkDriver<number | void>","options: FileSinkOptions","options: RotatingFileSinkOptions"],"sources":["../filesink.node.ts"],"sourcesContent":["import type { Sink } from \"@logtape/logtape\";\nimport fs from \"node:fs\";\nimport { promisify } from \"node:util\";\nimport {\n  type AsyncRotatingFileSinkDriver,\n  type FileSinkOptions,\n  getBaseFileSink,\n  getBaseRotatingFileSink,\n  type RotatingFileSinkDriver,\n  type RotatingFileSinkOptions,\n} from \"./filesink.base.ts\";\n\n/**\n * A Node.js-specific file sink driver.\n */\nexport const nodeDriver: RotatingFileSinkDriver<number | void> = {\n  openSync(path: string) {\n    return fs.openSync(path, \"a\");\n  },\n  writeSync: fs.writeSync,\n  writeManySync(fd: number, chunks: Uint8Array[]): void {\n    if (chunks.length === 0) return;\n    if (chunks.length === 1) {\n      fs.writeSync(fd, chunks[0]);\n      return;\n    }\n    // Use writev for multiple chunks\n    fs.writevSync(fd, chunks);\n  },\n  flushSync: fs.fsyncSync,\n  closeSync: fs.closeSync,\n  statSync: fs.statSync,\n  renameSync: fs.renameSync,\n};\n\n/**\n * A Node.js-specific async file sink driver.\n * @since 1.0.0\n */\nexport const nodeAsyncDriver: AsyncRotatingFileSinkDriver<number | void> = {\n  ...nodeDriver,\n  async writeMany(fd: number, chunks: Uint8Array[]): Promise<void> {\n    if (chunks.length === 0) return;\n    if (chunks.length === 1) {\n      await promisify(fs.write)(fd, chunks[0]);\n      return;\n    }\n    // Use async writev for multiple chunks\n    await promisify(fs.writev)(fd, chunks);\n  },\n  flush: promisify(fs.fsync),\n  close: promisify(fs.close),\n};\n\n/**\n * Get a file sink.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\n * @param options The options for the sink.\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 enabled,\n *          returns a sink that also implements {@link AsyncDisposable}.\n */\nexport function getFileSink(\n  path: string,\n  options?: FileSinkOptions,\n): Sink & Disposable;\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions & { nonBlocking: true },\n): Sink & AsyncDisposable;\nexport function getFileSink(\n  path: string,\n  options: FileSinkOptions = {},\n): Sink & (Disposable | AsyncDisposable) {\n  if (options.nonBlocking) {\n    return getBaseFileSink(path, { ...options, ...nodeAsyncDriver });\n  }\n  return getBaseFileSink(path, { ...options, ...nodeDriver });\n}\n\n/**\n * Get a rotating file sink.\n *\n * This sink writes log records to a file, and rotates the file when it reaches\n * the `maxSize`.  The rotated files are named with the original file name\n * followed by a dot and a number, starting from 1.  The number is incremented\n * for each rotation, and the maximum number of files to keep is `maxFiles`.\n *\n * Note that this function is unavailable in the browser.\n *\n * @param path A path to the file to write to.\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 enabled,\n *          returns a sink that also implements {@link AsyncDisposable}.\n */\nexport function getRotatingFileSink(\n  path: string,\n  options?: RotatingFileSinkOptions,\n): Sink & Disposable;\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions & { nonBlocking: true },\n): Sink & AsyncDisposable;\nexport function getRotatingFileSink(\n  path: string,\n  options: RotatingFileSinkOptions = {},\n): Sink & (Disposable | AsyncDisposable) {\n  if (options.nonBlocking) {\n    return getBaseRotatingFileSink(path, { ...options, ...nodeAsyncDriver });\n  }\n  return getBaseRotatingFileSink(path, { ...options, ...nodeDriver });\n}\n\n// cSpell: ignore filesink\n"],"mappings":";;;;;;;;AAeA,MAAaA,aAAoD;CAC/D,SAASC,MAAc;AACrB,SAAO,GAAG,SAAS,MAAM,IAAI;CAC9B;CACD,WAAW,GAAG;CACd,cAAcC,IAAYC,QAA4B;AACpD,MAAI,OAAO,WAAW,EAAG;AACzB,MAAI,OAAO,WAAW,GAAG;AACvB,MAAG,UAAU,IAAI,OAAO,GAAG;AAC3B;EACD;AAED,KAAG,WAAW,IAAI,OAAO;CAC1B;CACD,WAAW,GAAG;CACd,WAAW,GAAG;CACd,UAAU,GAAG;CACb,YAAY,GAAG;AAChB;;;;;AAMD,MAAaC,kBAA8D;CACzE,GAAG;CACH,MAAM,UAAUF,IAAYC,QAAqC;AAC/D,MAAI,OAAO,WAAW,EAAG;AACzB,MAAI,OAAO,WAAW,GAAG;AACvB,SAAM,UAAU,GAAG,MAAM,CAAC,IAAI,OAAO,GAAG;AACxC;EACD;AAED,QAAM,UAAU,GAAG,OAAO,CAAC,IAAI,OAAO;CACvC;CACD,OAAO,UAAU,GAAG,MAAM;CAC1B,OAAO,UAAU,GAAG,MAAM;AAC3B;AAqBD,SAAgB,YACdF,MACAI,UAA2B,CAAE,GACU;AACvC,KAAI,QAAQ,YACV,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAiB,EAAC;AAElE,QAAO,gBAAgB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AAC5D;AA0BD,SAAgB,oBACdJ,MACAK,UAAmC,CAAE,GACE;AACvC,KAAI,QAAQ,YACV,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAiB,EAAC;AAE1E,QAAO,wBAAwB,MAAM;EAAE,GAAG;EAAS,GAAG;CAAY,EAAC;AACpE"}

package/dist/mod.cjs

@@ -1,4 +1,5 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_streamfilesink = require('./streamfilesink.cjs');
 const __filesink = require_rolldown_runtime.__toESM(require("#filesink"));
 
 Object.defineProperty(exports, 'getFileSink', {
@@ -12,4 +13,5 @@ Object.defineProperty(exports, 'getRotatingFileSink', {
   get: function () {
     return __filesink.getRotatingFileSink;
   }
-});
+});
+exports.getStreamFileSink = require_streamfilesink.getStreamFileSink;

package/dist/mod.d.cts

@@ -1,3 +1,4 @@
 import { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.cjs";
+import { StreamFileSinkOptions, getStreamFileSink } from "./streamfilesink.cjs";
 import { getFileSink, getRotatingFileSink } from "#filesink";
-export { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions, getFileSink, getRotatingFileSink };
+export { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions, StreamFileSinkOptions, getFileSink, getRotatingFileSink, getStreamFileSink };

package/dist/mod.d.ts

@@ -1,3 +1,4 @@
 import { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions } from "./filesink.base.js";
+import { StreamFileSinkOptions, getStreamFileSink } from "./streamfilesink.js";
 import { getFileSink, getRotatingFileSink } from "#filesink";
-export { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions, getFileSink, getRotatingFileSink };
+export { FileSinkDriver, FileSinkOptions, RotatingFileSinkDriver, RotatingFileSinkOptions, StreamFileSinkOptions, getFileSink, getRotatingFileSink, getStreamFileSink };

package/dist/mod.js

@@ -1,3 +1,4 @@
+import { getStreamFileSink } from "./streamfilesink.js";
 import { getFileSink, getRotatingFileSink } from "#filesink";
 
-export { getFileSink, getRotatingFileSink };
+export { getFileSink, getRotatingFileSink, getStreamFileSink };

package/dist/streamfilesink.cjs

@@ -0,0 +1,84 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+const node_fs = require_rolldown_runtime.__toESM(require("node:fs"));
+const node_stream = require_rolldown_runtime.__toESM(require("node:stream"));
+
+//#region streamfilesink.ts
+/**
+* Create a high-performance stream-based file sink that writes log records to a file.
+*
+* This sink uses Node.js PassThrough streams piped to WriteStreams for optimal
+* I/O performance. It leverages the Node.js stream infrastructure to provide
+* automatic backpressure management, efficient buffering, and asynchronous writes
+* without blocking the main thread.
+*
+* ## Performance Characteristics
+*
+* - **High Performance**: Optimized for high-volume logging scenarios
+* - **Non-blocking**: Uses asynchronous I/O that doesn't block the main thread
+* - **Memory Efficient**: Automatic backpressure prevents memory buildup
+* - **Stream-based**: Leverages Node.js native stream optimizations
+*
+* ## When to Use
+*
+* Use this sink when you need:
+* - High-performance file logging for production applications
+* - Non-blocking I/O behavior for real-time applications
+* - Automatic backpressure handling for high-volume scenarios
+* - Simple file output without complex buffering configuration
+*
+* For more control over buffering behavior, consider using {@link getFileSink}
+* instead, which provides options for buffer size, flush intervals, and
+* non-blocking modes.
+*
+* ## Example
+*
+* ```typescript
+* import { configure } from "@logtape/logtape";
+* import { getStreamFileSink } from "@logtape/file";
+*
+* await configure({
+*   sinks: {
+*     file: getStreamFileSink("app.log", {
+*       highWaterMark: 32768  // 32KB buffer for high-volume logging
+*     })
+*   },
+*   loggers: [
+*     { category: ["myapp"], sinks: ["file"] }
+*   ]
+* });
+* ```
+*
+* @param path The path to the file to write logs to. The file will be created
+*             if it doesn't exist, or appended to if it does exist.
+* @param options Configuration options for the stream-based sink.
+* @returns A sink that writes formatted log records to the specified file.
+*          The returned sink implements `Disposable` for proper resource cleanup.
+*
+* @since 1.0.0
+*/
+function getStreamFileSink(path, options = {}) {
+	const highWaterMark = options.highWaterMark ?? 16384;
+	const formatter = options.formatter ?? __logtape_logtape.defaultTextFormatter;
+	const passThrough = new node_stream.PassThrough({
+		highWaterMark,
+		objectMode: false
+	});
+	const writeStream = (0, node_fs.createWriteStream)(path, { flags: "a" });
+	passThrough.pipe(writeStream);
+	let disposed = false;
+	const sink = (record) => {
+		if (disposed) return;
+		passThrough.write(formatter(record));
+	};
+	sink[Symbol.dispose] = () => {
+		if (disposed) return;
+		disposed = true;
+		passThrough.end();
+		writeStream.end();
+	};
+	return sink;
+}
+
+//#endregion
+exports.getStreamFileSink = getStreamFileSink;