@mintlify/scraping 4.0.175 → 4.0.177
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/__test__/fixtures/complexAsyncAPI.yml +257 -0
- package/__test__/fixtures/emptyAsyncAPI.yml +6 -0
- package/__test__/fixtures/simpleAsyncAPI.yml +110 -0
- package/__test__/fixtures/withTagsAsyncAPI.yml +135 -0
- package/__test__/generateAsyncApiPagesForDocsConfig.test.ts +138 -0
- package/bin/apiPages/common.js +1 -1
- package/bin/apiPages/common.js.map +1 -1
- package/bin/asyncapi/generateAsyncApiPagesForDocsConfig.d.ts +20 -0
- package/bin/asyncapi/generateAsyncApiPagesForDocsConfig.js +54 -0
- package/bin/asyncapi/generateAsyncApiPagesForDocsConfig.js.map +1 -0
- package/bin/asyncapi/processAsyncApiChannel.js +8 -6
- package/bin/asyncapi/processAsyncApiChannel.js.map +1 -1
- package/bin/index.d.ts +1 -0
- package/bin/index.js +1 -0
- package/bin/index.js.map +1 -1
- package/bin/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +5 -5
- package/src/apiPages/common.ts +1 -1
- package/src/asyncapi/generateAsyncApiPagesForDocsConfig.ts +88 -0
- package/src/asyncapi/processAsyncApiChannel.ts +8 -6
- package/src/index.ts +1 -0
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { validateAsyncApi, } from '@mintlify/common/asyncapi';
|
|
2
|
+
import { findNavGroup } from '../apiPages/common.js';
|
|
3
|
+
import { getAsyncApiDefinition } from './getAsyncApiDefinition.js';
|
|
4
|
+
import { processAsyncApiChannel } from './processAsyncApiChannel.js';
|
|
5
|
+
export async function generateAsyncApiPagesForDocsConfig(spec, opts) {
|
|
6
|
+
let document = undefined;
|
|
7
|
+
let isUrl;
|
|
8
|
+
if (typeof spec === 'string' || spec instanceof URL) {
|
|
9
|
+
const { document: asyncApiDocument, isUrl: isUrlFromDefinition } = await getAsyncApiDefinition(spec);
|
|
10
|
+
if (asyncApiDocument) {
|
|
11
|
+
document = asyncApiDocument;
|
|
12
|
+
}
|
|
13
|
+
isUrl = isUrlFromDefinition;
|
|
14
|
+
}
|
|
15
|
+
else {
|
|
16
|
+
const { valid, errorMessage, document: asyncApiDocument } = await validateAsyncApi(spec);
|
|
17
|
+
if (!valid && errorMessage) {
|
|
18
|
+
throw new Error(errorMessage);
|
|
19
|
+
}
|
|
20
|
+
document = asyncApiDocument;
|
|
21
|
+
isUrl = false;
|
|
22
|
+
}
|
|
23
|
+
if (!document) {
|
|
24
|
+
throw new Error('No document defined');
|
|
25
|
+
}
|
|
26
|
+
const channels = document.channels();
|
|
27
|
+
if (channels.isEmpty()) {
|
|
28
|
+
throw new Error('No channels defined');
|
|
29
|
+
}
|
|
30
|
+
const nav = [];
|
|
31
|
+
const decoratedNav = [];
|
|
32
|
+
const writePromises = [];
|
|
33
|
+
const pagesAcc = {};
|
|
34
|
+
channels.all().forEach((channel) => {
|
|
35
|
+
processAsyncApiChannel({
|
|
36
|
+
channel: channel,
|
|
37
|
+
nav,
|
|
38
|
+
decoratedNav,
|
|
39
|
+
writePromises,
|
|
40
|
+
pagesAcc,
|
|
41
|
+
opts,
|
|
42
|
+
findNavGroup,
|
|
43
|
+
});
|
|
44
|
+
});
|
|
45
|
+
await Promise.all(writePromises);
|
|
46
|
+
return {
|
|
47
|
+
nav,
|
|
48
|
+
decoratedNav,
|
|
49
|
+
spec: document,
|
|
50
|
+
pagesAcc,
|
|
51
|
+
isUrl,
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=generateAsyncApiPagesForDocsConfig.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"generateAsyncApiPagesForDocsConfig.js","sourceRoot":"","sources":["../../src/asyncapi/generateAsyncApiPagesForDocsConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAmBrE,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,IAA8C,EAC9C,IAAmC;IAEnC,IAAI,QAAQ,GAA0C,SAAS,CAAC;IAChE,IAAI,KAAc,CAAC;IACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,YAAY,GAAG,EAAE,CAAC;QACpD,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAC9D,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,gBAAgB,EAAE,CAAC;YACrB,QAAQ,GAAG,gBAAgB,CAAC;QAC9B,CAAC;QACD,KAAK,GAAG,mBAAmB,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzF,IAAI,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QACD,QAAQ,GAAG,gBAAgB,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAErC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,YAAY,GAA0B,EAAE,CAAC;IAC/C,MAAM,aAAa,GAAoB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAA4C,EAAE,CAAC;IAE7D,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,sBAAsB,CAAC;YACrB,OAAO,EAAE,OAA0B;YACnC,GAAG;YACH,YAAY;YACZ,aAAa;YACb,QAAQ;YACR,IAAI;YACJ,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAEjC,OAAO;QACL,GAAG;QACH,YAAY;QACZ,IAAI,EAAE,QAAQ;QACd,QAAQ;QACR,KAAK;KACN,CAAC;AACJ,CAAC"}
|
|
@@ -1,29 +1,31 @@
|
|
|
1
|
-
import { optionallyAddLeadingSlash } from '@mintlify/common';
|
|
1
|
+
import { optionallyAddLeadingSlash, camelToSentenceCase } from '@mintlify/common';
|
|
2
2
|
import fse from 'fs-extra';
|
|
3
3
|
import { outputFile } from 'fs-extra';
|
|
4
4
|
import { join, resolve } from 'path';
|
|
5
5
|
import { DEFAULT_WEBSOCKETS_GROUP_NAME, prepareStringToBeValidFilename, generateUniqueFilenameWithoutExtension, } from '../apiPages/common.js';
|
|
6
6
|
export const processAsyncApiChannel = ({ channel, nav, decoratedNav, writePromises, pagesAcc, opts, findNavGroup, }) => {
|
|
7
7
|
const asyncApiFilePathFromRoot = opts?.asyncApiFilePath
|
|
8
|
-
?
|
|
8
|
+
? opts.asyncApiFilePath.startsWith('https://')
|
|
9
|
+
? opts.asyncApiFilePath
|
|
10
|
+
: optionallyAddLeadingSlash(opts.asyncApiFilePath)
|
|
9
11
|
: undefined;
|
|
10
|
-
const operation = 'websocket';
|
|
11
12
|
const tags = channel.tags().all();
|
|
12
13
|
const groupName = tags[0]?.name() ?? DEFAULT_WEBSOCKETS_GROUP_NAME;
|
|
13
14
|
const channelId = channel.id();
|
|
14
15
|
const title = channel.title() ?? channelId;
|
|
16
|
+
const filename = prepareStringToBeValidFilename(title) ?? '';
|
|
15
17
|
const description = channel.description() ?? channel.summary() ?? '';
|
|
16
18
|
const folder = prepareStringToBeValidFilename(groupName) ?? '';
|
|
17
|
-
const base = join(opts?.outDir ?? '', folder,
|
|
19
|
+
const base = join(opts?.outDir ?? '', folder, filename);
|
|
18
20
|
const navGroup = findNavGroup(nav, groupName);
|
|
19
21
|
const decoratedNavGroup = findNavGroup(decoratedNav, groupName);
|
|
20
22
|
const filenameWithoutExtension = generateUniqueFilenameWithoutExtension(navGroup, base);
|
|
21
|
-
const asyncApiMetaTag = `${asyncApiFilePathFromRoot ? `${asyncApiFilePathFromRoot} ` : ''}${
|
|
23
|
+
const asyncApiMetaTag = `${asyncApiFilePathFromRoot ? `${asyncApiFilePathFromRoot} ` : ''}${channelId}`;
|
|
22
24
|
navGroup.push(filenameWithoutExtension);
|
|
23
25
|
const page = {
|
|
24
26
|
asyncapi: asyncApiMetaTag,
|
|
25
27
|
href: resolve('/', filenameWithoutExtension),
|
|
26
|
-
title: title,
|
|
28
|
+
title: title === channelId ? camelToSentenceCase(title) : title,
|
|
27
29
|
description,
|
|
28
30
|
version: opts?.version,
|
|
29
31
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"processAsyncApiChannel.js","sourceRoot":"","sources":["../../src/asyncapi/processAsyncApiChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"processAsyncApiChannel.js","sourceRoot":"","sources":["../../src/asyncapi/processAsyncApiChannel.ts"],"names":[],"mappings":"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"}
|
package/bin/index.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export { generateOpenApiPages } from './openapi/generateOpenApiPages.js';
|
|
2
2
|
export { generateOpenApiPagesForDocsConfig } from './openapi/generateOpenApiPagesForDocsConfig.js';
|
|
3
3
|
export * from './utils/log.js';
|
|
4
|
+
export { generateAsyncApiPagesForDocsConfig } from './asyncapi/generateAsyncApiPagesForDocsConfig.js';
|
package/bin/index.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export { generateOpenApiPages } from './openapi/generateOpenApiPages.js';
|
|
2
2
|
export { generateOpenApiPagesForDocsConfig } from './openapi/generateOpenApiPagesForDocsConfig.js';
|
|
3
3
|
export * from './utils/log.js';
|
|
4
|
+
export { generateAsyncApiPagesForDocsConfig } from './asyncapi/generateAsyncApiPagesForDocsConfig.js';
|
|
4
5
|
//# sourceMappingURL=index.js.map
|
package/bin/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AACnG,cAAc,gBAAgB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AACnG,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,kCAAkC,EAAE,MAAM,kDAAkD,CAAC"}
|