@haverstack/eleventy 0.2.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,91 @@
+# `@haverstack/eleventy`
+
+An Eleventy plugin that builds a static site from a [Haverstack](https://github.com/haverstack/core)
+stack. Records are the content source; there are no content files on disk.
+
+> **Status:** Early development, but the whole pipeline works — load, resolve, asset
+> staging, markdown, emit (pages, collections, feeds, sitemap), built-in templates that a
+> site can override with its own, and the `check` / `publish` commands.
+> [`docs/design.md`](./docs/design.md) covers how it works and why.
+
+## Usage
+
+```js
+import { haverstack } from '@haverstack/eleventy';
+import { LocalAdapter } from '@haverstack/adapter-local';
+import { Stack } from '@haverstack/core';
+
+export default async function (eleventyConfig) {
+  const stack = await Stack.create(await LocalAdapter.open({ path: './stack.db' }));
+
+  eleventyConfig.addPlugin(haverstack, {
+    stack,
+    site: 'personal',
+    assetDir: '_stack-assets',
+    slugStrategy: 'title',
+  });
+}
+```
+
+The plugin takes a `Stack`, not a URL — so a build can run against a remote server
+(`APIAdapter`), a local SQLite file (`LocalAdapter`), or an in-memory stack
+(`MemoryAdapter`, for tests). Whoever constructs the stack has already dealt with auth;
+the plugin never handles credentials and never writes.
+
+Out of the box it renders a legible site with its built-in templates. The pages are
+ordinary Eleventy pages: transforms and global data apply, and every listed page/member
+carries `tags` (`haverstack`, its type, its tag associations) and `eleventyNavigation`,
+so `collections.*`, navigation plugins, and anything reading `collections.all` see them.
+
+To use your own layouts, map `template` names to files in your `_includes`:
+
+```js
+eleventyConfig.addPlugin(haverstack, {
+  stack,
+  site: 'personal',
+  templates: { base: 'layouts/base', listing: 'layouts/index', article: 'layouts/longform' },
+});
+```
+
+A mapped page emits its content fragment (`{{ content }}`) plus `record`, `meta`, `url`,
+`canonical`, `body` / `bodyRaw`, `collection`, and the `haverstack` globals; the layout
+does the rest and may chain to another. `base` catches any unmapped name; anything still
+unmapped keeps the built-in render. `haverstack-eleventy eject` writes a starter
+`haverstack-base.njk` to get going. Other options: `eleventyCollections: false` for full
+isolation, `pageData: (ctx) => ({…})` to compute extra template data per record.
+
+## Types
+
+**Consumes** the commons publishing types — `site@1`, `page@1`, `article@1`, `post@1`,
+`photo@1`, `bookmark@1` — plus `_entity@1` and `_attachment@1`.
+
+**Owns** two sidecar types, minted under `org.haverstack.eleventy`:
+
+| Type                                  | Role                                                                                                  |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `org.haverstack.eleventy/page-meta@1` | Per-record, per-site overrides: `slug`, `template`, `order`, `hidden`, `draft`. Every field optional. |
+| `org.haverstack.eleventy/menu@1`      | A named, ordered navigation menu belonging to one site.                                               |
+
+`defineEleventyTypes(stack)` registers the whole set. It is idempotent and safe to call
+on every build; under a non-owner credential it tolerates types that already exist.
+
+## Commands
+
+```
+haverstack-eleventy check     load + resolve, report structural problems, write nothing
+haverstack-eleventy publish   stamp article.url / post.url with the canonical location
+haverstack-eleventy eject     write a starter haverstack-base layout into _includes
+```
+
+`check` and `publish` read the stack from a config module (`--config`, default
+`./haverstack.config.mjs`) that default-exports a `Stack`, a `{ stack, site? }`, or a
+function returning one — the same place a project builds the stack for
+`eleventy.config.js`. `--site <handle>` overrides the config's site.
+
+`check` is read-only and safe against production data; it exits non-zero when it finds a
+build failure (a path collision, conflicting sidecars). `publish` writes — run it
+deliberately after a good build; `--dry-run` shows what it would stamp.
+
+## License
+
+[MIT](./LICENSE)

package/dist/assets.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @haverstack/eleventy — asset staging
+ * -------------------------------------------------------
+ * Eleventy does not emit binaries well, so attachment bytes are staged to
+ * disk before the build proper and passed through. Content addressing
+ * makes the cache trivially correct: a `fileId` already on disk is never
+ * refetched, and it can never go stale.
+ *
+ * `collectAssets` is pure — it decides which files a site needs and what
+ * they will be named. `stageAssets` does the fetching and writing.
+ *
+ * See docs/design.md § Stage assets.
+ */
+import type { FileId, RecordId, StackClient } from '@haverstack/core';
+import type { StackIndex } from './load.js';
+import type { ResolvedSite, ResolveWarning } from './resolve.js';
+export interface StagedFile {
+    fileId: FileId;
+    /** `<fileId><ext>` — the name on disk and in the URL. */
+    fileName: string;
+    /** Site-root-relative URL, e.g. `/_stack-assets/<fileId>.png`. */
+    assetPath: string;
+    mimeType: string;
+}
+export interface AssetPlan {
+    /** As configured, e.g. `_stack-assets`. */
+    assetDir: string;
+    /** Every file this site references, by fileId. */
+    files: Map<FileId, StagedFile>;
+    /** Per record: the body filename → staged asset path map for embed substitution. */
+    embedsByRecord: Map<RecordId, Map<string, string>>;
+    warnings: ResolveWarning[];
+}
+/**
+ * Walk every record this site builds — pages and members, listed or not —
+ * and collect the attachment files it references, by `embed` association
+ * and by `file-ref` content field. Filenames for embed substitution are
+ * resolved per record, never globally: two records can each carry an
+ * `image.png` with different bytes.
+ */
+export declare function collectAssets(resolved: ResolvedSite, index: StackIndex, assetDir: string): AssetPlan;
+export interface StageResult {
+    written: number;
+    skipped: number;
+}
+/**
+ * Fetch and write every file in `plan` into `outDir`, skipping any that
+ * are already there — the content-addressed cache. `outDir` is the
+ * on-disk location of `plan.assetDir`. Downloads run in a bounded pool.
+ */
+export declare function stageAssets(stack: StackClient, plan: AssetPlan, outDir: string): Promise<StageResult>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAGnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA2BjE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,oFAAoF;IACpF,cAAc,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAmBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS,CAsDX;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAqBtB"}

package/dist/assets.js

@@ -0,0 +1,148 @@
+/**
+ * @haverstack/eleventy — asset staging
+ * -------------------------------------------------------
+ * Eleventy does not emit binaries well, so attachment bytes are staged to
+ * disk before the build proper and passed through. Content addressing
+ * makes the cache trivially correct: a `fileId` already on disk is never
+ * refetched, and it can never go stale.
+ *
+ * `collectAssets` is pure — it decides which files a site needs and what
+ * they will be named. `stageAssets` does the fetching and writing.
+ *
+ * See docs/design.md § Stage assets.
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { PHOTO } from '@haverstack/commons';
+import { EMBED_LABEL } from './types.js';
+const baseId = (typeId) => typeId.split('@')[0];
+const EXT_BY_MIME = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'image/avif': '.avif',
+    'image/svg+xml': '.svg',
+    'application/pdf': '.pdf',
+    'video/mp4': '.mp4',
+    'audio/mpeg': '.mp3',
+    'text/plain': '.txt',
+};
+function extForMime(mime) {
+    const known = EXT_BY_MIME[mime];
+    if (known)
+        return known;
+    const sub = mime
+        .split('/')[1]
+        ?.split('+')[0]
+        ?.replace(/[^a-z0-9.-]/gi, '');
+    return sub ? `.${sub}` : '.bin';
+}
+function fileRefsIn(record) {
+    // The only `file-ref` content field in the commons publishing types.
+    // Custom types with their own file-ref fields are not scanned yet.
+    if (baseId(record.typeId) === baseId(PHOTO.id) && typeof record.content.image === 'string') {
+        return [record.content.image];
+    }
+    return [];
+}
+function embedFileIds(record) {
+    const out = [];
+    for (const a of record.associations ?? []) {
+        if (a.kind === 'attachment' && a.label === EMBED_LABEL)
+            out.push(a.fileId);
+    }
+    return out;
+}
+/**
+ * Walk every record this site builds — pages and members, listed or not —
+ * and collect the attachment files it references, by `embed` association
+ * and by `file-ref` content field. Filenames for embed substitution are
+ * resolved per record, never globally: two records can each carry an
+ * `image.png` with different bytes.
+ */
+export function collectAssets(resolved, index, assetDir) {
+    const files = new Map();
+    const embedsByRecord = new Map();
+    const warnings = [];
+    const dir = assetDir.replace(/^\/+|\/+$/g, '');
+    const stage = (fileId, forRecord) => {
+        const meta = index.attachmentsByFileId.get(fileId)?.[0];
+        if (!meta) {
+            warnings.push({
+                kind: 'attachment-missing-metadata',
+                recordId: forRecord,
+                message: `Record ${forRecord} references file ${fileId}, which has no _attachment@1 record; skipped.`,
+            });
+            return null;
+        }
+        let staged = files.get(fileId);
+        if (!staged) {
+            const mimeType = String(meta.content.mimeType ?? 'application/octet-stream');
+            const fileName = `${fileId}${extForMime(mimeType)}`;
+            staged = { fileId, fileName, assetPath: `/${dir}/${fileName}`, mimeType };
+            files.set(fileId, staged);
+        }
+        return staged;
+    };
+    const visit = (record) => {
+        for (const fileId of fileRefsIn(record))
+            stage(fileId, record.id);
+        const embedMap = new Map();
+        for (const fileId of embedFileIds(record)) {
+            const staged = stage(fileId, record.id);
+            if (!staged)
+                continue;
+            // One fileId can have several _attachment@1 records (one per upload),
+            // each with its own filename. The body might reference any of them,
+            // so every known name points at the one staged path.
+            for (const meta of index.attachmentsByFileId.get(fileId) ?? []) {
+                const filename = meta.content.filename;
+                if (typeof filename === 'string' && filename)
+                    embedMap.set(filename, staged.assetPath);
+            }
+        }
+        if (embedMap.size > 0)
+            embedsByRecord.set(record.id, embedMap);
+    };
+    const walkPages = (pages) => {
+        for (const page of pages) {
+            visit(page.record);
+            walkPages(page.children);
+        }
+    };
+    walkPages(resolved.pages);
+    for (const member of resolved.members)
+        visit(member.record);
+    return { assetDir: dir, files, embedsByRecord, warnings };
+}
+/** How many attachments to fetch at once — a remote stack is the case this bounds. */
+const DOWNLOAD_CONCURRENCY = 6;
+/**
+ * Fetch and write every file in `plan` into `outDir`, skipping any that
+ * are already there — the content-addressed cache. `outDir` is the
+ * on-disk location of `plan.assetDir`. Downloads run in a bounded pool.
+ */
+export async function stageAssets(stack, plan, outDir) {
+    await mkdir(outDir, { recursive: true });
+    const toFetch = [];
+    let skipped = 0;
+    for (const file of plan.files.values()) {
+        if (existsSync(join(outDir, file.fileName)))
+            skipped++;
+        else
+            toFetch.push(file);
+    }
+    let next = 0;
+    const worker = async () => {
+        while (next < toFetch.length) {
+            const file = toFetch[next++];
+            const bytes = await stack.getAttachment(file.fileId);
+            await writeFile(join(outDir, file.fileName), bytes);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(DOWNLOAD_CONCURRENCY, toFetch.length) }, worker));
+    return { written: toFetch.length, skipped };
+}
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAIzC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,GAA2B;IAC1C,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;IACrB,YAAY,EAAE,OAAO;IACrB,eAAe,EAAE,MAAM;IACvB,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;CACrB,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI;SACb,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACd,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,EAAE,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAClC,CAAC;AAqBD,SAAS,UAAU,CAAC,MAAmB;IACrC,qEAAqE;IACrE,mEAAmE;IACnE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC3F,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,MAAmB;IACvC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAsB,EACtB,KAAiB,EACjB,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;IAChE,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAE/C,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,SAAmB,EAAqB,EAAE;QACvE,MAAM,IAAI,GAAG,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,6BAA6B;gBACnC,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,UAAU,SAAS,oBAAoB,MAAM,+CAA+C;aACtG,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,0BAA0B,CAAC,CAAC;YAC7E,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC;YAC1E,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,MAAmB,EAAQ,EAAE;QAC1C,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,sEAAsE;YACtE,oEAAoE;YACpE,qDAAqD;YACrD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ;oBAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,KAAqD,EAAQ,EAAE;QAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,QAAwB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC;IACF,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO;QAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE5D,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC5D,CAAC;AAOD,sFAAsF;AACtF,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAkB,EAClB,IAAe,EACf,MAAc;IAEd,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;;YAClD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAElG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/dist/check.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @haverstack/eleventy — the `check` command
+ * -------------------------------------------------------
+ * Load + resolve, report structural problems, write and emit nothing.
+ * Read-only and safe against production data. These are the faults an
+ * editing tool structurally cannot catch, because they are only defined
+ * relative to a build: a slug collides only relative to a path, a sidecar
+ * is misdirected only relative to which sites a record is published on.
+ *
+ * See docs/design.md § check.
+ */
+import type { StackClient } from '@haverstack/core';
+import { type SlugStrategy } from './resolve.js';
+export interface CheckItem {
+    kind: string;
+    message: string;
+}
+export interface CheckReport {
+    /** The resolved site's handle, or `null` for a single-site stack. */
+    site: string | null;
+    /** Faults that would also fail a build. */
+    failures: CheckItem[];
+    /** Problems a build tolerates. */
+    warnings: CheckItem[];
+    /** Not problems — an audit of what the build did with edge-case records. */
+    info: CheckItem[];
+}
+export interface CheckOptions {
+    site?: string;
+    slugStrategy?: SlugStrategy;
+}
+export declare function runCheck(stack: StackClient, opts?: CheckOptions): Promise<CheckReport>;
+export declare function formatCheckReport(report: CheckReport): string;
+export declare const checkExitCode: (report: CheckReport) => number;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAgB,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAK7E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,kCAAkC;IAClC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,4EAA4E;IAC5E,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AA8BD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiFhG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAuB7D;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,WAAW,KAAG,MAA8C,CAAC"}

package/dist/check.js

@@ -0,0 +1,141 @@
+/**
+ * @haverstack/eleventy — the `check` command
+ * -------------------------------------------------------
+ * Load + resolve, report structural problems, write and emit nothing.
+ * Read-only and safe against production data. These are the faults an
+ * editing tool structurally cannot catch, because they are only defined
+ * relative to a build: a slug collides only relative to a path, a sidecar
+ * is misdirected only relative to which sites a record is published on.
+ *
+ * See docs/design.md § check.
+ */
+import { ARTICLE, BOOKMARK, PHOTO, POST } from '@haverstack/commons';
+import { load } from './load.js';
+import { resolve } from './resolve.js';
+import { SITE_MEMBERSHIP_LABEL } from './types.js';
+const MEMBER_TYPES = [ARTICLE.id, POST.id, PHOTO.id, BOOKMARK.id];
+async function queryAll(stack, filter) {
+    const out = [];
+    let cursor;
+    do {
+        const page = await stack.query({ filter, cursor, limit: 100 });
+        out.push(...page.records);
+        cursor = page.cursor ?? undefined;
+    } while (cursor);
+    return out;
+}
+const siteMembershipIds = (record) => {
+    const out = [];
+    for (const a of record.associations ?? []) {
+        if (a.kind === 'relationship' &&
+            a.label === SITE_MEMBERSHIP_LABEL &&
+            a.target.scope === 'record') {
+            out.push(a.target.recordId);
+        }
+    }
+    return out;
+};
+const title = (r) => String(r.content.title ?? r.content.caption ?? r.content.text ?? r.id).slice(0, 60);
+export async function runCheck(stack, opts = {}) {
+    const index = await load(stack, { site: opts.site });
+    const resolved = resolve(index, {
+        slugStrategy: opts.slugStrategy ?? 'title',
+        strict: false,
+    });
+    const failures = resolved.errors.map((e) => ({ kind: e.kind, message: e.message }));
+    const warnings = resolved.warnings.map((w) => ({
+        kind: w.kind,
+        message: w.message,
+    }));
+    const info = [];
+    // A sidecar scoped to a site the record it describes isn't published on.
+    for (const [parentId, set] of index.sidecarsByParent) {
+        const record = index.byId.get(parentId);
+        if (!record)
+            continue;
+        const memberships = new Set(siteMembershipIds(record));
+        for (const scopedSiteId of set.bySite.keys()) {
+            if (memberships.has(scopedSiteId))
+                continue;
+            const scopedSite = index.sitesById.get(scopedSiteId);
+            warnings.push({
+                kind: 'sidecar-for-unpublished-site',
+                message: `Record ${parentId} ("${title(record)}") has a page-meta scoped to ` +
+                    `${scopedSite ? `site "${scopedSite.content.handle}"` : scopedSiteId}, ` +
+                    `which it carries no membership association for — usually a forgotten \`site\` association.`,
+            });
+        }
+    }
+    // Member records carrying no `site` association at all.
+    for (const typeId of MEMBER_TYPES) {
+        for (const record of await queryAll(stack, {
+            typeId,
+            ...(index.unlistedVisible ? { includeUnlisted: true } : {}),
+        })) {
+            if (siteMembershipIds(record).length === 0) {
+                warnings.push({
+                    kind: 'record-on-no-site',
+                    message: `${record.id} (${record.typeId}) "${title(record)}" is published on no site.`,
+                });
+            }
+        }
+    }
+    // Unlisted records built this run — nothing else in the output points at them.
+    if (!index.unlistedVisible) {
+        info.push({
+            kind: 'unlisted-not-visible',
+            message: 'Running under a credential that cannot see unlisted records; any built this run ' +
+                'are missing and cannot be reported.',
+        });
+    }
+    else {
+        const report = (url, record, meta) => {
+            const mechanism = record.unlistedAt ? 'unlistedAt' : meta.hidden ? 'hidden' : 'unknown';
+            info.push({
+                kind: 'unlisted-built',
+                message: `${url}  (${mechanism})  "${title(record)}"`,
+            });
+        };
+        const walk = (pages) => {
+            for (const page of pages) {
+                if (page.unlisted)
+                    report(page.url, page.record, page.meta);
+                walk(page.children);
+            }
+        };
+        walk(resolved.pages);
+        for (const member of resolved.members) {
+            if (member.unlisted)
+                report(member.url, member.record, member.meta);
+        }
+    }
+    return {
+        site: resolved.site ? resolved.site.content.handle : null,
+        failures,
+        warnings,
+        info,
+    };
+}
+export function formatCheckReport(report) {
+    const lines = [];
+    const where = report.site ? `site "${report.site}"` : 'the single site';
+    lines.push(`Checked ${where}.\n`);
+    const section = (label, items) => {
+        if (items.length === 0)
+            return;
+        lines.push(`${label}  (${items.length})`);
+        for (const item of items) {
+            lines.push(item.message.includes('\n') ? item.message : `  - ${item.message}`);
+        }
+        lines.push('');
+    };
+    section('FAIL', report.failures);
+    section('WARN', report.warnings);
+    section('INFO', report.info);
+    lines.push(report.failures.length > 0
+        ? `${report.failures.length} failure(s), ${report.warnings.length} warning(s).`
+        : `OK — no failures, ${report.warnings.length} warning(s).`);
+    return lines.join('\n');
+}
+export const checkExitCode = (report) => (report.failures.length > 0 ? 1 : 0);
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @haverstack/eleventy — the `haverstack-eleventy` CLI
+ * -------------------------------------------------------
+ * Two commands that sit alongside the build:
+ *
+ *   haverstack-eleventy check     load + resolve, report problems, write nothing
+ *   haverstack-eleventy publish   stamp canonical URLs on articles and posts
+ *
+ * Both need a stack. They read it from a config module — the same place a
+ * project already builds one for `eleventy.config.js` — so the plugin
+ * package never has to know about adapters or credentials.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/cli.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * @haverstack/eleventy — the `haverstack-eleventy` CLI
+ * -------------------------------------------------------
+ * Two commands that sit alongside the build:
+ *
+ *   haverstack-eleventy check     load + resolve, report problems, write nothing
+ *   haverstack-eleventy publish   stamp canonical URLs on articles and posts
+ *
+ * Both need a stack. They read it from a config module — the same place a
+ * project already builds one for `eleventy.config.js` — so the plugin
+ * package never has to know about adapters or credentials.
+ */
+import { existsSync } from 'node:fs';
+import { resolve as resolvePath } from 'node:path';
+import { parseArgs } from 'node:util';
+import { pathToFileURL } from 'node:url';
+import { checkExitCode, formatCheckReport, runCheck } from './check.js';
+import { formatPublishReport, runPublish } from './publish.js';
+import { formatEjectResult, runEject } from './scaffold.js';
+const USAGE = `haverstack-eleventy <command> [options]
+
+Commands:
+  check      Load and resolve the site; report structural problems. Writes nothing.
+  publish    Stamp canonical URLs on articles and posts that lack one.
+  eject      Write a starter haverstack-base layout into _includes for editing.
+
+Options:
+  --config <path>            check/publish: module providing the stack
+                             (default: ./haverstack.config.mjs). Default-exports a Stack,
+                             a { stack, site? }, or a function returning one.
+  --site <handle>            Site to build. Overrides the config's default.
+  --slug-strategy <s>        'title' (default) or 'recordId'.
+  --dry-run                  publish: show what would be written, write nothing.
+  --includes-dir <path>      eject: where to write (default: _includes).
+  --force                    eject: overwrite existing files.
+  -h, --help
+`;
+async function loadStack(configPath) {
+    const abs = resolvePath(process.cwd(), configPath);
+    if (!existsSync(abs)) {
+        throw new Error(`Config not found: ${configPath}\n` +
+            'Create one that default-exports your Stack (or { stack, site }), or pass --config.');
+    }
+    const mod = (await import(pathToFileURL(abs).href));
+    let value = mod.default ?? mod.stack ?? mod;
+    if (typeof value === 'function')
+        value = await value();
+    const asRecord = value;
+    if (asRecord && typeof asRecord.stack === 'object' && asRecord.stack) {
+        return { stack: asRecord.stack, site: asRecord.site };
+    }
+    if (asRecord && typeof asRecord.query === 'function') {
+        return { stack: value };
+    }
+    throw new Error('Config must default-export a Stack, a { stack, site? }, or a function returning one.');
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+            config: { type: 'string' },
+            site: { type: 'string' },
+            'slug-strategy': { type: 'string' },
+            'dry-run': { type: 'boolean' },
+            'includes-dir': { type: 'string' },
+            force: { type: 'boolean' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    const command = positionals[0];
+    if (values.help || !command) {
+        process.stdout.write(USAGE);
+        process.exit(values.help ? 0 : 1);
+    }
+    if (command !== 'check' && command !== 'publish' && command !== 'eject') {
+        process.stderr.write(`Unknown command: ${command}\n\n${USAGE}`);
+        process.exit(1);
+    }
+    if (command === 'eject') {
+        const dir = values['includes-dir'] ?? '_includes';
+        const result = await runEject(dir, { force: Boolean(values.force) });
+        process.stdout.write(`${formatEjectResult(result, dir)}\n`);
+        process.exit(0);
+    }
+    const strategy = values['slug-strategy'];
+    if (strategy && strategy !== 'title' && strategy !== 'recordId') {
+        process.stderr.write('--slug-strategy must be "title" or "recordId".\n');
+        process.exit(1);
+    }
+    const slugStrategy = (strategy ?? 'title');
+    const { stack, site: configSite } = await loadStack(values.config ?? './haverstack.config.mjs');
+    const site = values.site ?? configSite;
+    try {
+        if (command === 'check') {
+            const report = await runCheck(stack, { site, slugStrategy });
+            process.stdout.write(`${formatCheckReport(report)}\n`);
+            await stack.close();
+            process.exit(checkExitCode(report));
+        }
+        else {
+            const report = await runPublish(stack, {
+                site,
+                slugStrategy,
+                dryRun: Boolean(values['dry-run']),
+            });
+            process.stdout.write(`${formatPublishReport(report)}\n`);
+            await stack.close();
+            process.exit(0);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`\n${err instanceof Error ? err.message : String(err)}\n`);
+        await stack.close().catch(() => { });
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map