autoicd-js 0.7.0 → 0.9.0

package/README.md

@@ -18,6 +18,7 @@ Zero dependencies. Works in **Node.js 18+**, **Deno**, **Bun**, and **edge runti
 |---|---|
 | **AI-Powered ICD-10, ICD-11 & ICF Coding** | Clinical NLP extracts diagnoses from free-text notes and maps them to ICD-10-CM, ICD-11, or ICF codes — no manual lookup required |
 | **Chart Audit with HCC Gap Capture** | Find missed HCCs, unsupported codes, and specificity upgrades with RAF-weighted revenue estimates (CMS v22 + v28 PY2026). Every finding carries evidence spans |
+| **Cross-Standard Code Translation** | Map a code between ICD-10, ICD-11, SNOMED CT, UMLS, and ICF in one call. Forward ICD-10 → all other systems, plus reverse ICD-11 → ICD-10 and ICF → ICD-10 |
 | **74,000+ ICD-10-CM Codes** | Full 2025 code set enriched with SNOMED CT synonyms for comprehensive matching |
 | **ICD-11 Support** | Search and look up ICD-11 codes, with full ICD-10 ↔ ICD-11 crosswalk mappings |
 | **ICF Functioning Codes** | Code clinical text to WHO ICF categories, search 1,400+ codes, and access Core Sets for 12+ conditions |
@@ -116,6 +117,42 @@ Default behavior runs all five capabilities. Pass `capabilities: ["hcc"]` to run
 
 Read more about the Audit endpoint at [autoicdapi.com/audit](https://autoicdapi.com/audit).
 
+### Cross-Standard Code Translation
+
+Translate a code between healthcare coding systems in one call. Forward from ICD-10 to ICD-11, SNOMED CT, UMLS, and ICF, plus reverse ICD-11 → ICD-10 and ICF → ICD-10. Built on CMS-published crosswalks, code-level SNOMED / UMLS concept IDs, and WHO ICF Core Sets.
+
+```ts
+const mapping = await autoicd.translate({
+  from: { code: "E11.9", system: "icd10" },
+});
+
+console.log(mapping.mappings.icd11);
+// [{ code: "5A11", description: "Type 2 diabetes mellitus", mapping_type: "equivalent" }]
+console.log(mapping.mappings.snomed);
+// [{ code: "44054006" }, { code: "73211009" }, ...]
+console.log(mapping.mappings.icf);
+// [{ code: "b540", description: "General metabolic functions", component: "b" }, ...]
+```
+
+Narrow the targets when you only need specific systems:
+
+```ts
+const targeted = await autoicd.translate({
+  from: { code: "I50.9", system: "icd10" },
+  to: ["icd11"],
+});
+```
+
+Requested systems that aren't reachable from the source are returned in `unsupported_targets[]` rather than as errors, so clients can request a broad target list and use whatever comes back.
+
+| From | To | Source |
+|------|----|--------|
+| ICD-10-CM | ICD-11, SNOMED, UMLS, ICF | CMS crosswalk + concept refsets + WHO Core Sets |
+| ICD-11 MMS | ICD-10-CM | Reverse CMS crosswalk |
+| ICF | ICD-10-CM | Reverse WHO ICF Core Set index |
+
+Read more about the Translate endpoint at [autoicdapi.com/interop](https://autoicdapi.com/interop).
+
 ### Automated ICD-10 Medical Coding
 
 Extract diagnosis entities from clinical notes and map them to ICD-10-CM codes. Each entity includes ranked candidates with confidence scores, negation status, and context flags.
@@ -216,13 +253,18 @@ for (const mapping of detail.icd11_mappings ?? []) {
 
 ### ICF Functioning Codes
 
-Code clinical text to WHO ICF categories, look up codes, search, and access ICF Core Sets for 12+ conditions.
+Look up WHO ICF categories, search the catalog, and access ICF Core Sets for 12+ conditions. To extract ICF functioning categories from clinical text, pass `includeIcf: true` to `autoicd.code()`; the response includes `icf_entities` alongside the ICD-10 results.
 
 ```typescript
-// Code clinical text to ICF categories
-const icf = await client.icf.code("Patient with stroke and hemiplegia");
-console.log(icf.results[0].codes);
-// [{ code: "b730", description: "Muscle power functions", component: "b", ... }]
+// Extract ICF functioning categories during ICD-10 coding
+const result = await client.code(
+  "Patient with stroke and hemiplegia",
+  { includeIcf: true }
+);
+for (const entity of result.icf_entities ?? []) {
+  console.log(entity.entity_text, entity.codes[0]?.code);
+  // "hemiplegia" "b730"
+}
 
 // Look up an ICF code
 const code = await client.icf.lookup("d450");
@@ -234,7 +276,7 @@ const results = await client.icf.search("mobility");
 
 // Get ICF Core Set for a diagnosis
 const coreSet = await client.icf.coreSet("E11.9");
-console.log(coreSet.conditionName); // "Diabetes Mellitus"
+console.log(coreSet.condition_name); // "Diabetes Mellitus"
 console.log(coreSet.brief); // [{ code: "b530", title: "Weight maintenance functions", ... }]
 ```
 
@@ -352,7 +394,6 @@ Full REST API documentation at [autoicdapi.com/docs](https://autoicdapi.com/docs
 | `autoicd.icd10.get(code)` | Get details for an ICD-10-CM code (incl. ICD-11 crosswalk) |
 | `autoicd.icd11.search(query, options?)` | Search ICD-11 codes by description |
 | `autoicd.icd11.get(code)` | Get details for an ICD-11 code (incl. ICD-10 crosswalk) |
-| `autoicd.icf.code(text, options?)` | Code clinical text to ICF functioning categories |
 | `autoicd.icf.lookup(code)` | Get details for an ICF code |
 | `autoicd.icf.search(query, options?)` | Search ICF codes by keyword |
 | `autoicd.icf.coreSet(icd10Code)` | Get ICF Core Set for an ICD-10 diagnosis |
@@ -378,7 +419,6 @@ import type {
   ICD11CodeDetailFull,
   ICD11CodeSearchResponse,
   CrosswalkMapping,
-  ICFCodingResponse,
   ICFCodeDetail,
   ICFCodeSearchResponse,
   ICFCoreSetResponse,

package/dist/index.d.mts

@@ -299,16 +299,6 @@ interface ICFCodingEntity {
     /** Ranked ICF code candidates. */
     codes: ICFCodeResult[];
 }
-interface ICFCodingResponse {
-    /** The input text that was processed. */
-    text: string;
-    /** Coding provider used. */
-    provider: string;
-    /** Total number of entities in results. */
-    entity_count: number;
-    /** Coding results per entity. */
-    results: ICFCodingEntity[];
-}
 interface ICFSearchResponse {
     /** The search query that was used. */
     query: string;
@@ -570,6 +560,38 @@ interface AuditResponse {
     rates_used: RatesUsed;
     upgrade_hint?: UpgradeHint;
 }
+/**
+ * Healthcare coding systems supported by `/v1/translate`.
+ * Current reachable mappings (forward):
+ * - `icd10` → `icd11` / `snomed` / `umls` / `icf`
+ * - `icd11` → `icd10`
+ * - `icf`   → `icd10`
+ */
+type InteropSystem = "icd10" | "icd11" | "snomed" | "umls" | "icf";
+interface TranslateRequest {
+    from: {
+        code: string;
+        system: InteropSystem;
+    };
+    to?: InteropSystem[];
+}
+interface TranslateMapping {
+    code: string;
+    description?: string;
+    mapping_type?: string;
+    component?: string;
+}
+interface TranslateSource {
+    code: string;
+    system: InteropSystem;
+    description?: string;
+}
+interface TranslateResponse {
+    from: TranslateSource;
+    mappings: Partial<Record<InteropSystem, TranslateMapping[]>>;
+    unsupported_targets: InteropSystem[];
+    provider: string;
+}
 
 declare class AutoICD {
     private readonly apiKey;
@@ -629,6 +651,21 @@ declare class AutoICD {
      * ```
      */
     audit(request: AuditRequest): Promise<AuditResponse>;
+    /**
+     * Translate a code between healthcare coding systems. Maps a source code
+     * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target
+     * systems. Omit `to` to get every system reachable from the source.
+     *
+     * @example
+     * ```ts
+     * const result = await autoicd.translate({
+     *   from: { code: "E11.9", system: "icd10" },
+     * });
+     * console.log(result.mappings.icd11);
+     * console.log(result.mappings.snomed);
+     * ```
+     */
+    translate(request: TranslateRequest): Promise<TranslateResponse>;
     /** @internal */
     get<T>(path: string): Promise<T>;
     /** @internal */
@@ -691,20 +728,6 @@ declare class ICD11Codes {
 declare class ICFCodes {
     private readonly client;
     constructor(client: AutoICD);
-    /**
-     * Code clinical text to ICF codes.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.icf.code("Patient has difficulty walking");
-     * for (const entity of result.results) {
-     *   console.log(entity.entity_text, entity.codes[0]?.code);
-     * }
-     * ```
-     */
-    code(text: string, options?: {
-        topK?: number;
-    }): Promise<ICFCodingResponse>;
     /**
      * Get full details for a single ICF code, including definition,
      * hierarchy (parent/children), inclusions, exclusions, and index terms.
@@ -798,4 +821,4 @@ declare class NotFoundError extends AutoICDError {
     constructor(message?: string);
 }
 
-export { type AnonymizeResponse, type AuditCapability, type AuditCode, type AuditContext, type AuditDocument, type AuditRequest, type AuditResponse, type AuditTotals, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodingEntity, type CodingResponse, type ConfirmedCode, type CrosswalkMapping, type DenialRisk, type EvidenceSpan, type ICD11ChapterInfo, type ICD11CodeDetail, type ICD11CodeDetailFull, type ICD11CodeSearchResponse, type ICD11CodeSearchResult, type ICFCodeDetail, type ICFCodeResult, type ICFCodeSummary, type ICFCodingEntity, type ICFCodingResponse, type ICFComponent, type ICFCoreSetResult, type ICFCrossReference, type ICFSearchResponse, type LOINCCodeDetail, type LOINCCodeResult, type LOINCCodeSummary, type LOINCCodingEntity, type LOINCCodingResponse, type LOINCSearchResponse, type MissedCode, NotFoundError, type PIIEntity, type ProblemListEntry, type RateLimit, RateLimitError, type RatesUsed, type SearchOptions, type SpecificityUpgrade, type UnsupportedCode, type UpgradeHint };
+export { type AnonymizeResponse, type AuditCapability, type AuditCode, type AuditContext, type AuditDocument, type AuditRequest, type AuditResponse, type AuditTotals, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodingEntity, type CodingResponse, type ConfirmedCode, type CrosswalkMapping, type DenialRisk, type EvidenceSpan, type ICD11ChapterInfo, type ICD11CodeDetail, type ICD11CodeDetailFull, type ICD11CodeSearchResponse, type ICD11CodeSearchResult, type ICFCodeDetail, type ICFCodeResult, type ICFCodeSummary, type ICFCodingEntity, type ICFComponent, type ICFCoreSetResult, type ICFCrossReference, type ICFSearchResponse, type InteropSystem, type LOINCCodeDetail, type LOINCCodeResult, type LOINCCodeSummary, type LOINCCodingEntity, type LOINCCodingResponse, type LOINCSearchResponse, type MissedCode, NotFoundError, type PIIEntity, type ProblemListEntry, type RateLimit, RateLimitError, type RatesUsed, type SearchOptions, type SpecificityUpgrade, type TranslateMapping, type TranslateRequest, type TranslateResponse, type TranslateSource, type UnsupportedCode, type UpgradeHint };

package/dist/index.d.ts

@@ -299,16 +299,6 @@ interface ICFCodingEntity {
     /** Ranked ICF code candidates. */
     codes: ICFCodeResult[];
 }
-interface ICFCodingResponse {
-    /** The input text that was processed. */
-    text: string;
-    /** Coding provider used. */
-    provider: string;
-    /** Total number of entities in results. */
-    entity_count: number;
-    /** Coding results per entity. */
-    results: ICFCodingEntity[];
-}
 interface ICFSearchResponse {
     /** The search query that was used. */
     query: string;
@@ -570,6 +560,38 @@ interface AuditResponse {
     rates_used: RatesUsed;
     upgrade_hint?: UpgradeHint;
 }
+/**
+ * Healthcare coding systems supported by `/v1/translate`.
+ * Current reachable mappings (forward):
+ * - `icd10` → `icd11` / `snomed` / `umls` / `icf`
+ * - `icd11` → `icd10`
+ * - `icf`   → `icd10`
+ */
+type InteropSystem = "icd10" | "icd11" | "snomed" | "umls" | "icf";
+interface TranslateRequest {
+    from: {
+        code: string;
+        system: InteropSystem;
+    };
+    to?: InteropSystem[];
+}
+interface TranslateMapping {
+    code: string;
+    description?: string;
+    mapping_type?: string;
+    component?: string;
+}
+interface TranslateSource {
+    code: string;
+    system: InteropSystem;
+    description?: string;
+}
+interface TranslateResponse {
+    from: TranslateSource;
+    mappings: Partial<Record<InteropSystem, TranslateMapping[]>>;
+    unsupported_targets: InteropSystem[];
+    provider: string;
+}
 
 declare class AutoICD {
     private readonly apiKey;
@@ -629,6 +651,21 @@ declare class AutoICD {
      * ```
      */
     audit(request: AuditRequest): Promise<AuditResponse>;
+    /**
+     * Translate a code between healthcare coding systems. Maps a source code
+     * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target
+     * systems. Omit `to` to get every system reachable from the source.
+     *
+     * @example
+     * ```ts
+     * const result = await autoicd.translate({
+     *   from: { code: "E11.9", system: "icd10" },
+     * });
+     * console.log(result.mappings.icd11);
+     * console.log(result.mappings.snomed);
+     * ```
+     */
+    translate(request: TranslateRequest): Promise<TranslateResponse>;
     /** @internal */
     get<T>(path: string): Promise<T>;
     /** @internal */
@@ -691,20 +728,6 @@ declare class ICD11Codes {
 declare class ICFCodes {
     private readonly client;
     constructor(client: AutoICD);
-    /**
-     * Code clinical text to ICF codes.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.icf.code("Patient has difficulty walking");
-     * for (const entity of result.results) {
-     *   console.log(entity.entity_text, entity.codes[0]?.code);
-     * }
-     * ```
-     */
-    code(text: string, options?: {
-        topK?: number;
-    }): Promise<ICFCodingResponse>;
     /**
      * Get full details for a single ICF code, including definition,
      * hierarchy (parent/children), inclusions, exclusions, and index terms.
@@ -798,4 +821,4 @@ declare class NotFoundError extends AutoICDError {
     constructor(message?: string);
 }
 
-export { type AnonymizeResponse, type AuditCapability, type AuditCode, type AuditContext, type AuditDocument, type AuditRequest, type AuditResponse, type AuditTotals, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodingEntity, type CodingResponse, type ConfirmedCode, type CrosswalkMapping, type DenialRisk, type EvidenceSpan, type ICD11ChapterInfo, type ICD11CodeDetail, type ICD11CodeDetailFull, type ICD11CodeSearchResponse, type ICD11CodeSearchResult, type ICFCodeDetail, type ICFCodeResult, type ICFCodeSummary, type ICFCodingEntity, type ICFCodingResponse, type ICFComponent, type ICFCoreSetResult, type ICFCrossReference, type ICFSearchResponse, type LOINCCodeDetail, type LOINCCodeResult, type LOINCCodeSummary, type LOINCCodingEntity, type LOINCCodingResponse, type LOINCSearchResponse, type MissedCode, NotFoundError, type PIIEntity, type ProblemListEntry, type RateLimit, RateLimitError, type RatesUsed, type SearchOptions, type SpecificityUpgrade, type UnsupportedCode, type UpgradeHint };
+export { type AnonymizeResponse, type AuditCapability, type AuditCode, type AuditContext, type AuditDocument, type AuditRequest, type AuditResponse, type AuditTotals, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodingEntity, type CodingResponse, type ConfirmedCode, type CrosswalkMapping, type DenialRisk, type EvidenceSpan, type ICD11ChapterInfo, type ICD11CodeDetail, type ICD11CodeDetailFull, type ICD11CodeSearchResponse, type ICD11CodeSearchResult, type ICFCodeDetail, type ICFCodeResult, type ICFCodeSummary, type ICFCodingEntity, type ICFComponent, type ICFCoreSetResult, type ICFCrossReference, type ICFSearchResponse, type InteropSystem, type LOINCCodeDetail, type LOINCCodeResult, type LOINCCodeSummary, type LOINCCodingEntity, type LOINCCodingResponse, type LOINCSearchResponse, type MissedCode, NotFoundError, type PIIEntity, type ProblemListEntry, type RateLimit, RateLimitError, type RatesUsed, type SearchOptions, type SpecificityUpgrade, type TranslateMapping, type TranslateRequest, type TranslateResponse, type TranslateSource, type UnsupportedCode, type UpgradeHint };

package/dist/index.js

@@ -147,6 +147,26 @@ var AutoICD = class {
   async audit(request) {
     return this.post("/api/v1/audit", request);
   }
+  /**
+   * Translate a code between healthcare coding systems. Maps a source code
+   * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target
+   * systems. Omit `to` to get every system reachable from the source.
+   *
+   * @example
+   * ```ts
+   * const result = await autoicd.translate({
+   *   from: { code: "E11.9", system: "icd10" },
+   * });
+   * console.log(result.mappings.icd11);
+   * console.log(result.mappings.snomed);
+   * ```
+   */
+  async translate(request) {
+    return this.post(
+      "/api/v1/translate",
+      request
+    );
+  }
   // ─── Internal HTTP ───
   /** @internal */
   async get(path) {
@@ -277,23 +297,6 @@ var ICFCodes = class {
   constructor(client) {
     this.client = client;
   }
-  /**
-   * Code clinical text to ICF codes.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.icf.code("Patient has difficulty walking");
-   * for (const entity of result.results) {
-   *   console.log(entity.entity_text, entity.codes[0]?.code);
-   * }
-   * ```
-   */
-  async code(text, options) {
-    return this.client.post("/api/v1/icf/code", {
-      text,
-      top_k: options?.topK
-    });
-  }
   /**
    * Get full details for a single ICF code, including definition,
    * hierarchy (parent/children), inclusions, exclusions, and index terms.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { AutoICD } from \"./client.js\";\n\nexport type {\n  AutoICDOptions,\n  CodeOptions,\n  CodeMatch,\n  CodingEntity,\n  CodingResponse,\n  SearchOptions,\n  CodeDetail,\n  CodeDetailFull,\n  ChapterInfo,\n  CodeSearchResponse,\n  PIIEntity,\n  AnonymizeResponse,\n  RateLimit,\n  ICD11CodeDetail,\n  ICD11ChapterInfo,\n  CrosswalkMapping,\n  ICD11CodeDetailFull,\n  ICD11CodeSearchResult,\n  ICD11CodeSearchResponse,\n  ICFComponent,\n  ICFCodeSummary,\n  ICFCodeDetail,\n  ICFCodeResult,\n  ICFCodingEntity,\n  ICFCodingResponse,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  ICFCrossReference,\n  LOINCCodeSummary,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodeResult,\n  LOINCCodingEntity,\n  LOINCCodingResponse,\n  AuditCapability,\n  AuditCode,\n  AuditDocument,\n  AuditContext,\n  AuditRequest,\n  AuditResponse,\n  EvidenceSpan,\n  ConfirmedCode,\n  MissedCode,\n  UnsupportedCode,\n  SpecificityUpgrade,\n  DenialRisk,\n  ProblemListEntry,\n  AuditTotals,\n  RatesUsed,\n  UpgradeHint,\n} from \"./types.js\";\n\nexport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n","import type { RateLimit } from \"./types.js\";\n\nexport class AutoICDError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"AutoICDError\";\n    this.status = status;\n  }\n}\n\nexport class AuthenticationError extends AutoICDError {\n  constructor(message = \"Invalid API key\") {\n    super(401, message);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class RateLimitError extends AutoICDError {\n  readonly rateLimit: RateLimit;\n\n  constructor(message: string, rateLimit: RateLimit) {\n    super(429, message);\n    this.name = \"RateLimitError\";\n    this.rateLimit = rateLimit;\n  }\n}\n\nexport class NotFoundError extends AutoICDError {\n  constructor(message = \"Resource not found\") {\n    super(404, message);\n    this.name = \"NotFoundError\";\n  }\n}\n","import type {\n  AutoICDOptions,\n  CodeOptions,\n  CodingResponse,\n  SearchOptions,\n  CodeSearchResponse,\n  CodeDetail,\n  CodeDetailFull,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\n  ICD11CodeSearchResponse,\n  ICD11CodeDetailFull,\n  ICFCodingResponse,\n  ICFCodeDetail,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodingResponse,\n  AuditRequest,\n  AuditResponse,\n} from \"./types.js\";\nimport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://autoicdapi.com\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class AutoICD {\n  private readonly apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeout: number;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  /** Rate limit info from the most recent API response. */\n  lastRateLimit: RateLimit | null = null;\n\n  /** Sub-resource for ICD-10 code lookup. */\n  readonly icd10: ICD10Codes;\n\n  /** Sub-resource for ICD-11 code lookup. */\n  readonly icd11: ICD11Codes;\n\n  /** Sub-resource for ICF code lookup and coding. */\n  readonly icf: ICFCodes;\n\n  /** Sub-resource for LOINC code lookup and coding. */\n  readonly loinc: LOINCCodes;\n\n  constructor(options: AutoICDOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"apiKey is required\");\n    }\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetch = options.fetch ?? globalThis.fetch;\n    this.icd10 = new ICD10Codes(this);\n    this.icd11 = new ICD11Codes(this);\n    this.icf = new ICFCodes(this);\n    this.loinc = new LOINCCodes(this);\n  }\n\n  // ─── Public Methods ───\n\n  /**\n   * Code clinical text to ICD-10-CM diagnoses.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.code(\"Patient has type 2 diabetes\");\n   * for (const entity of result.entities) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: CodeOptions): Promise<CodingResponse> {\n    return this.post<CodingResponse>(\"/api/v1/code\", {\n      text,\n      top_k: options?.topK,\n      include_negated: options?.includeNegated,\n      output_system: options?.outputSystem,\n      include_icf: options?.includeIcf,\n      include_icd11: options?.includeIcd11,\n      include_snomed: options?.includeSnomed,\n      include_umls: options?.includeUmls,\n    });\n  }\n\n  /**\n   * Anonymize PHI/PII in clinical text.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.anonymize(\"John Smith, DOB 01/15/1980, has COPD\");\n   * console.log(result.anonymized_text);\n   * // \"[NAME], DOB [DATE], has COPD\"\n   * ```\n   */\n  async anonymize(text: string): Promise<AnonymizeResponse> {\n    return this.post<AnonymizeResponse>(\"/api/v1/anonymize\", { text });\n  }\n\n  /**\n   * Audit a chart for coding gaps, RADV risk, specificity, denial flags, and\n   * a reconciled problem list. Every finding carries extractive evidence spans.\n   *\n   * @example\n   * ```ts\n   * const audit = await autoicd.audit({\n   *   text: \"68yo M, type 2 diabetes, chronic systolic heart failure on furosemide.\",\n   *   codes: [{ code: \"E11.9\", kind: \"icd10\" }],\n   *   capabilities: [\"hcc\", \"radv\", \"specificity\", \"denial\", \"problem_list\"],\n   *   context: { patient: { coverage: \"medicare_advantage\" } },\n   * });\n   * console.log(audit.totals.estimated_revenue_recovery);\n   * for (const m of audit.missed) {\n   *   console.log(`${m.code} ${m.hcc_category} $${m.estimated_revenue}`);\n   * }\n   * ```\n   */\n  async audit(request: AuditRequest): Promise<AuditResponse> {\n    return this.post<AuditResponse>(\"/api/v1/audit\", request as unknown as Record<string, unknown>);\n  }\n\n  // ─── Internal HTTP ───\n\n  /** @internal */\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  /** @internal */\n  async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    // Strip undefined values so the API receives clean JSON\n    const clean = Object.fromEntries(\n      Object.entries(body).filter(([, v]) => v !== undefined)\n    );\n    return this.request<T>(\"POST\", path, clean);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await this._fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          \"Content-Type\": \"application/json\",\n          Accept: \"application/json\",\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      // Parse rate limit headers\n      this.lastRateLimit = parseRateLimit(res.headers);\n\n      if (res.ok) {\n        return (await res.json()) as T;\n      }\n\n      // Error responses\n      const errorBody = (await res.json().catch(() => null)) as ErrorBody | null;\n      const message = errorBody?.error ?? `HTTP ${res.status}`;\n\n      if (res.status === 401) throw new AuthenticationError(message);\n      if (res.status === 404) throw new NotFoundError(message);\n      if (res.status === 429) {\n        throw new RateLimitError(\n          message,\n          this.lastRateLimit ?? {\n            limit: errorBody?.limit ?? 0,\n            remaining: 0,\n            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : new Date(),\n          }\n        );\n      }\n\n      throw new AutoICDError(res.status, message);\n    } catch (err) {\n      if (err instanceof AutoICDError) throw err;\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n// ─── ICD-10 Codes Sub-resource ───\n\nclass ICD10Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-10 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd10.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<CodeSearchResponse>(`/api/v1/icd10/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-10 code, including synonyms,\n   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd10.get(\"E11.9\");\n   * console.log(detail.long_description);\n   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms\n   * console.log(detail.chapter?.title);   // \"Endocrine, Nutritional and Metabolic Diseases\"\n   * console.log(detail.children.length);  // child codes\n   * ```\n   */\n  async get(code: string): Promise<CodeDetailFull> {\n    return this.client.get<CodeDetailFull>(`/api/v1/icd10/codes/${encodeURIComponent(code)}`);\n  }\n\n}\n\n// ─── ICD-11 Codes Sub-resource ───\n\nclass ICD11Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-11 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd11.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICD11CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICD11CodeSearchResponse>(`/api/v1/icd11/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-11 code, including synonyms,\n   * hierarchy (parent/children), chapter, and ICD-10 crosswalk mappings.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd11.get(\"5A11\");\n   * console.log(detail.long_description);\n   * console.log(detail.chapter?.title);\n   * console.log(detail.icd10_mappings);\n   * ```\n   */\n  async get(code: string): Promise<ICD11CodeDetailFull> {\n    return this.client.get<ICD11CodeDetailFull>(`/api/v1/icd11/codes/${encodeURIComponent(code)}`);\n  }\n}\n\n// ─── ICF Codes Sub-resource ───\n\nclass ICFCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to ICF codes.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.icf.code(\"Patient has difficulty walking\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<ICFCodingResponse> {\n    return this.client.post<ICFCodingResponse>(\"/api/v1/icf/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single ICF code, including definition,\n   * hierarchy (parent/children), inclusions, exclusions, and index terms.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icf.lookup(\"b280\");\n   * console.log(detail.title);\n   * console.log(detail.definition);\n   * console.log(detail.children.length);\n   * ```\n   */\n  async lookup(code: string): Promise<ICFCodeDetail> {\n    return this.client.get<ICFCodeDetail>(`/api/v1/icf/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search ICF codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icf.search(\"pain\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICFSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICFSearchResponse>(`/api/v1/icf/codes/search?${params}`);\n  }\n\n  /**\n   * Get the ICF Core Set for an ICD-10 diagnosis code.\n   *\n   * @example\n   * ```ts\n   * const coreSet = await autoicd.icf.coreSet(\"M54.5\");\n   * console.log(coreSet.condition_name);\n   * console.log(coreSet.brief.length, \"brief codes\");\n   * console.log(coreSet.comprehensive.length, \"comprehensive codes\");\n   * ```\n   */\n  async coreSet(icd10Code: string): Promise<ICFCoreSetResult> {\n    return this.client.get<ICFCoreSetResult>(`/api/v1/icf/core-set/${encodeURIComponent(icd10Code)}`);\n  }\n}\n\n// ─── LOINC Codes Sub-resource ───\n\nclass LOINCCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to LOINC codes.\n   *\n   * Extracts lab tests, imaging orders, and clinical observations from\n   * free text and matches to LOINC codes using NER + SapBERT embeddings.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.loinc.code(\"Order CBC, glucose, and TSH\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<LOINCCodingResponse> {\n    return this.client.post<LOINCCodingResponse>(\"/api/v1/loinc/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single LOINC code, including 6-axis classification,\n   * definition, related names, and cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.loinc.lookup(\"2345-7\");\n   * console.log(detail.long_common_name);\n   * console.log(detail.component, detail.system);\n   * ```\n   */\n  async lookup(code: string): Promise<LOINCCodeDetail> {\n    return this.client.get<LOINCCodeDetail>(`/api/v1/loinc/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search LOINC codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.loinc.search(\"glucose\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<LOINCSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<LOINCSearchResponse>(`/api/v1/loinc/codes/search?${params}`);\n  }\n}\n\n// ─── Helpers ───\n\nfunction parseRateLimit(headers: Headers): RateLimit | null {\n  const limit = headers.get(\"X-RateLimit-Limit\");\n  const remaining = headers.get(\"X-RateLimit-Remaining\");\n  const reset = headers.get(\"X-RateLimit-Reset\");\n\n  if (!limit || !remaining || !reset) return null;\n\n  return {\n    limit: parseInt(limit, 10),\n    remaining: parseInt(remaining, 10),\n    resetAt: new Date(reset),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,eAAN,cAA2B,MAAM;AAAA,EAC7B;AAAA,EAET,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAEO,IAAM,sBAAN,cAAkC,aAAa;AAAA,EACpD,YAAY,UAAU,mBAAmB;AACvC,UAAM,KAAK,OAAO;AAClB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,iBAAN,cAA6B,aAAa;AAAA,EACtC;AAAA,EAET,YAAY,SAAiB,WAAsB;AACjD,UAAM,KAAK,OAAO;AAClB,SAAK,OAAO;AACZ,SAAK,YAAY;AAAA,EACnB;AACF;AAEO,IAAM,gBAAN,cAA4B,aAAa;AAAA,EAC9C,YAAY,UAAU,sBAAsB;AAC1C,UAAM,KAAK,OAAO;AAClB,SAAK,OAAO;AAAA,EACd;AACF;;;ACJA,IAAM,mBAAmB;AACzB,IAAM,kBAAkB;AAEjB,IAAM,UAAN,MAAc;AAAA,EACF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAGjB,gBAAkC;AAAA;AAAA,EAGzB;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAET,YAAY,SAAyB;AACnC,QAAI,CAAC,QAAQ,QAAQ;AACnB,YAAM,IAAI,MAAM,oBAAoB;AAAA,IACtC;AACA,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACvE,SAAK,UAAU,QAAQ,WAAW;AAClC,SAAK,SAAS,QAAQ,SAAS,WAAW;AAC1C,SAAK,QAAQ,IAAI,WAAW,IAAI;AAChC,SAAK,QAAQ,IAAI,WAAW,IAAI;AAChC,SAAK,MAAM,IAAI,SAAS,IAAI;AAC5B,SAAK,QAAQ,IAAI,WAAW,IAAI;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,KAAK,MAAc,SAAgD;AACvE,WAAO,KAAK,KAAqB,gBAAgB;AAAA,MAC/C;AAAA,MACA,OAAO,SAAS;AAAA,MAChB,iBAAiB,SAAS;AAAA,MAC1B,eAAe,SAAS;AAAA,MACxB,aAAa,SAAS;AAAA,MACtB,eAAe,SAAS;AAAA,MACxB,gBAAgB,SAAS;AAAA,MACzB,cAAc,SAAS;AAAA,IACzB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,UAAU,MAA0C;AACxD,WAAO,KAAK,KAAwB,qBAAqB,EAAE,KAAK,CAAC;AAAA,EACnE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,MAAM,SAA+C;AACzD,WAAO,KAAK,KAAoB,iBAAiB,OAA6C;AAAA,EAChG;AAAA;AAAA;AAAA,EAKA,MAAM,IAAO,MAA0B;AACrC,WAAO,KAAK,QAAW,OAAO,IAAI;AAAA,EACpC;AAAA;AAAA,EAGA,MAAM,KAAQ,MAAc,MAA2C;AAErE,UAAM,QAAQ,OAAO;AAAA,MACnB,OAAO,QAAQ,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS;AAAA,IACxD;AACA,WAAO,KAAK,QAAW,QAAQ,MAAM,KAAK;AAAA,EAC5C;AAAA,EAEA,MAAc,QACZ,QACA,MACA,MACY;AACZ,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI;AAClC,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO;AAE/D,QAAI;AACF,YAAM,MAAM,MAAM,KAAK,OAAO,KAAK;AAAA,QACjC;AAAA,QACA,SAAS;AAAA,UACP,eAAe,UAAU,KAAK,MAAM;AAAA,UACpC,gBAAgB;AAAA,UAChB,QAAQ;AAAA,QACV;AAAA,QACA,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AAAA,QACpC,QAAQ,WAAW;AAAA,MACrB,CAAC;AAGD,WAAK,gBAAgB,eAAe,IAAI,OAAO;AAE/C,UAAI,IAAI,IAAI;AACV,eAAQ,MAAM,IAAI,KAAK;AAAA,MACzB;AAGA,YAAM,YAAa,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI;AACpD,YAAM,UAAU,WAAW,SAAS,QAAQ,IAAI,MAAM;AAEtD,UAAI,IAAI,WAAW,IAAK,OAAM,IAAI,oBAAoB,OAAO;AAC7D,UAAI,IAAI,WAAW,IAAK,OAAM,IAAI,cAAc,OAAO;AACvD,UAAI,IAAI,WAAW,KAAK;AACtB,cAAM,IAAI;AAAA,UACR;AAAA,UACA,KAAK,iBAAiB;AAAA,YACpB,OAAO,WAAW,SAAS;AAAA,YAC3B,WAAW;AAAA,YACX,SAAS,WAAW,UAAU,IAAI,KAAK,UAAU,OAAO,IAAI,oBAAI,KAAK;AAAA,UACvE;AAAA,QACF;AAAA,MACF;AAEA,YAAM,IAAI,aAAa,IAAI,QAAQ,OAAO;AAAA,IAC5C,SAAS,KAAK;AACZ,UAAI,eAAe,aAAc,OAAM;AACvC,UAAI,eAAe,gBAAgB,IAAI,SAAS,cAAc;AAC5D,cAAM,IAAI,aAAa,GAAG,2BAA2B,KAAK,OAAO,IAAI;AAAA,MACvE;AACA,YAAM;AAAA,IACR,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF;AACF;AAIA,IAAM,aAAN,MAAiB;AAAA,EACf,YAA6B,QAAiB;AAAjB;AAAA,EAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU/C,MAAM,OAAO,OAAe,SAAsD;AAChF,UAAM,SAAS,IAAI,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAC/C,QAAI,SAAS,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC3E,QAAI,SAAS,WAAW,OAAW,QAAO,IAAI,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9E,WAAO,KAAK,OAAO,IAAwB,8BAA8B,MAAM,EAAE;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,IAAI,MAAuC;AAC/C,WAAO,KAAK,OAAO,IAAoB,uBAAuB,mBAAmB,IAAI,CAAC,EAAE;AAAA,EAC1F;AAEF;AAIA,IAAM,aAAN,MAAiB;AAAA,EACf,YAA6B,QAAiB;AAAjB;AAAA,EAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU/C,MAAM,OAAO,OAAe,SAA2D;AACrF,UAAM,SAAS,IAAI,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAC/C,QAAI,SAAS,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC3E,QAAI,SAAS,WAAW,OAAW,QAAO,IAAI,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9E,WAAO,KAAK,OAAO,IAA6B,8BAA8B,MAAM,EAAE;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,IAAI,MAA4C;AACpD,WAAO,KAAK,OAAO,IAAyB,uBAAuB,mBAAmB,IAAI,CAAC,EAAE;AAAA,EAC/F;AACF;AAIA,IAAM,WAAN,MAAe;AAAA,EACb,YAA6B,QAAiB;AAAjB;AAAA,EAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAa/C,MAAM,KAAK,MAAc,SAAyD;AAChF,WAAO,KAAK,OAAO,KAAwB,oBAAoB;AAAA,MAC7D;AAAA,MACA,OAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,OAAO,MAAsC;AACjD,WAAO,KAAK,OAAO,IAAmB,qBAAqB,mBAAmB,IAAI,CAAC,EAAE;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OAAO,OAAe,SAAqD;AAC/E,UAAM,SAAS,IAAI,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAC/C,QAAI,SAAS,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC3E,QAAI,SAAS,WAAW,OAAW,QAAO,IAAI,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9E,WAAO,KAAK,OAAO,IAAuB,4BAA4B,MAAM,EAAE;AAAA,EAChF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,QAAQ,WAA8C;AAC1D,WAAO,KAAK,OAAO,IAAsB,wBAAwB,mBAAmB,SAAS,CAAC,EAAE;AAAA,EAClG;AACF;AAIA,IAAM,aAAN,MAAiB;AAAA,EACf,YAA6B,QAAiB;AAAjB;AAAA,EAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgB/C,MAAM,KAAK,MAAc,SAA2D;AAClF,WAAO,KAAK,OAAO,KAA0B,sBAAsB;AAAA,MACjE;AAAA,MACA,OAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,MAAM,OAAO,MAAwC;AACnD,WAAO,KAAK,OAAO,IAAqB,uBAAuB,mBAAmB,IAAI,CAAC,EAAE;AAAA,EAC3F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OAAO,OAAe,SAAuD;AACjF,UAAM,SAAS,IAAI,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAC/C,QAAI,SAAS,UAAU,OAAW,QAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;AAC3E,QAAI,SAAS,WAAW,OAAW,QAAO,IAAI,UAAU,OAAO,QAAQ,MAAM,CAAC;AAC9E,WAAO,KAAK,OAAO,IAAyB,8BAA8B,MAAM,EAAE;AAAA,EACpF;AACF;AAIA,SAAS,eAAe,SAAoC;AAC1D,QAAM,QAAQ,QAAQ,IAAI,mBAAmB;AAC7C,QAAM,YAAY,QAAQ,IAAI,uBAAuB;AACrD,QAAM,QAAQ,QAAQ,IAAI,mBAAmB;AAE7C,MAAI,CAAC,SAAS,CAAC,aAAa,CAAC,MAAO,QAAO;AAE3C,SAAO;AAAA,IACL,OAAO,SAAS,OAAO,EAAE;AAAA,IACzB,WAAW,SAAS,WAAW,EAAE;AAAA,IACjC,SAAS,IAAI,KAAK,KAAK;AAAA,EACzB;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export { AutoICD } from \"./client.js\";\n\nexport type {\n  AutoICDOptions,\n  CodeOptions,\n  CodeMatch,\n  CodingEntity,\n  CodingResponse,\n  SearchOptions,\n  CodeDetail,\n  CodeDetailFull,\n  ChapterInfo,\n  CodeSearchResponse,\n  PIIEntity,\n  AnonymizeResponse,\n  RateLimit,\n  ICD11CodeDetail,\n  ICD11ChapterInfo,\n  CrosswalkMapping,\n  ICD11CodeDetailFull,\n  ICD11CodeSearchResult,\n  ICD11CodeSearchResponse,\n  ICFComponent,\n  ICFCodeSummary,\n  ICFCodeDetail,\n  ICFCodeResult,\n  ICFCodingEntity,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  ICFCrossReference,\n  LOINCCodeSummary,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodeResult,\n  LOINCCodingEntity,\n  LOINCCodingResponse,\n  AuditCapability,\n  AuditCode,\n  AuditDocument,\n  AuditContext,\n  AuditRequest,\n  AuditResponse,\n  EvidenceSpan,\n  ConfirmedCode,\n  MissedCode,\n  UnsupportedCode,\n  SpecificityUpgrade,\n  DenialRisk,\n  ProblemListEntry,\n  AuditTotals,\n  RatesUsed,\n  UpgradeHint,\n  InteropSystem,\n  TranslateRequest,\n  TranslateResponse,\n  TranslateMapping,\n  TranslateSource,\n} from \"./types.js\";\n\nexport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n","import type { RateLimit } from \"./types.js\";\n\nexport class AutoICDError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"AutoICDError\";\n    this.status = status;\n  }\n}\n\nexport class AuthenticationError extends AutoICDError {\n  constructor(message = \"Invalid API key\") {\n    super(401, message);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class RateLimitError extends AutoICDError {\n  readonly rateLimit: RateLimit;\n\n  constructor(message: string, rateLimit: RateLimit) {\n    super(429, message);\n    this.name = \"RateLimitError\";\n    this.rateLimit = rateLimit;\n  }\n}\n\nexport class NotFoundError extends AutoICDError {\n  constructor(message = \"Resource not found\") {\n    super(404, message);\n    this.name = \"NotFoundError\";\n  }\n}\n","import type {\n  AutoICDOptions,\n  CodeOptions,\n  CodingResponse,\n  SearchOptions,\n  CodeSearchResponse,\n  CodeDetail,\n  CodeDetailFull,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\n  ICD11CodeSearchResponse,\n  ICD11CodeDetailFull,\n  ICFCodeDetail,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodingResponse,\n  AuditRequest,\n  AuditResponse,\n  TranslateRequest,\n  TranslateResponse,\n} from \"./types.js\";\nimport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://autoicdapi.com\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class AutoICD {\n  private readonly apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeout: number;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  /** Rate limit info from the most recent API response. */\n  lastRateLimit: RateLimit | null = null;\n\n  /** Sub-resource for ICD-10 code lookup. */\n  readonly icd10: ICD10Codes;\n\n  /** Sub-resource for ICD-11 code lookup. */\n  readonly icd11: ICD11Codes;\n\n  /** Sub-resource for ICF code lookup and coding. */\n  readonly icf: ICFCodes;\n\n  /** Sub-resource for LOINC code lookup and coding. */\n  readonly loinc: LOINCCodes;\n\n  constructor(options: AutoICDOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"apiKey is required\");\n    }\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetch = options.fetch ?? globalThis.fetch;\n    this.icd10 = new ICD10Codes(this);\n    this.icd11 = new ICD11Codes(this);\n    this.icf = new ICFCodes(this);\n    this.loinc = new LOINCCodes(this);\n  }\n\n  // ─── Public Methods ───\n\n  /**\n   * Code clinical text to ICD-10-CM diagnoses.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.code(\"Patient has type 2 diabetes\");\n   * for (const entity of result.entities) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: CodeOptions): Promise<CodingResponse> {\n    return this.post<CodingResponse>(\"/api/v1/code\", {\n      text,\n      top_k: options?.topK,\n      include_negated: options?.includeNegated,\n      output_system: options?.outputSystem,\n      include_icf: options?.includeIcf,\n      include_icd11: options?.includeIcd11,\n      include_snomed: options?.includeSnomed,\n      include_umls: options?.includeUmls,\n    });\n  }\n\n  /**\n   * Anonymize PHI/PII in clinical text.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.anonymize(\"John Smith, DOB 01/15/1980, has COPD\");\n   * console.log(result.anonymized_text);\n   * // \"[NAME], DOB [DATE], has COPD\"\n   * ```\n   */\n  async anonymize(text: string): Promise<AnonymizeResponse> {\n    return this.post<AnonymizeResponse>(\"/api/v1/anonymize\", { text });\n  }\n\n  /**\n   * Audit a chart for coding gaps, RADV risk, specificity, denial flags, and\n   * a reconciled problem list. Every finding carries extractive evidence spans.\n   *\n   * @example\n   * ```ts\n   * const audit = await autoicd.audit({\n   *   text: \"68yo M, type 2 diabetes, chronic systolic heart failure on furosemide.\",\n   *   codes: [{ code: \"E11.9\", kind: \"icd10\" }],\n   *   capabilities: [\"hcc\", \"radv\", \"specificity\", \"denial\", \"problem_list\"],\n   *   context: { patient: { coverage: \"medicare_advantage\" } },\n   * });\n   * console.log(audit.totals.estimated_revenue_recovery);\n   * for (const m of audit.missed) {\n   *   console.log(`${m.code} ${m.hcc_category} $${m.estimated_revenue}`);\n   * }\n   * ```\n   */\n  async audit(request: AuditRequest): Promise<AuditResponse> {\n    return this.post<AuditResponse>(\"/api/v1/audit\", request as unknown as Record<string, unknown>);\n  }\n\n  /**\n   * Translate a code between healthcare coding systems. Maps a source code\n   * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target\n   * systems. Omit `to` to get every system reachable from the source.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.translate({\n   *   from: { code: \"E11.9\", system: \"icd10\" },\n   * });\n   * console.log(result.mappings.icd11);\n   * console.log(result.mappings.snomed);\n   * ```\n   */\n  async translate(request: TranslateRequest): Promise<TranslateResponse> {\n    return this.post<TranslateResponse>(\n      \"/api/v1/translate\",\n      request as unknown as Record<string, unknown>,\n    );\n  }\n\n  // ─── Internal HTTP ───\n\n  /** @internal */\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  /** @internal */\n  async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    // Strip undefined values so the API receives clean JSON\n    const clean = Object.fromEntries(\n      Object.entries(body).filter(([, v]) => v !== undefined)\n    );\n    return this.request<T>(\"POST\", path, clean);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await this._fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          \"Content-Type\": \"application/json\",\n          Accept: \"application/json\",\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      // Parse rate limit headers\n      this.lastRateLimit = parseRateLimit(res.headers);\n\n      if (res.ok) {\n        return (await res.json()) as T;\n      }\n\n      // Error responses\n      const errorBody = (await res.json().catch(() => null)) as ErrorBody | null;\n      const message = errorBody?.error ?? `HTTP ${res.status}`;\n\n      if (res.status === 401) throw new AuthenticationError(message);\n      if (res.status === 404) throw new NotFoundError(message);\n      if (res.status === 429) {\n        throw new RateLimitError(\n          message,\n          this.lastRateLimit ?? {\n            limit: errorBody?.limit ?? 0,\n            remaining: 0,\n            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : new Date(),\n          }\n        );\n      }\n\n      throw new AutoICDError(res.status, message);\n    } catch (err) {\n      if (err instanceof AutoICDError) throw err;\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n// ─── ICD-10 Codes Sub-resource ───\n\nclass ICD10Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-10 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd10.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<CodeSearchResponse>(`/api/v1/icd10/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-10 code, including synonyms,\n   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd10.get(\"E11.9\");\n   * console.log(detail.long_description);\n   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms\n   * console.log(detail.chapter?.title);   // \"Endocrine, Nutritional and Metabolic Diseases\"\n   * console.log(detail.children.length);  // child codes\n   * ```\n   */\n  async get(code: string): Promise<CodeDetailFull> {\n    return this.client.get<CodeDetailFull>(`/api/v1/icd10/codes/${encodeURIComponent(code)}`);\n  }\n\n}\n\n// ─── ICD-11 Codes Sub-resource ───\n\nclass ICD11Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-11 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd11.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICD11CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICD11CodeSearchResponse>(`/api/v1/icd11/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-11 code, including synonyms,\n   * hierarchy (parent/children), chapter, and ICD-10 crosswalk mappings.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd11.get(\"5A11\");\n   * console.log(detail.long_description);\n   * console.log(detail.chapter?.title);\n   * console.log(detail.icd10_mappings);\n   * ```\n   */\n  async get(code: string): Promise<ICD11CodeDetailFull> {\n    return this.client.get<ICD11CodeDetailFull>(`/api/v1/icd11/codes/${encodeURIComponent(code)}`);\n  }\n}\n\n// ─── ICF Codes Sub-resource ───\n\nclass ICFCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Get full details for a single ICF code, including definition,\n   * hierarchy (parent/children), inclusions, exclusions, and index terms.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icf.lookup(\"b280\");\n   * console.log(detail.title);\n   * console.log(detail.definition);\n   * console.log(detail.children.length);\n   * ```\n   */\n  async lookup(code: string): Promise<ICFCodeDetail> {\n    return this.client.get<ICFCodeDetail>(`/api/v1/icf/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search ICF codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icf.search(\"pain\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICFSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICFSearchResponse>(`/api/v1/icf/codes/search?${params}`);\n  }\n\n  /**\n   * Get the ICF Core Set for an ICD-10 diagnosis code.\n   *\n   * @example\n   * ```ts\n   * const coreSet = await autoicd.icf.coreSet(\"M54.5\");\n   * console.log(coreSet.condition_name);\n   * console.log(coreSet.brief.length, \"brief codes\");\n   * console.log(coreSet.comprehensive.length, \"comprehensive codes\");\n   * ```\n   */\n  async coreSet(icd10Code: string): Promise<ICFCoreSetResult> {\n    return this.client.get<ICFCoreSetResult>(`/api/v1/icf/core-set/${encodeURIComponent(icd10Code)}`);\n  }\n}\n\n// ─── LOINC Codes Sub-resource ───\n\nclass LOINCCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to LOINC codes.\n   *\n   * Extracts lab tests, imaging orders, and clinical observations from\n   * free text and matches to LOINC codes using NER + SapBERT embeddings.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.loinc.code(\"Order CBC, glucose, and TSH\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<LOINCCodingResponse> {\n    return this.client.post<LOINCCodingResponse>(\"/api/v1/loinc/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single LOINC code, including 6-axis classification,\n   * definition, related names, and cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.loinc.lookup(\"2345-7\");\n   * console.log(detail.long_common_name);\n   * console.log(detail.component, detail.system);\n   * ```\n   */\n  async lookup(code: string): Promise<LOINCCodeDetail> {\n    return this.client.get<LOINCCodeDetail>(`/api/v1/loinc/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search LOINC codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.loinc.search(\"glucose\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<LOINCSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<LOINCSearchResponse>(`/api/v1/loinc/codes/search?${params}`);\n  }\n}\n\n// ─── Helpers ───\n\nfunction parseRateLimit(headers: Headers): RateLimit | null {\n  const limit = headers.get(\"X-RateLimit-Limit\");\n  const remaining = headers.get(\"X-RateLimit-Remaining\");\n  const reset = headers.get(\"X-RateLimit-Reset\");\n\n  if (!limit || !remaining || !reset) return null;\n\n  return {\n    limit: parseInt(limit, 10),\n    remaining: parseInt(remaining, 10),\n    resetAt: new Date(reset),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -117,6 +117,26 @@ var AutoICD = class {
   async audit(request) {
     return this.post("/api/v1/audit", request);
   }
+  /**
+   * Translate a code between healthcare coding systems. Maps a source code
+   * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target
+   * systems. Omit `to` to get every system reachable from the source.
+   *
+   * @example
+   * ```ts
+   * const result = await autoicd.translate({
+   *   from: { code: "E11.9", system: "icd10" },
+   * });
+   * console.log(result.mappings.icd11);
+   * console.log(result.mappings.snomed);
+   * ```
+   */
+  async translate(request) {
+    return this.post(
+      "/api/v1/translate",
+      request
+    );
+  }
   // ─── Internal HTTP ───
   /** @internal */
   async get(path) {
@@ -247,23 +267,6 @@ var ICFCodes = class {
   constructor(client) {
     this.client = client;
   }
-  /**
-   * Code clinical text to ICF codes.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.icf.code("Patient has difficulty walking");
-   * for (const entity of result.results) {
-   *   console.log(entity.entity_text, entity.codes[0]?.code);
-   * }
-   * ```
-   */
-  async code(text, options) {
-    return this.client.post("/api/v1/icf/code", {
-      text,
-      top_k: options?.topK
-    });
-  }
   /**
    * Get full details for a single ICF code, including definition,
    * hierarchy (parent/children), inclusions, exclusions, and index terms.

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { RateLimit } from \"./types.js\";\n\nexport class AutoICDError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"AutoICDError\";\n    this.status = status;\n  }\n}\n\nexport class AuthenticationError extends AutoICDError {\n  constructor(message = \"Invalid API key\") {\n    super(401, message);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class RateLimitError extends AutoICDError {\n  readonly rateLimit: RateLimit;\n\n  constructor(message: string, rateLimit: RateLimit) {\n    super(429, message);\n    this.name = \"RateLimitError\";\n    this.rateLimit = rateLimit;\n  }\n}\n\nexport class NotFoundError extends AutoICDError {\n  constructor(message = \"Resource not found\") {\n    super(404, message);\n    this.name = \"NotFoundError\";\n  }\n}\n","import type {\n  AutoICDOptions,\n  CodeOptions,\n  CodingResponse,\n  SearchOptions,\n  CodeSearchResponse,\n  CodeDetail,\n  CodeDetailFull,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\n  ICD11CodeSearchResponse,\n  ICD11CodeDetailFull,\n  ICFCodingResponse,\n  ICFCodeDetail,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodingResponse,\n  AuditRequest,\n  AuditResponse,\n} from \"./types.js\";\nimport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://autoicdapi.com\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class AutoICD {\n  private readonly apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeout: number;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  /** Rate limit info from the most recent API response. */\n  lastRateLimit: RateLimit | null = null;\n\n  /** Sub-resource for ICD-10 code lookup. */\n  readonly icd10: ICD10Codes;\n\n  /** Sub-resource for ICD-11 code lookup. */\n  readonly icd11: ICD11Codes;\n\n  /** Sub-resource for ICF code lookup and coding. */\n  readonly icf: ICFCodes;\n\n  /** Sub-resource for LOINC code lookup and coding. */\n  readonly loinc: LOINCCodes;\n\n  constructor(options: AutoICDOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"apiKey is required\");\n    }\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetch = options.fetch ?? globalThis.fetch;\n    this.icd10 = new ICD10Codes(this);\n    this.icd11 = new ICD11Codes(this);\n    this.icf = new ICFCodes(this);\n    this.loinc = new LOINCCodes(this);\n  }\n\n  // ─── Public Methods ───\n\n  /**\n   * Code clinical text to ICD-10-CM diagnoses.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.code(\"Patient has type 2 diabetes\");\n   * for (const entity of result.entities) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: CodeOptions): Promise<CodingResponse> {\n    return this.post<CodingResponse>(\"/api/v1/code\", {\n      text,\n      top_k: options?.topK,\n      include_negated: options?.includeNegated,\n      output_system: options?.outputSystem,\n      include_icf: options?.includeIcf,\n      include_icd11: options?.includeIcd11,\n      include_snomed: options?.includeSnomed,\n      include_umls: options?.includeUmls,\n    });\n  }\n\n  /**\n   * Anonymize PHI/PII in clinical text.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.anonymize(\"John Smith, DOB 01/15/1980, has COPD\");\n   * console.log(result.anonymized_text);\n   * // \"[NAME], DOB [DATE], has COPD\"\n   * ```\n   */\n  async anonymize(text: string): Promise<AnonymizeResponse> {\n    return this.post<AnonymizeResponse>(\"/api/v1/anonymize\", { text });\n  }\n\n  /**\n   * Audit a chart for coding gaps, RADV risk, specificity, denial flags, and\n   * a reconciled problem list. Every finding carries extractive evidence spans.\n   *\n   * @example\n   * ```ts\n   * const audit = await autoicd.audit({\n   *   text: \"68yo M, type 2 diabetes, chronic systolic heart failure on furosemide.\",\n   *   codes: [{ code: \"E11.9\", kind: \"icd10\" }],\n   *   capabilities: [\"hcc\", \"radv\", \"specificity\", \"denial\", \"problem_list\"],\n   *   context: { patient: { coverage: \"medicare_advantage\" } },\n   * });\n   * console.log(audit.totals.estimated_revenue_recovery);\n   * for (const m of audit.missed) {\n   *   console.log(`${m.code} ${m.hcc_category} $${m.estimated_revenue}`);\n   * }\n   * ```\n   */\n  async audit(request: AuditRequest): Promise<AuditResponse> {\n    return this.post<AuditResponse>(\"/api/v1/audit\", request as unknown as Record<string, unknown>);\n  }\n\n  // ─── Internal HTTP ───\n\n  /** @internal */\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  /** @internal */\n  async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    // Strip undefined values so the API receives clean JSON\n    const clean = Object.fromEntries(\n      Object.entries(body).filter(([, v]) => v !== undefined)\n    );\n    return this.request<T>(\"POST\", path, clean);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await this._fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          \"Content-Type\": \"application/json\",\n          Accept: \"application/json\",\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      // Parse rate limit headers\n      this.lastRateLimit = parseRateLimit(res.headers);\n\n      if (res.ok) {\n        return (await res.json()) as T;\n      }\n\n      // Error responses\n      const errorBody = (await res.json().catch(() => null)) as ErrorBody | null;\n      const message = errorBody?.error ?? `HTTP ${res.status}`;\n\n      if (res.status === 401) throw new AuthenticationError(message);\n      if (res.status === 404) throw new NotFoundError(message);\n      if (res.status === 429) {\n        throw new RateLimitError(\n          message,\n          this.lastRateLimit ?? {\n            limit: errorBody?.limit ?? 0,\n            remaining: 0,\n            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : new Date(),\n          }\n        );\n      }\n\n      throw new AutoICDError(res.status, message);\n    } catch (err) {\n      if (err instanceof AutoICDError) throw err;\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n// ─── ICD-10 Codes Sub-resource ───\n\nclass ICD10Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-10 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd10.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<CodeSearchResponse>(`/api/v1/icd10/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-10 code, including synonyms,\n   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd10.get(\"E11.9\");\n   * console.log(detail.long_description);\n   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms\n   * console.log(detail.chapter?.title);   // \"Endocrine, Nutritional and Metabolic Diseases\"\n   * console.log(detail.children.length);  // child codes\n   * ```\n   */\n  async get(code: string): Promise<CodeDetailFull> {\n    return this.client.get<CodeDetailFull>(`/api/v1/icd10/codes/${encodeURIComponent(code)}`);\n  }\n\n}\n\n// ─── ICD-11 Codes Sub-resource ───\n\nclass ICD11Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-11 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd11.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICD11CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICD11CodeSearchResponse>(`/api/v1/icd11/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-11 code, including synonyms,\n   * hierarchy (parent/children), chapter, and ICD-10 crosswalk mappings.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd11.get(\"5A11\");\n   * console.log(detail.long_description);\n   * console.log(detail.chapter?.title);\n   * console.log(detail.icd10_mappings);\n   * ```\n   */\n  async get(code: string): Promise<ICD11CodeDetailFull> {\n    return this.client.get<ICD11CodeDetailFull>(`/api/v1/icd11/codes/${encodeURIComponent(code)}`);\n  }\n}\n\n// ─── ICF Codes Sub-resource ───\n\nclass ICFCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to ICF codes.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.icf.code(\"Patient has difficulty walking\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<ICFCodingResponse> {\n    return this.client.post<ICFCodingResponse>(\"/api/v1/icf/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single ICF code, including definition,\n   * hierarchy (parent/children), inclusions, exclusions, and index terms.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icf.lookup(\"b280\");\n   * console.log(detail.title);\n   * console.log(detail.definition);\n   * console.log(detail.children.length);\n   * ```\n   */\n  async lookup(code: string): Promise<ICFCodeDetail> {\n    return this.client.get<ICFCodeDetail>(`/api/v1/icf/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search ICF codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icf.search(\"pain\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICFSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICFSearchResponse>(`/api/v1/icf/codes/search?${params}`);\n  }\n\n  /**\n   * Get the ICF Core Set for an ICD-10 diagnosis code.\n   *\n   * @example\n   * ```ts\n   * const coreSet = await autoicd.icf.coreSet(\"M54.5\");\n   * console.log(coreSet.condition_name);\n   * console.log(coreSet.brief.length, \"brief codes\");\n   * console.log(coreSet.comprehensive.length, \"comprehensive codes\");\n   * ```\n   */\n  async coreSet(icd10Code: string): Promise<ICFCoreSetResult> {\n    return this.client.get<ICFCoreSetResult>(`/api/v1/icf/core-set/${encodeURIComponent(icd10Code)}`);\n  }\n}\n\n// ─── LOINC Codes Sub-resource ───\n\nclass LOINCCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to LOINC codes.\n   *\n   * Extracts lab tests, imaging orders, and clinical observations from\n   * free text and matches to LOINC codes using NER + SapBERT embeddings.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.loinc.code(\"Order CBC, glucose, and TSH\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<LOINCCodingResponse> {\n    return this.client.post<LOINCCodingResponse>(\"/api/v1/loinc/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single LOINC code, including 6-axis classification,\n   * definition, related names, and cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.loinc.lookup(\"2345-7\");\n   * console.log(detail.long_common_name);\n   * console.log(detail.component, detail.system);\n   * ```\n   */\n  async lookup(code: string): Promise<LOINCCodeDetail> {\n    return this.client.get<LOINCCodeDetail>(`/api/v1/loinc/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search LOINC codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.loinc.search(\"glucose\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<LOINCSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<LOINCSearchResponse>(`/api/v1/loinc/codes/search?${params}`);\n  }\n}\n\n// ─── Helpers ───\n\nfunction parseRateLimit(headers: Headers): RateLimit | null {\n  const limit = headers.get(\"X-RateLimit-Limit\");\n  const remaining = headers.get(\"X-RateLimit-Remaining\");\n  const reset = headers.get(\"X-RateLimit-Reset\");\n\n  if (!limit || !remaining || !reset) return null;\n\n  return {\n    limit: parseInt(limit, 10),\n    remaining: parseInt(remaining, 10),\n    resetAt: new Date(reset),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["import type { RateLimit } from \"./types.js\";\n\nexport class AutoICDError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = \"AutoICDError\";\n    this.status = status;\n  }\n}\n\nexport class AuthenticationError extends AutoICDError {\n  constructor(message = \"Invalid API key\") {\n    super(401, message);\n    this.name = \"AuthenticationError\";\n  }\n}\n\nexport class RateLimitError extends AutoICDError {\n  readonly rateLimit: RateLimit;\n\n  constructor(message: string, rateLimit: RateLimit) {\n    super(429, message);\n    this.name = \"RateLimitError\";\n    this.rateLimit = rateLimit;\n  }\n}\n\nexport class NotFoundError extends AutoICDError {\n  constructor(message = \"Resource not found\") {\n    super(404, message);\n    this.name = \"NotFoundError\";\n  }\n}\n","import type {\n  AutoICDOptions,\n  CodeOptions,\n  CodingResponse,\n  SearchOptions,\n  CodeSearchResponse,\n  CodeDetail,\n  CodeDetailFull,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\n  ICD11CodeSearchResponse,\n  ICD11CodeDetailFull,\n  ICFCodeDetail,\n  ICFSearchResponse,\n  ICFCoreSetResult,\n  LOINCCodeDetail,\n  LOINCSearchResponse,\n  LOINCCodingResponse,\n  AuditRequest,\n  AuditResponse,\n  TranslateRequest,\n  TranslateResponse,\n} from \"./types.js\";\nimport {\n  AutoICDError,\n  AuthenticationError,\n  RateLimitError,\n  NotFoundError,\n} from \"./errors.js\";\n\nconst DEFAULT_BASE_URL = \"https://autoicdapi.com\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class AutoICD {\n  private readonly apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeout: number;\n  private readonly _fetch: typeof globalThis.fetch;\n\n  /** Rate limit info from the most recent API response. */\n  lastRateLimit: RateLimit | null = null;\n\n  /** Sub-resource for ICD-10 code lookup. */\n  readonly icd10: ICD10Codes;\n\n  /** Sub-resource for ICD-11 code lookup. */\n  readonly icd11: ICD11Codes;\n\n  /** Sub-resource for ICF code lookup and coding. */\n  readonly icf: ICFCodes;\n\n  /** Sub-resource for LOINC code lookup and coding. */\n  readonly loinc: LOINCCodes;\n\n  constructor(options: AutoICDOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"apiKey is required\");\n    }\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;\n    this._fetch = options.fetch ?? globalThis.fetch;\n    this.icd10 = new ICD10Codes(this);\n    this.icd11 = new ICD11Codes(this);\n    this.icf = new ICFCodes(this);\n    this.loinc = new LOINCCodes(this);\n  }\n\n  // ─── Public Methods ───\n\n  /**\n   * Code clinical text to ICD-10-CM diagnoses.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.code(\"Patient has type 2 diabetes\");\n   * for (const entity of result.entities) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: CodeOptions): Promise<CodingResponse> {\n    return this.post<CodingResponse>(\"/api/v1/code\", {\n      text,\n      top_k: options?.topK,\n      include_negated: options?.includeNegated,\n      output_system: options?.outputSystem,\n      include_icf: options?.includeIcf,\n      include_icd11: options?.includeIcd11,\n      include_snomed: options?.includeSnomed,\n      include_umls: options?.includeUmls,\n    });\n  }\n\n  /**\n   * Anonymize PHI/PII in clinical text.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.anonymize(\"John Smith, DOB 01/15/1980, has COPD\");\n   * console.log(result.anonymized_text);\n   * // \"[NAME], DOB [DATE], has COPD\"\n   * ```\n   */\n  async anonymize(text: string): Promise<AnonymizeResponse> {\n    return this.post<AnonymizeResponse>(\"/api/v1/anonymize\", { text });\n  }\n\n  /**\n   * Audit a chart for coding gaps, RADV risk, specificity, denial flags, and\n   * a reconciled problem list. Every finding carries extractive evidence spans.\n   *\n   * @example\n   * ```ts\n   * const audit = await autoicd.audit({\n   *   text: \"68yo M, type 2 diabetes, chronic systolic heart failure on furosemide.\",\n   *   codes: [{ code: \"E11.9\", kind: \"icd10\" }],\n   *   capabilities: [\"hcc\", \"radv\", \"specificity\", \"denial\", \"problem_list\"],\n   *   context: { patient: { coverage: \"medicare_advantage\" } },\n   * });\n   * console.log(audit.totals.estimated_revenue_recovery);\n   * for (const m of audit.missed) {\n   *   console.log(`${m.code} ${m.hcc_category} $${m.estimated_revenue}`);\n   * }\n   * ```\n   */\n  async audit(request: AuditRequest): Promise<AuditResponse> {\n    return this.post<AuditResponse>(\"/api/v1/audit\", request as unknown as Record<string, unknown>);\n  }\n\n  /**\n   * Translate a code between healthcare coding systems. Maps a source code\n   * (ICD-10, ICD-11, SNOMED, UMLS, ICF) to equivalents in requested target\n   * systems. Omit `to` to get every system reachable from the source.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.translate({\n   *   from: { code: \"E11.9\", system: \"icd10\" },\n   * });\n   * console.log(result.mappings.icd11);\n   * console.log(result.mappings.snomed);\n   * ```\n   */\n  async translate(request: TranslateRequest): Promise<TranslateResponse> {\n    return this.post<TranslateResponse>(\n      \"/api/v1/translate\",\n      request as unknown as Record<string, unknown>,\n    );\n  }\n\n  // ─── Internal HTTP ───\n\n  /** @internal */\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  /** @internal */\n  async post<T>(path: string, body: Record<string, unknown>): Promise<T> {\n    // Strip undefined values so the API receives clean JSON\n    const clean = Object.fromEntries(\n      Object.entries(body).filter(([, v]) => v !== undefined)\n    );\n    return this.request<T>(\"POST\", path, clean);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: Record<string, unknown>\n  ): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await this._fetch(url, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          \"Content-Type\": \"application/json\",\n          Accept: \"application/json\",\n        },\n        body: body ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      // Parse rate limit headers\n      this.lastRateLimit = parseRateLimit(res.headers);\n\n      if (res.ok) {\n        return (await res.json()) as T;\n      }\n\n      // Error responses\n      const errorBody = (await res.json().catch(() => null)) as ErrorBody | null;\n      const message = errorBody?.error ?? `HTTP ${res.status}`;\n\n      if (res.status === 401) throw new AuthenticationError(message);\n      if (res.status === 404) throw new NotFoundError(message);\n      if (res.status === 429) {\n        throw new RateLimitError(\n          message,\n          this.lastRateLimit ?? {\n            limit: errorBody?.limit ?? 0,\n            remaining: 0,\n            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : new Date(),\n          }\n        );\n      }\n\n      throw new AutoICDError(res.status, message);\n    } catch (err) {\n      if (err instanceof AutoICDError) throw err;\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);\n      }\n      throw err;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n\n// ─── ICD-10 Codes Sub-resource ───\n\nclass ICD10Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-10 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd10.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<CodeSearchResponse>(`/api/v1/icd10/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-10 code, including synonyms,\n   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd10.get(\"E11.9\");\n   * console.log(detail.long_description);\n   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms\n   * console.log(detail.chapter?.title);   // \"Endocrine, Nutritional and Metabolic Diseases\"\n   * console.log(detail.children.length);  // child codes\n   * ```\n   */\n  async get(code: string): Promise<CodeDetailFull> {\n    return this.client.get<CodeDetailFull>(`/api/v1/icd10/codes/${encodeURIComponent(code)}`);\n  }\n\n}\n\n// ─── ICD-11 Codes Sub-resource ───\n\nclass ICD11Codes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Search ICD-11 codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icd11.search(\"diabetes mellitus\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICD11CodeSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICD11CodeSearchResponse>(`/api/v1/icd11/codes/search?${params}`);\n  }\n\n  /**\n   * Get comprehensive details for a single ICD-11 code, including synonyms,\n   * hierarchy (parent/children), chapter, and ICD-10 crosswalk mappings.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icd11.get(\"5A11\");\n   * console.log(detail.long_description);\n   * console.log(detail.chapter?.title);\n   * console.log(detail.icd10_mappings);\n   * ```\n   */\n  async get(code: string): Promise<ICD11CodeDetailFull> {\n    return this.client.get<ICD11CodeDetailFull>(`/api/v1/icd11/codes/${encodeURIComponent(code)}`);\n  }\n}\n\n// ─── ICF Codes Sub-resource ───\n\nclass ICFCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Get full details for a single ICF code, including definition,\n   * hierarchy (parent/children), inclusions, exclusions, and index terms.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.icf.lookup(\"b280\");\n   * console.log(detail.title);\n   * console.log(detail.definition);\n   * console.log(detail.children.length);\n   * ```\n   */\n  async lookup(code: string): Promise<ICFCodeDetail> {\n    return this.client.get<ICFCodeDetail>(`/api/v1/icf/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search ICF codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.icf.search(\"pain\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<ICFSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<ICFSearchResponse>(`/api/v1/icf/codes/search?${params}`);\n  }\n\n  /**\n   * Get the ICF Core Set for an ICD-10 diagnosis code.\n   *\n   * @example\n   * ```ts\n   * const coreSet = await autoicd.icf.coreSet(\"M54.5\");\n   * console.log(coreSet.condition_name);\n   * console.log(coreSet.brief.length, \"brief codes\");\n   * console.log(coreSet.comprehensive.length, \"comprehensive codes\");\n   * ```\n   */\n  async coreSet(icd10Code: string): Promise<ICFCoreSetResult> {\n    return this.client.get<ICFCoreSetResult>(`/api/v1/icf/core-set/${encodeURIComponent(icd10Code)}`);\n  }\n}\n\n// ─── LOINC Codes Sub-resource ───\n\nclass LOINCCodes {\n  constructor(private readonly client: AutoICD) {}\n\n  /**\n   * Code clinical text to LOINC codes.\n   *\n   * Extracts lab tests, imaging orders, and clinical observations from\n   * free text and matches to LOINC codes using NER + SapBERT embeddings.\n   *\n   * @example\n   * ```ts\n   * const result = await autoicd.loinc.code(\"Order CBC, glucose, and TSH\");\n   * for (const entity of result.results) {\n   *   console.log(entity.entity_text, entity.codes[0]?.code);\n   * }\n   * ```\n   */\n  async code(text: string, options?: { topK?: number }): Promise<LOINCCodingResponse> {\n    return this.client.post<LOINCCodingResponse>(\"/api/v1/loinc/code\", {\n      text,\n      top_k: options?.topK,\n    });\n  }\n\n  /**\n   * Get full details for a single LOINC code, including 6-axis classification,\n   * definition, related names, and cross-references.\n   *\n   * @example\n   * ```ts\n   * const detail = await autoicd.loinc.lookup(\"2345-7\");\n   * console.log(detail.long_common_name);\n   * console.log(detail.component, detail.system);\n   * ```\n   */\n  async lookup(code: string): Promise<LOINCCodeDetail> {\n    return this.client.get<LOINCCodeDetail>(`/api/v1/loinc/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Search LOINC codes by description.\n   *\n   * @example\n   * ```ts\n   * const results = await autoicd.loinc.search(\"glucose\");\n   * ```\n   */\n  async search(query: string, options?: SearchOptions): Promise<LOINCSearchResponse> {\n    const params = new URLSearchParams({ q: query });\n    if (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n    if (options?.offset !== undefined) params.set(\"offset\", String(options.offset));\n    return this.client.get<LOINCSearchResponse>(`/api/v1/loinc/codes/search?${params}`);\n  }\n}\n\n// ─── Helpers ───\n\nfunction parseRateLimit(headers: Headers): RateLimit | null {\n  const limit = headers.get(\"X-RateLimit-Limit\");\n  const remaining = headers.get(\"X-RateLimit-Remaining\");\n  const reset = headers.get(\"X-RateLimit-Reset\");\n\n  if (!limit || !remaining || !reset) return null;\n\n  return {\n    limit: parseInt(limit, 10),\n    remaining: parseInt(remaining, 10),\n    resetAt: new Date(reset),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autoicd-js",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "AI medical coding SDK — convert clinical text to ICD-10-CM and ICD-11 diagnosis codes with AI-powered NLP. Automated ICD-10 coding, PHI de-identification, code search, and ICD-10/ICD-11 crosswalk for EHR, billing, and health-tech apps.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",