@scalemule/news-publication 0.0.7

package/dist/cookie-settings-view.cjs

@@ -0,0 +1,470 @@
+"use client";
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/cookies.ts
+var COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
+var COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
+var COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
+var COOKIE_CONSENT_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
+var DEFAULT_PREFERENCES_REJECTED = {
+  essential: true,
+  performance: false,
+  functional: false,
+  advertising: false
+};
+var DEFAULT_PREFERENCES_ACCEPTED = {
+  essential: true,
+  performance: true,
+  functional: true,
+  advertising: true
+};
+var COOKIE_CATEGORIES = [
+  {
+    id: "essential",
+    title: "Strictly Necessary Cookies",
+    shortDescription: "Essential for site security, navigation, and privacy preference management.",
+    fullDescription: "These cookies are necessary for the website to function properly and securely. They enable core features such as load balancing, CSRF protection, secure session tokens, and remembering your cookie consent choice. Because the site cannot function without them, they cannot be turned off.",
+    required: true,
+    cookies: [
+      {
+        name: "sm_cookie_consent_v1",
+        provider: "First-Party (ScaleMule)",
+        purpose: "Stores your verified cookie privacy and category consent choices.",
+        duration: "1 year",
+        type: "HTTP Cookie"
+      },
+      {
+        name: "napsite_session_v1",
+        provider: "First-Party",
+        purpose: "Maintains session continuity, security tokens, and server routing.",
+        duration: "30 minutes (idle)",
+        type: "Session Storage"
+      },
+      {
+        name: "napsite_preview",
+        provider: "First-Party",
+        purpose: "Verifies preview access permissions when viewing unpublished newsroom editions.",
+        duration: "14 days",
+        type: "HTTP Cookie"
+      }
+    ]
+  },
+  {
+    id: "performance",
+    title: "Performance & Analytics Cookies",
+    shortDescription: "Help us measure reader engagement, story completion, and site reliability.",
+    fullDescription: "These cookies collect anonymous information about how visitors navigate our news publication. They allow us to count article reads, understand scroll depth and reading completion, and identify broken links or slow-loading assets so we can keep our community reporting responsive and fast. All metrics are aggregated and never contain personal information.",
+    required: false,
+    cookies: [
+      {
+        name: "napsite_visitor_v1",
+        provider: "First-Party",
+        purpose: "A randomized anonymous UUIDv7 to count distinct readers without tracking personal identity.",
+        duration: "1 year",
+        type: "Local Storage"
+      },
+      {
+        name: "napsite_analytics_v1",
+        provider: "First-Party",
+        purpose: "Connects reading completion and web vitals to the anonymous session.",
+        duration: "30 minutes",
+        type: "HTTP Cookie"
+      }
+    ]
+  },
+  {
+    id: "functional",
+    title: "Functional & Personalization Cookies",
+    shortDescription: "Remember your reading preferences, text size, and narration audio settings.",
+    fullDescription: "These cookies enable enhanced convenience features designed for readers. They remember your custom text sizing, keep your preferred audio narration playback speed (e.g., 1.0x vs 1.25x), and preserve your local town filters across the front page so you always see news closest to your neighborhood.",
+    required: false,
+    cookies: [
+      {
+        name: "reader_text_size",
+        provider: "First-Party",
+        purpose: "Remembers your preferred reading font size across articles.",
+        duration: "1 year",
+        type: "Local Storage"
+      },
+      {
+        name: "audio_narration_speed",
+        provider: "First-Party",
+        purpose: "Stores your preferred audio player playback rate (e.g. 1.0x, 1.25x).",
+        duration: "1 year",
+        type: "Local Storage"
+      }
+    ]
+  },
+  {
+    id: "advertising",
+    title: "Advertising & Local Sponsorship Cookies",
+    shortDescription: "Support local business sponsors by capping repetition and measuring notices.",
+    fullDescription: "Our journalism is supported by local business sponsors and community partners. These cookies ensure you do not see the same sponsor banner repeatedly (frequency capping) and help local merchants measure whether their announcement reached their community. They never track your activity across unrelated third-party websites or build external advertising profiles.",
+    required: false,
+    cookies: [
+      {
+        name: "napsite_sponsor_cap",
+        provider: "First-Party",
+        purpose: "Prevents repetitive display of identical local business announcements.",
+        duration: "7 days",
+        type: "Local Storage"
+      },
+      {
+        name: "local_sponsor_ref",
+        provider: "First-Party",
+        purpose: "Attributes community inquiries directly to the sponsoring local merchant.",
+        duration: "30 days",
+        type: "Local Storage"
+      }
+    ]
+  }
+];
+var memoryConsent = null;
+function readCookie(name) {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(new RegExp("(?:^|; )" + name.replace(/([.$?*|{}()[\]\\/+^])/g, "\\$1") + "=([^;]*)"));
+  return match ? decodeURIComponent(match[1]) : null;
+}
+function writeCookie(name, value, maxAgeSeconds) {
+  if (typeof document === "undefined") return;
+  const secure = typeof location !== "undefined" && location.protocol === "https:" ? "; Secure" : "";
+  document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=${maxAgeSeconds}; SameSite=Lax${secure}`;
+}
+function getCookieConsent() {
+  if (typeof window === "undefined") return memoryConsent;
+  try {
+    const raw = readCookie(COOKIE_CONSENT_KEY) || readCookie(COOKIE_CONSENT_BACKUP_KEY);
+    if (raw) {
+      const parsed = JSON.parse(raw);
+      if (parsed && parsed.version === 1 && parsed.preferences) {
+        memoryConsent = parsed;
+        return parsed;
+      }
+    }
+    const stored = window.localStorage?.getItem(COOKIE_CONSENT_KEY);
+    if (stored) {
+      const parsed = JSON.parse(stored);
+      if (parsed && parsed.version === 1 && parsed.preferences) {
+        memoryConsent = parsed;
+        return parsed;
+      }
+    }
+  } catch {
+  }
+  return memoryConsent;
+}
+function setCookieConsent(preferences, source = "settings_save") {
+  const mergedPreferences = {
+    essential: true,
+    performance: Boolean(preferences.performance),
+    functional: Boolean(preferences.functional),
+    advertising: Boolean(preferences.advertising)
+  };
+  let anonymous_id;
+  if (typeof window !== "undefined") {
+    try {
+      anonymous_id = window.localStorage?.getItem("napsite_visitor_v1") || void 0;
+    } catch {
+    }
+  }
+  const record = {
+    version: 1,
+    preferences: mergedPreferences,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    anonymous_id,
+    source
+  };
+  memoryConsent = record;
+  const serialized = JSON.stringify(record);
+  writeCookie(COOKIE_CONSENT_KEY, serialized, COOKIE_CONSENT_MAX_AGE_SECONDS);
+  writeCookie(COOKIE_CONSENT_BACKUP_KEY, serialized, COOKIE_CONSENT_MAX_AGE_SECONDS);
+  if (typeof window !== "undefined") {
+    try {
+      window.localStorage?.setItem(COOKIE_CONSENT_KEY, serialized);
+    } catch {
+    }
+    window.dispatchEvent(new CustomEvent(COOKIE_CONSENT_EVENT, { detail: record }));
+  }
+  return record;
+}
+async function recordConsentToCompliance(record, options) {
+  if (typeof window === "undefined") return;
+  const endpoint = options?.endpoint || "/api/compliance/consent";
+  try {
+    const payload = {
+      consent_type: "cookie_policy",
+      granted: record.preferences.performance || record.preferences.advertising,
+      preferences: record.preferences,
+      source: record.source,
+      anonymous_id: record.anonymous_id,
+      timestamp: record.timestamp,
+      url: window.location.href,
+      user_agent: window.navigator.userAgent
+    };
+    if (typeof navigator.sendBeacon === "function") {
+      navigator.sendBeacon(endpoint, new Blob([JSON.stringify(payload)], { type: "application/json" }));
+    } else {
+      await fetch(endpoint, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(payload),
+        keepalive: true
+      });
+    }
+  } catch {
+  }
+}
+function CookieSettingsView({
+  publicationName = "This Publication",
+  region,
+  complianceEndpoint = "/api/compliance/consent",
+  publicationSlug
+}) {
+  const [preferences, setPreferences] = react.useState(() => {
+    const existing = getCookieConsent();
+    return existing ? existing.preferences : { ...DEFAULT_PREFERENCES_ACCEPTED };
+  });
+  const [expandedCategories, setExpandedCategories] = react.useState({
+    essential: false,
+    performance: false,
+    functional: false,
+    advertising: false
+  });
+  const [saveSuccess, setSaveSuccess] = react.useState(false);
+  const [lastSavedTime, setLastSavedTime] = react.useState(null);
+  react.useEffect(() => {
+    const existing = getCookieConsent();
+    if (existing) {
+      setPreferences(existing.preferences);
+      setLastSavedTime(new Date(existing.timestamp).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" }));
+    }
+  }, []);
+  const handleToggle = (category) => {
+    if (category === "essential") return;
+    setPreferences((prev) => ({
+      ...prev,
+      [category]: !prev[category]
+    }));
+    setSaveSuccess(false);
+  };
+  const toggleExpand = (category) => {
+    setExpandedCategories((prev) => ({
+      ...prev,
+      [category]: !prev[category]
+    }));
+  };
+  const handleSave = () => {
+    const record = setCookieConsent(preferences, "settings_save");
+    setSaveSuccess(true);
+    setLastSavedTime(new Date(record.timestamp).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" }));
+    void recordConsentToCompliance(record, {
+      endpoint: complianceEndpoint});
+    window.scrollTo({ top: 0, behavior: "smooth" });
+  };
+  const handleAcceptAll = () => {
+    setPreferences({ ...DEFAULT_PREFERENCES_ACCEPTED });
+    const record = setCookieConsent(DEFAULT_PREFERENCES_ACCEPTED, "settings_save");
+    setSaveSuccess(true);
+    setLastSavedTime(new Date(record.timestamp).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" }));
+    void recordConsentToCompliance(record, {
+      endpoint: complianceEndpoint});
+    window.scrollTo({ top: 0, behavior: "smooth" });
+  };
+  const handleRejectAll = () => {
+    setPreferences({ ...DEFAULT_PREFERENCES_REJECTED });
+    const record = setCookieConsent(DEFAULT_PREFERENCES_REJECTED, "settings_save");
+    setSaveSuccess(true);
+    setLastSavedTime(new Date(record.timestamp).toLocaleTimeString([], { hour: "numeric", minute: "2-digit" }));
+    void recordConsentToCompliance(record, {
+      endpoint: complianceEndpoint});
+    window.scrollTo({ top: 0, behavior: "smooth" });
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-settings-container", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("header", { className: "sm-cookie-settings-header", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-settings-eyebrow", children: [
+        publicationName,
+        " \xB7 Legal & Privacy"
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("h1", { className: "sm-cookie-settings-title", children: "Cookie Settings & Privacy Controls" }),
+      /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "sm-cookie-settings-intro", children: [
+        "We believe in transparent, neighborly community journalism. When you visit ",
+        publicationName,
+        region ? ` across ${region}` : "",
+        ", we use cookies and process device data to ensure the website is secure, reliable, and easy to read. Review our cookie categories below, view detailed technical disclosures, and choose your preferences at any time."
+      ] })
+    ] }),
+    saveSuccess && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-alert-success", role: "status", "aria-live": "polite", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("svg", { width: "20", height: "20", viewBox: "0 0 20 20", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsx(
+        "path",
+        {
+          d: "M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.707l-4.5 4.5a1 1 0 01-1.414 0l-2-2a1 1 0 011.414-1.414L8.5 10.586l3.793-3.793a1 1 0 011.414 1.414z",
+          fill: "currentColor"
+        }
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("strong", { children: "Preferences Saved." }),
+        " Your cookie choices have been updated",
+        lastSavedTime ? ` (at ${lastSavedTime})` : "",
+        " and will be remembered across all community editions."
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-global-actions", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "sm-cookie-btn sm-cookie-btn-secondary",
+          onClick: handleRejectAll,
+          children: "Reject Optional Cookies"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "sm-cookie-btn sm-cookie-btn-secondary",
+          onClick: handleAcceptAll,
+          children: "Accept All Cookies"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          className: "sm-cookie-btn sm-cookie-btn-primary",
+          onClick: handleSave,
+          children: "Save Preferences"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-cookie-category-list", children: COOKIE_CATEGORIES.map((category) => {
+      const isEssential = category.id === "essential";
+      const isChecked = isEssential || preferences[category.id];
+      const isExpanded = expandedCategories[category.id];
+      return /* @__PURE__ */ jsxRuntime.jsxs(
+        "section",
+        {
+          className: "sm-cookie-category-card",
+          "aria-labelledby": `cookie-cat-${category.id}`,
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-category-top", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("h2", { id: `cookie-cat-${category.id}`, className: "sm-cookie-category-heading", children: category.title }),
+              isEssential ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "sm-cookie-badge-required", children: "Always Active" }) : /* @__PURE__ */ jsxRuntime.jsxs(
+                "label",
+                {
+                  className: "sm-cookie-switch-label",
+                  htmlFor: `toggle-${category.id}`,
+                  "aria-label": `Toggle ${category.title}`,
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(
+                      "input",
+                      {
+                        id: `toggle-${category.id}`,
+                        type: "checkbox",
+                        className: "sm-cookie-switch-input",
+                        checked: isChecked,
+                        onChange: () => handleToggle(category.id)
+                      }
+                    ),
+                    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "sm-cookie-switch-slider" })
+                  ]
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "sm-cookie-category-desc", children: category.fullDescription }),
+            /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+              /* @__PURE__ */ jsxRuntime.jsxs(
+                "button",
+                {
+                  type: "button",
+                  className: "sm-cookie-details-toggle",
+                  onClick: () => toggleExpand(category.id),
+                  "aria-expanded": isExpanded,
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(
+                      "svg",
+                      {
+                        width: "14",
+                        height: "14",
+                        viewBox: "0 0 20 20",
+                        fill: "currentColor",
+                        style: {
+                          transform: isExpanded ? "rotate(90deg)" : "rotate(0deg)",
+                          transition: "transform 0.2s ease"
+                        },
+                        "aria-hidden": "true",
+                        children: /* @__PURE__ */ jsxRuntime.jsx(
+                          "path",
+                          {
+                            fillRule: "evenodd",
+                            d: "M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z",
+                            clipRule: "evenodd"
+                          }
+                        )
+                      }
+                    ),
+                    isExpanded ? "Hide cookie disclosures" : `View ${category.cookies.length} cookie disclosures`
+                  ]
+                }
+              ),
+              isExpanded && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-cookie-table-wrapper", children: /* @__PURE__ */ jsxRuntime.jsxs("table", { className: "sm-cookie-table", children: [
+                /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+                  /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Cookie Name" }),
+                  /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Provider" }),
+                  /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Duration" }),
+                  /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Storage Type" }),
+                  /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Purpose" })
+                ] }) }),
+                /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: category.cookies.map((cookie) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+                  /* @__PURE__ */ jsxRuntime.jsx("td", { children: /* @__PURE__ */ jsxRuntime.jsx("code", { className: "sm-cookie-code", children: cookie.name }) }),
+                  /* @__PURE__ */ jsxRuntime.jsx("td", { children: cookie.provider }),
+                  /* @__PURE__ */ jsxRuntime.jsx("td", { children: cookie.duration }),
+                  /* @__PURE__ */ jsxRuntime.jsx("td", { children: cookie.type }),
+                  /* @__PURE__ */ jsxRuntime.jsx("td", { children: cookie.purpose })
+                ] }, cookie.name)) })
+              ] }) })
+            ] })
+          ]
+        },
+        category.id
+      );
+    }) }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-save-bar", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-cookie-save-status", children: lastSavedTime ? `Last saved: today at ${lastSavedTime}` : "No custom preferences saved yet." }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-save-buttons", children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "button",
+          {
+            type: "button",
+            className: "sm-cookie-btn sm-cookie-btn-secondary",
+            onClick: handleRejectAll,
+            children: "Reject Optional"
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "button",
+          {
+            type: "button",
+            className: "sm-cookie-btn sm-cookie-btn-secondary",
+            onClick: handleAcceptAll,
+            children: "Accept All"
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          "button",
+          {
+            type: "button",
+            className: "sm-cookie-btn sm-cookie-btn-primary",
+            onClick: handleSave,
+            children: "Save Preferences"
+          }
+        )
+      ] })
+    ] })
+  ] });
+}
+
+exports.CookieSettingsView = CookieSettingsView;

package/dist/cookie-settings-view.d.cts

@@ -0,0 +1,15 @@
+import react__default from 'react';
+
+interface CookieSettingsViewProps {
+    /** The publication display name (e.g., "San Ramon Times") */
+    publicationName?: string;
+    /** Publication region / coverage context (e.g., "San Ramon Valley, California") */
+    region?: string;
+    /** Compliance endpoint for recording consent. Default: "/api/compliance/consent" */
+    complianceEndpoint?: string;
+    /** Optional publication slug for metadata */
+    publicationSlug?: string;
+}
+declare function CookieSettingsView({ publicationName, region, complianceEndpoint, publicationSlug, }: CookieSettingsViewProps): react__default.JSX.Element;
+
+export { CookieSettingsView, type CookieSettingsViewProps };

package/dist/cookie-settings-view.d.ts

@@ -0,0 +1,15 @@
+import react__default from 'react';
+
+interface CookieSettingsViewProps {
+    /** The publication display name (e.g., "San Ramon Times") */
+    publicationName?: string;
+    /** Publication region / coverage context (e.g., "San Ramon Valley, California") */
+    region?: string;
+    /** Compliance endpoint for recording consent. Default: "/api/compliance/consent" */
+    complianceEndpoint?: string;
+    /** Optional publication slug for metadata */
+    publicationSlug?: string;
+}
+declare function CookieSettingsView({ publicationName, region, complianceEndpoint, publicationSlug, }: CookieSettingsViewProps): react__default.JSX.Element;
+
+export { CookieSettingsView, type CookieSettingsViewProps };

package/dist/cookie-settings-view.js

@@ -0,0 +1,3 @@
+"use client";
+export { CookieSettingsView } from './chunk-R33MJWND.js';
+import './chunk-TJ7RL3PV.js';