0.1.0 • Published 3 years ago

hn-ts v0.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

hn-ts

Build status Coverage jsDocs.io Language npm bundle size npm License

A TypeScript client for the Hacker News API.

Features

  • Fully typed API and response data
  • Well documented and tested

API & Package Info

Install

Using npm:

npm i hn-ts

Using yarn:

yarn add hn-ts

Usage Examples

Get the ID of the latest item created on HN:

import { getMaxItemId } from 'hn-ts';

(async () => {
  const id = await getMaxItemId();

  // Output: a number like `27107832`
  console.log(id);
})();

Get the item (story, comment, job, poll or poll option) with the given ID:

import { getItemById } from 'hn-ts';

(async () => {
  const item = await getItemById({
    id: 27107832,
  });

  // Output: `27107832`
  console.log(item.id);

  // Output: `story`
  console.log(item.type);

  // Output: `velut`
  console.log(item.author);
})();

Get the user with the given name:

import { getUserById } from 'hn-ts';

(async () => {
  const user = await getUserById({
    id: "velut",
  });

  // Output: `velut`
  console.log(user.id);
})();

License

MIT License

Copyright (c) 2021 Edoardo Scibona

See LICENSE file.