@logtape/windows-eventlog 1.0.0-dev.225

package/dist/ffi.node.cjs

@@ -0,0 +1,78 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+
+//#region ffi.node.ts
+/**
+* Node.js FFI implementation for Windows Event Log API using koffi
+*/
+var WindowsEventLogFFI = class {
+	eventSource = null;
+	koffi = null;
+	sourceName;
+	initialized = false;
+	lib = null;
+	metaLogger = (0, __logtape_logtape.getLogger)([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initialize the FFI bindings and register event source
+	*/
+	async initialize() {
+		if (this.initialized) return;
+		try {
+			const koffiModule = await import("koffi");
+			this.koffi = koffiModule.default || koffiModule;
+			this.lib = this.koffi.load("advapi32.dll");
+			const RegisterEventSourceA = this.lib.func("uintptr __stdcall RegisterEventSourceA(uintptr lpUNCServerName, str lpSourceName)");
+			const ReportEventA = this.lib.func("bool __stdcall ReportEventA(uintptr hEventLog, uint16 wType, uint16 wCategory, uint32 dwEventID, uintptr lpUserSid, uint16 wNumStrings, uint32 dwDataSize, char** lpStrings, uint8* lpRawData)");
+			const DeregisterEventSource = this.lib.func("bool __stdcall DeregisterEventSource(uintptr hEventLog)");
+			this.RegisterEventSourceA = RegisterEventSourceA;
+			this.ReportEventA = ReportEventA;
+			this.DeregisterEventSource = DeregisterEventSource;
+			this.eventSource = this.RegisterEventSourceA(0, this.sourceName);
+			if (!this.eventSource || this.eventSource === 0) throw new Error(`Failed to register event source: ${this.sourceName}`);
+			this.initialized = true;
+		} catch (error) {
+			throw new Error(`Failed to initialize Windows Event Log FFI: ${error}`);
+		}
+	}
+	RegisterEventSourceA = null;
+	ReportEventA = null;
+	DeregisterEventSource = null;
+	/**
+	* Write an event to Windows Event Log
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.initialized || !this.eventSource || !this.ReportEventA) return;
+		try {
+			const messageWithNull = message + "\0";
+			const messages = [messageWithNull];
+			const success = this.ReportEventA(this.eventSource, eventType, 0, eventId, 0, 1, 0, messages, null);
+			if (!success) throw new Error("ReportEventA() returned false.");
+		} catch (error) {
+			throw error;
+		}
+	}
+	/**
+	* Clean up resources
+	*/
+	dispose() {
+		if (this.initialized && this.eventSource && this.DeregisterEventSource) {
+			try {
+				this.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+			this.initialized = false;
+		}
+	}
+};
+
+//#endregion
+exports.WindowsEventLogFFI = WindowsEventLogFFI;

package/dist/ffi.node.js

@@ -0,0 +1,78 @@
+import { getLogger } from "@logtape/logtape";
+
+//#region ffi.node.ts
+/**
+* Node.js FFI implementation for Windows Event Log API using koffi
+*/
+var WindowsEventLogFFI = class {
+	eventSource = null;
+	koffi = null;
+	sourceName;
+	initialized = false;
+	lib = null;
+	metaLogger = getLogger([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initialize the FFI bindings and register event source
+	*/
+	async initialize() {
+		if (this.initialized) return;
+		try {
+			const koffiModule = await import("koffi");
+			this.koffi = koffiModule.default || koffiModule;
+			this.lib = this.koffi.load("advapi32.dll");
+			const RegisterEventSourceA = this.lib.func("uintptr __stdcall RegisterEventSourceA(uintptr lpUNCServerName, str lpSourceName)");
+			const ReportEventA = this.lib.func("bool __stdcall ReportEventA(uintptr hEventLog, uint16 wType, uint16 wCategory, uint32 dwEventID, uintptr lpUserSid, uint16 wNumStrings, uint32 dwDataSize, char** lpStrings, uint8* lpRawData)");
+			const DeregisterEventSource = this.lib.func("bool __stdcall DeregisterEventSource(uintptr hEventLog)");
+			this.RegisterEventSourceA = RegisterEventSourceA;
+			this.ReportEventA = ReportEventA;
+			this.DeregisterEventSource = DeregisterEventSource;
+			this.eventSource = this.RegisterEventSourceA(0, this.sourceName);
+			if (!this.eventSource || this.eventSource === 0) throw new Error(`Failed to register event source: ${this.sourceName}`);
+			this.initialized = true;
+		} catch (error) {
+			throw new Error(`Failed to initialize Windows Event Log FFI: ${error}`);
+		}
+	}
+	RegisterEventSourceA = null;
+	ReportEventA = null;
+	DeregisterEventSource = null;
+	/**
+	* Write an event to Windows Event Log
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.initialized || !this.eventSource || !this.ReportEventA) return;
+		try {
+			const messageWithNull = message + "\0";
+			const messages = [messageWithNull];
+			const success = this.ReportEventA(this.eventSource, eventType, 0, eventId, 0, 1, 0, messages, null);
+			if (!success) throw new Error("ReportEventA() returned false.");
+		} catch (error) {
+			throw error;
+		}
+	}
+	/**
+	* Clean up resources
+	*/
+	dispose() {
+		if (this.initialized && this.eventSource && this.DeregisterEventSource) {
+			try {
+				this.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+			this.initialized = false;
+		}
+	}
+};
+
+//#endregion
+export { WindowsEventLogFFI };
+//# sourceMappingURL=ffi.node.js.map

package/dist/ffi.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi.node.js","names":["sourceName: string","eventType: EventType","eventId: number","message: string"],"sources":["../ffi.node.ts"],"sourcesContent":["import { getLogger } from \"@logtape/logtape\";\nimport type { EventType } from \"./types.ts\";\n\n/**\n * Node.js FFI implementation for Windows Event Log API using koffi\n */\nexport class WindowsEventLogFFI {\n  private eventSource: unknown = null;\n  private koffi: unknown = null;\n  private sourceName: string;\n  private initialized = false;\n  private lib: unknown = null;\n  private metaLogger = getLogger([\"logtape\", \"meta\", \"windows-eventlog\"]);\n\n  constructor(sourceName: string) {\n    this.sourceName = sourceName;\n  }\n\n  /**\n   * Initialize the FFI bindings and register event source\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    try {\n      // Dynamic import for koffi\n      const koffiModule = await import(\"koffi\");\n      this.koffi = koffiModule.default || koffiModule;\n\n      // Load advapi32.dll\n      this.lib = (this.koffi as unknown as { load: (lib: string) => unknown })\n        .load(\"advapi32.dll\");\n\n      // Define Windows API functions with correct koffi types using __stdcall convention\n      const RegisterEventSourceA =\n        (this.lib as unknown as { func: (sig: string) => unknown }).func(\n          \"uintptr __stdcall RegisterEventSourceA(uintptr lpUNCServerName, str lpSourceName)\",\n        );\n      // ReportEventA expects LPCSTR* (array of string pointers) for lpStrings\n      // Use char** for null-terminated array of strings\n      const ReportEventA =\n        (this.lib as unknown as { func: (sig: string) => unknown }).func(\n          \"bool __stdcall ReportEventA(uintptr hEventLog, uint16 wType, uint16 wCategory, uint32 dwEventID, uintptr lpUserSid, uint16 wNumStrings, uint32 dwDataSize, char** lpStrings, uint8* lpRawData)\",\n        );\n      const DeregisterEventSource =\n        (this.lib as unknown as { func: (sig: string) => unknown }).func(\n          \"bool __stdcall DeregisterEventSource(uintptr hEventLog)\",\n        );\n\n      // Store functions\n      this.RegisterEventSourceA = RegisterEventSourceA;\n      this.ReportEventA = ReportEventA;\n      this.DeregisterEventSource = DeregisterEventSource;\n\n      // Register event source\n      this.eventSource = (this.RegisterEventSourceA as unknown as (\n        ...args: unknown[]\n      ) => unknown)(0, this.sourceName);\n\n      if (!this.eventSource || this.eventSource === 0) {\n        throw new Error(\n          `Failed to register event source: ${this.sourceName}`,\n        );\n      }\n\n      this.initialized = true;\n    } catch (error) {\n      throw new Error(\n        `Failed to initialize Windows Event Log FFI: ${error}`,\n      );\n    }\n  }\n\n  private RegisterEventSourceA: unknown = null;\n  private ReportEventA: unknown = null;\n  private DeregisterEventSource: unknown = null;\n\n  /**\n   * Write an event to Windows Event Log\n   */\n  writeEvent(eventType: EventType, eventId: number, message: string): void {\n    if (!this.initialized || !this.eventSource || !this.ReportEventA) {\n      return;\n    }\n\n    try {\n      // Create null-terminated string\n      const messageWithNull = message + \"\\0\";\n\n      // Create an array with a single string pointer\n      // In koffi, we pass an array of strings for char**\n      const messages = [messageWithNull];\n\n      // Report the event using strings array approach\n      const success =\n        (this.ReportEventA as unknown as (...args: unknown[]) => unknown)(\n          this.eventSource,\n          eventType,\n          0, // category\n          eventId,\n          0, // user SID (null)\n          1, // number of strings (1 - we have one message)\n          0, // data size (0 - not using raw data)\n          messages, // strings array with our message\n          null, // raw data (null - not using)\n        );\n\n      if (!success) {\n        throw new Error(\"ReportEventA() returned false.\");\n      }\n    } catch (error) {\n      throw error;\n    }\n  }\n\n  /**\n   * Clean up resources\n   */\n  dispose(): void {\n    if (this.initialized && this.eventSource && this.DeregisterEventSource) {\n      try {\n        (this.DeregisterEventSource as unknown as (\n          ...args: unknown[]\n        ) => unknown)(this.eventSource);\n      } catch (error) {\n        this.metaLogger.error(\n          \"Failed to deregister event source during cleanup: {error}\",\n          { error },\n        );\n      }\n      this.eventSource = null;\n      this.initialized = false;\n    }\n  }\n}\n"],"mappings":";;;;;;AAMA,IAAa,qBAAb,MAAgC;CAC9B,AAAQ,cAAuB;CAC/B,AAAQ,QAAiB;CACzB,AAAQ;CACR,AAAQ,cAAc;CACtB,AAAQ,MAAe;CACvB,AAAQ,aAAa,UAAU;EAAC;EAAW;EAAQ;CAAmB,EAAC;CAEvE,YAAYA,YAAoB;AAC9B,OAAK,aAAa;CACnB;;;;CAKD,MAAM,aAA4B;AAChC,MAAI,KAAK,YAAa;AAEtB,MAAI;GAEF,MAAM,cAAc,MAAM,OAAO;AACjC,QAAK,QAAQ,YAAY,WAAW;AAGpC,QAAK,MAAM,AAAC,KAAK,MACd,KAAK,eAAe;GAGvB,MAAM,uBACJ,AAAC,KAAK,IAAsD,KAC1D,oFACD;GAGH,MAAM,eACJ,AAAC,KAAK,IAAsD,KAC1D,iMACD;GACH,MAAM,wBACJ,AAAC,KAAK,IAAsD,KAC1D,0DACD;AAGH,QAAK,uBAAuB;AAC5B,QAAK,eAAe;AACpB,QAAK,wBAAwB;AAG7B,QAAK,cAAc,AAAC,KAAK,qBAEX,GAAG,KAAK,WAAW;AAEjC,QAAK,KAAK,eAAe,KAAK,gBAAgB,EAC5C,OAAM,IAAI,OACP,mCAAmC,KAAK,WAAW;AAIxD,QAAK,cAAc;EACpB,SAAQ,OAAO;AACd,SAAM,IAAI,OACP,8CAA8C,MAAM;EAExD;CACF;CAED,AAAQ,uBAAgC;CACxC,AAAQ,eAAwB;CAChC,AAAQ,wBAAiC;;;;CAKzC,WAAWC,WAAsBC,SAAiBC,SAAuB;AACvE,OAAK,KAAK,gBAAgB,KAAK,gBAAgB,KAAK,aAClD;AAGF,MAAI;GAEF,MAAM,kBAAkB,UAAU;GAIlC,MAAM,WAAW,CAAC,eAAgB;GAGlC,MAAM,UACJ,AAAC,KAAK,aACJ,KAAK,aACL,WACA,GACA,SACA,GACA,GACA,GACA,UACA,KACD;AAEH,QAAK,QACH,OAAM,IAAI,MAAM;EAEnB,SAAQ,OAAO;AACd,SAAM;EACP;CACF;;;;CAKD,UAAgB;AACd,MAAI,KAAK,eAAe,KAAK,eAAe,KAAK,uBAAuB;AACtE,OAAI;AACF,IAAC,KAAK,sBAEQ,KAAK,YAAY;GAChC,SAAQ,OAAO;AACd,SAAK,WAAW,MACd,6DACA,EAAE,MAAO,EACV;GACF;AACD,QAAK,cAAc;AACnB,QAAK,cAAc;EACpB;CACF;AACF"}

package/dist/mod.cjs

@@ -0,0 +1,12 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const __wineventlog = require_rolldown_runtime.__toESM(require("#wineventlog"));
+
+exports.WindowsEventLogError = require_types.WindowsEventLogError;
+exports.WindowsPlatformError = require_types.WindowsPlatformError;
+Object.defineProperty(exports, 'getWindowsEventLogSink', {
+  enumerable: true,
+  get: function () {
+    return __wineventlog.getWindowsEventLogSink;
+  }
+});

package/dist/mod.d.cts

@@ -0,0 +1,3 @@
+import { WindowsEventLogError, WindowsEventLogSinkOptions, WindowsLogName, WindowsPlatformError } from "./types.cjs";
+import { getWindowsEventLogSink } from "#wineventlog";
+export { WindowsEventLogError, WindowsEventLogSinkOptions, WindowsLogName, WindowsPlatformError, getWindowsEventLogSink };

package/dist/mod.d.ts

@@ -0,0 +1,3 @@
+import { WindowsEventLogError, WindowsEventLogSinkOptions, WindowsLogName, WindowsPlatformError } from "./types.js";
+import { getWindowsEventLogSink } from "#wineventlog";
+export { WindowsEventLogError, WindowsEventLogSinkOptions, WindowsLogName, WindowsPlatformError, getWindowsEventLogSink };

package/dist/mod.js

@@ -0,0 +1,4 @@
+import { WindowsEventLogError, WindowsPlatformError } from "./types.js";
+import { getWindowsEventLogSink } from "#wineventlog";
+
+export { WindowsEventLogError, WindowsPlatformError, getWindowsEventLogSink };

package/dist/platform.cjs

@@ -0,0 +1,30 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const node_process = require_rolldown_runtime.__toESM(require("node:process"));
+
+//#region platform.ts
+/**
+* Validates that the current platform is Windows.
+* Throws a WindowsPlatformError if running on a non-Windows platform.
+*
+* @throws {WindowsPlatformError} When running on non-Windows platforms
+* @since 1.0.0
+*/
+function validateWindowsPlatform() {
+	const platform = getPlatform();
+	if (platform !== "windows" && platform !== "win32") throw new require_types.WindowsPlatformError(platform);
+}
+/**
+* Gets the current platform in a cross-runtime compatible way.
+*
+* @returns The platform identifier
+* @since 1.0.0
+*/
+function getPlatform() {
+	if (typeof Deno !== "undefined" && Deno.build?.os) return Deno.build.os;
+	if (typeof node_process.default !== "undefined" && node_process.default.platform) return node_process.default.platform;
+	return "unknown";
+}
+
+//#endregion
+exports.validateWindowsPlatform = validateWindowsPlatform;

package/dist/platform.js

@@ -0,0 +1,30 @@
+import { WindowsPlatformError } from "./types.js";
+import process from "node:process";
+
+//#region platform.ts
+/**
+* Validates that the current platform is Windows.
+* Throws a WindowsPlatformError if running on a non-Windows platform.
+*
+* @throws {WindowsPlatformError} When running on non-Windows platforms
+* @since 1.0.0
+*/
+function validateWindowsPlatform() {
+	const platform = getPlatform();
+	if (platform !== "windows" && platform !== "win32") throw new WindowsPlatformError(platform);
+}
+/**
+* Gets the current platform in a cross-runtime compatible way.
+*
+* @returns The platform identifier
+* @since 1.0.0
+*/
+function getPlatform() {
+	if (typeof Deno !== "undefined" && Deno.build?.os) return Deno.build.os;
+	if (typeof process !== "undefined" && process.platform) return process.platform;
+	return "unknown";
+}
+
+//#endregion
+export { validateWindowsPlatform };
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","names":[],"sources":["../platform.ts"],"sourcesContent":["import process from \"node:process\";\nimport { WindowsPlatformError } from \"./types.ts\";\n\n/**\n * Validates that the current platform is Windows.\n * Throws a WindowsPlatformError if running on a non-Windows platform.\n *\n * @throws {WindowsPlatformError} When running on non-Windows platforms\n * @since 1.0.0\n */\nexport function validateWindowsPlatform(): void {\n  const platform = getPlatform();\n\n  if (platform !== \"windows\" && platform !== \"win32\") {\n    throw new WindowsPlatformError(platform);\n  }\n}\n\n/**\n * Gets the current platform in a cross-runtime compatible way.\n *\n * @returns The platform identifier\n * @since 1.0.0\n */\nexport function getPlatform(): string {\n  // Deno\n  if (typeof Deno !== \"undefined\" && Deno.build?.os) {\n    return Deno.build.os;\n  }\n\n  // Node.js/Bun\n  if (typeof process !== \"undefined\" && process.platform) {\n    return process.platform;\n  }\n\n  // Fallback - assume non-Windows\n  return \"unknown\";\n}\n\n/**\n * Checks if the current platform is Windows without throwing.\n *\n * @returns true if running on Windows, false otherwise\n * @since 1.0.0\n */\nexport function isWindows(): boolean {\n  try {\n    validateWindowsPlatform();\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Gets the current JavaScript runtime.\n *\n * @returns The runtime identifier (\"deno\", \"node\", \"bun\", or \"unknown\")\n * @since 1.0.0\n */\nexport function getRuntime(): \"deno\" | \"node\" | \"bun\" | \"unknown\" {\n  // Deno\n  if (typeof Deno !== \"undefined\") {\n    return \"deno\";\n  }\n\n  // Bun\n  if (typeof globalThis !== \"undefined\" && \"Bun\" in globalThis) {\n    return \"bun\";\n  }\n\n  // Node.js (check process exists and is not Deno/Bun)\n  if (typeof process !== \"undefined\" && process.versions?.node) {\n    return \"node\";\n  }\n\n  return \"unknown\";\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,0BAAgC;CAC9C,MAAM,WAAW,aAAa;AAE9B,KAAI,aAAa,aAAa,aAAa,QACzC,OAAM,IAAI,qBAAqB;AAElC;;;;;;;AAQD,SAAgB,cAAsB;AAEpC,YAAW,SAAS,eAAe,KAAK,OAAO,GAC7C,QAAO,KAAK,MAAM;AAIpB,YAAW,YAAY,eAAe,QAAQ,SAC5C,QAAO,QAAQ;AAIjB,QAAO;AACR"}

package/dist/sink.bun.cjs

@@ -0,0 +1,102 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const require_platform = require('./platform.cjs');
+const require_ffi_bun = require('./ffi.bun.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+
+//#region sink.bun.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 Bun environments using FFI.
+*
+* This implementation uses Bun's native Foreign Function Interface to directly
+* call Windows Event Log APIs, providing high performance logging optimized
+* for the Bun runtime.
+*
+* @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) {
+			ffi = new require_ffi_bun.WindowsEventLogFFI(sourceName);
+			try {
+				ffi.initialize();
+			} catch (error) {
+				metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+				ffi = null;
+				return;
+			}
+		}
+		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) 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.bun.d.cts

@@ -0,0 +1,34 @@
+import { WindowsEventLogSinkOptions } from "./types.cjs";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.bun.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Bun environments using FFI.
+ *
+ * This implementation uses Bun's native Foreign Function Interface to directly
+ * call Windows Event Log APIs, providing high performance logging optimized
+ * for the Bun runtime.
+ *
+ * @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.bun.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.bun.d.cts.map

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

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

package/dist/sink.bun.d.ts

@@ -0,0 +1,34 @@
+import { WindowsEventLogSinkOptions } from "./types.js";
+import { Sink } from "@logtape/logtape";
+
+//#region sink.bun.d.ts
+
+/**
+ * Creates a Windows Event Log sink for Bun environments using FFI.
+ *
+ * This implementation uses Bun's native Foreign Function Interface to directly
+ * call Windows Event Log APIs, providing high performance logging optimized
+ * for the Bun runtime.
+ *
+ * @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.bun.d.ts.map
+//#endregion
+export { getWindowsEventLogSink };
+//# sourceMappingURL=sink.bun.d.ts.map

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

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

package/dist/sink.bun.js

@@ -0,0 +1,102 @@
+import { DEFAULT_EVENT_ID_MAPPING, mapLogLevelToEventType } from "./types.js";
+import { validateWindowsPlatform } from "./platform.js";
+import { WindowsEventLogFFI } from "./ffi.bun.js";
+import { getLogger } from "@logtape/logtape";
+
+//#region sink.bun.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 Bun environments using FFI.
+*
+* This implementation uses Bun's native Foreign Function Interface to directly
+* call Windows Event Log APIs, providing high performance logging optimized
+* for the Bun runtime.
+*
+* @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) {
+			ffi = new WindowsEventLogFFI(sourceName);
+			try {
+				ffi.initialize();
+			} catch (error) {
+				metaLogger.error("Failed to initialize Windows Event Log FFI: {error}", { error });
+				ffi = null;
+				return;
+			}
+		}
+		const message = formatMessage(record);
+		const context = formatContext(record);
+		const fullMessage = message + context;
+		const eventType = mapLogLevelToEventType(record.level);
+		const eventId = eventIds[record.level];
+		if (ffi) 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.bun.js.map

package/dist/sink.bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.bun.js","names":["record: LogRecord","context: string[]","options: WindowsEventLogSinkOptions","ffi: WindowsEventLogFFI | null","sink: Sink & Disposable"],"sources":["../sink.bun.ts"],"sourcesContent":["import type { LogRecord, Sink } from \"@logtape/logtape\";\nimport { getLogger } from \"@logtape/logtape\";\nimport type { WindowsEventLogSinkOptions } from \"./types.ts\";\nimport { DEFAULT_EVENT_ID_MAPPING, mapLogLevelToEventType } from \"./types.ts\";\nimport { validateWindowsPlatform } from \"./platform.ts\";\nimport { WindowsEventLogFFI } from \"./ffi.bun.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 Bun environments using FFI.\n *\n * This implementation uses Bun's native Foreign Function Interface to directly\n * call Windows Event Log APIs, providing high performance logging optimized\n * for the Bun runtime.\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    if (!ffi) {\n      ffi = new WindowsEventLogFFI(sourceName);\n      try {\n        ffi.initialize();\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        return;\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 = mapLogLevelToEventType(record.level);\n    const eventId = eventIds[record.level];\n\n    // Write to Event Log using FFI (synchronously since Bun FFI initializes synchronously)\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\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":";;;;;;;;;;AAWA,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;;;;;;;;;;;;;;;;;;;;;;;;;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,CAACJ,WAAsB;AACrD,OAAK,KAAK;AACR,SAAM,IAAI,mBAAmB;AAC7B,OAAI;AACF,QAAI,YAAY;GACjB,SAAQ,OAAO;AACd,eAAW,MACT,uDACA,EAAE,MAAO,EACV;AACD,UAAM;AACN;GACD;EACF;EAGD,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,MAAI,IACF,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"}