@unveil/vk 0.3.0 → 0.4.0

package/README.md

@@ -4,6 +4,8 @@ Fetch GitHub account activity and analyze it for automation patterns
 
 This is the batteries-included wrapper around [`@unveil/identity`](https://github.com/unveil-project/identity). Give it a username and it does the GitHub API calls for you, then hands the result to the scoring engine.
 
+It talks to the GitHub REST API with native `fetch` and has no dependencies beyond `@unveil/identity`, so it runs the same in Node, Deno, Bun, the browser and edge runtimes.
+
 Both packages are the logic behind [AgentScan](https://agentscan.netlify.app), a tool for analyzing GitHub account behavior to detect potential AI agents and automated activity. The results are indicators, not verdicts.
 
 ### Install
@@ -36,7 +38,7 @@ analyze(username, {
 });
 ```
 
-`token` is passed straight to Octokit. Without it you are on the unauthenticated
+`token` is sent as `Authorization: Bearer`. Without it you are on the unauthenticated
 rate limit, which is 60 requests per hour for the whole IP — and each `analyze`
 call spends 4 of them. With a token you get 5000 per hour. The token needs no
 scopes; all the data read here is public.
@@ -72,8 +74,9 @@ analysis reports lower `confidence` to match.
 ### Errors
 
 `analyze` rejects instead of returning a partial result. A missing user, a
-revoked token or an exhausted rate limit all come back as the Octokit error, so
-you can read `status` off it:
+revoked token or an exhausted rate limit all come back as a plain `Error`
+carrying GitHub's own message, with the `status` and `url` of the failed request
+attached to it:
 
 ```js
 try {
@@ -85,6 +88,8 @@ try {
 }
 ```
 
+Network failures reject with whatever `fetch` threw, untouched.
+
 ### Which package do I want?
 
 Use **`@unveil/vk`** when you have a username and want an answer.

package/dist/index.d.mts

@@ -9,6 +9,11 @@ type AnalyzeReturn = {
   events: GitHubEvent[];
   eventsCount: number;
 };
+declare class GitHubError extends Error {
+  readonly status: number;
+  readonly url: string;
+  constructor(message: string, status: number, url: string);
+}
 declare function analyze(username: string, options?: AnalyzeOptions): Promise<AnalyzeReturn>;
 //#endregion
-export { AnalyzeOptions, AnalyzeReturn, analyze };
+export { AnalyzeOptions, AnalyzeReturn, GitHubError, analyze };

package/dist/index.mjs

@@ -1 +1 @@
-import{identify as e}from"@unveil/identity";import{Octokit as t}from"octokit";async function n(n,r){let i=new t({auth:r?.token}),{data:a}=await i.rest.users.getByUsername({username:n}),o=Array.from({length:3},(e,t)=>i.rest.activity.listPublicEventsForUser({username:n,per_page:100,page:t+1})),s=(await Promise.all(o)).flatMap(e=>e.data);return{analysis:e({user:a,events:s}),events:r?.showEvents?s:[],eventsCount:s.length}}export{n as analyze};
+import{identify as e}from"@unveil/identity";var t=class extends Error{status;url;constructor(e,t,n){super(e),this.name=`GitHubError`,this.status=t,this.url=n}};async function n(e){try{let t=await e.json();if(t?.message)return t.message}catch{}return`${e.status} ${e.statusText}`}async function r(e,r){let i=`https://api.github.com${e}`,a={Accept:`application/vnd.github+json`,"X-GitHub-Api-Version":`2022-11-28`,"User-Agent":`unveil-vk`};r&&(a.Authorization=`Bearer ${r}`);let o=await fetch(i,{headers:a});if(!o.ok)throw new t(await n(o),o.status,i);return await o.json()}async function i(t,n){let i=n?.token,a=encodeURIComponent(t),o=await r(`/users/${a}`,i),s=Array.from({length:3},(e,t)=>r(`/users/${a}/events/public?per_page=100&page=${t+1}`,i)),c=(await Promise.all(s)).flat();return{analysis:e({user:o,events:c}),events:n?.showEvents?c:[],eventsCount:c.length}}export{t as GitHubError,i as analyze};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@unveil/vk",
-	"version": "0.3.0",
+	"version": "0.4.0",
 	"description": "Fetch GitHub account activity and analyze it for automation patterns",
 	"type": "module",
 	"packageManager": "pnpm@11.22.0",
@@ -43,7 +43,6 @@
 		"vitest": "^4.1.10"
 	},
 	"dependencies": {
-		"@unveil/identity": "^2.0.2",
-		"octokit": "^5.0.5"
+		"@unveil/identity": "^2.0.2"
 	}
 }