@fern-api/fdr-sdk 1.1.23-bebb482a16 → 1.1.23-ebc4c54fb0

package/dist/api-definition/snippets/auth-scheme.js

@@ -0,0 +1,105 @@
+/**
+ * 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 function getFirstAuthSchemeId(endpoint) {
+    if (endpoint.multiAuth != null && endpoint.multiAuth.length > 0) {
+        const firstGroup = endpoint.multiAuth[0];
+        if (firstGroup && firstGroup.schemes.length > 0) {
+            return firstGroup.schemes[0];
+        }
+    }
+    return endpoint.auth?.[0];
+}
+/**
+ * Get the first auth scheme for an endpoint from the auths record.
+ * Uses getFirstAuthSchemeId to select the correct auth scheme.
+ */
+export function getFirstAuthScheme(endpoint, auths) {
+    const authId = getFirstAuthSchemeId(endpoint);
+    return authId != null ? auths[authId] : undefined;
+}
+/**
+ * Get the header name for an auth scheme.
+ * Returns the header wire value for header auth, "Authorization" for bearer/OAuth, or undefined.
+ */
+export function getAuthHeaderName(auth) {
+    if (auth == null) {
+        return undefined;
+    }
+    if (auth.type === "header") {
+        return auth.headerWireValue;
+    }
+    if (auth.type === "bearerAuth" || auth.type === "oAuth") {
+        return "Authorization";
+    }
+    return 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 function isLikelyGeneratedSnippet(snippet) {
+    if (snippet.generated === true) {
+        return true;
+    }
+    if (snippet.generated === false) {
+        return false;
+    }
+    return snippet.name == null && snippet.install == null && snippet.description == null;
+}
+/**
+ * Determine if a curl snippet should be regenerated because it has the wrong auth header.
+ * 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
+ */
+export function shouldRegenerateCurlSnippet(existingSnippets, expectedHeaderName, authScheme) {
+    if (existingSnippets == null || existingSnippets.length === 0) {
+        return true;
+    }
+    const allLikelyGenerated = existingSnippets.every(isLikelyGeneratedSnippet);
+    if (!allLikelyGenerated) {
+        return false;
+    }
+    // For basic auth, check if snippets use -H "Authorization: Basic" instead of -u flag
+    // If so, regenerate to use -u flag
+    if (authScheme?.type === "basicAuth") {
+        const usesBasicAuthHeader = existingSnippets.some((s) => s.code.includes('-H "Authorization: Basic') || s.code.includes("-H 'Authorization: Basic"));
+        if (usesBasicAuthHeader) {
+            return true;
+        }
+        // If passwordAlwaysEmpty, regenerate if existing snippet still contains a password placeholder
+        if (authScheme.passwordAlwaysEmpty) {
+            const passwordName = authScheme.passwordName ?? "password";
+            const hasPasswordPlaceholder = existingSnippets.some((s) => s.code.includes(`:<${passwordName}>`));
+            if (hasPasswordPlaceholder) {
+                return true;
+            }
+        }
+        // If basic auth and no header found, check if -u flag is present
+        const usesUFlag = existingSnippets.some((s) => s.code.includes("-u "));
+        // If -u flag is present, no need to regenerate
+        return !usesUFlag;
+    }
+    if (expectedHeaderName == null) {
+        return false;
+    }
+    const hasCorrectHeader = existingSnippets.some((s) => s.code.includes(`"${expectedHeaderName}:`) || s.code.includes(`'${expectedHeaderName}:`));
+    return !hasCorrectHeader;
+}
+/**
+ * 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 function shouldRegenerateHttpSnippet(existingSnippets) {
+    if (existingSnippets == null || existingSnippets.length === 0) {
+        return false; // nothing to regenerate; will be generated fresh
+    }
+    return existingSnippets.every(isLikelyGeneratedSnippet);
+}
+//# sourceMappingURL=auth-scheme.js.map

package/dist/api-definition/snippets/auth-scheme.js.map

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

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

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

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

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

package/dist/api-definition/snippets/auth-scheme.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, it } from "vitest";
+import { shouldRegenerateCurlSnippet, shouldRegenerateHttpSnippet } from "./auth-scheme";
+function makeSnippet(code, generated = true, language = "curl") {
+    return {
+        name: undefined,
+        language,
+        install: undefined,
+        code,
+        generated,
+        description: undefined
+    };
+}
+describe("shouldRegenerateCurlSnippet", () => {
+    it("should regenerate when no existing snippets", () => {
+        expect(shouldRegenerateCurlSnippet(undefined, undefined)).toBe(true);
+        expect(shouldRegenerateCurlSnippet([], undefined)).toBe(true);
+    });
+    it("should not regenerate user-provided snippets", () => {
+        const snippet = makeSnippet('curl -u "key:<password>" https://api.example.com', false);
+        expect(shouldRegenerateCurlSnippet([snippet], undefined)).toBe(false);
+    });
+    it("should regenerate basic auth snippets using -H Authorization header instead of -u flag", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: false
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -H "Authorization: Basic Q0xPU0VfQVBJX0tFWTpwYXNzd29yZA=="');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(true);
+    });
+    it("should not regenerate basic auth snippets already using -u flag", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: false
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -u "<CLOSE_API_KEY>:<password>"');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(false);
+    });
+    it("should regenerate when passwordAlwaysEmpty is true and snippet contains password placeholder", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: true
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -u "<CLOSE_API_KEY>:<password>"');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(true);
+    });
+    it("should regenerate when passwordAlwaysEmpty is true and snippet contains custom password placeholder", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "API_KEY",
+            passwordName: "secret",
+            passwordAlwaysEmpty: true
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -u "<API_KEY>:<secret>"');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(true);
+    });
+    it("should not regenerate when passwordAlwaysEmpty is true and snippet already omits password", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: true
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -u "<CLOSE_API_KEY>:"');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(false);
+    });
+    it("should not regenerate when passwordAlwaysEmpty is false and snippet has password placeholder", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: false
+        };
+        const snippet = makeSnippet('curl https://api.example.com \\\n     -u "<CLOSE_API_KEY>:<password>"');
+        expect(shouldRegenerateCurlSnippet([snippet], undefined, authScheme)).toBe(false);
+    });
+});
+describe("shouldRegenerateHttpSnippet", () => {
+    it("returns false when no existing snippets", () => {
+        expect(shouldRegenerateHttpSnippet(undefined)).toBe(false);
+        expect(shouldRegenerateHttpSnippet([])).toBe(false);
+    });
+    it("returns true for auto-generated snippets (generated === true)", () => {
+        const snippet = makeSnippet("any code content", true, "python");
+        expect(shouldRegenerateHttpSnippet([snippet])).toBe(true);
+    });
+    it("returns false for user-provided snippets (generated === false)", () => {
+        const snippet = makeSnippet("any code content", false, "python");
+        expect(shouldRegenerateHttpSnippet([snippet])).toBe(false);
+    });
+    it("returns true for likely-generated snippets (generated not explicitly false)", () => {
+        const snippet = {
+            name: undefined,
+            language: "python",
+            install: undefined,
+            code: "any code content",
+            generated: true,
+            description: undefined
+        };
+        expect(shouldRegenerateHttpSnippet([snippet])).toBe(true);
+    });
+    it("returns false if any snippet in the array is user-provided", () => {
+        const generated = makeSnippet("generated code", true, "python");
+        const userProvided = makeSnippet("user code", false, "python");
+        expect(shouldRegenerateHttpSnippet([generated, userProvided])).toBe(false);
+    });
+    it("returns true when all snippets in array are generated", () => {
+        const snippet1 = makeSnippet("code 1", true, "python");
+        const snippet2 = makeSnippet("code 2", true, "python");
+        expect(shouldRegenerateHttpSnippet([snippet1, snippet2])).toBe(true);
+    });
+});
+//# sourceMappingURL=auth-scheme.test.js.map

package/dist/api-definition/snippets/auth-scheme.test.js.map

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

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

@@ -0,0 +1,18 @@
+import type { ApiDefinition, CodeSnippet, EndpointDefinition, ExampleEndpointCall } from "../latest";
+import type { DynamicIRsByLanguage, SnippetGenerationFlags, SnippetGenerators } from "./types";
+/**
+ * Backfill snippets for an entire API definition.
+ * This is the main entry point for snippet generation during docs loading.
+ */
+export declare function backfillSnippets(apiDefinition: ApiDefinition, dynamicIr: DynamicIRsByLanguage | undefined, flags: SnippetGenerationFlags): Promise<ApiDefinition>;
+/**
+ * Backfill snippets for a single endpoint example.
+ * Combines SDK snippets (from dynamic IR) and HTTP snippets (from httpsnippet-lite).
+ */
+export declare function backfillSnippetsForExample(apiDefinition: ApiDefinition, dynamicGenerators: SnippetGenerators, endpoint: EndpointDefinition, example: ExampleEndpointCall, flags: SnippetGenerationFlags): Promise<ExampleEndpointCall>;
+/**
+ * Generate all snippets for a single example without modifying the original.
+ * This is a utility function for use in FDR registration and other contexts.
+ */
+export declare function generateSnippetsForExample(apiDefinition: ApiDefinition, endpoint: EndpointDefinition, example: ExampleEndpointCall, dynamicIr: DynamicIRsByLanguage | undefined, flags: SnippetGenerationFlags): Promise<Record<string, CodeSnippet[]>>;
+//# 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":"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"}

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

@@ -0,0 +1,110 @@
+import { createSnippetGenerators } from "./generators";
+import { generateHttpSnippets, shouldIncludeHttpSnippetLanguage } from "./http-snippets";
+import { generateSdkSnippets } from "./sdk-snippets";
+/**
+ * Backfill snippets for an entire API definition.
+ * This is the main entry point for snippet generation during docs loading.
+ */
+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))
+    };
+}
+/**
+ * Backfill snippets for a single endpoint example.
+ * Combines SDK snippets (from dynamic IR) and HTTP snippets (from httpsnippet-lite).
+ */
+export async function backfillSnippetsForExample(apiDefinition, dynamicGenerators, endpoint, example, flags) {
+    const snippets = { ...example.snippets };
+    const pushSnippet = (snippet) => {
+        (snippets[snippet.language] ??= []).push(snippet);
+    };
+    // Remove curl if it shouldn't be included
+    if (snippets.curl?.length && !shouldIncludeHttpSnippetLanguage("curl", flags)) {
+        delete snippets.curl;
+    }
+    // Generate SDK snippets from dynamic IR
+    if (Object.keys(dynamicGenerators).length > 0 && endpoint.method !== "HEAD") {
+        const sdkSnippets = generateSdkSnippets(apiDefinition, endpoint, example, dynamicGenerators);
+        for (const snippet of sdkSnippets) {
+            pushSnippet(snippet);
+        }
+    }
+    // Generate HTTP snippets (curl and httpsnippet-lite)
+    const httpSnippets = await generateHttpSnippets(apiDefinition, endpoint, example, {
+        flags,
+        dynamicGenerators,
+        existingSnippets: snippets
+    });
+    for (const snippet of httpSnippets) {
+        // Replace existing snippets when regenerating (targeted repair for wrong auth headers or old-style base64)
+        if (snippets[snippet.language]?.length) {
+            snippets[snippet.language] = [snippet];
+        }
+        else {
+            pushSnippet(snippet);
+        }
+    }
+    return { ...example, snippets };
+}
+/**
+ * Generate all snippets for a single example without modifying the original.
+ * This is a utility function for use in FDR registration and other contexts.
+ */
+export async function generateSnippetsForExample(apiDefinition, endpoint, example, dynamicIr, flags) {
+    let dynamicGenerators = {};
+    try {
+        if (dynamicIr) {
+            dynamicGenerators = createSnippetGenerators({ endpoint, dynamicIr });
+        }
+    }
+    catch (error) {
+        console.log("[generateSnippetsForExample] error creating dynamic snippet generators:", error);
+    }
+    const snippets = { ...example.snippets };
+    const pushSnippet = (snippet) => {
+        (snippets[snippet.language] ??= []).push(snippet);
+    };
+    // Generate SDK snippets
+    if (Object.keys(dynamicGenerators).length > 0 && endpoint.method !== "HEAD") {
+        const sdkSnippets = generateSdkSnippets(apiDefinition, endpoint, example, dynamicGenerators);
+        for (const snippet of sdkSnippets) {
+            pushSnippet(snippet);
+        }
+    }
+    // Generate HTTP snippets
+    const httpSnippets = await generateHttpSnippets(apiDefinition, endpoint, example, {
+        flags,
+        dynamicGenerators,
+        existingSnippets: snippets
+    });
+    for (const snippet of httpSnippets) {
+        // Replace existing snippets when regenerating (targeted repair for wrong auth headers or old-style base64)
+        if (snippets[snippet.language]?.length) {
+            snippets[snippet.language] = [snippet];
+        }
+        else {
+            pushSnippet(snippet);
+        }
+    }
+    return snippets;
+}
+//# 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":""}