@carlonicora/nestjs-neo4jsonapi 1.78.0 → 1.79.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/dist/bootstrap/app.module.factory.d.ts.map +1 -1
  2. package/dist/bootstrap/app.module.factory.js +0 -5
  3. package/dist/bootstrap/app.module.factory.js.map +1 -1
  4. package/dist/bootstrap/bootstrap.options.d.ts +0 -9
  5. package/dist/bootstrap/bootstrap.options.d.ts.map +1 -1
  6. package/dist/foundations/how-to/controllers/how-to.controller.d.ts +3 -0
  7. package/dist/foundations/how-to/controllers/how-to.controller.d.ts.map +1 -1
  8. package/dist/foundations/how-to/controllers/how-to.controller.js +41 -0
  9. package/dist/foundations/how-to/controllers/how-to.controller.js.map +1 -1
  10. package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts +14 -0
  11. package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts.map +1 -0
  12. package/dist/foundations/how-to/controllers/how-to.public.controller.js +73 -0
  13. package/dist/foundations/how-to/controllers/how-to.public.controller.js.map +1 -0
  14. package/dist/foundations/how-to/dtos/how-to.post.dto.d.ts +7 -0
  15. package/dist/foundations/how-to/dtos/how-to.post.dto.d.ts.map +1 -1
  16. package/dist/foundations/how-to/dtos/how-to.post.dto.js +38 -0
  17. package/dist/foundations/how-to/dtos/how-to.post.dto.js.map +1 -1
  18. package/dist/foundations/how-to/dtos/how-to.put.dto.d.ts +7 -0
  19. package/dist/foundations/how-to/dtos/how-to.put.dto.d.ts.map +1 -1
  20. package/dist/foundations/how-to/dtos/how-to.put.dto.js +38 -0
  21. package/dist/foundations/how-to/dtos/how-to.put.dto.js.map +1 -1
  22. package/dist/foundations/how-to/entities/how-to.d.ts +7 -2
  23. package/dist/foundations/how-to/entities/how-to.d.ts.map +1 -1
  24. package/dist/foundations/how-to/entities/how-to.js +7 -2
  25. package/dist/foundations/how-to/entities/how-to.js.map +1 -1
  26. package/dist/foundations/how-to/how-to.module.d.ts.map +1 -1
  27. package/dist/foundations/how-to/how-to.module.js +2 -1
  28. package/dist/foundations/how-to/how-to.module.js.map +1 -1
  29. package/dist/foundations/how-to/repositories/how-to.repository.d.ts +40 -4
  30. package/dist/foundations/how-to/repositories/how-to.repository.d.ts.map +1 -1
  31. package/dist/foundations/how-to/repositories/how-to.repository.js +80 -5
  32. package/dist/foundations/how-to/repositories/how-to.repository.js.map +1 -1
  33. package/dist/foundations/how-to/services/how-to.service.d.ts +28 -7
  34. package/dist/foundations/how-to/services/how-to.service.d.ts.map +1 -1
  35. package/dist/foundations/how-to/services/how-to.service.js +60 -9
  36. package/dist/foundations/how-to/services/how-to.service.js.map +1 -1
  37. package/dist/foundations/index.d.ts +0 -1
  38. package/dist/foundations/index.d.ts.map +1 -1
  39. package/dist/foundations/index.js +0 -1
  40. package/dist/foundations/index.js.map +1 -1
  41. package/package.json +1 -5
  42. package/dist/foundations/help-content-sync/help-content-sync.module.d.ts +0 -6
  43. package/dist/foundations/help-content-sync/help-content-sync.module.d.ts.map +0 -1
  44. package/dist/foundations/help-content-sync/help-content-sync.module.js +0 -35
  45. package/dist/foundations/help-content-sync/help-content-sync.module.js.map +0 -1
  46. package/dist/foundations/help-content-sync/helpers/create-help-content-reader.d.ts +0 -5
  47. package/dist/foundations/help-content-sync/helpers/create-help-content-reader.d.ts.map +0 -1
  48. package/dist/foundations/help-content-sync/helpers/create-help-content-reader.js +0 -9
  49. package/dist/foundations/help-content-sync/helpers/create-help-content-reader.js.map +0 -1
  50. package/dist/foundations/help-content-sync/helpers/to-content-id.d.ts +0 -3
  51. package/dist/foundations/help-content-sync/helpers/to-content-id.d.ts.map +0 -1
  52. package/dist/foundations/help-content-sync/helpers/to-content-id.js +0 -8
  53. package/dist/foundations/help-content-sync/helpers/to-content-id.js.map +0 -1
  54. package/dist/foundations/help-content-sync/index.d.ts +0 -7
  55. package/dist/foundations/help-content-sync/index.d.ts.map +0 -1
  56. package/dist/foundations/help-content-sync/index.js +0 -28
  57. package/dist/foundations/help-content-sync/index.js.map +0 -1
  58. package/dist/foundations/help-content-sync/interfaces/help-article.interface.d.ts +0 -29
  59. package/dist/foundations/help-content-sync/interfaces/help-article.interface.d.ts.map +0 -1
  60. package/dist/foundations/help-content-sync/interfaces/help-article.interface.js +0 -5
  61. package/dist/foundations/help-content-sync/interfaces/help-article.interface.js.map +0 -1
  62. package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.d.ts +0 -8
  63. package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.d.ts.map +0 -1
  64. package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.js +0 -3
  65. package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.js.map +0 -1
  66. package/dist/foundations/help-content-sync/schema/frontmatter.schema.d.ts +0 -19
  67. package/dist/foundations/help-content-sync/schema/frontmatter.schema.d.ts.map +0 -1
  68. package/dist/foundations/help-content-sync/schema/frontmatter.schema.js +0 -20
  69. package/dist/foundations/help-content-sync/schema/frontmatter.schema.js.map +0 -1
  70. package/dist/foundations/help-content-sync/services/help-content-sync.service.d.ts +0 -21
  71. package/dist/foundations/help-content-sync/services/help-content-sync.service.d.ts.map +0 -1
  72. package/dist/foundations/help-content-sync/services/help-content-sync.service.js +0 -111
  73. package/dist/foundations/help-content-sync/services/help-content-sync.service.js.map +0 -1
  74. package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts +0 -13
  75. package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts.map +0 -1
  76. package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js +0 -104
  77. package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js.map +0 -1
  78. package/dist/foundations/help-content-sync/tokens.d.ts +0 -2
  79. package/dist/foundations/help-content-sync/tokens.d.ts.map +0 -1
  80. package/dist/foundations/help-content-sync/tokens.js +0 -5
  81. package/dist/foundations/help-content-sync/tokens.js.map +0 -1
  82. package/dist/tools/help-content-build/build-manifest.d.ts +0 -31
  83. package/dist/tools/help-content-build/build-manifest.d.ts.map +0 -1
  84. package/dist/tools/help-content-build/build-manifest.js +0 -134
  85. package/dist/tools/help-content-build/build-manifest.js.map +0 -1
  86. package/dist/tools/help-content-build/index.d.ts +0 -2
  87. package/dist/tools/help-content-build/index.d.ts.map +0 -1
  88. package/dist/tools/help-content-build/index.js +0 -6
  89. package/dist/tools/help-content-build/index.js.map +0 -1
@@ -1,20 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.helpFrontmatterSchema = void 0;
4
- const zod_1 = require("zod");
5
- const help_article_interface_1 = require("../interfaces/help-article.interface");
6
- exports.helpFrontmatterSchema = zod_1.z.object({
7
- title: zod_1.z.string().min(1),
8
- mode: zod_1.z.enum(help_article_interface_1.HELP_MODES),
9
- order: zod_1.z.number().int(),
10
- summary: zod_1.z.string().min(1),
11
- tags: zod_1.z.array(zod_1.z.string()).optional().default([]),
12
- contextual_keys: zod_1.z
13
- .array(zod_1.z.string().regex(/^[a-z][a-z0-9-]*\.[a-z][a-z0-9-]*$/))
14
- .optional()
15
- .default([]),
16
- ai_indexed: zod_1.z.boolean().optional().default(true),
17
- draft: zod_1.z.boolean().optional().default(false),
18
- related: zod_1.z.array(zod_1.z.string()).optional().default([]),
19
- });
20
- //# sourceMappingURL=frontmatter.schema.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"frontmatter.schema.js","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/schema/frontmatter.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iFAAkE;AAErD,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,mCAAU,CAAC;IACxB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,eAAe,EAAE,OAAC;SACf,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;SAC7D,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;IACd,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACpD,CAAC,CAAC"}
@@ -1,21 +0,0 @@
1
- import { OnApplicationBootstrap } from "@nestjs/common";
2
- import { ClsService } from "nestjs-cls";
3
- import { HowToRepository } from "../../how-to/repositories/how-to.repository";
4
- import { HowToService } from "../../how-to/services/how-to.service";
5
- import { RedisLockService } from "../../../core/redis/services/redis.lock.service";
6
- import { MdxToMarkdownService } from "./mdx-to-markdown.service";
7
- import { HelpContentConfig } from "../interfaces/help-content-config.interface";
8
- export declare class HelpContentSyncService implements OnApplicationBootstrap {
9
- private readonly config;
10
- private readonly howToRepository;
11
- private readonly howToService;
12
- private readonly mdxToMarkdown;
13
- private readonly lock;
14
- private readonly clsService;
15
- private readonly logger;
16
- constructor(config: HelpContentConfig, howToRepository: HowToRepository, howToService: HowToService, mdxToMarkdown: MdxToMarkdownService, lock: RedisLockService, clsService: ClsService);
17
- onApplicationBootstrap(): void;
18
- run(): Promise<void>;
19
- private runInsideCls;
20
- }
21
- //# sourceMappingURL=help-content-sync.service.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"help-content-sync.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/help-content-sync.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAMhF,qBACa,sBAAuB,YAAW,sBAAsB;IAI9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;gBAGZ,MAAM,EAAE,iBAAiB,EAC5D,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,oBAAoB,EACnC,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,UAAU;IAGzC,sBAAsB,IAAI,IAAI;IAMxB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAQZ,YAAY;CA6D3B"}
@@ -1,111 +0,0 @@
1
- "use strict";
2
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
- return c > 3 && r && Object.defineProperty(target, key, r), r;
7
- };
8
- var __metadata = (this && this.__metadata) || function (k, v) {
9
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
- };
11
- var __param = (this && this.__param) || function (paramIndex, decorator) {
12
- return function (target, key) { decorator(target, key, paramIndex); }
13
- };
14
- var HelpContentSyncService_1;
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.HelpContentSyncService = void 0;
17
- const common_1 = require("@nestjs/common");
18
- const nestjs_cls_1 = require("nestjs-cls");
19
- const how_to_repository_1 = require("../../how-to/repositories/how-to.repository");
20
- const how_to_service_1 = require("../../how-to/services/how-to.service");
21
- const redis_lock_service_1 = require("../../../core/redis/services/redis.lock.service");
22
- const mdx_to_markdown_service_1 = require("./mdx-to-markdown.service");
23
- const tokens_1 = require("../tokens");
24
- const to_content_id_1 = require("../helpers/to-content-id");
25
- const LOCK_KEY = "nestjs-neo4jsonapi:help-content-sync:lock";
26
- const LOCK_TTL_SECONDS = 300;
27
- let HelpContentSyncService = HelpContentSyncService_1 = class HelpContentSyncService {
28
- constructor(config, howToRepository, howToService, mdxToMarkdown, lock, clsService) {
29
- this.config = config;
30
- this.howToRepository = howToRepository;
31
- this.howToService = howToService;
32
- this.mdxToMarkdown = mdxToMarkdown;
33
- this.lock = lock;
34
- this.clsService = clsService;
35
- this.logger = new common_1.Logger(HelpContentSyncService_1.name);
36
- }
37
- onApplicationBootstrap() {
38
- void this.run().catch((err) => this.logger.error(`Help content sync failed: ${err.message}`, err.stack));
39
- }
40
- async run() {
41
- await this.lock.withLock(LOCK_KEY, LOCK_TTL_SECONDS, async () => {
42
- await this.clsService.run(async () => {
43
- await this.runInsideCls();
44
- });
45
- });
46
- }
47
- async runInsideCls() {
48
- const articles = this.config.manifest.filter((a) => a.aiIndexed && !a.draft);
49
- let created = 0, updated = 0, skipped = 0, redirected = 0, deleted = 0;
50
- for (const article of articles) {
51
- const id = (0, to_content_id_1.toContentId)(article.mode, article.slug, this.config.namespaceUuid);
52
- const existing = await this.howToService.findRecordById({ id });
53
- const plainMarkdown = await this.mdxToMarkdown.convert(await this.config.readRawMarkdown(article));
54
- const baseFields = {
55
- id,
56
- name: article.title,
57
- description: article.summary,
58
- pages: plainMarkdown,
59
- helpContentSlug: `${article.mode}/${article.slug}`,
60
- contentHash: article.contentHash,
61
- };
62
- if (!existing) {
63
- await this.howToRepository.create(baseFields);
64
- await this.howToService.queueHowToForProcessingFromMarkdown({
65
- howToId: id,
66
- markdown: plainMarkdown,
67
- });
68
- created++;
69
- }
70
- else if (existing.contentHash !== article.contentHash) {
71
- await this.howToRepository.patch(baseFields);
72
- await this.howToService.queueHowToForProcessingFromMarkdown({
73
- howToId: id,
74
- markdown: plainMarkdown,
75
- });
76
- updated++;
77
- }
78
- else {
79
- skipped++;
80
- }
81
- }
82
- const manifestSlugs = new Set(articles.map((a) => `${a.mode}/${a.slug}`));
83
- const managed = await this.howToRepository.findAllWithHelpContentSlug();
84
- const redirects = this.config.redirects ?? [];
85
- for (const orphan of managed) {
86
- if (!orphan.helpContentSlug || manifestSlugs.has(orphan.helpContentSlug))
87
- continue;
88
- const moved = redirects.find((r) => r.from === orphan.helpContentSlug);
89
- if (moved) {
90
- await this.howToRepository.patch({ id: orphan.id, helpContentSlug: moved.to });
91
- redirected++;
92
- }
93
- else {
94
- await this.howToRepository.delete({ id: orphan.id });
95
- deleted++;
96
- }
97
- }
98
- this.logger.log(`Help content sync done — created=${created} updated=${updated} skipped=${skipped} redirected=${redirected} deleted=${deleted}`);
99
- }
100
- };
101
- exports.HelpContentSyncService = HelpContentSyncService;
102
- exports.HelpContentSyncService = HelpContentSyncService = HelpContentSyncService_1 = __decorate([
103
- (0, common_1.Injectable)(),
104
- __param(0, (0, common_1.Inject)(tokens_1.HELP_CONTENT_CONFIG_TOKEN)),
105
- __metadata("design:paramtypes", [Object, how_to_repository_1.HowToRepository,
106
- how_to_service_1.HowToService,
107
- mdx_to_markdown_service_1.MdxToMarkdownService,
108
- redis_lock_service_1.RedisLockService,
109
- nestjs_cls_1.ClsService])
110
- ], HelpContentSyncService);
111
- //# sourceMappingURL=help-content-sync.service.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"help-content-sync.service.js","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/help-content-sync.service.ts"],"names":[],"mappings":"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"}
@@ -1,13 +0,0 @@
1
- export declare class MdxToMarkdownService {
2
- /**
3
- * Convert MDX source into plain markdown suitable for the chunker.
4
- * Known JSX components are rewritten to text-equivalent markdown;
5
- * unknown JSX is dropped silently.
6
- */
7
- convert(mdx: string): Promise<string>;
8
- private transformTree;
9
- private transformNode;
10
- private transformJsx;
11
- private flattenText;
12
- }
13
- //# sourceMappingURL=mdx-to-markdown.service.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mdx-to-markdown.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/mdx-to-markdown.service.ts"],"names":[],"mappings":"AAUA,qBACa,oBAAoB;IAC/B;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,WAAW;CAMpB"}
@@ -1,104 +0,0 @@
1
- "use strict";
2
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
- else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
- return c > 3 && r && Object.defineProperty(target, key, r), r;
7
- };
8
- var __importDefault = (this && this.__importDefault) || function (mod) {
9
- return (mod && mod.__esModule) ? mod : { "default": mod };
10
- };
11
- Object.defineProperty(exports, "__esModule", { value: true });
12
- exports.MdxToMarkdownService = void 0;
13
- const common_1 = require("@nestjs/common");
14
- const unified_1 = require("unified");
15
- const remark_parse_1 = __importDefault(require("remark-parse"));
16
- const remark_mdx_1 = __importDefault(require("remark-mdx"));
17
- const mdast_util_to_markdown_1 = require("mdast-util-to-markdown");
18
- const mdast_util_mdx_1 = require("mdast-util-mdx");
19
- let MdxToMarkdownService = class MdxToMarkdownService {
20
- /**
21
- * Convert MDX source into plain markdown suitable for the chunker.
22
- * Known JSX components are rewritten to text-equivalent markdown;
23
- * unknown JSX is dropped silently.
24
- */
25
- async convert(mdx) {
26
- const tree = (0, unified_1.unified)().use(remark_parse_1.default).use(remark_mdx_1.default).parse(mdx);
27
- const transformed = this.transformTree(tree);
28
- return (0, mdast_util_to_markdown_1.toMarkdown)(transformed, { extensions: [(0, mdast_util_mdx_1.mdxToMarkdown)()] });
29
- }
30
- transformTree(tree) {
31
- tree.children = tree.children.flatMap((child) => this.transformNode(child));
32
- return tree;
33
- }
34
- transformNode(node) {
35
- if (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") {
36
- return this.transformJsx(node);
37
- }
38
- if ("children" in node && Array.isArray(node.children)) {
39
- node.children = node.children.flatMap((c) => this.transformNode(c));
40
- }
41
- return [node];
42
- }
43
- transformJsx(node) {
44
- switch (node.name) {
45
- case "Callout": {
46
- const typeAttr = (node.attributes ?? []).find((a) => a.name === "type");
47
- const type = typeAttr?.value ?? "info";
48
- const prefix = `${String(type).charAt(0).toUpperCase() + String(type).slice(1)}: `;
49
- const innerText = this.flattenText(node);
50
- return [
51
- {
52
- type: "blockquote",
53
- children: [{ type: "paragraph", children: [{ type: "text", value: prefix + innerText }] }],
54
- },
55
- ];
56
- }
57
- case "Steps": {
58
- const steps = (node.children ?? []).filter((c) => (c.type === "mdxJsxFlowElement" || c.type === "mdxJsxTextElement") && c.name === "Step");
59
- return [
60
- {
61
- type: "list",
62
- ordered: true,
63
- start: 1,
64
- spread: false,
65
- children: steps.map((s) => ({
66
- type: "listItem",
67
- spread: false,
68
- children: [{ type: "paragraph", children: [{ type: "text", value: this.flattenText(s) }] }],
69
- })),
70
- },
71
- ];
72
- }
73
- case "Screenshot": {
74
- const caption = (node.attributes ?? []).find((a) => a.name === "caption")?.value ?? "image";
75
- return [{ type: "paragraph", children: [{ type: "text", value: `[Screenshot: ${caption}]` }] }];
76
- }
77
- case "Video": {
78
- const src = (node.attributes ?? []).find((a) => a.name === "src")?.value ?? "";
79
- return [{ type: "paragraph", children: [{ type: "text", value: `[Video: ${src}]` }] }];
80
- }
81
- case "EntityRef":
82
- case "KeyBinding": {
83
- return [{ type: "text", value: this.flattenText(node) }];
84
- }
85
- case "Related":
86
- default:
87
- return [];
88
- }
89
- }
90
- flattenText(node) {
91
- if (!node)
92
- return "";
93
- if (typeof node.value === "string")
94
- return node.value;
95
- if (Array.isArray(node.children))
96
- return node.children.map((c) => this.flattenText(c)).join("");
97
- return "";
98
- }
99
- };
100
- exports.MdxToMarkdownService = MdxToMarkdownService;
101
- exports.MdxToMarkdownService = MdxToMarkdownService = __decorate([
102
- (0, common_1.Injectable)()
103
- ], MdxToMarkdownService);
104
- //# sourceMappingURL=mdx-to-markdown.service.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mdx-to-markdown.service.js","sourceRoot":"","sources":["../../../../src/foundations/help-content-sync/services/mdx-to-markdown.service.ts"],"names":[],"mappings":"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"}
@@ -1,2 +0,0 @@
1
- export declare const HELP_CONTENT_CONFIG_TOKEN: unique symbol;
2
- //# sourceMappingURL=tokens.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/foundations/help-content-sync/tokens.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,eAAsC,CAAC"}
@@ -1,5 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.HELP_CONTENT_CONFIG_TOKEN = void 0;
4
- exports.HELP_CONTENT_CONFIG_TOKEN = Symbol("HELP_CONTENT_CONFIG_TOKEN");
5
- //# sourceMappingURL=tokens.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/foundations/help-content-sync/tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC"}
@@ -1,31 +0,0 @@
1
- import { HelpMode } from "../../foundations/help-content-sync/interfaces/help-article.interface";
2
- export interface BuildManifestOptions {
3
- srcDir: string;
4
- outputPath: string;
5
- namespaceUuid: string;
6
- includeDrafts?: boolean;
7
- }
8
- interface BuiltEntry {
9
- id: string;
10
- slug: string;
11
- mode: HelpMode;
12
- title: string;
13
- summary: string;
14
- order: number;
15
- tags: string[];
16
- contextualKeys: string[];
17
- aiIndexed: boolean;
18
- draft: boolean;
19
- contentHash: string;
20
- path: string;
21
- headings: {
22
- depth: 2 | 3;
23
- slug: string;
24
- text: string;
25
- }[];
26
- relatedSlugs: string[];
27
- lastUpdated: string;
28
- }
29
- export declare function buildManifest(opts: BuildManifestOptions): Promise<BuiltEntry[]>;
30
- export {};
31
- //# sourceMappingURL=build-manifest.d.ts.map
@@ -1 +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"}
@@ -1,134 +0,0 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.buildManifest = buildManifest;
7
- const node_crypto_1 = require("node:crypto");
8
- const promises_1 = require("node:fs/promises");
9
- const node_child_process_1 = require("node:child_process");
10
- const node_path_1 = require("node:path");
11
- const gray_matter_1 = __importDefault(require("gray-matter"));
12
- const unified_1 = require("unified");
13
- const remark_parse_1 = __importDefault(require("remark-parse"));
14
- const remark_mdx_1 = __importDefault(require("remark-mdx"));
15
- const frontmatter_schema_1 = require("../../foundations/help-content-sync/schema/frontmatter.schema");
16
- const help_article_interface_1 = require("../../foundations/help-content-sync/interfaces/help-article.interface");
17
- // NOTE: buildManifest produces ids using the consumer-provided namespaceUuid.
18
- // The build script accepts namespaceUuid as a parameter so the manifest's ids
19
- // match what the runtime sync will compute via toContentId.
20
- const to_content_id_1 = require("../../foundations/help-content-sync/helpers/to-content-id");
21
- function slugifyHeading(text) {
22
- return text
23
- .toLowerCase()
24
- .replace(/[^a-z0-9]+/g, "-")
25
- .replace(/^-|-$/g, "");
26
- }
27
- function extractHeadings(tree) {
28
- const out = [];
29
- function walk(node) {
30
- const n = node;
31
- if (n.type === "heading" && (n.depth === 2 || n.depth === 3)) {
32
- const heading = node;
33
- const text = heading.children
34
- .map((c) => {
35
- const child = c;
36
- return typeof child.value === "string" ? child.value : "";
37
- })
38
- .join("")
39
- .trim();
40
- out.push({ depth: n.depth, slug: slugifyHeading(text), text });
41
- }
42
- if (n.children && Array.isArray(n.children))
43
- n.children.forEach(walk);
44
- }
45
- walk(tree);
46
- return out;
47
- }
48
- function lastUpdatedFromGit(absPath) {
49
- try {
50
- const iso = (0, node_child_process_1.execSync)(`git log -1 --format=%cI -- "${absPath}"`, { encoding: "utf8" }).trim();
51
- if (iso)
52
- return iso;
53
- }
54
- catch {
55
- // file not tracked yet
56
- }
57
- return new Date().toISOString();
58
- }
59
- async function walkMdxFiles(dir) {
60
- const entries = await (0, promises_1.readdir)(dir, { withFileTypes: true });
61
- const out = [];
62
- for (const entry of entries) {
63
- const full = (0, node_path_1.join)(dir, entry.name);
64
- if (entry.isDirectory())
65
- out.push(...(await walkMdxFiles(full)));
66
- else if (entry.isFile() && entry.name.endsWith(".mdx"))
67
- out.push(full);
68
- }
69
- return out;
70
- }
71
- async function buildManifest(opts) {
72
- const { srcDir, outputPath, namespaceUuid, includeDrafts = false } = opts;
73
- const mdxFiles = await walkMdxFiles(srcDir);
74
- const entries = [];
75
- const seenBySlug = new Map();
76
- for (const abs of mdxFiles) {
77
- const rel = (0, node_path_1.relative)(srcDir, abs).split(node_path_1.sep).join("/");
78
- const parts = rel.split("/");
79
- if (parts.length !== 2)
80
- continue;
81
- const [modeFolder, fileName] = parts;
82
- if (!help_article_interface_1.HELP_MODES.includes(modeFolder))
83
- continue;
84
- if (!fileName.endsWith(".mdx"))
85
- continue;
86
- const slug = fileName.replace(/\.mdx$/, "");
87
- const dedupKey = `${modeFolder}/${slug.toLowerCase()}`;
88
- if (seenBySlug.has(dedupKey)) {
89
- throw new Error(`Duplicate slug detected: ${rel} conflicts with ${seenBySlug.get(dedupKey)}`);
90
- }
91
- seenBySlug.set(dedupKey, rel);
92
- const raw = await (0, promises_1.readFile)(abs, "utf8");
93
- const fm = (0, gray_matter_1.default)(raw);
94
- const parsed = frontmatter_schema_1.helpFrontmatterSchema.parse(fm.data);
95
- if (!includeDrafts && parsed.draft)
96
- continue;
97
- const tree = (0, unified_1.unified)().use(remark_parse_1.default).use(remark_mdx_1.default).parse(fm.content);
98
- const headings = extractHeadings(tree);
99
- const contentHash = (0, node_crypto_1.createHash)("sha256").update(raw).digest("hex");
100
- entries.push({
101
- id: (0, to_content_id_1.toContentId)(modeFolder, slug, namespaceUuid),
102
- slug,
103
- mode: modeFolder,
104
- title: parsed.title,
105
- summary: parsed.summary,
106
- order: parsed.order,
107
- tags: parsed.tags,
108
- contextualKeys: parsed.contextual_keys,
109
- aiIndexed: parsed.ai_indexed,
110
- draft: parsed.draft,
111
- contentHash,
112
- path: rel,
113
- headings,
114
- relatedSlugs: parsed.related,
115
- lastUpdated: lastUpdatedFromGit(abs),
116
- });
117
- }
118
- const visibleSet = new Set(entries.map((e) => `${e.mode}/${e.slug}`));
119
- for (const e of entries) {
120
- for (const relSlug of e.relatedSlugs) {
121
- if (!visibleSet.has(relSlug)) {
122
- throw new Error(`Article ${e.mode}/${e.slug} relates to non-existent ${relSlug}`);
123
- }
124
- }
125
- }
126
- entries.sort((a, b) => a.mode.localeCompare(b.mode) || a.order - b.order);
127
- const file = `// AUTO-GENERATED by @carlonicora/nestjs-neo4jsonapi/help-content-build. Do not edit by hand.
128
- import type { HelpArticle } from "@carlonicora/nestjs-neo4jsonapi";
129
- export const helpManifest: readonly HelpArticle[] = ${JSON.stringify(entries, null, 2)} as const;
130
- `;
131
- await (0, promises_1.writeFile)(outputPath, file, "utf8");
132
- return entries;
133
- }
134
- //# sourceMappingURL=build-manifest.js.map
@@ -1 +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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"}
@@ -1,2 +0,0 @@
1
- export { buildManifest, type BuildManifestOptions } from "./build-manifest";
2
- //# sourceMappingURL=index.d.ts.map
@@ -1 +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"}
@@ -1,6 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.buildManifest = void 0;
4
- var build_manifest_1 = require("./build-manifest");
5
- Object.defineProperty(exports, "buildManifest", { enumerable: true, get: function () { return build_manifest_1.buildManifest; } });
6
- //# sourceMappingURL=index.js.map
@@ -1 +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"}