@nakedcreativity/cee-ms-node 2.0.0-beta.5 → 2.0.0-beta.7

package/lib/interfaces.d.ts

@@ -3,6 +3,7 @@ import type express from 'express';
 import type { Context, FilterImplOptions } from 'liquidjs';
 export declare enum CacheSource {
     Local = 0,
+    /** The bucket, read with the host's own AWS credentials (`cacheBucket`, `cacheRegion`). */
     S3 = 1
 }
 export interface CeemsConfig {
@@ -18,9 +19,11 @@ export interface CeemsConfig {
     cacheRegion?: string;
     cacheFolder?: string;
     /**
-     * Where Cee.ms 2 publishes in the bucket or folder: `ceems/` by default, so it can publish to the same bucket
-     * as Cee.ms 1 (which writes `pages/` and `data/` at the top) while a site moves over. `''` reads from the top.
+     * The environment this renderer serves: published files are read from `<environment>/` in the bucket or
+     * folder. Defaults to the `CEEMS_ENVIRONMENT` environment variable, then `development`.
      */
+    environment?: string;
+    /** Where published files are read from in the bucket or folder: `<environment>/` unless set. */
     cachePrefix?: string;
     whitelistedCookies?: Array<string>;
     tags?: Array<LiquidTag>;
@@ -76,6 +79,83 @@ export interface CeemsSite {
      */
     settings?: Record<string, any>;
     collections?: any;
+    /**
+     * Every published page by id (absent for sites last published before it): page links read their address from here when the page
+     * renders, so a renamed or moved page is right everywhere once it is published. A link to a page that
+     * isn't here is broken.
+     */
+    pageIndex?: Record<string, CeemsPageIndexEntry>;
+    /** The documents published content uses, by id, read by document links and values as the page renders. */
+    documents?: Record<string, CeemsPublishedDocument>;
+    /** The site's People by row id, for bylines, profile pages and row fields. */
+    people?: Record<string, CeemsPerson>;
+}
+/** A person from the site's People, in `site.json` `people`. Sites may add columns of their own. */
+export interface CeemsPerson {
+    name: string;
+    jobTitle?: string;
+    photo?: CeemsImage;
+    /** Rich text. */
+    bio?: string;
+    links?: {
+        url: string;
+    }[];
+    /** `links` as addresses, for structured data. */
+    sameAs: string[];
+    email?: string;
+    telephone?: string;
+    /** Their profile page, if they have one. */
+    profile?: {
+        kind: 'page';
+        pageId: string;
+        url: string;
+    };
+    [column: string]: unknown;
+}
+/** A byline author, as published: a person from People, someone typed in, or the organisation. */
+export type CeemsBylineAuthor = {
+    kind: 'person';
+    collectionId: string;
+    rowId: string;
+} | {
+    kind: 'guest';
+    name: string;
+    url?: string;
+    jobTitle?: string;
+} | {
+    kind: 'organisation';
+};
+/** A published page, in `site.json` `pageIndex`. */
+export interface CeemsPageIndexEntry {
+    /** Its address, e.g. `/about/team`, or `/` for the home page. */
+    path: string;
+    name: string;
+}
+export interface CeemsDocumentInfo {
+    numpages?: number;
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+}
+/** A library document, in `site.json` `documents`. */
+export interface CeemsPublishedDocument {
+    url: string;
+    thumbnail?: string;
+    info?: CeemsDocumentInfo;
+}
+/** A published `data/<id>.json`. */
+export interface CeemsDataFile {
+    _id: string;
+    name: string;
+    slug: string;
+    columns: any[];
+    /** Each row's values, in order: as Cee.ms 1 published them. */
+    data: Record<string, any>[];
+    /** The same rows with their ids, for row references. Absent for data last published before it. */
+    rows?: ({
+        _id: string;
+    } & Record<string, any>)[];
 }
 /** The published `site.json` `site`. */
 export interface CeemsSiteInfo {
@@ -90,6 +170,10 @@ export interface CeemsSiteInfo {
         faqModules?: Record<string, FaqModuleMapping>;
         /** For module types holding reviews, which attach to a product or event page. */
         reviewModules?: Record<string, ReviewsModuleMapping>;
+        /** For module types featuring people: their row field to People, by module config type. */
+        peopleModules?: Record<string, {
+            field: string;
+        }>;
     };
     [key: string]: any;
 }
@@ -100,7 +184,7 @@ export type StructuredDataType = 'WEBSITE' | 'WEBPAGE' | 'BREADCRUMB' | 'ORGANIS
  * `HOME` is the site's front page, which by default carries the site and organisation. Templates and modules
  * can read it, e.g. `{% if page.entity == 'PRODUCT' %}`.
  */
-export type PageEntity = 'HOME' | 'PAGE' | 'PRODUCT' | 'EVENT' | 'PERSON' | 'SERVICE';
+export type PageEntity = 'HOME' | 'PAGE' | 'ARTICLE' | 'PRODUCT' | 'EVENT' | 'PERSON' | 'SERVICE';
 /** The types each kind of page outputs unless it chooses its own. */
 export interface StructuredDataDefaults {
     home: StructuredDataType[];
@@ -244,12 +328,23 @@ export interface CeemsPage {
     type?: 'blog' | 'article';
     /** Published from Cee.ms with the default resolved: `HOME` for the home page, else `PAGE`. */
     entity?: PageEntity;
+    /** The site's own page type, such as `property`, by key. Its `entity` is the type's base. */
+    pageType?: string;
     tags?: string[];
     /** An article's date. */
     date?: string;
     publishedAt?: string;
     updatedAt?: string;
     structuredData?: CeemsPageStructuredData;
+    /** An article's byline, as published. Templates read `page.authors`. */
+    byline?: {
+        authors: CeemsBylineAuthor[];
+        reviewedBy?: unknown;
+    };
+    /** For entity `PERSON`: the person whose profile page it is, as a `RowDrop` once loaded. */
+    person?: unknown;
+    /** The byline, resolved (see `bylineAuthors`): people, guests and the organisation, in order. */
+    authors?: Record<string, unknown>[];
     [key: string]: any;
 }
 export interface CeemsRegion {

package/lib/interfaces.js

@@ -4,6 +4,7 @@ exports.CacheSource = void 0;
 var CacheSource;
 (function (CacheSource) {
     CacheSource[CacheSource["Local"] = 0] = "Local";
+    /** The bucket, read with the host's own AWS credentials (`cacheBucket`, `cacheRegion`). */
     CacheSource[CacheSource["S3"] = 1] = "S3";
 })(CacheSource || (exports.CacheSource = CacheSource = {}));
 //# sourceMappingURL=interfaces.js.map

package/lib/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;;AAIA,IAAY,WAGX;AAHD,WAAY,WAAW;IACnB,+CAAK,CAAA;IACL,yCAAE,CAAA;AACN,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;;AAIA,IAAY,WAIX;AAJD,WAAY,WAAW;IACnB,+CAAK,CAAA;IACL,2FAA2F;IAC3F,yCAAE,CAAA;AACN,CAAC,EAJW,WAAW,2BAAX,WAAW,QAItB"}

package/lib/links.d.ts

@@ -1,9 +1,24 @@
 import { Drop } from 'liquidjs';
+import type { CeemsDataFile, CeemsDocumentInfo, CeemsPageIndexEntry, CeemsPublishedDocument, CeemsSite } from './interfaces';
+/**
+ * What references resolve against when a page renders: the published pages and documents from `site.json`,
+ * and the rows of the data collections the page points at. Each is published once, so a renamed page or an
+ * edited row is right everywhere as soon as that one change is published. A site published before Cee.ms
+ * sent these has none of them, and links read their stored address as before.
+ */
+export interface LinkContext {
+    pageIndex?: Record<string, CeemsPageIndexEntry>;
+    documents?: Record<string, CeemsPublishedDocument>;
+    /** A row by collection and row id, or undefined if it isn't published (or was deleted). */
+    row?: (collectionId: string, rowId: string) => Record<string, unknown> | undefined;
+}
 /**
  * A stored link value in templates. It reads as its address, so a field that held a URL string and became a
  * link field still works where templates print it (`{{ item.url }}`), filter it (`| escape`, `| append`),
  * compare it (`== '/about'`, `!= blank`) or measure it (`| size`); and its parts are there too
  * (`{{ item.url.kind }}`, `.pageId`, `.anchor`). `| json` shows the whole link.
+ *
+ * A page link whose page isn't published reads as `''`, with `broken` true, so `{% if link %}` leaves it out.
  */
 export declare class LinkDrop extends Drop {
     kind: string;
@@ -12,6 +27,7 @@ export declare class LinkDrop extends Drop {
     documentId?: string;
     anchor?: string;
     email?: string;
+    broken?: boolean;
     constructor(link: Record<string, unknown>);
     valueOf(): string;
     toString(): string;
@@ -21,5 +37,54 @@ export declare class LinkDrop extends Drop {
     get size(): number;
     toJSON(): Record<string, unknown>;
 }
-/** Wraps every stored link in a published page, data file or draft in a `LinkDrop`, in place. */
-export declare function wrapLinks<T>(value: T): T;
+/**
+ * A document value (`{ documentId, url, thumbnail, info }`) in templates, read from the published documents
+ * so a replaced file is right everywhere. It prints as its address, so `{{ download }}` and
+ * `{{ download.url }}` both work.
+ */
+export declare class DocumentDrop extends Drop {
+    documentId?: string;
+    url: string;
+    thumbnail?: string;
+    info?: CeemsDocumentInfo;
+    constructor(value: Record<string, unknown>);
+    valueOf(): string;
+    toString(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * A row of a data collection, from a `row` field: its columns by key (`{{ author.name }}`,
+ * `{% image person.photo 'square' %}`), plus `_id`. It prints as its `name`, else its first text value.
+ */
+export declare class RowDrop extends Drop {
+    _id: string;
+    [column: string]: unknown;
+    constructor(row: Record<string, unknown>);
+    toString(): string;
+    valueOf(): string;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Rich text links carry the page they point at (`data-page-id`); their `href` comes from the published page,
+ * keeping any `#anchor`, and is dropped when that page isn't published. Documents' come from `documents`.
+ */
+export declare function resolveRichText(html: string, context: LinkContext): string;
+/**
+ * Wraps every stored link in a published page, data file or draft in a `LinkDrop`, every document value in a
+ * `DocumentDrop` and every row reference in a `RowDrop`, in place, resolving each against `context`. A row
+ * that isn't published reads as nothing, and is left out of lists.
+ */
+export declare function wrapLinks<T>(value: T, context?: LinkContext, depth?: number): T;
+/** The rows a page's row references and byline authors point at, by collection id. */
+export declare function referencedRows(value: unknown, found?: Map<string, Set<string>>): Map<string, Set<string>>;
+/**
+ * The context for a site and the data files its page points at. People come from `site.json` `people` (with
+ * `sameAs`), so a person reads the same wherever they are referenced.
+ */
+export declare function linkContextFor(site: CeemsSite | undefined, files?: Iterable<CeemsDataFile | null>): LinkContext;
+/**
+ * An article's byline as templates and structured data read it, in order: `page.authors`. A person is their
+ * People row (`{{ author.name }}`, `{{ author.profile }}`); a guest is what was typed; the organisation is the
+ * site's. Each has `kind`, `name` and `url` (a person's profile page, else their first profile link).
+ */
+export declare function bylineAuthors(page: Record<string, any>, site: CeemsSite | undefined, context: LinkContext): Record<string, unknown>[];

package/lib/links.js

@@ -1,7 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkDrop = void 0;
+exports.RowDrop = exports.DocumentDrop = exports.LinkDrop = void 0;
+exports.resolveRichText = resolveRichText;
 exports.wrapLinks = wrapLinks;
+exports.referencedRows = referencedRows;
+exports.linkContextFor = linkContextFor;
+exports.bylineAuthors = bylineAuthors;
 const liquidjs_1 = require("liquidjs");
 /** The kinds of link Cee.ms stores: `{ kind, url, pageId?, documentId?, anchor?, email? }`. */
 const LINK_KINDS = ['url', 'page', 'document', 'anchor', 'email'];
@@ -10,6 +14,8 @@ const LINK_KINDS = ['url', 'page', 'document', 'anchor', 'email'];
  * link field still works where templates print it (`{{ item.url }}`), filter it (`| escape`, `| append`),
  * compare it (`== '/about'`, `!= blank`) or measure it (`| size`); and its parts are there too
  * (`{{ item.url.kind }}`, `.pageId`, `.anchor`). `| json` shows the whole link.
+ *
+ * A page link whose page isn't published reads as `''`, with `broken` true, so `{% if link %}` leaves it out.
  */
 class LinkDrop extends liquidjs_1.Drop {
     kind;
@@ -18,6 +24,7 @@ class LinkDrop extends liquidjs_1.Drop {
     documentId;
     anchor;
     email;
+    broken;
     constructor(link) {
         super();
         Object.assign(this, link);
@@ -41,21 +48,208 @@ class LinkDrop extends liquidjs_1.Drop {
     }
 }
 exports.LinkDrop = LinkDrop;
+/**
+ * A document value (`{ documentId, url, thumbnail, info }`) in templates, read from the published documents
+ * so a replaced file is right everywhere. It prints as its address, so `{{ download }}` and
+ * `{{ download.url }}` both work.
+ */
+class DocumentDrop extends liquidjs_1.Drop {
+    documentId;
+    url;
+    thumbnail;
+    info;
+    constructor(value) {
+        super();
+        Object.assign(this, value);
+    }
+    valueOf() {
+        return this.url;
+    }
+    toString() {
+        return this.url;
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.DocumentDrop = DocumentDrop;
+/**
+ * A row of a data collection, from a `row` field: its columns by key (`{{ author.name }}`,
+ * `{% image person.photo 'square' %}`), plus `_id`. It prints as its `name`, else its first text value.
+ */
+class RowDrop extends liquidjs_1.Drop {
+    _id;
+    constructor(row) {
+        super();
+        Object.assign(this, row);
+    }
+    toString() {
+        if (typeof this.name === 'string')
+            return this.name;
+        const first = Object.entries(this).find(([key, v]) => key !== '_id' && typeof v === 'string');
+        return first ? String(first[1]) : '';
+    }
+    valueOf() {
+        return this.toString();
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.RowDrop = RowDrop;
 const isLink = (value) => typeof value.kind === 'string' && LINK_KINDS.includes(value.kind) && typeof value.url === 'string';
-/** Wraps every stored link in a published page, data file or draft in a `LinkDrop`, in place. */
-function wrapLinks(value) {
+const isRowRef = (value) => value.kind === 'row' && value.rowId !== undefined && value.collectionId !== undefined;
+const isDocumentValue = (value) => value.documentId !== undefined && typeof value.url === 'string' && value.kind === undefined;
+const RICH_LINK = /<a\b([^>]*)>/gi;
+/**
+ * Rich text links carry the page they point at (`data-page-id`); their `href` comes from the published page,
+ * keeping any `#anchor`, and is dropped when that page isn't published. Documents' come from `documents`.
+ */
+function resolveRichText(html, context) {
+    if (!context.pageIndex && !context.documents)
+        return html;
+    return html.replace(RICH_LINK, (tag, attrs) => {
+        const pageId = /\bdata-page-id="([0-9a-f]{24})"/i.exec(attrs)?.[1];
+        const documentId = /\bdata-document-id="([0-9a-f]{24})"/i.exec(attrs)?.[1];
+        let href;
+        if (pageId && context.pageIndex) {
+            const anchor = /\bhref="[^"#]*#([^"]*)"/i.exec(attrs)?.[1];
+            const entry = context.pageIndex[pageId];
+            href = entry ? entry.path + (anchor ? `#${anchor}` : '') : null;
+        }
+        else if (documentId && context.documents) {
+            href = context.documents[documentId]?.url;
+        }
+        if (href === undefined)
+            return tag;
+        if (href === null)
+            return tag.replace(/\s*\bhref="[^"]*"/i, '');
+        const value = `href="${href.replace(/&/g, '&amp;').replace(/"/g, '&quot;')}"`;
+        return /\bhref="[^"]*"/i.test(attrs) ? tag.replace(/\bhref="[^"]*"/i, value) : `<a ${value}${attrs}>`;
+    });
+}
+function linkDrop(record, context) {
+    if (record.kind === 'page' && record.pageId && context.pageIndex) {
+        const entry = context.pageIndex[String(record.pageId)];
+        const anchor = record.anchor ? `#${record.anchor}` : '';
+        return new LinkDrop(entry ? { ...record, url: entry.path + anchor, broken: false } : { ...record, url: '', broken: true });
+    }
+    if (record.kind === 'document' && record.documentId && context.documents) {
+        const document = context.documents[String(record.documentId)];
+        if (document)
+            return new LinkDrop({ ...record, url: document.url });
+    }
+    return new LinkDrop(record);
+}
+/** Rows inside rows resolve this deep, so rows that point at each other can't loop. */
+const ROW_DEPTH = 2;
+/**
+ * Wraps every stored link in a published page, data file or draft in a `LinkDrop`, every document value in a
+ * `DocumentDrop` and every row reference in a `RowDrop`, in place, resolving each against `context`. A row
+ * that isn't published reads as nothing, and is left out of lists.
+ */
+function wrapLinks(value, context = {}, depth = 0) {
     if (Array.isArray(value)) {
-        for (let i = 0; i < value.length; i++)
-            value[i] = wrapLinks(value[i]);
+        const wrapped = value.map((item) => wrapLinks(item, context, depth));
+        // a list of rows skips the ones that are gone
+        const kept = wrapped.filter((item, i) => item !== undefined || !isRowLike(value[i]));
+        value.splice(0, value.length, ...kept);
         return value;
     }
+    if (typeof value === 'string')
+        return (value.includes('<a') ? resolveRichText(value, context) : value);
     if (!value || typeof value !== 'object' || value instanceof liquidjs_1.Drop)
         return value;
     const record = value;
     if (isLink(record))
-        return new LinkDrop(record);
+        return linkDrop(record, context);
+    if (isRowRef(record)) {
+        if (!context.row || depth >= ROW_DEPTH)
+            return (context.row ? undefined : value);
+        const row = context.row(String(record.collectionId), String(record.rowId));
+        // a copy: rows come from data files cached across renders
+        return (row ? new RowDrop(wrapLinks(structuredClone(row), context, depth + 1)) : undefined);
+    }
+    if (isDocumentValue(record) && context.documents) {
+        const document = context.documents[String(record.documentId)];
+        return new DocumentDrop(document ? { ...record, ...document } : record);
+    }
     for (const key of Object.keys(record))
-        record[key] = wrapLinks(record[key]);
+        record[key] = wrapLinks(record[key], context, depth);
     return value;
 }
+const isRowLike = (value) => !!value && typeof value === 'object' && isRowRef(value);
+/** The rows a page's row references and byline authors point at, by collection id. */
+function referencedRows(value, found = new Map()) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            referencedRows(item, found);
+    }
+    else if (value && typeof value === 'object' && !(value instanceof liquidjs_1.Drop)) {
+        const record = value;
+        if (isRowRef(record) || (record.kind === 'person' && record.rowId !== undefined)) {
+            const collection = String(record.collectionId);
+            found.set(collection, (found.get(collection) ?? new Set()).add(String(record.rowId)));
+        }
+        else
+            for (const child of Object.values(record))
+                referencedRows(child, found);
+    }
+    return found;
+}
+/**
+ * The context for a site and the data files its page points at. People come from `site.json` `people` (with
+ * `sameAs`), so a person reads the same wherever they are referenced.
+ */
+function linkContextFor(site, files = []) {
+    const rows = new Map();
+    for (const file of files) {
+        if (!file?.rows)
+            continue;
+        rows.set(String(file._id), new Map(file.rows.map((row) => [String(row._id), row])));
+    }
+    return {
+        pageIndex: site?.pageIndex,
+        documents: site?.documents,
+        row: (collectionId, rowId) => {
+            const person = site?.people?.[rowId];
+            return person ? { _id: rowId, ...person } : rows.get(collectionId)?.get(rowId);
+        },
+    };
+}
+/**
+ * An article's byline as templates and structured data read it, in order: `page.authors`. A person is their
+ * People row (`{{ author.name }}`, `{{ author.profile }}`); a guest is what was typed; the organisation is the
+ * site's. Each has `kind`, `name` and `url` (a person's profile page, else their first profile link).
+ */
+function bylineAuthors(page, site, context) {
+    const authors = [];
+    for (const author of page.byline?.authors ?? []) {
+        if (author?.kind === 'person') {
+            const row = context.row?.(String(author.collectionId), String(author.rowId));
+            if (!row)
+                continue;
+            const person = new RowDrop(wrapLinks(structuredClone(row), context, 1));
+            const profile = person.profile;
+            const sameAs = Array.isArray(person.sameAs) ? person.sameAs : [];
+            person.kind = 'person';
+            person.url = profile && String(profile) ? String(profile) : sameAs[0];
+            authors.push(person);
+        }
+        else if (author?.kind === 'guest') {
+            authors.push({ kind: 'guest', name: author.name, url: author.url, jobTitle: author.jobTitle });
+        }
+        else if (author?.kind === 'organisation') {
+            const org = site?.site?.organisation;
+            if (org?.name)
+                authors.push({
+                    kind: 'organisation',
+                    name: org.name,
+                    url: org.url || site?.site?.url,
+                    photo: org.logo,
+                });
+        }
+    }
+    return authors;
+}
 //# sourceMappingURL=links.js.map

package/lib/links.js.map

@@ -1 +1 @@
-{"version":3,"file":"links.js","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":";;;AAmDA,8BAUC;AA7DD,uCAAgC;AAEhC,+FAA+F;AAC/F,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElE;;;;;GAKG;AACH,MAAa,QAAS,SAAQ,eAAI;IAC9B,IAAI,CAAU;IACd,GAAG,CAAU;IACb,MAAM,CAAU;IAChB,UAAU,CAAU;IACpB,MAAM,CAAU;IAChB,KAAK,CAAU;IAEf,YAAY,IAA6B;QACrC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ;AAlCD,4BAkCC;AAED,MAAM,MAAM,GAAG,CAAC,KAA8B,EAAE,EAAE,CAC9C,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC;AAEvG,iGAAiG;AACjG,SAAgB,SAAS,CAAI,KAAQ;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,eAAI;QAAE,OAAO,KAAK,CAAC;IAC/E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAiB,CAAC;IAChE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC;AACjB,CAAC"}
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":";;;AA8IA,0CAkBC;AAyBD,8BAwBC;AAMD,wCAWC;AAMD,wCAcC;AAOD,sCA0BC;AAvRD,uCAAgC;AAShC,+FAA+F;AAC/F,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAelE;;;;;;;GAOG;AACH,MAAa,QAAS,SAAQ,eAAI;IAC9B,IAAI,CAAU;IACd,GAAG,CAAU;IACb,MAAM,CAAU;IAChB,UAAU,CAAU;IACpB,MAAM,CAAU;IAChB,KAAK,CAAU;IACf,MAAM,CAAW;IAEjB,YAAY,IAA6B;QACrC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ;AAnCD,4BAmCC;AAED;;;;GAIG;AACH,MAAa,YAAa,SAAQ,eAAI;IAClC,UAAU,CAAU;IACpB,GAAG,CAAU;IACb,SAAS,CAAU;IACnB,IAAI,CAAqB;IAEzB,YAAY,KAA8B;QACtC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ;AAtBD,oCAsBC;AAED;;;GAGG;AACH,MAAa,OAAQ,SAAQ,eAAI;IAC7B,GAAG,CAAU;IAGb,YAAY,GAA4B;QACpC,KAAK,EAAE,CAAC;QACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ;QACJ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAC9F,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM;QACF,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ;AAtBD,0BAsBC;AAED,MAAM,MAAM,GAAG,CAAC,KAA8B,EAAE,EAAE,CAC9C,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC;AAEvG,MAAM,QAAQ,GAAG,CAAC,KAA8B,EAAE,EAAE,CAChD,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC;AAE1F,MAAM,eAAe,GAAG,CAAC,KAA8B,EAAE,EAAE,CACvD,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;AAEhG,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAEnC;;;GAGG;AACH,SAAgB,eAAe,CAAC,IAAY,EAAE,OAAoB;IAC9D,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,KAAa,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,IAA+B,CAAC;QACpC,IAAI,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,CAAC;aAAM,IAAI,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;QACnC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;QAC9E,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC;IAC1G,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,QAAQ,CAAC,MAA+B,EAAE,OAAoB;IACnE,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,QAAQ,CACf,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CACxG,CAAC;IACN,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,OAAO,IAAI,QAAQ,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;GAIG;AACH,SAAgB,SAAS,CAAI,KAAQ,EAAE,UAAuB,EAAE,EAAE,KAAK,GAAG,CAAC;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACrE,8CAA8C;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAM,CAAC;IAC5G,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,YAAY,eAAI;QAAE,OAAO,KAAK,CAAC;IAC/E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAiB,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAM,CAAC;QACtF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3E,0DAA0D;QAC1D,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAM,CAAC;IACrG,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9D,OAAO,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAiB,CAAC;IAC5F,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAgC,CAAC,CAAC;AAEvF,sFAAsF;AACtF,SAAgB,cAAc,CAAC,KAAc,EAAE,QAAQ,IAAI,GAAG,EAAuB;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,YAAY,eAAI,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;YAC/E,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC/C,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC;;YAAM,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;gBAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAA2B,EAAE,QAAwC,EAAE;IAClG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgD,CAAC;IACrE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,IAAI;YAAE,SAAS;QAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO;QACH,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,SAAS,EAAE,IAAI,EAAE,SAAS;QAC1B,GAAG,EAAE,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACnF,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAyB,EAAE,IAA2B,EAAE,OAAoB;IACtG,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7E,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAA+B,CAAC;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,MAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;YACvB,MAAM,CAAC,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,MAA4C,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnG,CAAC;aAAM,IAAI,MAAM,EAAE,IAAI,KAAK,cAAc,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC;YACrC,IAAI,GAAG,EAAE,IAAI;gBACT,OAAO,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,cAAc;oBACpB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG;oBAC/B,KAAK,EAAE,GAAG,CAAC,IAAI;iBAClB,CAAC,CAAC;QACX,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/lib/social-meta.d.ts

@@ -0,0 +1,15 @@
+import { CeemsPage, CeemsSite } from './interfaces';
+/** One `<meta>`: Open Graph tags take `property`, X's take `name`. */
+export interface SocialMetaTag {
+    attribute: 'property' | 'name';
+    key: string;
+    content: string;
+}
+/**
+ * The page's link-preview tags: Open Graph, read by Facebook, LinkedIn, WhatsApp, Slack and others, and X's
+ * card. Built from what the page already publishes for search (title, description, social image, dates), so
+ * a template needs no more than `{% socialmeta %}`. X reads the title, description and image from Open Graph.
+ */
+export declare function socialMeta(site: CeemsSite, page: CeemsPage): SocialMetaTag[];
+/** The tags as HTML, their content escaped for an attribute. */
+export declare function renderSocialMeta(tags: SocialMetaTag[]): string;

package/lib/social-meta.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.socialMeta = socialMeta;
+exports.renderSocialMeta = renderSocialMeta;
+const structured_data_1 = require("./structured-data");
+/**
+ * The page's link-preview tags: Open Graph, read by Facebook, LinkedIn, WhatsApp, Slack and others, and X's
+ * card. Built from what the page already publishes for search (title, description, social image, dates), so
+ * a template needs no more than `{% socialmeta %}`. X reads the title, description and image from Open Graph.
+ */
+function socialMeta(site, page) {
+    const root = String(site.site?.url ?? '').replace(/\/+$/, '');
+    const path = page.fullpath && page.fullpath !== 'home' ? `/${page.fullpath}` : '/';
+    const absolute = (href) => /^https?:\/\//i.test(href) ? href : `${root}${href.startsWith('/') ? '' : '/'}${href}`;
+    const entity = (0, structured_data_1.entityOf)(page);
+    const image = (0, structured_data_1.imageUrl)(page.social);
+    const tags = [];
+    const og = (key, value) => {
+        const content = (0, structured_data_1.text)(value);
+        if (content)
+            tags.push({ attribute: 'property', key, content });
+    };
+    const x = (key, value) => {
+        const content = (0, structured_data_1.text)(value);
+        if (content)
+            tags.push({ attribute: 'name', key, content });
+    };
+    og('og:type', entity === 'ARTICLE' ? 'article' : entity === 'PERSON' ? 'profile' : 'website');
+    og('og:title', (0, structured_data_1.text)(page.title) ?? (0, structured_data_1.text)(page.name) ?? site.site?.name);
+    og('og:description', (0, structured_data_1.plain)(page.description));
+    if (root)
+        og('og:url', root + path);
+    og('og:site_name', site.site?.name);
+    if (image) {
+        og('og:image', absolute(image));
+        if (page.social?.width && page.social?.height) {
+            og('og:image:width', page.social.width);
+            og('og:image:height', page.social.height);
+        }
+        og('og:image:alt', page.social?.alt);
+    }
+    if (entity === 'ARTICLE') {
+        const published = (0, structured_data_1.isoDate)(page.date) ?? (0, structured_data_1.isoDate)(page.publishedAt);
+        og('article:published_time', published);
+        og('article:modified_time', (0, structured_data_1.isoDate)(page.updatedAt) ?? published);
+        for (const author of page.authors ?? []) {
+            const profile = (0, structured_data_1.text)(author.profile);
+            if (profile)
+                og('article:author', absolute(profile));
+        }
+        for (const tag of page.tags ?? [])
+            og('article:tag', tag);
+    }
+    x('twitter:card', image ? 'summary_large_image' : 'summary');
+    x('twitter:site', xHandle(site.site?.organisation?.sameAs));
+    return tags;
+}
+/** The organisation's X account, `@name`, from its profile links. */
+function xHandle(sameAs) {
+    for (const url of sameAs ?? []) {
+        const match = /^https?:\/\/(?:www\.)?(?:x|twitter)\.com\/@?([A-Za-z0-9_]{1,15})\/?$/i.exec(url.trim());
+        if (match)
+            return `@${match[1]}`;
+    }
+}
+/** The tags as HTML, their content escaped for an attribute. */
+function renderSocialMeta(tags) {
+    return tags.map((t) => `<meta ${t.attribute}="${t.key}" content="${escapeAttribute(t.content)}">`).join('');
+}
+function escapeAttribute(value) {
+    return value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=social-meta.js.map

package/lib/social-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-meta.js","sourceRoot":"","sources":["../src/social-meta.ts"],"names":[],"mappings":"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"}

package/lib/structured-data.d.ts

@@ -1,4 +1,4 @@
-import type { CeemsPage, CeemsSite, PageEntity, StructuredDataDefaults, StructuredDataType } from './interfaces';
+import type { CeemsImage, CeemsPage, CeemsSite, PageEntity, StructuredDataDefaults, StructuredDataType } from './interfaces';
 /** The types a page or the site's defaults can switch on, in the order the tag outputs them. */
 export declare const STRUCTURED_DATA_TYPES: readonly StructuredDataType[];
 /** What `{% structureddata %}` can be limited to: the types, and the page's entity (its product, event…). */
@@ -25,4 +25,11 @@ export declare function structuredDataGraph(site: CeemsSite, page: CeemsPage, on
 };
 /** JSON for a `<script>`: `<`, `>` and `&` are escaped so content can't end the script. */
 export declare function serialiseJsonLd(value: unknown): string;
+export declare function imageUrl(image?: CeemsImage | null): string | undefined;
+/** A date published as an ISO string (or a `Date`, for custom pages) as an ISO string. */
+export declare function isoDate(value: unknown): string | undefined;
+/** A non-empty trimmed string, else `undefined`. Stored links (`LinkDrop`) read as their address. */
+export declare function text(value: unknown): string | undefined;
+/** Rich text as plain text, for properties that take no markup. */
+export declare function plain(value: unknown): unknown;
 export {};