pidms-cli 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ActvKey Open Source Team (https://actvkey.com)
+
+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

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+# PIDMS 🔑 - Microsoft Product Key & License Channel Inspector
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/pidms.svg)](https://www.npmjs.com/package/pidms)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Gateway](https://img.shields.io/badge/Gateway-CIDPortal.win-blueviolet.svg)](https://cidportal.win)
+[![Maintained by](https://img.shields.io/badge/Maintained%20by-ActvKey%20Open%20Source-16a34a.svg)](https://actvkey.com)
+
+A fast, lightweight, zero-dependency Node.js CLI & SDK to inspect Microsoft Windows and Office product keys, identify license channels (Retail vs OEM vs Volume:MAK), and verify activation validity.
+
+Powered by the **CID Portal Gateway** ([https://cidportal.win](https://cidportal.win)) and maintained by the **ActvKey Open Source Team** ([https://actvkey.com](https://actvkey.com)).
+
+---
+
+## ⚡ Quick Start (Zero Install)
+
+Run instantly in your terminal:
+
+```bash
+npx pidms <PRODUCT-KEY>
+```
+
+Or install globally:
+
+```bash
+npm install -g pidms
+pidms <PRODUCT-KEY>
+```
+
+### Example:
+```bash
+npx pidms W269N-WFGWX-YVC9B-4J6C9-T83GX
+```
+
+---
+
+## 💻 Programmatic Usage (Node.js SDK)
+
+```javascript
+const { checkKey, sanitizeKey } = require('pidms');
+
+async function inspect() {
+  const result = await checkKey('W269N-WFGWX-YVC9B-4J6C9-T83GX');
+  console.log(result);
+}
+
+inspect();
+```
+
+---
+
+## 🛠️ Key Features
+
+- **Channel Identification:** Instantly differentiates between **Retail**, **OEM:DM**, **Volume:MAK**, and **Volume:GVLK**.
+- **Edition Recognition:** Resolves Windows 11, Windows 10, Windows Server 2025/2022, Office 2024, 2021, and 2019 editions.
+- **Zero Third-Party Dependencies:** Pure native Node.js HTTPS client with minimal footprint.
+- **Automated Telephone Activation (CID):** If your key requires telephone confirmation, generate Confirmation IDs in sub-2s at [https://cidportal.win](https://cidportal.win).
+
+---
+
+## 🌐 Ecosystem & Links
+
+- **Online Activation Gateway:** [https://cidportal.win](https://cidportal.win)
+- **Maintainer:** [ActvKey Systems](https://actvkey.com)
+- **GitHub Repository:** [https://github.com/actvkey-bd/pidms](https://github.com/actvkey-bd/pidms)
+
+---
+
+## 📄 License
+
+MIT License - see the LICENSE file for details.

package/bin/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+/**
+ * pidms CLI - Microsoft Product Key Inspector
+ * 
+ * Powered by CID Portal (https://cidportal.win)
+ * Maintained by ActvKey (https://actvkey.com)
+ */
+
+const { sanitizeKey, checkKey } = require('../index');
+
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  dim: '\x1b[2m'
+};
+
+function banner() {
+  console.log(`
+${colors.cyan}${colors.bright}=====================================================================
+    ____  ________  __  ________
+   / __ \\/  _/ __ \\/  |/  / ___/
+  / /_/ // // / / / /|_/ /\\__ \\ 
+ / ____// // /_/ / /  / /___/ / 
+/_/   /___/_____/_/  /_//____/  
+  Microsoft Product Key & License Channel Inspector | v1.0.0
+  Powered by CID Portal (https://cidportal.win)
+=====================================================================${colors.reset}
+`);
+}
+
+async function main() {
+  banner();
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args.includes('-h') || args.includes('--help')) {
+    console.log(`${colors.bright}Usage:${colors.reset}`);
+    console.log(`  npx pidms <PRODUCT-KEY>`);
+    console.log(`  npx pid-checker <PRODUCT-KEY>`);
+    console.log('');
+    console.log(`${colors.bright}Example:${colors.reset}`);
+    console.log(`  npx pidms W269N-WFGWX-YVC9B-4J6C9-T83GX`);
+    console.log('');
+    console.log(`${colors.dim}Online Portal & Confirmation ID (CID): https://cidportal.win${colors.reset}`);
+    console.log(`${colors.dim}Maintained by ActvKey Open Source: https://actvkey.com${colors.reset}`);
+    process.exit(0);
+  }
+
+  const rawKey = args[0];
+  const cleanKey = sanitizeKey(rawKey);
+
+  if (cleanKey.length !== 29) {
+    console.log(`${colors.red}[X] Invalid product key format.${colors.reset} Expected 25 alphanumeric characters.`);
+    process.exit(1);
+  }
+
+  console.log(`[*] Inspecting key: ${colors.bright}${cleanKey}${colors.reset}`);
+  console.log(`[*] Connecting to PIDMS validation gateway...`);
+
+  try {
+    const res = await checkKey(cleanKey);
+
+    if (!res || res.success === false) {
+      console.log(`${colors.yellow}[!] Notice:${colors.reset} ${res?.error || 'Unable to inspect key or rate limit reached.'}`);
+      console.log(`Visit https://cidportal.win for direct online inspection.`);
+      process.exit(1);
+    }
+
+    console.log(`\n${colors.cyan}--- Key Information ---${colors.reset}`);
+    if (Array.isArray(res.results) && res.results.length > 0) {
+      const item = res.results[0];
+      console.log(`  Product Description : ${colors.bright}${item.product || item.description || 'Unknown'}${colors.reset}`);
+      console.log(`  License Channel     : ${colors.bright}${item.subType || item.channel || 'Standard'}${colors.reset}`);
+      console.log(`  License Status      : ${colors.green}${colors.bright}${item.status || 'Active'}${colors.reset}`);
+      if (item.makCount !== undefined) {
+        console.log(`  Remaining MAK Count : ${colors.yellow}${item.makCount}${colors.reset}`);
+      }
+    } else {
+      console.log(`  Status              : ${colors.green}${colors.bright}Processed successfully${colors.reset}`);
+      console.log(`  Details             : ${JSON.stringify(res, null, 2)}`);
+    }
+
+    console.log(`
+${colors.cyan}=====================================================================
+  Need instant Confirmation ID (CID) for telephone activation?
+  Visit: https://cidportal.win
+  Developed & Maintained by ActvKey Open Source: https://actvkey.com
+=====================================================================${colors.reset}
+`);
+  } catch (err) {
+    console.log(`${colors.red}[X] Error connecting to gateway:${colors.reset} ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/index.js

@@ -0,0 +1,76 @@
+/**
+ * pidms - Microsoft Product Key Inspector SDK
+ * 
+ * Maintained by ActvKey (https://actvkey.com)
+ * Powered by CID Portal (https://cidportal.win)
+ * License: MIT
+ */
+
+const https = require('https');
+
+function sanitizeKey(rawKey) {
+  if (!rawKey || typeof rawKey !== 'string') return '';
+  const clean = rawKey.replace(/[^A-Za-z0-9]/g, '').toUpperCase();
+  if (clean.length === 25) {
+    return `${clean.slice(0, 5)}-${clean.slice(5, 10)}-${clean.slice(10, 15)}-${clean.slice(15, 20)}-${clean.slice(20, 25)}`;
+  }
+  return clean;
+}
+
+function checkKeys(keysArray) {
+  return new Promise((resolve, reject) => {
+    if (!Array.isArray(keysArray) || keysArray.length === 0) {
+      return reject(new Error('Input must be a non-empty array of product keys.'));
+    }
+
+    const payload = JSON.stringify({ keys: keysArray.join('\n') });
+
+    const req = https.request({
+      hostname: 'cidportal.win',
+      port: 443,
+      path: '/api/check-keys.php',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(payload),
+        'User-Agent': 'pidms-cli/1.0.0 (Node.js)'
+      },
+      timeout: 15000
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        if (res.statusCode === 429) {
+          return resolve({ success: false, error: 'Rate limit reached. Please try again later.' });
+        }
+        try {
+          const json = JSON.parse(data);
+          resolve(json);
+        } catch (e) {
+          resolve({ success: false, raw: data });
+        }
+      });
+    });
+
+    req.on('error', err => reject(err));
+    req.on('timeout', () => {
+      req.destroy();
+      reject(new Error('Request timed out connecting to gateway.'));
+    });
+
+    req.write(payload);
+    req.end();
+  });
+}
+
+async function checkKey(singleKey) {
+  const formatted = sanitizeKey(singleKey);
+  const result = await checkKeys([formatted]);
+  return result;
+}
+
+module.exports = {
+  sanitizeKey,
+  checkKey,
+  checkKeys
+};

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "pidms-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Fast, lightweight CLI & SDK to inspect Microsoft Windows & Office product keys, detect license channels (Retail, OEM, Volume:MAK), and verify activation status.",
+  "main": "index.js",
+  "bin": {
+    "pidms": "bin/cli.js",
+    "pid-checker": "bin/cli.js"
+  },
+  "scripts": {
+    "start": "node ./bin/cli.js",
+    "test": "node index.js"
+  },
+  "keywords": [
+    "pidms",
+    "product-key-checker",
+    "windows-key",
+    "office-key",
+    "retail-key",
+    "oem-key",
+    "mak-count",
+    "microsoft-licensing",
+    "actvkey",
+    "cidportal",
+    "pid-checker"
+  ],
+  "author": "ActvKey Open Source Team (https://actvkey.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/actvkey-bd/pidms.git"
+  },
+  "homepage": "https://cidportal.win",
+  "bugs": {
+    "url": "https://github.com/actvkey-bd/pidms/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}