@fern-api/fdr-sdk 0.140.3-2163f3701 → 0.140.3-28a5650c1

package/dist/api-definition/prune.d.ts

@@ -0,0 +1,16 @@
+import type * as Latest from "./latest";
+export type PruningNodeType = {
+    type: "endpoint";
+    endpointId: Latest.EndpointId;
+} | {
+    type: "webSocket";
+    webSocketId: Latest.WebSocketId;
+} | {
+    type: "webhook";
+    webhookId: Latest.WebhookId;
+} | {
+    type: "grpc";
+    grpcId: Latest.GrpcId;
+};
+export declare function prune(api: Latest.ApiDefinition, ...nodes: PruningNodeType[]): Latest.ApiDefinition;
+//# sourceMappingURL=prune.d.ts.map

package/dist/api-definition/prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/api-definition/prune.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,UAAU,CAAC;AAIxC,MAAM,MAAM,eAAe,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAA;CAAE,CAAC;AA8I9C,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,aAAa,EAAE,GAAG,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,aAAa,CAElG"}

package/dist/api-definition/prune.js

@@ -0,0 +1,132 @@
+import { LARGE_LOOP_TOLERANCE } from "./const";
+import { EndpointId } from "./latest";
+import { ApiTypeIdVisitor } from "./typeid-visitor";
+class ApiDefinitionPruner {
+    api;
+    static instances = new WeakMap();
+    static from(api) {
+        const toRet = ApiDefinitionPruner.instances.get(api) ?? new ApiDefinitionPruner(api);
+        ApiDefinitionPruner.instances.set(api, toRet);
+        return toRet;
+    }
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * This utility is designed to prune an API definition to only include the desired endpoints, websockets, and webhooks
+     * based on the provided node of the navigation tree, which will reduce the size of the API definition that is sent to the client.
+     *
+     * @param node of the navigation tree to prune the API definition to
+     * @returns a new API definition that is the result of pruning the input API definition to the desired node
+     */
+    prune(...nodes) {
+        const toRet = {
+            ...this.api,
+            endpoints: {},
+            websockets: {},
+            webhooks: {},
+            types: {},
+            subpackages: {},
+            auths: {}
+        };
+        const namespaces = new Set();
+        const authSchemes = new Set();
+        for (const node of nodes) {
+            if (node.type === "endpoint") {
+                const found = this.api.endpoints[node.endpointId];
+                if (found) {
+                    toRet.endpoints[node.endpointId] = found;
+                    found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+                    found.auth?.forEach((authSchemeId) => authSchemes.add(authSchemeId));
+                }
+            }
+            else if (node.type === "webSocket") {
+                const found = this.api.websockets[node.webSocketId];
+                if (found) {
+                    toRet.websockets[node.webSocketId] = found;
+                    found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+                    found.auth?.forEach((authSchemeId) => authSchemes.add(authSchemeId));
+                }
+            }
+            else if (node.type === "webhook") {
+                const found = this.api.webhooks[node.webhookId];
+                if (found) {
+                    toRet.webhooks[node.webhookId] = found;
+                    found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+                }
+            }
+            else if (node.type === "grpc") {
+                const grpcIdAsEndpointId = EndpointId(node.grpcId);
+                const found = this.api.endpoints[grpcIdAsEndpointId];
+                if (found) {
+                    toRet.endpoints[grpcIdAsEndpointId] = found;
+                    found.namespace?.forEach((subpackageId) => namespaces.add(subpackageId));
+                }
+            }
+        }
+        toRet.types = this.pruneTypes(toRet);
+        namespaces.forEach((subpackageId) => {
+            const subpackage = this.api.subpackages[subpackageId];
+            if (subpackage) {
+                toRet.subpackages[subpackageId] = subpackage;
+            }
+        });
+        authSchemes.forEach((authSchemeId) => {
+            const authScheme = this.api.auths[authSchemeId];
+            if (authScheme) {
+                toRet.auths[authSchemeId] = authScheme;
+            }
+        });
+        return toRet;
+    }
+    pruneTypes(partiallyPrunedApi) {
+        let typeIds = new Set();
+        partiallyPrunedApi.globalHeaders?.forEach((header) => {
+            ApiTypeIdVisitor.visitTypeShape(header.valueShape, (typeId) => typeIds.add(typeId));
+        });
+        for (const endpoint of Object.values(partiallyPrunedApi.endpoints)) {
+            ApiTypeIdVisitor.visitEndpointDefinition(endpoint, (typeId) => typeIds.add(typeId));
+        }
+        for (const websocket of Object.values(partiallyPrunedApi.websockets)) {
+            ApiTypeIdVisitor.visitWebSocketChannel(websocket, (typeId) => typeIds.add(typeId));
+        }
+        for (const webhook of Object.values(partiallyPrunedApi.webhooks)) {
+            ApiTypeIdVisitor.visitWebhookDefinition(webhook, (typeId) => typeIds.add(typeId));
+        }
+        typeIds = this.expandTypeIds(typeIds);
+        const types = {};
+        typeIds.forEach((typeId) => {
+            const type = this.api.types[typeId];
+            if (type != null) {
+                types[typeId] = type;
+            }
+        });
+        return types;
+    }
+    expandTypeIds(typeIds) {
+        const visitedTypeIds = new Set();
+        const queue = Array.from(typeIds);
+        let loop = 0;
+        while (queue.length > 0) {
+            if (loop > LARGE_LOOP_TOLERANCE + typeIds.size) {
+                throw new Error("Infinite loop detected while expanding type references.");
+            }
+            const typeId = queue.pop();
+            if (typeId != null && !visitedTypeIds.has(typeId)) {
+                visitedTypeIds.add(typeId);
+                const type = this.api.types[typeId];
+                if (type) {
+                    ApiTypeIdVisitor.visitTypeDefinition(type, (nestedTypeId) => {
+                        queue.push(nestedTypeId);
+                    });
+                }
+            }
+            loop++;
+        }
+        return visitedTypeIds;
+    }
+}
+export function prune(api, ...nodes) {
+    return ApiDefinitionPruner.from(api).prune(...nodes);
+}
+//# sourceMappingURL=prune.js.map

package/dist/api-definition/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../src/api-definition/prune.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQpD,MAAM,mBAAmB;IASO;IAR5B,MAAM,CAAC,SAAS,GAAG,IAAI,OAAO,EAA6C,CAAC;IAE5E,MAAM,CAAC,IAAI,CAAC,GAAyB;QACjC,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACrF,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,YAA4B,GAAyB;QAAzB,QAAG,GAAH,GAAG,CAAsB;IAAG,CAAC;IAEzD;;;;;;OAMG;IACI,KAAK,CAAC,GAAG,KAAwB;QACpC,MAAM,KAAK,GAAyB;YAChC,GAAG,IAAI,CAAC,GAAG;YACX,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,EAAE;YACf,KAAK,EAAE,EAAE;SACZ,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;QAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAC;QAEnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAClD,IAAI,KAAK,EAAE,CAAC;oBACR,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;oBACzC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;oBACzE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;gBACzE,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACpD,IAAI,KAAK,EAAE,CAAC;oBACR,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;oBAC3C,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;oBACzE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;gBACzE,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAChD,IAAI,KAAK,EAAE,CAAC;oBACR,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;oBACvC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC7E,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC9B,MAAM,kBAAkB,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;gBACrD,IAAI,KAAK,EAAE,CAAC;oBACR,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC;oBAC5C,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;gBAC7E,CAAC;YACL,CAAC;QACL,CAAC;QAED,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,UAAU,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YACtD,IAAI,UAAU,EAAE,CAAC;gBACb,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC;YACjD,CAAC;QACL,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,UAAU,EAAE,CAAC;gBACb,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC;YAC3C,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,UAAU,CAAC,kBAAwC;QACvD,IAAI,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;QACvC,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACjD,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,gBAAgB,CAAC,uBAAuB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,gBAAgB,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,gBAAgB,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,KAAK,GAA0C,EAAE,CAAC;QAExD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACf,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;YACzB,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,aAAa,CAAC,OAAmC;QACrD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,GAAG,oBAAoB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;YAC/E,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,IAAI,EAAE,CAAC;oBACP,gBAAgB,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,EAAE;wBACxD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC7B,CAAC,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YAED,IAAI,EAAE,CAAC;QACX,CAAC;QAED,OAAO,cAAc,CAAC;IAC1B,CAAC;;AAGL,MAAM,UAAU,KAAK,CAAC,GAAyB,EAAE,GAAG,KAAwB;IACxE,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/api-definition/snippets/SnippetHttpRequest.d.ts

@@ -0,0 +1,44 @@
+import type * as Latest from "../latest";
+interface SnippetHttpRequestBodyJson {
+    type: "json";
+    value?: unknown;
+}
+interface SnippetHttpRequestBodyJsonExploded {
+    type: "exploded";
+    value?: unknown[];
+}
+export interface SnippetHttpRequestBodyForm {
+    type: "form";
+    value: Record<string, SnippetHttpRequestBodyFormValue>;
+}
+export interface SnippetHttpRequestBodyFormValueFilename {
+    type: "filename";
+    filename: string;
+    contentType: string | undefined;
+}
+export interface SnippetHttpRequestBodyFormValueFilenames {
+    type: "filenames";
+    files: Omit<SnippetHttpRequestBodyFormValueFilename, "type">[];
+}
+export type SnippetHttpRequestBodyFormValue = SnippetHttpRequestBodyJson | SnippetHttpRequestBodyJsonExploded | SnippetHttpRequestBodyFormValueFilename | SnippetHttpRequestBodyFormValueFilenames;
+interface SnippetHttpRequestBodyBytes {
+    type: "bytes";
+    filename: string;
+}
+export type SnippetHttpRequestBody = SnippetHttpRequestBodyJson | SnippetHttpRequestBodyForm | SnippetHttpRequestBodyBytes;
+export interface SnippetHttpRequest {
+    method: string;
+    url: string;
+    searchParams: Record<string, unknown>;
+    headers: Record<string, unknown>;
+    basicAuth?: {
+        username: string;
+        password: string;
+    };
+    body: SnippetHttpRequestBody | undefined;
+    protocol?: Latest.Protocol;
+    redacted?: boolean;
+}
+export declare function toSnippetHttpRequest(endpoint: Latest.EndpointDefinition, example: Latest.ExampleEndpointCall, auth: Latest.AuthScheme | undefined): SnippetHttpRequest;
+export {};
+//# sourceMappingURL=SnippetHttpRequest.d.ts.map

package/dist/api-definition/snippets/SnippetHttpRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnippetHttpRequest.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/SnippetHttpRequest.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,KAAK,MAAM,MAAM,WAAW,CAAC;AAEzC,UAAU,0BAA0B;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,kCAAkC;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,uCAAuC;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,wCAAwC;IACrD,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,IAAI,CAAC,uCAAuC,EAAE,MAAM,CAAC,EAAE,CAAC;CAClE;AAED,MAAM,MAAM,+BAA+B,GACrC,0BAA0B,GAC1B,kCAAkC,GAClC,uCAAuC,GACvC,wCAAwC,CAAC;AAE/C,UAAU,2BAA2B;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC1B,2BAA2B,CAAC;AAElC,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAGD,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EACnC,OAAO,EAAE,MAAM,CAAC,mBAAmB,EACnC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,GACpC,kBAAkB,CA4GpB"}

package/dist/api-definition/snippets/SnippetHttpRequest.js

@@ -0,0 +1,105 @@
+import { sanitizeUrl } from "@fern-api/ui-core-utils";
+import visitDiscriminatedUnion from "@fern-api/ui-core-utils/visitDiscriminatedUnion";
+import { compact } from "es-toolkit/array";
+import { noop } from "ts-essentials";
+import urljoin from "url-join";
+// TODO: validate that global headers are also included in the example by CLI or FDR
+export function toSnippetHttpRequest(endpoint, example, auth) {
+    const environmentUrl = (endpoint.environments?.find((env) => env.id === endpoint.defaultEnvironment) ?? endpoint.environments?.[0])?.baseUrl;
+    const sanitizedEnvironment = sanitizeUrl(environmentUrl);
+    const url = urljoin(compact([sanitizedEnvironment, example.path]));
+    const headers = { ...example.headers };
+    let basicAuth;
+    if (endpoint.auth && endpoint.auth.length > 0 && auth) {
+        visitDiscriminatedUnion(auth, "type")._visit({
+            basicAuth: ({ usernameName = "username", passwordName = "password" }) => {
+                basicAuth = {
+                    username: `<${usernameName}>`,
+                    password: `<${passwordName}>`
+                };
+            },
+            bearerAuth: ({ tokenName = "token" }) => {
+                headers.Authorization = `Bearer <${tokenName}>`;
+            },
+            header: ({ headerWireValue, nameOverride = headerWireValue, prefix }) => {
+                headers[headerWireValue] = prefix != null ? `${prefix} <${nameOverride}>` : `<${nameOverride}>`;
+            },
+            oAuth: ({ value: clientCredentials }) => {
+                visitDiscriminatedUnion(clientCredentials, "type")._visit({
+                    clientCredentials: () => {
+                        headers.Authorization = "Bearer <token>";
+                    },
+                    _other: noop
+                });
+            },
+            _other: noop
+        });
+    }
+    const body = example.requestBody;
+    if (endpoint.requests?.[0]?.contentType != null) {
+        headers["Content-Type"] = endpoint.requests?.[0]?.contentType;
+    }
+    if (body != null && headers["Content-Type"] == null) {
+        if (body.type === "json") {
+            headers["Content-Type"] = "application/json";
+        }
+        else if (body.type === "form") {
+            headers["Content-Type"] = "multipart/form-data";
+        }
+    }
+    // If endpoint is OpenRPC, ensure Content-Type is application/json
+    if (endpoint.protocol?.type === "openrpc") {
+        headers["Content-Type"] = "application/json";
+    }
+    return {
+        method: endpoint.method,
+        url,
+        searchParams: example.queryParameters ?? {},
+        headers: JSON.parse(JSON.stringify(headers)),
+        basicAuth,
+        protocol: endpoint.protocol,
+        body: body == null
+            ? undefined
+            : visitDiscriminatedUnion(body)._visit({
+                json: (value) => value,
+                form: (value) => {
+                    const toRet = {};
+                    for (const [key, val] of Object.entries(value.value)) {
+                        toRet[key] = visitDiscriminatedUnion(val)._visit({
+                            exploded: (value) => value,
+                            json: (value) => value,
+                            filename: (value) => ({
+                                type: "filename",
+                                filename: value.value,
+                                contentType: undefined // TODO: infer content type?
+                            }),
+                            filenames: (value) => ({
+                                type: "filenames",
+                                files: value.value.map((filename) => ({
+                                    filename,
+                                    contentType: undefined // TODO: infer content type?
+                                }))
+                            }),
+                            filenameWithData: (value) => ({
+                                type: "filename",
+                                filename: value.filename,
+                                contentType: undefined // TODO: infer content type?
+                            }),
+                            filenamesWithData: (value) => ({
+                                type: "filenames",
+                                files: value.value.map(({ filename }) => ({
+                                    filename,
+                                    contentType: undefined // TODO: infer content type?
+                                }))
+                            })
+                        });
+                    }
+                    return { type: "form", value: toRet };
+                },
+                // TODO: filename should be provided in the example from the API definition
+                bytes: () => ({ type: "bytes", filename: "<filename>" }),
+                _other: () => undefined
+            })
+    };
+}
+//# sourceMappingURL=SnippetHttpRequest.js.map

package/dist/api-definition/snippets/SnippetHttpRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnippetHttpRequest.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/SnippetHttpRequest.ts"],"names":[],"mappings":"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"}

package/dist/api-definition/snippets/backfill.d.ts

@@ -0,0 +1,10 @@
+import type { DynamicIr } from "../../client/APIV1Write";
+import type { HttpSnippetLanguage } from "../../client/generated/api/resources/docs/resources/v1/resources/commons/resources/commons/types/HttpSnippetLanguage";
+import type { ApiDefinition } from "../latest";
+export type DynamicIRsByLanguage = Record<string, DynamicIr>;
+export type { HttpSnippetLanguage };
+export declare function backfillSnippets(apiDefinition: ApiDefinition, dynamicIr: DynamicIRsByLanguage | undefined, flags: {
+    httpSnippets: boolean | HttpSnippetLanguage[];
+    alwaysEnableJavaScriptFetch: boolean;
+}): Promise<ApiDefinition>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/api-definition/snippets/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sHAAsH,CAAC;AAChK,OAAO,KAAK,EAAE,aAAa,EAAwD,MAAM,WAAW,CAAC;AAKrG,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAiB7D,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,wBAAsB,gBAAgB,CAClC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,KAAK,EAAE;IACH,YAAY,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAC9C,2BAA2B,EAAE,OAAO,CAAC;CACxC,GACF,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/api-definition/snippets/backfill.js

@@ -0,0 +1,280 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { SnippetResolver } from "@fern-api/snippets";
+import { HTTPSnippet } from "httpsnippet-lite";
+import { convertToCurl } from "./curl";
+import { getHarRequest } from "./get-har-request";
+import { toSnippetHttpRequest } from "./SnippetHttpRequest";
+const CLIENTS = [
+    { targetId: "python", clientId: "requests" },
+    { targetId: "javascript", clientId: "fetch" },
+    { targetId: "go", clientId: "native" },
+    { targetId: "ruby", clientId: "native" },
+    { targetId: "java", clientId: "unirest" },
+    { targetId: "php", clientId: "guzzle" },
+    { targetId: "csharp", clientId: "restsharp" },
+    { targetId: "swift", clientId: "nsurlsession" }
+];
+export async function backfillSnippets(apiDefinition, dynamicIr, flags) {
+    return {
+        ...apiDefinition,
+        endpoints: await Promise.all(Object.entries(apiDefinition.endpoints).map(async ([id, endpoint]) => {
+            let dynamicGenerators = {};
+            try {
+                if (dynamicIr) {
+                    dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
+                }
+            }
+            catch (error) {
+                console.log("[backfill] error creating dynamic snippet generators:", error);
+            }
+            return [
+                id,
+                {
+                    ...endpoint,
+                    examples: await Promise.all(endpoint.examples?.map((example) => backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags)) ?? [])
+                }
+            ];
+        })).then((entries) => Object.fromEntries(entries))
+    };
+}
+async function backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, { httpSnippets, alwaysEnableJavaScriptFetch }) {
+    const snippets = { ...example.snippets };
+    const pushSnippet = (snippet) => {
+        (snippets[snippet.language] ??= []).push(snippet);
+    };
+    // Determine if HTTP snippets are enabled and which languages to include
+    const isHttpSnippetsEnabled = httpSnippets !== false;
+    const httpSnippetLanguages = Array.isArray(httpSnippets) ? httpSnippets : null;
+    // Check if a language should be included in HTTP snippets (important-comment)
+    // If httpSnippets is true (boolean), include all languages (important-comment)
+    // If httpSnippets is an array, only include languages in the array (important-comment)
+    const shouldIncludeLanguage = (language) => {
+        if (!isHttpSnippetsEnabled) {
+            return language === "curl";
+        }
+        return httpSnippetLanguages == null || httpSnippetLanguages.includes(language);
+    };
+    // Check if curl snippet exists and should be generated (important-comment)
+    if (!snippets.curl?.length && shouldIncludeLanguage("curl")) {
+        const endpointAuth = endpoint.auth?.[0];
+        const curlCode = convertToCurl(toSnippetHttpRequest(endpoint, example, endpointAuth != null ? apiDefinition.auths[endpointAuth] : undefined));
+        pushSnippet({
+            name: undefined,
+            language: "curl",
+            install: undefined,
+            code: curlCode,
+            generated: true,
+            description: undefined
+        });
+    }
+    if (snippets.curl?.length && !shouldIncludeLanguage("curl")) {
+        delete snippets.curl;
+    }
+    for (const [language, generator] of Object.entries(dynamicGenerators)) {
+        if (!generator || endpoint.method === "HEAD") {
+            continue;
+        }
+        try {
+            let auth;
+            const endpointAuth = endpoint.auth?.[0];
+            if (endpointAuth) {
+                const authDefinition = apiDefinition.auths[endpointAuth];
+                if (authDefinition?.type === "bearerAuth") {
+                    auth = {
+                        type: "bearer",
+                        token: "YOUR_TOKEN_HERE"
+                    };
+                }
+                else {
+                    auth = authDefinition;
+                }
+            }
+            // process request body similar to getHarRequest
+            let bodyValue = undefined;
+            if (example.requestBody != null && example.requestBody.type === "json" && example.requestBody.value) {
+                if (typeof example.requestBody.value === "object" && !Array.isArray(example.requestBody.value)) {
+                    const filteredValue = Object.fromEntries(Object.entries(example.requestBody.value).filter(([_, valueObj]) => {
+                        // keep arrays and primitive values
+                        if (Array.isArray(valueObj) || typeof valueObj !== "object" || valueObj == null) {
+                            return true;
+                        }
+                        // for objects, only filter out empty objects without a value property
+                        return Object.keys(valueObj).length > 0;
+                    }));
+                    bodyValue = filteredValue;
+                }
+                else {
+                    bodyValue = example.requestBody.value;
+                }
+            }
+            const request = {
+                baseURL: endpoint?.environments?.find((env) => env.id === endpoint.defaultEnvironment)?.baseUrl ??
+                    endpoint?.environments?.[0]?.baseUrl,
+                auth,
+                pathParameters: example.pathParameters,
+                queryParameters: example.queryParameters,
+                headers: example.headers,
+                requestBody: bodyValue,
+                method: endpoint.method
+            };
+            let result;
+            try {
+                result = generator.generateSync(request);
+            }
+            catch (error) {
+                console.error("Failed to generate snippet:", error);
+                continue;
+            }
+            if (result?.snippet) {
+                pushSnippet({
+                    name: undefined,
+                    language,
+                    install: undefined,
+                    code: result.snippet,
+                    generated: true,
+                    description: undefined
+                });
+            }
+        }
+        catch (error) {
+            console.error(`Error generating ${language} snippet:`, error);
+        }
+    }
+    if (isHttpSnippetsEnabled) {
+        const snippet = new HTTPSnippet(getHarRequest(endpoint, example, apiDefinition.auths, example.requestBody));
+        for (const { clientId, targetId } of CLIENTS) {
+            // If the snippet already exists, skip it
+            if (snippets[targetId]?.length) {
+                continue;
+            }
+            // If dynamic snippets are available for this language, skip generating HTTP snippets
+            if (dynamicGenerators[targetId === "javascript" ? "typescript" : targetId]) {
+                continue;
+            }
+            // If alwaysEnableJavaScriptFetch is disabled, skip generating JavaScript snippets if TypeScript snippets are available
+            if (targetId === "javascript" && snippets.typescript?.length && !alwaysEnableJavaScriptFetch) {
+                continue;
+            }
+            // Check if this language should be included based on the httpSnippets configuration
+            if (!shouldIncludeLanguage(targetId)) {
+                continue;
+            }
+            const convertedCode = await snippet.convert(targetId, clientId);
+            const code = typeof convertedCode === "string"
+                ? convertedCode
+                : convertedCode != null
+                    ? convertedCode[0]
+                    : undefined;
+            if (code != null) {
+                pushSnippet({
+                    name: undefined,
+                    language: targetId,
+                    install: undefined,
+                    code,
+                    generated: true,
+                    description: undefined
+                });
+            }
+        }
+    }
+    return { ...example, snippets };
+}
+function createSnippetGenerators({ endpoint, dynamicIr }) {
+    if (endpoint.method === "HEAD") {
+        return {};
+    }
+    const snippetInputs = [];
+    const generators = {};
+    // only process languages that have IR data
+    if (dynamicIr.typescript) {
+        snippetInputs.push({
+            language: "typescript",
+            ir: dynamicIr.typescript
+        });
+    }
+    if (dynamicIr.python) {
+        snippetInputs.push({
+            language: "python",
+            ir: dynamicIr.python
+        });
+    }
+    if (dynamicIr.java) {
+        snippetInputs.push({
+            language: "java",
+            ir: dynamicIr.java
+        });
+    }
+    if (dynamicIr.ruby) {
+        snippetInputs.push({
+            language: "ruby",
+            ir: dynamicIr.ruby
+        });
+    }
+    if (dynamicIr.swift) {
+        snippetInputs.push({
+            language: "swift",
+            ir: dynamicIr.swift
+        });
+    }
+    if (dynamicIr.csharp) {
+        snippetInputs.push({
+            language: "csharp",
+            ir: dynamicIr.csharp
+        });
+    }
+    if (dynamicIr.go) {
+        snippetInputs.push({
+            language: "go",
+            ir: dynamicIr.go
+        });
+    }
+    if (dynamicIr.php) {
+        snippetInputs.push({
+            language: "php",
+            ir: dynamicIr.php
+        });
+    }
+    const snippetResolver = new SnippetResolver({ snippetInputs });
+    const endpointPath = `${endpoint.method} ${endpoint.path
+        .map((p) => {
+        if (p.type === "pathParameter") {
+            return `{${p.value}}`;
+        }
+        return p.value;
+    })
+        .join("")}`;
+    if (dynamicIr.typescript) {
+        const typescriptSdk = snippetResolver.sdk("typescript");
+        generators.typescript = typescriptSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.python) {
+        const pythonSdk = snippetResolver.sdk("python");
+        generators.python = pythonSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.java) {
+        const javaSdk = snippetResolver.sdk("java");
+        generators.java = javaSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.ruby) {
+        const rubySdk = snippetResolver.sdk("ruby");
+        generators.ruby = rubySdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.swift) {
+        const swiftSdk = snippetResolver.sdk("swift");
+        generators.swift = swiftSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.csharp) {
+        const csharpSdk = snippetResolver.sdk("csharp");
+        generators.csharp = csharpSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.go) {
+        const goSdk = snippetResolver.sdk("go");
+        generators.go = goSdk?.endpoint(endpointPath);
+    }
+    if (dynamicIr.php) {
+        const phpSdk = snippetResolver.sdk("php");
+        generators.php = phpSdk?.endpoint(endpointPath);
+    }
+    return generators;
+}
+//# sourceMappingURL=backfill.js.map

package/dist/api-definition/snippets/backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.ts"],"names":[],"mappings":"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"}

package/dist/api-definition/snippets/backfill.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backfill.test.d.ts.map

package/dist/api-definition/snippets/backfill.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.test.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/backfill.test.ts"],"names":[],"mappings":""}