phenoml 5.1.0 → 5.3.0

package/dist/cjs/Client.js

@@ -52,8 +52,8 @@ class phenomlClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phenoml",
-                "X-Fern-SDK-Version": "5.1.0",
-                "User-Agent": "phenoml/5.1.0",
+                "X-Fern-SDK-Version": "5.3.0",
+                "User-Agent": "phenoml/5.3.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/construe/client/Client.d.ts

@@ -27,10 +27,12 @@ export declare class Construe {
      *
      * @example
      *     await client.construe.uploadCodeSystem({
+     *         format: "csv",
      *         name: "CUSTOM_CODES",
      *         version: "1.0",
-     *         format: "json",
-     *         file: "file"
+     *         file: "file",
+     *         code_col: "code",
+     *         desc_col: "description"
      *     })
      */
     uploadCodeSystem(request: phenoml.construe.UploadRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ConstrueUploadCodeSystemResponse>;
@@ -108,6 +110,30 @@ export declare class Construe {
      */
     deleteCustomCodeSystem(codesystem: string, request?: phenoml.construe.DeleteConstrueCodesSystemsCodesystemRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.DeleteCodeSystemResponse>;
     private __deleteCustomCodeSystem;
+    /**
+     * Exports a custom (non-builtin) code system as a JSON file compatible with the upload format.
+     * The exported file can be re-uploaded directly via POST /construe/upload with format "json".
+     * Only available on dedicated instances. Builtin systems cannot be exported.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest} request
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.ForbiddenError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.ConflictError}
+     * @throws {@link phenoml.construe.FailedDependencyError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.exportCustomCodeSystem("CUSTOM_CODES", {
+     *         version: "version"
+     *     })
+     */
+    exportCustomCodeSystem(codesystem: string, request?: phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExportCodeSystemResponse>;
+    private __exportCustomCodeSystem;
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/cjs/api/resources/construe/client/Client.js

@@ -70,10 +70,12 @@ class Construe {
      *
      * @example
      *     await client.construe.uploadCodeSystem({
+     *         format: "csv",
      *         name: "CUSTOM_CODES",
      *         version: "1.0",
-     *         format: "json",
-     *         file: "file"
+     *         file: "file",
+     *         code_col: "code",
+     *         desc_col: "description"
      *     })
      */
     uploadCodeSystem(request, requestOptions) {
@@ -441,6 +443,96 @@ class Construe {
             }
         });
     }
+    /**
+     * Exports a custom (non-builtin) code system as a JSON file compatible with the upload format.
+     * The exported file can be re-uploaded directly via POST /construe/upload with format "json".
+     * Only available on dedicated instances. Builtin systems cannot be exported.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest} request
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.ForbiddenError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.ConflictError}
+     * @throws {@link phenoml.construe.FailedDependencyError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.exportCustomCodeSystem("CUSTOM_CODES", {
+     *         version: "version"
+     *     })
+     */
+    exportCustomCodeSystem(codesystem, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__exportCustomCodeSystem(codesystem, request, requestOptions));
+    }
+    __exportCustomCodeSystem(codesystem_1) {
+        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { version } = request;
+            const _queryParams = {};
+            if (version != null) {
+                _queryParams.version = version;
+            }
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `construe/codes/systems/${core.url.encodePathParam(codesystem)}/export`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new phenoml.construe.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.construe.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new phenoml.construe.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new phenoml.construe.ConflictError(_response.error.body, _response.rawResponse);
+                    case 424:
+                        throw new phenoml.construe.FailedDependencyError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.phenomlError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.phenomlError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.phenomlTimeoutError("Timeout exceeded when calling GET /construe/codes/systems/{codesystem}/export.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/cjs/api/resources/construe/client/requests/GetConstrueCodesSystemsCodesystemExportRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         version: "version"
+ *     }
+ */
+export interface GetConstrueCodesSystemsCodesystemExportRequest {
+    /** Specific version of the code system. Required if multiple versions exist. */
+    version?: string;
+}

package/dist/cjs/api/resources/construe/client/requests/GetConstrueCodesSystemsCodesystemExportRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/client/requests/index.d.ts

@@ -4,5 +4,5 @@ export type { GetConstrueCodesCodesystemCodeIdRequest } from "./GetConstrueCodes
 export type { GetConstrueCodesCodesystemRequest } from "./GetConstrueCodesCodesystemRequest.js";
 export type { GetConstrueCodesCodesystemSearchSemanticRequest } from "./GetConstrueCodesCodesystemSearchSemanticRequest.js";
 export type { GetConstrueCodesCodesystemSearchTextRequest } from "./GetConstrueCodesCodesystemSearchTextRequest.js";
+export type { GetConstrueCodesSystemsCodesystemExportRequest } from "./GetConstrueCodesSystemsCodesystemExportRequest.js";
 export type { GetConstrueCodesSystemsCodesystemRequest } from "./GetConstrueCodesSystemsCodesystemRequest.js";
-export type { UploadRequest } from "./UploadRequest.js";

package/dist/cjs/api/resources/construe/types/ExportCodeSystemResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as phenoml from "../../../index.js";
+export interface ExportCodeSystemResponse {
+    /** Code system name */
+    name: string;
+    /** Code system version */
+    version: string;
+    /** Upload format (always "json") */
+    format: "json";
+    /** All codes in the system */
+    codes: phenoml.construe.CodeResponse[];
+}

package/dist/cjs/api/resources/construe/types/ExportCodeSystemResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/GetCodeSystemDetailResponse.d.ts

@@ -7,10 +7,29 @@ export interface GetCodeSystemDetailResponse {
     code_count: number;
     /** Whether this is a built-in system (vs custom uploaded) */
     builtin: boolean;
-    /** Processing status of the code system. Currently always "ready". */
-    status: "ready";
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    status: GetCodeSystemDetailResponse.Status;
     /** When the code system was created */
     created_at: string;
     /** When the code system was last updated */
     updated_at: string;
 }
+export declare namespace GetCodeSystemDetailResponse {
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    const Status: {
+        readonly Processing: "processing";
+        readonly Ready: "ready";
+        readonly Failed: "failed";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/resources/construe/types/GetCodeSystemDetailResponse.js

@@ -1,3 +1,18 @@
 "use strict";
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCodeSystemDetailResponse = void 0;
+var GetCodeSystemDetailResponse;
+(function (GetCodeSystemDetailResponse) {
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    GetCodeSystemDetailResponse.Status = {
+        Processing: "processing",
+        Ready: "ready",
+        Failed: "failed",
+    };
+})(GetCodeSystemDetailResponse || (exports.GetCodeSystemDetailResponse = GetCodeSystemDetailResponse = {}));

package/dist/cjs/api/resources/construe/types/UploadRequest.d.ts

@@ -0,0 +1,10 @@
+import type * as phenoml from "../../../index.js";
+export type UploadRequest = phenoml.construe.UploadRequest.Csv | phenoml.construe.UploadRequest.Json;
+export declare namespace UploadRequest {
+    interface Csv extends phenoml.construe.UploadRequestCsv {
+        format: "csv";
+    }
+    interface Json extends phenoml.construe.UploadRequestJson {
+        format: "json";
+    }
+}

package/dist/cjs/api/resources/construe/types/UploadRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/UploadRequestCsv.d.ts

@@ -0,0 +1,32 @@
+export interface UploadRequestCsv {
+    /**
+     * Name of the code system. Names are case-insensitive and stored uppercase.
+     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
+     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
+     */
+    name: string;
+    /** Version of the code system */
+    version: string;
+    /** Optional revision number */
+    revision?: number;
+    /** The CSV file contents as a base64-encoded string. */
+    file: string;
+    /** Column name containing codes */
+    code_col: string;
+    /** Column name containing descriptions */
+    desc_col: string;
+    /** Optional column name containing long definitions */
+    defn_col?: string;
+    /**
+     * If true, replaces an existing code system with the same name and version.
+     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
+     * When false (default), uploading a duplicate returns 409 Conflict.
+     */
+    replace?: boolean;
+    /**
+     * If true, returns 202 Accepted immediately after validation and starts processing
+     * in the background. Poll GET /construe/codes/systems/{name}?version={version} to
+     * check when status transitions from "processing" to "ready" or "failed".
+     */
+    async?: boolean;
+}

package/dist/cjs/api/resources/construe/types/UploadRequestCsv.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/UploadRequestJson.d.ts

@@ -0,0 +1,40 @@
+import type * as phenoml from "../../../index.js";
+/**
+ * Upload codes in JSON format. Either 'file' or 'codes' must be provided.
+ * If both are provided, 'codes' takes precedence.
+ */
+export interface UploadRequestJson {
+    /**
+     * Name of the code system. Names are case-insensitive and stored uppercase.
+     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
+     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
+     */
+    name: string;
+    /** Version of the code system */
+    version: string;
+    /** Optional revision number */
+    revision?: number;
+    /**
+     * The file contents as a base64-encoded JSON array string.
+     * Prefer using 'codes' instead to pass the array directly without base64 encoding.
+     */
+    file?: string;
+    /**
+     * The codes to upload as a JSON array.
+     * This is the preferred way to upload JSON codes, as it avoids unnecessary base64 encoding.
+     * If both 'codes' and 'file' are provided, 'codes' takes precedence.
+     */
+    codes?: phenoml.construe.CodeResponse[];
+    /**
+     * If true, replaces an existing code system with the same name and version.
+     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
+     * When false (default), uploading a duplicate returns 409 Conflict.
+     */
+    replace?: boolean;
+    /**
+     * If true, returns 202 Accepted immediately after validation and starts processing
+     * in the background. Poll GET /construe/codes/systems/{name}?version={version} to
+     * check when status transitions from "processing" to "ready" or "failed".
+     */
+    async?: boolean;
+}

package/dist/cjs/api/resources/construe/types/UploadRequestJson.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/construe/types/index.d.ts

@@ -4,6 +4,7 @@ export * from "./CodeSystemDetails.js";
 export * from "./CodeSystemInfo.js";
 export * from "./ConstrueUploadCodeSystemResponse.js";
 export * from "./DeleteCodeSystemResponse.js";
+export * from "./ExportCodeSystemResponse.js";
 export * from "./ExtractCodesResult.js";
 export * from "./ExtractedCodeResult.js";
 export * from "./ExtractRequestConfig.js";
@@ -16,3 +17,6 @@ export * from "./SemanticSearchResponse.js";
 export * from "./SemanticSearchResult.js";
 export * from "./TextSearchResponse.js";
 export * from "./TextSearchResult.js";
+export * from "./UploadRequest.js";
+export * from "./UploadRequestCsv.js";
+export * from "./UploadRequestJson.js";

package/dist/cjs/api/resources/construe/types/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./CodeSystemDetails.js"), exports);
 __exportStar(require("./CodeSystemInfo.js"), exports);
 __exportStar(require("./ConstrueUploadCodeSystemResponse.js"), exports);
 __exportStar(require("./DeleteCodeSystemResponse.js"), exports);
+__exportStar(require("./ExportCodeSystemResponse.js"), exports);
 __exportStar(require("./ExtractCodesResult.js"), exports);
 __exportStar(require("./ExtractedCodeResult.js"), exports);
 __exportStar(require("./ExtractRequestConfig.js"), exports);
@@ -32,3 +33,6 @@ __exportStar(require("./SemanticSearchResponse.js"), exports);
 __exportStar(require("./SemanticSearchResult.js"), exports);
 __exportStar(require("./TextSearchResponse.js"), exports);
 __exportStar(require("./TextSearchResult.js"), exports);
+__exportStar(require("./UploadRequest.js"), exports);
+__exportStar(require("./UploadRequestCsv.js"), exports);
+__exportStar(require("./UploadRequestJson.js"), exports);

package/dist/cjs/api/resources/fhirProvider/client/Client.d.ts

@@ -59,7 +59,6 @@ export declare class FhirProvider {
      * @param {FhirProvider.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link phenoml.fhirProvider.UnauthorizedError}
-     * @throws {@link phenoml.fhirProvider.ForbiddenError}
      * @throws {@link phenoml.fhirProvider.NotFoundError}
      * @throws {@link phenoml.fhirProvider.InternalServerError}
      *

package/dist/cjs/api/resources/fhirProvider/client/Client.js

@@ -211,7 +211,6 @@ class FhirProvider {
      * @param {FhirProvider.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link phenoml.fhirProvider.UnauthorizedError}
-     * @throws {@link phenoml.fhirProvider.ForbiddenError}
      * @throws {@link phenoml.fhirProvider.NotFoundError}
      * @throws {@link phenoml.fhirProvider.InternalServerError}
      *
@@ -244,8 +243,6 @@ class FhirProvider {
                 switch (_response.error.statusCode) {
                     case 401:
                         throw new phenoml.fhirProvider.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new phenoml.fhirProvider.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new phenoml.fhirProvider.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.0";
+export declare const SDK_VERSION = "5.3.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "5.1.0";
+exports.SDK_VERSION = "5.3.0";

package/dist/esm/Client.mjs

@@ -16,8 +16,8 @@ export class phenomlClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "phenoml",
-                "X-Fern-SDK-Version": "5.1.0",
-                "User-Agent": "phenoml/5.1.0",
+                "X-Fern-SDK-Version": "5.3.0",
+                "User-Agent": "phenoml/5.3.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/construe/client/Client.d.mts

@@ -27,10 +27,12 @@ export declare class Construe {
      *
      * @example
      *     await client.construe.uploadCodeSystem({
+     *         format: "csv",
      *         name: "CUSTOM_CODES",
      *         version: "1.0",
-     *         format: "json",
-     *         file: "file"
+     *         file: "file",
+     *         code_col: "code",
+     *         desc_col: "description"
      *     })
      */
     uploadCodeSystem(request: phenoml.construe.UploadRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ConstrueUploadCodeSystemResponse>;
@@ -108,6 +110,30 @@ export declare class Construe {
      */
     deleteCustomCodeSystem(codesystem: string, request?: phenoml.construe.DeleteConstrueCodesSystemsCodesystemRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.DeleteCodeSystemResponse>;
     private __deleteCustomCodeSystem;
+    /**
+     * Exports a custom (non-builtin) code system as a JSON file compatible with the upload format.
+     * The exported file can be re-uploaded directly via POST /construe/upload with format "json".
+     * Only available on dedicated instances. Builtin systems cannot be exported.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest} request
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.ForbiddenError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.ConflictError}
+     * @throws {@link phenoml.construe.FailedDependencyError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.exportCustomCodeSystem("CUSTOM_CODES", {
+     *         version: "version"
+     *     })
+     */
+    exportCustomCodeSystem(codesystem: string, request?: phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExportCodeSystemResponse>;
+    private __exportCustomCodeSystem;
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/esm/api/resources/construe/client/Client.mjs

@@ -34,10 +34,12 @@ export class Construe {
      *
      * @example
      *     await client.construe.uploadCodeSystem({
+     *         format: "csv",
      *         name: "CUSTOM_CODES",
      *         version: "1.0",
-     *         format: "json",
-     *         file: "file"
+     *         file: "file",
+     *         code_col: "code",
+     *         desc_col: "description"
      *     })
      */
     uploadCodeSystem(request, requestOptions) {
@@ -405,6 +407,96 @@ export class Construe {
             }
         });
     }
+    /**
+     * Exports a custom (non-builtin) code system as a JSON file compatible with the upload format.
+     * The exported file can be re-uploaded directly via POST /construe/upload with format "json".
+     * Only available on dedicated instances. Builtin systems cannot be exported.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest} request
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.BadRequestError}
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.ForbiddenError}
+     * @throws {@link phenoml.construe.NotFoundError}
+     * @throws {@link phenoml.construe.ConflictError}
+     * @throws {@link phenoml.construe.FailedDependencyError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.exportCustomCodeSystem("CUSTOM_CODES", {
+     *         version: "version"
+     *     })
+     */
+    exportCustomCodeSystem(codesystem, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__exportCustomCodeSystem(codesystem, request, requestOptions));
+    }
+    __exportCustomCodeSystem(codesystem_1) {
+        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { version } = request;
+            const _queryParams = {};
+            if (version != null) {
+                _queryParams.version = version;
+            }
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `construe/codes/systems/${core.url.encodePathParam(codesystem)}/export`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new phenoml.construe.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new phenoml.construe.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new phenoml.construe.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new phenoml.construe.ConflictError(_response.error.body, _response.rawResponse);
+                    case 424:
+                        throw new phenoml.construe.FailedDependencyError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.phenomlError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.phenomlError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.phenomlTimeoutError("Timeout exceeded when calling GET /construe/codes/systems/{codesystem}/export.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Returns a paginated list of all codes in the specified code system from the terminology server.
      *

package/dist/esm/api/resources/construe/client/requests/GetConstrueCodesSystemsCodesystemExportRequest.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         version: "version"
+ *     }
+ */
+export interface GetConstrueCodesSystemsCodesystemExportRequest {
+    /** Specific version of the code system. Required if multiple versions exist. */
+    version?: string;
+}

package/dist/esm/api/resources/construe/client/requests/GetConstrueCodesSystemsCodesystemExportRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/client/requests/index.d.mts

@@ -4,5 +4,5 @@ export type { GetConstrueCodesCodesystemCodeIdRequest } from "./GetConstrueCodes
 export type { GetConstrueCodesCodesystemRequest } from "./GetConstrueCodesCodesystemRequest.mjs";
 export type { GetConstrueCodesCodesystemSearchSemanticRequest } from "./GetConstrueCodesCodesystemSearchSemanticRequest.mjs";
 export type { GetConstrueCodesCodesystemSearchTextRequest } from "./GetConstrueCodesCodesystemSearchTextRequest.mjs";
+export type { GetConstrueCodesSystemsCodesystemExportRequest } from "./GetConstrueCodesSystemsCodesystemExportRequest.mjs";
 export type { GetConstrueCodesSystemsCodesystemRequest } from "./GetConstrueCodesSystemsCodesystemRequest.mjs";
-export type { UploadRequest } from "./UploadRequest.mjs";

package/dist/esm/api/resources/construe/types/ExportCodeSystemResponse.d.mts

@@ -0,0 +1,11 @@
+import type * as phenoml from "../../../index.mjs";
+export interface ExportCodeSystemResponse {
+    /** Code system name */
+    name: string;
+    /** Code system version */
+    version: string;
+    /** Upload format (always "json") */
+    format: "json";
+    /** All codes in the system */
+    codes: phenoml.construe.CodeResponse[];
+}

package/dist/esm/api/resources/construe/types/ExportCodeSystemResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/types/GetCodeSystemDetailResponse.d.mts

@@ -7,10 +7,29 @@ export interface GetCodeSystemDetailResponse {
     code_count: number;
     /** Whether this is a built-in system (vs custom uploaded) */
     builtin: boolean;
-    /** Processing status of the code system. Currently always "ready". */
-    status: "ready";
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    status: GetCodeSystemDetailResponse.Status;
     /** When the code system was created */
     created_at: string;
     /** When the code system was last updated */
     updated_at: string;
 }
+export declare namespace GetCodeSystemDetailResponse {
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    const Status: {
+        readonly Processing: "processing";
+        readonly Ready: "ready";
+        readonly Failed: "failed";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/esm/api/resources/construe/types/GetCodeSystemDetailResponse.mjs

@@ -1,2 +1,15 @@
 // This file was auto-generated by Fern from our API Definition.
-export {};
+export var GetCodeSystemDetailResponse;
+(function (GetCodeSystemDetailResponse) {
+    /**
+     * Processing status of the code system.
+     * - "processing": embeddings are being generated (async upload in progress)
+     * - "ready": code system is ready for use
+     * - "failed": async processing failed (re-upload with replace=true to retry)
+     */
+    GetCodeSystemDetailResponse.Status = {
+        Processing: "processing",
+        Ready: "ready",
+        Failed: "failed",
+    };
+})(GetCodeSystemDetailResponse || (GetCodeSystemDetailResponse = {}));

package/dist/esm/api/resources/construe/types/UploadRequest.d.mts

@@ -0,0 +1,10 @@
+import type * as phenoml from "../../../index.mjs";
+export type UploadRequest = phenoml.construe.UploadRequest.Csv | phenoml.construe.UploadRequest.Json;
+export declare namespace UploadRequest {
+    interface Csv extends phenoml.construe.UploadRequestCsv {
+        format: "csv";
+    }
+    interface Json extends phenoml.construe.UploadRequestJson {
+        format: "json";
+    }
+}

package/dist/esm/api/resources/construe/types/UploadRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/types/UploadRequestCsv.d.mts

@@ -0,0 +1,32 @@
+export interface UploadRequestCsv {
+    /**
+     * Name of the code system. Names are case-insensitive and stored uppercase.
+     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
+     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
+     */
+    name: string;
+    /** Version of the code system */
+    version: string;
+    /** Optional revision number */
+    revision?: number;
+    /** The CSV file contents as a base64-encoded string. */
+    file: string;
+    /** Column name containing codes */
+    code_col: string;
+    /** Column name containing descriptions */
+    desc_col: string;
+    /** Optional column name containing long definitions */
+    defn_col?: string;
+    /**
+     * If true, replaces an existing code system with the same name and version.
+     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
+     * When false (default), uploading a duplicate returns 409 Conflict.
+     */
+    replace?: boolean;
+    /**
+     * If true, returns 202 Accepted immediately after validation and starts processing
+     * in the background. Poll GET /construe/codes/systems/{name}?version={version} to
+     * check when status transitions from "processing" to "ready" or "failed".
+     */
+    async?: boolean;
+}

package/dist/esm/api/resources/construe/types/UploadRequestCsv.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/types/UploadRequestJson.d.mts

@@ -0,0 +1,40 @@
+import type * as phenoml from "../../../index.mjs";
+/**
+ * Upload codes in JSON format. Either 'file' or 'codes' must be provided.
+ * If both are provided, 'codes' takes precedence.
+ */
+export interface UploadRequestJson {
+    /**
+     * Name of the code system. Names are case-insensitive and stored uppercase.
+     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
+     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
+     */
+    name: string;
+    /** Version of the code system */
+    version: string;
+    /** Optional revision number */
+    revision?: number;
+    /**
+     * The file contents as a base64-encoded JSON array string.
+     * Prefer using 'codes' instead to pass the array directly without base64 encoding.
+     */
+    file?: string;
+    /**
+     * The codes to upload as a JSON array.
+     * This is the preferred way to upload JSON codes, as it avoids unnecessary base64 encoding.
+     * If both 'codes' and 'file' are provided, 'codes' takes precedence.
+     */
+    codes?: phenoml.construe.CodeResponse[];
+    /**
+     * If true, replaces an existing code system with the same name and version.
+     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
+     * When false (default), uploading a duplicate returns 409 Conflict.
+     */
+    replace?: boolean;
+    /**
+     * If true, returns 202 Accepted immediately after validation and starts processing
+     * in the background. Poll GET /construe/codes/systems/{name}?version={version} to
+     * check when status transitions from "processing" to "ready" or "failed".
+     */
+    async?: boolean;
+}

package/dist/esm/api/resources/construe/types/UploadRequestJson.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/construe/types/index.d.mts

@@ -4,6 +4,7 @@ export * from "./CodeSystemDetails.mjs";
 export * from "./CodeSystemInfo.mjs";
 export * from "./ConstrueUploadCodeSystemResponse.mjs";
 export * from "./DeleteCodeSystemResponse.mjs";
+export * from "./ExportCodeSystemResponse.mjs";
 export * from "./ExtractCodesResult.mjs";
 export * from "./ExtractedCodeResult.mjs";
 export * from "./ExtractRequestConfig.mjs";
@@ -16,3 +17,6 @@ export * from "./SemanticSearchResponse.mjs";
 export * from "./SemanticSearchResult.mjs";
 export * from "./TextSearchResponse.mjs";
 export * from "./TextSearchResult.mjs";
+export * from "./UploadRequest.mjs";
+export * from "./UploadRequestCsv.mjs";
+export * from "./UploadRequestJson.mjs";

package/dist/esm/api/resources/construe/types/index.mjs

@@ -4,6 +4,7 @@ export * from "./CodeSystemDetails.mjs";
 export * from "./CodeSystemInfo.mjs";
 export * from "./ConstrueUploadCodeSystemResponse.mjs";
 export * from "./DeleteCodeSystemResponse.mjs";
+export * from "./ExportCodeSystemResponse.mjs";
 export * from "./ExtractCodesResult.mjs";
 export * from "./ExtractedCodeResult.mjs";
 export * from "./ExtractRequestConfig.mjs";
@@ -16,3 +17,6 @@ export * from "./SemanticSearchResponse.mjs";
 export * from "./SemanticSearchResult.mjs";
 export * from "./TextSearchResponse.mjs";
 export * from "./TextSearchResult.mjs";
+export * from "./UploadRequest.mjs";
+export * from "./UploadRequestCsv.mjs";
+export * from "./UploadRequestJson.mjs";

package/dist/esm/api/resources/fhirProvider/client/Client.d.mts

@@ -59,7 +59,6 @@ export declare class FhirProvider {
      * @param {FhirProvider.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link phenoml.fhirProvider.UnauthorizedError}
-     * @throws {@link phenoml.fhirProvider.ForbiddenError}
      * @throws {@link phenoml.fhirProvider.NotFoundError}
      * @throws {@link phenoml.fhirProvider.InternalServerError}
      *

package/dist/esm/api/resources/fhirProvider/client/Client.mjs

@@ -175,7 +175,6 @@ export class FhirProvider {
      * @param {FhirProvider.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link phenoml.fhirProvider.UnauthorizedError}
-     * @throws {@link phenoml.fhirProvider.ForbiddenError}
      * @throws {@link phenoml.fhirProvider.NotFoundError}
      * @throws {@link phenoml.fhirProvider.InternalServerError}
      *
@@ -208,8 +207,6 @@ export class FhirProvider {
                 switch (_response.error.statusCode) {
                     case 401:
                         throw new phenoml.fhirProvider.UnauthorizedError(_response.error.body, _response.rawResponse);
-                    case 403:
-                        throw new phenoml.fhirProvider.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new phenoml.fhirProvider.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "5.1.0";
+export declare const SDK_VERSION = "5.3.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "5.1.0";
+export const SDK_VERSION = "5.3.0";

package/package.json

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

package/reference.md

@@ -1171,10 +1171,12 @@ subsequently use the code system for construe/extract and lang2fhir/create (comi
 
 ```typescript
 await client.construe.uploadCodeSystem({
+    format: "csv",
     name: "CUSTOM_CODES",
     version: "1.0",
-    format: "json",
-    file: "file"
+    file: "file",
+    code_col: "code",
+    desc_col: "description"
 });
 
 ```
@@ -1191,7 +1193,7 @@ await client.construe.uploadCodeSystem({
 <dl>
 <dd>
 
-**request:** `phenoml.construe.UploadRequest` 
+**request:** `phenoml.UploadRequest` 
     
 </dd>
 </dl>
@@ -1476,6 +1478,81 @@ await client.construe.deleteCustomCodeSystem("CUSTOM_CODES", {
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.construe.<a href="/src/api/resources/construe/client/Client.ts">exportCustomCodeSystem</a>(codesystem, { ...params }) -> phenoml.ExportCodeSystemResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Exports a custom (non-builtin) code system as a JSON file compatible with the upload format.
+The exported file can be re-uploaded directly via POST /construe/upload with format "json".
+Only available on dedicated instances. Builtin systems cannot be exported.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.construe.exportCustomCodeSystem("CUSTOM_CODES", {
+    version: "version"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**codesystem:** `string` — Code system name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `phenoml.construe.GetConstrueCodesSystemsCodesystemExportRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Construe.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

package/dist/cjs/api/resources/construe/client/requests/UploadRequest.d.ts

@@ -1,45 +0,0 @@
-/**
- * @example
- *     {
- *         name: "CUSTOM_CODES",
- *         version: "1.0",
- *         format: "json",
- *         file: "file"
- *     }
- */
-export interface UploadRequest {
-    /**
-     * Name of the code system. Names are case-insensitive and stored uppercase.
-     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
-     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
-     */
-    name: string;
-    /** Version of the code system */
-    version: string;
-    /** Optional revision number */
-    revision?: number;
-    /** Format of the uploaded file */
-    format: UploadRequest.Format;
-    /** The file contents as a base64-encoded string */
-    file: string;
-    /** Column name containing codes (required for CSV format) */
-    code_col?: string;
-    /** Column name containing descriptions (required for CSV format) */
-    desc_col?: string;
-    /** Optional column name containing long definitions (for CSV format) */
-    defn_col?: string;
-    /**
-     * If true, replaces an existing code system with the same name and version.
-     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
-     * When false (default), uploading a duplicate returns 409 Conflict.
-     */
-    replace?: boolean;
-}
-export declare namespace UploadRequest {
-    /** Format of the uploaded file */
-    const Format: {
-        readonly Json: "json";
-        readonly Csv: "csv";
-    };
-    type Format = (typeof Format)[keyof typeof Format];
-}

package/dist/cjs/api/resources/construe/client/requests/UploadRequest.js

@@ -1,12 +0,0 @@
-"use strict";
-// This file was auto-generated by Fern from our API Definition.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UploadRequest = void 0;
-var UploadRequest;
-(function (UploadRequest) {
-    /** Format of the uploaded file */
-    UploadRequest.Format = {
-        Json: "json",
-        Csv: "csv",
-    };
-})(UploadRequest || (exports.UploadRequest = UploadRequest = {}));

package/dist/esm/api/resources/construe/client/requests/UploadRequest.d.mts

@@ -1,45 +0,0 @@
-/**
- * @example
- *     {
- *         name: "CUSTOM_CODES",
- *         version: "1.0",
- *         format: "json",
- *         file: "file"
- *     }
- */
-export interface UploadRequest {
-    /**
-     * Name of the code system. Names are case-insensitive and stored uppercase.
-     * Builtin system names (e.g. ICD-10-CM, SNOMED_CT_US_LITE, LOINC, CPT, etc.) are
-     * reserved and cannot be used for custom uploads; attempts return HTTP 403 Forbidden.
-     */
-    name: string;
-    /** Version of the code system */
-    version: string;
-    /** Optional revision number */
-    revision?: number;
-    /** Format of the uploaded file */
-    format: UploadRequest.Format;
-    /** The file contents as a base64-encoded string */
-    file: string;
-    /** Column name containing codes (required for CSV format) */
-    code_col?: string;
-    /** Column name containing descriptions (required for CSV format) */
-    desc_col?: string;
-    /** Optional column name containing long definitions (for CSV format) */
-    defn_col?: string;
-    /**
-     * If true, replaces an existing code system with the same name and version.
-     * Builtin systems cannot be replaced; attempts to do so return HTTP 403 Forbidden.
-     * When false (default), uploading a duplicate returns 409 Conflict.
-     */
-    replace?: boolean;
-}
-export declare namespace UploadRequest {
-    /** Format of the uploaded file */
-    const Format: {
-        readonly Json: "json";
-        readonly Csv: "csv";
-    };
-    type Format = (typeof Format)[keyof typeof Format];
-}

package/dist/esm/api/resources/construe/client/requests/UploadRequest.mjs

@@ -1,9 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-export var UploadRequest;
-(function (UploadRequest) {
-    /** Format of the uploaded file */
-    UploadRequest.Format = {
-        Json: "json",
-        Csv: "csv",
-    };
-})(UploadRequest || (UploadRequest = {}));