@logtape/windows-eventlog 1.0.0-dev.225

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2024 Hong Minhee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+<!-- deno-fmt-ignore-file -->
+
+LogTape Windows Event Log sink
+==============================
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+
+Windows Event Log sink for [LogTape]. This package provides a Windows Event Log
+sink that sends log messages directly to the Windows Event Log system with
+cross-runtime support and optimal performance.
+
+[JSR]: https://jsr.io/@logtape/windows-eventlog
+[JSR badge]: https://jsr.io/badges/@logtape/windows-eventlog
+[npm]: https://www.npmjs.com/package/@logtape/windows-eventlog
+[npm badge]: https://img.shields.io/npm/v/@logtape/windows-eventlog?logo=npm
+[LogTape]: https://logtape.org/
+
+
+Features
+--------
+
+ -  *Native Windows integration*: Direct integration with Windows Event Log
+    system
+ -  *Cross-runtime*: Works on Deno, Node.js, and Bun
+ -  *High performance*: Uses runtime-optimized FFI implementations
+ -  *Structured logging*: Preserves structured data in Event Log entries
+ -  *Unicode support*: Full support for international characters and emoji
+ -  *Platform safety*: Automatically restricts installation to Windows platforms
+ -  *Zero dependencies*: No external dependencies for Deno and Bun
+
+
+Installation
+------------
+
+This package is available on [JSR] and [npm]. You can install it for various
+JavaScript runtimes and package managers:
+
+~~~~ sh
+deno add jsr:@logtape/windows-eventlog  # for Deno
+npm  add     @logtape/windows-eventlog  # for npm
+pnpm add     @logtape/windows-eventlog  # for pnpm
+yarn add     @logtape/windows-eventlog  # for Yarn
+bun  add     @logtape/windows-eventlog  # for Bun
+~~~~
+
+> [!NOTE]
+> This package is only available for Windows platforms. The package installation
+> is restricted to Windows (`"os": ["win32"]`) to prevent accidental usage on
+> other platforms.
+
+
+Usage
+-----
+
+The quickest way to get started is to use the `getWindowsEventLogSink()`
+function with your application source name:
+
+~~~~ typescript
+import { configure } from "@logtape/logtape";
+import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+
+await configure({
+  sinks: {
+    eventlog: getWindowsEventLogSink({
+      sourceName: "MyApplication",
+    }),
+  },
+  loggers: [
+    { category: [], sinks: ["eventlog"], lowestLevel: "info" },
+  ],
+});
+~~~~
+
+You can also customize the sink behavior with additional options:
+
+~~~~ typescript
+import { configure } from "@logtape/logtape";
+import { getWindowsEventLogSink } from "@logtape/windows-eventlog";
+
+await configure({
+  sinks: {
+    eventlog: getWindowsEventLogSink({
+      sourceName: "MyApplication",
+      logName: "Application",  // Default log name
+      eventIdMapping: {
+        error: 1001,
+        warning: 2001,
+        info: 3001,
+      },
+    }),
+  },
+  loggers: [
+    { category: [], sinks: ["eventlog"], lowestLevel: "info" },
+  ],
+});
+~~~~
+
+
+Runtime support
+---------------
+
+The Windows Event Log sink works across multiple JavaScript runtimes on Windows:
+
+ -  *Deno*: Uses [Deno's native FFI] for optimal performance
+ -  *Node.js*: Uses the [koffi] library for FFI bindings
+ -  *Bun*: Uses [Bun's native FFI] for maximum performance
+
+[Deno's native FFI]: https://docs.deno.com/runtime/fundamentals/ffi/
+[koffi]: https://koffi.dev/
+[Bun's native FFI]: https://bun.sh/docs/api/ffi
+
+
+Viewing logs
+------------
+
+Once your application writes to the Windows Event Log, you can view the logs using:
+
+ -  *Event Viewer* (*eventvwr.msc*)
+ -  *PowerShell*: `Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='MyApplication'}`
+ -  *Command Prompt*: `wevtutil qe Application /f:text /q:"*[System[Provider[@Name='MyApplication']]]"`
+
+
+Docs
+----
+
+The docs of this package is available at
+<https://logtape.org/manual/sinks#windows-event-log-sink>. For the API
+references, see <https://jsr.io/@logtape/windows-eventlog>.

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,30 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/ffi.bun.cjs

@@ -0,0 +1,102 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+const bun_ffi = require_rolldown_runtime.__toESM(require("bun:ffi"));
+
+//#region ffi.bun.ts
+/**
+* Bun FFI implementation for Windows Event Log API
+*/
+var WindowsEventLogFFI = class {
+	eventSource = null;
+	lib = null;
+	sourceName;
+	initialized = false;
+	metaLogger = (0, __logtape_logtape.getLogger)([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initialize the FFI bindings and register event source
+	*/
+	initialize() {
+		if (this.initialized) return;
+		try {
+			this.lib = (0, bun_ffi.dlopen)("advapi32.dll", {
+				RegisterEventSourceA: {
+					args: [bun_ffi.FFIType.ptr, bun_ffi.FFIType.cstring],
+					returns: bun_ffi.FFIType.ptr
+				},
+				ReportEventA: {
+					args: [
+						bun_ffi.FFIType.ptr,
+						bun_ffi.FFIType.u16,
+						bun_ffi.FFIType.u16,
+						bun_ffi.FFIType.u32,
+						bun_ffi.FFIType.ptr,
+						bun_ffi.FFIType.u16,
+						bun_ffi.FFIType.u32,
+						bun_ffi.FFIType.ptr,
+						bun_ffi.FFIType.ptr
+					],
+					returns: bun_ffi.FFIType.bool
+				},
+				DeregisterEventSource: {
+					args: [bun_ffi.FFIType.ptr],
+					returns: bun_ffi.FFIType.bool
+				}
+			});
+			const encoder = new TextEncoder();
+			const sourceNameBuffer = encoder.encode(this.sourceName + "\0");
+			const result = this.lib.symbols.RegisterEventSourceA(null, sourceNameBuffer);
+			this.eventSource = typeof result === "number" ? result : null;
+			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}`);
+		}
+	}
+	/**
+	* Write an event to Windows Event Log
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.initialized || !this.eventSource || !this.lib) return;
+		try {
+			const encoder = new TextEncoder();
+			const messageBuffer = encoder.encode(message + "\0");
+			const ptrArray = new BigUint64Array(2);
+			ptrArray[0] = BigInt((0, bun_ffi.ptr)(messageBuffer));
+			ptrArray[1] = 0n;
+			const success = this.lib.symbols.ReportEventA(this.eventSource, eventType, 0, eventId, null, 1, 0, ptrArray, null);
+			if (!success) throw new Error(`ReportEventA returned false`);
+		} catch (error) {
+			throw error;
+		}
+	}
+	/**
+	* Clean up resources
+	*/
+	dispose() {
+		if (this.initialized && this.eventSource && this.lib) {
+			try {
+				this.lib.symbols.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+			this.initialized = false;
+			try {
+				this.lib.close();
+			} catch (error) {
+				this.metaLogger.error("Failed to close FFI library during cleanup: {error}", { error });
+			}
+			this.lib = null;
+		}
+	}
+};
+
+//#endregion
+exports.WindowsEventLogFFI = WindowsEventLogFFI;

package/dist/ffi.bun.js

@@ -0,0 +1,102 @@
+import { getLogger } from "@logtape/logtape";
+import { FFIType, dlopen, ptr } from "bun:ffi";
+
+//#region ffi.bun.ts
+/**
+* Bun FFI implementation for Windows Event Log API
+*/
+var WindowsEventLogFFI = class {
+	eventSource = null;
+	lib = null;
+	sourceName;
+	initialized = false;
+	metaLogger = getLogger([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initialize the FFI bindings and register event source
+	*/
+	initialize() {
+		if (this.initialized) return;
+		try {
+			this.lib = dlopen("advapi32.dll", {
+				RegisterEventSourceA: {
+					args: [FFIType.ptr, FFIType.cstring],
+					returns: FFIType.ptr
+				},
+				ReportEventA: {
+					args: [
+						FFIType.ptr,
+						FFIType.u16,
+						FFIType.u16,
+						FFIType.u32,
+						FFIType.ptr,
+						FFIType.u16,
+						FFIType.u32,
+						FFIType.ptr,
+						FFIType.ptr
+					],
+					returns: FFIType.bool
+				},
+				DeregisterEventSource: {
+					args: [FFIType.ptr],
+					returns: FFIType.bool
+				}
+			});
+			const encoder = new TextEncoder();
+			const sourceNameBuffer = encoder.encode(this.sourceName + "\0");
+			const result = this.lib.symbols.RegisterEventSourceA(null, sourceNameBuffer);
+			this.eventSource = typeof result === "number" ? result : null;
+			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}`);
+		}
+	}
+	/**
+	* Write an event to Windows Event Log
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.initialized || !this.eventSource || !this.lib) return;
+		try {
+			const encoder = new TextEncoder();
+			const messageBuffer = encoder.encode(message + "\0");
+			const ptrArray = new BigUint64Array(2);
+			ptrArray[0] = BigInt(ptr(messageBuffer));
+			ptrArray[1] = 0n;
+			const success = this.lib.symbols.ReportEventA(this.eventSource, eventType, 0, eventId, null, 1, 0, ptrArray, null);
+			if (!success) throw new Error(`ReportEventA returned false`);
+		} catch (error) {
+			throw error;
+		}
+	}
+	/**
+	* Clean up resources
+	*/
+	dispose() {
+		if (this.initialized && this.eventSource && this.lib) {
+			try {
+				this.lib.symbols.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+			this.initialized = false;
+			try {
+				this.lib.close();
+			} catch (error) {
+				this.metaLogger.error("Failed to close FFI library during cleanup: {error}", { error });
+			}
+			this.lib = null;
+		}
+	}
+};
+
+//#endregion
+export { WindowsEventLogFFI };
+//# sourceMappingURL=ffi.bun.js.map

package/dist/ffi.bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi.bun.js","names":["sourceName: string","eventType: EventType","eventId: number","message: string"],"sources":["../ffi.bun.ts"],"sourcesContent":["import { getLogger } from \"@logtape/logtape\";\n// @ts-types=\"npm:@types/bun@^1.2.16\"\nimport { dlopen, FFIType, ptr } from \"bun:ffi\";\nimport type { EventType } from \"./types.ts\";\n\n/**\n * Bun FFI implementation for Windows Event Log API\n */\nexport class WindowsEventLogFFI {\n  private eventSource: number | null = null;\n  // deno-lint-ignore no-explicit-any\n  private lib: any = null;\n  private sourceName: string;\n  private initialized = false;\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  initialize(): void {\n    if (this.initialized) return;\n\n    try {\n      // Load advapi32.dll using Bun FFI\n      this.lib = dlopen(\"advapi32.dll\", {\n        RegisterEventSourceA: {\n          args: [FFIType.ptr, FFIType.cstring],\n          returns: FFIType.ptr,\n        },\n        ReportEventA: {\n          args: [\n            FFIType.ptr, // hEventLog\n            FFIType.u16, // wType\n            FFIType.u16, // wCategory\n            FFIType.u32, // dwEventID\n            FFIType.ptr, // lpUserSid\n            FFIType.u16, // wNumStrings\n            FFIType.u32, // dwDataSize\n            FFIType.ptr, // lpStrings - pointer to array of string pointers\n            FFIType.ptr, // lpRawData\n          ],\n          returns: FFIType.bool,\n        },\n        DeregisterEventSource: {\n          args: [FFIType.ptr],\n          returns: FFIType.bool,\n        },\n      });\n\n      // Register event source using cstring\n      // Create a buffer for the source name\n      const encoder = new TextEncoder();\n      const sourceNameBuffer = encoder.encode(this.sourceName + \"\\0\");\n\n      const result = this.lib.symbols.RegisterEventSourceA(\n        null,\n        sourceNameBuffer,\n      );\n      this.eventSource = typeof result === \"number\" ? result : null;\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  /**\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.lib) {\n      return;\n    }\n\n    try {\n      // Use string array approach which works with Bun FFI\n      const encoder = new TextEncoder();\n      const messageBuffer = encoder.encode(message + \"\\0\");\n\n      // Create pointer array for strings\n      const ptrArray = new BigUint64Array(2);\n      ptrArray[0] = BigInt(ptr(messageBuffer));\n      ptrArray[1] = 0n; // null terminator\n\n      const success = this.lib.symbols.ReportEventA(\n        this.eventSource,\n        eventType,\n        0, // category\n        eventId,\n        null, // user SID (null)\n        1, // number of strings\n        0, // data size\n        ptrArray, // pointer to array of string pointers\n        null, // raw data (null)\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.lib) {\n      try {\n        this.lib.symbols.DeregisterEventSource(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      try {\n        this.lib.close();\n      } catch (error) {\n        this.metaLogger.error(\n          \"Failed to close FFI library during cleanup: {error}\",\n          { error },\n        );\n      }\n      this.lib = null;\n    }\n  }\n}\n\n// cSpell: ignore cstring\n"],"mappings":";;;;;;;AAQA,IAAa,qBAAb,MAAgC;CAC9B,AAAQ,cAA6B;CAErC,AAAQ,MAAW;CACnB,AAAQ;CACR,AAAQ,cAAc;CACtB,AAAQ,aAAa,UAAU;EAAC;EAAW;EAAQ;CAAmB,EAAC;CAEvE,YAAYA,YAAoB;AAC9B,OAAK,aAAa;CACnB;;;;CAKD,aAAmB;AACjB,MAAI,KAAK,YAAa;AAEtB,MAAI;AAEF,QAAK,MAAM,OAAO,gBAAgB;IAChC,sBAAsB;KACpB,MAAM,CAAC,QAAQ,KAAK,QAAQ,OAAQ;KACpC,SAAS,QAAQ;IAClB;IACD,cAAc;KACZ,MAAM;MACJ,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;MACR,QAAQ;KACT;KACD,SAAS,QAAQ;IAClB;IACD,uBAAuB;KACrB,MAAM,CAAC,QAAQ,GAAI;KACnB,SAAS,QAAQ;IAClB;GACF,EAAC;GAIF,MAAM,UAAU,IAAI;GACpB,MAAM,mBAAmB,QAAQ,OAAO,KAAK,aAAa,KAAK;GAE/D,MAAM,SAAS,KAAK,IAAI,QAAQ,qBAC9B,MACA,iBACD;AACD,QAAK,qBAAqB,WAAW,WAAW,SAAS;AAEzD,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;;;;CAKD,WAAWC,WAAsBC,SAAiBC,SAAuB;AACvE,OAAK,KAAK,gBAAgB,KAAK,gBAAgB,KAAK,IAClD;AAGF,MAAI;GAEF,MAAM,UAAU,IAAI;GACpB,MAAM,gBAAgB,QAAQ,OAAO,UAAU,KAAK;GAGpD,MAAM,WAAW,IAAI,eAAe;AACpC,YAAS,KAAK,OAAO,IAAI,cAAc,CAAC;AACxC,YAAS,KAAK;GAEd,MAAM,UAAU,KAAK,IAAI,QAAQ,aAC/B,KAAK,aACL,WACA,GACA,SACA,MACA,GACA,GACA,UACA,KACD;AAED,QAAK,QACH,OAAM,IAAI,OAAO;EAEpB,SAAQ,OAAO;AACd,SAAM;EACP;CACF;;;;CAKD,UAAgB;AACd,MAAI,KAAK,eAAe,KAAK,eAAe,KAAK,KAAK;AACpD,OAAI;AACF,SAAK,IAAI,QAAQ,sBAAsB,KAAK,YAAY;GACzD,SAAQ,OAAO;AACd,SAAK,WAAW,MACd,6DACA,EAAE,MAAO,EACV;GACF;AACD,QAAK,cAAc;AACnB,QAAK,cAAc;AAEnB,OAAI;AACF,SAAK,IAAI,OAAO;GACjB,SAAQ,OAAO;AACd,SAAK,WAAW,MACd,uDACA,EAAE,MAAO,EACV;GACF;AACD,QAAK,MAAM;EACZ;CACF;AACF"}

package/dist/ffi.deno.cjs

@@ -0,0 +1,116 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_types = require('./types.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+
+//#region ffi.deno.ts
+const EVENTLOG_ERROR_TYPE = 1;
+const EVENTLOG_WARNING_TYPE = 2;
+const EVENTLOG_INFORMATION_TYPE = 4;
+const FFI_SYMBOLS = {
+	RegisterEventSourceA: {
+		parameters: ["pointer", "pointer"],
+		result: "pointer"
+	},
+	DeregisterEventSource: {
+		parameters: ["pointer"],
+		result: "u32"
+	},
+	ReportEventA: {
+		parameters: [
+			"pointer",
+			"u16",
+			"u16",
+			"u32",
+			"pointer",
+			"u16",
+			"u32",
+			"pointer",
+			"pointer"
+		],
+		result: "u32"
+	}
+};
+/**
+* Windows Event Log FFI wrapper class for Deno.
+* Provides direct access to Windows Event Log APIs through Deno's FFI.
+*
+* @since 1.0.0
+*/
+var WindowsEventLogFFI = class {
+	lib = null;
+	eventSource = null;
+	encoder = new TextEncoder();
+	metaLogger = (0, __logtape_logtape.getLogger)([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initializes the FFI library and registers the event source.
+	* @throws {WindowsEventLogError} If initialization fails
+	*/
+	initialize() {
+		try {
+			this.lib = Deno.dlopen("advapi32.dll", FFI_SYMBOLS);
+			const sourceNamePtr = Deno.UnsafePointer.of(this.encoder.encode(this.sourceName + "\0"));
+			this.eventSource = this.lib.symbols.RegisterEventSourceA(null, sourceNamePtr);
+			if (!this.eventSource) throw new require_types.WindowsEventLogError(`Failed to register event source '${this.sourceName}'.`);
+		} catch (error) {
+			if (error instanceof require_types.WindowsEventLogError) throw error;
+			throw new require_types.WindowsEventLogError(`Failed to initialize Windows Event Log FFI: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Writes a message to the Windows Event Log.
+	*
+	* @param eventType Event type (error, warning, info)
+	* @param eventId Event ID number
+	* @param message Message string to log
+	* @throws {WindowsEventLogError} If the write operation fails
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.lib || !this.eventSource) throw new require_types.WindowsEventLogError("FFI not initialized. Call initialize() first.");
+		try {
+			const messageBuffer = this.encoder.encode(message + "\0");
+			const messagePtr = Deno.UnsafePointer.of(messageBuffer);
+			const messagePtrValue = messagePtr ? Deno.UnsafePointer.value(messagePtr) : 0n;
+			const stringsArray = new BigUint64Array([messagePtrValue]);
+			const stringsPtr = Deno.UnsafePointer.of(stringsArray);
+			const result = this.lib.symbols.ReportEventA(this.eventSource, eventType, 0, eventId, null, 1, 0, stringsPtr, null);
+			if (result === 0) throw new require_types.WindowsEventLogError(`Failed to write event to Event Log.`);
+		} catch (error) {
+			if (error instanceof require_types.WindowsEventLogError) throw error;
+			throw new require_types.WindowsEventLogError(`Error writing to Event Log: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Cleans up resources and deregisters the event source.
+	*/
+	dispose() {
+		if (this.lib && this.eventSource) {
+			try {
+				this.lib.symbols.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+		}
+		if (this.lib) {
+			try {
+				this.lib.close();
+			} catch (error) {
+				this.metaLogger.error("Failed to close FFI library during cleanup: {error}", { error });
+			}
+			this.lib = null;
+		}
+	}
+};
+
+//#endregion
+exports.EVENTLOG_ERROR_TYPE = EVENTLOG_ERROR_TYPE;
+exports.EVENTLOG_INFORMATION_TYPE = EVENTLOG_INFORMATION_TYPE;
+exports.EVENTLOG_WARNING_TYPE = EVENTLOG_WARNING_TYPE;
+exports.WindowsEventLogFFI = WindowsEventLogFFI;

package/dist/ffi.deno.js

@@ -0,0 +1,113 @@
+import { WindowsEventLogError } from "./types.js";
+import { getLogger } from "@logtape/logtape";
+
+//#region ffi.deno.ts
+const EVENTLOG_ERROR_TYPE = 1;
+const EVENTLOG_WARNING_TYPE = 2;
+const EVENTLOG_INFORMATION_TYPE = 4;
+const FFI_SYMBOLS = {
+	RegisterEventSourceA: {
+		parameters: ["pointer", "pointer"],
+		result: "pointer"
+	},
+	DeregisterEventSource: {
+		parameters: ["pointer"],
+		result: "u32"
+	},
+	ReportEventA: {
+		parameters: [
+			"pointer",
+			"u16",
+			"u16",
+			"u32",
+			"pointer",
+			"u16",
+			"u32",
+			"pointer",
+			"pointer"
+		],
+		result: "u32"
+	}
+};
+/**
+* Windows Event Log FFI wrapper class for Deno.
+* Provides direct access to Windows Event Log APIs through Deno's FFI.
+*
+* @since 1.0.0
+*/
+var WindowsEventLogFFI = class {
+	lib = null;
+	eventSource = null;
+	encoder = new TextEncoder();
+	metaLogger = getLogger([
+		"logtape",
+		"meta",
+		"windows-eventlog"
+	]);
+	constructor(sourceName) {
+		this.sourceName = sourceName;
+	}
+	/**
+	* Initializes the FFI library and registers the event source.
+	* @throws {WindowsEventLogError} If initialization fails
+	*/
+	initialize() {
+		try {
+			this.lib = Deno.dlopen("advapi32.dll", FFI_SYMBOLS);
+			const sourceNamePtr = Deno.UnsafePointer.of(this.encoder.encode(this.sourceName + "\0"));
+			this.eventSource = this.lib.symbols.RegisterEventSourceA(null, sourceNamePtr);
+			if (!this.eventSource) throw new WindowsEventLogError(`Failed to register event source '${this.sourceName}'.`);
+		} catch (error) {
+			if (error instanceof WindowsEventLogError) throw error;
+			throw new WindowsEventLogError(`Failed to initialize Windows Event Log FFI: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Writes a message to the Windows Event Log.
+	*
+	* @param eventType Event type (error, warning, info)
+	* @param eventId Event ID number
+	* @param message Message string to log
+	* @throws {WindowsEventLogError} If the write operation fails
+	*/
+	writeEvent(eventType, eventId, message) {
+		if (!this.lib || !this.eventSource) throw new WindowsEventLogError("FFI not initialized. Call initialize() first.");
+		try {
+			const messageBuffer = this.encoder.encode(message + "\0");
+			const messagePtr = Deno.UnsafePointer.of(messageBuffer);
+			const messagePtrValue = messagePtr ? Deno.UnsafePointer.value(messagePtr) : 0n;
+			const stringsArray = new BigUint64Array([messagePtrValue]);
+			const stringsPtr = Deno.UnsafePointer.of(stringsArray);
+			const result = this.lib.symbols.ReportEventA(this.eventSource, eventType, 0, eventId, null, 1, 0, stringsPtr, null);
+			if (result === 0) throw new WindowsEventLogError(`Failed to write event to Event Log.`);
+		} catch (error) {
+			if (error instanceof WindowsEventLogError) throw error;
+			throw new WindowsEventLogError(`Error writing to Event Log: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : void 0);
+		}
+	}
+	/**
+	* Cleans up resources and deregisters the event source.
+	*/
+	dispose() {
+		if (this.lib && this.eventSource) {
+			try {
+				this.lib.symbols.DeregisterEventSource(this.eventSource);
+			} catch (error) {
+				this.metaLogger.error("Failed to deregister event source during cleanup: {error}", { error });
+			}
+			this.eventSource = null;
+		}
+		if (this.lib) {
+			try {
+				this.lib.close();
+			} catch (error) {
+				this.metaLogger.error("Failed to close FFI library during cleanup: {error}", { error });
+			}
+			this.lib = null;
+		}
+	}
+};
+
+//#endregion
+export { EVENTLOG_ERROR_TYPE, EVENTLOG_INFORMATION_TYPE, EVENTLOG_WARNING_TYPE, WindowsEventLogFFI };
+//# sourceMappingURL=ffi.deno.js.map

package/dist/ffi.deno.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi.deno.js","names":["sourceName: string","eventType: number","eventId: number","message: string"],"sources":["../ffi.deno.ts"],"sourcesContent":["import { getLogger } from \"@logtape/logtape\";\nimport { WindowsEventLogError } from \"./types.ts\";\n\n/**\n * Windows Event Log API constants and types for FFI.\n * @since 1.0.0\n */\n\n// Event Log types\nexport const EVENTLOG_SUCCESS = 0x0000;\nexport const EVENTLOG_ERROR_TYPE = 0x0001;\nexport const EVENTLOG_WARNING_TYPE = 0x0002;\nexport const EVENTLOG_INFORMATION_TYPE = 0x0004;\n\n// FFI symbol definitions for Windows Event Log APIs\nconst FFI_SYMBOLS = {\n  RegisterEventSourceA: {\n    parameters: [\"pointer\", \"pointer\"] as const,\n    result: \"pointer\" as const,\n  },\n  DeregisterEventSource: {\n    parameters: [\"pointer\"] as const,\n    result: \"u32\" as const,\n  },\n  ReportEventA: {\n    parameters: [\n      \"pointer\", // hEventLog\n      \"u16\", // wType\n      \"u16\", // wCategory\n      \"u32\", // dwEventID\n      \"pointer\", // lpUserSid\n      \"u16\", // wNumStrings\n      \"u32\", // dwDataSize\n      \"pointer\", // lpStrings\n      \"pointer\", // lpRawData\n    ] as const,\n    result: \"u32\" as const,\n  },\n} as const;\n\n/**\n * Windows Event Log FFI wrapper class for Deno.\n * Provides direct access to Windows Event Log APIs through Deno's FFI.\n *\n * @since 1.0.0\n */\nexport class WindowsEventLogFFI {\n  private lib: Deno.DynamicLibrary<typeof FFI_SYMBOLS> | null = null;\n  private eventSource: Deno.PointerValue | null = null;\n  private encoder = new TextEncoder();\n  private metaLogger = getLogger([\"logtape\", \"meta\", \"windows-eventlog\"]);\n\n  constructor(private sourceName: string) {}\n\n  /**\n   * Initializes the FFI library and registers the event source.\n   * @throws {WindowsEventLogError} If initialization fails\n   */\n  initialize(): void {\n    try {\n      // Load advapi32.dll\n      this.lib = Deno.dlopen(\"advapi32.dll\", FFI_SYMBOLS);\n\n      // Register event source\n      const sourceNamePtr = Deno.UnsafePointer.of(\n        this.encoder.encode(this.sourceName + \"\\0\"),\n      );\n      this.eventSource = this.lib.symbols.RegisterEventSourceA(\n        null,\n        sourceNamePtr,\n      );\n\n      if (!this.eventSource) {\n        throw new WindowsEventLogError(\n          `Failed to register event source '${this.sourceName}'.`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof WindowsEventLogError) {\n        throw error;\n      }\n      throw new WindowsEventLogError(\n        `Failed to initialize Windows Event Log FFI: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Writes a message to the Windows Event Log.\n   *\n   * @param eventType Event type (error, warning, info)\n   * @param eventId Event ID number\n   * @param message Message string to log\n   * @throws {WindowsEventLogError} If the write operation fails\n   */\n  writeEvent(eventType: number, eventId: number, message: string): void {\n    if (!this.lib || !this.eventSource) {\n      throw new WindowsEventLogError(\n        \"FFI not initialized. Call initialize() first.\",\n      );\n    }\n\n    try {\n      // Prepare message string\n      const messageBuffer = this.encoder.encode(message + \"\\0\");\n      const messagePtr = Deno.UnsafePointer.of(messageBuffer);\n      const messagePtrValue = messagePtr\n        ? Deno.UnsafePointer.value(messagePtr)\n        : 0n;\n      const stringsArray = new BigUint64Array([messagePtrValue]);\n      const stringsPtr = Deno.UnsafePointer.of(stringsArray);\n\n      // Call ReportEventA\n      const result = this.lib.symbols.ReportEventA(\n        this.eventSource, // hEventLog\n        eventType, // wType\n        0, // wCategory (0 = no category)\n        eventId, // dwEventID\n        null, // lpUserSid (null = current user)\n        1, // wNumStrings (1 string)\n        0, // dwDataSize (no additional data)\n        stringsPtr, // lpStrings\n        null, // lpRawData (no additional data)\n      );\n\n      if (result === 0) {\n        throw new WindowsEventLogError(\n          `Failed to write event to Event Log.`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof WindowsEventLogError) {\n        throw error;\n      }\n      throw new WindowsEventLogError(\n        `Error writing to Event Log: ${\n          error instanceof Error ? error.message : String(error)\n        }`,\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Cleans up resources and deregisters the event source.\n   */\n  dispose(): void {\n    if (this.lib && this.eventSource) {\n      try {\n        this.lib.symbols.DeregisterEventSource(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    }\n\n    if (this.lib) {\n      try {\n        this.lib.close();\n      } catch (error) {\n        this.metaLogger.error(\n          \"Failed to close FFI library during cleanup: {error}\",\n          { error },\n        );\n      }\n      this.lib = null;\n    }\n  }\n}\n"],"mappings":";;;;AAUA,MAAa,sBAAsB;AACnC,MAAa,wBAAwB;AACrC,MAAa,4BAA4B;AAGzC,MAAM,cAAc;CAClB,sBAAsB;EACpB,YAAY,CAAC,WAAW,SAAU;EAClC,QAAQ;CACT;CACD,uBAAuB;EACrB,YAAY,CAAC,SAAU;EACvB,QAAQ;CACT;CACD,cAAc;EACZ,YAAY;GACV;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;EACD;EACD,QAAQ;CACT;AACF;;;;;;;AAQD,IAAa,qBAAb,MAAgC;CAC9B,AAAQ,MAAsD;CAC9D,AAAQ,cAAwC;CAChD,AAAQ,UAAU,IAAI;CACtB,AAAQ,aAAa,UAAU;EAAC;EAAW;EAAQ;CAAmB,EAAC;CAEvE,YAAoBA,YAAoB;EAApB;CAAsB;;;;;CAM1C,aAAmB;AACjB,MAAI;AAEF,QAAK,MAAM,KAAK,OAAO,gBAAgB,YAAY;GAGnD,MAAM,gBAAgB,KAAK,cAAc,GACvC,KAAK,QAAQ,OAAO,KAAK,aAAa,KAAK,CAC5C;AACD,QAAK,cAAc,KAAK,IAAI,QAAQ,qBAClC,MACA,cACD;AAED,QAAK,KAAK,YACR,OAAM,IAAI,sBACP,mCAAmC,KAAK,WAAW;EAGzD,SAAQ,OAAO;AACd,OAAI,iBAAiB,qBACnB,OAAM;AAER,SAAM,IAAI,sBACP,8CACC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD,GACD,iBAAiB,QAAQ;EAE5B;CACF;;;;;;;;;CAUD,WAAWC,WAAmBC,SAAiBC,SAAuB;AACpE,OAAK,KAAK,QAAQ,KAAK,YACrB,OAAM,IAAI,qBACR;AAIJ,MAAI;GAEF,MAAM,gBAAgB,KAAK,QAAQ,OAAO,UAAU,KAAK;GACzD,MAAM,aAAa,KAAK,cAAc,GAAG,cAAc;GACvD,MAAM,kBAAkB,aACpB,KAAK,cAAc,MAAM,WAAW,GACpC;GACJ,MAAM,eAAe,IAAI,eAAe,CAAC,eAAgB;GACzD,MAAM,aAAa,KAAK,cAAc,GAAG,aAAa;GAGtD,MAAM,SAAS,KAAK,IAAI,QAAQ,aAC9B,KAAK,aACL,WACA,GACA,SACA,MACA,GACA,GACA,YACA,KACD;AAED,OAAI,WAAW,EACb,OAAM,IAAI,sBACP;EAGN,SAAQ,OAAO;AACd,OAAI,iBAAiB,qBACnB,OAAM;AAER,SAAM,IAAI,sBACP,8BACC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD,GACD,iBAAiB,QAAQ;EAE5B;CACF;;;;CAKD,UAAgB;AACd,MAAI,KAAK,OAAO,KAAK,aAAa;AAChC,OAAI;AACF,SAAK,IAAI,QAAQ,sBAAsB,KAAK,YAAY;GACzD,SAAQ,OAAO;AACd,SAAK,WAAW,MACd,6DACA,EAAE,MAAO,EACV;GACF;AACD,QAAK,cAAc;EACpB;AAED,MAAI,KAAK,KAAK;AACZ,OAAI;AACF,SAAK,IAAI,OAAO;GACjB,SAAQ,OAAO;AACd,SAAK,WAAW,MACd,uDACA,EAAE,MAAO,EACV;GACF;AACD,QAAK,MAAM;EACZ;CACF;AACF"}