@haverstack/eleventy 0.2.0

package/dist/load.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @haverstack/eleventy — load phase
+ * -------------------------------------------------------
+ * Fetch every record a build needs and turn it into in-memory indexes.
+ * This phase is mechanical: it resolves the site, walks the change-free
+ * structure, and groups records for lookup. Every decision — cascades,
+ * collisions, permalinks, collection membership — belongs to resolve.
+ *
+ * Two disciplines this phase enforces (see docs/design.md § Load):
+ *
+ *   - Every query loops on the cursor to exhaustion. `cursor === null` is
+ *     the only end-of-results signal; a short or empty page is not. `total`
+ *     is `null` under a scoped stack, so there is no count to check.
+ *   - Every query asks for unlisted records. They still build at their
+ *     URLs, so the build must see them; excluding them from listings is
+ *     resolve's job. `includeUnlisted` is owner-only, so a build under a
+ *     scoped credential silently loses them — `unlistedVisible` records
+ *     whether that happened.
+ */
+import { type FileId, type RecordId, type StackClient, type StackRecord } from '@haverstack/core';
+/** The `collection` object a listing-root `page@1` carries. */
+export interface CollectionSpec {
+    typeId: string;
+    tag?: string;
+    order?: string;
+}
+export interface LoadOptions {
+    /**
+     * The `site@1` record to build, by `handle` or by record id. Omit only
+     * on a stack with no `site@1` records — the single-site case.
+     */
+    site?: string;
+}
+/** `page-meta` sidecars for one described record, split by scope. */
+export interface SidecarSet {
+    /** Sidecars with no `for-site` association — the record's default. >1 is a writer error. */
+    unscoped: StackRecord[];
+    /** Sidecars scoped to the site being built. >1 is a writer error. */
+    thisSite: StackRecord[];
+    /** Every scoped sidecar by the site it targets — for resolving links to other sites. */
+    bySite: Map<RecordId, StackRecord[]>;
+}
+/** A node in the site's page tree. */
+export interface PageNode {
+    record: StackRecord;
+    parent: PageNode | null;
+    children: PageNode[];
+}
+export interface StackIndex {
+    /** The site being built, or `null` on a stack with no `site@1` records. */
+    site: StackRecord | null;
+    /** Every `site@1` record, for cross-site link resolution. */
+    sitesById: Map<RecordId, StackRecord>;
+    sitesByHandle: Map<string, StackRecord>;
+    /**
+     * Every record this phase fetched, by id: every site's pages, all menus,
+     * sidecars, attachment metadata, the owner, and the listing members that
+     * carry a sidecar. Every key of `sidecarsByParent` resolves here.
+     */
+    byId: Map<RecordId, StackRecord>;
+    /** Root pages of the site being built, sorted stably. */
+    pageRoots: PageNode[];
+    /** Every page in the site's pruned subtree, by id. */
+    pagesById: Map<RecordId, PageNode>;
+    /** `page-meta` sidecars grouped by the record they describe. */
+    sidecarsByParent: Map<RecordId, SidecarSet>;
+    /**
+     * Raw collection candidates per listing-root page id: every record the
+     * root's `collection` query selects, scoped to this site and unlisted
+     * included, in query order. Draft/hidden filtering, sorting and
+     * permalinks are resolve's.
+     */
+    membersByListingRoot: Map<RecordId, StackRecord[]>;
+    /** The site's menus, in fetch order. */
+    menus: StackRecord[];
+    /** The site's menus grouped by handle (one-to-many: uniqueness is unenforced). */
+    menusByHandle: Map<string, StackRecord[]>;
+    /** `_attachment@1` records grouped by fileId, earliest `createdAt` first. */
+    attachmentsByFileId: Map<FileId, StackRecord[]>;
+    /** The stack owner's `_entity@1` card, or `null`. */
+    owner: StackRecord | null;
+    /** `false` when the build runs under a credential that cannot see unlisted records. */
+    unlistedVisible: boolean;
+}
+export declare function load(stack: StackClient, opts?: LoadOptions): Promise<StackIndex>;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,KAAK,MAAM,EAEX,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAK1B,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,4FAA4F;IAC5F,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,qEAAqE;IACrE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,wFAAwF;IACxF,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,6DAA6D;IAC7D,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACtC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC;;;;OAIG;IACH,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjC,yDAAyD;IACzD,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,gEAAgE;IAChE,gBAAgB,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,oBAAoB,EAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACnD,wCAAwC;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kFAAkF;IAClF,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1C,6EAA6E;IAC7E,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAChD,qDAAqD;IACrD,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,uFAAuF;IACvF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAyHD,wBAAsB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoI1F"}

package/dist/load.js

@@ -0,0 +1,258 @@
+/**
+ * @haverstack/eleventy — load phase
+ * -------------------------------------------------------
+ * Fetch every record a build needs and turn it into in-memory indexes.
+ * This phase is mechanical: it resolves the site, walks the change-free
+ * structure, and groups records for lookup. Every decision — cascades,
+ * collisions, permalinks, collection membership — belongs to resolve.
+ *
+ * Two disciplines this phase enforces (see docs/design.md § Load):
+ *
+ *   - Every query loops on the cursor to exhaustion. `cursor === null` is
+ *     the only end-of-results signal; a short or empty page is not. `total`
+ *     is `null` under a scoped stack, so there is no count to check.
+ *   - Every query asks for unlisted records. They still build at their
+ *     URLs, so the build must see them; excluding them from listings is
+ *     resolve's job. `includeUnlisted` is owner-only, so a build under a
+ *     scoped credential silently loses them — `unlistedVisible` records
+ *     whether that happened.
+ */
+import { StackPermissionError, SYSTEM_TYPES, } from '@haverstack/core';
+import { PAGE, SITE } from '@haverstack/commons';
+import { FOR_SITE_LABEL, MENU, PAGE_META, SITE_MEMBERSHIP_LABEL } from './types.js';
+import { HaverstackEleventyError } from './errors.js';
+const QUERY_PAGE_SIZE = 100;
+/** Walk `filter` to exhaustion. See the module comment for why the loop is the only correct form. */
+async function queryAll(stack, filter) {
+    const out = [];
+    let cursor;
+    do {
+        const page = await stack.query({ filter, cursor, limit: QUERY_PAGE_SIZE });
+        out.push(...page.records);
+        cursor = page.cursor ?? undefined;
+    } while (cursor);
+    return out;
+}
+function resolveSite(sites, want) {
+    if (want === undefined) {
+        if (sites.length === 0)
+            return null;
+        const known = sites.map((s) => s.content.handle ?? `(${s.id})`).join(', ');
+        throw new HaverstackEleventyError(`This stack has ${sites.length} site@1 record(s); name one with the \`site\` option ` +
+            `(handle or record id). Known: ${known}.`);
+    }
+    const byHandle = sites.filter((s) => s.content.handle === want);
+    if (byHandle.length === 1)
+        return byHandle[0];
+    if (byHandle.length > 1) {
+        throw new HaverstackEleventyError(`The \`site\` handle "${want}" resolves to ${byHandle.length} records ` +
+            `(${byHandle.map((s) => s.id).join(', ')}). Handle uniqueness is a writer obligation.`);
+    }
+    const byId = sites.find((s) => s.id === want);
+    if (byId)
+        return byId;
+    throw new HaverstackEleventyError(`No site@1 record with handle or id "${want}".`);
+}
+/**
+ * The first ancestor of `startId` that is not itself a page in `rawPages`,
+ * or `null` for a page with no parent (or an ancestry cycle). A `site@1`
+ * parent is one such stop; so is a parent that was never fetched.
+ */
+function terminalAncestor(startId, rawPages) {
+    const seen = new Set();
+    let current = rawPages.get(startId);
+    while (current) {
+        if (seen.has(current.id))
+            return null;
+        seen.add(current.id);
+        const parentId = current.parentId;
+        if (!parentId)
+            return null;
+        const parent = rawPages.get(parentId);
+        if (!parent)
+            return parentId;
+        current = parent;
+    }
+    return null;
+}
+const pageOrder = (a, b) => a.record.createdAt.getTime() - b.record.createdAt.getTime() ||
+    (a.record.id < b.record.id ? -1 : a.record.id > b.record.id ? 1 : 0);
+function buildPageTree(kept) {
+    const byId = new Map(kept.map((r) => [r.id, { record: r, parent: null, children: [] }]));
+    const roots = [];
+    for (const node of byId.values()) {
+        const parentId = node.record.parentId;
+        const parent = parentId ? byId.get(parentId) : undefined;
+        if (parent) {
+            node.parent = parent;
+            parent.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    roots.sort(pageOrder);
+    for (const node of byId.values())
+        node.children.sort(pageOrder);
+    return { roots, byId };
+}
+function forSiteTargets(record) {
+    const out = [];
+    for (const a of record.associations ?? []) {
+        if (a.kind === 'relationship' && a.label === FOR_SITE_LABEL && a.target.scope === 'record') {
+            out.push(a.target.recordId);
+        }
+    }
+    return out;
+}
+function groupSidecars(sidecars, siteId) {
+    const map = new Map();
+    for (const sc of sidecars) {
+        if (!sc.parentId)
+            continue;
+        const set = map.get(sc.parentId) ?? {
+            unscoped: [],
+            thisSite: [],
+            bySite: new Map(),
+        };
+        const targets = forSiteTargets(sc);
+        if (targets.length === 0) {
+            set.unscoped.push(sc);
+        }
+        else {
+            for (const target of targets) {
+                const list = set.bySite.get(target) ?? [];
+                list.push(sc);
+                set.bySite.set(target, list);
+            }
+            if (siteId !== undefined && targets.includes(siteId))
+                set.thisSite.push(sc);
+        }
+        map.set(sc.parentId, set);
+    }
+    return map;
+}
+export async function load(stack, opts = {}) {
+    // Probe includeUnlisted once — it is owner-only, and a scoped stack
+    // throws rather than downgrading silently.
+    let unlistedVisible = true;
+    let siteRecords;
+    try {
+        siteRecords = await queryAll(stack, { typeId: SITE.id, includeUnlisted: true });
+    }
+    catch (err) {
+        if (!(err instanceof StackPermissionError))
+            throw err;
+        unlistedVisible = false;
+        siteRecords = await queryAll(stack, { typeId: SITE.id });
+    }
+    const unlisted = unlistedVisible
+        ? { includeUnlisted: true }
+        : {};
+    const site = resolveSite(siteRecords, opts.site);
+    const sitesById = new Map(siteRecords.map((s) => [s.id, s]));
+    const sitesByHandle = new Map();
+    for (const s of siteRecords) {
+        const handle = s.content.handle;
+        if (typeof handle === 'string' && handle && !sitesByHandle.has(handle)) {
+            sitesByHandle.set(handle, s);
+        }
+    }
+    const [allPages, allSidecars, allMenus, allAttachments, owner] = await Promise.all([
+        queryAll(stack, { typeId: PAGE.id, ...unlisted }),
+        queryAll(stack, { typeId: PAGE_META.id, ...unlisted }),
+        queryAll(stack, { typeId: MENU.id, ...(site ? { parentId: site.id } : {}), ...unlisted }),
+        queryAll(stack, { baseId: SYSTEM_TYPES.ATTACHMENT, ...unlisted }),
+        stack.getOwnerEntity(),
+    ]);
+    const rawPages = new Map(allPages.map((p) => [p.id, p]));
+    const kept = allPages.filter((p) => {
+        const terminal = terminalAncestor(p.id, rawPages);
+        return site ? terminal === site.id : terminal === null || !sitesById.has(terminal);
+    });
+    const { roots: pageRoots, byId: pagesById } = buildPageTree(kept);
+    const sidecarsByParent = groupSidecars(allSidecars, site?.id);
+    // Collection candidates: one query per listing root, scoped to this site
+    // by a `relatedTo` clause (omitted on a single-site stack). Query
+    // construction only — the draft convention, sort and permalinks that turn
+    // candidates into a listing are resolve's. The roots run concurrently:
+    // over a remote stack these are the calls that add up.
+    const listingNodes = [...pagesById.values()].filter((n) => n.record.content.collection?.typeId);
+    const listingMembers = await Promise.all(listingNodes.map((node) => {
+        const spec = node.record.content.collection;
+        return queryAll(stack, {
+            typeId: spec.typeId,
+            ...(spec.tag ? { tags: [spec.tag] } : {}),
+            ...(site
+                ? {
+                    relatedTo: {
+                        label: SITE_MEMBERSHIP_LABEL,
+                        target: { scope: 'record', recordId: site.id },
+                    },
+                }
+                : {}),
+            ...unlisted,
+        });
+    }));
+    const membersByListingRoot = new Map(listingNodes.map((node, i) => [node.record.id, listingMembers[i]]));
+    const menusByHandle = new Map();
+    for (const menu of allMenus) {
+        const handle = menu.content.handle;
+        if (typeof handle !== 'string')
+            continue;
+        const list = menusByHandle.get(handle) ?? [];
+        list.push(menu);
+        menusByHandle.set(handle, list);
+    }
+    const attachmentsByFileId = new Map();
+    for (const attachment of allAttachments) {
+        const fileId = attachment.content.fileId;
+        if (!fileId)
+            continue;
+        const list = attachmentsByFileId.get(fileId) ?? [];
+        list.push(attachment);
+        attachmentsByFileId.set(fileId, list);
+    }
+    for (const list of attachmentsByFileId.values()) {
+        list.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+    }
+    const byId = new Map();
+    for (const record of [
+        ...siteRecords,
+        ...allPages,
+        ...allMenus,
+        ...allSidecars,
+        ...allAttachments,
+        ...[...membersByListingRoot.values()].flat(),
+    ]) {
+        byId.set(record.id, record);
+    }
+    if (owner)
+        byId.set(owner.id, owner);
+    // The records sidecars describe — listing members carrying page-meta —
+    // are not bulk-fetched here (resolve's collection queries bring them in).
+    // Point-read the few that carry a sidecar so every key in
+    // `sidecarsByParent` resolves through `byId`: `check` names them, and a
+    // scoped read that returns null just leaves the gap it would have anyway.
+    const describedIds = [...sidecarsByParent.keys()].filter((id) => !byId.has(id));
+    const described = await Promise.all(describedIds.map((id) => stack.get(id)));
+    for (const record of described)
+        if (record)
+            byId.set(record.id, record);
+    return {
+        site,
+        sitesById,
+        sitesByHandle,
+        byId,
+        pageRoots,
+        pagesById,
+        sidecarsByParent,
+        membersByListingRoot,
+        menus: allMenus,
+        menusByHandle,
+        attachmentsByFileId,
+        owner,
+        unlistedVisible,
+    };
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

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

package/dist/markdown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @haverstack/eleventy — body rendering
+ * -------------------------------------------------------
+ * A plugin-owned markdown-it instance so record bodies render the same
+ * regardless of the host's markdown config. Embed substitution runs first
+ * (it rewrites link and image targets in the source text); the result is
+ * sanitized, because a stack can hold records written by more than one
+ * person and sanitizing on render costs little.
+ *
+ * `format` follows the commons vocabulary: `markdown` when absent, `plain`
+ * when set, and any unrecognised value rendered as plain — never a richer
+ * format than the record declares. See docs/design.md § Markdown.
+ */
+/**
+ * Rewrite `](filename)` / `](<filename>)` targets to their staged asset
+ * paths. Exposed so a site rendering the raw body itself gets image links
+ * that resolve.
+ */
+export declare function substituteEmbeds(text: string, embeds: Map<string, string>): string;
+export declare function renderMarkdown(text: string): string;
+export declare function renderPlain(text: string): string;
+export declare function renderBody(text: string, format: unknown, embeds?: Map<string, string>): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2CH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CASlF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAK9F"}

package/dist/markdown.js

@@ -0,0 +1,81 @@
+/**
+ * @haverstack/eleventy — body rendering
+ * -------------------------------------------------------
+ * A plugin-owned markdown-it instance so record bodies render the same
+ * regardless of the host's markdown config. Embed substitution runs first
+ * (it rewrites link and image targets in the source text); the result is
+ * sanitized, because a stack can hold records written by more than one
+ * person and sanitizing on render costs little.
+ *
+ * `format` follows the commons vocabulary: `markdown` when absent, `plain`
+ * when set, and any unrecognised value rendered as plain — never a richer
+ * format than the record declares. See docs/design.md § Markdown.
+ */
+import MarkdownIt from 'markdown-it';
+import sanitizeHtml from 'sanitize-html';
+const md = new MarkdownIt({
+    html: true,
+    linkify: true,
+    typographer: true,
+    langPrefix: 'language-',
+});
+const SANITIZE = {
+    allowedTags: [
+        ...sanitizeHtml.defaults.allowedTags,
+        'img',
+        'figure',
+        'figcaption',
+        'picture',
+        'source',
+        'h1',
+        'h2',
+        'del',
+        'ins',
+        'sup',
+        'sub',
+        'abbr',
+    ],
+    allowedAttributes: {
+        ...sanitizeHtml.defaults.allowedAttributes,
+        a: ['href', 'name', 'id', 'target', 'rel'],
+        img: ['src', 'srcset', 'alt', 'title', 'width', 'height', 'loading'],
+        source: ['src', 'srcset', 'type', 'media', 'sizes'],
+        code: ['class'],
+        span: ['class'],
+        '*': ['id'],
+    },
+    allowedSchemes: ['http', 'https', 'mailto', 'tel'],
+};
+const escapeHtml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+/**
+ * Rewrite `](filename)` / `](<filename>)` targets to their staged asset
+ * paths. Exposed so a site rendering the raw body itself gets image links
+ * that resolve.
+ */
+export function substituteEmbeds(text, embeds) {
+    let out = text;
+    for (const [filename, assetPath] of embeds) {
+        const literal = filename.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        out = out
+            .replace(new RegExp(`\\]\\(<${literal}>\\)`, 'g'), `](<${assetPath}>)`)
+            .replace(new RegExp(`\\]\\(${literal}(\\s|\\))`, 'g'), `](${assetPath}$1`);
+    }
+    return out;
+}
+export function renderMarkdown(text) {
+    return sanitizeHtml(md.render(text), SANITIZE);
+}
+export function renderPlain(text) {
+    return text
+        .split(/\n{2,}/)
+        .map((para) => `<p>${escapeHtml(para).replace(/\n/g, '<br>\n')}</p>`)
+        .join('\n');
+}
+export function renderBody(text, format, embeds) {
+    const isMarkdown = format === undefined || format === 'markdown';
+    if (!isMarkdown)
+        return renderPlain(text);
+    const source = embeds && embeds.size > 0 ? substituteEmbeds(text, embeds) : text;
+    return renderMarkdown(source);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/publish.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @haverstack/eleventy — the `publish` command
+ * -------------------------------------------------------
+ * Stamps `article.url` / `post.url` with the canonical location at first
+ * publish, so any app can render a "view published" link. This is a
+ * write, and it does not belong in a build: a build that mutates what it
+ * read cannot run twice safely, against production, or from CI without
+ * write credentials. So it is a separate command, run deliberately after
+ * a successful build.
+ *
+ * See docs/design.md § publish.
+ */
+import type { Stack } from '@haverstack/core';
+import { type SlugStrategy } from './resolve.js';
+export interface PublishOptions {
+    site?: string;
+    slugStrategy?: SlugStrategy;
+    /** Report what would be written without writing. */
+    dryRun?: boolean;
+}
+export interface PublishReport {
+    site: string;
+    baseUrl: string;
+    dryRun: boolean;
+    /** `url` was absent and this site stamped it. */
+    stamped: {
+        recordId: string;
+        url: string;
+    }[];
+    /** `url` already points into this site — nothing to do. */
+    alreadyHome: {
+        recordId: string;
+        storedUrl: string;
+    }[];
+    /** `url` points at another site — this site renders rel=canonical, does not restamp. */
+    canonicalElsewhere: {
+        recordId: string;
+        storedUrl: string;
+    }[];
+    /** Members whose type carries no canonical `url` field (photos, bookmarks). */
+    skipped: number;
+}
+export declare function runPublish(stack: Stack, opts?: PublishOptions): Promise<PublishReport>;
+export declare function formatPublishReport(report: PublishReport): string;
+//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAQ1D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,2DAA2D;IAC3D,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,wFAAwF;IACxF,kBAAkB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6ChG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAsBjE"}

package/dist/publish.js

@@ -0,0 +1,79 @@
+/**
+ * @haverstack/eleventy — the `publish` command
+ * -------------------------------------------------------
+ * Stamps `article.url` / `post.url` with the canonical location at first
+ * publish, so any app can render a "view published" link. This is a
+ * write, and it does not belong in a build: a build that mutates what it
+ * read cannot run twice safely, against production, or from CI without
+ * write credentials. So it is a separate command, run deliberately after
+ * a successful build.
+ *
+ * See docs/design.md § publish.
+ */
+import { ARTICLE, POST } from '@haverstack/commons';
+import { load } from './load.js';
+import { resolve } from './resolve.js';
+import { HaverstackEleventyError } from './errors.js';
+const baseId = (typeId) => typeId.split('@')[0];
+/** Types whose `url` field is the canonical published location (not, say, a bookmark's target). */
+const CANONICAL_URL_TYPES = new Set([baseId(ARTICLE.id), baseId(POST.id)]);
+export async function runPublish(stack, opts = {}) {
+    const index = await load(stack, { site: opts.site });
+    // A clean resolve is a precondition — publish follows a successful build.
+    const resolved = resolve(index, { slugStrategy: opts.slugStrategy ?? 'title', strict: true });
+    if (!resolved.site) {
+        throw new HaverstackEleventyError('publish needs a site@1 record: canonical URLs are built from its baseUrl.');
+    }
+    const baseUrl = String(resolved.site.content.baseUrl ?? '').replace(/\/+$/, '');
+    if (!baseUrl) {
+        throw new HaverstackEleventyError(`Site "${resolved.site.content.handle}" has no baseUrl.`);
+    }
+    const report = {
+        site: resolved.site.content.handle,
+        baseUrl,
+        dryRun: Boolean(opts.dryRun),
+        stamped: [],
+        alreadyHome: [],
+        canonicalElsewhere: [],
+        skipped: 0,
+    };
+    for (const member of resolved.members) {
+        if (!CANONICAL_URL_TYPES.has(baseId(member.record.typeId))) {
+            report.skipped++;
+            continue;
+        }
+        const stored = member.record.content.url;
+        if (typeof stored === 'string' && stored) {
+            if (stored.startsWith(baseUrl))
+                report.alreadyHome.push({ recordId: member.record.id, storedUrl: stored });
+            else
+                report.canonicalElsewhere.push({ recordId: member.record.id, storedUrl: stored });
+            continue;
+        }
+        const url = `${baseUrl}${member.url}`;
+        if (!opts.dryRun)
+            await stack.update(member.record.id, { url });
+        report.stamped.push({ recordId: member.record.id, url });
+    }
+    return report;
+}
+export function formatPublishReport(report) {
+    const lines = [];
+    lines.push(`${report.dryRun ? 'Would publish' : 'Published'} canonical URLs for "${report.site}" ` +
+        `(${report.baseUrl}).\n`);
+    for (const { recordId, url } of report.stamped) {
+        lines.push(`  ${report.dryRun ? 'would stamp' : 'stamped'}   ${recordId}  → ${url}`);
+    }
+    for (const { recordId } of report.alreadyHome) {
+        lines.push(`  already home ${recordId}`);
+    }
+    for (const { recordId, storedUrl } of report.canonicalElsewhere) {
+        lines.push(`  elsewhere    ${recordId}  (canonical at ${storedUrl})`);
+    }
+    lines.push(`\n${report.stamped.length} ${report.dryRun ? 'to stamp' : 'stamped'}, ` +
+        `${report.alreadyHome.length} already canonical here, ` +
+        `${report.canonicalElsewhere.length} canonical elsewhere, ` +
+        `${report.skipped} without a canonical url field.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=publish.js.map

package/dist/publish.js.map

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