feat: add additional movie metadata fields and upgrade generator

fern-api[bot] · web-flow · commit 9e0a140c3765 · 2025-11-25T19:24:08.000Z
The TypeScript SDK has been enhanced with new movie metadata fields and upgraded to the latest generator version for improved functionality.

Key changes:
- Add metadata, more_metadata, and rank fields to movie creation and responses
- Remove deprecated User-Agent header and description field from Movie type
- Upgrade Fern TypeScript generator from 3.28.6 to 3.28.11
- Implement Headers class for improved HTTP header management
- Add comprehensive test utilities with custom header matching matchers
- Update all code examples and documentation to reflect new API structure

🌿 Generated with Fern
diff --git a/.fern/metadata.json b/.fern/metadata.json
@@ -1,5 +1,5 @@
 {
     "cliVersion": "0.113.1",
     "generatorName": "fernapi/fern-typescript-sdk",
-    "generatorVersion": "3.28.6"
+    "generatorVersion": "3.28.11"
 }
diff --git a/README.md b/README.md
@@ -25,7 +25,10 @@ import { FernAutopilotTestApiClient } from "";
 const client = new FernAutopilotTestApiClient({ environment: "YOUR_BASE_URL" });
 await client.imdb.createMovie({
     title: "title",
-    rating: 1.1
+    rating: 1.1,
+    metadata: "metadata",
+    more_metadata: "more_metadata",
+    rank: 1
 });
 ```
 
diff --git a/changelog.md b/changelog.md
@@ -0,0 +1,12 @@
+## 2.1.0 - 2025-11-25
+* feat: add additional movie metadata fields and upgrade generator
+* The TypeScript SDK has been enhanced with new movie metadata fields and upgraded to the latest generator version for improved functionality.
+* Key changes:
+* Add metadata, more_metadata, and rank fields to movie creation and responses
+* Remove deprecated User-Agent header and description field from Movie type
+* Upgrade Fern TypeScript generator from 3.28.6 to 3.28.11
+* Implement Headers class for improved HTTP header management
+* Add comprehensive test utilities with custom header matching matchers
+* Update all code examples and documentation to reflect new API structure
+* 🌿 Generated with Fern
+
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "",
-    "version": "2.0.0",
+    "version": "2.1.0",
     "private": false,
     "repository": "github:fern-demo/autopilot-typescript-sdk",
     "type": "commonjs",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/reference.md b/reference.md
@@ -29,7 +29,10 @@ Add a movie to the database
 ```typescript
 await client.imdb.createMovie({
     title: "title",
-    rating: 1.1
+    rating: 1.1,
+    metadata: "metadata",
+    more_metadata: "more_metadata",
+    rank: 1
 });
 
 ```
diff --git a/src/Client.ts b/src/Client.ts
@@ -23,8 +23,8 @@ export class FernAutopilotTestApiClient {
                 {
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "",
-                    "X-Fern-SDK-Version": "2.0.0",
-                    "User-Agent": "/2.0.0",
+                    "X-Fern-SDK-Version": "2.1.0",
+                    "User-Agent": "/2.1.0",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },
diff --git a/src/api/resources/imdb/client/Client.ts b/src/api/resources/imdb/client/Client.ts
@@ -28,7 +28,10 @@ export class Imdb {
      * @example
      *     await client.imdb.createMovie({
      *         title: "title",
-     *         rating: 1.1
+     *         rating: 1.1,
+     *         metadata: "metadata",
+     *         more_metadata: "more_metadata",
+     *         rank: 1
      *     })
      */
     public createMovie(
diff --git a/src/api/resources/imdb/types/CreateMovieRequest.ts b/src/api/resources/imdb/types/CreateMovieRequest.ts
@@ -3,4 +3,7 @@
 export interface CreateMovieRequest {
     title: string;
     rating: number;
+    metadata: string;
+    more_metadata: string;
+    rank: number;
 }
diff --git a/src/api/resources/imdb/types/Movie.ts b/src/api/resources/imdb/types/Movie.ts
@@ -7,6 +7,6 @@ export interface Movie {
     title: string;
     /** The rating scale out of ten stars */
     rating: number;
-    description: string;
     metadata: string;
+    rank: number;
 }
diff --git a/src/core/fetcher/Fetcher.ts b/src/core/fetcher/Fetcher.ts
@@ -8,6 +8,7 @@ import { getErrorResponseBody } from "./getErrorResponseBody.js";
 import { getFetchFn } from "./getFetchFn.js";
 import { getRequestBody } from "./getRequestBody.js";
 import { getResponseBody } from "./getResponseBody.js";
+import { Headers } from "./Headers.js";
 import { makeRequest } from "./makeRequest.js";
 import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.js";
 import { requestWithRetries } from "./requestWithRetries.js";
@@ -77,9 +78,9 @@ const SENSITIVE_HEADERS = new Set([
     "x-access-token",
 ]);
 
-function redactHeaders(headers: Record<string, string>): Record<string, string> {
+function redactHeaders(headers: Headers | Record<string, string>): Record<string, string> {
     const filtered: Record<string, string> = {};
-    for (const [key, value] of Object.entries(headers)) {
+    for (const [key, value] of headers instanceof Headers ? headers.entries() : Object.entries(headers)) {
         if (SENSITIVE_HEADERS.has(key.toLowerCase())) {
             filtered[key] = "[REDACTED]";
         } else {
@@ -207,10 +208,15 @@ function redactUrl(url: string): string {
     return url.slice(0, queryStart + 1) + redactedParams.join("&") + url.slice(queryEnd);
 }
 
-async function getHeaders(args: Fetcher.Args): Promise<Record<string, string>> {
-    const newHeaders: Record<string, string> = {};
+async function getHeaders(args: Fetcher.Args): Promise<Headers> {
+    const newHeaders: Headers = new Headers();
+
+    newHeaders.set(
+        "Accept",
+        args.responseType === "json" ? "application/json" : args.responseType === "text" ? "text/plain" : "*/*",
+    );
     if (args.body !== undefined && args.contentType != null) {
-        newHeaders["Content-Type"] = args.contentType;
+        newHeaders.set("Content-Type", args.contentType);
     }
 
     if (args.headers == null) {
@@ -220,13 +226,13 @@ async function getHeaders(args: Fetcher.Args): Promise<Record<string, string>> {
     for (const [key, value] of Object.entries(args.headers)) {
         const result = await EndpointSupplier.get(value, { endpointMetadata: args.endpointMetadata ?? {} });
         if (typeof result === "string") {
-            newHeaders[key] = result;
+            newHeaders.set(key, result);
             continue;
         }
         if (result == null) {
             continue;
         }
-        newHeaders[key] = `${result}`;
+        newHeaders.set(key, `${result}`);
     }
     return newHeaders;
 }
@@ -275,7 +281,7 @@ export async function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIR
                     method: args.method,
                     url: redactUrl(url),
                     statusCode: response.status,
-                    responseHeaders: redactHeaders(Object.fromEntries(response.headers.entries())),
+                    responseHeaders: redactHeaders(response.headers),
                 };
                 logger.debug("HTTP request succeeded", metadata);
             }
diff --git a/src/core/fetcher/makeRequest.ts b/src/core/fetcher/makeRequest.ts
@@ -4,7 +4,7 @@ export const makeRequest = async (
     fetchFn: (url: string, init: RequestInit) => Promise<Response>,
     url: string,
     method: string,
-    headers: Record<string, string>,
+    headers: Headers | Record<string, string>,
     requestBody: BodyInit | undefined,
     timeoutMs?: number,
     abortSignal?: AbortSignal,
diff --git a/src/version.ts b/src/version.ts
@@ -1 +1 @@
-export const SDK_VERSION = "2.0.0";
+export const SDK_VERSION = "2.1.0";
diff --git a/tests/setup.ts b/tests/setup.ts
@@ -0,0 +1,80 @@
+import { expect } from "vitest";
+
+interface CustomMatchers<R = unknown> {
+    toContainHeaders(expectedHeaders: Record<string, string>): R;
+}
+
+declare module "vitest" {
+    interface Assertion<T = any> extends CustomMatchers<T> {}
+    interface AsymmetricMatchersContaining extends CustomMatchers {}
+}
+
+expect.extend({
+    toContainHeaders(actual: unknown, expectedHeaders: Record<string, string>) {
+        const isHeaders = actual instanceof Headers;
+        const isPlainObject = typeof actual === "object" && actual !== null && !Array.isArray(actual);
+
+        if (!isHeaders && !isPlainObject) {
+            throw new TypeError("Received value must be an instance of Headers or a plain object!");
+        }
+
+        if (typeof expectedHeaders !== "object" || expectedHeaders === null || Array.isArray(expectedHeaders)) {
+            throw new TypeError("Expected headers must be a plain object!");
+        }
+
+        const missingHeaders: string[] = [];
+        const mismatchedHeaders: Array<{ key: string; expected: string; actual: string | null }> = [];
+
+        for (const [key, value] of Object.entries(expectedHeaders)) {
+            let actualValue: string | null = null;
+
+            if (isHeaders) {
+                // Headers.get() is already case-insensitive
+                actualValue = (actual as Headers).get(key);
+            } else {
+                // For plain objects, do case-insensitive lookup
+                const actualObj = actual as Record<string, string>;
+                const lowerKey = key.toLowerCase();
+                const foundKey = Object.keys(actualObj).find((k) => k.toLowerCase() === lowerKey);
+                actualValue = foundKey ? actualObj[foundKey] : null;
+            }
+
+            if (actualValue === null || actualValue === undefined) {
+                missingHeaders.push(key);
+            } else if (actualValue !== value) {
+                mismatchedHeaders.push({ key, expected: value, actual: actualValue });
+            }
+        }
+
+        const pass = missingHeaders.length === 0 && mismatchedHeaders.length === 0;
+
+        const actualType = isHeaders ? "Headers" : "object";
+
+        if (pass) {
+            return {
+                message: () => `expected ${actualType} not to contain ${this.utils.printExpected(expectedHeaders)}`,
+                pass: true,
+            };
+        } else {
+            const messages: string[] = [];
+
+            if (missingHeaders.length > 0) {
+                messages.push(`Missing headers: ${this.utils.printExpected(missingHeaders.join(", "))}`);
+            }
+
+            if (mismatchedHeaders.length > 0) {
+                const mismatches = mismatchedHeaders.map(
+                    ({ key, expected, actual }) =>
+                        `${key}: expected ${this.utils.printExpected(expected)} but got ${this.utils.printReceived(actual)}`,
+                );
+                messages.push(mismatches.join("\n"));
+            }
+
+            return {
+                message: () =>
+                    `expected ${actualType} to contain ${this.utils.printExpected(expectedHeaders)}\n\n${messages.join("\n")}`,
+                pass: false,
+            };
+        }
+    },
+});
diff --git a/tests/unit/fetcher/Fetcher.test.ts b/tests/unit/fetcher/Fetcher.test.ts
@@ -34,7 +34,7 @@ describe("Test fetcherImpl", () => {
             "https://httpbin.org/post",
             expect.objectContaining({
                 method: "POST",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
                 body: JSON.stringify({ data: "test" }),
             }),
         );
@@ -66,7 +66,7 @@ describe("Test fetcherImpl", () => {
             url,
             expect.objectContaining({
                 method: "POST",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
                 body: expect.any(fs.ReadStream),
             }),
         );
@@ -102,7 +102,7 @@ describe("Test fetcherImpl", () => {
             url,
             expect.objectContaining({
                 method: "GET",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
             }),
         );
         expect(result.ok).toBe(true);
@@ -148,7 +148,7 @@ describe("Test fetcherImpl", () => {
             url,
             expect.objectContaining({
                 method: "GET",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
             }),
         );
         expect(result.ok).toBe(true);
@@ -194,7 +194,7 @@ describe("Test fetcherImpl", () => {
             url,
             expect.objectContaining({
                 method: "GET",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
             }),
         );
         expect(result.ok).toBe(true);
@@ -238,7 +238,7 @@ describe("Test fetcherImpl", () => {
             url,
             expect.objectContaining({
                 method: "GET",
-                headers: expect.objectContaining({ "X-Test": "x-test-header" }),
+                headers: expect.toContainHeaders({ "X-Test": "x-test-header" }),
             }),
         );
         expect(result.ok).toBe(true);
diff --git a/tests/unit/fetcher/logging.test.ts b/tests/unit/fetcher/logging.test.ts
@@ -54,7 +54,7 @@ describe("Fetcher Logging Integration", () => {
                 expect.objectContaining({
                     method: "POST",
                     url: "https://example.com/api",
-                    headers: expect.objectContaining({
+                    headers: expect.toContainHeaders({
                         "Content-Type": "application/json",
                     }),
                     hasBody: true,
diff --git a/tests/unit/fetcher/makeRequest.test.ts b/tests/unit/fetcher/makeRequest.test.ts
@@ -1,3 +1,4 @@
+import type { Mock } from "vitest";
 import { makeRequest } from "../../../src/core/fetcher/makeRequest";
 
 describe("Test makeRequest", () => {
@@ -6,7 +7,7 @@ describe("Test makeRequest", () => {
     const mockHeaders = { "Content-Type": "application/json" };
     const mockBody = JSON.stringify({ key: "value" });
 
-    let mockFetch: import("vitest").Mock;
+    let mockFetch: Mock;
 
     beforeEach(() => {
         mockFetch = vi.fn();
diff --git a/tests/unit/fetcher/redacting.test.ts b/tests/unit/fetcher/redacting.test.ts
diff --git a/tests/unit/fetcher/requestWithRetries.test.ts b/tests/unit/fetcher/requestWithRetries.test.ts
diff --git a/tests/wire/imdb.test.ts b/tests/wire/imdb.test.ts
diff --git a/vitest.config.mts b/vitest.config.mts

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`	`2`	`"cliVersion": "0.113.1",`
`3`	`3`	`"generatorName": "fernapi/fern-typescript-sdk",`
`4`		`- "generatorVersion": "3.28.6"`
	`4`	`+ "generatorVersion": "3.28.11"`
`5`	`5`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "",`
`3`		`- "version": "2.0.0",`
	`3`	`+ "version": "2.1.0",`
`4`	`4`	`"private": false,`
`5`	`5`	`"repository": "github:fern-demo/autopilot-typescript-sdk",`
`6`	`6`	`"type": "commonjs",`
Original file line number	Diff line number	Diff line change
`@@ -3,4 +3,7 @@`
`3`	`3`	`export interface CreateMovieRequest {`
`4`	`4`	`title: string;`
`5`	`5`	`rating: number;`
	`6`	`+ metadata: string;`
	`7`	`+ more_metadata: string;`
	`8`	`+ rank: number;`
`6`	`9`	`}`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,6 @@ export interface Movie {`
`7`	`7`	`title: string;`
`8`	`8`	`/** The rating scale out of ten stars */`
`9`	`9`	`rating: number;`
`10`		`- description: string;`
`11`	`10`	`metadata: string;`
	`11`	`+ rank: number;`
`12`	`12`	`}`