@carlonicora/nestjs-neo4jsonapi 1.78.0 → 1.80.0

package/dist/tools/help-content-build/build-manifest.js

@@ -1,134 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildManifest = buildManifest;
-const node_crypto_1 = require("node:crypto");
-const promises_1 = require("node:fs/promises");
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = require("node:path");
-const gray_matter_1 = __importDefault(require("gray-matter"));
-const unified_1 = require("unified");
-const remark_parse_1 = __importDefault(require("remark-parse"));
-const remark_mdx_1 = __importDefault(require("remark-mdx"));
-const frontmatter_schema_1 = require("../../foundations/help-content-sync/schema/frontmatter.schema");
-const help_article_interface_1 = require("../../foundations/help-content-sync/interfaces/help-article.interface");
-// NOTE: buildManifest produces ids using the consumer-provided namespaceUuid.
-// The build script accepts namespaceUuid as a parameter so the manifest's ids
-// match what the runtime sync will compute via toContentId.
-const to_content_id_1 = require("../../foundations/help-content-sync/helpers/to-content-id");
-function slugifyHeading(text) {
-    return text
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "");
-}
-function extractHeadings(tree) {
-    const out = [];
-    function walk(node) {
-        const n = node;
-        if (n.type === "heading" && (n.depth === 2 || n.depth === 3)) {
-            const heading = node;
-            const text = heading.children
-                .map((c) => {
-                const child = c;
-                return typeof child.value === "string" ? child.value : "";
-            })
-                .join("")
-                .trim();
-            out.push({ depth: n.depth, slug: slugifyHeading(text), text });
-        }
-        if (n.children && Array.isArray(n.children))
-            n.children.forEach(walk);
-    }
-    walk(tree);
-    return out;
-}
-function lastUpdatedFromGit(absPath) {
-    try {
-        const iso = (0, node_child_process_1.execSync)(`git log -1 --format=%cI -- "${absPath}"`, { encoding: "utf8" }).trim();
-        if (iso)
-            return iso;
-    }
-    catch {
-        // file not tracked yet
-    }
-    return new Date().toISOString();
-}
-async function walkMdxFiles(dir) {
-    const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
-    const out = [];
-    for (const entry of entries) {
-        const full = (0, node_path_1.join)(dir, entry.name);
-        if (entry.isDirectory())
-            out.push(...(await walkMdxFiles(full)));
-        else if (entry.isFile() && entry.name.endsWith(".mdx"))
-            out.push(full);
-    }
-    return out;
-}
-async function buildManifest(opts) {
-    const { srcDir, outputPath, namespaceUuid, includeDrafts = false } = opts;
-    const mdxFiles = await walkMdxFiles(srcDir);
-    const entries = [];
-    const seenBySlug = new Map();
-    for (const abs of mdxFiles) {
-        const rel = (0, node_path_1.relative)(srcDir, abs).split(node_path_1.sep).join("/");
-        const parts = rel.split("/");
-        if (parts.length !== 2)
-            continue;
-        const [modeFolder, fileName] = parts;
-        if (!help_article_interface_1.HELP_MODES.includes(modeFolder))
-            continue;
-        if (!fileName.endsWith(".mdx"))
-            continue;
-        const slug = fileName.replace(/\.mdx$/, "");
-        const dedupKey = `${modeFolder}/${slug.toLowerCase()}`;
-        if (seenBySlug.has(dedupKey)) {
-            throw new Error(`Duplicate slug detected: ${rel} conflicts with ${seenBySlug.get(dedupKey)}`);
-        }
-        seenBySlug.set(dedupKey, rel);
-        const raw = await (0, promises_1.readFile)(abs, "utf8");
-        const fm = (0, gray_matter_1.default)(raw);
-        const parsed = frontmatter_schema_1.helpFrontmatterSchema.parse(fm.data);
-        if (!includeDrafts && parsed.draft)
-            continue;
-        const tree = (0, unified_1.unified)().use(remark_parse_1.default).use(remark_mdx_1.default).parse(fm.content);
-        const headings = extractHeadings(tree);
-        const contentHash = (0, node_crypto_1.createHash)("sha256").update(raw).digest("hex");
-        entries.push({
-            id: (0, to_content_id_1.toContentId)(modeFolder, slug, namespaceUuid),
-            slug,
-            mode: modeFolder,
-            title: parsed.title,
-            summary: parsed.summary,
-            order: parsed.order,
-            tags: parsed.tags,
-            contextualKeys: parsed.contextual_keys,
-            aiIndexed: parsed.ai_indexed,
-            draft: parsed.draft,
-            contentHash,
-            path: rel,
-            headings,
-            relatedSlugs: parsed.related,
-            lastUpdated: lastUpdatedFromGit(abs),
-        });
-    }
-    const visibleSet = new Set(entries.map((e) => `${e.mode}/${e.slug}`));
-    for (const e of entries) {
-        for (const relSlug of e.relatedSlugs) {
-            if (!visibleSet.has(relSlug)) {
-                throw new Error(`Article ${e.mode}/${e.slug} relates to non-existent ${relSlug}`);
-            }
-        }
-    }
-    entries.sort((a, b) => a.mode.localeCompare(b.mode) || a.order - b.order);
-    const file = `// AUTO-GENERATED by @carlonicora/nestjs-neo4jsonapi/help-content-build. Do not edit by hand.
-import type { HelpArticle } from "@carlonicora/nestjs-neo4jsonapi";
-export const helpManifest: readonly HelpArticle[] = ${JSON.stringify(entries, null, 2)} as const;
-`;
-    await (0, promises_1.writeFile)(outputPath, file, "utf8");
-    return entries;
-}
-//# sourceMappingURL=build-manifest.js.map

package/dist/tools/help-content-build/build-manifest.js.map

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

package/dist/tools/help-content-build/index.d.ts

@@ -1,2 +0,0 @@
-export { buildManifest, type BuildManifestOptions } from "./build-manifest";
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/help-content-build/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/help-content-build/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tools/help-content-build/index.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildManifest = void 0;
-var build_manifest_1 = require("./build-manifest");
-Object.defineProperty(exports, "buildManifest", { enumerable: true, get: function () { return build_manifest_1.buildManifest; } });
-//# sourceMappingURL=index.js.map

package/dist/tools/help-content-build/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/help-content-build/index.ts"],"names":[],"mappings":";;;AAAA,mDAA4E;AAAnE,+GAAA,aAAa,OAAA"}