@neurowire/core 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -334,6 +334,20 @@ declare function matchRule(entry: NeurowireEntry, rule: FilterRule): boolean;
  */
 declare function filterEntries(feed: NeurowireFeed, spec: FilterSpec): NeurowireFeed;
 
+/**
+ * Stable, content-derived entry ids. Pure and dependency-free (no node:crypto)
+ * so core stays portable. Used to give entries that lack a real GUID a
+ * deterministic id, keeping dedup and round-trips stable across formats.
+ */
+/** FNV-1a (64-bit) hash of `input`, returned as a fixed 16-char lowercase hex string. */
+declare function hashHex(input: string): string;
+/**
+ * A deterministic synthetic id derived from an entry's link and title.
+ * Same `(link, title)` always yields the same urn; different inputs (essentially)
+ * always differ. Shape: `urn:nwf:<16-char hex>`.
+ */
+declare function stableId(link: string, title: string): string;
+
 /** One feed plus the source label its entries should carry in a merge. */
 interface MergePart {
     feed: NeurowireFeed;
@@ -472,4 +486,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 FilterField, type FilterRule, type FilterSpec, 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, entryKey, filterEntries, fromNwf, isFormat, matchRule, mergeFeeds, newEntries, parseDuration, parseMesh, parseNeurowireFeed, resolveWindow, selectEntries, serialize, toAtom, toJsonFeed, toJsonFeedObject, toMarkdown, toNwf, validateNwf };
+export { EXTENSIONS, EntrySchema, FORMATS, FeedSchema, type FilterField, type FilterRule, type FilterSpec, 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, entryKey, filterEntries, fromNwf, hashHex, isFormat, matchRule, mergeFeeds, newEntries, parseDuration, parseMesh, parseNeurowireFeed, resolveWindow, selectEntries, serialize, stableId, toAtom, toJsonFeed, toJsonFeedObject, toMarkdown, toNwf, validateNwf };

package/dist/index.js

@@ -43,6 +43,21 @@ function filterEntries(feed, spec) {
   return { ...feed, entries: kept };
 }
 
+// src/id.ts
+function hashHex(input) {
+  let hash = 0xcbf29ce484222325n;
+  const prime = 0x100000001b3n;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= BigInt(input.charCodeAt(i));
+    hash = hash * prime & 0xffffffffffffffffn;
+  }
+  return hash.toString(16).padStart(16, "0");
+}
+function stableId(link, title) {
+  return `urn:nwf:${hashHex(`${link}
+${title}`)}`;
+}
+
 // src/model.ts
 import { z } from "zod";
 var PersonSchema = z.object({
@@ -703,6 +718,7 @@ export {
   entryKey,
   filterEntries,
   fromNwf,
+  hashHex,
   isFormat,
   matchRule,
   mergeFeeds,
@@ -713,6 +729,7 @@ export {
   resolveWindow,
   selectEntries,
   serialize,
+  stableId,
   toAtom,
   toJsonFeed,
   toJsonFeedObject,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neurowire/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Canonical feed model and serializers (Atom, JSON Feed 1.1, Markdown, nwf) for Neurowire.",
   "type": "module",
   "main": "./dist/index.js",