feat: add additional movie metadata fields and upgrade generator

.fern/metadata.json

@@ -1,5 +1,5 @@
 {
     "cliVersion": "0.113.1",
     "generatorName": "fernapi/fern-typescript-sdk",
-    "generatorVersion": "3.28.6"
+    "generatorVersion": "3.28.11"
 }

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
 });
 ```
 

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
+

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",

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
 });
 
 ```

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,
                 },

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(

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;
 }

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;
 }

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);
             }

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,

src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.0";
+export const SDK_VERSION = "2.1.0";

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,
+            };
+        }
+    },
+});

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);

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,

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();