@syshcndr/attendance 1.0.0

package/bin/attendance.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+
+function printHelp() {
+  console.log(`attendance - WLAN SSID attendance checker\n
+Usage:
+  attendance [--ssid <SSID_NAME>] [--start YYYY-MM-DD]
+
+Options:
+  --ssid   SSID name to match in WLAN AutoConfig logs. Default: Sapiens-Corporate
+  --start  Start date in YYYY-MM-DD format. Default: 2026-01-01
+  --help   Show this help.
+
+Example:
+  attendance --ssid "Sapiens-Corporate" --start 2026-01-01`);
+}
+
+function parseArgs(argv) {
+  const args = {
+    ssid: "Sapiens-Corporate",
+    start: "2026-01-01",
+    help: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+
+    if (token === "--help" || token === "-h") {
+      args.help = true;
+      continue;
+    }
+
+    if (token === "--ssid") {
+      args.ssid = argv[i + 1];
+      i += 1;
+      continue;
+    }
+
+    if (token === "--start") {
+      args.start = argv[i + 1];
+      i += 1;
+      continue;
+    }
+  }
+
+  return args;
+}
+
+function validateDate(dateText) {
+  return /^\d{4}-\d{2}-\d{2}$/.test(dateText);
+}
+
+function escapeForSingleQuotedPsString(value) {
+  return String(value).replace(/'/g, "''");
+}
+
+function getAttendanceDates({ ssid, start }) {
+  const safeSsid = escapeForSingleQuotedPsString(ssid);
+  const safeStart = escapeForSingleQuotedPsString(start);
+
+  const psScript = `
+$ErrorActionPreference = 'Stop'
+$ssid='${safeSsid}'
+$start=[datetime]'${safeStart}'
+
+$rows = Get-WinEvent -FilterHashtable @{LogName='Microsoft-Windows-WLAN-AutoConfig/Operational'; StartTime=$start; Id=8001} |
+Where-Object { $_.Message -like ('*' + $ssid + '*') } |
+Sort-Object TimeCreated |
+Select-Object @{n='Date';e={$_.TimeCreated.ToString('yyyy-MM-dd')}} -Unique
+
+$rows | ConvertTo-Json -Compress
+`;
+
+  const result = spawnSync(
+    "powershell",
+    ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", psScript],
+    {
+      encoding: "utf8",
+      maxBuffer: 10 * 1024 * 1024,
+    },
+  );
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  if (result.status !== 0) {
+    const stderr = (result.stderr || "").trim();
+    throw new Error(stderr || "PowerShell command failed.");
+  }
+
+  const stdout = (result.stdout || "").trim();
+  if (!stdout) {
+    return [];
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(stdout);
+  } catch {
+    return [];
+  }
+
+  const rows = Array.isArray(parsed) ? parsed : [parsed];
+  return rows.map((r) => r.Date).filter(Boolean);
+}
+
+function printResult(ssid, start, dates) {
+  console.log(`SSID       : ${ssid}`);
+  console.log(`Start Date : ${start}`);
+  console.log("");
+
+  if (dates.length === 0) {
+    console.log("No attendance days found.");
+    console.log("Total Days: 0");
+    return;
+  }
+
+  for (const date of dates) {
+    console.log(date);
+  }
+
+  console.log("");
+  console.log(`Total Days: ${dates.length}`);
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (!validateDate(args.start)) {
+    console.error("Error: --start must be in YYYY-MM-DD format.");
+    process.exit(1);
+  }
+
+  try {
+    const dates = getAttendanceDates({ ssid: args.ssid, start: args.start });
+    printResult(args.ssid, args.start, dates);
+  } catch (error) {
+    console.error("Failed to fetch attendance from Windows event logs.");
+    console.error(error.message || String(error));
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@syshcndr/attendance",
+  "version": "1.0.0",
+  "description": "CLI to list attendance days from Windows WLAN AutoConfig logs for a specific SSID",
+  "private": false,
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "attendance": "./bin/attendance.js"
+  },
+  "scripts": {
+    "start": "node ./bin/attendance.js"
+  },
+  "keywords": [
+    "attendance",
+    "wlan",
+    "windows",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT"
+}