@fhirfly-io/terminology 0.7.1 → 0.8.1

package/README.md

@@ -1,6 +1,6 @@
 # @fhirfly-io/terminology
 
-Official FHIRfly SDK for Node.js — typed access to healthcare reference data APIs (NDC, NPI, LOINC, RxNorm, ICD-10, CVX, MVX, FDA Labels).
+Official FHIRfly SDK for Node.js — typed access to healthcare reference data APIs.
 
 [![npm version](https://img.shields.io/npm/v/@fhirfly-io/terminology.svg)](https://www.npmjs.com/package/@fhirfly-io/terminology)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -20,7 +20,7 @@ const client = new Fhirfly({ apiKey: "your-api-key" });
 
 // Look up a drug by NDC
 const ndc = await client.ndc.lookup("0069-0151-01");
-console.log(ndc.data.product_name); // "Lipitor"
+console.log(ndc.data.brand_name); // "Lipitor"
 
 // Look up a provider by NPI
 const npi = await client.npi.lookup("1234567890");
@@ -30,20 +30,22 @@ console.log(npi.data.name);
 ## Features
 
 - **Full TypeScript support** with comprehensive type definitions
-- **All FHIRfly APIs**: NDC, NPI, RxNorm, LOINC, ICD-10, CVX, MVX, FDA Labels
+- **11 healthcare domains**: NDC, NPI, RxNorm, LOINC, ICD-10, CVX, MVX, FDA Labels, SNOMED CT, Connectivity, Claims
+- **Search** with full-text queries, filters, facets, and pagination
 - **Batch lookups** for efficient bulk operations
 - **Response shapes**: compact, standard, or full detail levels
+- **Two auth modes**: API key (simple) and OAuth2 client credentials (secure)
 - **Automatic retries** with exponential backoff
 - **Detailed error types** for proper error handling
-- **Designed for both human developers and programmatic agents**
+- **Zero runtime dependencies**
 
-## API Reference
+## Authentication
 
-### Client Configuration
+### API Key (Simple)
 
 ```typescript
 const client = new Fhirfly({
-  apiKey: "your-api-key",      // Required
+  apiKey: "ffly_sk_live_...",
   baseUrl: "https://api.fhirfly.io", // Optional, default shown
   timeout: 30000,              // Optional, request timeout in ms
   maxRetries: 3,               // Optional, retry attempts
@@ -51,6 +53,21 @@ const client = new Fhirfly({
 });
 ```
 
+### OAuth2 Client Credentials (Secure)
+
+```typescript
+const client = new Fhirfly({
+  clientId: "ffly_client_...",
+  clientSecret: "ffly_secret_...",
+  scopes: ["ndc.read", "npi.read"], // Optional
+  tokenUrl: "https://api.fhirfly.io/oauth2/token", // Optional, default shown
+});
+```
+
+OAuth2 tokens are cached and automatically refreshed before expiry.
+
+## API Reference
+
 ### NDC (National Drug Codes)
 
 ```typescript
@@ -70,13 +87,20 @@ const results = await client.ndc.lookupMany([
 ]);
 
 for (const item of results.results) {
-  if (item.found) {
-    console.log(item.data.product_name);
+  if (item.status === "ok") {
+    console.log(item.data.brand_name);
   }
 }
+
+// Search
+const results = await client.ndc.search({
+  q: "advil",
+  dosage_form: "TABLET",
+  is_active: true,
+});
 ```
 
-Batch lookups return per-item results and never throw for individual misses.
+Batch lookups return per-item results and never throw for individual misses. Each item has `status: "ok" | "not_found" | "invalid"`.
 
 ### NPI (National Provider Identifiers)
 
@@ -84,8 +108,17 @@ Batch lookups return per-item results and never throw for individual misses.
 // Single lookup
 const npi = await client.npi.lookup("1234567890");
 
-// Batch lookup
+// Batch lookup (up to 100)
 const results = await client.npi.lookupMany(["1234567890", "0987654321"]);
+
+// Search for providers
+const results = await client.npi.search({
+  q: "smith",
+  specialty: "cardiology",
+  state: "CA",
+  entity_type: "individual",
+});
+console.log(`Found ${results.total} providers`);
 ```
 
 ### RxNorm
@@ -94,6 +127,12 @@ const results = await client.npi.lookupMany(["1234567890", "0987654321"]);
 // Look up by RxCUI
 const rx = await client.rxnorm.lookup("213169");
 console.log(rx.data.name); // "atorvastatin 10 MG Oral Tablet"
+
+// Search for drugs
+const results = await client.rxnorm.search({
+  ingredient: "metformin",
+  is_prescribable: true,
+});
 ```
 
 ### LOINC
@@ -101,28 +140,50 @@ console.log(rx.data.name); // "atorvastatin 10 MG Oral Tablet"
 ```typescript
 // Look up lab code
 const loinc = await client.loinc.lookup("2345-7");
-console.log(loinc.data.long_common_name);
+console.log(loinc.data.display_name);
+
+// Search
+const results = await client.loinc.search({
+  q: "glucose",
+  class: "CHEM",
+  system: "Bld",
+});
 ```
 
 ### ICD-10
 
+The API auto-detects CM (diagnoses) vs PCS (procedures) based on code format.
+
 ```typescript
-// ICD-10-CM (diagnoses)
-const diagnosis = await client.icd10.lookupCm("E11.9");
+// Diagnosis code (CM)
+const diagnosis = await client.icd10.lookup("E11.9");
+console.log(diagnosis.data.display); // "Type 2 diabetes mellitus without complications"
+
+// Procedure code (PCS)
+const procedure = await client.icd10.lookup("02HA0QZ");
 
-// ICD-10-PCS (procedures)
-const procedure = await client.icd10.lookupPcs("0BJ08ZZ");
+// Batch lookup (mix of CM and PCS, up to 100)
+const results = await client.icd10.lookupMany(["E11.9", "I10", "02HA0QZ"]);
 
-// Batch lookups
-const cmResults = await client.icd10.lookupCmMany(["E11.9", "I10"]);
-const pcsResults = await client.icd10.lookupPcsMany(["0BJ08ZZ"]);
+// Search
+const results = await client.icd10.search({
+  q: "diabetes",
+  code_system: "CM",
+  billable: true,
+});
 ```
 
 ### CVX (Vaccine Codes)
 
 ```typescript
 const cvx = await client.cvx.lookup("208");
-console.log(cvx.data.short_description);
+console.log(cvx.data.display);
+
+// Search for COVID vaccines
+const results = await client.cvx.search({
+  is_covid_vaccine: true,
+  status: "active",
+});
 ```
 
 ### MVX (Vaccine Manufacturers)
@@ -130,33 +191,149 @@ console.log(cvx.data.short_description);
 ```typescript
 const mvx = await client.mvx.lookup("PFR");
 console.log(mvx.data.manufacturer_name); // "Pfizer, Inc"
+
+const results = await client.mvx.search({ q: "pfizer" });
 ```
 
 ### FDA Labels
 
 ```typescript
-// By Set ID
-const label = await client.fdaLabels.lookup("set-id-here");
+// Look up by Set ID, NDC, or RxCUI (auto-detected)
+const label = await client.fdaLabels.lookup("0069-0151-01");
+
+// With safety sections
+const label = await client.fdaLabels.lookup("0069-0151-01", {
+  bundle: "safety",
+});
+
+// With specific sections
+const label = await client.fdaLabels.lookup("0069-0151-01", {
+  sections: ["boxed_warning", "dosage_and_administration"],
+});
+
+// Batch (up to 50, metadata only)
+const results = await client.fdaLabels.lookupMany(["0069-0151-01", "0002-1433-80"]);
+
+// Search
+const results = await client.fdaLabels.search({
+  substance: "acetaminophen",
+  product_type: "otc",
+});
+```
+
+### SNOMED CT (IPS)
+
+Access to ~12,000 curated clinical concepts from the SNOMED CT IPS (International Patient Set), licensed under CC BY 4.0.
+
+```typescript
+// Look up a concept
+const concept = await client.snomed.lookup("73211009");
+console.log(concept.data.preferred_term); // "Diabetes mellitus"
+
+// Batch lookup (up to 100)
+const results = await client.snomed.lookupMany(["73211009", "38341003"]);
+
+// Search by category
+const results = await client.snomed.search({
+  q: "diabetes",
+  ips_category: "condition",
+});
+
+// List all IPS categories
+const categories = await client.snomed.categories();
+
+// Reverse mappings (what ICD-10/RxNorm/NDC codes map to this concept?)
+const mappings = await client.snomed.mappings("73211009");
+```
+
+### Connectivity Intelligence
+
+Discover how to reach a provider's organization electronically — FHIR endpoints, Direct addresses, and more.
+
+```typescript
+// Look up connectivity options for a provider
+const conn = await client.connectivity.lookup("1234567890");
+
+console.log(conn.provider_summary.name);
 
-// By NDC
-const label = await client.fdaLabels.lookupByNdc("0069-0151-01");
+for (const target of conn.connectivity_targets) {
+  console.log(`${target.name} (${target.type})`);
+  for (const ep of target.endpoints) {
+    console.log(`  ${ep.type}: ${ep.url} [${ep.status}]`);
+  }
+}
+```
+
+### Claims Intelligence
+
+CMS claims editing and payment data. Requires the `claims.read` scope.
+
+```typescript
+// NCCI PTP: Can these codes be billed together?
+const ncci = await client.claims.validateNcci("99213", "99214");
+console.log(ncci.data.can_bill_together); // true/false
+console.log(ncci.data.summary);
+
+// MUE: Maximum units for a code
+const mue = await client.claims.lookupMue("99213");
+for (const limit of mue.data.limits) {
+  console.log(`${limit.service_type}: max ${limit.mue_value} units`);
+}
+
+// Batch MUE (up to 100 codes)
+const mueResults = await client.claims.lookupMueMany(["99213", "99214"]);
+
+// PFS/RVU: Fee schedule and relative value units
+const pfs = await client.claims.lookupPfs("99213");
+console.log(`Work RVU: ${pfs.data.rvu.work}`);
+console.log(`Non-facility payment: $${pfs.data.calculated_payment.non_facility}`);
+
+// Batch PFS (up to 100 codes)
+const pfsResults = await client.claims.lookupPfsMany(["99213", "99214", "99215"]);
+
+// LCD/NCD Coverage determination
+const coverage = await client.claims.checkCoverage("99213");
+console.log(`${coverage.data.policies_found} coverage policies found`);
 ```
 
 ## Response Shapes
 
-All lookup methods accept a `shape` option to control response detail:
+All lookup and search methods accept a `shape` option to control response detail:
 
 | Shape | Description |
 |-------|-------------|
-| `compact` | Minimal fields for quick lookups |
-| `standard` | Balanced detail (default) |
-| `full` | Complete data with all available fields |
+| `compact` | Minimal fields for quick lookups and autocomplete |
+| `standard` | Balanced detail (default for REST) |
+| `full` | Complete data with provenance (default for MCP/agents) |
 
 ```typescript
-// Get full details
 const ndc = await client.ndc.lookup("0069-0151-01", { shape: "full" });
 ```
 
+**Exceptions**: SNOMED always returns full data (no shapes). FDA Labels lookup uses a metadata + sections model instead of shapes; search uses shapes.
+
+## Search
+
+All endpoints except Connectivity support full-text search with filters, facets, and pagination:
+
+```typescript
+const results = await client.ndc.search(
+  { q: "advil", is_active: true },        // Search params
+  { shape: "compact", limit: 50, page: 1 } // Options
+);
+
+console.log(`${results.total} results, page ${results.page}`);
+console.log(results.facets); // Facet counts for filtering
+
+for (const item of results.items) {
+  console.log(item.name);
+}
+
+if (results.has_more) {
+  // Fetch next page...
+}
+```
+
 ## Error Handling
 
 The SDK provides typed errors for different failure scenarios:

package/dist/index.cjs

@@ -171,7 +171,7 @@ var HttpClient = class {
       timeout: config.timeout ?? 3e4,
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
-      userAgent: config.userAgent ?? `@fhirfly/sdk/0.1.0 Node.js/${process.version}`
+      userAgent: config.userAgent ?? `@fhirfly-io/terminology/0.7.1 Node.js/${process.version}`
     };
   }
   /**
@@ -308,7 +308,7 @@ var HttpClient = class {
           if (response.status === 429) {
             const retryAfter = response.headers.get("retry-after");
             if (retryAfter && attempt < this.config.maxRetries) {
-              await this.sleep(parseInt(retryAfter, 10) * 1e3);
+              await this.sleep(Math.min(parseInt(retryAfter, 10) * 1e3, 12e4));
               continue;
             }
             await this.parseErrorResponse(response, endpoint);
@@ -387,7 +387,7 @@ var NdcEndpoint = class {
    * @example
    * ```ts
    * const ndc = await client.ndc.lookup("0069-0151-01");
-   * console.log(ndc.data.product_name); // "Lipitor"
+   * console.log(ndc.data.brand_name); // "Lipitor"
    * ```
    */
   async lookup(code, options) {
@@ -409,15 +409,17 @@ var NdcEndpoint = class {
    * ]);
    *
    * for (const item of results.results) {
-   *   if (item.found) {
-   *     console.log(item.data.product_name);
+   *   if (item.status === "ok") {
+   *     console.log(item.data.brand_name);
    *   } else {
-   *     console.log(`Not found: ${item.code}`);
+   *     console.log(`Not found: ${item.input}`);
    *   }
    * }
    * ```
    */
   async lookupMany(codes, options) {
+    if (codes.length === 0) throw new ValidationError("codes array must not be empty");
+    if (codes.length > 500) throw new ValidationError(`NDC batch lookup supports max 500 codes, got ${codes.length}`);
     return this.http.post(
       "/v1/ndc/_batch",
       { codes },
@@ -482,7 +484,7 @@ var NpiEndpoint = class {
   /**
    * Look up multiple NPIs in a single request.
    *
-   * @param npis - Array of 10-digit NPI numbers (max 500)
+   * @param npis - Array of 10-digit NPI numbers (max 100)
    * @param options - Response shape, include, and batch options
    * @returns Batch response with results for each NPI
    *
@@ -495,6 +497,8 @@ var NpiEndpoint = class {
    * ```
    */
   async lookupMany(npis, options) {
+    if (npis.length === 0) throw new ValidationError("npis array must not be empty");
+    if (npis.length > 100) throw new ValidationError(`NPI batch lookup supports max 100 codes, got ${npis.length}`);
     return this.http.post(
       "/v1/npi/_batch",
       { codes: npis },
@@ -556,11 +560,13 @@ var RxNormEndpoint = class {
   /**
    * Look up multiple RxCUIs in a single request.
    *
-   * @param rxcuis - Array of RxCUIs (max 500)
+   * @param rxcuis - Array of RxCUIs (max 100)
    * @param options - Response shape, include, and batch options
    * @returns Batch response with results for each RxCUI
    */
   async lookupMany(rxcuis, options) {
+    if (rxcuis.length === 0) throw new ValidationError("rxcuis array must not be empty");
+    if (rxcuis.length > 100) throw new ValidationError(`RxNorm batch lookup supports max 100 codes, got ${rxcuis.length}`);
     return this.http.post(
       "/v1/rxnorm/_batch",
       { codes: rxcuis },
@@ -619,11 +625,13 @@ var LoincEndpoint = class {
   /**
    * Look up multiple LOINC codes in a single request.
    *
-   * @param loincNums - Array of LOINC numbers (max 500)
+   * @param loincNums - Array of LOINC numbers (max 100)
    * @param options - Response shape, include, and batch options
    * @returns Batch response with results for each LOINC
    */
   async lookupMany(loincNums, options) {
+    if (loincNums.length === 0) throw new ValidationError("loincNums array must not be empty");
+    if (loincNums.length > 100) throw new ValidationError(`LOINC batch lookup supports max 100 codes, got ${loincNums.length}`);
     return this.http.post(
       "/v1/loinc/_batch",
       { codes: loincNums },
@@ -693,11 +701,13 @@ var Icd10Endpoint = class {
    *
    * Codes can be a mix of CM (diagnoses) and PCS (procedures).
    *
-   * @param codes - Array of ICD-10 codes (max 500)
+   * @param codes - Array of ICD-10 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(`ICD-10 batch lookup supports max 100 codes, got ${codes.length}`);
     return this.http.post(
       "/v1/icd10/_batch",
       { codes },
@@ -760,11 +770,13 @@ var CvxEndpoint = class {
   /**
    * Look up multiple CVX codes in a single request.
    *
-   * @param cvxCodes - Array of CVX codes (max 500)
+   * @param cvxCodes - Array of CVX codes (max 100)
    * @param options - Response shape, include, and batch options
    * @returns Batch response with results for each code
    */
   async lookupMany(cvxCodes, options) {
+    if (cvxCodes.length === 0) throw new ValidationError("cvxCodes array must not be empty");
+    if (cvxCodes.length > 100) throw new ValidationError(`CVX batch lookup supports max 100 codes, got ${cvxCodes.length}`);
     return this.http.post(
       "/v1/cvx/_batch",
       { codes: cvxCodes },
@@ -823,11 +835,13 @@ var MvxEndpoint = class {
   /**
    * Look up multiple MVX codes in a single request.
    *
-   * @param mvxCodes - Array of MVX codes (max 500)
+   * @param mvxCodes - Array of MVX codes (max 100)
    * @param options - Response shape, include, and batch options
    * @returns Batch response with results for each code
    */
   async lookupMany(mvxCodes, options) {
+    if (mvxCodes.length === 0) throw new ValidationError("mvxCodes array must not be empty");
+    if (mvxCodes.length > 100) throw new ValidationError(`MVX batch lookup supports max 100 codes, got ${mvxCodes.length}`);
     return this.http.post(
       "/v1/mvx/_batch",
       { codes: mvxCodes },
@@ -909,10 +923,12 @@ var FdaLabelsEndpoint = class {
    * Returns metadata only (no sections) for batch efficiency.
    * Identifiers can be Set IDs, NDC codes, or RxCUIs (mixed).
    *
-   * @param identifiers - Array of identifiers (max 500)
+   * @param identifiers - Array of identifiers (max 50)
    * @returns Batch response with results for each identifier
    */
   async lookupMany(identifiers) {
+    if (identifiers.length === 0) throw new ValidationError("identifiers array must not be empty");
+    if (identifiers.length > 50) throw new ValidationError(`FDA Labels batch lookup supports max 50 identifiers, got ${identifiers.length}`);
     return this.http.post(
       "/v1/fda-label/_batch",
       { codes: identifiers }
@@ -1034,6 +1050,8 @@ var SnomedEndpoint = class {
    * ```
    */
   async lookupMany(conceptIds) {
+    if (conceptIds.length === 0) throw new ValidationError("conceptIds array must not be empty");
+    if (conceptIds.length > 100) throw new ValidationError(`SNOMED batch lookup supports max 100 codes, got ${conceptIds.length}`);
     return this.http.post(
       "/v1/snomed/_batch",
       { codes: conceptIds }
@@ -1100,6 +1118,168 @@ var SnomedEndpoint = class {
   }
 };
 
+// src/endpoints/claims.ts
+var ClaimsEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ==========================================================================
+  // NCCI PTP Edits
+  // ==========================================================================
+  /**
+   * Validate whether two CPT/HCPCS codes can be billed together.
+   *
+   * @param code1 - First CPT/HCPCS code (4-5 alphanumeric characters)
+   * @param code2 - Second CPT/HCPCS code (4-5 alphanumeric characters)
+   * @param options - Optional filters (claim_type)
+   * @returns Validation result with edit details and billing summary
+   *
+   * @example
+   * ```ts
+   * const result = await client.claims.validateNcci("99213", "99214");
+   * if (!result.data.can_bill_together) {
+   *   console.log(result.data.summary);
+   *   for (const edit of result.data.edits) {
+   *     console.log(`${edit.claim_type}: modifier ${edit.modifier_allowed ? "allowed" : "not allowed"}`);
+   *   }
+   * }
+   * ```
+   */
+  async validateNcci(code1, code2, options) {
+    const params = {
+      code1: encodeURIComponent(code1),
+      code2: encodeURIComponent(code2)
+    };
+    if (options?.claim_type) {
+      params.claim_type = options.claim_type;
+    }
+    const queryString = this.http.buildSearchQueryString(params);
+    return this.http.get(`/v1/ncci/validate${queryString}`);
+  }
+  // ==========================================================================
+  // MUE (Medically Unlikely Edits)
+  // ==========================================================================
+  /**
+   * Look up MUE limits for a HCPCS/CPT code.
+   *
+   * @param hcpcs - HCPCS/CPT code (4-5 alphanumeric characters)
+   * @param options - Optional filters (service_type)
+   * @returns MUE limit data including max units per service type
+   *
+   * @example
+   * ```ts
+   * const mue = await client.claims.lookupMue("99213");
+   * for (const limit of mue.data.limits) {
+   *   console.log(`${limit.service_type}: max ${limit.mue_value} units`);
+   * }
+   * ```
+   */
+  async lookupMue(hcpcs, options) {
+    const params = {};
+    if (options?.service_type) {
+      params.service_type = options.service_type;
+    }
+    const queryString = this.http.buildSearchQueryString(params);
+    return this.http.get(
+      `/v1/mue/${encodeURIComponent(hcpcs)}${queryString}`
+    );
+  }
+  /**
+   * Batch MUE lookup for multiple HCPCS codes.
+   *
+   * @param codes - Array of HCPCS/CPT codes (max 100)
+   * @returns Batch results with per-code MUE limits
+   *
+   * @example
+   * ```ts
+   * const results = await client.claims.lookupMueMany(["99213", "99214", "99215"]);
+   * for (const item of results.results) {
+   *   if (item.status === "ok") {
+   *     console.log(`${item.hcpcs_code}: ${item.data.limits.length} limits`);
+   *   }
+   * }
+   * ```
+   */
+  async lookupMueMany(codes) {
+    if (codes.length === 0) throw new ValidationError("codes array must not be empty");
+    if (codes.length > 100) throw new ValidationError(`MUE batch lookup supports max 100 codes, got ${codes.length}`);
+    return this.http.post("/v1/mue/_batch", { codes });
+  }
+  // ==========================================================================
+  // PFS/RVU (Physician Fee Schedule / Relative Value Units)
+  // ==========================================================================
+  /**
+   * Look up Physician Fee Schedule and RVU data for a HCPCS/CPT code.
+   *
+   * @param hcpcs - HCPCS/CPT code (4-5 alphanumeric characters)
+   * @returns Fee schedule data including RVU breakdown and calculated payments
+   *
+   * @example
+   * ```ts
+   * const pfs = await client.claims.lookupPfs("99213");
+   * console.log(`Description: ${pfs.data.description}`);
+   * console.log(`Work RVU: ${pfs.data.rvu.work}`);
+   * console.log(`Non-facility payment: $${pfs.data.calculated_payment.non_facility}`);
+   * console.log(`Facility payment: $${pfs.data.calculated_payment.facility}`);
+   * ```
+   */
+  async lookupPfs(hcpcs) {
+    return this.http.get(
+      `/v1/pfs/${encodeURIComponent(hcpcs)}`
+    );
+  }
+  /**
+   * Batch PFS/RVU lookup for multiple HCPCS codes.
+   *
+   * @param codes - Array of HCPCS/CPT codes (max 100)
+   * @returns Batch results with per-code fee schedule data
+   *
+   * @example
+   * ```ts
+   * const results = await client.claims.lookupPfsMany(["99213", "99214", "99215"]);
+   * for (const item of results.results) {
+   *   if (item.status === "ok") {
+   *     console.log(`${item.hcpcs_code}: $${item.data.calculated_payment.non_facility}`);
+   *   }
+   * }
+   * ```
+   */
+  async lookupPfsMany(codes) {
+    if (codes.length === 0) throw new ValidationError("codes array must not be empty");
+    if (codes.length > 100) throw new ValidationError(`PFS batch lookup supports max 100 codes, got ${codes.length}`);
+    return this.http.post("/v1/pfs/_batch", { codes });
+  }
+  // ==========================================================================
+  // LCD/NCD Coverage Determination
+  // ==========================================================================
+  /**
+   * Check LCD/NCD coverage determinations linked to a HCPCS code.
+   *
+   * @param hcpcs - HCPCS/CPT code (4-5 alphanumeric characters)
+   * @param options - Optional filters (active only)
+   * @returns Coverage policies linked to the code
+   *
+   * @example
+   * ```ts
+   * const coverage = await client.claims.checkCoverage("99213");
+   * console.log(`${coverage.data.policies_found} policies found`);
+   * for (const policy of coverage.data.policies) {
+   *   console.log(`${policy.display_id}: ${policy.policy_title} [${policy.status}]`);
+   * }
+   * ```
+   */
+  async checkCoverage(hcpcs, options) {
+    const params = {
+      hcpcs: encodeURIComponent(hcpcs)
+    };
+    if (options?.active !== void 0) {
+      params.active = options.active.toString();
+    }
+    const queryString = this.http.buildSearchQueryString(params);
+    return this.http.get(`/v1/coverage/check${queryString}`);
+  }
+};
+
 // src/client.ts
 var Fhirfly = class {
   http;
@@ -1145,6 +1325,11 @@ var Fhirfly = class {
    * Look up clinical concepts from the SNOMED CT IPS free set (~12K concepts, CC BY 4.0).
    */
   snomed;
+  /**
+   * Claims Intelligence endpoints (requires `claims.read` scope).
+   * NCCI PTP validation, MUE limits, PFS/RVU fee schedule, LCD/NCD coverage.
+   */
+  claims;
   /**
    * Create a new FHIRfly client.
    *
@@ -1192,6 +1377,7 @@ var Fhirfly = class {
     this.fdaLabels = new FdaLabelsEndpoint(this.http);
     this.connectivity = new ConnectivityEndpoint(this.http);
     this.snomed = new SnomedEndpoint(this.http);
+    this.claims = new ClaimsEndpoint(this.http);
   }
 };