Data-only library for the NBTCA documents repository. Fetches directory listings and raw markdown files from GitHub with built-in TTL caching, stale-while-revalidate fallback, and rate-limit handling.

Rendering is the consumer's job (e.g. @nbtca/prompt).

npm install @nbtca/docs

import { createDocsClient } from '@nbtca/docs';

const docs = createDocsClient(); // defaults to nbtca/documents@main

const items = await docs.listDir('tutorial');  // DocItem[]
const md    = await docs.getFile('repair/guide.md');  // string (raw markdown)

Custom target:

const docs = createDocsClient({
  owner: 'my-org',
  repo: 'my-docs',
  branch: 'main',
  token: process.env.GITHUB_TOKEN,
});

Returns DocItem[] for the given path (root if omitted). Filters out hidden files, non-markdown files, and repository metadata.

Returns raw markdown as a string. Falls back to stale cache on network error.

Thrown when a fetch fails with no stale cache available. Has .path and .status fields.

MIT