@carlonicora/nestjs-neo4jsonapi 1.75.0 → 1.77.0

package/dist/foundations/keyconcept/services/keyconcept.service.d.ts

@@ -13,7 +13,7 @@ export declare class KeyConceptService {
         chunkId: string;
     }): Promise<void>;
     addKeyConceptRelationships(params: {
-        companyId: string;
+        companyId?: string;
         chunkId: string;
         relationships: {
             keyConcept1: string;

package/dist/foundations/keyconcept/services/keyconcept.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyconcept.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/keyconcept/services/keyconcept.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAE3F,qBACa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,oBAAoB;IAEjE,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9E,gBAAgB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlF,kDAAkD,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9F,0BAA0B,CAAC,MAAM,EAAE;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;KACL,GAAG,OAAO,CAAC,IAAI,CAAC;IAQX,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrD"}
+{"version":3,"file":"keyconcept.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/keyconcept/services/keyconcept.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAE3F,qBACa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,oBAAoB;IAEjE,uBAAuB,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9E,gBAAgB,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlF,kDAAkD,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9F,0BAA0B,CAAC,MAAM,EAAE;QACvC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;KACL,GAAG,OAAO,CAAC,IAAI,CAAC;IAQX,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrD"}

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from "./foundations";
 export * from "./agents";
 export * from "./bootstrap";
 export * from "./openapi";
+export { RedisLockService } from "./core/redis/services/redis.lock.service";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC"}

package/dist/index.js

@@ -19,6 +19,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisLockService = void 0;
 // Common exports
 __exportStar(require("./common"), exports);
 // Config exports
@@ -35,4 +36,7 @@ __exportStar(require("./agents"), exports);
 __exportStar(require("./bootstrap"), exports);
 // OpenAPI module exports
 __exportStar(require("./openapi"), exports);
+// RedisLockService is not re-exported by core/redis/index.ts, so export explicitly here.
+var redis_lock_service_1 = require("./core/redis/services/redis.lock.service");
+Object.defineProperty(exports, "RedisLockService", { enumerable: true, get: function () { return redis_lock_service_1.RedisLockService; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,2CAAyB;AAEzB,iBAAiB;AACjB,2CAAyB;AAEzB,sBAAsB;AACtB,yCAAuB;AACvB,6CAA2B;AAC3B,kDAAgC;AAEhC,4BAA4B;AAC5B,gDAA8B;AAE9B,uBAAuB;AACvB,2CAAyB;AAEzB,sBAAsB;AACtB,8CAA4B;AAE5B,yBAAyB;AACzB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,iBAAiB;AACjB,2CAAyB;AAEzB,iBAAiB;AACjB,2CAAyB;AAEzB,sBAAsB;AACtB,yCAAuB;AACvB,6CAA2B;AAC3B,kDAAgC;AAEhC,4BAA4B;AAC5B,gDAA8B;AAE9B,uBAAuB;AACvB,2CAAyB;AAEzB,sBAAsB;AACtB,8CAA4B;AAE5B,yBAAyB;AACzB,4CAA0B;AAE1B,yFAAyF;AACzF,+EAA4E;AAAnE,sHAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,31 @@
+import { HelpMode } from "../../foundations/help-content-sync/interfaces/help-article.interface";
+export interface BuildManifestOptions {
+    srcDir: string;
+    outputPath: string;
+    namespaceUuid: string;
+    includeDrafts?: boolean;
+}
+interface BuiltEntry {
+    id: string;
+    slug: string;
+    mode: HelpMode;
+    title: string;
+    summary: string;
+    order: number;
+    tags: string[];
+    contextualKeys: string[];
+    aiIndexed: boolean;
+    draft: boolean;
+    contentHash: string;
+    path: string;
+    headings: {
+        depth: 2 | 3;
+        slug: string;
+        text: string;
+    }[];
+    relatedSlugs: string[];
+    lastUpdated: string;
+}
+export declare function buildManifest(opts: BuildManifestOptions): Promise<BuiltEntry[]>;
+export {};
+//# sourceMappingURL=build-manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest.d.ts","sourceRoot":"","sources":["../../../src/tools/help-content-build/build-manifest.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,QAAQ,EAAE,MAAM,uEAAuE,CAAC;AAM7G,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAmDD,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiErF"}

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

@@ -0,0 +1,134 @@
+"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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+"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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.75.0",
+  "version": "1.77.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -47,6 +47,10 @@
     "./bootstrap": {
       "types": "./dist/bootstrap/index.d.ts",
       "default": "./dist/bootstrap/index.js"
+    },
+    "./help-content-build": {
+      "types": "./dist/tools/help-content-build/index.d.ts",
+      "default": "./dist/tools/help-content-build/index.js"
     }
   },
   "scripts": {
@@ -63,6 +67,7 @@
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.0",
     "@aws-sdk/client-s3": "^3.1053.0",
     "@aws-sdk/s3-request-presigner": "^3.1053.0",
     "@azure/storage-blob": "^12.31.0",
@@ -83,6 +88,14 @@
     "@sendgrid/mail": "^8.1.6",
     "@simplewebauthn/server": "^13.3.0",
     "adm-zip": "^0.5.17",
+    "gray-matter": "^4.0.3",
+    "mdast-util-mdx": "^3.0.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "remark-mdx": "^3.1.1",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5",
+    "uuid": "^14.0.0",
+    "ai": "^6.0.5",
     "axios": "^1.16.1",
     "bcrypt": "^6.0.0",
     "bcryptjs": "^3.0.3",
@@ -90,7 +103,7 @@
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.3",
     "discord.js": "^14.26.4",
-    "docx": "^9.6.1",
+    "docx": "9.6.1",
     "docx-templates": "^4.15.0",
     "fast-xml-parser": "^5.8.0",
     "fastify": "^5.8.5",
@@ -142,7 +155,9 @@
     "@swc/core": "^1.15.33",
     "@types/bcrypt": "^6.0.0",
     "@types/bcryptjs": "^3.0.0",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^25.9.1",
+    "@types/uuid": "^10.0.0",
     "@types/nodemailer": "^8.0.0",
     "@types/passport-jwt": "^4.0.1",
     "@types/qrcode": "^1.5.6",