@ossintel/input-parser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ossintel
+
+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,80 @@
+# @ossintel/input-parser <img src="https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png" style="height: 40px"/>
+
+<p className="flex gap-2">
+  <a href="https://github.com/ossintel/ossintel/actions/workflows/ci.yml" rel="noopener noreferrer">
+    <img alt="CI" src="https://github.com/ossintel/ossintel/actions/workflows/ci.yml/badge.svg" />
+  </a>
+  <a href="https://codecov.io/gh/ossintel/ossintel/tree/main/packages/@ossintel/input-parser" rel="noopener noreferrer">
+    <img alt="codecov" src="https://codecov.io/gh/ossintel/ossintel/graph/badge.svg?flag=@ossintel/input-parser" />
+  </a> 
+  <a href="https://npmjs.com/package/@ossintel/input-parser" rel="noopener noreferrer">
+    <img alt="npm version" src="https://img.shields.io/npm/v/@ossintel/input-parser" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/input-parser" rel="noopener noreferrer">
+    <img alt="npm downloads" src="https://img.shields.io/npm/d18m/@ossintel/input-parser" />
+  </a>
+  <a href="https://npmjs.com/package/@ossintel/input-parser" rel="noopener noreferrer">
+    <img alt="npm bundle size" src="https://img.shields.io/bundlephobia/minzip/@ossintel/input-parser" />
+  </a>
+  <img alt="license" src="https://img.shields.io/npm/l/@ossintel/input-parser" />
+</p>
+
+> @ossintel/input-parser: Lightweight and extensible input query parser for resolving developer, repository, organization, and package paths across multiple ecosystems (GitHub, NPM, StackOverflow, VS Code).
+
+---
+
+## ✨ Why @ossintel/input-parser?
+
+- **Ecosystem Agnostic**: Parses query strings, profiles, and URLs across GitHub, NPM, StackOverflow, VS Code, Medium, and LeetCode.
+- **URL Auto-Healing**: Extracts platform, owner, repo, package name, or user IDs directly from browser copy-pasted URLs.
+- **Prefix Shortcuts**: Handles intuitive prefix syntax (e.g. `org:react18-tools`, `npm:~isaacs`, `so:12345`).
+- **Fully Typed & Lightweight**: Zero external dependencies, compiling to highly optimized, type-safe ESM/CJS bundles.
+
+---
+
+## 🚀 Usage
+
+```typescript
+import { detectInput } from "@ossintel/input-parser";
+
+// Parse a repository URL
+const repo = detectInput("https://github.com/react18-tools/kosha");
+// => { platform: "github", type: "repo", owner: "react18-tools", repo: "kosha", rawInput: "..." }
+
+// Parse a GitHub Organization prefix
+const org = detectInput("org:react18-tools");
+// => { platform: "github", type: "org", owner: "react18-tools", rawInput: "..." }
+
+// Parse an NPM user shortcut
+const npmUser = detectInput("npm:~mayank1513");
+// => { platform: "npm", type: "user", name: "mayank1513", rawInput: "..." }
+```
+
+---
+
+## 📦 Installation
+
+```bash
+$ pnpm add @ossintel/input-parser
+```
+
+**_or_**
+
+```bash
+$ npm install @ossintel/input-parser
+```
+
+**_or_**
+
+```bash
+$ yarn add @ossintel/input-parser
+```
+
+
+## License
+
+This library is licensed under the MIT open-source license.
+
+<hr />
+
+<p align="center">with 💖 by <a href="https://mayankchaudhari.com" target="_blank">Mayank Kumar Chaudhari</a></p>

package/dist/index.d.mts

@@ -0,0 +1,52 @@
+interface InputDetectionResult {
+    /**
+     * Target platform: "github" | "npm" | "stackoverflow" | "vscode" | "medium" | "leetcode" | "unknown"
+     */
+    platform: "github" | "npm" | "stackoverflow" | "vscode" | "medium" | "leetcode" | "unknown";
+    /**
+     * Target type: "user" | "org" | "repo" | "package" | "unknown"
+     */
+    type: "user" | "org" | "repo" | "package" | "unknown";
+    /**
+     * GitHub owner/username or organization login
+     */
+    owner?: string;
+    /**
+     * GitHub repository name
+     */
+    repo?: string;
+    /**
+     * NPM package or user name
+     */
+    name?: string;
+    /**
+     * StackOverflow user profile ID
+     */
+    profileId?: string;
+    /**
+     * Raw input search query
+     */
+    rawInput: string;
+}
+/**
+ * Parses and resolves search query strings into platform and type targets.
+ * Supporting URLs, prefixes, and fallback shorthands.
+ *
+ * @param input - The raw search query entered by the user
+ * @returns An object containing the platform, target type, parsed identifiers, and the raw input.
+ *
+ * @example
+ * ```ts
+ * detectInput("react18-tools/kosha")
+ * // => { platform: "github", type: "repo", owner: "react18-tools", repo: "kosha", rawInput: "react18-tools/kosha" }
+ *
+ * detectInput("org:react18-tools")
+ * // => { platform: "github", type: "org", owner: "react18-tools", rawInput: "org:react18-tools" }
+ *
+ * detectInput("npm:kosha")
+ * // => { platform: "npm", type: "package", name: "kosha", rawInput: "npm:kosha" }
+ * ```
+ */
+declare function detectInput(input: string): InputDetectionResult;
+
+export { type InputDetectionResult, detectInput };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+interface InputDetectionResult {
+    /**
+     * Target platform: "github" | "npm" | "stackoverflow" | "vscode" | "medium" | "leetcode" | "unknown"
+     */
+    platform: "github" | "npm" | "stackoverflow" | "vscode" | "medium" | "leetcode" | "unknown";
+    /**
+     * Target type: "user" | "org" | "repo" | "package" | "unknown"
+     */
+    type: "user" | "org" | "repo" | "package" | "unknown";
+    /**
+     * GitHub owner/username or organization login
+     */
+    owner?: string;
+    /**
+     * GitHub repository name
+     */
+    repo?: string;
+    /**
+     * NPM package or user name
+     */
+    name?: string;
+    /**
+     * StackOverflow user profile ID
+     */
+    profileId?: string;
+    /**
+     * Raw input search query
+     */
+    rawInput: string;
+}
+/**
+ * Parses and resolves search query strings into platform and type targets.
+ * Supporting URLs, prefixes, and fallback shorthands.
+ *
+ * @param input - The raw search query entered by the user
+ * @returns An object containing the platform, target type, parsed identifiers, and the raw input.
+ *
+ * @example
+ * ```ts
+ * detectInput("react18-tools/kosha")
+ * // => { platform: "github", type: "repo", owner: "react18-tools", repo: "kosha", rawInput: "react18-tools/kosha" }
+ *
+ * detectInput("org:react18-tools")
+ * // => { platform: "github", type: "org", owner: "react18-tools", rawInput: "org:react18-tools" }
+ *
+ * detectInput("npm:kosha")
+ * // => { platform: "npm", type: "package", name: "kosha", rawInput: "npm:kosha" }
+ * ```
+ */
+declare function detectInput(input: string): InputDetectionResult;
+
+export { type InputDetectionResult, detectInput };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var l=(n,t)=>{for(var r in t)s(n,r,{get:t[r],enumerable:!0})},f=(n,t,r,p)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of o(t))!u.call(n,e)&&e!==r&&s(n,e,{get:()=>t[e],enumerable:!(p=i(t,e))||p.enumerable});return n};var m=n=>f(s({},"__esModule",{value:!0}),n);var h={};l(h,{detectInput:()=>c});module.exports=m(h);function c(n){let t=n.trim();if(t.startsWith("npm:pkg:"))return{platform:"npm",type:"package",name:t.slice(8),rawInput:t};if(t.startsWith("npm:")){let r=t.slice(4);return r.startsWith("~")?{platform:"npm",type:"user",name:r.slice(1),rawInput:t}:{platform:"npm",type:"package",name:r,rawInput:t}}if(t.startsWith("~"))return{platform:"npm",type:"user",name:t.slice(1),rawInput:t};if(t.startsWith("so:")||t.startsWith("stackoverflow:")){let r=t.startsWith("so:")?3:14;return{platform:"stackoverflow",type:"user",profileId:t.slice(r),rawInput:t}}if(t.startsWith("org:")||t.startsWith("github:org:")){let r=t.startsWith("org:")?4:11;return{platform:"github",type:"org",owner:t.slice(r),rawInput:t}}if(t.startsWith("user:")||t.startsWith("github:user:")){let r=t.startsWith("user:")?5:12;return{platform:"github",type:"user",owner:t.slice(r),rawInput:t}}if(t.startsWith("github:repo:")){let r=t.slice(12).split("/");return{platform:"github",type:"repo",owner:r[0]||"",repo:r[1]||"",rawInput:t}}if(t.startsWith("github:")){let r=t.slice(7).split("/");return r.length>=2?{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:t}:{platform:"github",type:"unknown",owner:r[0],rawInput:t}}if(t.startsWith("vscode:")){let r=t.slice(7).split("/");return{platform:"vscode",type:r.length>=2?"package":"user",name:r.join("."),rawInput:t}}if(t.startsWith("medium:"))return{platform:"medium",type:"user",profileId:t.slice(7),rawInput:t};if(t.startsWith("leetcode:"))return{platform:"leetcode",type:"user",profileId:t.slice(9),rawInput:t};try{let r=new URL(t.match(/^https?:\/\//i)?t:`https://${t}`),p=r.hostname.toLowerCase();if(p.includes("github.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="organizations"||e[0]==="orgs")return{platform:"github",type:"org",owner:e[1]||"",rawInput:t};if(e.length===1)return{platform:"github",type:"unknown",owner:e[0],rawInput:t};if(e.length>=2)return{platform:"github",type:"repo",owner:e[0],repo:e[1],rawInput:t}}if(p.includes("npmjs.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="package")return{platform:"npm",type:"package",name:e.slice(1).join("/"),rawInput:t};if(e[0].startsWith("~"))return{platform:"npm",type:"user",name:e[0].slice(1),rawInput:t};if(e[0].startsWith("@"))return e.length===1?{platform:"npm",type:"org",name:e[0],rawInput:t}:{platform:"npm",type:"package",name:`${e[0]}/${e[1]}`,rawInput:t}}if(p.includes("stackoverflow.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="users"&&e[1])return{platform:"stackoverflow",type:"user",profileId:e[1],name:e[2]||void 0,rawInput:t}}if(p.includes("medium.com")){let e=r.pathname.split("/").filter(Boolean),a=e[0]?.startsWith("@")?e[0].slice(1):e[0];if(a)return{platform:"medium",type:"user",profileId:a,rawInput:t}}}catch{}if(t.startsWith("organizations/")||t.startsWith("orgs/"))return{platform:"github",type:"org",owner:t.split("/")[1]||"",rawInput:t};if(t.startsWith("@")&&t.includes("/"))return{platform:"npm",type:"package",name:t,rawInput:t};if(t.includes("/")){let r=t.split("/");return{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:t}}return{platform:"github",type:"unknown",owner:t,rawInput:t}}0&&(module.exports={detectInput});

package/dist/index.mjs

@@ -0,0 +1 @@
+function a(s){let t=s.trim();if(t.startsWith("npm:pkg:"))return{platform:"npm",type:"package",name:t.slice(8),rawInput:t};if(t.startsWith("npm:")){let r=t.slice(4);return r.startsWith("~")?{platform:"npm",type:"user",name:r.slice(1),rawInput:t}:{platform:"npm",type:"package",name:r,rawInput:t}}if(t.startsWith("~"))return{platform:"npm",type:"user",name:t.slice(1),rawInput:t};if(t.startsWith("so:")||t.startsWith("stackoverflow:")){let r=t.startsWith("so:")?3:14;return{platform:"stackoverflow",type:"user",profileId:t.slice(r),rawInput:t}}if(t.startsWith("org:")||t.startsWith("github:org:")){let r=t.startsWith("org:")?4:11;return{platform:"github",type:"org",owner:t.slice(r),rawInput:t}}if(t.startsWith("user:")||t.startsWith("github:user:")){let r=t.startsWith("user:")?5:12;return{platform:"github",type:"user",owner:t.slice(r),rawInput:t}}if(t.startsWith("github:repo:")){let r=t.slice(12).split("/");return{platform:"github",type:"repo",owner:r[0]||"",repo:r[1]||"",rawInput:t}}if(t.startsWith("github:")){let r=t.slice(7).split("/");return r.length>=2?{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:t}:{platform:"github",type:"unknown",owner:r[0],rawInput:t}}if(t.startsWith("vscode:")){let r=t.slice(7).split("/");return{platform:"vscode",type:r.length>=2?"package":"user",name:r.join("."),rawInput:t}}if(t.startsWith("medium:"))return{platform:"medium",type:"user",profileId:t.slice(7),rawInput:t};if(t.startsWith("leetcode:"))return{platform:"leetcode",type:"user",profileId:t.slice(9),rawInput:t};try{let r=new URL(t.match(/^https?:\/\//i)?t:`https://${t}`),n=r.hostname.toLowerCase();if(n.includes("github.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="organizations"||e[0]==="orgs")return{platform:"github",type:"org",owner:e[1]||"",rawInput:t};if(e.length===1)return{platform:"github",type:"unknown",owner:e[0],rawInput:t};if(e.length>=2)return{platform:"github",type:"repo",owner:e[0],repo:e[1],rawInput:t}}if(n.includes("npmjs.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="package")return{platform:"npm",type:"package",name:e.slice(1).join("/"),rawInput:t};if(e[0].startsWith("~"))return{platform:"npm",type:"user",name:e[0].slice(1),rawInput:t};if(e[0].startsWith("@"))return e.length===1?{platform:"npm",type:"org",name:e[0],rawInput:t}:{platform:"npm",type:"package",name:`${e[0]}/${e[1]}`,rawInput:t}}if(n.includes("stackoverflow.com")){let e=r.pathname.split("/").filter(Boolean);if(e[0]==="users"&&e[1])return{platform:"stackoverflow",type:"user",profileId:e[1],name:e[2]||void 0,rawInput:t}}if(n.includes("medium.com")){let e=r.pathname.split("/").filter(Boolean),p=e[0]?.startsWith("@")?e[0].slice(1):e[0];if(p)return{platform:"medium",type:"user",profileId:p,rawInput:t}}}catch{}if(t.startsWith("organizations/")||t.startsWith("orgs/"))return{platform:"github",type:"org",owner:t.split("/")[1]||"",rawInput:t};if(t.startsWith("@")&&t.includes("/"))return{platform:"npm",type:"package",name:t,rawInput:t};if(t.includes("/")){let r=t.split("/");return{platform:"github",type:"repo",owner:r[0],repo:r[1],rawInput:t}}return{platform:"github",type:"unknown",owner:t,rawInput:t}}export{a as detectInput};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@ossintel/input-parser",
+  "author": "Mayank Kumar Chaudhari <https://mayankchaudhari.com>",
+  "private": false,
+  "version": "0.1.0",
+  "description": "Lightweight and extensible input query parser for resolving developer, repository, organization, and package paths across multiple ecosystems (GitHub, NPM, StackOverflow, VS Code).",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ossintel/ossintel",
+    "directory": "packages/input-parser"
+  },
+  "bugs": "https://github.com/ossintel/ossintel/issues",
+  "homepage": "https://github.com/ossintel/ossintel/blob/main/packages/input-parser/README.md",
+  "sideEffects": false,
+  "files": [
+    "dist/**"
+  ],
+  "devDependencies": {
+    "@types/node": "latest",
+    "tsup": "latest",
+    "typescript": "latest"
+  },
+  "forge": {
+    "aliases": [],
+    "icon": "LibraryBig",
+    "description": "Extensible input query parser"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/ossintel"
+    },
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/mayank1513"
+    }
+  ],
+  "keywords": [
+    "ossintel",
+    "parser",
+    "input-detection",
+    "github",
+    "npm",
+    "stackoverflow",
+    "vscode",
+    "monorepo"
+  ],
+  "scripts": {
+    "build": "tsup && gzip -c dist/index.js | wc -c",
+    "clean": "rm -rf dist",
+    "dev": "tsup --watch"
+  }
+}