@fern-api/fdr-sdk 1.0.4-92b8658c63 → 1.0.4-cab13ddd2d

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

@@ -0,0 +1,95 @@
+import { getAuthHeaderName, getFirstAuthScheme, shouldRegenerateCurlSnippet } from "./auth-scheme";
+import { HTTP_SNIPPET_CLIENTS } from "./constants";
+import { convertToCurl } from "./curl";
+import { getHarRequest } 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);
+    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 converter = new HttpSnippetConverter(harRequest);
+        for (const { clientId, targetId } of HTTP_SNIPPET_CLIENTS) {
+            // Skip if snippet already exists
+            if (existingSnippets[targetId]?.length) {
+                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`,
+                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/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

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

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

package/dist/api-definition/status-message.d.ts

@@ -0,0 +1,9 @@
+import type { HttpMethod } from "./latest";
+type StatusCodeMessagesByMethod = Partial<Record<HttpMethod, string>>;
+type StatusCodeMessages = Record<number, StatusCodeMessagesByMethod>;
+type DefaultStatusCodeMessages = Record<number, string>;
+export declare const STATUS_CODE_MESSAGES: DefaultStatusCodeMessages;
+export declare const STATUS_CODE_MESSAGES_METHOD_OVERRIDES: StatusCodeMessages;
+export declare function getMessageForStatus(statusCode: number, method?: HttpMethod): string;
+export {};
+//# sourceMappingURL=status-message.d.ts.map

package/dist/api-definition/status-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-message.d.ts","sourceRoot":"","sources":["../../src/api-definition/status-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,KAAK,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;AAErE,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,oBAAoB,EAAE,yBAgElC,CAAC;AAEF,eAAO,MAAM,qCAAqC,EAAE,kBAQnD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAgCnF"}

package/dist/api-definition/status-message.js

@@ -0,0 +1,111 @@
+export const STATUS_CODE_MESSAGES = {
+    100: "Continue",
+    101: "Switching Protocols",
+    102: "Processing",
+    103: "Early Hints",
+    200: "OK",
+    201: "Created",
+    202: "Accepted",
+    203: "Non-Authoritative Information",
+    204: "No Content",
+    205: "Reset Content",
+    206: "Partial Content",
+    207: "Multi-Status",
+    208: "Already Reported",
+    226: "IM Used",
+    300: "Multiple Choices",
+    301: "Moved Permanently",
+    302: "Found",
+    303: "See Other",
+    304: "Not Modified",
+    305: "Use Proxy",
+    306: "Switch Proxy",
+    307: "Temporary Redirect",
+    308: "Permanent Redirect",
+    400: "Bad Request",
+    401: "Unauthorized",
+    402: "Payment Required",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
+    407: "Proxy Authentication Required",
+    408: "Request Timeout",
+    409: "Conflict",
+    410: "Gone",
+    411: "Length Required",
+    412: "Precondition Failed",
+    413: "Payload Too Large",
+    414: "URI Too Long",
+    415: "Unsupported Media Type",
+    416: "Range Not Satisfiable",
+    417: "Expectation Failed",
+    418: "I'm a teapot",
+    421: "Misdirected Request",
+    422: "Unprocessable Entity",
+    423: "Locked",
+    424: "Failed Dependency",
+    425: "Too Early",
+    426: "Upgrade Required",
+    428: "Precondition Required",
+    429: "Too Many Requests",
+    431: "Request Header Fields Too Large",
+    451: "Unavailable For Legal Reasons",
+    500: "Internal Server Error",
+    501: "Not Implemented",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout",
+    505: "HTTP Version Not Supported",
+    506: "Variant Also Negotiates",
+    507: "Insufficient Storage",
+    508: "Loop Detected",
+    510: "Not Extended",
+    511: "Network Authentication Required"
+};
+export const STATUS_CODE_MESSAGES_METHOD_OVERRIDES = {
+    200: {
+        GET: "Retrieved",
+        POST: "Successful", // more accurate than "Created" for POST
+        PUT: "Updated",
+        PATCH: "Updated",
+        DELETE: "Deleted"
+    }
+};
+export function getMessageForStatus(statusCode, method) {
+    // return the method-specific message if it exists
+    if (method != null) {
+        const methodOverrides = STATUS_CODE_MESSAGES_METHOD_OVERRIDES[statusCode];
+        if (methodOverrides != null) {
+            const message = methodOverrides[method];
+            if (message != null) {
+                return message;
+            }
+        }
+    }
+    // return the official status message if it exists
+    const message = STATUS_CODE_MESSAGES[statusCode];
+    if (message != null) {
+        return message;
+    }
+    // return the default message if it exists
+    if (statusCode >= 100 && statusCode < 200) {
+        return "Informational";
+    }
+    else if (statusCode >= 200 && statusCode < 300) {
+        return "Success";
+    }
+    else if (statusCode >= 300 && statusCode < 400) {
+        return "Redirection";
+    }
+    else if (statusCode >= 400 && statusCode < 500) {
+        return "Client Error";
+    }
+    else if (statusCode >= 500 && statusCode < 600) {
+        return "Server Error";
+    }
+    else {
+        return "Unknown Status";
+    }
+}
+//# sourceMappingURL=status-message.js.map

package/dist/api-definition/status-message.js.map

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