AbsoluteJS

@absolutejs/dataset-github

@absolutejs/dataset-githubv0.0.2betaCommerce & Growth

GitHub DatasetSource adapter for @absolutejs/discover — resolve a company's GitHub org and surface its public members (founders/leads, occasionally a public email) for tech-company contact discovery.

#Installation

BASH
bun add @absolutejs/dataset-github

#Capabilities

Overview

A @absolutejs/discover DatasetSource over the GitHub REST API — for the tech long tail SEC EDGAR misses: private startups with a GitHub org.

What it does — and doesn't

findCompany resolves a company to its GitHub org (by domain SLD, normalized name, then org search). findPeople lists the org's public members and surfaces only those whose bio signals leadership (founder / exec / lead) — not every engineer — with a public email when the profile exposes one (which lets the caller skip email-pattern-guessing for that person).

Scope / honest limits:

Only companies with a public GitHub org and public members (most users

Show 6 more

default membership + email to private), so coverage is spotty.

People are engineers/founders — ideal for technical / dev-rel partnerships,

not sales/BD.

A lookup costs 15 API calls (org + members + per-member profiles). Provide a

token — unauthenticated GitHub is 60 req/hr; authenticated is 5000/hr.

Apache-2.0. Pure importer of public GitHub data — see THIRD_PARTY_NOTICES.md. Callers are responsible for using any personal data (incl. emails) lawfully.

Outcomes

What you can build

Build on the supported package contract

Use @absolutejs/dataset-github through its supported public entry points.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/dataset-github version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/dataset-github example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#@absolutejs/dataset-github quick start

Partial snippet

# @absolutejs/dataset-github

TS
import { githubSource } from "@absolutejs/dataset-github";

const gh = githubSource({ token: process.env.GITHUB_TOKEN });

await gh.findCompany({ name: "Vercel", domain: "vercel.com" });
// → { name: "Vercel", domain: "vercel.com", registryId: "vercel", source: "github" }

await gh.findPeople({ company: "Vercel", domain: "vercel.com", limit: 5 });
// → [ { fullName: "...", title: "co-founder", company: "Vercel",
//       email: "<if public>", source: "github", confidence: 65 }, … ]

#Package commands

Scripts declared by this package manifest.

bun run buildrm -rf dist && bun build src/index.ts --outdir dist --target=bun --external @absolutejs/discover && tsc --emitDeclarationOnly --project tsconfig.json
bun run typechecktsc --noEmit