@scalemule/news-publication 0.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ScaleMule Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @scalemule/news-publication
+
+Server framework for ScaleMule local news sites. Walnut Creek Times is the reference: broadsheet layout, the 30s/60s news cache, on-demand revalidation, front-page composition, article structured data, and the analytics event contract.
+
+Each paper stays its own site, domain, and ScaleMule application. The package holds the shared behavior. The paper passes its name, towns, theme, layout, and feature flags.
+
+```ts
+import { definePublication, walnutCreekTimes } from "@scalemule/news-publication";
+
+export const publication = walnutCreekTimes;
+
+export const napaGate = definePublication({
+  slug: "napagate",
+  name: "Napa Gate",
+  masthead: ["Napa", "Gate"],
+  region: "Napa Valley",
+  regionLabel: "Napa Valley",
+  towns: ["Napa", "Yountville", "St. Helena"],
+  description: "Local stories from Napa Valley.",
+  layout: "napagate",
+  layouts: ["napagate", "broadsheet"],
+  theme: { accent: "#6b2d5b" },
+  features: { referrals: true, coupons: true },
+});
+```
+
+`resolveLayout(publication, cookie)` returns the paper default for crawlers and readers with no cookie. A reader preference is kept only when that paper listed the layout in `layouts`. The cookie name is `news_publication_layout`.
+
+## Config sync
+
+The application record is the source of truth. The site stores the last accepted copy in `publication.snapshot.json` and ships that file with the deployment. `syncPublicationFile` from `@scalemule/news-publication/snapshot-file` writes a new file only after a complete record for that paper arrives. The main package entry stays free of Node file APIs so client components can import it. A timeout, a 500, a truncated body, or another paper's payload leaves the file untouched.
+
+That snapshot does not expire. A paper whose application API is unreachable for several days, including across restarts, keeps serving the last synced name, towns, theme, and flags. The result reports `source: "retained"` and how old the snapshot is, so the outage can be logged. The only paper that cannot render is one that has never synced.
+
+Code hooks such as `matchTag` are attached in the site after the snapshot loads. They are not part of the stored file.
+
+## What a paper turns on
+
+| Flag | Default | Meaning |
+|---|---|---|
+| `smile` | off, on for Walnut Creek Times | Mount the paper's Daily Smile module |
+| `comments` | off | Article discussion thread |
+| `chat` | off | Town room, same discussions service |
+| `jobs`, `classifieds` | off | Boards for that paper |
+| `referrals` | off | Read a `ref` code (or `referrals.queryParam`) into analytics |
+| `coupons` | off | Resolve `coupons.offers` or a paper-supplied `coupons.resolve` |
+
+Referrals and coupons do not call Billing. `resolveCoupon` returns the offer the paper configured, or null when the flag is off. The checkout call stays in the site, using that paper's API key.
+
+`matchTag` replaces the generic tag matcher when a paper has its own neighborhood rules. `modules.home` and `modules.articleEnd` name site-owned blocks the paper renders.
+
+## Cache
+
+`NEWS_CACHE` is the policy verified on walnutcreektimes.com.
+
+- Feeds revalidate every 30 seconds (`feedCacheOptions`).
+- Articles revalidate every 60 seconds (`articleCacheOptions`).
+- `edgeCacheControl()` is `public, s-maxage=60, stale-while-revalidate=300`.
+- `withLastKnown` returns the last good feed or article when the gateway fails, and still throws on a 404.
+- `revalidateDecision` is the authorization and response body for `POST /api/revalidate`. The route then purges `defaultRevalidateTargets()`.
+
+## Search
+
+`newsArticleJsonLd`, `publicationJsonLd`, `publicationMeta`, and `articleMeta` are the fields the paper puts on its pages. `llmsText` is the body for `/llms.txt`. Preview hosts pass `indexable: false`.
+
+## Type
+
+Import `@scalemule/news-publication/tokens.css` on the publication shell. Headlines use `--font-editorial` at every width, and navigation uses `--font-inter`. The site loads those faces. Override `--pub-accent` or `--pub-serif` on `.publication` for a paper that should not match the broadsheet palette.
+
+The React front page still lives in the Walnut Creek Times repository. This package is the server contract those components move onto, so a font, cache, or schema fix ships once and each paper picks it up by version.
+
+## Versioning
+
+Patch only (`0.0.x` or `0.1.x`) until a stable release is explicitly approved. Publishing is manual: `npm publish` from this directory.

package/cookie-consent.css

@@ -0,0 +1,419 @@
+/* ScaleMule News Publication - Tesla-Style Cookie Consent & Settings */
+
+/* ==========================================================================
+   Cookie Banner (Floating Bottom Card)
+   ========================================================================== */
+
+.sm-cookie-banner-wrapper {
+  position: fixed;
+  bottom: 1.25rem;
+  left: 1rem;
+  right: 1rem;
+  z-index: 9999;
+  display: flex;
+  justify-content: center;
+  pointer-events: none;
+  animation: sm-cookie-slide-up 0.35s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+}
+
+@keyframes sm-cookie-slide-up {
+  from {
+    opacity: 0;
+    transform: translateY(1.5rem);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+.sm-cookie-banner-card {
+  pointer-events: auto;
+  max-width: 1100px;
+  width: 100%;
+  background: rgba(255, 255, 255, 0.96);
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  border: 1px solid rgba(0, 0, 0, 0.1);
+  box-shadow: 0 20px 40px -15px rgba(0, 0, 0, 0.15), 0 0 0 1px rgba(0, 0, 0, 0.05);
+  border-radius: 14px;
+  padding: 1.5rem 1.75rem;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 2rem;
+  box-sizing: border-box;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  color: #171a20;
+}
+
+.sm-cookie-banner-content {
+  flex: 1 1 auto;
+}
+
+.sm-cookie-banner-title {
+  margin: 0 0 0.4rem 0;
+  font-size: 1.15rem;
+  font-weight: 600;
+  letter-spacing: -0.015em;
+  color: #11141a;
+  line-height: 1.3;
+}
+
+.sm-cookie-banner-text {
+  margin: 0;
+  font-size: 0.9rem;
+  line-height: 1.45;
+  color: #393c41;
+}
+
+.sm-cookie-banner-link {
+  color: #171a20;
+  text-decoration: underline;
+  text-underline-offset: 3px;
+  font-weight: 500;
+  transition: opacity 0.15s ease;
+  cursor: pointer;
+}
+
+.sm-cookie-banner-link:hover {
+  opacity: 0.75;
+}
+
+.sm-cookie-banner-actions {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  flex-shrink: 0;
+}
+
+.sm-cookie-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.65rem 1.5rem;
+  font-size: 0.88rem;
+  font-weight: 600;
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.18s ease;
+  text-decoration: none;
+  border: 1px solid transparent;
+  white-space: nowrap;
+  user-select: none;
+  outline: none;
+}
+
+.sm-cookie-btn:focus-visible {
+  box-shadow: 0 0 0 3px rgba(30, 90, 220, 0.4);
+}
+
+.sm-cookie-btn-primary {
+  background: #171a20;
+  color: #ffffff;
+  border-color: #171a20;
+}
+
+.sm-cookie-btn-primary:hover {
+  background: #2b303a;
+  border-color: #2b303a;
+}
+
+.sm-cookie-btn-secondary {
+  background: transparent;
+  color: #171a20;
+  border-color: #d0d1d2;
+}
+
+.sm-cookie-btn-secondary:hover {
+  background: rgba(0, 0, 0, 0.04);
+  border-color: #171a20;
+}
+
+@media (max-width: 820px) {
+  .sm-cookie-banner-card {
+    flex-direction: column;
+    align-items: stretch;
+    gap: 1.25rem;
+    padding: 1.25rem;
+  }
+
+  .sm-cookie-banner-actions {
+    justify-content: flex-end;
+  }
+
+  .sm-cookie-btn {
+    flex: 1 1 auto;
+  }
+}
+
+/* ==========================================================================
+   Cookie Settings Page (Full Privacy Controls)
+   ========================================================================== */
+
+.sm-cookie-settings-container {
+  max-width: 900px;
+  margin: 0 auto;
+  padding: 2.5rem 1.5rem 5rem 1.5rem;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  color: #171a20;
+}
+
+.sm-cookie-settings-header {
+  margin-bottom: 2.5rem;
+}
+
+.sm-cookie-settings-eyebrow {
+  font-size: 0.85rem;
+  font-weight: 600;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: #5c5e62;
+  margin-bottom: 0.5rem;
+}
+
+.sm-cookie-settings-title {
+  font-size: 2.25rem;
+  font-weight: 700;
+  letter-spacing: -0.025em;
+  margin: 0 0 1rem 0;
+  line-height: 1.15;
+  color: #11141a;
+}
+
+.sm-cookie-settings-intro {
+  font-size: 1.05rem;
+  line-height: 1.6;
+  color: #393c41;
+  margin: 0;
+}
+
+/* Alert Notification Toast */
+.sm-cookie-alert-success {
+  background: #eef8f1;
+  border: 1px solid #c2e9cd;
+  color: #166434;
+  padding: 1rem 1.25rem;
+  border-radius: 10px;
+  font-size: 0.95rem;
+  margin-bottom: 2rem;
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  animation: sm-cookie-fade-in 0.25s ease-out;
+}
+
+@keyframes sm-cookie-fade-in {
+  from { opacity: 0; transform: translateY(-6px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+/* Global Actions Bar (Top) */
+.sm-cookie-global-actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 0.75rem;
+  margin-bottom: 2rem;
+  padding-bottom: 1.25rem;
+  border-bottom: 1px solid #e2e4e6;
+}
+
+/* Category Cards */
+.sm-cookie-category-list {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  margin-bottom: 3rem;
+}
+
+.sm-cookie-category-card {
+  background: #ffffff;
+  border: 1px solid #e2e4e6;
+  border-radius: 12px;
+  padding: 1.5rem;
+  transition: border-color 0.2s ease, box-shadow 0.2s ease;
+}
+
+.sm-cookie-category-card:hover {
+  border-color: #cbcfd4;
+}
+
+.sm-cookie-category-top {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 1.5rem;
+  margin-bottom: 0.75rem;
+}
+
+.sm-cookie-category-heading {
+  margin: 0;
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: #171a20;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.sm-cookie-category-desc {
+  font-size: 0.95rem;
+  line-height: 1.55;
+  color: #4b4f56;
+  margin: 0 0 1rem 0;
+}
+
+.sm-cookie-badge-required {
+  background: #f0f1f3;
+  color: #393c41;
+  font-size: 0.78rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  padding: 0.35rem 0.65rem;
+  border-radius: 6px;
+  white-space: nowrap;
+}
+
+/* iOS / Tesla style Toggle Switch */
+.sm-cookie-switch-label {
+  position: relative;
+  display: inline-block;
+  width: 48px;
+  height: 28px;
+  flex-shrink: 0;
+  cursor: pointer;
+}
+
+.sm-cookie-switch-input {
+  opacity: 0;
+  width: 0;
+  height: 0;
+}
+
+.sm-cookie-switch-slider {
+  position: absolute;
+  cursor: pointer;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background-color: #d1d5db;
+  transition: 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+  border-radius: 28px;
+}
+
+.sm-cookie-switch-slider:before {
+  position: absolute;
+  content: "";
+  height: 22px;
+  width: 22px;
+  left: 3px;
+  bottom: 3px;
+  background-color: white;
+  transition: 0.25s cubic-bezier(0.4, 0, 0.2, 1);
+  border-radius: 50%;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+}
+
+.sm-cookie-switch-input:checked + .sm-cookie-switch-slider {
+  background-color: #171a20;
+}
+
+.sm-cookie-switch-input:focus-visible + .sm-cookie-switch-slider {
+  box-shadow: 0 0 0 3px rgba(30, 90, 220, 0.35);
+}
+
+.sm-cookie-switch-input:checked + .sm-cookie-switch-slider:before {
+  transform: translateX(20px);
+}
+
+.sm-cookie-switch-input:disabled + .sm-cookie-switch-slider {
+  opacity: 0.6;
+  cursor: not-allowed;
+}
+
+/* Disclosure Table */
+.sm-cookie-details-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.35rem;
+  background: none;
+  border: none;
+  padding: 0;
+  font-size: 0.88rem;
+  font-weight: 500;
+  color: #1e5adc;
+  cursor: pointer;
+  text-decoration: none;
+}
+
+.sm-cookie-details-toggle:hover {
+  text-decoration: underline;
+}
+
+.sm-cookie-table-wrapper {
+  margin-top: 1rem;
+  overflow-x: auto;
+  border: 1px solid #eaedf0;
+  border-radius: 8px;
+}
+
+.sm-cookie-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.85rem;
+  text-align: left;
+}
+
+.sm-cookie-table th {
+  background: #f7f8f9;
+  padding: 0.65rem 0.9rem;
+  font-weight: 600;
+  color: #5c5e62;
+  border-bottom: 1px solid #eaedf0;
+}
+
+.sm-cookie-table td {
+  padding: 0.65rem 0.9rem;
+  border-bottom: 1px solid #eaedf0;
+  color: #2b303a;
+  vertical-align: top;
+}
+
+.sm-cookie-table tr:last-child td {
+  border-bottom: none;
+}
+
+.sm-cookie-code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-size: 0.8rem;
+  background: #f0f2f5;
+  padding: 0.15rem 0.35rem;
+  border-radius: 4px;
+  color: #11141a;
+}
+
+/* Bottom Save Sticky Bar */
+.sm-cookie-save-bar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  flex-wrap: wrap;
+  gap: 1rem;
+  padding: 1.5rem 0;
+  border-top: 1px solid #e2e4e6;
+}
+
+.sm-cookie-save-status {
+  font-size: 0.88rem;
+  color: #5c5e62;
+}
+
+.sm-cookie-save-buttons {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+}

package/dist/chunk-C7JTEHTH.js

@@ -0,0 +1,158 @@
+// src/types.ts
+var FEATURE_NAMES = [
+  "smile",
+  "comments",
+  "chat",
+  "jobs",
+  "classifieds",
+  "referrals",
+  "coupons"
+];
+
+// src/config.ts
+var BROADSHEET_THEME = {
+  accent: "#bb171d",
+  ink: "#171917",
+  paper: "#ffffff",
+  sponsor: "#173d32"
+};
+var DISABLED_FEATURES = {
+  smile: false,
+  comments: false,
+  chat: false,
+  jobs: false,
+  classifieds: false,
+  referrals: false,
+  coupons: false
+};
+function featureEnabled(publication, feature) {
+  return publication.features[feature] === true;
+}
+function definePublication(input) {
+  if (!input.slug.trim() || !input.name.trim()) throw new Error("A publication needs a slug and a name");
+  if (!input.towns.length) throw new Error("A publication needs at least one covered town");
+  const layout = input.layout ?? "broadsheet";
+  const layouts = [.../* @__PURE__ */ new Set([layout, ...input.layouts ?? ["broadsheet"]])];
+  const referralsEnabled = input.features?.referrals === true || input.referrals?.enabled === true;
+  const couponsEnabled = input.features?.coupons === true || input.coupons?.enabled === true;
+  const features = { ...DISABLED_FEATURES, ...input.features, referrals: referralsEnabled, coupons: couponsEnabled };
+  for (const name of FEATURE_NAMES) features[name] = features[name] === true;
+  return {
+    slug: input.slug,
+    name: input.name,
+    masthead: input.masthead.length ? input.masthead : [input.name],
+    region: input.region,
+    regionLabel: input.regionLabel,
+    towns: input.towns,
+    nearbyTowns: input.nearbyTowns ?? [],
+    sections: input.sections ?? [],
+    description: input.description,
+    tagline: input.tagline ?? "Local stories. Close to home.",
+    briefTitle: input.briefTitle ?? `${input.regionLabel} in Brief`,
+    parent: input.parent === true,
+    layout,
+    layouts,
+    features,
+    theme: { ...BROADSHEET_THEME, ...input.theme },
+    referrals: { queryParam: input.referrals?.queryParam?.trim() || "ref", enabled: referralsEnabled },
+    coupons: { enabled: couponsEnabled, offers: input.coupons?.offers ?? [], resolve: input.coupons?.resolve },
+    modules: input.modules ?? {},
+    matchTag: input.matchTag
+  };
+}
+var LAYOUT_COOKIE = "news_publication_layout";
+function resolveLayout(publication, cookieValue) {
+  const requested = cookieValue?.trim();
+  if (requested && publication.layouts.includes(requested)) return requested;
+  return publication.layout;
+}
+
+// src/snapshot.ts
+var SNAPSHOT_VERSION = 1;
+function publicationRecord(publication) {
+  return {
+    slug: publication.slug,
+    name: publication.name,
+    masthead: publication.masthead,
+    region: publication.region,
+    regionLabel: publication.regionLabel,
+    towns: publication.towns,
+    nearbyTowns: publication.nearbyTowns,
+    sections: publication.sections,
+    description: publication.description,
+    tagline: publication.tagline,
+    briefTitle: publication.briefTitle,
+    parent: publication.parent,
+    layout: publication.layout,
+    layouts: publication.layouts,
+    features: publication.features,
+    theme: publication.theme,
+    referrals: publication.referrals,
+    coupons: { enabled: publication.coupons.enabled, offers: publication.coupons.offers },
+    modules: publication.modules
+  };
+}
+function snapshotFromRecord(record, syncedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  const publication = definePublication(record);
+  return { version: SNAPSHOT_VERSION, syncedAt, record: publicationRecord(publication) };
+}
+function parseSnapshot(raw) {
+  try {
+    return acceptSnapshot(JSON.parse(raw));
+  } catch {
+    return null;
+  }
+}
+function acceptSnapshot(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const snapshot = value;
+  if (snapshot.version !== SNAPSHOT_VERSION || typeof snapshot.syncedAt !== "string") return null;
+  if (!Number.isFinite(Date.parse(snapshot.syncedAt))) return null;
+  try {
+    return snapshotFromRecord(snapshot.record, snapshot.syncedAt);
+  } catch {
+    return null;
+  }
+}
+function acceptRemoteRecord(value, expectedSlug) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const body = value;
+  const candidate = body.record ?? body.publication ?? value;
+  try {
+    const publication = definePublication(candidate);
+    if (expectedSlug && publication.slug !== expectedSlug) return null;
+    return publicationRecord(publication);
+  } catch {
+    return null;
+  }
+}
+function publicationFromSnapshot(snapshot, hooks = {}) {
+  return definePublication({
+    ...snapshot.record,
+    matchTag: hooks.matchTag,
+    coupons: { ...snapshot.record.coupons, resolve: hooks.resolveCoupon }
+  });
+}
+async function syncPublication(input) {
+  const now = input.now ?? Date.now();
+  try {
+    const remote = acceptRemoteRecord(await input.fetchRecord(), input.expectedSlug);
+    if (remote) {
+      const snapshot = snapshotFromRecord(remote, new Date(now).toISOString());
+      return { publication: publicationFromSnapshot(snapshot, input.hooks), snapshot, source: "fresh", ageMs: 0 };
+    }
+  } catch {
+  }
+  if (!input.previous) {
+    throw new Error("This paper has no synced publication config");
+  }
+  const ageMs = Math.max(0, now - Date.parse(input.previous.syncedAt));
+  return {
+    publication: publicationFromSnapshot(input.previous, input.hooks),
+    snapshot: input.previous,
+    source: "retained",
+    ageMs
+  };
+}
+
+export { BROADSHEET_THEME, FEATURE_NAMES, LAYOUT_COOKIE, acceptRemoteRecord, acceptSnapshot, definePublication, featureEnabled, parseSnapshot, publicationFromSnapshot, publicationRecord, resolveLayout, snapshotFromRecord, syncPublication };