wehub-resource-sync
9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
53 lines
2.2 KiB
JavaScript
53 lines
2.2 KiB
JavaScript
// rfc rfc — fetch a single IETF RFC's metadata.
|
|
//
|
|
// Hits `https://datatracker.ietf.org/doc/rfc<N>/doc.json` and projects the
|
|
// agent-useful fields: title, abstract (full text — RFCs don't truncate well),
|
|
// page count, working group, authors, std level, publish date, plus rendered URLs.
|
|
import { cli, Strategy } from '@jackwener/opencli/registry';
|
|
import { EmptyResultError } from '@jackwener/opencli/errors';
|
|
import { RFC_BASE, requireRfcNumber, rfcFetch, trimDate } from './utils.js';
|
|
|
|
cli({
|
|
site: 'rfc',
|
|
name: 'rfc',
|
|
access: 'read',
|
|
description: 'Single IETF RFC metadata (title, abstract, working group, authors, std level)',
|
|
domain: 'datatracker.ietf.org',
|
|
strategy: Strategy.PUBLIC,
|
|
browser: false,
|
|
args: [
|
|
{ name: 'number', positional: true, type: 'int', required: true, help: 'RFC number (e.g. 9000, 791, 2616)' },
|
|
],
|
|
columns: [
|
|
'rfc', 'title', 'state', 'stdLevel', 'group', 'groupType',
|
|
'pages', 'published', 'authors', 'abstract', 'rfcEditorUrl', 'url',
|
|
],
|
|
func: async (args) => {
|
|
const number = requireRfcNumber(args.number);
|
|
const name = `rfc${number}`;
|
|
const doc = await rfcFetch(`${RFC_BASE}/doc/${name}/doc.json`, `rfc ${number}`);
|
|
if (!doc || !doc.name) {
|
|
throw new EmptyResultError('rfc rfc', `IETF datatracker returned no metadata for RFC ${number}.`);
|
|
}
|
|
const authors = Array.isArray(doc.authors)
|
|
? doc.authors.map((a) => String(a?.name ?? '').trim()).filter(Boolean).join(', ')
|
|
: '';
|
|
const groupName = String(doc.group?.name ?? '').trim();
|
|
const groupType = String(doc.group?.type ?? '').trim();
|
|
return [{
|
|
rfc: number,
|
|
title: String(doc.title ?? '').trim(),
|
|
state: String(doc.state ?? '').trim(),
|
|
stdLevel: String(doc.std_level ?? '').trim(),
|
|
group: groupName,
|
|
groupType,
|
|
pages: doc.pages == null ? null : Number(doc.pages),
|
|
published: trimDate(doc.time),
|
|
authors,
|
|
abstract: String(doc.abstract ?? '').trim(),
|
|
rfcEditorUrl: `https://www.rfc-editor.org/rfc/rfc${number}`,
|
|
url: `${RFC_BASE}/doc/${name}/`,
|
|
}];
|
|
},
|
|
});
|