@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.
- package/dist/bootstrap/app.module.factory.d.ts.map +1 -1
- package/dist/bootstrap/app.module.factory.js +0 -5
- package/dist/bootstrap/app.module.factory.js.map +1 -1
- package/dist/bootstrap/bootstrap.options.d.ts +0 -9
- package/dist/bootstrap/bootstrap.options.d.ts.map +1 -1
- package/dist/foundations/how-to/controllers/how-to.controller.d.ts +3 -0
- package/dist/foundations/how-to/controllers/how-to.controller.d.ts.map +1 -1
- package/dist/foundations/how-to/controllers/how-to.controller.js +41 -0
- package/dist/foundations/how-to/controllers/how-to.controller.js.map +1 -1
- package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts +14 -0
- package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts.map +1 -0
- package/dist/foundations/how-to/controllers/how-to.public.controller.js +73 -0
- package/dist/foundations/how-to/controllers/how-to.public.controller.js.map +1 -0
- package/dist/foundations/how-to/dtos/how-to.post.dto.d.ts +7 -0
- package/dist/foundations/how-to/dtos/how-to.post.dto.d.ts.map +1 -1
- package/dist/foundations/how-to/dtos/how-to.post.dto.js +38 -0
- package/dist/foundations/how-to/dtos/how-to.post.dto.js.map +1 -1
- package/dist/foundations/how-to/dtos/how-to.put.dto.d.ts +7 -0
- package/dist/foundations/how-to/dtos/how-to.put.dto.d.ts.map +1 -1
- package/dist/foundations/how-to/dtos/how-to.put.dto.js +38 -0
- package/dist/foundations/how-to/dtos/how-to.put.dto.js.map +1 -1
- package/dist/foundations/how-to/entities/how-to.d.ts +7 -2
- package/dist/foundations/how-to/entities/how-to.d.ts.map +1 -1
- package/dist/foundations/how-to/entities/how-to.js +7 -2
- package/dist/foundations/how-to/entities/how-to.js.map +1 -1
- package/dist/foundations/how-to/how-to.module.d.ts.map +1 -1
- package/dist/foundations/how-to/how-to.module.js +2 -1
- package/dist/foundations/how-to/how-to.module.js.map +1 -1
- package/dist/foundations/how-to/repositories/how-to.repository.d.ts +40 -4
- package/dist/foundations/how-to/repositories/how-to.repository.d.ts.map +1 -1
- package/dist/foundations/how-to/repositories/how-to.repository.js +80 -5
- package/dist/foundations/how-to/repositories/how-to.repository.js.map +1 -1
- package/dist/foundations/how-to/services/how-to.service.d.ts +28 -7
- package/dist/foundations/how-to/services/how-to.service.d.ts.map +1 -1
- package/dist/foundations/how-to/services/how-to.service.js +60 -9
- package/dist/foundations/how-to/services/how-to.service.js.map +1 -1
- package/dist/foundations/index.d.ts +0 -1
- package/dist/foundations/index.d.ts.map +1 -1
- package/dist/foundations/index.js +0 -1
- package/dist/foundations/index.js.map +1 -1
- package/package.json +1 -5
- package/dist/foundations/help-content-sync/help-content-sync.module.d.ts +0 -6
- package/dist/foundations/help-content-sync/help-content-sync.module.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/help-content-sync.module.js +0 -35
- package/dist/foundations/help-content-sync/help-content-sync.module.js.map +0 -1
- package/dist/foundations/help-content-sync/helpers/create-help-content-reader.d.ts +0 -5
- package/dist/foundations/help-content-sync/helpers/create-help-content-reader.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/helpers/create-help-content-reader.js +0 -9
- package/dist/foundations/help-content-sync/helpers/create-help-content-reader.js.map +0 -1
- package/dist/foundations/help-content-sync/helpers/to-content-id.d.ts +0 -3
- package/dist/foundations/help-content-sync/helpers/to-content-id.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/helpers/to-content-id.js +0 -8
- package/dist/foundations/help-content-sync/helpers/to-content-id.js.map +0 -1
- package/dist/foundations/help-content-sync/index.d.ts +0 -7
- package/dist/foundations/help-content-sync/index.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/index.js +0 -28
- package/dist/foundations/help-content-sync/index.js.map +0 -1
- package/dist/foundations/help-content-sync/interfaces/help-article.interface.d.ts +0 -29
- package/dist/foundations/help-content-sync/interfaces/help-article.interface.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/interfaces/help-article.interface.js +0 -5
- package/dist/foundations/help-content-sync/interfaces/help-article.interface.js.map +0 -1
- package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.d.ts +0 -8
- package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.js +0 -3
- package/dist/foundations/help-content-sync/interfaces/help-content-config.interface.js.map +0 -1
- package/dist/foundations/help-content-sync/schema/frontmatter.schema.d.ts +0 -19
- package/dist/foundations/help-content-sync/schema/frontmatter.schema.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/schema/frontmatter.schema.js +0 -20
- package/dist/foundations/help-content-sync/schema/frontmatter.schema.js.map +0 -1
- package/dist/foundations/help-content-sync/services/help-content-sync.service.d.ts +0 -21
- package/dist/foundations/help-content-sync/services/help-content-sync.service.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/services/help-content-sync.service.js +0 -111
- package/dist/foundations/help-content-sync/services/help-content-sync.service.js.map +0 -1
- package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts +0 -13
- package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js +0 -104
- package/dist/foundations/help-content-sync/services/mdx-to-markdown.service.js.map +0 -1
- package/dist/foundations/help-content-sync/tokens.d.ts +0 -2
- package/dist/foundations/help-content-sync/tokens.d.ts.map +0 -1
- package/dist/foundations/help-content-sync/tokens.js +0 -5
- package/dist/foundations/help-content-sync/tokens.js.map +0 -1
- package/dist/tools/help-content-build/build-manifest.d.ts +0 -31
- package/dist/tools/help-content-build/build-manifest.d.ts.map +0 -1
- package/dist/tools/help-content-build/build-manifest.js +0 -134
- package/dist/tools/help-content-build/build-manifest.js.map +0 -1
- package/dist/tools/help-content-build/index.d.ts +0 -2
- package/dist/tools/help-content-build/index.d.ts.map +0 -1
- package/dist/tools/help-content-build/index.js +0 -6
- 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 +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 +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":";;;;;AA0FA,sCAiEC;AA3JD,6CAAyC;AACzC,+CAAgE;AAChE,2DAA8C;AAC9C,yCAAgD;AAChD,8DAAiC;AACjC,qCAAkC;AAClC,gEAAuC;AACvC,4DAAmC;AAEnC,sGAAsG;AACtG,kHAA6G;AAC7G,8EAA8E;AAC9E,8EAA8E;AAC9E,4DAA4D;AAC5D,6FAAwF;AA2BxF,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,eAAe,CAAC,IAAU;IACjC,MAAM,GAAG,GAAmD,EAAE,CAAC;IAC/D,SAAS,IAAI,CAAC,IAAa;QACzB,MAAM,CAAC,GAAG,IAA+E,CAAC;QAC1F,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAe,CAAC;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ;iBAC1B,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE;gBAClB,MAAM,KAAK,GAAG,CAAuB,CAAC;gBACtC,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,CAAC,CAAC;iBACD,IAAI,CAAC,EAAE,CAAC;iBACR,IAAI,EAAE,CAAC;YACV,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAc,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,6BAAQ,EAAC,+BAA+B,OAAO,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7F,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAC5D,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAA,oBAAQ,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,eAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACjC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;QACrC,IAAI,CAAE,mCAAgC,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,SAAS;QACtE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,GAAG,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvD,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,mBAAmB,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE9B,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,IAAA,qBAAM,EAAC,GAAG,CAAC,CAAC;QACvB,MAAM,MAAM,GAAG,0CAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,KAAK;YAAE,SAAS;QAE7C,MAAM,IAAI,GAAG,IAAA,iBAAO,GAAE,CAAC,GAAG,CAAC,sBAAW,CAAC,CAAC,GAAG,CAAC,oBAAS,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAS,CAAC;QACjF,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEnE,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,IAAA,2BAAW,EAAC,UAAsB,EAAE,IAAI,EAAE,aAAa,CAAC;YAC5D,IAAI;YACJ,IAAI,EAAE,UAAsB;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,eAAe;YACtC,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW;YACX,IAAI,EAAE,GAAG;YACT,QAAQ;YACR,YAAY,EAAE,MAAM,CAAC,OAAO;YAC5B,WAAW,EAAE,kBAAkB,CAAC,GAAG,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,4BAA4B,OAAO,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE1E,MAAM,IAAI,GAAG;;sDAEuC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;CACrF,CAAC;IACA,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
|
@@ -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"}
|