@mindful-web/marko-web-digital-edition 1.95.0

package/components/toolbar.marko.js

@@ -0,0 +1,54 @@
+// Compiled using marko@4.20.2 - DO NOT EDIT
+"use strict";
+
+var marko_template = module.exports = require("marko/dist/html").t(__filename),
+    marko_componentType = "/@mindful-web/marko-web-digital-edition$1.95.0/components/toolbar.marko",
+    marko_renderer = require("marko/dist/runtime/components/renderer"),
+    module_lib_module = require("../lib"),
+    lib_module = module_lib_module.default || module_lib_module,
+    editionPath = module_lib_module.editionPath,
+    helpers_escape_xml = require("marko/dist/runtime/html/helpers/escape-xml"),
+    marko_escapeXml = helpers_escape_xml.x,
+    marko_classAttr = require("marko/dist/runtime/html/helpers/class-attr"),
+    marko_attr = require("marko/dist/runtime/html/helpers/attr");
+
+function render(input, out, __component, component, state) {
+  var data = input;
+
+  const { manifest, view } = input;
+
+  const readHref = editionPath(manifest.issueId);
+
+  const printHref = editionPath(manifest.issueId, { view: "print" });
+
+  const showThemeToggle = input.showThemeToggle !== false;
+
+  out.w("<div class=\"edition-toolbar\"><div class=\"edition-toolbar__title\"><span class=\"edition-toolbar__pub\">" +
+    marko_escapeXml(manifest.publication) +
+    "</span><span class=\"edition-toolbar__issue\">" +
+    marko_escapeXml(manifest.name) +
+    "</span></div><div class=\"edition-toolbar__actions\">");
+
+  if (showThemeToggle) {
+    out.w("<button type=\"button\" class=\"edition-toolbar__theme\" data-edition-theme-toggle aria-live=\"polite\"><span class=\"edition-toolbar__theme__icon\" aria-hidden=\"true\"><span data-when=\"dark\">☀</span><span data-when=\"light\">☾</span></span><span class=\"edition-toolbar__theme__label\"><span data-when=\"dark\">Light</span><span data-when=\"light\">Dark</span></span></button>");
+  }
+
+  out.w("<nav class=\"edition-toolbar__views\" aria-label=\"Reading view\"><a" +
+    marko_classAttr("edition-toolbar__view " + (view === "read" ? "is-active" : "")) +
+    marko_attr("href", readHref) +
+    marko_attr("aria-current", view === "read" ? "page" : null) +
+    ">Read</a><a" +
+    marko_classAttr("edition-toolbar__view " + (view === "print" ? "is-active" : "")) +
+    marko_attr("href", printHref) +
+    marko_attr("aria-current", view === "print" ? "page" : null) +
+    ">Print view</a></nav></div></div>");
+}
+
+marko_template._ = marko_renderer(render, {
+    d_: true,
+    e_: marko_componentType
+  });
+
+marko_template.meta = {
+    id: "/@mindful-web/marko-web-digital-edition$1.95.0/components/toolbar.marko"
+  };

package/components/tracking.marko

@@ -0,0 +1,211 @@
+import { issueEntity, articleEntity } from "../lib/entities";
+
+$ const { site } = out.global;
+$ const { manifest, view, item } = input;
+$ const p1 = site.getAsObject("p1events");
+
+<if(p1.enabled)>
+  $ const issue = issueEntity(manifest);
+  $ const article = item ? articleEntity(manifest, item) : null;
+  $ const issueView = { action: "View", category: "Digital Edition", label: issue.name, entity: issue, props: { issueId: issue.id, view, pageCount: issue.props.pageCount } };
+  $ const articleView = article ? { action: "View", category: "Digital Edition Article", label: item.slug, entity: article, props: { view, via: "page" } } : null;
+  $ const articleViewScript = articleView ? `p1events('track', ${JSON.stringify(articleView)});` : "";
+
+  <!--
+    Event model (see digital-edition-spike/TRACKING-PLAN.md):
+
+      issue    View (hub / replica / article page), Page View (replica page dwell)
+      article  View (article page load here; each article entering the scroll reader
+               in scroll.marko), Scroll 25/50/75/90 of the FULL body only, Engaged View
+      ad       Impression (25% in view, "served"), Active View (IAB: 50% of the unit —
+               30% for units over 242,500 px² — for one continuous second), Click
+               (p1events link listener via data-p1-* on the anchors)
+
+    Entities are built server-side (lib/entities.js) and stamped on the elements as
+    data-edition-entity, so the browser never rebuilds them and the namespace always
+    comes from the tenant. Everything goes through the site's p1events queue, so it
+    carries the reader identity — the reason this targets Mindful ads rather than GAM.
+    Ad categories mirror the Mindful ad server's so a later swap to real
+    ADVERTISING_CREATIVE delivery is a rename, not a redesign.
+  -->
+  <script>
+    $!{`
+    (function () {
+      if (!window.p1events) return;
+      p1events('track', ${JSON.stringify(issueView)});
+      ${articleViewScript}
+
+      var ISSUE = ${JSON.stringify(issue)};
+      var hasIO = 'IntersectionObserver' in window;
+
+      function entityOf(el) {
+        try { return JSON.parse(el.getAttribute('data-edition-entity')); } catch (e) { return null; }
+      }
+
+      // ---- ads: served impression + IAB active view -------------------------------
+      var LARGE_AD_PX = 242500;
+      var seen = Object.create(null);
+      var active = Object.create(null);
+      var timers = Object.create(null);
+
+      function adEvent(action, el) {
+        var entity = entityOf(el);
+        if (!entity) return;
+        p1events('track', {
+          action: action,
+          category: 'Digital Edition Ad Unit',
+          label: el.getAttribute('data-advertiser') || '',
+          entity: entity,
+          props: {
+            issueId: ISSUE.id,
+            page: Number(el.getAttribute('data-edition-page')) || null,
+            advertiser: el.getAttribute('data-advertiser') || null,
+            placement: el.getAttribute('data-edition-placement') || 'after'
+          }
+        });
+      }
+
+      function impression(el) {
+        var id = el.getAttribute('data-edition-ad-id') + '@' + (el.getAttribute('data-edition-placement') || '');
+        if (seen[id]) return;
+        seen[id] = 1;
+        adEvent('Impression', el);
+      }
+
+      // The unit must hold its ratio for one continuous second: start a timer when it
+      // crosses the threshold, cancel it when it drops back below.
+      function activeRatioFor(el) {
+        var r = el.getBoundingClientRect();
+        return (r.width * r.height) > LARGE_AD_PX ? 0.3 : 0.5;
+      }
+      function onAdIntersect(entries) {
+        entries.forEach(function (e) {
+          var el = e.target;
+          var id = el.getAttribute('data-edition-ad-id') + '@' + (el.getAttribute('data-edition-placement') || '');
+          if (e.isIntersecting && e.intersectionRatio >= 0.25) impression(el);
+          if (active[id]) return;
+          var viewable = e.isIntersecting && e.intersectionRatio >= activeRatioFor(el);
+          if (viewable && !timers[id]) {
+            timers[id] = setTimeout(function () {
+              timers[id] = null;
+              active[id] = 1;
+              adEvent('Active View', el);
+              adIO.unobserve(el);
+            }, 1000);
+          } else if (!viewable && timers[id]) {
+            clearTimeout(timers[id]);
+            timers[id] = null;
+          }
+        });
+      }
+      var adIO = hasIO ? new IntersectionObserver(onAdIntersect, { threshold: [0, 0.25, 0.3, 0.5, 0.75, 1] }) : null;
+
+      function scanAds() {
+        var ads = document.querySelectorAll('[data-edition-ad-id]:not([data-edition-ad-tracked])');
+        for (var i = 0; i < ads.length; i += 1) {
+          ads[i].setAttribute('data-edition-ad-tracked', '1');
+          if (adIO) adIO.observe(ads[i]);
+          else impression(ads[i]);
+        }
+      }
+
+      // ---- articles: scroll depth over the FULL body only ----------------------------
+      // Thresholds mirror web articles (25/50/75/90). Depth is measured against the
+      // article's own body, not the page, and only bodies rendered for an entitled
+      // reader carry data-edition-full-body — a "90%" on a teaser would be a false read.
+      var DEPTHS = [0.25, 0.5, 0.75, 0.9];
+      var tracked = [];
+
+      function scanArticles() {
+        var arts = document.querySelectorAll('[data-edition-entity][data-edition-full-body]:not([data-edition-scroll-tracked])');
+        for (var i = 0; i < arts.length; i += 1) {
+          var art = arts[i];
+          art.setAttribute('data-edition-scroll-tracked', '1');
+          var body = art.querySelector('.edition-article__body');
+          var entity = entityOf(art);
+          if (!body || !entity) continue;
+          tracked.push({ body: body, entity: entity, slug: art.getAttribute('data-edition-article-slug') || '', fired: {} });
+        }
+        measure();
+      }
+
+      // rAF must be called as a method of window: a detached reference throws
+      // "Illegal invocation" and would leave the pending flag stuck true.
+      var raf = window.requestAnimationFrame
+        ? function (fn) { window.requestAnimationFrame(fn); }
+        : function (fn) { setTimeout(fn, 16); };
+      var pending = false;
+      function measure() {
+        pending = false;
+        var vh = window.innerHeight || document.documentElement.clientHeight;
+        for (var i = 0; i < tracked.length; i += 1) {
+          var t = tracked[i];
+          if (t.done) continue;
+          var r = t.body.getBoundingClientRect();
+          if (!r.height || r.top > vh) continue;
+          var depth = Math.min(1, (vh - r.top) / r.height);
+          var remaining = 0;
+          for (var d = 0; d < DEPTHS.length; d += 1) {
+            var k = DEPTHS[d];
+            if (t.fired[k]) continue;
+            if (depth >= k) {
+              t.fired[k] = 1;
+              p1events('track', {
+                action: 'Scroll',
+                category: 'Digital Edition Article',
+                label: (k * 100) + ' percent',
+                entity: t.entity,
+                props: { slug: t.slug, depth: k }
+              });
+            } else {
+              remaining += 1;
+            }
+          }
+          if (!remaining) t.done = true;
+        }
+      }
+      function onScroll() {
+        if (pending) return;
+        pending = true;
+        raf(measure);
+      }
+      window.addEventListener('scroll', onScroll, { passive: true });
+      window.addEventListener('resize', onScroll, { passive: true });
+
+      scanAds();
+      scanArticles();
+      // The scroll reader appends whole articles (with their ads) after this runs.
+      document.addEventListener('edition:content-appended', function () { scanAds(); scanArticles(); });
+
+      // ---- replica: report the page a reader actually dwells on ----------------------
+      var pages = document.querySelectorAll('.edition-replica__page[data-page]');
+      if (pages.length && hasIO) {
+        var pageSeen = Object.create(null);
+        var pio = new IntersectionObserver(function (entries) {
+          entries.forEach(function (e) {
+            if (!e.isIntersecting) return;
+            var n = e.target.getAttribute('data-page');
+            if (pageSeen[n]) return;
+            pageSeen[n] = 1;
+            p1events('track', {
+              action: 'Page View',
+              category: 'Digital Edition',
+              label: 'Page ' + n,
+              entity: ISSUE,
+              props: { issueId: ISSUE.id, page: Number(n) }
+            });
+          });
+        }, { threshold: 0.5 });
+        for (var k = 0; k < pages.length; k += 1) pio.observe(pages[k]);
+      }
+    }());
+    `}
+  </script>
+
+  <!-- One Engaged View per page load, on the page's primary entity. -->
+  <marko-web-p1-events-track-engagement
+    category=(article ? "Digital Edition Article" : "Digital Edition")
+    entity=(article || issue)
+    label=(article ? item.slug : issue.name)
+  />
+</if>

package/components/tracking.marko.js

@@ -0,0 +1,60 @@
+// Compiled using marko@4.20.2 - DO NOT EDIT
+"use strict";
+
+var marko_template = module.exports = require("marko/dist/html").t(__filename),
+    marko_componentType = "/@mindful-web/marko-web-digital-edition$1.95.0/components/tracking.marko",
+    marko_renderer = require("marko/dist/runtime/components/renderer"),
+    module_entities_module = require("../lib/entities"),
+    entities_module = module_entities_module.default || module_entities_module,
+    issueEntity = module_entities_module.issueEntity,
+    articleEntity = module_entities_module.articleEntity,
+    helpers_escape_xml = require("marko/dist/runtime/html/helpers/escape-xml"),
+    marko_escapeXml = helpers_escape_xml.x,
+    marko_escapeScript = require("marko/dist/runtime/html/helpers/escape-script-placeholder"),
+    marko_web_p1_events_track_engagement_template = require("@mindful-web/marko-web-p1-events/components/track-engagement.marko"),
+    marko_loadTag = require("marko/dist/runtime/helpers/load-tag"),
+    marko_web_p1_events_track_engagement_tag = marko_loadTag(marko_web_p1_events_track_engagement_template);
+
+function render(input, out, __component, component, state) {
+  var data = input;
+
+  const { site } = out.global;
+
+  const { manifest, view, item } = input;
+
+  const p1 = site.getAsObject("p1events");
+
+  if (p1.enabled) {
+    const issue = issueEntity(manifest);
+
+    const article = item ? articleEntity(manifest, item) : null;
+
+    const issueView = { action: "View", category: "Digital Edition", label: issue.name, entity: issue, props: { issueId: issue.id, view, pageCount: issue.props.pageCount } };
+
+    const articleView = article ? { action: "View", category: "Digital Edition Article", label: item.slug, entity: article, props: { view, via: "page" } } : null;
+
+    const articleViewScript = articleView ? `p1events('track', ${JSON.stringify(articleView)});` : "";
+
+    out.w("<script>" +
+      marko_escapeScript(("\n    " + (((((("\n    (function () {\n      if (!window.p1events) return;\n      p1events('track', " + JSON.stringify(issueView)) + ");\n      ") + articleViewScript) + "\n\n      var ISSUE = ") + JSON.stringify(issue)) + ";\n      var hasIO = 'IntersectionObserver' in window;\n\n      function entityOf(el) {\n        try { return JSON.parse(el.getAttribute('data-edition-entity')); } catch (e) { return null; }\n      }\n\n      // ---- ads: served impression + IAB active view -------------------------------\n      var LARGE_AD_PX = 242500;\n      var seen = Object.create(null);\n      var active = Object.create(null);\n      var timers = Object.create(null);\n\n      function adEvent(action, el) {\n        var entity = entityOf(el);\n        if (!entity) return;\n        p1events('track', {\n          action: action,\n          category: 'Digital Edition Ad Unit',\n          label: el.getAttribute('data-advertiser') || '',\n          entity: entity,\n          props: {\n            issueId: ISSUE.id,\n            page: Number(el.getAttribute('data-edition-page')) || null,\n            advertiser: el.getAttribute('data-advertiser') || null,\n            placement: el.getAttribute('data-edition-placement') || 'after'\n          }\n        });\n      }\n\n      function impression(el) {\n        var id = el.getAttribute('data-edition-ad-id') + '@' + (el.getAttribute('data-edition-placement') || '');\n        if (seen[id]) return;\n        seen[id] = 1;\n        adEvent('Impression', el);\n      }\n\n      // The unit must hold its ratio for one continuous second: start a timer when it\n      // crosses the threshold, cancel it when it drops back below.\n      function activeRatioFor(el) {\n        var r = el.getBoundingClientRect();\n        return (r.width * r.height) > LARGE_AD_PX ? 0.3 : 0.5;\n      }\n      function onAdIntersect(entries) {\n        entries.forEach(function (e) {\n          var el = e.target;\n          var id = el.getAttribute('data-edition-ad-id') + '@' + (el.getAttribute('data-edition-placement') || '');\n          if (e.isIntersecting && e.intersectionRatio >= 0.25) impression(el);\n          if (active[id]) return;\n          var viewable = e.isIntersecting && e.intersectionRatio >= activeRatioFor(el);\n          if (viewable && !timers[id]) {\n            timers[id] = setTimeout(function () {\n              timers[id] = null;\n              active[id] = 1;\n              adEvent('Active View', el);\n              adIO.unobserve(el);\n            }, 1000);\n          } else if (!viewable && timers[id]) {\n            clearTimeout(timers[id]);\n            timers[id] = null;\n          }\n        });\n      }\n      var adIO = hasIO ? new IntersectionObserver(onAdIntersect, { threshold: [0, 0.25, 0.3, 0.5, 0.75, 1] }) : null;\n\n      function scanAds() {\n        var ads = document.querySelectorAll('[data-edition-ad-id]:not([data-edition-ad-tracked])');\n        for (var i = 0; i < ads.length; i += 1) {\n          ads[i].setAttribute('data-edition-ad-tracked', '1');\n          if (adIO) adIO.observe(ads[i]);\n          else impression(ads[i]);\n        }\n      }\n\n      // ---- articles: scroll depth over the FULL body only ----------------------------\n      // Thresholds mirror web articles (25/50/75/90). Depth is measured against the\n      // article's own body, not the page, and only bodies rendered for an entitled\n      // reader carry data-edition-full-body — a \"90%\" on a teaser would be a false read.\n      var DEPTHS = [0.25, 0.5, 0.75, 0.9];\n      var tracked = [];\n\n      function scanArticles() {\n        var arts = document.querySelectorAll('[data-edition-entity][data-edition-full-body]:not([data-edition-scroll-tracked])');\n        for (var i = 0; i < arts.length; i += 1) {\n          var art = arts[i];\n          art.setAttribute('data-edition-scroll-tracked', '1');\n          var body = art.querySelector('.edition-article__body');\n          var entity = entityOf(art);\n          if (!body || !entity) continue;\n          tracked.push({ body: body, entity: entity, slug: art.getAttribute('data-edition-article-slug') || '', fired: {} });\n        }\n        measure();\n      }\n\n      // rAF must be called as a method of window: a detached reference throws\n      // \"Illegal invocation\" and would leave the pending flag stuck true.\n      var raf = window.requestAnimationFrame\n        ? function (fn) { window.requestAnimationFrame(fn); }\n        : function (fn) { setTimeout(fn, 16); };\n      var pending = false;\n      function measure() {\n        pending = false;\n        var vh = window.innerHeight || document.documentElement.clientHeight;\n        for (var i = 0; i < tracked.length; i += 1) {\n          var t = tracked[i];\n          if (t.done) continue;\n          var r = t.body.getBoundingClientRect();\n          if (!r.height || r.top > vh) continue;\n          var depth = Math.min(1, (vh - r.top) / r.height);\n          var remaining = 0;\n          for (var d = 0; d < DEPTHS.length; d += 1) {\n            var k = DEPTHS[d];\n            if (t.fired[k]) continue;\n            if (depth >= k) {\n              t.fired[k] = 1;\n              p1events('track', {\n                action: 'Scroll',\n                category: 'Digital Edition Article',\n                label: (k * 100) + ' percent',\n                entity: t.entity,\n                props: { slug: t.slug, depth: k }\n              });\n            } else {\n              remaining += 1;\n            }\n          }\n          if (!remaining) t.done = true;\n        }\n      }\n      function onScroll() {\n        if (pending) return;\n        pending = true;\n        raf(measure);\n      }\n      window.addEventListener('scroll', onScroll, { passive: true });\n      window.addEventListener('resize', onScroll, { passive: true });\n\n      scanAds();\n      scanArticles();\n      // The scroll reader appends whole articles (with their ads) after this runs.\n      document.addEventListener('edition:content-appended', function () { scanAds(); scanArticles(); });\n\n      // ---- replica: report the page a reader actually dwells on ----------------------\n      var pages = document.querySelectorAll('.edition-replica__page[data-page]');\n      if (pages.length && hasIO) {\n        var pageSeen = Object.create(null);\n        var pio = new IntersectionObserver(function (entries) {\n          entries.forEach(function (e) {\n            if (!e.isIntersecting) return;\n            var n = e.target.getAttribute('data-page');\n            if (pageSeen[n]) return;\n            pageSeen[n] = 1;\n            p1events('track', {\n              action: 'Page View',\n              category: 'Digital Edition',\n              label: 'Page ' + n,\n              entity: ISSUE,\n              props: { issueId: ISSUE.id, page: Number(n) }\n            });\n          });\n        }, { threshold: 0.5 });\n        for (var k = 0; k < pages.length; k += 1) pio.observe(pages[k]);\n      }\n    }());\n    ")) + "\n  ") +
+      "</script>");
+
+    marko_web_p1_events_track_engagement_tag({
+        category: article ? "Digital Edition Article" : "Digital Edition",
+        entity: article || issue,
+        label: article ? item.slug : issue.name
+      }, out, __component, "0");
+  }
+}
+
+marko_template._ = marko_renderer(render, {
+    d_: true,
+    e_: marko_componentType
+  });
+
+marko_template.meta = {
+    id: "/@mindful-web/marko-web-digital-edition$1.95.0/components/tracking.marko",
+    tags: [
+      "@mindful-web/marko-web-p1-events/components/track-engagement.marko"
+    ]
+  };

package/lib/authors.js

@@ -0,0 +1,125 @@
+const gql = require('graphql-tag');
+const { getAsArray } = require('@mindful-web/object-path');
+
+/**
+ * Resolve a print byline string to a CMS contact record, so the edition can render a
+ * linked name and headshot instead of plain text.
+ *
+ * The compat API has no name-search query for contacts, so the org's contact list is
+ * fetched once and matched in Node. AB Media has ~306 records, which is small enough
+ * to hold in memory — but it must NOT be fetched per request, hence the TTL cache.
+ *
+ * Matching is exact on a normalized name (plus "first last"). No fuzzy matching:
+ * attributing an article to the wrong person is worse than showing plain text.
+ */
+
+const CONTACTS = gql`
+  query EditionContacts($siteId: ObjectID!, $limit: Int!, $after: String) {
+    allPublishedContent(input: {
+      siteId: $siteId
+      includeContentTypes: [Contact]
+      pagination: { limit: $limit, after: $after }
+    }) {
+      pageInfo { hasNextPage endCursor }
+      edges {
+        node {
+          id
+          name
+          siteContext { path }
+          ... on Contactable { title firstName lastName }
+          primaryImage {
+            id
+            src(input: { options: { auto: "format,compress" } })
+            alt(input: { append: "Headshot" })
+          }
+        }
+      }
+    }
+  }
+`;
+
+const TTL_MS = 10 * 60 * 1000;
+const cache = new Map(); // siteId -> { at, index }
+
+const normalize = (s) => String(s || '')
+  .toLowerCase()
+  .replace(/^\s*by[\s:]+/i, '')
+  .replace(/[’']/g, '')
+  .replace(/[^a-z\s-]/g, ' ')
+  .replace(/\s+/g, ' ')
+  .trim();
+
+/** Fetch every contact for the site and index by normalized name. */
+async function loadIndex({ apollo, siteId }) {
+  const index = new Map();
+  let after;
+  for (let i = 0; i < 10; i += 1) {
+    // eslint-disable-next-line no-await-in-loop
+    const { data } = await apollo.query({
+      query: CONTACTS,
+      variables: { siteId, limit: 100, after },
+    });
+    const conn = data.allPublishedContent;
+    getAsArray(conn, 'edges').forEach((edge) => {
+      const { node } = edge;
+      if (!node) return;
+      [
+        normalize(node.name),
+        normalize([node.firstName, node.lastName].filter(Boolean).join(' ')),
+      ].forEach((key) => {
+        if (key && !index.has(key)) index.set(key, node);
+      });
+    });
+    if (!conn.pageInfo || !conn.pageInfo.hasNextPage) break;
+    after = conn.pageInfo.endCursor;
+  }
+  return index;
+}
+
+async function getIndex({ apollo, siteId }) {
+  const hit = cache.get(siteId);
+  if (hit && Date.now() - hit.at < TTL_MS) return hit.index;
+  try {
+    const index = await loadIndex({ apollo, siteId });
+    cache.set(siteId, { at: Date.now(), index });
+    return index;
+  } catch (e) {
+    // A contact-lookup failure must never take the edition down — fall back to
+    // plain-text bylines. Reuse a stale index if we have one.
+    // eslint-disable-next-line no-console
+    console.error(`[edition] contact lookup failed: ${e.message}`);
+    return hit ? hit.index : new Map();
+  }
+}
+
+/**
+ * Attach a resolved contact record to each article item as `authorNode`.
+ *
+ * For an article matched to existing CMS content, the real `authors` connection on
+ * that content is higher fidelity than matching the print byline string — pass it in
+ * via `authorsByContentId` and it wins.
+ */
+async function attachAuthors({
+  apollo, siteId, items, authorsByContentId = new Map(),
+}) {
+  const bylined = items.filter((i) => i.kind === 'article' && (i.byline || (i.match && i.match.contentId)));
+  if (!bylined.length) return items;
+
+  const index = await getIndex({ apollo, siteId });
+
+  bylined.forEach((item) => {
+    const matchedId = item.match && item.match.contentId;
+    const fromMatch = matchedId
+      ? getAsArray(authorsByContentId.get(matchedId), 'edges').map((e) => e.node)[0]
+      : null;
+    /* eslint-disable no-param-reassign */
+    item.authorNode = fromMatch || index.get(normalize(item.byline)) || null;
+    if (fromMatch) item.authorSource = 'cms-content-authors';
+    else if (item.authorNode) item.authorSource = 'byline-name-match';
+    else item.authorSource = 'none';
+    /* eslint-enable no-param-reassign */
+  });
+  return items;
+}
+
+module.exports = { attachAuthors, normalize, CONTACTS };

package/lib/entities.js

@@ -0,0 +1,97 @@
+const ns = require('@mindful-web/marko-web-p1-events/utils/create-namespace');
+
+/**
+ * p1events entities for the digital edition.
+ *
+ * One place builds every entity so the templates, the scroll reader and the browser
+ * trackers all describe the same thing the same way. Namespaces come from the p1events
+ * `create-namespace` util (tenant from the process), never a literal — this package
+ * ships to every tenant.
+ *
+ *   issue    base.<tenant>.magazine-issue           id <issueId>
+ *   article  base.<tenant>.digital-edition-article  id <issueId>.<slug>
+ *            refs: issue, content (matched web article), authors
+ *   ad       base.<tenant>.digital-edition-ad       id <issueId>.<adId>
+ *            refs: issue, company (directory match)
+ *
+ * The article's `content` ref is the matched web article (when the ingest matched one),
+ * which is what lets reporting show print-edition reads beside web reads of a story.
+ */
+
+const issueId = (manifest) => String(manifest.issueId);
+const issueName = (manifest) => `${manifest.publication} ${manifest.name}`;
+
+const issueEntity = (manifest) => ({
+  id: issueId(manifest),
+  ns: ns('magazine-issue'),
+  name: issueName(manifest),
+  props: {
+    issueId: issueId(manifest),
+    publication: manifest.publication,
+    issueName: manifest.name,
+    pageCount: manifest.pdf && manifest.pdf.pageCount,
+  },
+});
+
+const issueRef = (manifest) => ({ id: issueId(manifest), ns: ns('magazine-issue'), name: issueName(manifest) });
+
+/** The content type segment of a Mindful content path: /section/article/12345/slug → article. */
+const contentTypeFromPath = (path) => {
+  const m = /\/([a-z-]+)\/\d{5,}(?:\/|$)/.exec(String(path || ''));
+  return m ? m[1] : 'article';
+};
+
+const articleEntity = (manifest, item) => {
+  const match = item.match && item.match.contentId ? item.match : null;
+  const author = item.authorNode && item.authorNode.id ? item.authorNode : null;
+  return {
+    id: `${issueId(manifest)}.${item.slug}`,
+    ns: ns('digital-edition-article'),
+    name: item.headline || item.slug,
+    props: {
+      issueId: issueId(manifest),
+      slug: item.slug,
+      printPage: item.printPage,
+      publication: manifest.publication,
+      issueName: manifest.name,
+      matched: Boolean(match),
+    },
+    refs: {
+      issue: issueRef(manifest),
+      content: match
+        ? { id: String(match.contentId), ns: ns(`content-${contentTypeFromPath(match.path)}`), name: match.contentName || null }
+        : null,
+      authors: author ? [{ id: String(author.id), ns: ns('content-contact'), name: author.name }] : [],
+    },
+  };
+};
+
+const adEntity = (manifest, item, { placement = null } = {}) => ({
+  id: `${issueId(manifest)}.${item.id}`,
+  ns: ns('digital-edition-ad'),
+  name: item.advertiserName || item.id,
+  props: {
+    issueId: issueId(manifest),
+    page: item.printPage,
+    placement,
+    advertiser: item.advertiserName || null,
+    landingUrl: item.landingUrl || null,
+  },
+  refs: {
+    issue: issueRef(manifest),
+    company: item.company && item.company.id
+      ? { id: String(item.company.id), ns: ns('content-company'), name: item.company.name }
+      : null,
+  },
+});
+
+/** The `ns*id` form the p1events link listener reads from `data-p1-entity`. */
+const entityAttr = (entity) => `${entity.ns}*${entity.id}`;
+
+module.exports = {
+  issueEntity,
+  articleEntity,
+  adEntity,
+  entityAttr,
+  contentTypeFromPath,
+};