← All packages

@lacspace/datecheck

v1.0.1Newsroom Kit0 deps

Tell how old an article really is — so an undated 2019 story is never republished as today's news. Extract the published/modified date from HTML (JSON-LD incl. @graph, meta tags, <time>, URL patterns, bylines), including Nepali Bikram Sambat dates (Devanagari digits, every month spelling, BS→AD on a verified table), detect body-text staleness, and return a fresh | stale | unknown verdict. Fail-closed: no date + no signal = unknown, never silently fresh. AI only via an optional injected hook. Zero third-party deps, deterministic, isomorphic.

npm i @lacspace/datecheck

Usage

datecheck.ts
import { extractPublishedDate, assessFreshness, bsToAd } from "@lacspace/datecheck";

extractPublishedDate(html, url).publishedAt; // reads JSON-LD / meta / <time> / URL / byline, incl. Bikram Sambat
assessFreshness({ html, text, url, feedDate, now: new Date(), maxAgeHours: 48 }).verdict; // "fresh" | "stale" | "unknown"
bsToAd(2083, 6, 16); // → 2026-10-02 (AD)
// fail-closed: no date + no signal = "unknown", never silently fresh

Exports 9

extractPublishedDatetextStalenessassessFreshnessassessFreshnessWithAIfreshnessPromptparseAnyDatebsToAdadToBsnormalizeDigits

Keywords

date-extractionpublished-datebikram-sambatnepali-datefreshnessstalenessjsonldnewsroom

More in Newsroom Kit