phenoml 15.0.0 → 17.0.0

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

@@ -0,0 +1,528 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodesClient = void 0;
+const BaseClient_js_1 = require("../../../../../../BaseClient.js");
+const headers_js_1 = require("../../../../../../core/headers.js");
+const core = __importStar(require("../../../../../../core/index.js"));
+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"));
+/**
+ * Extract and search codes within a code system.
+ */
+class CodesClient {
+    constructor(options = {}) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * 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 {CodesClient.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.codes.extract({
+     *         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.codes.extract({
+     *         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.codes.extract({
+     *         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.codes.extract({
+     *         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.codes.extract({
+     *         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
+     *         }
+     *     })
+     */
+    extract(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__extract(request, requestOptions));
+    }
+    __extract(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 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.CodesListRequest} request
+     * @param {CodesClient.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.codes.list("ICD-10-CM", {
+     *         version: "2025",
+     *         cursor: "cursor",
+     *         limit: 1
+     *     })
+     */
+    list(codesystem, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__list(codesystem, request, requestOptions));
+    }
+    __list(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.LookupRequest} request
+     * @param {CodesClient.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.codes.lookup("ICD-10-CM", "E1165", {
+     *         version: "version"
+     *     })
+     */
+    lookup(codesystem, codeID, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__lookup(codesystem, codeID, request, requestOptions));
+    }
+    __lookup(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 {CodesClient.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.codes.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");
+        });
+    }
+    /**
+     * 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 {CodesClient.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.codes.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.CodesClient = CodesClient;

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

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/cjs/api/resources/construe/resources/codes/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);

package/dist/cjs/api/resources/construe/{client/requests/GetConstrueCodesCodesystemRequest.d.ts → resources/codes/client/requests/CodesListRequest.d.ts}

@@ -6,7 +6,7 @@
  *         limit: 1
  *     }
  */
-export interface GetConstrueCodesCodesystemRequest {
+export interface CodesListRequest {
     /** Specific version of the code system. Required if multiple versions exist. */
     version?: string;
     /** Pagination cursor from previous response */

package/dist/cjs/api/resources/construe/{client → resources/codes/client}/requests/ExtractRequest.d.ts

@@ -1,4 +1,4 @@
-import type * as phenoml from "../../../../index.js";
+import type * as phenoml from "../../../../../../index.js";
 /**
  * @example
  *     {

package/dist/{esm/api/resources/construe/client/requests/GetConstrueCodesCodesystemCodeIdRequest.d.mts → cjs/api/resources/construe/resources/codes/client/requests/LookupRequest.d.ts}

@@ -4,7 +4,7 @@
  *         version: "version"
  *     }
  */
-export interface GetConstrueCodesCodesystemCodeIdRequest {
+export interface LookupRequest {
     /** Specific version of the code system */
     version?: string;
 }

package/dist/cjs/api/resources/construe/{client/requests/GetConstrueCodesCodesystemSearchSemanticRequest.d.ts → resources/codes/client/requests/SearchSemanticRequest.d.ts}

@@ -6,7 +6,7 @@
  *         limit: 1
  *     }
  */
-export interface GetConstrueCodesCodesystemSearchSemanticRequest {
+export interface SearchSemanticRequest {
     /** Natural language text to find semantically similar codes for */
     text: string;
     /** Specific version of the code system */

package/dist/{esm/api/resources/construe/client/requests/GetConstrueCodesCodesystemSearchTextRequest.d.mts → cjs/api/resources/construe/resources/codes/client/requests/SearchTextRequest.d.ts}

@@ -6,7 +6,7 @@
  *         limit: 1
  *     }
  */
-export interface GetConstrueCodesCodesystemSearchTextRequest {
+export interface SearchTextRequest {
     /** Search query (searches code IDs and descriptions) */
     q: string;
     /** Specific version of the code system */

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

@@ -0,0 +1,5 @@
+export type { CodesListRequest } from "./CodesListRequest.js";
+export type { ExtractRequest } from "./ExtractRequest.js";
+export type { LookupRequest } from "./LookupRequest.js";
+export type { SearchSemanticRequest } from "./SearchSemanticRequest.js";
+export type { SearchTextRequest } from "./SearchTextRequest.js";

package/dist/cjs/api/resources/construe/resources/codes/exports.d.ts

@@ -0,0 +1,2 @@
+export { CodesClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/cjs/api/resources/{tools/resources/mcpServer/resources/tools → construe/resources/codes}/exports.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolsClient = void 0;
+exports.CodesClient = void 0;
 var Client_js_1 = require("./client/Client.js");
-Object.defineProperty(exports, "ToolsClient", { enumerable: true, get: function () { return Client_js_1.ToolsClient; } });
+Object.defineProperty(exports, "CodesClient", { enumerable: true, get: function () { return Client_js_1.CodesClient; } });
 __exportStar(require("./client/index.js"), exports);

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

@@ -0,0 +1,5 @@
+export * from "./codeSystems/client/requests/index.js";
+export * as codeSystems from "./codeSystems/index.js";
+export * from "./codeSystems/types/index.js";
+export * from "./codes/client/requests/index.js";
+export * as codes from "./codes/index.js";