@kody/hn-pulse

@kody/hn-pulse

Intent

Tiny zero-OAuth onboarding example: fetch Hacker News top story ids from the public Firebase HN API, hydrate each item, and return a slim list agents can summarize or link. Fork-friendly Step 2 starter for keyless HTTP packages.

When to use

• Pull a short list of current HN front-page stories
• Teach agents parallel fetch + projection without secrets
• Fork and extend (filter by score, email a digest, etc.)

Exports

• getTopStories({ limit? }) — top stories with id, title, url, by, score, descendants
• default export — namespace with getTopStories

Invoke tip

Named ESM exports work via static import { ... }. For keyless packages.invoke, use a subpath whose default export is the function (for example exportName: "getTopStories"), or call the root default dispatcher.

• Subpath: getTopStories (default export for invoke)

Example

import { getTopStories } from 'kody:@kody/hn-pulse'

export default async function main() {
	return await getTopStories({ limit: 5 })
}