Merge pull request #53 from PhenoML/fern-bot/2026-02-03T21-42Z

refactor: simplify document API by removing fileType parameter

Author: kerbearasaurus

changelog.md

@@ -1,3 +1,16 @@
+## 4.0.0 - 2026-02-03
+* refactor: simplify document API by removing fileType parameter
+* The Lang2Fhir document endpoint now auto-detects file types from content magic bytes,
+* eliminating the need for manual MIME type specification. This change streamlines the
+* API interface while maintaining support for PDF, PNG, and JPEG file formats.
+* Key changes:
+* Remove fileType parameter from DocumentRequest interface
+* Update content parameter documentation to specify supported formats
+* Remove FileType enum and associated type definitions
+* Update all code examples and tests to use simplified API
+* Maintain backward compatibility for file type detection
+* 🌿 Generated with Fern
+
 ## 3.1.0 - 2026-01-29
 * feat: add citation support and rename text search method
 * Adds source text citation functionality to code extraction and renames the text search method for better clarity. Citations provide exact text spans with character offsets showing where each code was found in the source text, enabling precise traceability.

package.json

@@ -1,6 +1,6 @@
 {
     "name": "phenoml",
-    "version": "3.1.0",
+    "version": "4.0.0",
     "private": false,
     "repository": "github:PhenoML/phenoml-ts-sdk",
     "type": "commonjs",

reference.md

@@ -3096,8 +3096,7 @@ Extracts text from a document (PDF or image) and converts it into a structured F
 await client.lang2Fhir.document({
     version: "R4",
     resource: "questionnaire",
-    content: "content",
-    fileType: "application/pdf"
+    content: "content"
 });
 
 ```

src/Client.ts

@@ -40,8 +40,8 @@ export class phenomlClient {
                 {
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "phenoml",
-                    "X-Fern-SDK-Version": "3.1.0",
-                    "User-Agent": "phenoml/3.1.0",
+                    "X-Fern-SDK-Version": "4.0.0",
+                    "User-Agent": "phenoml/4.0.0",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },

src/api/resources/lang2Fhir/client/Client.ts

@@ -430,8 +430,7 @@ export class Lang2Fhir {
      *     await client.lang2Fhir.document({
      *         version: "R4",
      *         resource: "questionnaire",
-     *         content: "content",
-     *         fileType: "application/pdf"
+     *         content: "content"
      *     })
      */
     public document(

src/api/resources/lang2Fhir/client/requests/DocumentRequest.ts

@@ -5,19 +5,20 @@
  *     {
  *         version: "R4",
  *         resource: "questionnaire",
- *         content: "content",
- *         fileType: "application/pdf"
+ *         content: "content"
  *     }
  */
 export interface DocumentRequest {
     /** FHIR version to use */
     version: string;
     /** Type of FHIR resource to create (questionnaire and US Core questionnaireresponse profiles currently supported) */
     resource: DocumentRequest.Resource;
-    /** Base64 encoded file content */
+    /**
+     * Base64 encoded file content.
+     * Supported file types: PDF (application/pdf), PNG (image/png), JPEG (image/jpeg).
+     * File type is auto-detected from content magic bytes.
+     */
     content: string;
-    /** MIME type of the file */
-    fileType: DocumentRequest.FileType;
 }
 
 export namespace DocumentRequest {
@@ -27,12 +28,4 @@ export namespace DocumentRequest {
         Questionnaireresponse: "questionnaireresponse",
     } as const;
     export type Resource = (typeof Resource)[keyof typeof Resource];
-    /** MIME type of the file */
-    export const FileType = {
-        ApplicationPdf: "application/pdf",
-        ImagePng: "image/png",
-        ImageJpeg: "image/jpeg",
-        ImageJpg: "image/jpg",
-    } as const;
-    export type FileType = (typeof FileType)[keyof typeof FileType];
 }

src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "3.1.0";
+export const SDK_VERSION = "4.0.0";

tests/wire/lang2fhir/main.test.ts

@@ -460,12 +460,7 @@ describe("Lang2Fhir", () => {
     test("document (1)", async () => {
         const server = mockServerPool.createServer();
         const client = new phenomlClient({ token: "test", environment: server.baseUrl });
-        const rawRequestBody = {
-            version: "R4",
-            resource: "questionnaire",
-            content: "content",
-            fileType: "application/pdf",
-        };
+        const rawRequestBody = { version: "R4", resource: "questionnaire", content: "content" };
         const rawResponseBody = { key: "value" };
         server
             .mockEndpoint()
@@ -480,7 +475,6 @@ describe("Lang2Fhir", () => {
             version: "R4",
             resource: "questionnaire",
             content: "content",
-            fileType: "application/pdf",
         });
         expect(response).toEqual({
             key: "value",
@@ -490,12 +484,7 @@ describe("Lang2Fhir", () => {
     test("document (2)", async () => {
         const server = mockServerPool.createServer();
         const client = new phenomlClient({ token: "test", environment: server.baseUrl });
-        const rawRequestBody = {
-            version: "version",
-            resource: "questionnaire",
-            content: "content",
-            fileType: "application/pdf",
-        };
+        const rawRequestBody = { version: "version", resource: "questionnaire", content: "content" };
         const rawResponseBody = { key: "value" };
         server
             .mockEndpoint()
@@ -511,20 +500,14 @@ describe("Lang2Fhir", () => {
                 version: "version",
                 resource: "questionnaire",
                 content: "content",
-                fileType: "application/pdf",
             });
         }).rejects.toThrow(phenoml.lang2Fhir.BadRequestError);
     });
 
     test("document (3)", async () => {
         const server = mockServerPool.createServer();
         const client = new phenomlClient({ token: "test", environment: server.baseUrl });
-        const rawRequestBody = {
-            version: "version",
-            resource: "questionnaire",
-            content: "content",
-            fileType: "application/pdf",
-        };
+        const rawRequestBody = { version: "version", resource: "questionnaire", content: "content" };
         const rawResponseBody = { key: "value" };
         server
             .mockEndpoint()
@@ -540,20 +523,14 @@ describe("Lang2Fhir", () => {
                 version: "version",
                 resource: "questionnaire",
                 content: "content",
-                fileType: "application/pdf",
             });
         }).rejects.toThrow(phenoml.lang2Fhir.UnauthorizedError);
     });
 
     test("document (4)", async () => {
         const server = mockServerPool.createServer();
         const client = new phenomlClient({ token: "test", environment: server.baseUrl });
-        const rawRequestBody = {
-            version: "version",
-            resource: "questionnaire",
-            content: "content",
-            fileType: "application/pdf",
-        };
+        const rawRequestBody = { version: "version", resource: "questionnaire", content: "content" };
         const rawResponseBody = { key: "value" };
         server
             .mockEndpoint()
@@ -569,7 +546,6 @@ describe("Lang2Fhir", () => {
                 version: "version",
                 resource: "questionnaire",
                 content: "content",
-                fileType: "application/pdf",
             });
         }).rejects.toThrow(phenoml.lang2Fhir.InternalServerError);
     });