phenoml 16.0.0 → 17.0.0

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

@@ -51,751 +51,19 @@ const environments = __importStar(require("../../../../environments.js"));
 const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 const phenoml = __importStar(require("../../../index.js"));
+const Client_js_1 = require("../resources/codeSystems/client/Client.js");
+const Client_js_2 = require("../resources/codes/client/Client.js");
 class ConstrueClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
-    /**
-     * Upload a custom medical code system with codes and descriptions for use in code extraction. Requires a paid plan.
-     * Returns 202 immediately; embedding generation runs asynchronously. Poll
-     * GET /construe/codes/systems/{codesystem}?version={version} to check when status
-     * transitions from "processing" to "ready" or "failed".
-     *
-     * @param {phenoml.construe.UploadRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.ForbiddenError}
-     * @throws {@link phenoml.construe.ConflictError}
-     * @throws {@link phenoml.construe.FailedDependencyError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.uploadCodeSystem({
-     *         name: "CUSTOM_CODES",
-     *         version: "1.0",
-     *         format: "json",
-     *         codes: [{
-     *                 code: "X001",
-     *                 description: "Example custom code 1"
-     *             }, {
-     *                 code: "X002",
-     *                 description: "Example custom code 2"
-     *             }]
-     *     })
-     *
-     * @example
-     *     await client.construe.uploadCodeSystem({
-     *         name: "CUSTOM_CODES",
-     *         version: "1.0",
-     *         format: "csv",
-     *         file: "Y29kZSxkZXNjcmlwdGlvbgpYMDAxLEV4YW1wbGUgY3VzdG9tIGNvZGUgMQo=",
-     *         code_col: "code",
-     *         desc_col: "description"
-     *     })
-     */
-    uploadCodeSystem(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__uploadCodeSystem(request, requestOptions));
-    }
-    __uploadCodeSystem(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/upload"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                requestType: "json",
-                body: request,
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/construe/upload");
-        });
-    }
-    /**
-     * Converts natural language text into structured medical codes.
-     *
-     * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
-     *
-     * @param {phenoml.construe.ExtractRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     * @throws {@link phenoml.construe.ServiceUnavailableError}
-     * @throws {@link phenoml.construe.GatewayTimeoutError}
-     *
-     * @example
-     *     await client.construe.extractCodes({
-     *         text: "Patient is a 14-year-old female, previously healthy, who is here for evaluation of abnormal renal ultrasound with atrophic right kidney.",
-     *         system: {
-     *             name: "ICD-10-CM",
-     *             version: "2025"
-     *         }
-     *     })
-     *
-     * @example
-     *     await client.construe.extractCodes({
-     *         text: "45-year-old male presents with chest pain radiating to left arm, shortness of breath, and diaphoresis. ECG shows ST elevation in leads II, III, and aVF.",
-     *         system: {
-     *             name: "SNOMED_CT_US_LITE",
-     *             version: "20240901"
-     *         },
-     *         config: {
-     *             chunking_method: "sentences",
-     *             validation_method: "simple",
-     *             include_rationale: true,
-     *             include_citations: true
-     *         }
-     *     })
-     *
-     * @example
-     *     await client.construe.extractCodes({
-     *         text: "Start Metformin 500mg twice daily for type 2 diabetes. Continue Lisinopril 10mg daily for hypertension. Add Atorvastatin 20mg at bedtime.",
-     *         system: {
-     *             name: "RXNORM",
-     *             version: "11042024"
-     *         },
-     *         config: {
-     *             validation_method: "medication_search",
-     *             include_rationale: true
-     *         }
-     *     })
-     *
-     * @example
-     *     await client.construe.extractCodes({
-     *         text: "Patient diagnosed with Type 2 diabetes mellitus with diabetic chronic kidney disease, stage 3.",
-     *         system: {
-     *             name: "ICD-10-CM",
-     *             version: "2025"
-     *         },
-     *         config: {
-     *             validation_method: "simple",
-     *             include_ancestors: true
-     *         }
-     *     })
-     *
-     * @example
-     *     await client.construe.extractCodes({
-     *         text: "5-year-old male with seizures, severe intellectual disability, microcephaly, and hypotonia.",
-     *         system: {
-     *             name: "HPO",
-     *             version: "2025"
-     *         },
-     *         config: {
-     *             chunking_method: "fasthpocr",
-     *             validation_method: "none",
-     *             include_rationale: false
-     *         }
-     *     })
-     */
-    extractCodes(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__extractCodes(request, requestOptions));
-    }
-    __extractCodes(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/extract"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                requestType: "json",
-                body: request,
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
-                    case 503:
-                        throw new phenoml.construe.ServiceUnavailableError(_response.error.body, _response.rawResponse);
-                    case 504:
-                        throw new phenoml.construe.GatewayTimeoutError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.phenomlError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/construe/extract");
-        });
-    }
-    /**
-     * Returns the terminology server's catalog of available code systems, including both built-in standard terminologies and custom uploaded systems.
-     *
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.listCodeSystems()
-     */
-    listCodeSystems(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__listCodeSystems(requestOptions));
-    }
-    __listCodeSystems(requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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"),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            if (_response.ok) {
-                return {
-                    data: _response.body,
-                    rawResponse: _response.rawResponse,
-                };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 401:
-                        throw new phenoml.construe.UnauthorizedError(_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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/systems");
-        });
-    }
-    /**
-     * Returns full metadata for a single code system, including timestamps and builtin status.
-     *
-     * @param {string} codesystem - Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
-     * @param {phenoml.construe.GetCodeSystemRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.getCodeSystem("ICD-10-CM", {
-     *         version: "2025"
-     *     })
-     */
-    getCodeSystem(codesystem, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getCodeSystem(codesystem, request, requestOptions));
-    }
-    __getCodeSystem(codesystem_1) {
-        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { version } = request;
-            const _queryParams = {
-                version,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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)}`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/systems/{codesystem}");
-        });
-    }
-    /**
-     * Deletes a custom (non-builtin) code system and all its codes. Builtin systems cannot be deleted.
-     * Only available on dedicated instances. Large systems may take up to a minute to delete.
-     *
-     * @param {string} codesystem - Code system name
-     * @param {phenoml.construe.DeleteCodeSystemRequest} request
-     * @param {ConstrueClient.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.InternalServerError}
-     *
-     * @example
-     *     await client.construe.deleteCodeSystem("CUSTOM_CODES", {
-     *         version: "version"
-     *     })
-     */
-    deleteCodeSystem(codesystem, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__deleteCodeSystem(codesystem, request, requestOptions));
-    }
-    __deleteCodeSystem(codesystem_1) {
-        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { version } = request;
-            const _queryParams = {
-                version,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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)}`),
-                method: "DELETE",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/construe/codes/systems/{codesystem}");
-        });
+    get codeSystems() {
+        var _a;
+        return ((_a = this._codeSystems) !== null && _a !== void 0 ? _a : (this._codeSystems = new Client_js_1.CodeSystemsClient(this._options)));
     }
-    /**
-     * 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.ExportCodeSystemRequest} request
-     * @param {ConstrueClient.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.exportCodeSystem("CUSTOM_CODES", {
-     *         version: "version"
-     *     })
-     */
-    exportCodeSystem(codesystem, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__exportCodeSystem(codesystem, request, requestOptions));
-    }
-    __exportCodeSystem(codesystem_1) {
-        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { version } = request;
-            const _queryParams = {
-                version,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/systems/{codesystem}/export");
-        });
-    }
-    /**
-     * Returns a paginated list of all codes in the specified code system from the terminology server.
-     *
-     * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
-     *
-     * @param {string} codesystem - Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
-     * @param {phenoml.construe.ListCodesRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.listCodes("ICD-10-CM", {
-     *         version: "2025",
-     *         cursor: "cursor",
-     *         limit: 1
-     *     })
-     */
-    listCodes(codesystem, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__listCodes(codesystem, request, requestOptions));
-    }
-    __listCodes(codesystem_1) {
-        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { version, cursor, limit } = request;
-            const _queryParams = {
-                version,
-                cursor,
-                limit,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/${core.url.encodePathParam(codesystem)}`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/{codesystem}");
-        });
-    }
-    /**
-     * Looks up a specific code in the terminology server and returns its details.
-     *
-     * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
-     *
-     * @param {string} codesystem - Code system name
-     * @param {string} codeID - The code identifier. ICD-10-CM codes are stored without their
-     *                          cosmetic dot (use "E1165", not "E11.65").
-     * @param {phenoml.construe.GetCodeRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.getCode("ICD-10-CM", "E1165", {
-     *         version: "version"
-     *     })
-     */
-    getCode(codesystem, codeID, request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getCode(codesystem, codeID, request, requestOptions));
-    }
-    __getCode(codesystem_1, codeID_1) {
-        return __awaiter(this, arguments, void 0, function* (codesystem, codeID, request = {}, requestOptions) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { version } = request;
-            const _queryParams = {
-                version,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/${core.url.encodePathParam(codesystem)}/${core.url.encodePathParam(codeID)}`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/{codesystem}/{codeID}");
-        });
-    }
-    /**
-     * Performs semantic similarity search using vector embeddings.
-     *
-     * **Availability**: This endpoint works for both **built-in and custom** code systems.
-     *
-     * **When to use**: Best for natural language queries where you want to find conceptually
-     * related codes, even when different terminology is used. The search understands meaning,
-     * not just keywords.
-     *
-     * **Examples**:
-     * - Query "trouble breathing at night" finds codes like "Sleep apnea", "Orthopnea",
-     *   "Nocturnal dyspnea" — semantically related but no exact keyword matches
-     * - Query "heart problems" finds "Myocardial infarction", "Cardiac arrest", "Arrhythmia"
-     *
-     * **Trade-offs**: Slower than text search (requires embedding generation), but finds
-     * conceptually similar results that keyword search would miss.
-     *
-     * See also: `/search/text` for faster keyword-based lookup with typo tolerance.
-     *
-     * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
-     *
-     * @param {string} codesystem - Code system name
-     * @param {phenoml.construe.SearchSemanticRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     *
-     * @example
-     *     await client.construe.searchSemantic("ICD-10-CM", {
-     *         text: "patient has trouble breathing at night and wakes up gasping",
-     *         version: "version",
-     *         limit: 1
-     *     })
-     */
-    searchSemantic(codesystem, request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__searchSemantic(codesystem, request, requestOptions));
-    }
-    __searchSemantic(codesystem, request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { text, version, limit } = request;
-            const _queryParams = {
-                text,
-                version,
-                limit,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/${core.url.encodePathParam(codesystem)}/search/semantic`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_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,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/{codesystem}/search/semantic");
-        });
+    get codes() {
+        var _a;
+        return ((_a = this._codes) !== null && _a !== void 0 ? _a : (this._codes = new Client_js_2.CodesClient(this._options)));
     }
     /**
      * Submits user feedback on results from the Construe extraction endpoint.
@@ -883,103 +151,5 @@ class ConstrueClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/construe/feedback");
         });
     }
-    /**
-     * Performs fast full-text search over code IDs and descriptions.
-     *
-     * **Availability**: This endpoint is only available for **built-in code systems**.
-     * Custom code systems uploaded via `/construe/upload` are not indexed for full-text search
-     * and will return empty results. Use `/search/semantic` to search custom code systems.
-     *
-     * **When to use**: Best for autocomplete UIs, code lookup, or when users know part of
-     * the code ID or specific keywords. Fast response times suitable for typeahead interfaces.
-     *
-     * **Features**:
-     * - Substring matching on code IDs (e.g., "11.65" finds "E11.65")
-     * - Typo tolerance on descriptions (not on code IDs)
-     * - Fast response times (~10-50ms)
-     *
-     * **Examples**:
-     * - Query "E11" finds all codes starting with E11 (diabetes codes)
-     * - Query "diabtes" (typo) still finds "diabetes" codes
-     *
-     * **Trade-offs**: Faster than semantic search, but only matches keywords/substrings.
-     * Won't find conceptually related codes with different terminology.
-     *
-     * See also: `/search/semantic` for finding conceptually similar codes.
-     *
-     * Usage of CPT is subject to AMA requirements: see PhenoML Terms of Service.
-     *
-     * @param {string} codesystem - Code system name
-     * @param {phenoml.construe.SearchTextRequest} request
-     * @param {ConstrueClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link phenoml.construe.BadRequestError}
-     * @throws {@link phenoml.construe.UnauthorizedError}
-     * @throws {@link phenoml.construe.NotFoundError}
-     * @throws {@link phenoml.construe.InternalServerError}
-     * @throws {@link phenoml.construe.NotImplementedError}
-     *
-     * @example
-     *     await client.construe.searchText("ICD-10-CM", {
-     *         q: "E11.65",
-     *         version: "version",
-     *         limit: 1
-     *     })
-     */
-    searchText(codesystem, request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__searchText(codesystem, request, requestOptions));
-    }
-    __searchText(codesystem, request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-            const { q, version, limit } = request;
-            const _queryParams = {
-                q,
-                version,
-                limit,
-            };
-            const _authRequest = yield this._options.authProvider.getAuthRequest();
-            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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/${core.url.encodePathParam(codesystem)}/search/text`),
-                method: "GET",
-                headers: _headers,
-                queryString: core.url
-                    .queryBuilder()
-                    .addMany(_queryParams)
-                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
-                    .build(),
-                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,
-                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
-                logging: this._options.logging,
-            });
-            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 404:
-                        throw new phenoml.construe.NotFoundError(_response.error.body, _response.rawResponse);
-                    case 500:
-                        throw new phenoml.construe.InternalServerError(_response.error.body, _response.rawResponse);
-                    case 501:
-                        throw new phenoml.construe.NotImplementedError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.phenomlError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/construe/codes/{codesystem}/search/text");
-        });
-    }
 }
 exports.ConstrueClient = ConstrueClient;