@ulyssedu45/service_api 1.0.5

package/README.md

@@ -0,0 +1,177 @@
+# service_api
+
+Cross-platform Node.js library to **check the existence and status of OS services** using native system APIs.
+
+**The same code runs unchanged on Windows and Linux** — the library selects the correct OS backend automatically. No `if (platform === 'win32')` guards are needed in your application.
+
+| Platform    | Backend                                                                                                                                             |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Windows** | `advapi32.dll` — calls the Windows Service Control Manager (SCM) directly via [koffi](https://koffi.dev/) FFI bindings. No PowerShell, no `sc.exe`. |
+| **Linux**   | `systemctl` (systemd), with a fallback to the legacy SysV `service` command.                                                                        |
+
+---
+
+## Installation
+
+```bash
+npm install @ulyssedu45/service_api
+```
+
+> **Requirements**: Node.js ≥ 18. koffi ships pre-built binaries for Windows and Linux (x64 / arm64) — no compilation step is needed.
+
+---
+
+## Usage
+
+The import and every function call look **identical** on Windows and Linux:
+
+```js
+const { serviceExists, getServiceStatus } = require("@ulyssedu45/service_api");
+
+// ── Check whether a service exists ───────────────────────────────────────────
+const exists = await serviceExists("myService");
+console.log(exists); // true | false
+
+// ── Get the full status ───────────────────────────────────────────────────────
+const status = await getServiceStatus("myService");
+console.log(status);
+// {
+//   name:    'myService',
+//   exists:  true,
+//   state:   'RUNNING',  // normalized — same values on both platforms
+//   pid:     12345,
+//   rawCode: ...         // raw OS value: ActiveState string (Linux) or dwCurrentState number (Windows)
+// }
+```
+
+### Service name convention
+
+| Platform | Name to use                            | Examples                             |
+| -------- | -------------------------------------- | ------------------------------------ |
+| Windows  | Short service name                     | `"wuauserv"`, `"spooler"`, `"W3SVC"` |
+| Linux    | systemd unit name (without `.service`) | `"nginx"`, `"sshd"`, `"cron"`        |
+
+---
+
+## Examples
+
+### Check existence and react to state
+
+```js
+const { serviceExists, getServiceStatus } = require("@ulyssedu45/service_api");
+
+async function checkService(name) {
+  if (!(await serviceExists(name))) {
+    console.log(`${name} is not installed.`);
+    return;
+  }
+
+  const { state, pid } = await getServiceStatus(name);
+
+  if (state === "RUNNING") {
+    console.log(`${name} is running (PID ${pid}).`);
+  } else if (state === "STOPPED") {
+    console.log(`${name} is stopped.`);
+  } else {
+    console.log(`${name} state: ${state}`);
+  }
+}
+
+// Windows
+checkService("spooler");
+
+// Linux
+checkService("nginx");
+```
+
+### Check multiple services at once
+
+```js
+const { getServiceStatus } = require("@ulyssedu45/service_api");
+
+const services =
+  process.platform === "win32"
+    ? ["spooler", "wuauserv", "W3SVC"] // Windows
+    : ["nginx", "sshd", "cron"]; // Linux
+
+const results = await Promise.all(services.map((name) => getServiceStatus(name).catch((err) => ({ name, exists: false, error: err.message }))));
+
+for (const s of results) {
+  if (!s.exists) {
+    console.log(`${s.name}: not found`);
+  } else {
+    console.log(`${s.name}: ${s.state} (PID ${s.pid || "-"})`);
+  }
+}
+```
+
+### Runnable demo
+
+```bash
+# Uses a sensible default service for the current OS
+node examples/check-service.js
+
+# Pass any service name as an argument
+node examples/check-service.js nginx      # Linux
+node examples/check-service.js spooler   # Windows
+```
+
+---
+
+## API
+
+### `serviceExists(serviceName) → Promise<boolean>`
+
+Returns `true` if the service is registered with the OS service manager, `false` if it does not exist.
+
+- Throws `TypeError` if `serviceName` is not a non-empty string.
+- Throws `Error` if the service manager cannot be contacted.
+
+### `getServiceStatus(serviceName) → Promise<ServiceStatus>`
+
+Returns a `ServiceStatus` object:
+
+| Field     | Type             | Description                                                                       |
+| --------- | ---------------- | --------------------------------------------------------------------------------- |
+| `name`    | `string`         | The service name as provided.                                                     |
+| `exists`  | `boolean`        | Always `true` (throws if the service is missing).                                 |
+| `state`   | `string`         | Normalized state — see table below.                                               |
+| `pid`     | `number`         | Main process ID (`0` when the service is not running).                            |
+| `rawCode` | `string\|number` | Raw OS value: `ActiveState` string on Linux, `dwCurrentState` integer on Windows. |
+
+- Throws `Error` if the service does not exist or cannot be queried.
+
+### State values
+
+| `state`            | Linux (ActiveState)   | Windows (dwCurrentState) |
+| ------------------ | --------------------- | ------------------------ |
+| `RUNNING`          | `active`              | `4` (SERVICE_RUNNING)    |
+| `STOPPED`          | `inactive` / `failed` | `1` (SERVICE_STOPPED)    |
+| `START_PENDING`    | `activating`          | `2`                      |
+| `STOP_PENDING`     | `deactivating`        | `3`                      |
+| `CONTINUE_PENDING` | `reloading`           | `5`                      |
+| `PAUSE_PENDING`    | —                     | `6`                      |
+| `PAUSED`           | —                     | `7`                      |
+
+---
+
+## How it works on Windows
+
+The library uses [koffi](https://koffi.dev/) to call `advapi32.dll` functions directly from Node.js — no PowerShell, no `sc.exe`, no child processes:
+
+1. **`OpenSCManagerW`** — opens a connection to the local SCM.
+2. **`OpenServiceW`** — opens a handle to the named service.
+3. **`QueryServiceStatusEx`** — fills a `SERVICE_STATUS_PROCESS` structure with the current state and PID.
+4. **`CloseServiceHandle`** — releases both handles.
+
+If `OpenServiceW` fails with error `1060` (`ERROR_SERVICE_DOES_NOT_EXIST`), `serviceExists` returns `false` rather than throwing.
+
+---
+
+## Running the tests
+
+```bash
+npm test
+```
+
+Tests use Node.js's built-in `node:test` runner (no extra dependencies).

package/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * service_api — cross-platform Node.js library to check Windows/Linux service
+ * existence and status.
+ *
+ * On Windows the library calls the Service Control Manager (SCM) via the
+ * advapi32.dll Windows API using koffi FFI bindings (no PowerShell, no sc.exe).
+ *
+ * On Linux the library queries systemd via systemctl, falling back to the
+ * legacy SysV `service` command on non-systemd systems.
+ *
+ * @module service_api
+ */
+import { ServiceStatus } from './src/types';
+/**
+ * Checks whether a service exists on the current operating system.
+ *
+ * @param serviceName
+ *   - **Windows**: the short service name (e.g. `"wuauserv"`, `"spooler"`).
+ *   - **Linux**:   the systemd unit name without the `.service` suffix
+ *                  (e.g. `"nginx"`, `"sshd"`).
+ *
+ * @returns `true` if the service is registered, `false` otherwise.
+ * @throws  {TypeError} If `serviceName` is not a non-empty string.
+ * @throws  {Error}     If the service manager cannot be contacted.
+ */
+declare const serviceExists: (serviceName: string) => Promise<boolean>;
+/**
+ * Returns the current status of a service.
+ *
+ * @param serviceName - See {@link serviceExists} for naming convention.
+ * @returns The service status.
+ * @throws  {TypeError} If `serviceName` is not a non-empty string.
+ * @throws  {Error}     If the service does not exist or cannot be queried.
+ */
+declare const getServiceStatus: (serviceName: string) => Promise<ServiceStatus>;
+export { serviceExists, getServiceStatus, ServiceStatus };
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AAc3D;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,aAAa,2CAAqB,CAAC;AAEzC;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,iDAAwB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC"}

package/index.js

@@ -0,0 +1,39 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServiceStatus = exports.serviceExists = void 0;
+const platform = process.platform;
+let impl;
+if (platform === 'win32') {
+    impl = require('./src/windows');
+}
+else if (platform === 'linux' || platform === 'darwin') {
+    impl = require('./src/linux');
+}
+else {
+    throw new Error(`service_api: unsupported platform "${platform}"`);
+}
+/**
+ * Checks whether a service exists on the current operating system.
+ *
+ * @param serviceName
+ *   - **Windows**: the short service name (e.g. `"wuauserv"`, `"spooler"`).
+ *   - **Linux**:   the systemd unit name without the `.service` suffix
+ *                  (e.g. `"nginx"`, `"sshd"`).
+ *
+ * @returns `true` if the service is registered, `false` otherwise.
+ * @throws  {TypeError} If `serviceName` is not a non-empty string.
+ * @throws  {Error}     If the service manager cannot be contacted.
+ */
+const serviceExists = impl.serviceExists;
+exports.serviceExists = serviceExists;
+/**
+ * Returns the current status of a service.
+ *
+ * @param serviceName - See {@link serviceExists} for naming convention.
+ * @returns The service status.
+ * @throws  {TypeError} If `serviceName` is not a non-empty string.
+ * @throws  {Error}     If the service does not exist or cannot be queried.
+ */
+const getServiceStatus = impl.getServiceStatus;
+exports.getServiceStatus = getServiceStatus;
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAiBb,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AAElC,IAAI,IAAmB,CAAC;AAExB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;IACzB,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC;KAAM,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;IACzD,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAChC,CAAC;KAAM,CAAC;IACN,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,GAAG,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;AAYhC,sCAAa;AAVtB;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;AAEvB,4CAAgB"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@ulyssedu45/service_api",
+  "version": "1.0.5",
+  "description": "Cross-platform Node.js library to check Windows/Linux service existence and status via native OS APIs",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ulyssedu45/service_api.git"
+  },
+  "keywords": [
+    "windows",
+    "service",
+    "linux",
+    "systemd",
+    "scm",
+    "winapi",
+    "ffi"
+  ],
+  "author": "",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/ulyssedu45/service_api/issues"
+  },
+  "homepage": "https://github.com/ulyssedu45/service_api#readme",
+  "dependencies": {
+    "koffi": "^2.15.1"
+  }
+}

package/src/linux.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Linux implementation of service_api.
+ * Uses systemctl (systemd) to query service status, with a fallback to
+ * the legacy SysV `service` command for non-systemd systems.
+ */
+import { ServiceStatus } from './types';
+/**
+ * Checks whether a Linux service exists.
+ *
+ * @param serviceName - The service name (e.g. "nginx", "sshd").
+ * @returns Resolves to `true` if the service is known.
+ * @throws If the service manager cannot be contacted.
+ */
+export declare function serviceExists(serviceName: string): Promise<boolean>;
+/**
+ * Returns the current status of a Linux service.
+ *
+ * @param serviceName - The service name (e.g. "nginx", "sshd").
+ * @returns The service status.
+ * @throws If the service does not exist or cannot be queried.
+ */
+export declare function getServiceStatus(serviceName: string): Promise<ServiceStatus>;
+//# sourceMappingURL=linux.d.ts.map

package/src/linux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.d.ts","sourceRoot":"","sources":["../../src/linux.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA6GxC;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBzE;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqClF"}

package/src/linux.js

@@ -0,0 +1,149 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceExists = serviceExists;
+exports.getServiceStatus = getServiceStatus;
+/**
+ * Thin async wrapper around child_process.execFile.
+ */
+function execFileAsync(cmd, args, opts) {
+    return new Promise((resolve, reject) => {
+        require('child_process').execFile(cmd, args, opts, (err, stdout, stderr) => {
+            if (err) {
+                err.stdout = stdout;
+                err.stderr = stderr;
+                reject(err);
+            }
+            else {
+                resolve({ stdout: stdout || '', stderr: stderr || '' });
+            }
+        });
+    });
+}
+// ─── Systemd state map ────────────────────────────────────────────────────────
+/**
+ * Maps systemctl ActiveState values to the canonical state strings used
+ * by service_api (mirrors Windows SERVICE_STATES for a consistent API).
+ */
+const SYSTEMD_STATE_MAP = {
+    active: 'RUNNING',
+    activating: 'START_PENDING',
+    deactivating: 'STOP_PENDING',
+    inactive: 'STOPPED',
+    failed: 'STOPPED',
+    reloading: 'CONTINUE_PENDING'
+};
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Detects whether the current system runs systemd.
+ */
+async function isSystemd() {
+    try {
+        await execFileAsync('systemctl', ['--version'], { timeout: 3000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Queries a service via systemctl (systemd).
+ */
+async function querySystemd(serviceName) {
+    const { stdout } = await execFileAsync('systemctl', [
+        'show',
+        '--no-pager',
+        '--property=LoadState,ActiveState,SubState,MainPID',
+        `${serviceName}.service`
+    ], { timeout: 5000 });
+    const props = {};
+    for (const line of stdout.split('\n')) {
+        const idx = line.indexOf('=');
+        if (idx !== -1) {
+            props[line.slice(0, idx)] = line.slice(idx + 1);
+        }
+    }
+    return {
+        loadState: (props.LoadState || '').trim(),
+        activeState: (props.ActiveState || '').trim(),
+        subState: (props.SubState || '').trim(),
+        mainPid: parseInt(props.MainPID || '0', 10) || 0
+    };
+}
+/**
+ * Queries a service via the legacy SysV `service` command.
+ */
+async function querySysV(serviceName) {
+    try {
+        await execFileAsync('service', [serviceName, 'status'], { timeout: 5000 });
+        return { running: true };
+    }
+    catch {
+        return { running: false };
+    }
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Checks whether a Linux service exists.
+ *
+ * @param serviceName - The service name (e.g. "nginx", "sshd").
+ * @returns Resolves to `true` if the service is known.
+ * @throws If the service manager cannot be contacted.
+ */
+async function serviceExists(serviceName) {
+    if (!serviceName || typeof serviceName !== 'string') {
+        throw new TypeError('serviceName must be a non-empty string');
+    }
+    if (await isSystemd()) {
+        const { loadState } = await querySystemd(serviceName);
+        return loadState !== 'not-found' && loadState !== '';
+    }
+    // SysV fallback: check if an init script is present.
+    const { access: fsAccess } = require('fs').promises;
+    try {
+        await fsAccess(`/etc/init.d/${serviceName}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns the current status of a Linux service.
+ *
+ * @param serviceName - The service name (e.g. "nginx", "sshd").
+ * @returns The service status.
+ * @throws If the service does not exist or cannot be queried.
+ */
+async function getServiceStatus(serviceName) {
+    if (!serviceName || typeof serviceName !== 'string') {
+        throw new TypeError('serviceName must be a non-empty string');
+    }
+    if (await isSystemd()) {
+        const { loadState, activeState, subState, mainPid } = await querySystemd(serviceName);
+        if (loadState === 'not-found' || loadState === '') {
+            throw new Error(`Service "${serviceName}" does not exist`);
+        }
+        const state = SYSTEMD_STATE_MAP[activeState] || `UNKNOWN(${activeState})`;
+        return {
+            name: serviceName,
+            exists: true,
+            state,
+            pid: mainPid,
+            rawCode: activeState
+        };
+    }
+    // SysV fallback
+    const exists = await serviceExists(serviceName);
+    if (!exists) {
+        throw new Error(`Service "${serviceName}" does not exist`);
+    }
+    const { running } = await querySysV(serviceName);
+    return {
+        name: serviceName,
+        exists: true,
+        state: running ? 'RUNNING' : 'STOPPED',
+        pid: 0,
+        rawCode: running ? 'active' : 'inactive'
+    };
+}
+//# sourceMappingURL=linux.js.map

package/src/linux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.js","sourceRoot":"","sources":["../../src/linux.ts"],"names":[],"mappings":"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"}

package/src/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Represents the status of an OS service.
+ */
+export interface ServiceStatus {
+    /** The service name as provided. */
+    name: string;
+    /** Always `true` (throws if the service is missing). */
+    exists: boolean;
+    /**
+     * One of: RUNNING | STOPPED | START_PENDING |
+     * STOP_PENDING | CONTINUE_PENDING | PAUSE_PENDING |
+     * PAUSED | UNKNOWN(<raw>).
+     */
+    state: string;
+    /** Main process ID (0 when the service is stopped). */
+    pid: number;
+    /** The raw state value from the OS. */
+    rawCode: string | number;
+}
+/**
+ * The platform-specific module contract.
+ */
+export interface ServiceModule {
+    serviceExists(serviceName: string): Promise<boolean>;
+    getServiceStatus(serviceName: string): Promise<ServiceStatus>;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/D"}

package/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/src/windows.d.ts

@@ -0,0 +1,18 @@
+import { ServiceStatus } from './types';
+/**
+ * Checks whether a Windows service exists in the SCM database.
+ *
+ * @param serviceName - The short name of the service (e.g. "wuauserv").
+ * @returns Resolves to `true` if the service exists.
+ * @throws If the SCM cannot be opened.
+ */
+export declare function serviceExists(serviceName: string): Promise<boolean>;
+/**
+ * Returns the current status of a Windows service.
+ *
+ * @param serviceName - The short name of the service (e.g. "wuauserv").
+ * @returns The service status.
+ * @throws If the service does not exist or cannot be queried.
+ */
+export declare function getServiceStatus(serviceName: string): Promise<ServiceStatus>;
+//# sourceMappingURL=windows.d.ts.map

package/src/windows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../../src/windows.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA4FxC;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBzE;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiDlF"}

package/src/windows.js

@@ -0,0 +1,156 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceExists = serviceExists;
+exports.getServiceStatus = getServiceStatus;
+/**
+ * Windows implementation of service_api.
+ * Uses the Windows Service Control Manager (SCM) via koffi FFI bindings
+ * to call advapi32.dll directly — no PowerShell or sc.exe involved.
+ */
+const koffi_1 = __importDefault(require("koffi"));
+// ─── Windows API constants ────────────────────────────────────────────────────
+/** Right to connect to the SCM. */
+const SC_MANAGER_CONNECT = 0x0001;
+/** Right to query the service status. */
+const SERVICE_QUERY_STATUS = 0x0004;
+/** QueryServiceStatusEx InfoLevel: returns a SERVICE_STATUS_PROCESS structure. */
+const SC_STATUS_PROCESS_INFO = 0;
+/** GetLastError code when the named service does not exist in the SCM database. */
+const ERROR_SERVICE_DOES_NOT_EXIST = 1060;
+// ─── Service state map ────────────────────────────────────────────────────────
+/** Maps dwCurrentState values to human-readable strings. */
+const SERVICE_STATES = {
+    1: 'STOPPED',
+    2: 'START_PENDING',
+    3: 'STOP_PENDING',
+    4: 'RUNNING',
+    5: 'CONTINUE_PENDING',
+    6: 'PAUSE_PENDING',
+    7: 'PAUSED'
+};
+// ─── koffi type definitions ───────────────────────────────────────────────────
+/**
+ * SERVICE_STATUS_PROCESS structure (winapi).
+ * @see https://learn.microsoft.com/en-us/windows/win32/api/winsvc/ns-winsvc-service_status_process
+ */
+const SERVICE_STATUS_PROCESS = koffi_1.default.struct('SERVICE_STATUS_PROCESS', {
+    dwServiceType: 'uint32',
+    dwCurrentState: 'uint32',
+    dwControlsAccepted: 'uint32',
+    dwWin32ExitCode: 'uint32',
+    dwServiceSpecificExitCode: 'uint32',
+    dwCheckPoint: 'uint32',
+    dwWaitHint: 'uint32',
+    dwProcessId: 'uint32',
+    dwServiceFlags: 'uint32'
+});
+// ─── DLL loading (lazy — only executed on Windows at require() time) ──────────
+const advapi32 = koffi_1.default.load('advapi32');
+const kernel32 = koffi_1.default.load('kernel32');
+/**
+ * Opens a connection to the service control manager.
+ */
+const OpenSCManagerW = advapi32.func('void *OpenSCManagerW(str16 lpMachineName, str16 lpDatabaseName, uint32 dwDesiredAccess)');
+/**
+ * Opens an existing service object.
+ */
+const OpenServiceW = advapi32.func('void *OpenServiceW(void *hSCManager, str16 lpServiceName, uint32 dwDesiredAccess)');
+/**
+ * Retrieves the current status of the specified service.
+ */
+const QueryServiceStatusEx = advapi32.func('bool QueryServiceStatusEx(void *hService, int32 InfoLevel, _Out_ SERVICE_STATUS_PROCESS *lpBuffer, uint32 cbBufSize, _Out_ uint32 *pcbBytesNeeded)');
+/** Closes an open handle to a service or the SCM. */
+const CloseServiceHandle = advapi32.func('bool CloseServiceHandle(void *hSCObject)');
+/** Returns the last Win32 error code for the calling thread. */
+const GetLastError = kernel32.func('uint32 GetLastError()');
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Returns true when a koffi pointer value represents a NULL handle.
+ */
+function isNullHandle(handle) {
+    return handle === null || handle === 0;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Checks whether a Windows service exists in the SCM database.
+ *
+ * @param serviceName - The short name of the service (e.g. "wuauserv").
+ * @returns Resolves to `true` if the service exists.
+ * @throws If the SCM cannot be opened.
+ */
+async function serviceExists(serviceName) {
+    if (!serviceName || typeof serviceName !== 'string') {
+        throw new TypeError('serviceName must be a non-empty string');
+    }
+    const hSCM = OpenSCManagerW(null, null, SC_MANAGER_CONNECT);
+    if (isNullHandle(hSCM)) {
+        throw new Error(`OpenSCManagerW failed (GetLastError=${GetLastError()})`);
+    }
+    try {
+        const hService = OpenServiceW(hSCM, serviceName, SERVICE_QUERY_STATUS);
+        if (isNullHandle(hService)) {
+            const err = GetLastError();
+            if (err === ERROR_SERVICE_DOES_NOT_EXIST) {
+                return false;
+            }
+            throw new Error(`OpenServiceW failed (GetLastError=${err})`);
+        }
+        CloseServiceHandle(hService);
+        return true;
+    }
+    finally {
+        CloseServiceHandle(hSCM);
+    }
+}
+/**
+ * Returns the current status of a Windows service.
+ *
+ * @param serviceName - The short name of the service (e.g. "wuauserv").
+ * @returns The service status.
+ * @throws If the service does not exist or cannot be queried.
+ */
+async function getServiceStatus(serviceName) {
+    if (!serviceName || typeof serviceName !== 'string') {
+        throw new TypeError('serviceName must be a non-empty string');
+    }
+    const hSCM = OpenSCManagerW(null, null, SC_MANAGER_CONNECT);
+    if (isNullHandle(hSCM)) {
+        throw new Error(`OpenSCManagerW failed (GetLastError=${GetLastError()})`);
+    }
+    try {
+        const hService = OpenServiceW(hSCM, serviceName, SERVICE_QUERY_STATUS);
+        if (isNullHandle(hService)) {
+            const err = GetLastError();
+            if (err === ERROR_SERVICE_DOES_NOT_EXIST) {
+                throw new Error(`Service "${serviceName}" does not exist`);
+            }
+            throw new Error(`OpenServiceW failed (GetLastError=${err})`);
+        }
+        try {
+            const statusBuf = {};
+            const bytesNeeded = [0];
+            const ok = QueryServiceStatusEx(hService, SC_STATUS_PROCESS_INFO, statusBuf, koffi_1.default.sizeof(SERVICE_STATUS_PROCESS), bytesNeeded);
+            if (!ok) {
+                throw new Error(`QueryServiceStatusEx failed (GetLastError=${GetLastError()})`);
+            }
+            const stateCode = statusBuf.dwCurrentState;
+            return {
+                name: serviceName,
+                exists: true,
+                state: SERVICE_STATES[stateCode] || `UNKNOWN(${stateCode})`,
+                pid: statusBuf.dwProcessId,
+                rawCode: stateCode
+            };
+        }
+        finally {
+            CloseServiceHandle(hService);
+        }
+    }
+    finally {
+        CloseServiceHandle(hSCM);
+    }
+}
+//# sourceMappingURL=windows.js.map

package/src/windows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows.js","sourceRoot":"","sources":["../../src/windows.ts"],"names":[],"mappings":"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"}

package/test/service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=service.test.d.ts.map

package/test/service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.test.d.ts","sourceRoot":"","sources":["../../test/service.test.ts"],"names":[],"mappings":""}

package/test/service.test.js

@@ -0,0 +1,227 @@
+'use strict';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Tests for the Linux implementation (src/linux.ts).
+ * These tests mock child_process.execFile and fs.promises.access to avoid
+ * requiring a real system service manager.
+ */
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+// ─── Tests ───────────────────────────────────────────────────────────────────
+(0, node_test_1.describe)('Linux implementation — serviceExists', () => {
+    (0, node_test_1.it)('returns true for an existing systemd service', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                // isSystemd() probe
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                // querySystemd — service is loaded and running
+                cb(null, 'LoadState=loaded\nActiveState=active\nSubState=running\nMainPID=1234\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { serviceExists } = require('../src/linux');
+            const result = await serviceExists('nginx');
+            assert.equal(result, true);
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('returns false for a non-existent systemd service', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                // systemd reports not-found
+                cb(null, 'LoadState=not-found\nActiveState=inactive\nSubState=dead\nMainPID=0\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { serviceExists } = require('../src/linux');
+            const result = await serviceExists('doesnotexist');
+            assert.equal(result, false);
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('throws TypeError for invalid serviceName', async () => {
+        delete require.cache[require.resolve('../src/linux')];
+        const { serviceExists } = require('../src/linux');
+        await assert.rejects(() => serviceExists(''), TypeError);
+        await assert.rejects(() => serviceExists(null), TypeError);
+        await assert.rejects(() => serviceExists(42), TypeError);
+    });
+});
+(0, node_test_1.describe)('Linux implementation — getServiceStatus', () => {
+    (0, node_test_1.it)('returns RUNNING status for an active service', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                cb(null, 'LoadState=loaded\nActiveState=active\nSubState=running\nMainPID=4321\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { getServiceStatus } = require('../src/linux');
+            const status = await getServiceStatus('sshd');
+            assert.equal(status.name, 'sshd');
+            assert.equal(status.exists, true);
+            assert.equal(status.state, 'RUNNING');
+            assert.equal(status.pid, 4321);
+            assert.equal(status.rawCode, 'active');
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('returns STOPPED status for an inactive service', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                cb(null, 'LoadState=loaded\nActiveState=inactive\nSubState=dead\nMainPID=0\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { getServiceStatus } = require('../src/linux');
+            const status = await getServiceStatus('nginx');
+            assert.equal(status.state, 'STOPPED');
+            assert.equal(status.pid, 0);
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('returns START_PENDING for an activating service', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                cb(null, 'LoadState=loaded\nActiveState=activating\nSubState=start\nMainPID=0\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { getServiceStatus } = require('../src/linux');
+            const status = await getServiceStatus('myservice');
+            assert.equal(status.state, 'START_PENDING');
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('throws when the service does not exist', async () => {
+        const cp = require('child_process');
+        const orig = cp.execFile;
+        let callCount = 0;
+        cp.execFile = function (cmd, args, opts, cb) {
+            callCount++;
+            if (callCount === 1) {
+                cb(null, 'systemd 252\n', '');
+            }
+            else {
+                cb(null, 'LoadState=not-found\nActiveState=inactive\nSubState=dead\nMainPID=0\n', '');
+            }
+            return { kill: () => { } };
+        };
+        try {
+            delete require.cache[require.resolve('../src/linux')];
+            const { getServiceStatus } = require('../src/linux');
+            await assert.rejects(() => getServiceStatus('ghost'), (err) => err.message.includes('does not exist'));
+        }
+        finally {
+            cp.execFile = orig;
+            delete require.cache[require.resolve('../src/linux')];
+        }
+    });
+    (0, node_test_1.it)('throws TypeError for invalid serviceName', async () => {
+        delete require.cache[require.resolve('../src/linux')];
+        const { getServiceStatus } = require('../src/linux');
+        await assert.rejects(() => getServiceStatus(''), TypeError);
+        await assert.rejects(() => getServiceStatus(undefined), TypeError);
+    });
+});
+(0, node_test_1.describe)('index.ts — module contract', () => {
+    (0, node_test_1.it)('exports serviceExists and getServiceStatus functions', () => {
+        // On Linux (our CI), the main index loads linux.
+        delete require.cache[require.resolve('../index')];
+        const api = require('../index');
+        assert.equal(typeof api.serviceExists, 'function');
+        assert.equal(typeof api.getServiceStatus, 'function');
+    });
+});
+//# sourceMappingURL=service.test.js.map

package/test/service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.test.js","sourceRoot":"","sources":["../../test/service.test.ts"],"names":[],"mappings":"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"}