phenoml 1.0.1 → 1.1.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": "1.0.1",
-                "User-Agent": "phenoml/1.0.1",
+                "X-Fern-SDK-Version": "1.1.0",
+                "User-Agent": "phenoml/1.1.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

@@ -52,5 +52,134 @@ export declare class Construe {
      */
     extractCodes(request: phenoml.construe.ExtractRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ExtractCodesResult>;
     private __extractCodes;
+    /**
+     * Returns metadata about all available code systems including built-in and custom systems.
+     *
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.listAvailableCodeSystems()
+     */
+    listAvailableCodeSystems(requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ListCodeSystemsResponse>;
+    private __listAvailableCodeSystems;
+    /**
+     * Returns a paginated list of all codes in the specified code system.
+     *
+     * @param {string} codesystem - Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
+     * @param {phenoml.construe.GetConstrueCodesCodesystemRequest} request
+     * @param {Construe.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.listCodesInACodeSystem("ICD-10-CM", {
+     *         version: "2025",
+     *         cursor: "cursor",
+     *         limit: 1
+     *     })
+     */
+    listCodesInACodeSystem(codesystem: string, request?: phenoml.construe.GetConstrueCodesCodesystemRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.ListCodesResponse>;
+    private __listCodesInACodeSystem;
+    /**
+     * Returns details for a specific code within a code system.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {string} codeId - The code identifier
+     * @param {phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest} request
+     * @param {Construe.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.getASpecificCode("ICD-10-CM", "E11.65", {
+     *         version: "version"
+     *     })
+     */
+    getASpecificCode(codesystem: string, codeId: string, request?: phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.GetCodeResponse>;
+    private __getASpecificCode;
+    /**
+     * Performs semantic similarity search using vector embeddings.
+     *
+     * **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.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchSemanticRequest} request
+     * @param {Construe.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.semanticSearchEmbeddingBased("ICD-10-CM", {
+     *         text: "patient has trouble breathing at night and wakes up gasping",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    semanticSearchEmbeddingBased(codesystem: string, request: phenoml.construe.GetConstrueCodesCodesystemSearchSemanticRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.SemanticSearchResponse>;
+    private __semanticSearchEmbeddingBased;
+    /**
+     * Performs fast full-text search over code IDs and descriptions.
+     *
+     * **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.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchTextRequest} request
+     * @param {Construe.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}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.construe.textSearchKeywordBased("ICD-10-CM", {
+     *         q: "E11.65",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    textSearchKeywordBased(codesystem: string, request: phenoml.construe.GetConstrueCodesCodesystemSearchTextRequest, requestOptions?: Construe.RequestOptions): core.HttpResponsePromise<phenoml.construe.TextSearchResponse>;
+    private __textSearchKeywordBased;
     protected _getAuthorizationHeader(): Promise<string>;
 }

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

@@ -210,6 +210,435 @@ class Construe {
             }
         });
     }
+    /**
+     * Returns metadata about all available code systems including built-in and custom systems.
+     *
+     * @param {Construe.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link phenoml.construe.UnauthorizedError}
+     * @throws {@link phenoml.construe.InternalServerError}
+     *
+     * @example
+     *     await client.construe.listAvailableCodeSystems()
+     */
+    listAvailableCodeSystems(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listAvailableCodeSystems(requestOptions));
+    }
+    __listAvailableCodeSystems(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            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"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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 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,
+                        });
+                }
+            }
+            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.");
+                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.
+     *
+     * @param {string} codesystem - Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
+     * @param {phenoml.construe.GetConstrueCodesCodesystemRequest} request
+     * @param {Construe.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.listCodesInACodeSystem("ICD-10-CM", {
+     *         version: "2025",
+     *         cursor: "cursor",
+     *         limit: 1
+     *     })
+     */
+    listCodesInACodeSystem(codesystem, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listCodesInACodeSystem(codesystem, request, requestOptions));
+    }
+    __listCodesInACodeSystem(codesystem_1) {
+        return __awaiter(this, arguments, void 0, function* (codesystem, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { version, cursor, limit } = request;
+            const _queryParams = {};
+            if (version != null) {
+                _queryParams.version = version;
+            }
+            if (cursor != null) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            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/${core.url.encodePathParam(codesystem)}`),
+                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 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,
+                        });
+                }
+            }
+            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/{codesystem}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Returns details for a specific code within a code system.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {string} codeId - The code identifier
+     * @param {phenoml.construe.GetConstrueCodesCodesystemCodeIdRequest} request
+     * @param {Construe.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.getASpecificCode("ICD-10-CM", "E11.65", {
+     *         version: "version"
+     *     })
+     */
+    getASpecificCode(codesystem, codeId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getASpecificCode(codesystem, codeId, request, requestOptions));
+    }
+    __getASpecificCode(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;
+            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/${core.url.encodePathParam(codesystem)}/${core.url.encodePathParam(codeId)}`),
+                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 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,
+                        });
+                }
+            }
+            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/{codesystem}/{codeID}.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Performs semantic similarity search using vector embeddings.
+     *
+     * **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.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchSemanticRequest} request
+     * @param {Construe.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.semanticSearchEmbeddingBased("ICD-10-CM", {
+     *         text: "patient has trouble breathing at night and wakes up gasping",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    semanticSearchEmbeddingBased(codesystem, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__semanticSearchEmbeddingBased(codesystem, request, requestOptions));
+    }
+    __semanticSearchEmbeddingBased(codesystem, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { text, version, limit } = request;
+            const _queryParams = {};
+            _queryParams.text = text;
+            if (version != null) {
+                _queryParams.version = version;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            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/${core.url.encodePathParam(codesystem)}/search/semantic`),
+                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 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,
+                        });
+                }
+            }
+            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/{codesystem}/search/semantic.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Performs fast full-text search over code IDs and descriptions.
+     *
+     * **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.
+     *
+     * @param {string} codesystem - Code system name
+     * @param {phenoml.construe.GetConstrueCodesCodesystemSearchTextRequest} request
+     * @param {Construe.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}
+     * @throws {@link phenoml.construe.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.construe.textSearchKeywordBased("ICD-10-CM", {
+     *         q: "E11.65",
+     *         version: "version",
+     *         limit: 1
+     *     })
+     */
+    textSearchKeywordBased(codesystem, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__textSearchKeywordBased(codesystem, request, requestOptions));
+    }
+    __textSearchKeywordBased(codesystem, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { q, version, limit } = request;
+            const _queryParams = {};
+            _queryParams.q = q;
+            if (version != null) {
+                _queryParams.version = version;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            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/${core.url.encodePathParam(codesystem)}/search/text`),
+                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 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);
+                    case 503:
+                        throw new phenoml.construe.ServiceUnavailableError(_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/{codesystem}/search/text.");
+                case "unknown":
+                    throw new errors.phenomlError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             return `Bearer ${yield core.Supplier.get(this._options.token)}`;

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         version: "version"
+ *     }
+ */
+export interface GetConstrueCodesCodesystemCodeIdRequest {
+    /** Specific version of the code system */
+    version?: string;
+}

package/dist/cjs/api/resources/construe/client/requests/GetConstrueCodesCodesystemCodeIdRequest.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/GetConstrueCodesCodesystemRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         version: "2025",
+ *         cursor: "cursor",
+ *         limit: 1
+ *     }
+ */
+export interface GetConstrueCodesCodesystemRequest {
+    /** Specific version of the code system. Required if multiple versions exist. */
+    version?: string;
+    /** Pagination cursor from previous response */
+    cursor?: string;
+    /** Maximum number of codes to return (default 20) */
+    limit?: number;
+}

package/dist/cjs/api/resources/construe/client/requests/GetConstrueCodesCodesystemRequest.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/GetConstrueCodesCodesystemSearchSemanticRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         text: "patient has trouble breathing at night and wakes up gasping",
+ *         version: "version",
+ *         limit: 1
+ *     }
+ */
+export interface GetConstrueCodesCodesystemSearchSemanticRequest {
+    /** Natural language text to find semantically similar codes for */
+    text: string;
+    /** Specific version of the code system */
+    version?: string;
+    /** Maximum number of results (default 10, max 50) */
+    limit?: number;
+}

package/dist/cjs/api/resources/construe/client/requests/GetConstrueCodesCodesystemSearchSemanticRequest.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/GetConstrueCodesCodesystemSearchTextRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         q: "E11.65",
+ *         version: "version",
+ *         limit: 1
+ *     }
+ */
+export interface GetConstrueCodesCodesystemSearchTextRequest {
+    /** Search query (searches code IDs and descriptions) */
+    q: string;
+    /** Specific version of the code system */
+    version?: string;
+    /** Maximum number of results (default 20, max 100) */
+    limit?: number;
+}