@jcbhmr/ungh 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jacob Hummer
+
+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,27 @@
+# ungh.cc client
+
+🐙 [ungh.cc](https://ungh.cc) API client for JavaScript
+
+## Installation
+
+```sh
+npm install @jcbhmr/ungh
+```
+
+## Usage
+
+```js
+import Ungh from "@jcbhmr/ungh";
+
+const ungh = new Ungh();
+console.log(await ungh.orgs.get("github"));
+console.log(await ungh.users.getByUsername("octocat"));
+console.log(await ungh.repos.listForOrg("github"));
+console.log(await ungh.repos.listForUser("octocat"));
+console.log(await ungh.repos.getLatestRelease("nodejs", "node"));
+console.log(await ungh.repos.listReleases("nodejs", "node"));
+```
+
+## Development
+
+![Vite+](https://img.shields.io/badge/Vite+-9135FF?style=for-the-badge&logo=Vite&logoColor=FFFFFF)

package/dist/index.d.mts

@@ -0,0 +1,114 @@
+//#region src/index.d.ts
+interface Options {
+  baseURL?: string | URL;
+  userAgent?: string;
+  fetch?: typeof globalThis.fetch;
+}
+declare namespace Users {
+  interface User {
+    id: number;
+    username: string;
+    name: string | null;
+    twitter: string | null;
+    avatar: string;
+  }
+  interface GetByUsername {
+    user: User;
+  }
+  interface Find {
+    user: User;
+  }
+}
+declare namespace Repos {
+  interface Repo {
+    id: number;
+    name: string;
+    repo: string;
+    description: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    pushedAt: string | null;
+    stars: number;
+    watchers: number;
+    forks: number;
+    defaultBranch: string;
+  }
+  interface ListForOrg {
+    repos: Repo[];
+  }
+  interface ListForUser {
+    repos: Repo[];
+  }
+  interface Get {
+    repo: Repo;
+  }
+  interface ListBranches {
+    branches: {
+      name: string;
+      commit: {
+        sha: string;
+        url: string;
+      };
+      protected: boolean;
+    }[];
+  }
+  interface Release {
+    id: number;
+    tag: string;
+    author: string;
+    name: string | null;
+    draft: boolean;
+    prerelease: boolean;
+    createdAt: string;
+    publishedAt: string | null;
+    markdown: string;
+    html: string;
+    assets: {
+      contentType: string;
+      size: number;
+      createdAt: string;
+      updatedAt: string;
+      downloadCount: number;
+      downloadUrl: string;
+    }[];
+  }
+  interface GetLatestRelease {
+    release: Release;
+  }
+  interface ListReleases {
+    releases: Release[];
+  }
+  interface ListContributors {
+    contributors: {
+      id: number;
+      username: string;
+      contributions: number;
+    }[];
+  }
+  interface GetReadme {
+    markdown: string;
+    html: string;
+  }
+}
+declare class Ungh {
+  #private;
+  constructor(options?: Options);
+  orgs: {
+    get: (org: string) => Promise<any>;
+  };
+  users: {
+    getByUsername: (username: string) => Promise<Users.GetByUsername>;
+    find: (query: string) => Promise<Users.Find>;
+  };
+  repos: {
+    listForOrg: (org: string) => Promise<Repos.ListForOrg>;
+    listForUser: (username: string) => Promise<Repos.ListForUser>;
+    get: (owner: string, repo: string) => Promise<Repos.Get>;
+    listBranches: (owner: string, repo: string) => Promise<Repos.ListBranches>;
+    getLatestRelease: (owner: string, repo: string) => Promise<Repos.GetLatestRelease>;
+    listReleases: (owner: string, repo: string) => Promise<Repos.ListReleases>;
+    listContributors: (owner: string, repo: string) => Promise<Repos.ListContributors>;
+  };
+}
+//#endregion
+export { Options, Repos, Users, Ungh as default };

package/dist/index.mjs

@@ -0,0 +1,46 @@
+//#region src/index.ts
+var Ungh = class {
+	#baseURL;
+	#userAgent;
+	#fetch;
+	constructor(options = {}) {
+		const baseURL = options.baseURL !== void 0 ? options.baseURL.toString() : "https://ungh.cc/";
+		const { userAgent, fetch = globalThis.fetch } = options;
+		this.#baseURL = baseURL;
+		this.#userAgent = userAgent;
+		this.#fetch = fetch;
+	}
+	async #fetchJSON(url) {
+		const response = await this.#fetch(new URL(url, this.#baseURL), {
+			headers: {
+				"User-Agent": this.#userAgent,
+				Accept: "application/json"
+			},
+			signal: AbortSignal.timeout(3e4)
+		});
+		if (response.status !== 200) throw new DOMException(`Unexpected response status: ${response.url} responded with ${response.status}`);
+		const contentType = response.headers.get("Content-Type");
+		if (contentType !== "application/json") throw new DOMException(`Unexpected content type: ${response.url} responded with ${contentType}`);
+		return await response.json();
+	}
+	async #fetchRouteJSON(template, ...substitutions) {
+		const route = String.raw({ raw: template }, ...substitutions.map((x) => encodeURIComponent(x)));
+		return await this.#fetchJSON(route);
+	}
+	orgs = { get: (org) => this.#fetchRouteJSON`orgs/${org}` };
+	users = {
+		getByUsername: (username) => this.#fetchRouteJSON`users/${username}`,
+		find: (query) => this.#fetchRouteJSON`users/find/${query}`
+	};
+	repos = {
+		listForOrg: (org) => this.#fetchRouteJSON`orgs/${org}/repos`,
+		listForUser: (username) => this.#fetchRouteJSON`users/${username}/repos`,
+		get: (owner, repo) => this.#fetchRouteJSON`repos/${owner}/${repo}`,
+		listBranches: (owner, repo) => this.#fetchRouteJSON`repos/${owner}/${repo}/branches`,
+		getLatestRelease: (owner, repo) => this.#fetchRouteJSON`repos/${owner}/${repo}/releases/latest`,
+		listReleases: (owner, repo) => this.#fetchRouteJSON`repos/${owner}/${repo}/releases`,
+		listContributors: (owner, repo) => this.#fetchRouteJSON`repos/${owner}/${repo}/contributors`
+	};
+};
+//#endregion
+export { Ungh as default };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@jcbhmr/ungh",
+  "version": "1.0.0",
+  "description": "🐙 ungh.cc API client for JavaScript",
+  "homepage": "https://npmx.dev/package-docs/@jcbhmr/ungh",
+  "bugs": {
+    "url": "https://github.com/jcbhmr/ungh/issues"
+  },
+  "license": "MIT",
+  "author": "Jacob Hummer <jcbhmr@outlook.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jcbhmr/ungh.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "bumpp": "^11.1.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "^0.2.3"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "11.9.0",
+      "onFail": "download"
+    }
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}