wiki-plugin-hitchhiker 0.2.0 → 0.3.0

package/README.md

@@ -12,8 +12,8 @@ fallback), unless a site has authored its own page of that slug. Currently:
 `tools`, `changes-to-this-site` (copied from hitchhikers.earth, journals stripped),
 and `about-hitchhiker-plugin`.
 
-This plugin defines **no authorable item type** (no `factory.json`) — its value is the
-pages and the served client script below.
+This plugin defines **no authorable item type** — its `factory.json` exists only to
+declare the bundled pages — its value is the pages and the served client script below.
 
 ## 2. Client UX override (`client/wiki-ux.js`)
 Served at `/plugins/hitchhiker/wiki-ux.js` and loaded globally on every page by the
@@ -40,7 +40,10 @@ surface. It installs:
   a loud pulsing highlight; on drop it opens a ghost **preview card** (see the server below).
 
 ## 3. Server component (`server/server.js`, ESM)
-`GET /system/unfurl.json?url=…` → a normalized **static** link-preview card
+`GET /system/unfurl.json?url=…` → a normalized **static** link-preview card.
+Since 0.3.0 the two extractor libraries are **imported on first request, not at
+start-up** — they cost about 14 MB of heap together, and a host that never
+unfurls should never pay it. Start-up cost of this server is now under 1 MB.
 `{ url, title, description, provider, author, type, image, favicon, source }`.
 - oEmbed metadata first (`@extractus/oembed-extractor`), OpenGraph/Twitter/JSON-LD fallback
   (`open-graph-scraper`). Metadata only — never the oEmbed HTML embed (no live third-party

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-plugin-hitchhiker",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "House UX + default-pages plugin for the hitchhiker farms: ships default pages (Tools, Changes to this Site) and hosts the wiki-ux.js client override (friendlier factory chooser + page-flag tool page), loaded globally by the wiki-security-hitchhiker bootstrap.",
   "type": "module",
   "files": [
@@ -29,5 +29,8 @@
       "version": 1,
       "spec": "api/openapi.json"
     }
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
   }
-}
+}

package/server/server.js

@@ -25,8 +25,19 @@ import net from 'node:net'
 import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
-import ogs from 'open-graph-scraper'
-import { extract as oembedExtract } from '@extractus/oembed-extractor'
+
+// The two extractor libraries are imported on first use, not at start-up.
+// Together they load about 14 MB of heap — eighty per cent of the memory of
+// every plugin server on the farm combined — and this server is resident in
+// the shared process on every site of the host, whether or not anything ever
+// asks for a link preview. Lazy import means a host that never unfurls never
+// pays. Each import is awaited once and cached, so the second request costs
+// nothing; a failed import is not cached, so a transient error does not stick.
+let ogsP = null
+const ogs = (...a) => (ogsP ||= import('open-graph-scraper').then(m => m.default, e => { ogsP = null; throw e })).then(f => f(...a))
+let oembedP = null
+const oembedExtract = (...a) =>
+  (oembedP ||= import('@extractus/oembed-extractor').then(m => m.extract, e => { oembedP = null; throw e })).then(f => f(...a))
 
 const CACHE = new Map()
 const TTL = 1000 * 60 * 30 // 30 minutes