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

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

@@ -0,0 +1,96 @@
+import { getAuthHeaderName, getFirstAuthScheme, shouldRegenerateCurlSnippet, shouldRegenerateHttpSnippet } from "./auth-scheme";
+import { HTTP_SNIPPET_CLIENTS } from "./constants";
+import { convertToCurl } from "./curl";
+import { getHarRequest, getHarRequestBasicAuth } from "./get-har-request";
+import { HttpSnippetConverter } from "./HttpSnippetConverter";
+import { toSnippetHttpRequest } from "./SnippetHttpRequest";
+/**
+ * Generate a curl snippet for an endpoint example
+ */
+export function generateCurlSnippet(apiDefinition, endpoint, example) {
+    const authScheme = getFirstAuthScheme(endpoint, apiDefinition.auths);
+    const curlCode = convertToCurl(toSnippetHttpRequest(endpoint, example, authScheme));
+    return {
+        name: undefined,
+        language: "curl",
+        install: undefined,
+        code: curlCode,
+        generated: true,
+        description: undefined
+    };
+}
+/**
+ * Generate HTTP snippets for an endpoint example using httpsnippet-lite
+ */
+export async function generateHttpSnippets(apiDefinition, endpoint, example, options) {
+    const { flags, dynamicGenerators = {}, existingSnippets = {} } = options;
+    const snippets = [];
+    const isHttpSnippetsEnabled = flags.httpSnippets !== false;
+    const httpSnippetLanguages = Array.isArray(flags.httpSnippets) ? flags.httpSnippets : null;
+    // Check if a language should be included based on the httpSnippets configuration
+    const shouldIncludeLanguage = (language) => {
+        if (!isHttpSnippetsEnabled) {
+            return language === "curl";
+        }
+        return httpSnippetLanguages == null || httpSnippetLanguages.includes(language);
+    };
+    // Generate or regenerate curl snippet if needed
+    // Regenerate if existing snippet has wrong auth header (targeted repair for pre-stored snippets)
+    // Also regenerate if basic auth uses -H "Authorization: Basic" instead of -u flag
+    const authScheme = getFirstAuthScheme(endpoint, apiDefinition.auths);
+    const expectedHeaderName = getAuthHeaderName(authScheme);
+    const needsCurlRegeneration = shouldRegenerateCurlSnippet(existingSnippets.curl, expectedHeaderName, authScheme, endpoint);
+    if (needsCurlRegeneration && shouldIncludeLanguage("curl")) {
+        snippets.push(generateCurlSnippet(apiDefinition, endpoint, example));
+    }
+    // Generate HTTP snippets for other languages
+    if (isHttpSnippetsEnabled) {
+        const harRequest = getHarRequest(endpoint, example, apiDefinition.auths, example.requestBody ?? undefined);
+        const basicAuth = getHarRequestBasicAuth(endpoint, apiDefinition.auths);
+        const converter = new HttpSnippetConverter(harRequest, basicAuth);
+        for (const { clientId, targetId } of HTTP_SNIPPET_CLIENTS) {
+            // Skip if snippet already exists and is user-provided; always regenerate auto-generated snippets
+            if (existingSnippets[targetId]?.length && !shouldRegenerateHttpSnippet(existingSnippets[targetId])) {
+                continue;
+            }
+            // Skip if dynamic SDK snippets are available for this language
+            if (dynamicGenerators[targetId === "javascript" ? "typescript" : targetId]) {
+                continue;
+            }
+            // Skip JavaScript if TypeScript snippets exist and alwaysEnableJavaScriptFetch is disabled
+            if (targetId === "javascript" &&
+                existingSnippets.typescript?.length &&
+                !flags.alwaysEnableJavaScriptFetch) {
+                continue;
+            }
+            // Check if this language should be included
+            if (!shouldIncludeLanguage(targetId)) {
+                continue;
+            }
+            const code = await converter.convert(targetId, clientId);
+            if (code != null) {
+                snippets.push({
+                    name: undefined,
+                    language: targetId,
+                    install: undefined,
+                    code,
+                    generated: true,
+                    description: undefined
+                });
+            }
+        }
+    }
+    return snippets;
+}
+/**
+ * Check if a language should be included for HTTP snippet generation based on flags
+ */
+export function shouldIncludeHttpSnippetLanguage(language, flags) {
+    const isHttpSnippetsEnabled = flags.httpSnippets !== false;
+    const httpSnippetLanguages = Array.isArray(flags.httpSnippets) ? flags.httpSnippets : null;
+    if (!isHttpSnippetsEnabled) {
+        return language === "curl";
+    }
+    return httpSnippetLanguages == null || httpSnippetLanguages.includes(language);
+}
+//# sourceMappingURL=http-snippets.js.map

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

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

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

@@ -0,0 +1,13 @@
+export * from "./backfill";
+export * from "./constants";
+export { convertToCurl } from "./curl";
+export * from "./generators";
+export { getHarRequest } from "./get-har-request";
+export * from "./graphql-snippets";
+export { HttpSnippetConverter } from "./HttpSnippetConverter";
+export * from "./http-snippets";
+export type { SnippetHttpRequest, SnippetHttpRequestBody, SnippetHttpRequestBodyForm, SnippetHttpRequestBodyFormValue, SnippetHttpRequestBodyFormValueFilename, SnippetHttpRequestBodyFormValueFilenames } from "./SnippetHttpRequest";
+export { toSnippetHttpRequest } from "./SnippetHttpRequest";
+export * from "./sdk-snippets";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAChC,YAAY,EACR,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,uCAAuC,EACvC,wCAAwC,EAC3C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,12 @@
+export * from "./backfill";
+export * from "./constants";
+export { convertToCurl } from "./curl";
+export * from "./generators";
+export { getHarRequest } from "./get-har-request";
+export * from "./graphql-snippets";
+export { HttpSnippetConverter } from "./HttpSnippetConverter";
+export * from "./http-snippets";
+export { toSnippetHttpRequest } from "./SnippetHttpRequest";
+export * from "./sdk-snippets";
+export * from "./types";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,cAAc,iBAAiB,CAAC;AAShC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ApiDefinition, CodeSnippet, EndpointDefinition, ExampleEndpointCall } from "../latest";
+import type { SnippetGenerators } from "./types";
+/**
+ * Build the SDK snippet request from an endpoint example.
+ * Returns a request object compatible with @fern-api/snippets generators.
+ */
+export declare function buildSdkSnippetRequest(apiDefinition: ApiDefinition, endpoint: EndpointDefinition, example: ExampleEndpointCall): any;
+/**
+ * Generate SDK snippets for an endpoint example using the provided generators
+ */
+export declare function generateSdkSnippets(apiDefinition: ApiDefinition, endpoint: EndpointDefinition, example: ExampleEndpointCall, generators: SnippetGenerators): CodeSnippet[];
+/**
+ * Generate a single SDK snippet for a specific language
+ */
+export declare function generateSdkSnippetForLanguage(apiDefinition: ApiDefinition, endpoint: EndpointDefinition, example: ExampleEndpointCall, generators: SnippetGenerators, language: string): CodeSnippet | undefined;
+//# sourceMappingURL=sdk-snippets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-snippets.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/sdk-snippets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,WAAW,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEjH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA0CjD;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB,GAC7B,GAAG,CAmCL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,iBAAiB,GAC9B,WAAW,EAAE,CAgCf;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CACzC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,MAAM,GACjB,WAAW,GAAG,SAAS,CA8BzB"}

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

@@ -0,0 +1,139 @@
+import { getFirstAuthScheme } from "./auth-scheme";
+/**
+ * Build the auth object for SDK snippet generators based on the auth scheme.
+ * Returns a properly formatted auth object compatible with @fern-api/snippets generators.
+ */
+function buildSnippetAuth(authScheme) {
+    if (!authScheme) {
+        return undefined;
+    }
+    switch (authScheme.type) {
+        case "bearerAuth":
+            return {
+                type: "bearer",
+                token: "YOUR_TOKEN_HERE"
+            };
+        case "basicAuth": {
+            const userLabel = (authScheme.usernameName ?? "username").toUpperCase().replace(/\s+/g, "_");
+            const passLabel = (authScheme.passwordName ?? "password").toUpperCase().replace(/\s+/g, "_");
+            return {
+                type: "basic",
+                username: `YOUR_${userLabel}_HERE`,
+                ...(authScheme.passwordAlwaysEmpty ? {} : { password: `YOUR_${passLabel}_HERE` })
+            };
+        }
+        case "header":
+            return {
+                type: "header",
+                value: "YOUR_API_KEY_HERE"
+            };
+        case "oAuth":
+            // OAuth uses bearer token format for SDK snippets
+            return {
+                type: "bearer",
+                token: "YOUR_TOKEN_HERE"
+            };
+        default:
+            return undefined;
+    }
+}
+/**
+ * Build the SDK snippet request from an endpoint example.
+ * Returns a request object compatible with @fern-api/snippets generators.
+ */
+export function buildSdkSnippetRequest(apiDefinition, endpoint, example) {
+    // Build auth configuration using multiAuth-aware selection
+    const authDefinition = getFirstAuthScheme(endpoint, apiDefinition.auths);
+    const auth = buildSnippetAuth(authDefinition);
+    // Process request body (filter out empty objects)
+    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;
+        }
+    }
+    return {
+        baseURL: undefined,
+        environment: undefined,
+        auth,
+        pathParameters: example.pathParameters,
+        queryParameters: example.queryParameters,
+        headers: example.headers,
+        requestBody: bodyValue,
+        method: endpoint.method
+    };
+}
+/**
+ * Generate SDK snippets for an endpoint example using the provided generators
+ */
+export function generateSdkSnippets(apiDefinition, endpoint, example, generators) {
+    if (endpoint.method === "HEAD") {
+        return [];
+    }
+    const snippets = [];
+    const request = buildSdkSnippetRequest(apiDefinition, endpoint, example);
+    for (const [language, generator] of Object.entries(generators)) {
+        if (!generator) {
+            continue;
+        }
+        try {
+            const result = generator.generateSync(request);
+            if (result?.snippet) {
+                snippets.push({
+                    name: undefined,
+                    language,
+                    install: undefined,
+                    code: result.snippet,
+                    generated: true,
+                    description: undefined
+                });
+            }
+        }
+        catch (error) {
+            console.error(`Error generating ${language} snippet:`, error);
+        }
+    }
+    return snippets;
+}
+/**
+ * Generate a single SDK snippet for a specific language
+ */
+export function generateSdkSnippetForLanguage(apiDefinition, endpoint, example, generators, language) {
+    if (endpoint.method === "HEAD") {
+        return undefined;
+    }
+    const generator = generators[language];
+    if (!generator) {
+        return undefined;
+    }
+    const request = buildSdkSnippetRequest(apiDefinition, endpoint, example);
+    try {
+        const result = generator.generateSync(request);
+        if (result?.snippet) {
+            return {
+                name: undefined,
+                language,
+                install: undefined,
+                code: result.snippet,
+                generated: true,
+                description: undefined
+            };
+        }
+    }
+    catch (error) {
+        console.error(`Error generating ${language} snippet:`, error);
+    }
+    return undefined;
+}
+//# sourceMappingURL=sdk-snippets.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,132 @@
+import { describe, expect, it } from "vitest";
+import { AuthSchemeId, EndpointId } from "../latest";
+import { buildSdkSnippetRequest } from "./sdk-snippets";
+function makeEndpoint(authSchemeId) {
+    return {
+        id: EndpointId("test-endpoint"),
+        displayName: "Test Endpoint",
+        operationId: undefined,
+        description: undefined,
+        availability: undefined,
+        method: "GET",
+        path: [{ type: "literal", value: "/test" }],
+        defaultEnvironment: undefined,
+        environments: undefined,
+        pathParameters: undefined,
+        queryParameters: undefined,
+        requestHeaders: undefined,
+        responseHeaders: undefined,
+        requests: undefined,
+        responses: undefined,
+        errors: undefined,
+        auth: [AuthSchemeId(authSchemeId)],
+        multiAuth: undefined,
+        examples: undefined,
+        snippetTemplates: undefined,
+        protocol: undefined,
+        namespace: undefined,
+        includeInApiExplorer: undefined
+    };
+}
+function makeExample() {
+    return {
+        name: undefined,
+        description: "",
+        path: "/test",
+        pathParameters: undefined,
+        queryParameters: undefined,
+        headers: undefined,
+        requestBody: undefined,
+        responseStatusCode: 200,
+        responseBody: undefined,
+        snippets: undefined
+    };
+}
+function makeApiDefinition(authSchemeId, authScheme) {
+    return {
+        id: "test-api",
+        endpoints: {
+            [EndpointId("test-endpoint")]: makeEndpoint(authSchemeId)
+        },
+        websockets: {},
+        webhooks: {},
+        graphqlOperations: {},
+        types: {},
+        subpackages: {},
+        auths: {
+            [AuthSchemeId(authSchemeId)]: authScheme
+        },
+        globalHeaders: undefined,
+        snippetsConfiguration: undefined
+    };
+}
+describe("buildSdkSnippetRequest", () => {
+    it("omits password from basic auth when passwordAlwaysEmpty is true", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: true
+        };
+        const apiDef = makeApiDefinition("ApiKeyAuth", authScheme);
+        const endpoint = makeEndpoint("ApiKeyAuth");
+        const example = makeExample();
+        const request = buildSdkSnippetRequest(apiDef, endpoint, example);
+        expect(request.auth).toEqual({
+            type: "basic",
+            username: "YOUR_CLOSE_API_KEY_HERE"
+        });
+        expect(request.auth).not.toHaveProperty("password");
+    });
+    it("includes password in basic auth when passwordAlwaysEmpty is false", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "CLOSE_API_KEY",
+            passwordName: "password",
+            passwordAlwaysEmpty: false
+        };
+        const apiDef = makeApiDefinition("ApiKeyAuth", authScheme);
+        const endpoint = makeEndpoint("ApiKeyAuth");
+        const example = makeExample();
+        const request = buildSdkSnippetRequest(apiDef, endpoint, example);
+        expect(request.auth).toEqual({
+            type: "basic",
+            username: "YOUR_CLOSE_API_KEY_HERE",
+            password: "YOUR_PASSWORD_HERE"
+        });
+    });
+    it("includes password in basic auth when passwordAlwaysEmpty is undefined", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "username",
+            passwordName: "password"
+        };
+        const apiDef = makeApiDefinition("BasicAuth", authScheme);
+        const endpoint = makeEndpoint("BasicAuth");
+        const example = makeExample();
+        const request = buildSdkSnippetRequest(apiDef, endpoint, example);
+        expect(request.auth).toEqual({
+            type: "basic",
+            username: "YOUR_USERNAME_HERE",
+            password: "YOUR_PASSWORD_HERE"
+        });
+    });
+    it("uses custom username/password labels in basic auth", () => {
+        const authScheme = {
+            type: "basicAuth",
+            usernameName: "API Key",
+            passwordName: "Secret Key",
+            passwordAlwaysEmpty: false
+        };
+        const apiDef = makeApiDefinition("CustomAuth", authScheme);
+        const endpoint = makeEndpoint("CustomAuth");
+        const example = makeExample();
+        const request = buildSdkSnippetRequest(apiDef, endpoint, example);
+        expect(request.auth).toEqual({
+            type: "basic",
+            username: "YOUR_API_KEY_HERE",
+            password: "YOUR_SECRET_KEY_HERE"
+        });
+    });
+});
+//# sourceMappingURL=sdk-snippets.test.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { TargetId } from "httpsnippet-lite";
+import type { DynamicIr } from "../../client/APIV1Write";
+import type { HttpSnippetLanguage } from "../../orpc-client/shared.js";
+/**
+ * Map of language identifiers to their dynamic IR data
+ */
+export type DynamicIRsByLanguage = Record<string, DynamicIr>;
+/**
+ * Configuration for an HTTP snippet client
+ */
+export interface HTTPSnippetClient {
+    targetId: TargetId;
+    clientId: string;
+}
+/**
+ * Flags controlling snippet generation behavior
+ */
+export interface SnippetGenerationFlags {
+    /**
+     * Controls HTTP snippet generation.
+     * - `false`: Only generate curl snippets
+     * - `true`: Generate HTTP snippets for all supported languages
+     * - `HttpSnippetLanguage[]`: Generate HTTP snippets only for specified languages
+     */
+    httpSnippets: boolean | HttpSnippetLanguage[];
+    /**
+     * When true, always generate JavaScript fetch snippets even if TypeScript snippets exist
+     */
+    alwaysEnableJavaScriptFetch: boolean;
+}
+/**
+ * Supported languages for SDK snippet generation
+ */
+export type SdkSnippetLanguage = "typescript" | "python" | "java" | "ruby" | "swift" | "csharp" | "go" | "php";
+export declare const SDK_SNIPPET_LANGUAGES: SdkSnippetLanguage[];
+/**
+ * Map of language identifiers to their snippet generators.
+ * Uses `any` type because the actual generator type from @fern-api/snippets
+ * has complex type requirements that we don't need to enforce here.
+ */
+export type SnippetGenerators = Record<string, any>;
+export type { HttpSnippetLanguage };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api-definition/snippets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,YAAY,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAE9C;;OAEG;IACH,2BAA2B,EAAE,OAAO,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC;AAE/G,eAAO,MAAM,qBAAqB,EAAE,kBAAkB,EASrD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEpD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,11 @@
+export const SDK_SNIPPET_LANGUAGES = [
+    "typescript",
+    "python",
+    "java",
+    "ruby",
+    "swift",
+    "csharp",
+    "go",
+    "php"
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api-definition/snippets/types.ts"],"names":[],"mappings":"AAwCA,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACvD,YAAY;IACZ,QAAQ;IACR,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,IAAI;IACJ,KAAK;CACR,CAAC"}

package/dist/api-definition/sort-keys.d.ts

@@ -0,0 +1,5 @@
+import type * as Latest from "./latest";
+import type { TypeShapeOrReference } from "./types";
+export declare function sortKeysByShape(obj: unknown, shape: TypeShapeOrReference | Latest.HttpRequestBodyShape | Latest.HttpResponseBodyShape | null | undefined, types: Record<string, Latest.TypeDefinition>): unknown;
+export declare function safeSortKeysByShape(value: unknown, shape: TypeShapeOrReference | Latest.HttpRequestBodyShape | Latest.HttpResponseBodyShape | null | undefined, types: Record<string, Latest.TypeDefinition>): unknown;
+//# sourceMappingURL=sort-keys.d.ts.map

package/dist/api-definition/sort-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-keys.d.ts","sourceRoot":"","sources":["../../src/api-definition/sort-keys.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAWpD,wBAAgB,eAAe,CAC3B,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,GAAG,MAAM,CAAC,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAC3G,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,GAC7C,OAAO,CA6FT;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,GAAG,MAAM,CAAC,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAC3G,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,GAC7C,OAAO,CAWT"}

package/dist/api-definition/sort-keys.js

@@ -0,0 +1,103 @@
+import isPlainObject from "@fern-api/ui-core-utils/isPlainObject";
+import visitDiscriminatedUnion from "@fern-api/ui-core-utils/visitDiscriminatedUnion";
+import { difference, keyBy } from "es-toolkit/array";
+import { mapValues } from "es-toolkit/object";
+import { unwrapDiscriminatedUnionVariant, unwrapObjectType } from "./unwrap";
+function sortKeysBy(obj, order) {
+    return mapValues(
+    // difference() is used to ensure that all keys are included in the result
+    keyBy([...order, ...difference(Object.keys(obj), order)], (key) => key), (key) => obj[key]);
+}
+export function sortKeysByShape(obj, shape, types) {
+    if ((!isPlainObject(obj) && !Array.isArray(obj)) || shape == null) {
+        return obj;
+    }
+    return visitDiscriminatedUnion(shape, "type")._visit({
+        id: ({ id }) => sortKeysByShape(obj, types[id]?.shape, types),
+        primitive: () => obj,
+        literal: () => obj,
+        optional: ({ shape }) => sortKeysByShape(obj, shape, types),
+        nullable: ({ shape }) => sortKeysByShape(obj, shape, types),
+        list: ({ itemShape }) => (Array.isArray(obj) ? obj.map((o) => sortKeysByShape(o, itemShape, types)) : obj),
+        set: ({ itemShape }) => (Array.isArray(obj) ? obj.map((o) => sortKeysByShape(o, itemShape, types)) : obj),
+        map: ({ valueShape }) => isPlainObject(obj) ? mapValues(obj, (value) => sortKeysByShape(value, valueShape, types)) : obj,
+        unknown: () => obj,
+        object: (object) => {
+            const objectProperties = unwrapObjectType(object, types).properties;
+            return isPlainObject(obj)
+                ? mapValues(sortKeysBy(obj, objectProperties.map((p) => p.key)), (value, key) => {
+                    const property = objectProperties.find((p) => p.key === key);
+                    if (property == null) {
+                        return value;
+                    }
+                    return sortKeysByShape(value, property?.valueShape, types);
+                })
+                : obj;
+        },
+        undiscriminatedUnion: () => obj, // TODO: match variant and sort nested objects
+        discriminatedUnion: (union) => {
+            const { discriminant, variants } = union;
+            if (!isPlainObject(obj)) {
+                return obj;
+            }
+            const variant = obj[discriminant];
+            if (variant == null) {
+                return obj;
+            }
+            const variantShape = variants.find((v) => v.discriminantValue === variant);
+            if (variantShape == null) {
+                return obj;
+            }
+            const variantProperties = unwrapDiscriminatedUnionVariant(union, variantShape, types).properties;
+            return mapValues(sortKeysBy(obj, [discriminant, ...variantProperties.map((p) => p.key)]), (value, key) => {
+                if (key === discriminant) {
+                    return value;
+                }
+                const property = variantProperties.find((p) => p.key === key);
+                if (property == null) {
+                    return value;
+                }
+                return sortKeysByShape(value, property.valueShape, types);
+            });
+        },
+        enum: () => obj,
+        alias: ({ value: typeRef }) => sortKeysByShape(obj, typeRef, types),
+        formData: ({ fields }) => {
+            if (!isPlainObject(obj)) {
+                return obj;
+            }
+            return mapValues(sortKeysBy(obj, fields.map((p) => p.key)), (v, key) => {
+                const property = fields.find((p) => p.key === key);
+                if (property == null) {
+                    return v;
+                }
+                if (property.type === "property") {
+                    return sortKeysByShape(v, property.valueShape, types);
+                }
+                return undefined;
+            });
+        },
+        bytes: () => obj,
+        fileDownload: () => obj,
+        streamingText: () => obj,
+        stream: () => obj,
+        empty: () => obj,
+        _other: () => obj
+    });
+}
+export function safeSortKeysByShape(value, shape, types) {
+    if (value == null) {
+        return value;
+    }
+    try {
+        return stripUndefines(sortKeysByShape(value, shape, types));
+    }
+    catch (e) {
+        console.error("Failed to sort JSON keys by type shape", e);
+        return value;
+    }
+}
+function stripUndefines(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+//# sourceMappingURL=sort-keys.js.map