@fern-api/fdr-sdk 1.1.24-e30ed51fda → 1.1.24-e3bdb9c0a9

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

@@ -0,0 +1,290 @@
+import { HTTPSnippet } from "httpsnippet-lite";
+import { HttpSnippetConverter } from "./HttpSnippetConverter";
+/**
+ * Build a minimal HAR request with a Basic Auth header for testing.
+ */
+function buildHarRequestWithBasicAuth(auth) {
+    return {
+        httpVersion: "1.1",
+        method: "GET",
+        url: "https://api.example.com/plants",
+        headers: [
+            {
+                name: "Authorization",
+                value: `Basic ${auth.username}:${auth.password}`
+            }
+        ],
+        headersSize: -1,
+        queryString: [],
+        cookies: [],
+        bodySize: -1
+    };
+}
+const BASIC_AUTH = {
+    username: "<api_key>",
+    password: "<password>"
+};
+const BASIC_AUTH_NO_PASSWORD = {
+    username: "<api_key>",
+    password: "",
+    passwordAlwaysEmpty: true
+};
+describe("HttpSnippetConverter native basic auth", () => {
+    it("python: uses native auth= parameter", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("python", "requests");
+        expect(code).toBeDefined();
+        expect(code).toContain('auth=("<api_key>", "<password>")');
+        expect(code).not.toContain("import base64");
+        expect(code).not.toContain('"Authorization"');
+    });
+    it("javascript: extracts credentials into btoa variable", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("javascript", "fetch");
+        expect(code).toBeDefined();
+        expect(code).toContain('btoa("<api_key>:<password>")');
+        expect(code).toContain("`Basic ${credentials}`");
+        expect(code).not.toMatch(/"Basic <api_key>:<password>"/);
+    });
+    it("go: uses native SetBasicAuth method", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("go", "native");
+        expect(code).toBeDefined();
+        expect(code).toContain('req.SetBasicAuth("<api_key>", "<password>")');
+        expect(code).not.toContain('"Basic <api_key>:<password>"');
+    });
+    it("ruby: uses native basic_auth method", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("ruby", "native");
+        expect(code).toBeDefined();
+        expect(code).toContain('request.basic_auth("<api_key>", "<password>")');
+        expect(code).not.toContain("require 'base64'");
+        expect(code).not.toContain('"Basic <api_key>:<password>"');
+    });
+    it("java: uses native basicAuth method", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("java", "unirest");
+        expect(code).toBeDefined();
+        expect(code).toContain('.basicAuth("<api_key>", "<password>")');
+        expect(code).not.toContain("import java.util.Base64;");
+        expect(code).not.toContain('"Basic <api_key>:<password>"');
+    });
+    it("php: uses native auth option", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("php", "guzzle");
+        expect(code).toBeDefined();
+        expect(code).toContain("'auth' => ['<api_key>', '<password>']");
+        expect(code).not.toContain("base64_encode");
+        expect(code).not.toContain("'Basic <api_key>:<password>'");
+    });
+    it("csharp: uses native HttpBasicAuthenticator", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("csharp", "restsharp");
+        expect(code).toBeDefined();
+        expect(code).toContain("using RestSharp.Authenticators;");
+        expect(code).toContain('HttpBasicAuthenticator("<api_key>", "<password>")');
+        expect(code).not.toContain("using System;");
+        expect(code).not.toContain('"Basic <api_key>:<password>"');
+    });
+    it("swift: extracts credentials with base64EncodedString", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const code = await converter.convert("swift", "nsurlsession");
+        expect(code).toBeDefined();
+        expect(code).toContain('Data("<api_key>:<password>".utf8).base64EncodedString()');
+        expect(code).toContain('"Basic \\(credentials)"');
+        expect(code).not.toMatch(/"Basic <api_key>:<password>"/);
+    });
+    it("does not modify code when no basicAuth is provided", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har); // no basicAuth
+        const code = await converter.convert("python", "requests");
+        expect(code).toBeDefined();
+        expect(code).toContain("Basic <api_key>:<password>");
+        expect(code).not.toContain("import base64");
+    });
+    it("convertAll uses native auth for all supported languages", async () => {
+        const har = buildHarRequestWithBasicAuth(BASIC_AUTH);
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH);
+        const results = await converter.convertAll();
+        expect(results.length).toBeGreaterThan(0);
+        for (const { targetId, code } of results) {
+            expect(code).not.toContain(`"Basic <api_key>:<password>"`);
+            switch (targetId) {
+                case "python":
+                    expect(code).toContain("auth=");
+                    break;
+                case "javascript":
+                    expect(code).toContain("btoa");
+                    break;
+                case "go":
+                    expect(code).toContain("SetBasicAuth");
+                    break;
+                case "ruby":
+                    expect(code).toContain("basic_auth");
+                    break;
+                case "java":
+                    expect(code).toContain("basicAuth");
+                    break;
+                case "php":
+                    expect(code).toContain("'auth'");
+                    break;
+                case "csharp":
+                    expect(code).toContain("HttpBasicAuthenticator");
+                    break;
+                case "swift":
+                    expect(code).toContain("base64EncodedString");
+                    break;
+            }
+        }
+    });
+});
+describe("HttpSnippetConverter passwordAlwaysEmpty", () => {
+    it("python: uses empty password with auth= when passwordAlwaysEmpty", async () => {
+        const har = {
+            httpVersion: "1.1",
+            method: "GET",
+            url: "https://api.example.com/plants",
+            headers: [{ name: "Authorization", value: "Basic <api_key>:" }],
+            headersSize: -1,
+            queryString: [],
+            cookies: [],
+            bodySize: -1
+        };
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH_NO_PASSWORD);
+        const code = await converter.convert("python", "requests");
+        expect(code).toBeDefined();
+        expect(code).toContain('auth=("<api_key>", "")');
+        expect(code).not.toContain('"Authorization"');
+    });
+    it("ruby: uses empty password with basic_auth when passwordAlwaysEmpty", async () => {
+        const har = {
+            httpVersion: "1.1",
+            method: "GET",
+            url: "https://api.example.com/plants",
+            headers: [{ name: "Authorization", value: "Basic <api_key>:" }],
+            headersSize: -1,
+            queryString: [],
+            cookies: [],
+            bodySize: -1
+        };
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH_NO_PASSWORD);
+        const code = await converter.convert("ruby", "native");
+        expect(code).toBeDefined();
+        expect(code).toContain('request.basic_auth("<api_key>", "")');
+    });
+    it("java: uses empty password with basicAuth when passwordAlwaysEmpty", async () => {
+        const har = {
+            httpVersion: "1.1",
+            method: "GET",
+            url: "https://api.example.com/plants",
+            headers: [{ name: "Authorization", value: "Basic <api_key>:" }],
+            headersSize: -1,
+            queryString: [],
+            cookies: [],
+            bodySize: -1
+        };
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH_NO_PASSWORD);
+        const code = await converter.convert("java", "unirest");
+        expect(code).toBeDefined();
+        expect(code).toContain('.basicAuth("<api_key>", "")');
+    });
+    it("csharp: uses empty password with HttpBasicAuthenticator when passwordAlwaysEmpty", async () => {
+        const har = {
+            httpVersion: "1.1",
+            method: "GET",
+            url: "https://api.example.com/plants",
+            headers: [{ name: "Authorization", value: "Basic <api_key>:" }],
+            headersSize: -1,
+            queryString: [],
+            cookies: [],
+            bodySize: -1
+        };
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH_NO_PASSWORD);
+        const code = await converter.convert("csharp", "restsharp");
+        expect(code).toBeDefined();
+        expect(code).toContain('HttpBasicAuthenticator("<api_key>", "")');
+    });
+    it("php: uses empty password with auth option when passwordAlwaysEmpty", async () => {
+        const har = {
+            httpVersion: "1.1",
+            method: "GET",
+            url: "https://api.example.com/plants",
+            headers: [{ name: "Authorization", value: "Basic <api_key>:" }],
+            headersSize: -1,
+            queryString: [],
+            cookies: [],
+            bodySize: -1
+        };
+        const converter = new HttpSnippetConverter(har, BASIC_AUTH_NO_PASSWORD);
+        const code = await converter.convert("php", "guzzle");
+        expect(code).toBeDefined();
+        expect(code).toContain("'auth' => ['<api_key>', '']");
+    });
+});
+/**
+ * These tests verify that httpsnippet-lite's raw output contains the patterns
+ * our regex-based handlers expect to match. If httpsnippet-lite changes its
+ * output format, these tests will fail loudly rather than silently falling
+ * through to base64 fallback paths.
+ */
+describe("httpsnippet-lite raw output format verification", () => {
+    let snippet;
+    beforeAll(() => {
+        snippet = new HTTPSnippet(buildHarRequestWithBasicAuth(BASIC_AUTH));
+    });
+    async function getRawOutput(targetId, clientId) {
+        const result = await snippet.convert(targetId, clientId);
+        const raw = typeof result === "string" ? result : result != null ? result[0] : undefined;
+        expect(raw).toBeDefined();
+        return raw;
+    }
+    it("python/requests: raw output contains Authorization header in dict format", async () => {
+        const raw = await getRawOutput("python", "requests");
+        // Our handler matches: /,?\s*"Authorization":\s*"[^"]*",?/
+        expect(raw).toMatch(/"Authorization":\s*"[^"]*"/);
+    });
+    it("javascript/fetch: raw output contains Basic literal in quotes", async () => {
+        const raw = await getRawOutput("javascript", "fetch");
+        // Our handler matches the literal 'Basic <api_key>:<password>' in single or double quotes
+        expect(raw).toMatch(/['"]Basic <api_key>:<password>['"]/);
+    });
+    it("go/native: raw output contains Header.Add Authorization pattern", async () => {
+        const raw = await getRawOutput("go", "native");
+        // Our handler matches: req.Header.Add("Authorization", "Basic ...")
+        expect(raw).toMatch(/req\.Header\.Add\("Authorization",\s*"Basic [^"]*"\)/);
+    });
+    it("ruby/native: raw output contains request[Authorization] assignment", async () => {
+        const raw = await getRawOutput("ruby", "native");
+        // Our handler matches: request["Authorization"] = ...
+        expect(raw).toMatch(/request\["Authorization"\]\s*=\s*[^\n]+/);
+    });
+    it("java/unirest: raw output contains .header(Authorization, Basic) call", async () => {
+        const raw = await getRawOutput("java", "unirest");
+        // Our handler matches: .header("Authorization", "Basic ...")
+        expect(raw).toMatch(/\.header\("Authorization",\s*"Basic [^"]*"\)/);
+    });
+    it("php/guzzle: raw output contains Authorization => Basic header", async () => {
+        const raw = await getRawOutput("php", "guzzle");
+        // Our handler matches: 'Authorization' => 'Basic ...'
+        expect(raw).toMatch(/'Authorization'\s*=>\s*'Basic [^']*'/);
+    });
+    it("csharp/restsharp: raw output contains AddHeader Authorization call", async () => {
+        const raw = await getRawOutput("csharp", "restsharp");
+        // Our handler matches: request.AddHeader("Authorization", "Basic ...");
+        expect(raw).toMatch(/request\.AddHeader\("Authorization",\s*"Basic [^"]*"\);/);
+    });
+    it("swift/nsurlsession: raw output contains quoted Basic literal", async () => {
+        const raw = await getRawOutput("swift", "nsurlsession");
+        // Our handler matches the literal "Basic <api_key>:<password>" in quotes
+        expect(raw).toMatch(/"Basic <api_key>:<password>"/);
+    });
+});
+//# sourceMappingURL=HttpSnippetConverter.test.js.map

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

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

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;AAsBzC,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,CA8IpB"}

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

@@ -0,0 +1,140 @@
+import { sanitizeUrl, unknownToString } 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";
+import { preprocessQueryParameters } from "../url";
+function buildPathForSnippet(path, pathParameters) {
+    if (path == null) {
+        return "";
+    }
+    return path
+        .map((part) => {
+        if (part.type === "pathParameter") {
+            const key = part.value;
+            const value = unknownToString(pathParameters?.[key]);
+            return value.length > 0 ? value : `{${key}}`;
+        }
+        return part.value;
+    })
+        .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 endpointPathRaw = buildPathForSnippet(endpoint.path, example.pathParameters ?? undefined);
+    const examplePathRaw = example.path ? (example.path.startsWith("/") ? example.path : `/${example.path}`) : "";
+    // Normalize for comparison only (strip trailing slash, treat empty as "/")
+    const normalize = (p) => (p.endsWith("/") ? p.slice(0, -1) : p) || "/";
+    const endpointPath = normalize(endpointPathRaw);
+    const examplePath = normalize(examplePathRaw);
+    // Use endpoint.path if example.path is missing, or if endpoint.path equals / extends example.path
+    // (endpoint.path carries the base path prefix)
+    const useEndpointPath = examplePathRaw === "" ||
+        endpointPath === examplePath ||
+        (endpointPath.length > examplePath.length && endpointPath.endsWith(examplePath));
+    const fullPath = useEndpointPath ? endpointPathRaw : examplePathRaw;
+    const url = urljoin(compact([sanitizedEnvironment, fullPath]));
+    const headers = { ...example.headers };
+    let basicAuth;
+    if (endpoint.auth && endpoint.auth.length > 0 && auth) {
+        visitDiscriminatedUnion(auth, "type")._visit({
+            basicAuth: ({ usernameName = "username", passwordName = "password", passwordAlwaysEmpty }) => {
+                basicAuth = {
+                    username: `<${usernameName}>`,
+                    password: passwordAlwaysEmpty ? "" : `<${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 ?? undefined;
+    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";
+    }
+    // Preprocess query parameters based on explode metadata
+    const processedQueryParams = preprocessQueryParameters(example.queryParameters ?? undefined, endpoint.queryParameters ?? undefined) ?? {};
+    return {
+        method: endpoint.method,
+        url,
+        searchParams: processedQueryParams,
+        headers: JSON.parse(JSON.stringify(headers)),
+        basicAuth,
+        protocol: endpoint.protocol ?? undefined,
+        body: body == null
+            ? undefined
+            : visitDiscriminatedUnion(body)._visit({
+                json: (value) => value,
+                form: (value) => {
+                    const toRet = {};
+                    for (const [key, val] of Object.entries(value.value)) {
+                        const typedVal = val;
+                        const formValue = visitDiscriminatedUnion(typedVal, "type")._visit({
+                            exploded: (value) => ({ type: "exploded", value: value.value }),
+                            json: (value) => ({ type: "json", value: value.value }),
+                            filename: (value) => ({
+                                type: "filename",
+                                filename: String(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: String(value.filename ?? ""),
+                                contentType: undefined // TODO: infer content type?
+                            }),
+                            filenamesWithData: (value) => ({
+                                type: "filenames",
+                                files: (value.value ?? []).map(({ filename }) => ({
+                                    filename,
+                                    contentType: undefined // TODO: infer content type?
+                                }))
+                            }),
+                            _other: () => undefined
+                        });
+                        if (formValue != null) {
+                            toRet[key] = formValue;
+                        }
+                    }
+                    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/auth-scheme.d.ts

@@ -0,0 +1,41 @@
+import type { ApiAuth } from "../../client/APIV1Read";
+import type { AuthScheme, AuthSchemeId, CodeSnippet, EndpointDefinition } from "../latest";
+/**
+ * Get the first auth scheme ID for an endpoint, preferring multiAuth over legacy auth.
+ * multiAuth provides proper OR-of-AND semantics for endpoint-specific security.
+ */
+export declare function getFirstAuthSchemeId(endpoint: EndpointDefinition): AuthSchemeId | undefined;
+/**
+ * Get the first auth scheme for an endpoint from the auths record.
+ * Uses getFirstAuthSchemeId to select the correct auth scheme.
+ */
+export declare function getFirstAuthScheme<T extends AuthScheme | ApiAuth>(endpoint: EndpointDefinition, auths: Record<AuthSchemeId, T>): T | undefined;
+/**
+ * Get the header name for an auth scheme.
+ * Returns the header wire value for header auth, "Authorization" for bearer/OAuth, or undefined.
+ */
+export declare function getAuthHeaderName(auth: AuthScheme | ApiAuth | undefined): string | undefined;
+/**
+ * Check if a snippet is likely auto-generated (not user-provided).
+ * A snippet is considered likely generated if:
+ * - generated === true, OR
+ * - generated is undefined AND name, install, and description are all null
+ */
+export declare function isLikelyGeneratedSnippet(snippet: CodeSnippet): boolean;
+/**
+ * Determine if a curl snippet should be regenerated because it has the wrong auth header or URL.
+ * Only regenerates if:
+ * - No existing snippets exist, OR
+ * - All existing snippets are likely generated AND none contain the expected header, OR
+ * - For basic auth: existing snippets use -H "Authorization: Basic" instead of -u flag, OR
+ * - The endpoint has a non-trivial path but no existing snippet's URL contains it
+ *   (targeted repair for snippets generated before the empty-example-path fix)
+ */
+export declare function shouldRegenerateCurlSnippet(existingSnippets: CodeSnippet[] | undefined, expectedHeaderName: string | undefined, authScheme?: AuthScheme | ApiAuth, endpoint?: EndpointDefinition): boolean;
+/**
+ * Determine if an HTTP snippet for a given language should be regenerated.
+ * Always regenerates auto-generated snippets so they pick up the latest
+ * generation logic. Only preserves user-provided snippets (generated === false).
+ */
+export declare function shouldRegenerateHttpSnippet(existingSnippets: CodeSnippet[] | undefined): boolean;
+//# sourceMappingURL=auth-scheme.d.ts.map

package/dist/api-definition/snippets/auth-scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-scheme.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/auth-scheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE3F;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,YAAY,GAAG,SAAS,CAQ3F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,GAAG,OAAO,EAC7D,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,GAC/B,CAAC,GAAG,SAAS,CAGf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAW5F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAQtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACvC,gBAAgB,EAAE,WAAW,EAAE,GAAG,SAAS,EAC3C,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,EACjC,QAAQ,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAiDT;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,gBAAgB,EAAE,WAAW,EAAE,GAAG,SAAS,GAAG,OAAO,CAMhG"}