@fhirfly-io/terminology 0.10.0 → 0.11.0

package/dist/index.cjs

@@ -1364,6 +1364,167 @@ var SmaEndpoint = class {
   }
 };
 
+// src/endpoints/hcc.ts
+var HccEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Look up HCC mappings for a single ICD-10 code.
+   *
+   * Returns all HCC category mappings for the given diagnosis code.
+   *
+   * @param icd10Code - ICD-10-CM diagnosis code (e.g., "E11.9")
+   * @param options - Response shape and include options
+   * @returns HCC mapping data (may contain multiple mappings)
+   *
+   * @example
+   * ```ts
+   * const result = await client.hcc.lookup("E11.9");
+   * console.log(result.data); // HCC mapping(s) for Type 2 diabetes
+   * ```
+   */
+  async lookup(icd10Code, options) {
+    return this.http.get(`/v1/hcc/${encodeURIComponent(icd10Code)}`, options);
+  }
+  /**
+   * Look up HCC mappings for multiple ICD-10 codes in a single request.
+   *
+   * @param codes - Array of ICD-10-CM codes (max 100)
+   * @param options - Response shape, include, and batch options
+   * @returns Batch response with HCC mappings for each code
+   */
+  async lookupMany(codes, options) {
+    if (codes.length === 0) throw new ValidationError("codes array must not be empty");
+    if (codes.length > 100) throw new ValidationError(`HCC batch lookup supports max 100 codes, got ${codes.length}`);
+    return this.http.post(
+      "/v1/hcc/_batch",
+      { codes },
+      options
+    );
+  }
+  /**
+   * Reverse lookup: find ICD-10 codes that map to a given HCC category.
+   *
+   * @param ccNumber - HCC condition category number
+   * @param options - Response shape, include, and model filter options
+   * @returns Reverse lookup result with array of ICD-10 codes
+   *
+   * @example
+   * ```ts
+   * // Find all ICD-10 codes that map to HCC 19 (Diabetes)
+   * const result = await client.hcc.reverse(19);
+   * console.log(result.data.icd10_codes);
+   *
+   * // Filter by model
+   * const result = await client.hcc.reverse(19, { model: "CMS-HCC" });
+   * ```
+   */
+  async reverse(ccNumber, options) {
+    const { model, ...lookupOptions } = options ?? {};
+    const endpoint = `/v1/hcc/reverse/${encodeURIComponent(String(ccNumber))}`;
+    if (model) {
+      return this.http.search(endpoint, {
+        model,
+        shape: lookupOptions.shape,
+        include: lookupOptions.include?.join(",")
+      });
+    }
+    return this.http.get(endpoint, lookupOptions);
+  }
+  /**
+   * Search for HCC crosswalk mappings.
+   *
+   * @param params - Search parameters (q, model_version, model_type, cc_number, payment_year)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by ICD-10 code text
+   * const results = await client.hcc.search({ q: "diabetes" });
+   *
+   * // Filter by model version
+   * const results = await client.hcc.search({
+   *   model_version: "V28",
+   *   cc_number: 19
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/hcc/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
+};
+
+// src/endpoints/opcs4.ts
+var Opcs4Endpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Look up a single OPCS-4 procedure code.
+   *
+   * @param code - OPCS-4 procedure code (e.g., "W37.1")
+   * @param options - Response shape and include options
+   * @returns OPCS-4 data
+   *
+   * @example
+   * ```ts
+   * const result = await client.opcs4.lookup("W37.1");
+   * console.log(result.data.display); // Procedure description
+   * ```
+   */
+  async lookup(code, options) {
+    return this.http.get(`/v1/opcs4/${encodeURIComponent(code)}`, options);
+  }
+  /**
+   * Look up multiple OPCS-4 codes in a single request.
+   *
+   * @param codes - Array of OPCS-4 codes (max 100)
+   * @param options - Response shape, include, and batch options
+   * @returns Batch response with results for each code
+   */
+  async lookupMany(codes, options) {
+    if (codes.length === 0) throw new ValidationError("codes array must not be empty");
+    if (codes.length > 100) throw new ValidationError(`OPCS-4 batch lookup supports max 100 codes, got ${codes.length}`);
+    return this.http.post(
+      "/v1/opcs4/_batch",
+      { codes },
+      options
+    );
+  }
+  /**
+   * Search for OPCS-4 procedure codes.
+   *
+   * @param params - Search parameters (q, chapter, category)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search for knee procedures
+   * const results = await client.opcs4.search({ q: "knee replacement" });
+   *
+   * // Filter by chapter
+   * const results = await client.opcs4.search({
+   *   chapter: "W",
+   *   q: "joint"
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/opcs4/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
+};
+
 // src/client.ts
 var Fhirfly = class {
   http;
@@ -1419,6 +1580,16 @@ var Fhirfly = class {
    * State FHIR endpoint implementation status, patient access, and provider directories.
    */
   sma;
+  /**
+   * HCC (Hierarchical Condition Categories) crosswalk lookups.
+   * Map ICD-10 diagnosis codes to CMS risk adjustment categories.
+   */
+  hcc;
+  /**
+   * OPCS-4 (Office of Population Censuses and Surveys) procedure code lookups.
+   * UK NHS procedural coding system.
+   */
+  opcs4;
   /**
    * Create a new FHIRfly client.
    *
@@ -1468,6 +1639,8 @@ var Fhirfly = class {
     this.snomed = new SnomedEndpoint(this.http);
     this.claims = new ClaimsEndpoint(this.http);
     this.sma = new SmaEndpoint(this.http);
+    this.hcc = new HccEndpoint(this.http);
+    this.opcs4 = new Opcs4Endpoint(this.http);
   }
 };
 
@@ -1475,8 +1648,10 @@ exports.ApiError = ApiError;
 exports.AuthenticationError = AuthenticationError;
 exports.Fhirfly = Fhirfly;
 exports.FhirflyError = FhirflyError;
+exports.HccEndpoint = HccEndpoint;
 exports.NetworkError = NetworkError;
 exports.NotFoundError = NotFoundError;
+exports.Opcs4Endpoint = Opcs4Endpoint;
 exports.QuotaExceededError = QuotaExceededError;
 exports.RateLimitError = RateLimitError;
 exports.ServerError = ServerError;