@logtape/windows-eventlog 1.0.0-dev.225

package/dist/sink.deno.cjs

@@ -0,0 +1,116 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const require_platform = require('./platform.cjs');
+const require_ffi_deno = require('./ffi.deno.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+
+//#region sink.deno.ts
+/**
+* Formats a log record message into a string suitable for Windows Event Log.
+* Combines the template and arguments into a readable message.
+*/
+function formatMessage(record) {
+	let message = "";
+	for (let i = 0; i < record.message.length; i++) if (i % 2 === 0) message += record.message[i];
+	else {
+		const arg = record.message[i];
+		if (typeof arg === "string") message += arg;
+		else message += JSON.stringify(arg);
+	}
+	return message;
+}
+/**
+* Formats additional context information for the log entry.
+* Includes category, properties, and other metadata.
+*/
+function formatContext(record) {
+	const context = [];
+	if (record.category && record.category.length > 0) context.push(`Category: ${record.category.join(".")}`);
+	if (record.properties && Object.keys(record.properties).length > 0) context.push(`Properties: ${JSON.stringify(record.properties)}`);
+	context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);
+	return context.length > 0 ? `\n\n${context.join("\n")}` : "";
+}
+/**
+* Maps LogTape log levels to Windows Event Log types.
+*/
+function getEventType(level) {
+	switch (level) {
+		case "fatal":
+		case "error": return require_ffi_deno.EVENTLOG_ERROR_TYPE;
+		case "warning": return require_ffi_deno.EVENTLOG_WARNING_TYPE;
+		case "info":
+		case "debug":
+		case "trace":
+		default: return require_ffi_deno.EVENTLOG_INFORMATION_TYPE;
+	}
+}
+/**
+* Creates a Windows Event Log sink for Deno environments using FFI.
+*
+* This implementation uses Deno's Foreign Function Interface to directly
+* call Windows Event Log APIs, providing reliable Event Log integration
+* without depending on external packages.
+*
+* @param options Configuration options for the sink
+* @returns A LogTape sink that writes to Windows Event Log
+* @throws {WindowsPlatformError} If not running on Windows
+* @throws {WindowsEventLogError} If Event Log operations fail
+*
+* @example
+* ```typescript
+* import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+*
+* const sink = getWindowsEventLogSink({
+*   sourceName: "MyApp",
+*   logName: "Application"
+* });
+* ```
+*
+* @since 1.0.0
+*/
+function getWindowsEventLogSink(options) {
+	require_platform.validateWindowsPlatform();
+	const { sourceName, logName: _logName = "Application", eventIdMapping = {} } = options;
+	const eventIds = {
+		...require_types.DEFAULT_EVENT_ID_MAPPING,
+		...eventIdMapping
+	};
+	let ffi = null;
+	const metaLogger = (0, __logtape_logtape.getLogger)([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	const sink = (record) => {
+		if (!ffi) try {
+			ffi = new require_ffi_deno.WindowsEventLogFFI(sourceName);
+			ffi.initialize();
+		} catch (error) {
+			metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+			return;
+		}
+		const message = formatMessage(record);
+		const context = formatContext(record);
+		const fullMessage = message + context;
+		const eventType = getEventType(record.level);
+		const eventId = eventIds[record.level];
+		try {
+			ffi.writeEvent(eventType, eventId, fullMessage);
+		} catch (error) {
+			metaLogger.error("Failed to write {level} message to Windows Event Log: {error}", {
+				level: record.level,
+				error
+			});
+		}
+	};
+	sink[Symbol.dispose] = () => {
+		if (ffi) {
+			ffi.dispose();
+			ffi = null;
+		}
+	};
+	return sink;
+}
+
+//#endregion
+exports.getWindowsEventLogSink = getWindowsEventLogSink;

package/dist/sink.deno.d.cts

@@ -0,0 +1,34 @@
+import { WindowsEventLogSinkOptions } from "./types.cjs";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.deno.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Deno environments using FFI.
+ *
+ * This implementation uses Deno's Foreign Function Interface to directly
+ * call Windows Event Log APIs, providing reliable Event Log integration
+ * without depending on external packages.
+ *
+ * @param options Configuration options for the sink
+ * @returns A LogTape sink that writes to Windows Event Log
+ * @throws {WindowsPlatformError} If not running on Windows
+ * @throws {WindowsEventLogError} If Event Log operations fail
+ *
+ * @example
+ * ```typescript
+ * import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+ *
+ * const sink = getWindowsEventLogSink({
+ *   sourceName: "MyApp",
+ *   logName: "Application"
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare function getWindowsEventLogSink(options: WindowsEventLogSinkOptions): Sink & Disposable;
+//# sourceMappingURL=sink.deno.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.deno.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sink.deno.d.cts","names":[],"sources":["../sink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuGA;;;;;AAEoB;;;;;;;;;;;;;;;;;iBAFJ,sBAAA,UACL,6BACR,OAAO"}

package/dist/sink.deno.d.ts

@@ -0,0 +1,34 @@
+import { WindowsEventLogSinkOptions } from "./types.js";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.deno.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Deno environments using FFI.
+ *
+ * This implementation uses Deno's Foreign Function Interface to directly
+ * call Windows Event Log APIs, providing reliable Event Log integration
+ * without depending on external packages.
+ *
+ * @param options Configuration options for the sink
+ * @returns A LogTape sink that writes to Windows Event Log
+ * @throws {WindowsPlatformError} If not running on Windows
+ * @throws {WindowsEventLogError} If Event Log operations fail
+ *
+ * @example
+ * ```typescript
+ * import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+ *
+ * const sink = getWindowsEventLogSink({
+ *   sourceName: "MyApp",
+ *   logName: "Application"
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare function getWindowsEventLogSink(options: WindowsEventLogSinkOptions): Sink & Disposable;
+//# sourceMappingURL=sink.deno.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.deno.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sink.deno.d.ts","names":[],"sources":["../sink.deno.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuGA;;;;;AAEoB;;;;;;;;;;;;;;;;;iBAFJ,sBAAA,UACL,6BACR,OAAO"}

package/dist/sink.deno.js

@@ -0,0 +1,116 @@
+import { DEFAULT_EVENT_ID_MAPPING } from "./types.js";
+import { validateWindowsPlatform } from "./platform.js";
+import { EVENTLOG_ERROR_TYPE, EVENTLOG_INFORMATION_TYPE, EVENTLOG_WARNING_TYPE, WindowsEventLogFFI } from "./ffi.deno.js";
+import { getLogger } from "@logtape/logtape";
+
+//#region sink.deno.ts
+/**
+* Formats a log record message into a string suitable for Windows Event Log.
+* Combines the template and arguments into a readable message.
+*/
+function formatMessage(record) {
+	let message = "";
+	for (let i = 0; i < record.message.length; i++) if (i % 2 === 0) message += record.message[i];
+	else {
+		const arg = record.message[i];
+		if (typeof arg === "string") message += arg;
+		else message += JSON.stringify(arg);
+	}
+	return message;
+}
+/**
+* Formats additional context information for the log entry.
+* Includes category, properties, and other metadata.
+*/
+function formatContext(record) {
+	const context = [];
+	if (record.category && record.category.length > 0) context.push(`Category: ${record.category.join(".")}`);
+	if (record.properties && Object.keys(record.properties).length > 0) context.push(`Properties: ${JSON.stringify(record.properties)}`);
+	context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);
+	return context.length > 0 ? `\n\n${context.join("\n")}` : "";
+}
+/**
+* Maps LogTape log levels to Windows Event Log types.
+*/
+function getEventType(level) {
+	switch (level) {
+		case "fatal":
+		case "error": return EVENTLOG_ERROR_TYPE;
+		case "warning": return EVENTLOG_WARNING_TYPE;
+		case "info":
+		case "debug":
+		case "trace":
+		default: return EVENTLOG_INFORMATION_TYPE;
+	}
+}
+/**
+* Creates a Windows Event Log sink for Deno environments using FFI.
+*
+* This implementation uses Deno's Foreign Function Interface to directly
+* call Windows Event Log APIs, providing reliable Event Log integration
+* without depending on external packages.
+*
+* @param options Configuration options for the sink
+* @returns A LogTape sink that writes to Windows Event Log
+* @throws {WindowsPlatformError} If not running on Windows
+* @throws {WindowsEventLogError} If Event Log operations fail
+*
+* @example
+* ```typescript
+* import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+*
+* const sink = getWindowsEventLogSink({
+*   sourceName: "MyApp",
+*   logName: "Application"
+* });
+* ```
+*
+* @since 1.0.0
+*/
+function getWindowsEventLogSink(options) {
+	validateWindowsPlatform();
+	const { sourceName, logName: _logName = "Application", eventIdMapping = {} } = options;
+	const eventIds = {
+		...DEFAULT_EVENT_ID_MAPPING,
+		...eventIdMapping
+	};
+	let ffi = null;
+	const metaLogger = getLogger([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	const sink = (record) => {
+		if (!ffi) try {
+			ffi = new WindowsEventLogFFI(sourceName);
+			ffi.initialize();
+		} catch (error) {
+			metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+			return;
+		}
+		const message = formatMessage(record);
+		const context = formatContext(record);
+		const fullMessage = message + context;
+		const eventType = getEventType(record.level);
+		const eventId = eventIds[record.level];
+		try {
+			ffi.writeEvent(eventType, eventId, fullMessage);
+		} catch (error) {
+			metaLogger.error("Failed to write {level} message to Windows Event Log: {error}", {
+				level: record.level,
+				error
+			});
+		}
+	};
+	sink[Symbol.dispose] = () => {
+		if (ffi) {
+			ffi.dispose();
+			ffi = null;
+		}
+	};
+	return sink;
+}
+
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.deno.js.map

package/dist/sink.deno.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.deno.js","names":["record: LogRecord","context: string[]","level: string","options: WindowsEventLogSinkOptions","ffi: WindowsEventLogFFI | null","sink: Sink & Disposable"],"sources":["../sink.deno.ts"],"sourcesContent":["import type { LogRecord, Sink } from \"@logtape/logtape\";\nimport { getLogger } from \"@logtape/logtape\";\nimport {\n  EVENTLOG_ERROR_TYPE,\n  EVENTLOG_INFORMATION_TYPE,\n  EVENTLOG_WARNING_TYPE,\n  WindowsEventLogFFI,\n} from \"./ffi.deno.ts\";\nimport { validateWindowsPlatform } from \"./platform.ts\";\nimport type { WindowsEventLogSinkOptions } from \"./types.ts\";\nimport { DEFAULT_EVENT_ID_MAPPING } from \"./types.ts\";\n\n/**\n * Formats a log record message into a string suitable for Windows Event Log.\n * Combines the template and arguments into a readable message.\n */\nfunction formatMessage(record: LogRecord): string {\n  let message = \"\";\n\n  // Combine template parts with arguments\n  for (let i = 0; i < record.message.length; i++) {\n    if (i % 2 === 0) {\n      // Template part\n      message += record.message[i];\n    } else {\n      // Argument - serialize it\n      const arg = record.message[i];\n      if (typeof arg === \"string\") {\n        message += arg;\n      } else {\n        message += JSON.stringify(arg);\n      }\n    }\n  }\n\n  return message;\n}\n\n/**\n * Formats additional context information for the log entry.\n * Includes category, properties, and other metadata.\n */\nfunction formatContext(record: LogRecord): string {\n  const context: string[] = [];\n\n  // Add category if present\n  if (record.category && record.category.length > 0) {\n    context.push(`Category: ${record.category.join(\".\")}`);\n  }\n\n  // Add properties if present\n  if (record.properties && Object.keys(record.properties).length > 0) {\n    context.push(`Properties: ${JSON.stringify(record.properties)}`);\n  }\n\n  // Add timestamp\n  context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);\n\n  return context.length > 0 ? `\\n\\n${context.join(\"\\n\")}` : \"\";\n}\n\n/**\n * Maps LogTape log levels to Windows Event Log types.\n */\nfunction getEventType(level: string): number {\n  switch (level) {\n    case \"fatal\":\n    case \"error\":\n      return EVENTLOG_ERROR_TYPE;\n    case \"warning\":\n      return EVENTLOG_WARNING_TYPE;\n    case \"info\":\n    case \"debug\":\n    case \"trace\":\n    default:\n      return EVENTLOG_INFORMATION_TYPE;\n  }\n}\n\n/**\n * Creates a Windows Event Log sink for Deno environments using FFI.\n *\n * This implementation uses Deno's Foreign Function Interface to directly\n * call Windows Event Log APIs, providing reliable Event Log integration\n * without depending on external packages.\n *\n * @param options Configuration options for the sink\n * @returns A LogTape sink that writes to Windows Event Log\n * @throws {WindowsPlatformError} If not running on Windows\n * @throws {WindowsEventLogError} If Event Log operations fail\n *\n * @example\n * ```typescript\n * import { getWindowsEventLogSink } from \"@logtape/windows-eventlog\";\n *\n * const sink = getWindowsEventLogSink({\n *   sourceName: \"MyApp\",\n *   logName: \"Application\"\n * });\n * ```\n *\n * @since 1.0.0\n */\nexport function getWindowsEventLogSink(\n  options: WindowsEventLogSinkOptions,\n): Sink & Disposable {\n  // Validate platform early\n  validateWindowsPlatform();\n\n  const {\n    sourceName,\n    logName: _logName = \"Application\",\n    eventIdMapping = {},\n  } = options;\n\n  // Merge with default event ID mapping\n  const eventIds = { ...DEFAULT_EVENT_ID_MAPPING, ...eventIdMapping };\n\n  let ffi: WindowsEventLogFFI | null = null;\n  const metaLogger = getLogger([\"logtape\", \"meta\", \"windows-eventlog\"]);\n\n  const sink: Sink & Disposable = (record: LogRecord) => {\n    // Initialize FFI if needed\n    if (!ffi) {\n      try {\n        ffi = new WindowsEventLogFFI(sourceName);\n        ffi.initialize();\n      } catch (error) {\n        metaLogger.error(\n          \"Failed to initialize Windows Event Log FFI: {error}\",\n          { error },\n        );\n        return; // Skip this log record\n      }\n    }\n\n    // Format the complete message\n    const message = formatMessage(record);\n    const context = formatContext(record);\n    const fullMessage = message + context;\n\n    // Get event type and ID for this log level\n    const eventType = getEventType(record.level);\n    const eventId = eventIds[record.level];\n\n    // Write to Event Log\n    try {\n      ffi.writeEvent(eventType, eventId, fullMessage);\n    } catch (error) {\n      metaLogger.error(\n        \"Failed to write {level} message to Windows Event Log: {error}\",\n        { level: record.level, error },\n      );\n    }\n  };\n\n  // Implement Disposable for cleanup\n  sink[Symbol.dispose] = () => {\n    // Clean up FFI resources\n    if (ffi) {\n      ffi.dispose();\n      ffi = null;\n    }\n  };\n\n  return sink;\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAS,cAAcA,QAA2B;CAChD,IAAI,UAAU;AAGd,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,QAAQ,IACzC,KAAI,IAAI,MAAM,EAEZ,YAAW,OAAO,QAAQ;MACrB;EAEL,MAAM,MAAM,OAAO,QAAQ;AAC3B,aAAW,QAAQ,SACjB,YAAW;MAEX,YAAW,KAAK,UAAU,IAAI;CAEjC;AAGH,QAAO;AACR;;;;;AAMD,SAAS,cAAcA,QAA2B;CAChD,MAAMC,UAAoB,CAAE;AAG5B,KAAI,OAAO,YAAY,OAAO,SAAS,SAAS,EAC9C,SAAQ,MAAM,YAAY,OAAO,SAAS,KAAK,IAAI,CAAC,EAAE;AAIxD,KAAI,OAAO,cAAc,OAAO,KAAK,OAAO,WAAW,CAAC,SAAS,EAC/D,SAAQ,MAAM,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC,EAAE;AAIlE,SAAQ,MAAM,aAAa,IAAI,KAAK,OAAO,WAAW,aAAa,CAAC,EAAE;AAEtE,QAAO,QAAQ,SAAS,KAAK,MAAM,QAAQ,KAAK,KAAK,CAAC,IAAI;AAC3D;;;;AAKD,SAAS,aAAaC,OAAuB;AAC3C,SAAQ,OAAR;EACE,KAAK;EACL,KAAK,QACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,QACE,QAAO;CACV;AACF;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,uBACdC,SACmB;AAEnB,0BAAyB;CAEzB,MAAM,EACJ,YACA,SAAS,WAAW,eACpB,iBAAiB,CAAE,GACpB,GAAG;CAGJ,MAAM,WAAW;EAAE,GAAG;EAA0B,GAAG;CAAgB;CAEnE,IAAIC,MAAiC;CACrC,MAAM,aAAa,UAAU;EAAC;EAAW;EAAQ;CAAmB,EAAC;CAErE,MAAMC,OAA0B,CAACL,WAAsB;AAErD,OAAK,IACH,KAAI;AACF,SAAM,IAAI,mBAAmB;AAC7B,OAAI,YAAY;EACjB,SAAQ,OAAO;AACd,cAAW,MACT,uDACA,EAAE,MAAO,EACV;AACD;EACD;EAIH,MAAM,UAAU,cAAc,OAAO;EACrC,MAAM,UAAU,cAAc,OAAO;EACrC,MAAM,cAAc,UAAU;EAG9B,MAAM,YAAY,aAAa,OAAO,MAAM;EAC5C,MAAM,UAAU,SAAS,OAAO;AAGhC,MAAI;AACF,OAAI,WAAW,WAAW,SAAS,YAAY;EAChD,SAAQ,OAAO;AACd,cAAW,MACT,iEACA;IAAE,OAAO,OAAO;IAAO;GAAO,EAC/B;EACF;CACF;AAGD,MAAK,OAAO,WAAW,MAAM;AAE3B,MAAI,KAAK;AACP,OAAI,SAAS;AACb,SAAM;EACP;CACF;AAED,QAAO;AACR"}

package/dist/sink.node.cjs

@@ -0,0 +1,112 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const require_platform = require('./platform.cjs');
+const require_ffi_node = require('./ffi.node.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+
+//#region sink.node.ts
+/**
+* Formats a log record message into a string suitable for Windows Event Log.
+* Combines the template and arguments into a readable message.
+*/
+function formatMessage(record) {
+	let message = "";
+	for (let i = 0; i < record.message.length; i++) if (i % 2 === 0) message += record.message[i];
+	else {
+		const arg = record.message[i];
+		if (typeof arg === "string") message += arg;
+		else message += JSON.stringify(arg);
+	}
+	return message;
+}
+/**
+* Formats additional context information for the log entry.
+* Includes category, properties, and other metadata.
+*/
+function formatContext(record) {
+	const context = [];
+	if (record.category && record.category.length > 0) context.push(`Category: ${record.category.join(".")}`);
+	if (record.properties && Object.keys(record.properties).length > 0) context.push(`Properties: ${JSON.stringify(record.properties)}`);
+	context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);
+	return context.length > 0 ? `\n\n${context.join("\n")}` : "";
+}
+/**
+* Creates a Windows Event Log sink for Node.js environments using FFI.
+*
+* This implementation uses koffi to call Windows Event Log API directly,
+* providing high performance logging without external dependencies.
+*
+* @param options Configuration options for the sink
+* @returns A LogTape sink that writes to Windows Event Log
+* @throws {WindowsPlatformError} If not running on Windows
+* @throws {WindowsEventLogError} If Event Log operations fail
+*
+* @example
+* ```typescript
+* import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+*
+* const sink = getWindowsEventLogSink({
+*   sourceName: "MyApp",
+*   logName: "Application"
+* });
+* ```
+*
+* @since 1.0.0
+*/
+function getWindowsEventLogSink(options) {
+	require_platform.validateWindowsPlatform();
+	const { sourceName, logName: _logName = "Application", eventIdMapping = {} } = options;
+	const eventIds = {
+		...require_types.DEFAULT_EVENT_ID_MAPPING,
+		...eventIdMapping
+	};
+	let ffi = null;
+	let initPromise = null;
+	const metaLogger = (0, __logtape_logtape.getLogger)([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	const sink = (record) => {
+		const message = formatMessage(record);
+		const context = formatContext(record);
+		const fullMessage = message + context;
+		const eventType = require_types.mapLogLevelToEventType(record.level);
+		const eventId = eventIds[record.level];
+		if (!ffi) {
+			ffi = new require_ffi_node.WindowsEventLogFFI(sourceName);
+			initPromise = ffi.initialize().then(() => {
+				if (ffi) try {
+					ffi.writeEvent(eventType, eventId, fullMessage);
+				} catch (error) {
+					metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+				}
+			}).catch((error) => {
+				metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+				ffi = null;
+				initPromise = null;
+			});
+		} else if (initPromise) initPromise = initPromise.then(() => {
+			if (ffi) try {
+				ffi.writeEvent(eventType, eventId, fullMessage);
+			} catch (error) {
+				metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+			}
+		});
+		else try {
+			ffi.writeEvent(eventType, eventId, fullMessage);
+		} catch (error) {
+			metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+		}
+	};
+	sink[Symbol.dispose] = () => {
+		if (ffi) {
+			ffi.dispose();
+			ffi = null;
+		}
+	};
+	return sink;
+}
+
+//#endregion
+exports.getWindowsEventLogSink = getWindowsEventLogSink;

package/dist/sink.node.d.cts

@@ -0,0 +1,33 @@
+import { WindowsEventLogSinkOptions } from "./types.cjs";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.node.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Node.js environments using FFI.
+ *
+ * This implementation uses koffi to call Windows Event Log API directly,
+ * providing high performance logging without external dependencies.
+ *
+ * @param options Configuration options for the sink
+ * @returns A LogTape sink that writes to Windows Event Log
+ * @throws {WindowsPlatformError} If not running on Windows
+ * @throws {WindowsEventLogError} If Event Log operations fail
+ *
+ * @example
+ * ```typescript
+ * import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+ *
+ * const sink = getWindowsEventLogSink({
+ *   sourceName: "MyApp",
+ *   logName: "Application"
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare function getWindowsEventLogSink(options: WindowsEventLogSinkOptions): Sink & Disposable;
+//# sourceMappingURL=sink.node.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.node.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sink.node.d.cts","names":[],"sources":["../sink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmFA;;;;;AAEoB;;;;;;;;;;;;;;;;iBAFJ,sBAAA,UACL,6BACR,OAAO"}

package/dist/sink.node.d.ts

@@ -0,0 +1,33 @@
+import { WindowsEventLogSinkOptions } from "./types.js";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.node.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Node.js environments using FFI.
+ *
+ * This implementation uses koffi to call Windows Event Log API directly,
+ * providing high performance logging without external dependencies.
+ *
+ * @param options Configuration options for the sink
+ * @returns A LogTape sink that writes to Windows Event Log
+ * @throws {WindowsPlatformError} If not running on Windows
+ * @throws {WindowsEventLogError} If Event Log operations fail
+ *
+ * @example
+ * ```typescript
+ * import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+ *
+ * const sink = getWindowsEventLogSink({
+ *   sourceName: "MyApp",
+ *   logName: "Application"
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare function getWindowsEventLogSink(options: WindowsEventLogSinkOptions): Sink & Disposable;
+//# sourceMappingURL=sink.node.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sink.node.d.ts","names":[],"sources":["../sink.node.ts"],"sourcesContent":[],"mappings":";;;;;;;AAmFA;;;;;AAEoB;;;;;;;;;;;;;;;;iBAFJ,sBAAA,UACL,6BACR,OAAO"}

package/dist/sink.node.js

@@ -0,0 +1,112 @@
+import { DEFAULT_EVENT_ID_MAPPING, mapLogLevelToEventType } from "./types.js";
+import { validateWindowsPlatform } from "./platform.js";
+import { WindowsEventLogFFI } from "./ffi.node.js";
+import { getLogger } from "@logtape/logtape";
+
+//#region sink.node.ts
+/**
+* Formats a log record message into a string suitable for Windows Event Log.
+* Combines the template and arguments into a readable message.
+*/
+function formatMessage(record) {
+	let message = "";
+	for (let i = 0; i < record.message.length; i++) if (i % 2 === 0) message += record.message[i];
+	else {
+		const arg = record.message[i];
+		if (typeof arg === "string") message += arg;
+		else message += JSON.stringify(arg);
+	}
+	return message;
+}
+/**
+* Formats additional context information for the log entry.
+* Includes category, properties, and other metadata.
+*/
+function formatContext(record) {
+	const context = [];
+	if (record.category && record.category.length > 0) context.push(`Category: ${record.category.join(".")}`);
+	if (record.properties && Object.keys(record.properties).length > 0) context.push(`Properties: ${JSON.stringify(record.properties)}`);
+	context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);
+	return context.length > 0 ? `\n\n${context.join("\n")}` : "";
+}
+/**
+* Creates a Windows Event Log sink for Node.js environments using FFI.
+*
+* This implementation uses koffi to call Windows Event Log API directly,
+* providing high performance logging without external dependencies.
+*
+* @param options Configuration options for the sink
+* @returns A LogTape sink that writes to Windows Event Log
+* @throws {WindowsPlatformError} If not running on Windows
+* @throws {WindowsEventLogError} If Event Log operations fail
+*
+* @example
+* ```typescript
+* import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+*
+* const sink = getWindowsEventLogSink({
+*   sourceName: "MyApp",
+*   logName: "Application"
+* });
+* ```
+*
+* @since 1.0.0
+*/
+function getWindowsEventLogSink(options) {
+	validateWindowsPlatform();
+	const { sourceName, logName: _logName = "Application", eventIdMapping = {} } = options;
+	const eventIds = {
+		...DEFAULT_EVENT_ID_MAPPING,
+		...eventIdMapping
+	};
+	let ffi = null;
+	let initPromise = null;
+	const metaLogger = getLogger([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	const sink = (record) => {
+		const message = formatMessage(record);
+		const context = formatContext(record);
+		const fullMessage = message + context;
+		const eventType = mapLogLevelToEventType(record.level);
+		const eventId = eventIds[record.level];
+		if (!ffi) {
+			ffi = new WindowsEventLogFFI(sourceName);
+			initPromise = ffi.initialize().then(() => {
+				if (ffi) try {
+					ffi.writeEvent(eventType, eventId, fullMessage);
+				} catch (error) {
+					metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+				}
+			}).catch((error) => {
+				metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+				ffi = null;
+				initPromise = null;
+			});
+		} else if (initPromise) initPromise = initPromise.then(() => {
+			if (ffi) try {
+				ffi.writeEvent(eventType, eventId, fullMessage);
+			} catch (error) {
+				metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+			}
+		});
+		else try {
+			ffi.writeEvent(eventType, eventId, fullMessage);
+		} catch (error) {
+			metaLogger.error("Failed to write to Windows Event Log: {error}", { error });
+		}
+	};
+	sink[Symbol.dispose] = () => {
+		if (ffi) {
+			ffi.dispose();
+			ffi = null;
+		}
+	};
+	return sink;
+}
+
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.node.js.map

package/dist/sink.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.node.js","names":["record: LogRecord","context: string[]","options: WindowsEventLogSinkOptions","ffi: WindowsEventLogFFI | null","initPromise: Promise<void> | null","sink: Sink & Disposable"],"sources":["../sink.node.ts"],"sourcesContent":["import type { LogRecord, Sink } from \"@logtape/logtape\";\nimport { getLogger } from \"@logtape/logtape\";\nimport type { WindowsEventLogSinkOptions } from \"./types.ts\";\nimport {\n  DEFAULT_EVENT_ID_MAPPING,\n  mapLogLevelToEventType,\n  type WindowsEventLogError as _WindowsEventLogError,\n} from \"./types.ts\";\nimport { validateWindowsPlatform } from \"./platform.ts\";\nimport { WindowsEventLogFFI } from \"./ffi.node.ts\";\n\n/**\n * Formats a log record message into a string suitable for Windows Event Log.\n * Combines the template and arguments into a readable message.\n */\nfunction formatMessage(record: LogRecord): string {\n  let message = \"\";\n\n  // Combine template parts with arguments\n  for (let i = 0; i < record.message.length; i++) {\n    if (i % 2 === 0) {\n      // Template part\n      message += record.message[i];\n    } else {\n      // Argument - serialize it\n      const arg = record.message[i];\n      if (typeof arg === \"string\") {\n        message += arg;\n      } else {\n        message += JSON.stringify(arg);\n      }\n    }\n  }\n\n  return message;\n}\n\n/**\n * Formats additional context information for the log entry.\n * Includes category, properties, and other metadata.\n */\nfunction formatContext(record: LogRecord): string {\n  const context: string[] = [];\n\n  // Add category if present\n  if (record.category && record.category.length > 0) {\n    context.push(`Category: ${record.category.join(\".\")}`);\n  }\n\n  // Add properties if present\n  if (record.properties && Object.keys(record.properties).length > 0) {\n    context.push(`Properties: ${JSON.stringify(record.properties)}`);\n  }\n\n  // Add timestamp\n  context.push(`Timestamp: ${new Date(record.timestamp).toISOString()}`);\n\n  return context.length > 0 ? `\\n\\n${context.join(\"\\n\")}` : \"\";\n}\n\n/**\n * Creates a Windows Event Log sink for Node.js environments using FFI.\n *\n * This implementation uses koffi to call Windows Event Log API directly,\n * providing high performance logging without external dependencies.\n *\n * @param options Configuration options for the sink\n * @returns A LogTape sink that writes to Windows Event Log\n * @throws {WindowsPlatformError} If not running on Windows\n * @throws {WindowsEventLogError} If Event Log operations fail\n *\n * @example\n * ```typescript\n * import { getWindowsEventLogSink } from \"@logtape/windows-eventlog\";\n *\n * const sink = getWindowsEventLogSink({\n *   sourceName: \"MyApp\",\n *   logName: \"Application\"\n * });\n * ```\n *\n * @since 1.0.0\n */\nexport function getWindowsEventLogSink(\n  options: WindowsEventLogSinkOptions,\n): Sink & Disposable {\n  // Validate platform early\n  validateWindowsPlatform();\n\n  const {\n    sourceName,\n    logName: _logName = \"Application\",\n    eventIdMapping = {},\n  } = options;\n\n  // Merge with default event ID mapping\n  const eventIds = { ...DEFAULT_EVENT_ID_MAPPING, ...eventIdMapping };\n\n  let ffi: WindowsEventLogFFI | null = null;\n  let initPromise: Promise<void> | null = null;\n  const metaLogger = getLogger([\"logtape\", \"meta\", \"windows-eventlog\"]);\n\n  const sink: Sink & Disposable = (record: LogRecord) => {\n    // Format the complete message\n    const message = formatMessage(record);\n    const context = formatContext(record);\n    const fullMessage = message + context;\n\n    // Get event type and ID for this log level\n    const eventType = mapLogLevelToEventType(record.level);\n    const eventId = eventIds[record.level];\n\n    // Initialize FFI on first use\n    if (!ffi) {\n      ffi = new WindowsEventLogFFI(sourceName);\n      initPromise = ffi.initialize()\n        .then(() => {\n          // Write the first event after initialization\n          if (ffi) {\n            try {\n              ffi.writeEvent(eventType, eventId, fullMessage);\n            } catch (error) {\n              metaLogger.error(\n                \"Failed to write to Windows Event Log: {error}\",\n                { error },\n              );\n            }\n          }\n        })\n        .catch((error) => {\n          metaLogger.error(\n            \"Failed to initialize Windows Event Log FFI: {error}\",\n            { error },\n          );\n          ffi = null; // Reset FFI on error\n          initPromise = null;\n        });\n    } else if (initPromise) {\n      // Still initializing - queue the write operation\n      initPromise = initPromise.then(() => {\n        if (ffi) {\n          try {\n            ffi.writeEvent(eventType, eventId, fullMessage);\n          } catch (error) {\n            metaLogger.error(\n              \"Failed to write to Windows Event Log: {error}\",\n              { error },\n            );\n          }\n        }\n      });\n    } else {\n      // Already initialized\n      try {\n        ffi.writeEvent(eventType, eventId, fullMessage);\n      } catch (error) {\n        metaLogger.error(\n          \"Failed to write to Windows Event Log: {error}\",\n          { error },\n        );\n      }\n    }\n  };\n\n  // Implement Disposable for cleanup\n  sink[Symbol.dispose] = () => {\n    if (ffi) {\n      ffi.dispose();\n      ffi = null;\n    }\n  };\n\n  return sink;\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAS,cAAcA,QAA2B;CAChD,IAAI,UAAU;AAGd,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,QAAQ,IACzC,KAAI,IAAI,MAAM,EAEZ,YAAW,OAAO,QAAQ;MACrB;EAEL,MAAM,MAAM,OAAO,QAAQ;AAC3B,aAAW,QAAQ,SACjB,YAAW;MAEX,YAAW,KAAK,UAAU,IAAI;CAEjC;AAGH,QAAO;AACR;;;;;AAMD,SAAS,cAAcA,QAA2B;CAChD,MAAMC,UAAoB,CAAE;AAG5B,KAAI,OAAO,YAAY,OAAO,SAAS,SAAS,EAC9C,SAAQ,MAAM,YAAY,OAAO,SAAS,KAAK,IAAI,CAAC,EAAE;AAIxD,KAAI,OAAO,cAAc,OAAO,KAAK,OAAO,WAAW,CAAC,SAAS,EAC/D,SAAQ,MAAM,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC,EAAE;AAIlE,SAAQ,MAAM,aAAa,IAAI,KAAK,OAAO,WAAW,aAAa,CAAC,EAAE;AAEtE,QAAO,QAAQ,SAAS,KAAK,MAAM,QAAQ,KAAK,KAAK,CAAC,IAAI;AAC3D;;;;;;;;;;;;;;;;;;;;;;;;AAyBD,SAAgB,uBACdC,SACmB;AAEnB,0BAAyB;CAEzB,MAAM,EACJ,YACA,SAAS,WAAW,eACpB,iBAAiB,CAAE,GACpB,GAAG;CAGJ,MAAM,WAAW;EAAE,GAAG;EAA0B,GAAG;CAAgB;CAEnE,IAAIC,MAAiC;CACrC,IAAIC,cAAoC;CACxC,MAAM,aAAa,UAAU;EAAC;EAAW;EAAQ;CAAmB,EAAC;CAErE,MAAMC,OAA0B,CAACL,WAAsB;EAErD,MAAM,UAAU,cAAc,OAAO;EACrC,MAAM,UAAU,cAAc,OAAO;EACrC,MAAM,cAAc,UAAU;EAG9B,MAAM,YAAY,uBAAuB,OAAO,MAAM;EACtD,MAAM,UAAU,SAAS,OAAO;AAGhC,OAAK,KAAK;AACR,SAAM,IAAI,mBAAmB;AAC7B,iBAAc,IAAI,YAAY,CAC3B,KAAK,MAAM;AAEV,QAAI,IACF,KAAI;AACF,SAAI,WAAW,WAAW,SAAS,YAAY;IAChD,SAAQ,OAAO;AACd,gBAAW,MACT,iDACA,EAAE,MAAO,EACV;IACF;GAEJ,EAAC,CACD,MAAM,CAAC,UAAU;AAChB,eAAW,MACT,uDACA,EAAE,MAAO,EACV;AACD,UAAM;AACN,kBAAc;GACf,EAAC;EACL,WAAU,YAET,eAAc,YAAY,KAAK,MAAM;AACnC,OAAI,IACF,KAAI;AACF,QAAI,WAAW,WAAW,SAAS,YAAY;GAChD,SAAQ,OAAO;AACd,eAAW,MACT,iDACA,EAAE,MAAO,EACV;GACF;EAEJ,EAAC;MAGF,KAAI;AACF,OAAI,WAAW,WAAW,SAAS,YAAY;EAChD,SAAQ,OAAO;AACd,cAAW,MACT,iDACA,EAAE,MAAO,EACV;EACF;CAEJ;AAGD,MAAK,OAAO,WAAW,MAAM;AAC3B,MAAI,KAAK;AACP,OAAI,SAAS;AACb,SAAM;EACP;CACF;AAED,QAAO;AACR"}