@fern-api/fdr-sdk 1.2.56-4cf0b0d54d → 1.2.56-d742990ae1
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/api-definition/snippets/backfill.d.ts.map +1 -1
- package/dist/api-definition/snippets/backfill.js +20 -37
- package/dist/api-definition/snippets/backfill.js.map +1 -1
- package/dist/js/api-definition/snippets/server.js +25 -27
- package/dist/js/api-definition/snippets/server.js.map +1 -1
- package/dist/js/api-definition/snippets/server.mjs +25 -27
- package/dist/js/api-definition/snippets/server.mjs.map +1 -1
- package/dist/js/navigation/ledger-root-builder.js +4 -18
- package/dist/js/navigation/ledger-root-builder.js.map +1 -1
- package/dist/js/navigation/ledger-root-builder.mjs +4 -18
- package/dist/js/navigation/ledger-root-builder.mjs.map +1 -1
- package/dist/navigation/__test__/ledger-root-builder.rootChildOrder.test.js +5 -7
- package/dist/navigation/__test__/ledger-root-builder.rootChildOrder.test.js.map +1 -1
- package/dist/navigation/ledger-root-builder.d.ts.map +1 -1
- package/dist/navigation/ledger-root-builder.js +14 -44
- package/dist/navigation/ledger-root-builder.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/dist/types/api-definition/snippets/backfill.d.ts.map +1 -1
- package/dist/types/navigation/ledger-root-builder.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAIrG,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAIrG,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE/F;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC5C,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,iBAAiB,EACpC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,sBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAoC9B;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC5C,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAyCxC"}
|
|
@@ -1,49 +1,32 @@
|
|
|
1
1
|
import { createSnippetGenerators } from "./generators";
|
|
2
2
|
import { generateHttpSnippets, shouldIncludeHttpSnippetLanguage } from "./http-snippets";
|
|
3
3
|
import { generateSdkSnippets } from "./sdk-snippets";
|
|
4
|
-
/**
|
|
5
|
-
* Snippet generation is synchronous, CPU-heavy work. Yielding to the event
|
|
6
|
-
* loop between units keeps long enrichment passes from starving concurrent
|
|
7
|
-
* I/O and requests. Yields are time-budgeted and the endpoint/example loops
|
|
8
|
-
* are sequential: awaiting setImmediate from many concurrently-queued tasks
|
|
9
|
-
* coalesces all their continuations into a single check phase (one long
|
|
10
|
-
* block), whereas a sequential loop guarantees a full event-loop turn per
|
|
11
|
-
* yield.
|
|
12
|
-
*/
|
|
13
|
-
const YIELD_BUDGET_MS = 20;
|
|
14
|
-
const yieldToEventLoop = () => new Promise((resolve) => (typeof setImmediate === "function" ? setImmediate(resolve) : setTimeout(resolve, 0)));
|
|
15
4
|
/**
|
|
16
5
|
* Backfill snippets for an entire API definition.
|
|
17
6
|
* This is the main entry point for snippet generation during docs loading.
|
|
18
7
|
*/
|
|
19
8
|
export async function backfillSnippets(apiDefinition, dynamicIr, flags) {
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
for (const [id, endpoint] of Object.entries(apiDefinition.endpoints)) {
|
|
29
|
-
await maybeYield();
|
|
30
|
-
let dynamicGenerators = {};
|
|
31
|
-
try {
|
|
32
|
-
if (dynamicIr) {
|
|
33
|
-
dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
|
|
9
|
+
return {
|
|
10
|
+
...apiDefinition,
|
|
11
|
+
endpoints: await Promise.all(Object.entries(apiDefinition.endpoints).map(async ([id, endpoint]) => {
|
|
12
|
+
let dynamicGenerators = {};
|
|
13
|
+
try {
|
|
14
|
+
if (dynamicIr) {
|
|
15
|
+
dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
|
|
16
|
+
}
|
|
34
17
|
}
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
18
|
+
catch (error) {
|
|
19
|
+
console.log("[backfill] error creating dynamic snippet generators:", error);
|
|
20
|
+
}
|
|
21
|
+
return [
|
|
22
|
+
id,
|
|
23
|
+
{
|
|
24
|
+
...endpoint,
|
|
25
|
+
examples: await Promise.all(endpoint.examples?.map((example) => backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags)) ?? [])
|
|
26
|
+
}
|
|
27
|
+
];
|
|
28
|
+
})).then((entries) => Object.fromEntries(entries))
|
|
29
|
+
};
|
|
47
30
|
}
|
|
48
31
|
/**
|
|
49
32
|
* Backfill snippets for a single endpoint example.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD
|
|
1
|
+
{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"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"}
|
|
@@ -43748,35 +43748,33 @@ function shouldIncludeHttpSnippetLanguage(language, flags) {
|
|
|
43748
43748
|
}
|
|
43749
43749
|
|
|
43750
43750
|
// src/api-definition/snippets/backfill.ts
|
|
43751
|
-
var YIELD_BUDGET_MS = 20;
|
|
43752
|
-
var yieldToEventLoop = () => new Promise((resolve) => typeof setImmediate === "function" ? setImmediate(resolve) : setTimeout(resolve, 0));
|
|
43753
43751
|
async function backfillSnippets(apiDefinition, dynamicIr, flags) {
|
|
43754
|
-
|
|
43755
|
-
|
|
43756
|
-
|
|
43757
|
-
|
|
43758
|
-
|
|
43759
|
-
|
|
43752
|
+
return {
|
|
43753
|
+
...apiDefinition,
|
|
43754
|
+
endpoints: await Promise.all(
|
|
43755
|
+
Object.entries(apiDefinition.endpoints).map(async ([id2, endpoint]) => {
|
|
43756
|
+
let dynamicGenerators = {};
|
|
43757
|
+
try {
|
|
43758
|
+
if (dynamicIr) {
|
|
43759
|
+
dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
|
|
43760
|
+
}
|
|
43761
|
+
} catch (error) {
|
|
43762
|
+
console.log("[backfill] error creating dynamic snippet generators:", error);
|
|
43763
|
+
}
|
|
43764
|
+
return [
|
|
43765
|
+
id2,
|
|
43766
|
+
{
|
|
43767
|
+
...endpoint,
|
|
43768
|
+
examples: await Promise.all(
|
|
43769
|
+
endpoint.examples?.map(
|
|
43770
|
+
(example) => backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags)
|
|
43771
|
+
) ?? []
|
|
43772
|
+
)
|
|
43773
|
+
}
|
|
43774
|
+
];
|
|
43775
|
+
})
|
|
43776
|
+
).then((entries) => Object.fromEntries(entries))
|
|
43760
43777
|
};
|
|
43761
|
-
const endpoints = {};
|
|
43762
|
-
for (const [id2, endpoint] of Object.entries(apiDefinition.endpoints)) {
|
|
43763
|
-
await maybeYield();
|
|
43764
|
-
let dynamicGenerators = {};
|
|
43765
|
-
try {
|
|
43766
|
-
if (dynamicIr) {
|
|
43767
|
-
dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
|
|
43768
|
-
}
|
|
43769
|
-
} catch (error) {
|
|
43770
|
-
console.log("[backfill] error creating dynamic snippet generators:", error);
|
|
43771
|
-
}
|
|
43772
|
-
const examples = [];
|
|
43773
|
-
for (const example of endpoint.examples ?? []) {
|
|
43774
|
-
await maybeYield();
|
|
43775
|
-
examples.push(await backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags));
|
|
43776
|
-
}
|
|
43777
|
-
endpoints[id2] = { ...endpoint, examples };
|
|
43778
|
-
}
|
|
43779
|
-
return { ...apiDefinition, endpoints };
|
|
43780
43778
|
}
|
|
43781
43779
|
async function backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags) {
|
|
43782
43780
|
const snippets = { ...example.snippets };
|