@fern-api/fdr-sdk 1.2.16-3b754a56be → 1.2.16-3bf669ca8e

package/dist/api-definition/snippets/curl.test.js

@@ -0,0 +1,552 @@
+import { convertToCurl, getUrlQueriesGetString } from "./curl";
+describe("curl", () => {
+    it("generates basic GET request", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/users",
+            headers: {},
+            searchParams: {},
+            body: undefined
+        })).toMatchInlineSnapshot('"curl https://api.example.com/users"');
+    });
+    it("generates POST request with JSON body", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/users",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            searchParams: {},
+            body: {
+                type: "json",
+                value: {
+                    name: "John Doe",
+                    email: "john@example.com"
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/users \\
+               -H "Content-Type: application/json" \\
+               -d '{
+            "name": "John Doe",
+            "email": "john@example.com"
+          }'"
+        `);
+    });
+    it("escapes single quotes in JSON body so the cURL command is runnable in a POSIX shell", () => {
+        // Single-quoted shell strings cannot contain a backslash-escaped single quote;
+        // the only portable way to embed `'` is to close the quoted string, emit `\'`,
+        // and re-open it (i.e. `'\''`).
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/research",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            searchParams: {},
+            body: {
+                type: "json",
+                value: {
+                    input: "What were the key drivers of NVIDIA's (NVDA) revenue growth in fiscal year 2025?",
+                    research_effort: "deep"
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/research \\
+               -H "Content-Type: application/json" \\
+               -d '{
+            "input": "What were the key drivers of NVIDIA'\\''s (NVDA) revenue growth in fiscal year 2025?",
+            "research_effort": "deep"
+          }'"
+        `);
+    });
+    it("escapes single quotes in OpenRPC JSON body so the cURL command is runnable in a POSIX shell", () => {
+        // Regression guard for the OpenRPC branch of getBodyJsonString.
+        // Same close-escape-reopen rationale as the JSON body test above:
+        // POSIX shells don't interpret `\'` inside `'...'`, so the only
+        // portable way to embed `'` is `'\''`.
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/jsonrpc",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            searchParams: {},
+            protocol: { type: "openrpc", methodName: "users.create" },
+            body: {
+                type: "json",
+                value: {
+                    name: "Mary O'Brien",
+                    bio: "It's a test"
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/jsonrpc \\
+               -H "Content-Type: application/json" \\
+               -d '{
+            "jsonrpc": "2.0",
+            "method": "users.create",
+            "params": [
+              "Mary O'\\''Brien",
+              "It'\\''s a test"
+            ],
+            "id": 1
+          }'"
+        `);
+    });
+    it("escapes single quotes in multipart JSON form values so the cURL command is runnable in a POSIX shell", () => {
+        // Regression guard for getBodyFormValueJsonString. Multipart JSON
+        // values are emitted as `-F key='{...}'`, so the same close-escape-reopen
+        // pattern is required when the JSON contains an apostrophe.
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    meta: {
+                        type: "json",
+                        value: {
+                            description: "Mary's file",
+                            note: "It's important"
+                        }
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F meta='{
+            "description": "Mary'\\''s file",
+            "note": "It'\\''s important"
+          }'"
+        `);
+    });
+    it("generates request with basic auth", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/secure",
+            headers: {
+                Authorization: "Basic ey123=="
+            },
+            searchParams: {},
+            basicAuth: {
+                username: "user",
+                password: "pass123"
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`
+          "curl https://api.example.com/secure \\
+               -u "user:pass123""
+        `);
+    });
+    it("generates request with form data", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    file: {
+                        type: "filename",
+                        filename: "test.txt",
+                        contentType: "text/plain"
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F file=@"test.txt;type=text/plain""
+        `);
+    });
+    it("generates request with multiple files in form data", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    files: {
+                        type: "filenames",
+                        files: [
+                            {
+                                filename: "test1.txt",
+                                contentType: "text/plain"
+                            },
+                            {
+                                filename: "test2.jpg",
+                                contentType: "image/jpeg"
+                            }
+                        ]
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F "files[]"=@"test1.txt;type=text/plain" \\
+               -F "files[]"=@"test2.jpg;type=image/jpeg""
+        `);
+    });
+    it("generates request with multiple form fields including files", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    title: {
+                        type: "json",
+                        value: "My Upload"
+                    },
+                    description: {
+                        type: "json",
+                        value: "Multiple file upload test"
+                    },
+                    files: {
+                        type: "filenames",
+                        files: [
+                            {
+                                filename: "document.pdf",
+                                contentType: "application/pdf"
+                            },
+                            {
+                                filename: "image.png",
+                                contentType: "image/png"
+                            }
+                        ]
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F title="My Upload" \\
+               -F description="Multiple file upload test" \\
+               -F "files[]"=@"document.pdf;type=application/pdf" \\
+               -F "files[]"=@"image.png;type=image/png""
+        `);
+    });
+    it("generates request without urlencoded parameters", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/form",
+            headers: {},
+            searchParams: {
+                name: "John Doe",
+                email: "john@example.com",
+                items: ["item1", "item2"]
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`"curl -X POST "https://api.example.com/form?name=John%20Doe&email=john%40example.com&items=item1&items=item2""`);
+    });
+    it("generates request with urlencoded form data", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/form",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded"
+            },
+            searchParams: {},
+            body: {
+                type: "json",
+                value: {
+                    name: "John Doe",
+                    email: "john@example.com",
+                    items: ["item1", "item2"]
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/form \\
+               -H "Content-Type: application/x-www-form-urlencoded" \\
+               -d "name=John%20Doe" \\
+               -d "email=john%40example.com" \\
+               -d "items=item1" \\
+               -d "items=item2""
+        `);
+    });
+    it("generates GET request with urlencoded parameters", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/search",
+            headers: {},
+            searchParams: {
+                q: "search term with spaces",
+                filter: ["category1", "category2"],
+                sort: "date desc"
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`
+      "curl -G https://api.example.com/search \\
+           --data-urlencode "q=search term with spaces" \\
+           -d filter=category1 \\
+           -d filter=category2 \\
+           --data-urlencode "sort=date desc""
+    `);
+    });
+    it("does not include nulls in urlencoded parameters", () => {
+        expect(getUrlQueriesGetString({ a: null, b: "b" })).toMatchInlineSnapshot(`
+      [
+        "-d b=b",
+      ]
+    `);
+        expect(getUrlQueriesGetString({ a: ["b1", null, "b2"] })).toMatchInlineSnapshot(`
+        [
+          "-d a=b1",
+          "-d a=b2",
+        ]
+      `);
+    });
+    it("generates POST request with openrpc protocol", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/jsonrpc",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            searchParams: {},
+            body: {
+                type: "json",
+                value: {
+                    jsonrpc: "2.0",
+                    method: "users.create",
+                    params: {
+                        name: "John Doe",
+                        email: "john@example.com"
+                    },
+                    id: 1
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/jsonrpc \\
+               -H "Content-Type: application/json" \\
+               -d '{
+            "jsonrpc": "2.0",
+            "method": "users.create",
+            "params": {
+              "name": "John Doe",
+              "email": "john@example.com"
+            },
+            "id": 1
+          }'"
+        `);
+    });
+    it("generates request with exploded form parameters", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    tags: {
+                        type: "exploded",
+                        value: ["tag1", "tag2", "tag3"]
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F tags="tag1" \\
+               -F tags="tag2" \\
+               -F tags="tag3""
+        `);
+    });
+    it("generates GET request with object query params", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/obj-query-params",
+            headers: {},
+            searchParams: {
+                include: "verifications",
+                fields: {
+                    "verification/driver-license": "status,created-at"
+                }
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`
+      "curl -G https://api.example.com/obj-query-params \\
+           -d include=verifications \\
+           --data-urlencode "fields[verification/driver-license]=status,created-at""
+    `);
+    });
+    it("generates request with basic auth and empty password (passwordAlwaysEmpty)", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/secure",
+            headers: {},
+            searchParams: {},
+            basicAuth: {
+                username: "<CLOSE_API_KEY>",
+                password: ""
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`
+          "curl https://api.example.com/secure \\
+               -u "<CLOSE_API_KEY>:""
+        `);
+    });
+    it("generates request with basic auth including password placeholder", () => {
+        expect(convertToCurl({
+            method: "GET",
+            url: "https://api.example.com/secure",
+            headers: {},
+            searchParams: {},
+            basicAuth: {
+                username: "<CLOSE_API_KEY>",
+                password: "<password>"
+            },
+            body: undefined
+        })).toMatchInlineSnapshot(`
+          "curl https://api.example.com/secure \\
+               -u "<CLOSE_API_KEY>:<password>""
+        `);
+    });
+    it("replaces {filename} placeholder with actual filename for single file uploads", () => {
+        // Some OpenAPI specs (e.g. Uploadcare) declare a multipart property
+        // whose name is the literal token `{filename}`. When the playground
+        // emits curl, that placeholder must be replaced with the real filename
+        // of the uploaded file so the request the user copies actually works.
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://upload.uploadcare.com/base/",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    UPLOADCARE_PUB_KEY: {
+                        type: "json",
+                        value: "demopublickey"
+                    },
+                    "{filename}": {
+                        type: "filename",
+                        filename: "testfile.png",
+                        contentType: "image/png"
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://upload.uploadcare.com/base/ \\
+               -H "Content-Type: multipart/form-data" \\
+               -F UPLOADCARE_PUB_KEY="demopublickey" \\
+               -F "testfile.png"=@"testfile.png;type=image/png""
+        `);
+    });
+    it("replaces {filename} placeholder per file for multi-file uploads (no [] suffix)", () => {
+        // For multi-file uploads where the property name is the {filename}
+        // placeholder (e.g. Uploadcare's /base/ endpoint), each file should be
+        // emitted as its own field whose name is the file's real filename. The
+        // legacy `[]` array suffix must be omitted because the keys are
+        // already unique per file.
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://upload.uploadcare.com/base/",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    "{filename}": {
+                        type: "filenames",
+                        files: [
+                            {
+                                filename: "first.png",
+                                contentType: "image/png"
+                            },
+                            {
+                                filename: "second.jpg",
+                                contentType: "image/jpeg"
+                            }
+                        ]
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://upload.uploadcare.com/base/ \\
+               -H "Content-Type: multipart/form-data" \\
+               -F "first.png"=@"first.png;type=image/png" \\
+               -F "second.jpg"=@"second.jpg;type=image/jpeg""
+        `);
+    });
+    it("preserves existing [] suffix for multi-file uploads without {filename} placeholder", () => {
+        // Regression guard: when the property name is a regular field (not a
+        // {filename} placeholder), the existing array-style emission with
+        // `field[]` must continue to work.
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/upload",
+            headers: {
+                "Content-Type": "multipart/form-data"
+            },
+            searchParams: {},
+            body: {
+                type: "form",
+                value: {
+                    attachments: {
+                        type: "filenames",
+                        files: [
+                            { filename: "a.txt", contentType: "text/plain" },
+                            { filename: "b.txt", contentType: "text/plain" }
+                        ]
+                    }
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/upload \\
+               -H "Content-Type: multipart/form-data" \\
+               -F "attachments[]"=@"a.txt;type=text/plain" \\
+               -F "attachments[]"=@"b.txt;type=text/plain""
+        `);
+    });
+    it("generates POST request with null JSON body fields", () => {
+        expect(convertToCurl({
+            method: "POST",
+            url: "https://api.example.com/null-json-fields",
+            headers: {
+                "Content-Type": "application/json"
+            },
+            searchParams: {},
+            body: {
+                type: "json",
+                value: {
+                    name: null,
+                    email: "john@example.com"
+                }
+            }
+        })).toMatchInlineSnapshot(`
+          "curl -X POST https://api.example.com/null-json-fields \\
+               -H "Content-Type: application/json" \\
+               -d '{
+            "name": null,
+            "email": "john@example.com"
+          }'"
+        `);
+    });
+});
+//# sourceMappingURL=curl.test.js.map

package/dist/api-definition/snippets/curl.test.js.map

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

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

@@ -0,0 +1,14 @@
+import type { EndpointDefinition } from "../latest";
+import type { DynamicIRsByLanguage, SnippetGenerators } from "./types";
+/**
+ * Build the endpoint path string used for snippet generation
+ */
+export declare function buildEndpointPath(endpoint: EndpointDefinition): string;
+/**
+ * Create snippet generators for all available languages in the dynamic IR
+ */
+export declare function createSnippetGenerators({ endpoint, dynamicIr }: {
+    endpoint: EndpointDefinition;
+    dynamicIr: DynamicIRsByLanguage;
+}): SnippetGenerators;
+//# sourceMappingURL=generators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/generators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEvE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAStE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,QAAQ,EACR,SAAS,EACZ,EAAE;IACC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,EAAE,oBAAoB,CAAC;CACnC,GAAG,iBAAiB,CAepB"}

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

@@ -0,0 +1,85 @@
+import { SnippetResolver } from "@fern-api/snippets";
+/**
+ * Build the endpoint path string used for snippet generation
+ */
+export function buildEndpointPath(endpoint) {
+    return `${endpoint.method} ${endpoint.path
+        .map((p) => {
+        if (p.type === "pathParameter") {
+            return `{${p.value}}`;
+        }
+        return p.value;
+    })
+        .join("")}`;
+}
+/**
+ * Create snippet generators for all available languages in the dynamic IR
+ */
+export function createSnippetGenerators({ endpoint, dynamicIr }) {
+    if (endpoint.method === "HEAD") {
+        return {};
+    }
+    const snippetInputs = collectSnippetInputs(dynamicIr);
+    if (snippetInputs.length === 0) {
+        return {};
+    }
+    const snippetResolver = new SnippetResolver({ snippetInputs });
+    const endpointPath = buildEndpointPath(endpoint);
+    return buildGeneratorsFromResolver(snippetResolver, endpointPath, dynamicIr);
+}
+/**
+ * Collect snippet inputs from dynamic IR for available languages
+ */
+function collectSnippetInputs(dynamicIr) {
+    const inputs = [];
+    if (dynamicIr.typescript) {
+        inputs.push({ language: "typescript", ir: dynamicIr.typescript });
+    }
+    if (dynamicIr.python) {
+        inputs.push({ language: "python", ir: dynamicIr.python });
+    }
+    if (dynamicIr.java) {
+        inputs.push({ language: "java", ir: dynamicIr.java });
+    }
+    if (dynamicIr.ruby) {
+        inputs.push({ language: "ruby", ir: dynamicIr.ruby });
+    }
+    if (dynamicIr.swift) {
+        inputs.push({ language: "swift", ir: dynamicIr.swift });
+    }
+    if (dynamicIr.csharp) {
+        inputs.push({ language: "csharp", ir: dynamicIr.csharp });
+    }
+    if (dynamicIr.go) {
+        inputs.push({ language: "go", ir: dynamicIr.go });
+    }
+    if (dynamicIr.php) {
+        inputs.push({ language: "php", ir: dynamicIr.php });
+    }
+    return inputs;
+}
+/**
+ * Build generators from the snippet resolver for available languages.
+ * Each language is resolved independently so that a failure in one
+ * (e.g. a stale dynamic IR missing an endpoint) does not discard
+ * generators that were already resolved for other languages.
+ */
+function buildGeneratorsFromResolver(snippetResolver, endpointPath, dynamicIr) {
+    const generators = {};
+    const languages = ["typescript", "python", "java", "ruby", "swift", "csharp", "go", "php"];
+    for (const language of languages) {
+        if (!dynamicIr[language]) {
+            continue;
+        }
+        try {
+            const sdk = snippetResolver.sdk(language);
+            generators[language] = sdk?.endpoint(endpointPath);
+        }
+        catch {
+            // Endpoint not found in this language's dynamic IR; skip it
+            // without affecting other languages.
+        }
+    }
+    return generators;
+}
+//# sourceMappingURL=generators.js.map

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

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