@scalemule/news-publication 0.0.7

package/dist/index.d.cts

@@ -0,0 +1,317 @@
+import { P as PublicationTheme, a as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, b as NearbyUpdate, c as NewsItem, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './snapshot-BS4hn1dk.cjs';
+export { A as ArticleCitation, e as CategoryRef, f as CouponSettings, g as CoverImageMetadata, h as FEATURE_NAMES, i as FeatureFlags, j as NewsFeed, k as NewsLayoutId, l as PublicationModules, m as PublicationRecord, n as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, o as StoryDisplay, p as SyncSource, q as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-BS4hn1dk.cjs';
+export { M as MEET_ACTIVITIES, a as MeetActivity, b as MeetupInput, P as PreparedMeetup, c as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-5Ym5bxfh.cjs';
+export { C as CLASSIFIED_CATEGORIES, a as ClassifiedCategory, b as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, P as PreparedClassified, c as PreparedJob, d as PublicJob, e as categoryLabel, f as classifiedPath, g as classifiedSearchPath, h as clipChars, i as employmentLabel, j as isClassifiedCategory, k as isEmploymentType, l as jobEmployerBody, m as jobOpeningBody, n as jobPostingBody, p as prepareClassified, o as prepareJobPost, q as publicJobPath, r as publicJobsPath } from './marketplace-Ch7mdJZv.cjs';
+export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.cjs';
+export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-view.cjs';
+import 'react';
+
+/** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
+declare const BROADSHEET_THEME: PublicationTheme;
+declare function featureEnabled(publication: NewsPublication, feature: FeatureName): boolean;
+/**
+ * Build a paper from the Walnut Creek Times defaults.
+ * Identity, towns, and feature flags are the only required differences.
+ */
+declare function definePublication(input: PublicationInput): NewsPublication;
+/** Cookie a reader layout preference is stored in. Absent cookie means the paper default. */
+declare const LAYOUT_COOKIE = "news_publication_layout";
+/**
+ * Crawlers and readers with no cookie get `publication.layout`.
+ * A cookie is honored only when that paper listed the layout.
+ */
+declare function resolveLayout(publication: NewsPublication, cookieValue?: string | null): string;
+
+/**
+ * Walnut Creek Times, the reference paper.
+ * Other papers call `definePublication` with their own name, towns, and flags.
+ * Daily Smile stays off unless a paper opts in: the joke catalog is site content.
+ */
+declare const walnutCreekTimes: NewsPublication;
+
+/**
+ * Cache policy verified on walnutcreektimes.com.
+ * Feeds refresh every 30s, articles every 60s, and the edge holds a page for
+ * 60s with five minutes of stale-while-revalidate. Publishing calls
+ * POST /api/revalidate to drop that wait.
+ */
+declare const NEWS_CACHE: {
+    readonly feedRevalidateSeconds: 30;
+    readonly articleRevalidateSeconds: 60;
+    readonly edgeMaxAgeSeconds: 60;
+    readonly staleWhileRevalidateSeconds: 300;
+    readonly feedTag: "news-feed";
+    readonly articleTag: "news-article";
+    readonly inventoryTag: "public-news-discovery-v2";
+    readonly paths: readonly ["/", "/news"];
+};
+declare const feedCacheOptions: {
+    readonly revalidate: 30;
+    readonly tags: readonly ["news-feed"];
+};
+declare const articleCacheOptions: {
+    readonly revalidate: 60;
+    readonly tags: readonly ["news-article"];
+};
+declare const inventoryCacheOptions: {
+    readonly revalidate: 30;
+    readonly tags: readonly ["news-feed", "public-news-discovery-v2"];
+};
+declare function edgeCacheControl(): string;
+declare function feedCacheKey(publicationId: string, before?: string, section?: string): string;
+declare function articleCacheKey(publicationId: string, slug: string): string;
+declare class NewsError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/** A missing article must 404. Every other failure may serve the last good copy. */
+declare function shouldServeLastKnown(error: unknown): boolean;
+/**
+ * In-memory stale fallback used when the gateway times out or returns 429/5xx.
+ * The Next.js data cache is separate and is configured with `feedCacheOptions`.
+ */
+declare function withLastKnown<T>(store: Map<string, T>, key: string, load: () => Promise<T>, accept?: (value: T) => boolean): Promise<T>;
+declare function secretsMatch(provided: string | null | undefined, secret: string | null | undefined): boolean;
+type RevalidateDecision = {
+    status: number;
+    body: {
+        error: string;
+    } | {
+        revalidated: true;
+        tag: string;
+        path: string;
+        now: number;
+    };
+};
+/** Pure form of POST /api/revalidate. The site route performs the Next.js purge. */
+declare function revalidateDecision(input: {
+    providedSecret: string | null;
+    configuredSecret: string | null;
+    tag?: string | null;
+    path?: string | null;
+    now?: number;
+}): RevalidateDecision;
+/** Tags and paths the default purge clears, including the discovery inventory tag. */
+declare function defaultRevalidateTargets(): {
+    tags: string[];
+    paths: string[];
+};
+
+declare function sectionId(name: string): string;
+declare function sectionPath(name: string): string;
+declare function sectionDefinition(name: string): EditorialSection;
+declare function editorialSections(items: NewsItem[]): EditorialSection[];
+/** Published inventory only. Selection never duplicates or fabricates a story. */
+declare function composeEdition(items: NewsItem[], selection?: HomepageSelection, now?: number): {
+    lead: NewsItem;
+    secondary: NewsItem[];
+    briefs: NewsItem[];
+    compact: NewsItem[];
+    sections: EditorialSection[];
+    navigation: EditorialSection[];
+};
+declare function displayHeadline(article: NewsItem, selection?: HomepageSelection): string;
+/** A complete existing sentence, not a cut-off or generated summary. */
+declare function briefSummary(article: NewsItem, selection?: HomepageSelection): string;
+declare function normalizedText(value: string): string;
+declare function townSlug(town: string): string;
+declare function storyTowns(article: NewsItem, towns: string[], selection?: HomepageSelection): string[];
+declare function matchesStoryTag(article: NewsItem, tag: string): boolean;
+declare function filterNews(items: NewsItem[], filters: {
+    q?: string;
+    town?: string;
+    section?: string;
+    tag?: string;
+}, publication: Pick<NewsPublication, "towns" | "matchTag">, selection?: HomepageSelection): NewsItem[];
+declare function validCalendarDate(value: string): boolean;
+declare function activeNearby(selection?: HomepageSelection, now?: number): NearbyUpdate[];
+declare function nearbyUpdates(items: NewsItem[], selection?: HomepageSelection, now?: number): {
+    article: NewsItem;
+    slug: string;
+    title: string;
+    summary: string;
+    town: string;
+    starts: string;
+    ends?: string;
+}[];
+/** Display-only shortening. Cuts on character boundaries, never on bytes. */
+declare function shortDeck(value: string | null | undefined, limit?: number): string;
+declare function storyDate(value: string): string | null;
+
+/** https URL with no userinfo. Anything else is dropped from public markup. */
+declare function publicHttps(value?: string | null): string | undefined;
+declare function articleUrl(canonical: string, slug: string): string;
+/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    dateModified: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
+    author: {
+        "@type": string;
+        name: string;
+    };
+    publisher: {
+        "@type": string;
+        name: string;
+        url: string;
+    };
+};
+declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    url: string;
+    description: string;
+    areaServed: string[];
+};
+/**
+ * Fields a Next.js `generateMetadata` spreads in.
+ * Preview hosts pass `indexable: false` and stay out of Google.
+ */
+declare function publicationMeta(publication: NewsPublication, canonical: string, indexable: boolean): {
+    title: string;
+    description: string;
+    canonical: string;
+    indexable: boolean;
+    openGraph: {
+        title: string;
+        description: string;
+        url: string;
+        siteName: string;
+        type: "website";
+    };
+};
+declare function articleMeta(publication: NewsPublication, article: NewsArticle, canonical: string, indexable: boolean): {
+    title: string;
+    description: string;
+    canonical: string;
+    indexable: boolean;
+    openGraph: {
+        type: "article";
+        title: string;
+        description: string | undefined;
+        url: string;
+        publishedTime: string;
+        modifiedTime: string;
+        images: string[];
+    };
+};
+/** One line a paper can serve at /llms.txt. Towns and the article path stay explicit. */
+declare function llmsText(publication: NewsPublication, canonical: string): string;
+
+/** Bounded event contract from Walnut Creek Times. Never accept raw form or chat text. */
+declare const ANALYTICS_VERSION = 1;
+declare const ANALYTICS_COOKIE = "napsite_analytics_v1";
+declare const SESSION_IDLE_MS: number;
+declare const UUID: RegExp;
+type Definition = {
+    category: "navigation" | "engagement" | "content" | "conversion" | "system";
+    source: "browser" | "server";
+};
+declare const EVENTS: Record<string, Definition>;
+declare const UTM_FIELDS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_content", "utm_term"];
+type Attribution = Partial<Record<(typeof UTM_FIELDS)[number], string>> & {
+    referrer?: string;
+    landing_page?: string;
+    referral_code?: string;
+};
+declare function shortText(value: unknown, max?: number): string | undefined;
+/** Query strings, fragments, credentials and private paths never reach analytics. */
+declare function publicUrl(value: unknown, originOnly?: boolean): string | undefined;
+declare function attribution(url: string, referrer?: string, publication?: Pick<NewsPublication, "referrals">): Attribution;
+
+/**
+ * Coupon lookup for a paper. No Stripe call lives here.
+ * When `features.coupons` is off, every code resolves to null, including a
+ * configured offer. A paper may replace matching with `coupons.resolve`.
+ */
+declare function resolveCoupon(publication: NewsPublication, code: string | null | undefined): CouponOffer | null;
+declare function referralCode(publication: NewsPublication, url: string): string | null;
+
+type CookieCategory = "essential" | "performance" | "functional" | "advertising";
+interface CookiePreferences {
+    /** Strictly necessary cookies required for core site operation and security. Always true. */
+    essential: true;
+    /** Analytics and performance measurement to improve community coverage and site speed. */
+    performance: boolean;
+    /** Personalization features such as narration audio speed, text sizing, and town filters. */
+    functional: boolean;
+    /** Local sponsorship delivery and partner campaign frequency capping. */
+    advertising: boolean;
+}
+interface CookieConsentRecord {
+    version: 1;
+    preferences: CookiePreferences;
+    timestamp: string;
+    anonymous_id?: string;
+    source: "banner_accept" | "banner_reject" | "settings_save";
+}
+interface CookieDisclosure {
+    name: string;
+    provider: string;
+    purpose: string;
+    duration: string;
+    type: "HTTP Cookie" | "Local Storage" | "Session Storage";
+}
+interface CookieCategoryDefinition {
+    id: CookieCategory;
+    title: string;
+    shortDescription: string;
+    fullDescription: string;
+    required: boolean;
+    cookies: CookieDisclosure[];
+}
+declare const COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
+declare const COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
+declare const COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
+declare const COOKIE_CONSENT_MAX_AGE_SECONDS: number;
+declare const DEFAULT_PREFERENCES_REJECTED: CookiePreferences;
+declare const DEFAULT_PREFERENCES_ACCEPTED: CookiePreferences;
+declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
+/**
+ * Retrieve the current cookie consent record.
+ * Checks HTTP cookie first, then localStorage fallback, then in-memory state.
+ */
+declare function getCookieConsent(): CookieConsentRecord | null;
+/**
+ * Check if the user has already provided an explicit consent decision.
+ */
+declare function hasConsented(): boolean;
+/**
+ * Check if a specific cookie category is currently permitted.
+ * Essential is always permitted.
+ */
+declare function isCategoryAllowed(category: CookieCategory): boolean;
+/**
+ * Record cookie consent choices.
+ * Updates both HTTP cookies, localStorage, and fires a window event.
+ */
+declare function setCookieConsent(preferences: Partial<CookiePreferences>, source?: CookieConsentRecord["source"]): CookieConsentRecord;
+/**
+ * Accepts all cookies (essential, performance, functional, advertising).
+ */
+declare function acceptAllCookies(): CookieConsentRecord;
+/**
+ * Rejects all optional cookies (preserves essential cookies only).
+ */
+declare function rejectOptionalCookies(): CookieConsentRecord;
+/**
+ * Clear consent record (used when resetting choices).
+ */
+declare function clearCookieConsent(): void;
+/**
+ * Forward the user consent choice to ScaleMule compliance service.
+ * Respects customer security boundary: uses relative /api/compliance/consent proxy or client endpoint.
+ */
+declare function recordConsentToCompliance(record: CookieConsentRecord, options?: {
+    endpoint?: string;
+    publicationSlug?: string;
+}): Promise<void>;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -0,0 +1,317 @@
+import { P as PublicationTheme, a as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, b as NearbyUpdate, c as NewsItem, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './snapshot-BS4hn1dk.js';
+export { A as ArticleCitation, e as CategoryRef, f as CouponSettings, g as CoverImageMetadata, h as FEATURE_NAMES, i as FeatureFlags, j as NewsFeed, k as NewsLayoutId, l as PublicationModules, m as PublicationRecord, n as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, o as StoryDisplay, p as SyncSource, q as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-BS4hn1dk.js';
+export { M as MEET_ACTIVITIES, a as MeetActivity, b as MeetupInput, P as PreparedMeetup, c as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-5Ym5bxfh.js';
+export { C as CLASSIFIED_CATEGORIES, a as ClassifiedCategory, b as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, P as PreparedClassified, c as PreparedJob, d as PublicJob, e as categoryLabel, f as classifiedPath, g as classifiedSearchPath, h as clipChars, i as employmentLabel, j as isClassifiedCategory, k as isEmploymentType, l as jobEmployerBody, m as jobOpeningBody, n as jobPostingBody, p as prepareClassified, o as prepareJobPost, q as publicJobPath, r as publicJobsPath } from './marketplace-Ch7mdJZv.js';
+export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.js';
+export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-view.js';
+import 'react';
+
+/** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
+declare const BROADSHEET_THEME: PublicationTheme;
+declare function featureEnabled(publication: NewsPublication, feature: FeatureName): boolean;
+/**
+ * Build a paper from the Walnut Creek Times defaults.
+ * Identity, towns, and feature flags are the only required differences.
+ */
+declare function definePublication(input: PublicationInput): NewsPublication;
+/** Cookie a reader layout preference is stored in. Absent cookie means the paper default. */
+declare const LAYOUT_COOKIE = "news_publication_layout";
+/**
+ * Crawlers and readers with no cookie get `publication.layout`.
+ * A cookie is honored only when that paper listed the layout.
+ */
+declare function resolveLayout(publication: NewsPublication, cookieValue?: string | null): string;
+
+/**
+ * Walnut Creek Times, the reference paper.
+ * Other papers call `definePublication` with their own name, towns, and flags.
+ * Daily Smile stays off unless a paper opts in: the joke catalog is site content.
+ */
+declare const walnutCreekTimes: NewsPublication;
+
+/**
+ * Cache policy verified on walnutcreektimes.com.
+ * Feeds refresh every 30s, articles every 60s, and the edge holds a page for
+ * 60s with five minutes of stale-while-revalidate. Publishing calls
+ * POST /api/revalidate to drop that wait.
+ */
+declare const NEWS_CACHE: {
+    readonly feedRevalidateSeconds: 30;
+    readonly articleRevalidateSeconds: 60;
+    readonly edgeMaxAgeSeconds: 60;
+    readonly staleWhileRevalidateSeconds: 300;
+    readonly feedTag: "news-feed";
+    readonly articleTag: "news-article";
+    readonly inventoryTag: "public-news-discovery-v2";
+    readonly paths: readonly ["/", "/news"];
+};
+declare const feedCacheOptions: {
+    readonly revalidate: 30;
+    readonly tags: readonly ["news-feed"];
+};
+declare const articleCacheOptions: {
+    readonly revalidate: 60;
+    readonly tags: readonly ["news-article"];
+};
+declare const inventoryCacheOptions: {
+    readonly revalidate: 30;
+    readonly tags: readonly ["news-feed", "public-news-discovery-v2"];
+};
+declare function edgeCacheControl(): string;
+declare function feedCacheKey(publicationId: string, before?: string, section?: string): string;
+declare function articleCacheKey(publicationId: string, slug: string): string;
+declare class NewsError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+/** A missing article must 404. Every other failure may serve the last good copy. */
+declare function shouldServeLastKnown(error: unknown): boolean;
+/**
+ * In-memory stale fallback used when the gateway times out or returns 429/5xx.
+ * The Next.js data cache is separate and is configured with `feedCacheOptions`.
+ */
+declare function withLastKnown<T>(store: Map<string, T>, key: string, load: () => Promise<T>, accept?: (value: T) => boolean): Promise<T>;
+declare function secretsMatch(provided: string | null | undefined, secret: string | null | undefined): boolean;
+type RevalidateDecision = {
+    status: number;
+    body: {
+        error: string;
+    } | {
+        revalidated: true;
+        tag: string;
+        path: string;
+        now: number;
+    };
+};
+/** Pure form of POST /api/revalidate. The site route performs the Next.js purge. */
+declare function revalidateDecision(input: {
+    providedSecret: string | null;
+    configuredSecret: string | null;
+    tag?: string | null;
+    path?: string | null;
+    now?: number;
+}): RevalidateDecision;
+/** Tags and paths the default purge clears, including the discovery inventory tag. */
+declare function defaultRevalidateTargets(): {
+    tags: string[];
+    paths: string[];
+};
+
+declare function sectionId(name: string): string;
+declare function sectionPath(name: string): string;
+declare function sectionDefinition(name: string): EditorialSection;
+declare function editorialSections(items: NewsItem[]): EditorialSection[];
+/** Published inventory only. Selection never duplicates or fabricates a story. */
+declare function composeEdition(items: NewsItem[], selection?: HomepageSelection, now?: number): {
+    lead: NewsItem;
+    secondary: NewsItem[];
+    briefs: NewsItem[];
+    compact: NewsItem[];
+    sections: EditorialSection[];
+    navigation: EditorialSection[];
+};
+declare function displayHeadline(article: NewsItem, selection?: HomepageSelection): string;
+/** A complete existing sentence, not a cut-off or generated summary. */
+declare function briefSummary(article: NewsItem, selection?: HomepageSelection): string;
+declare function normalizedText(value: string): string;
+declare function townSlug(town: string): string;
+declare function storyTowns(article: NewsItem, towns: string[], selection?: HomepageSelection): string[];
+declare function matchesStoryTag(article: NewsItem, tag: string): boolean;
+declare function filterNews(items: NewsItem[], filters: {
+    q?: string;
+    town?: string;
+    section?: string;
+    tag?: string;
+}, publication: Pick<NewsPublication, "towns" | "matchTag">, selection?: HomepageSelection): NewsItem[];
+declare function validCalendarDate(value: string): boolean;
+declare function activeNearby(selection?: HomepageSelection, now?: number): NearbyUpdate[];
+declare function nearbyUpdates(items: NewsItem[], selection?: HomepageSelection, now?: number): {
+    article: NewsItem;
+    slug: string;
+    title: string;
+    summary: string;
+    town: string;
+    starts: string;
+    ends?: string;
+}[];
+/** Display-only shortening. Cuts on character boundaries, never on bytes. */
+declare function shortDeck(value: string | null | undefined, limit?: number): string;
+declare function storyDate(value: string): string | null;
+
+/** https URL with no userinfo. Anything else is dropped from public markup. */
+declare function publicHttps(value?: string | null): string | undefined;
+declare function articleUrl(canonical: string, slug: string): string;
+/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    dateModified: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
+    author: {
+        "@type": string;
+        name: string;
+    };
+    publisher: {
+        "@type": string;
+        name: string;
+        url: string;
+    };
+};
+declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
+    "@context": string;
+    "@type": string;
+    name: string;
+    url: string;
+    description: string;
+    areaServed: string[];
+};
+/**
+ * Fields a Next.js `generateMetadata` spreads in.
+ * Preview hosts pass `indexable: false` and stay out of Google.
+ */
+declare function publicationMeta(publication: NewsPublication, canonical: string, indexable: boolean): {
+    title: string;
+    description: string;
+    canonical: string;
+    indexable: boolean;
+    openGraph: {
+        title: string;
+        description: string;
+        url: string;
+        siteName: string;
+        type: "website";
+    };
+};
+declare function articleMeta(publication: NewsPublication, article: NewsArticle, canonical: string, indexable: boolean): {
+    title: string;
+    description: string;
+    canonical: string;
+    indexable: boolean;
+    openGraph: {
+        type: "article";
+        title: string;
+        description: string | undefined;
+        url: string;
+        publishedTime: string;
+        modifiedTime: string;
+        images: string[];
+    };
+};
+/** One line a paper can serve at /llms.txt. Towns and the article path stay explicit. */
+declare function llmsText(publication: NewsPublication, canonical: string): string;
+
+/** Bounded event contract from Walnut Creek Times. Never accept raw form or chat text. */
+declare const ANALYTICS_VERSION = 1;
+declare const ANALYTICS_COOKIE = "napsite_analytics_v1";
+declare const SESSION_IDLE_MS: number;
+declare const UUID: RegExp;
+type Definition = {
+    category: "navigation" | "engagement" | "content" | "conversion" | "system";
+    source: "browser" | "server";
+};
+declare const EVENTS: Record<string, Definition>;
+declare const UTM_FIELDS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_content", "utm_term"];
+type Attribution = Partial<Record<(typeof UTM_FIELDS)[number], string>> & {
+    referrer?: string;
+    landing_page?: string;
+    referral_code?: string;
+};
+declare function shortText(value: unknown, max?: number): string | undefined;
+/** Query strings, fragments, credentials and private paths never reach analytics. */
+declare function publicUrl(value: unknown, originOnly?: boolean): string | undefined;
+declare function attribution(url: string, referrer?: string, publication?: Pick<NewsPublication, "referrals">): Attribution;
+
+/**
+ * Coupon lookup for a paper. No Stripe call lives here.
+ * When `features.coupons` is off, every code resolves to null, including a
+ * configured offer. A paper may replace matching with `coupons.resolve`.
+ */
+declare function resolveCoupon(publication: NewsPublication, code: string | null | undefined): CouponOffer | null;
+declare function referralCode(publication: NewsPublication, url: string): string | null;
+
+type CookieCategory = "essential" | "performance" | "functional" | "advertising";
+interface CookiePreferences {
+    /** Strictly necessary cookies required for core site operation and security. Always true. */
+    essential: true;
+    /** Analytics and performance measurement to improve community coverage and site speed. */
+    performance: boolean;
+    /** Personalization features such as narration audio speed, text sizing, and town filters. */
+    functional: boolean;
+    /** Local sponsorship delivery and partner campaign frequency capping. */
+    advertising: boolean;
+}
+interface CookieConsentRecord {
+    version: 1;
+    preferences: CookiePreferences;
+    timestamp: string;
+    anonymous_id?: string;
+    source: "banner_accept" | "banner_reject" | "settings_save";
+}
+interface CookieDisclosure {
+    name: string;
+    provider: string;
+    purpose: string;
+    duration: string;
+    type: "HTTP Cookie" | "Local Storage" | "Session Storage";
+}
+interface CookieCategoryDefinition {
+    id: CookieCategory;
+    title: string;
+    shortDescription: string;
+    fullDescription: string;
+    required: boolean;
+    cookies: CookieDisclosure[];
+}
+declare const COOKIE_CONSENT_KEY = "sm_cookie_consent_v1";
+declare const COOKIE_CONSENT_BACKUP_KEY = "napsite_cookie_consent_v1";
+declare const COOKIE_CONSENT_EVENT = "scalemule-cookie-consent-change";
+declare const COOKIE_CONSENT_MAX_AGE_SECONDS: number;
+declare const DEFAULT_PREFERENCES_REJECTED: CookiePreferences;
+declare const DEFAULT_PREFERENCES_ACCEPTED: CookiePreferences;
+declare const COOKIE_CATEGORIES: CookieCategoryDefinition[];
+/**
+ * Retrieve the current cookie consent record.
+ * Checks HTTP cookie first, then localStorage fallback, then in-memory state.
+ */
+declare function getCookieConsent(): CookieConsentRecord | null;
+/**
+ * Check if the user has already provided an explicit consent decision.
+ */
+declare function hasConsented(): boolean;
+/**
+ * Check if a specific cookie category is currently permitted.
+ * Essential is always permitted.
+ */
+declare function isCategoryAllowed(category: CookieCategory): boolean;
+/**
+ * Record cookie consent choices.
+ * Updates both HTTP cookies, localStorage, and fires a window event.
+ */
+declare function setCookieConsent(preferences: Partial<CookiePreferences>, source?: CookieConsentRecord["source"]): CookieConsentRecord;
+/**
+ * Accepts all cookies (essential, performance, functional, advertising).
+ */
+declare function acceptAllCookies(): CookieConsentRecord;
+/**
+ * Rejects all optional cookies (preserves essential cookies only).
+ */
+declare function rejectOptionalCookies(): CookieConsentRecord;
+/**
+ * Clear consent record (used when resetting choices).
+ */
+declare function clearCookieConsent(): void;
+/**
+ * Forward the user consent choice to ScaleMule compliance service.
+ * Respects customer security boundary: uses relative /api/compliance/consent proxy or client endpoint.
+ */
+declare function recordConsentToCompliance(record: CookieConsentRecord, options?: {
+    endpoint?: string;
+    publicationSlug?: string;
+}): Promise<void>;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };