@neurowire/core 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -317,6 +317,55 @@ interface MergeOptions {
  */
 declare function mergeFeeds(title: string, parts: MergePart[], options?: MergeOptions): NeurowireFeed;
 
+/**
+ * Pure, deterministic feed refinement: a time-window filter, a sort, and a
+ * limit. These operate on the canonical model and never touch the clock or the
+ * network themselves. Callers pass `now` (epoch ms) into `resolveWindow`, which
+ * keeps the whole module testable and side-effect free.
+ */
+type SortKey = 'date' | 'title' | 'source';
+type SortOrder = 'asc' | 'desc';
+interface SelectOptions {
+    /** Keep entries dated at or after this epoch-ms bound (inclusive). */
+    from?: number;
+    /** Keep entries dated at or before this epoch-ms bound (inclusive). */
+    to?: number;
+    sort?: SortKey;
+    order?: SortOrder;
+    /** Keep at most this many entries after filtering and sorting. */
+    limit?: number;
+}
+/** Parse a duration like "24h", "90m", or "7d" into milliseconds. */
+declare function parseDuration(value: string): number | undefined;
+interface WindowSpec {
+    /** Within this duration before now, e.g. "24h". */
+    since?: string;
+    /** Drop anything older than this duration, e.g. "7d". Same window as `since`. */
+    maxAge?: string;
+    /** Since midnight UTC today. */
+    today?: boolean;
+    /** Since midnight UTC of the current week (Monday). */
+    thisWeek?: boolean;
+    /** An explicit [start, end] pair of ISO dates (or anything Date.parse reads). */
+    between?: [string, string];
+}
+interface TimeWindow {
+    from?: number;
+    to?: number;
+}
+/**
+ * Turn a high-level window spec into concrete epoch-ms bounds, relative to
+ * `now`. Precedence when several are set: between > today > thisWeek > since/maxAge.
+ * Unparseable values yield an open-ended bound on that side.
+ */
+declare function resolveWindow(spec: WindowSpec, now: number): TimeWindow;
+/**
+ * Apply a date window, an optional sort, and an optional limit to a feed.
+ * Date sorts default to newest-first; title and source sorts default to A-Z.
+ * Entries without a parseable date are dropped only when a date bound is set.
+ */
+declare function selectEntries(feed: NeurowireFeed, opts: SelectOptions): NeurowireFeed;
+
 /** Serialize a feed to an Atom 1.0 document. */
 declare function toAtom(feed: NeurowireFeed): string;
 
@@ -385,4 +434,4 @@ declare function isFormat(value: string): value is Format;
 /** Serialize a feed to the requested format. */
 declare function serialize(feed: NeurowireFeed, format: Format): string;
 
-export { EXTENSIONS, EntrySchema, FORMATS, FeedSchema, type Format, GENERATOR, type JsonFeedDocument, MEDIA_TYPES, type MergeOptions, type MergePart, type Mesh, MeshSchema, type MeshSource, MeshSourceSchema, type NeurowireEntry, type NeurowireFeed, type NwfIssue, type NwfValidation, type Person, PersonSchema, fromNwf, isFormat, mergeFeeds, parseMesh, parseNeurowireFeed, serialize, toAtom, toJsonFeed, toJsonFeedObject, toMarkdown, toNwf, validateNwf };
+export { EXTENSIONS, EntrySchema, FORMATS, FeedSchema, type Format, GENERATOR, type JsonFeedDocument, MEDIA_TYPES, type MergeOptions, type MergePart, type Mesh, MeshSchema, type MeshSource, MeshSourceSchema, type NeurowireEntry, type NeurowireFeed, type NwfIssue, type NwfValidation, type Person, PersonSchema, type SelectOptions, type SortKey, type SortOrder, type TimeWindow, type WindowSpec, fromNwf, isFormat, mergeFeeds, parseDuration, parseMesh, parseNeurowireFeed, resolveWindow, selectEntries, serialize, toAtom, toJsonFeed, toJsonFeedObject, toMarkdown, toNwf, validateNwf };

package/dist/index.js

@@ -83,6 +83,82 @@ function mergeFeeds(title, parts, options = {}) {
   };
 }
 
+// src/refine.ts
+var DAY = 864e5;
+var UNIT_MS = { m: 6e4, h: 36e5, d: 864e5 };
+function parseDuration(value) {
+  const match = /^(\d+)\s*([mhd])$/.exec(value.trim());
+  if (!match) return void 0;
+  return Number(match[1]) * UNIT_MS[match[2]];
+}
+function startOfUtcDay(now) {
+  return Math.floor(now / DAY) * DAY;
+}
+function startOfUtcWeek(now) {
+  const dayNumber = Math.floor(now / DAY);
+  const weekday = ((dayNumber % 7 + 3) % 7 + 7) % 7;
+  return (dayNumber - weekday) * DAY;
+}
+function resolveWindow(spec, now) {
+  if (spec.between) {
+    const from = Date.parse(spec.between[0]);
+    const to = Date.parse(spec.between[1]);
+    return {
+      from: Number.isNaN(from) ? void 0 : from,
+      to: Number.isNaN(to) ? void 0 : to
+    };
+  }
+  if (spec.today) return { from: startOfUtcDay(now) };
+  if (spec.thisWeek) return { from: startOfUtcWeek(now) };
+  const duration = spec.since ?? spec.maxAge;
+  if (duration !== void 0) {
+    const ms = parseDuration(duration);
+    return ms === void 0 ? {} : { from: now - ms };
+  }
+  return {};
+}
+function entryTime2(entry) {
+  return Date.parse(entry.published ?? entry.updated ?? "");
+}
+function compareByTime(a, b) {
+  const ta = entryTime2(a);
+  const tb = entryTime2(b);
+  const aMissing = Number.isNaN(ta);
+  const bMissing = Number.isNaN(tb);
+  if (aMissing && bMissing) return 0;
+  if (aMissing) return -1;
+  if (bMissing) return 1;
+  return ta - tb;
+}
+function compare(key, a, b) {
+  if (key === "title") return a.title.localeCompare(b.title);
+  if (key === "source") {
+    return (a.source?.name ?? "").localeCompare(b.source?.name ?? "") || compareByTime(a, b);
+  }
+  return compareByTime(a, b);
+}
+function selectEntries(feed, opts) {
+  const { from, to, sort, order, limit } = opts;
+  let entries = feed.entries;
+  if (from !== void 0 || to !== void 0) {
+    entries = entries.filter((entry) => {
+      const t = entryTime2(entry);
+      if (Number.isNaN(t)) return false;
+      if (from !== void 0 && t < from) return false;
+      if (to !== void 0 && t > to) return false;
+      return true;
+    });
+  }
+  if (sort) {
+    const direction = (order ?? (sort === "date" ? "desc" : "asc")) === "asc" ? 1 : -1;
+    entries = [...entries].sort((a, b) => direction * compare(sort, a, b));
+  }
+  if (limit !== void 0 && limit >= 0) {
+    entries = entries.slice(0, limit);
+  }
+  return { ...feed, entries };
+}
+
 // src/serialize/atom.ts
 var escapeText = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 var escapeAttr = (s) => escapeText(s).replace(/"/g, "&quot;");
@@ -582,8 +658,11 @@ export {
   fromNwf,
   isFormat,
   mergeFeeds,
+  parseDuration,
   parseMesh,
   parseNeurowireFeed,
+  resolveWindow,
+  selectEntries,
   serialize,
   toAtom,
   toJsonFeed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurowire/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Canonical feed model and serializers (Atom, JSON Feed 1.1, Markdown, nwf) for Neurowire.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
     "url": "https://github.com/starside-io/neurowire/issues"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public"