autoicd-js 0.2.0 → 0.4.0

package/README.md

@@ -96,7 +96,6 @@ const result = await autoicd.code(
   "Patient presents with acute bronchitis and chest pain",
   {
     topK: 3,               // Top 3 ICD-10 candidates per entity (default: 5)
-    strategy: "merged",    // "individual" or "merged" entity strategy
     includeNegated: false, // Exclude negated conditions from results
   }
 );
@@ -115,25 +114,15 @@ const results = await autoicd.codes.search("heart failure", { limit: 5 });
 
 ### ICD-10 Code Details
 
-Get full details for any ICD-10-CM code — descriptions, billable status, and indexed terms.
+Get full details for any ICD-10-CM code — descriptions, billable status, synonyms, hierarchy, and chapter classification.
 
 ```ts
 const detail = await autoicd.codes.get("E11.9");
 console.log(detail.code);              // "E11.9"
 console.log(detail.long_description);  // "Type 2 diabetes mellitus without complications"
 console.log(detail.is_billable);       // true
-```
-
-### ICD-10 Code Terms & Synonyms
-
-Retrieve all indexed terms and synonyms for a code — includes SNOMED CT mappings and clinical variants.
-
-```ts
-const terms = await autoicd.codes.terms("E11.9");
-terms.forEach((t) => console.log(t.term, `(${t.term_type})`));
-// "Type 2 diabetes mellitus without complications" (long_desc)
-// "adult onset diabetes" (synonym)
-// ...
+console.log(detail.synonyms.snomed);   // ["Diabetes mellitus type 2", ...]
+console.log(detail.chapter?.title);    // "Endocrine, Nutritional and Metabolic Diseases"
 ```
 
 ### PHI De-identification
@@ -223,7 +212,6 @@ Full REST API documentation at [autoicdapi.com/docs](https://autoicdapi.com/docs
 | `autoicd.anonymize(text)` | De-identify PHI/PII in clinical text |
 | `autoicd.codes.search(query, options?)` | Search ICD-10-CM codes by description |
 | `autoicd.codes.get(code)` | Get details for an ICD-10-CM code |
-| `autoicd.codes.terms(code)` | Get indexed terms/synonyms for a code |
 
 ---
 
@@ -239,7 +227,6 @@ import type {
   CodeOptions,
   CodeDetail,
   CodeSearchResponse,
-  CodeTermInfo,
   AnonymizeResponse,
   PIIEntity,
   RateLimit,

package/package.json

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

package/dist/index.d.mts

@@ -1,240 +0,0 @@
-interface AutoICDOptions {
-    /** API key (starts with `sk_`). */
-    apiKey: string;
-    /** Base URL. Defaults to `https://autoicdapi.com`. */
-    baseURL?: string;
-    /** Default timeout in milliseconds. Defaults to 30_000. */
-    timeout?: number;
-    /** Custom fetch implementation (for testing or non-standard runtimes). */
-    fetch?: typeof globalThis.fetch;
-}
-interface CodeOptions {
-    /** Number of top ICD-10 candidates per entity (1-25). Defaults to 5. */
-    topK?: number;
-    /** Include negated entities in results. Defaults to true. */
-    includeNegated?: boolean;
-    /** Matching strategy. Defaults to `"individual"`. */
-    strategy?: "individual" | "merged";
-}
-interface CodeMatch {
-    /** ICD-10-CM code (e.g., `"E11.21"`). */
-    code: string;
-    /** Official code description. */
-    description: string;
-    /** Cosine similarity score (0-1). */
-    similarity: number;
-    /** `"high"` if above high-confidence threshold, else `"moderate"`. */
-    confidence: "high" | "moderate";
-    /** The index term that produced this match. */
-    matched_term: string;
-}
-interface CodingEntity {
-    /** Entity text as extracted from the input. */
-    entity_text: string;
-    /** Character offset start in input text. */
-    entity_start: number;
-    /** Character offset end in input text. */
-    entity_end: number;
-    /** Whether this entity was negated in context. */
-    negated: boolean;
-    /** Entity refers to a past/resolved condition. */
-    historical: boolean;
-    /** Entity refers to a family member's condition. */
-    family_history: boolean;
-    /** Entity is hedged or uncertain. */
-    uncertain: boolean;
-    /** Severity modifier if detected (e.g., `"severe"`). */
-    severity: string | null;
-    /** Ranked ICD-10 code candidates. */
-    codes: CodeMatch[];
-    /** Source entity texts if this result was created by merging consecutive entities. */
-    merged_from?: string[] | null;
-    /** Original text before spell correction (null if no correction). */
-    corrected_from?: string | null;
-}
-interface CodingResponse {
-    /** The input text that was processed. */
-    text: string;
-    /** Coding provider used. */
-    provider: string;
-    /** Matching strategy used. */
-    strategy: string;
-    /** Total number of entities in results. */
-    entity_count: number;
-    /** Coding results per entity, sorted by position in text. */
-    entities: CodingEntity[];
-}
-interface SearchOptions {
-    /** Maximum number of results (1-100). Defaults to 20. */
-    limit?: number;
-    /** Number of results to skip (for pagination). Defaults to 0. */
-    offset?: number;
-}
-interface CodeDetail {
-    /** ICD-10-CM code. */
-    code: string;
-    /** Abbreviated description. */
-    short_description: string;
-    /** Full official description. */
-    long_description: string;
-    /** Whether this is a billable (leaf) code. */
-    is_billable: boolean;
-}
-interface ChapterInfo {
-    /** Chapter number (1-22). */
-    number: number;
-    /** Code range (e.g., `"E00-E89"`). */
-    range: string;
-    /** Chapter title. */
-    title: string;
-}
-interface CodeDetailFull extends CodeDetail {
-    /** Synonyms grouped by source: `"snomed"`, `"umls"`, `"icd10_augmented"`. */
-    synonyms: Record<string, string[]>;
-    /** Parent code in the ICD-10 hierarchy, or `null` for top-level categories. */
-    parent: CodeDetail | null;
-    /** Direct child codes in the ICD-10 hierarchy. */
-    children: CodeDetail[];
-    /** ICD-10-CM chapter this code belongs to. */
-    chapter: ChapterInfo | null;
-    /** Code block range (e.g., `"E08-E13"`). */
-    block: string | null;
-}
-interface CodeSearchResponse {
-    /** The search query that was used. */
-    query: string;
-    /** Number of results returned. */
-    count: number;
-    /** Matching ICD-10 codes. */
-    codes: CodeDetail[];
-}
-interface CodeTermInfo {
-    /** The term text that was embedded. */
-    term: string;
-    /** Origin of this term (e.g., `"long_desc"`, `"synonym"`). */
-    term_type: string;
-}
-interface PIIEntity {
-    /** Original PII text. */
-    text: string;
-    /** Character offset start. */
-    start: number;
-    /** Character offset end. */
-    end: number;
-    /** PII category (NAME, DATE, SSN, PHONE, EMAIL, ADDRESS, MRN, AGE). */
-    label: string;
-    /** Replacement token (e.g., `"[NAME]"`). */
-    replacement: string;
-}
-interface AnonymizeResponse {
-    /** The input text that was processed. */
-    original_text: string;
-    /** Text with PII replaced by type labels. */
-    anonymized_text: string;
-    /** Number of PII entities detected. */
-    pii_count: number;
-    /** Detected PII spans with original offsets. */
-    pii_entities: PIIEntity[];
-}
-interface RateLimit {
-    /** Total requests allowed in the current period. */
-    limit: number;
-    /** Requests remaining. */
-    remaining: number;
-    /** UTC timestamp when the limit resets. */
-    resetAt: Date;
-}
-
-declare class AutoICD {
-    private readonly apiKey;
-    private readonly baseURL;
-    private readonly timeout;
-    private readonly _fetch;
-    /** Rate limit info from the most recent API response. */
-    lastRateLimit: RateLimit | null;
-    /** Sub-resource for ICD-10 code lookup. */
-    readonly codes: Codes;
-    constructor(options: AutoICDOptions);
-    /**
-     * Code clinical text to ICD-10-CM diagnoses.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.code("Patient has type 2 diabetes");
-     * for (const entity of result.entities) {
-     *   console.log(entity.entity_text, entity.codes[0]?.code);
-     * }
-     * ```
-     */
-    code(text: string, options?: CodeOptions): Promise<CodingResponse>;
-    /**
-     * Anonymize PHI/PII in clinical text.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.anonymize("John Smith, DOB 01/15/1980, has COPD");
-     * console.log(result.anonymized_text);
-     * // "[NAME], DOB [DATE], has COPD"
-     * ```
-     */
-    anonymize(text: string): Promise<AnonymizeResponse>;
-    /** @internal */
-    get<T>(path: string): Promise<T>;
-    /** @internal */
-    post<T>(path: string, body: Record<string, unknown>): Promise<T>;
-    private request;
-}
-declare class Codes {
-    private readonly client;
-    constructor(client: AutoICD);
-    /**
-     * Search ICD-10 codes by description.
-     *
-     * @example
-     * ```ts
-     * const results = await autoicd.codes.search("diabetes mellitus");
-     * ```
-     */
-    search(query: string, options?: SearchOptions): Promise<CodeSearchResponse>;
-    /**
-     * Get comprehensive details for a single ICD-10 code, including synonyms,
-     * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.
-     *
-     * @example
-     * ```ts
-     * const detail = await autoicd.codes.get("E11.9");
-     * console.log(detail.long_description);
-     * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms
-     * console.log(detail.chapter?.title);   // "Endocrine, Nutritional and Metabolic Diseases"
-     * console.log(detail.children.length);  // child codes
-     * ```
-     */
-    get(code: string): Promise<CodeDetailFull>;
-    /**
-     * Get all indexed terms/synonyms for an ICD-10 code.
-     *
-     * @example
-     * ```ts
-     * const terms = await autoicd.codes.terms("E11.9");
-     * terms.forEach(t => console.log(t.term, t.term_type));
-     * ```
-     */
-    terms(code: string): Promise<CodeTermInfo[]>;
-}
-
-declare class AutoICDError extends Error {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
-declare class AuthenticationError extends AutoICDError {
-    constructor(message?: string);
-}
-declare class RateLimitError extends AutoICDError {
-    readonly rateLimit: RateLimit;
-    constructor(message: string, rateLimit: RateLimit);
-}
-declare class NotFoundError extends AutoICDError {
-    constructor(message?: string);
-}
-
-export { type AnonymizeResponse, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodeTermInfo, type CodingEntity, type CodingResponse, NotFoundError, type PIIEntity, type RateLimit, RateLimitError, type SearchOptions };

package/dist/index.d.ts

@@ -1,240 +0,0 @@
-interface AutoICDOptions {
-    /** API key (starts with `sk_`). */
-    apiKey: string;
-    /** Base URL. Defaults to `https://autoicdapi.com`. */
-    baseURL?: string;
-    /** Default timeout in milliseconds. Defaults to 30_000. */
-    timeout?: number;
-    /** Custom fetch implementation (for testing or non-standard runtimes). */
-    fetch?: typeof globalThis.fetch;
-}
-interface CodeOptions {
-    /** Number of top ICD-10 candidates per entity (1-25). Defaults to 5. */
-    topK?: number;
-    /** Include negated entities in results. Defaults to true. */
-    includeNegated?: boolean;
-    /** Matching strategy. Defaults to `"individual"`. */
-    strategy?: "individual" | "merged";
-}
-interface CodeMatch {
-    /** ICD-10-CM code (e.g., `"E11.21"`). */
-    code: string;
-    /** Official code description. */
-    description: string;
-    /** Cosine similarity score (0-1). */
-    similarity: number;
-    /** `"high"` if above high-confidence threshold, else `"moderate"`. */
-    confidence: "high" | "moderate";
-    /** The index term that produced this match. */
-    matched_term: string;
-}
-interface CodingEntity {
-    /** Entity text as extracted from the input. */
-    entity_text: string;
-    /** Character offset start in input text. */
-    entity_start: number;
-    /** Character offset end in input text. */
-    entity_end: number;
-    /** Whether this entity was negated in context. */
-    negated: boolean;
-    /** Entity refers to a past/resolved condition. */
-    historical: boolean;
-    /** Entity refers to a family member's condition. */
-    family_history: boolean;
-    /** Entity is hedged or uncertain. */
-    uncertain: boolean;
-    /** Severity modifier if detected (e.g., `"severe"`). */
-    severity: string | null;
-    /** Ranked ICD-10 code candidates. */
-    codes: CodeMatch[];
-    /** Source entity texts if this result was created by merging consecutive entities. */
-    merged_from?: string[] | null;
-    /** Original text before spell correction (null if no correction). */
-    corrected_from?: string | null;
-}
-interface CodingResponse {
-    /** The input text that was processed. */
-    text: string;
-    /** Coding provider used. */
-    provider: string;
-    /** Matching strategy used. */
-    strategy: string;
-    /** Total number of entities in results. */
-    entity_count: number;
-    /** Coding results per entity, sorted by position in text. */
-    entities: CodingEntity[];
-}
-interface SearchOptions {
-    /** Maximum number of results (1-100). Defaults to 20. */
-    limit?: number;
-    /** Number of results to skip (for pagination). Defaults to 0. */
-    offset?: number;
-}
-interface CodeDetail {
-    /** ICD-10-CM code. */
-    code: string;
-    /** Abbreviated description. */
-    short_description: string;
-    /** Full official description. */
-    long_description: string;
-    /** Whether this is a billable (leaf) code. */
-    is_billable: boolean;
-}
-interface ChapterInfo {
-    /** Chapter number (1-22). */
-    number: number;
-    /** Code range (e.g., `"E00-E89"`). */
-    range: string;
-    /** Chapter title. */
-    title: string;
-}
-interface CodeDetailFull extends CodeDetail {
-    /** Synonyms grouped by source: `"snomed"`, `"umls"`, `"icd10_augmented"`. */
-    synonyms: Record<string, string[]>;
-    /** Parent code in the ICD-10 hierarchy, or `null` for top-level categories. */
-    parent: CodeDetail | null;
-    /** Direct child codes in the ICD-10 hierarchy. */
-    children: CodeDetail[];
-    /** ICD-10-CM chapter this code belongs to. */
-    chapter: ChapterInfo | null;
-    /** Code block range (e.g., `"E08-E13"`). */
-    block: string | null;
-}
-interface CodeSearchResponse {
-    /** The search query that was used. */
-    query: string;
-    /** Number of results returned. */
-    count: number;
-    /** Matching ICD-10 codes. */
-    codes: CodeDetail[];
-}
-interface CodeTermInfo {
-    /** The term text that was embedded. */
-    term: string;
-    /** Origin of this term (e.g., `"long_desc"`, `"synonym"`). */
-    term_type: string;
-}
-interface PIIEntity {
-    /** Original PII text. */
-    text: string;
-    /** Character offset start. */
-    start: number;
-    /** Character offset end. */
-    end: number;
-    /** PII category (NAME, DATE, SSN, PHONE, EMAIL, ADDRESS, MRN, AGE). */
-    label: string;
-    /** Replacement token (e.g., `"[NAME]"`). */
-    replacement: string;
-}
-interface AnonymizeResponse {
-    /** The input text that was processed. */
-    original_text: string;
-    /** Text with PII replaced by type labels. */
-    anonymized_text: string;
-    /** Number of PII entities detected. */
-    pii_count: number;
-    /** Detected PII spans with original offsets. */
-    pii_entities: PIIEntity[];
-}
-interface RateLimit {
-    /** Total requests allowed in the current period. */
-    limit: number;
-    /** Requests remaining. */
-    remaining: number;
-    /** UTC timestamp when the limit resets. */
-    resetAt: Date;
-}
-
-declare class AutoICD {
-    private readonly apiKey;
-    private readonly baseURL;
-    private readonly timeout;
-    private readonly _fetch;
-    /** Rate limit info from the most recent API response. */
-    lastRateLimit: RateLimit | null;
-    /** Sub-resource for ICD-10 code lookup. */
-    readonly codes: Codes;
-    constructor(options: AutoICDOptions);
-    /**
-     * Code clinical text to ICD-10-CM diagnoses.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.code("Patient has type 2 diabetes");
-     * for (const entity of result.entities) {
-     *   console.log(entity.entity_text, entity.codes[0]?.code);
-     * }
-     * ```
-     */
-    code(text: string, options?: CodeOptions): Promise<CodingResponse>;
-    /**
-     * Anonymize PHI/PII in clinical text.
-     *
-     * @example
-     * ```ts
-     * const result = await autoicd.anonymize("John Smith, DOB 01/15/1980, has COPD");
-     * console.log(result.anonymized_text);
-     * // "[NAME], DOB [DATE], has COPD"
-     * ```
-     */
-    anonymize(text: string): Promise<AnonymizeResponse>;
-    /** @internal */
-    get<T>(path: string): Promise<T>;
-    /** @internal */
-    post<T>(path: string, body: Record<string, unknown>): Promise<T>;
-    private request;
-}
-declare class Codes {
-    private readonly client;
-    constructor(client: AutoICD);
-    /**
-     * Search ICD-10 codes by description.
-     *
-     * @example
-     * ```ts
-     * const results = await autoicd.codes.search("diabetes mellitus");
-     * ```
-     */
-    search(query: string, options?: SearchOptions): Promise<CodeSearchResponse>;
-    /**
-     * Get comprehensive details for a single ICD-10 code, including synonyms,
-     * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.
-     *
-     * @example
-     * ```ts
-     * const detail = await autoicd.codes.get("E11.9");
-     * console.log(detail.long_description);
-     * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms
-     * console.log(detail.chapter?.title);   // "Endocrine, Nutritional and Metabolic Diseases"
-     * console.log(detail.children.length);  // child codes
-     * ```
-     */
-    get(code: string): Promise<CodeDetailFull>;
-    /**
-     * Get all indexed terms/synonyms for an ICD-10 code.
-     *
-     * @example
-     * ```ts
-     * const terms = await autoicd.codes.terms("E11.9");
-     * terms.forEach(t => console.log(t.term, t.term_type));
-     * ```
-     */
-    terms(code: string): Promise<CodeTermInfo[]>;
-}
-
-declare class AutoICDError extends Error {
-    readonly status: number;
-    constructor(status: number, message: string);
-}
-declare class AuthenticationError extends AutoICDError {
-    constructor(message?: string);
-}
-declare class RateLimitError extends AutoICDError {
-    readonly rateLimit: RateLimit;
-    constructor(message: string, rateLimit: RateLimit);
-}
-declare class NotFoundError extends AutoICDError {
-    constructor(message?: string);
-}
-
-export { type AnonymizeResponse, AuthenticationError, AutoICD, AutoICDError, type AutoICDOptions, type ChapterInfo, type CodeDetail, type CodeDetailFull, type CodeMatch, type CodeOptions, type CodeSearchResponse, type CodeTermInfo, type CodingEntity, type CodingResponse, NotFoundError, type PIIEntity, type RateLimit, RateLimitError, type SearchOptions };

package/dist/index.js

@@ -1,241 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  AuthenticationError: () => AuthenticationError,
-  AutoICD: () => AutoICD,
-  AutoICDError: () => AutoICDError,
-  NotFoundError: () => NotFoundError,
-  RateLimitError: () => RateLimitError
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/errors.ts
-var AutoICDError = class extends Error {
-  status;
-  constructor(status, message) {
-    super(message);
-    this.name = "AutoICDError";
-    this.status = status;
-  }
-};
-var AuthenticationError = class extends AutoICDError {
-  constructor(message = "Invalid API key") {
-    super(401, message);
-    this.name = "AuthenticationError";
-  }
-};
-var RateLimitError = class extends AutoICDError {
-  rateLimit;
-  constructor(message, rateLimit) {
-    super(429, message);
-    this.name = "RateLimitError";
-    this.rateLimit = rateLimit;
-  }
-};
-var NotFoundError = class extends AutoICDError {
-  constructor(message = "Resource not found") {
-    super(404, message);
-    this.name = "NotFoundError";
-  }
-};
-
-// src/client.ts
-var DEFAULT_BASE_URL = "https://autoicdapi.com";
-var DEFAULT_TIMEOUT = 3e4;
-var AutoICD = class {
-  apiKey;
-  baseURL;
-  timeout;
-  _fetch;
-  /** Rate limit info from the most recent API response. */
-  lastRateLimit = null;
-  /** Sub-resource for ICD-10 code lookup. */
-  codes;
-  constructor(options) {
-    if (!options.apiKey) {
-      throw new Error("apiKey is required");
-    }
-    this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
-    this._fetch = options.fetch ?? globalThis.fetch;
-    this.codes = new Codes(this);
-  }
-  // ─── Public Methods ───
-  /**
-   * Code clinical text to ICD-10-CM diagnoses.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.code("Patient has type 2 diabetes");
-   * for (const entity of result.entities) {
-   *   console.log(entity.entity_text, entity.codes[0]?.code);
-   * }
-   * ```
-   */
-  async code(text, options) {
-    return this.post("/api/v1/code", {
-      text,
-      top_k: options?.topK,
-      include_negated: options?.includeNegated,
-      strategy: options?.strategy
-    });
-  }
-  /**
-   * Anonymize PHI/PII in clinical text.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.anonymize("John Smith, DOB 01/15/1980, has COPD");
-   * console.log(result.anonymized_text);
-   * // "[NAME], DOB [DATE], has COPD"
-   * ```
-   */
-  async anonymize(text) {
-    return this.post("/api/v1/anonymize", { text });
-  }
-  // ─── Internal HTTP ───
-  /** @internal */
-  async get(path) {
-    return this.request("GET", path);
-  }
-  /** @internal */
-  async post(path, body) {
-    const clean = Object.fromEntries(
-      Object.entries(body).filter(([, v]) => v !== void 0)
-    );
-    return this.request("POST", path, clean);
-  }
-  async request(method, path, body) {
-    const url = `${this.baseURL}${path}`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const res = await this._fetch(url, {
-        method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: body ? JSON.stringify(body) : void 0,
-        signal: controller.signal
-      });
-      this.lastRateLimit = parseRateLimit(res.headers);
-      if (res.ok) {
-        return await res.json();
-      }
-      const errorBody = await res.json().catch(() => null);
-      const message = errorBody?.error ?? `HTTP ${res.status}`;
-      if (res.status === 401) throw new AuthenticationError(message);
-      if (res.status === 404) throw new NotFoundError(message);
-      if (res.status === 429) {
-        throw new RateLimitError(
-          message,
-          this.lastRateLimit ?? {
-            limit: errorBody?.limit ?? 0,
-            remaining: 0,
-            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : /* @__PURE__ */ new Date()
-          }
-        );
-      }
-      throw new AutoICDError(res.status, message);
-    } catch (err) {
-      if (err instanceof AutoICDError) throw err;
-      if (err instanceof DOMException && err.name === "AbortError") {
-        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);
-      }
-      throw err;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-};
-var Codes = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Search ICD-10 codes by description.
-   *
-   * @example
-   * ```ts
-   * const results = await autoicd.codes.search("diabetes mellitus");
-   * ```
-   */
-  async search(query, options) {
-    const params = new URLSearchParams({ q: query });
-    if (options?.limit !== void 0) params.set("limit", String(options.limit));
-    if (options?.offset !== void 0) params.set("offset", String(options.offset));
-    return this.client.get(`/api/v1/codes/search?${params}`);
-  }
-  /**
-   * Get comprehensive details for a single ICD-10 code, including synonyms,
-   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.
-   *
-   * @example
-   * ```ts
-   * const detail = await autoicd.codes.get("E11.9");
-   * console.log(detail.long_description);
-   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms
-   * console.log(detail.chapter?.title);   // "Endocrine, Nutritional and Metabolic Diseases"
-   * console.log(detail.children.length);  // child codes
-   * ```
-   */
-  async get(code) {
-    return this.client.get(`/api/v1/codes/${encodeURIComponent(code)}`);
-  }
-  /**
-   * Get all indexed terms/synonyms for an ICD-10 code.
-   *
-   * @example
-   * ```ts
-   * const terms = await autoicd.codes.terms("E11.9");
-   * terms.forEach(t => console.log(t.term, t.term_type));
-   * ```
-   */
-  async terms(code) {
-    return this.client.get(
-      `/api/v1/codes/${encodeURIComponent(code)}/terms`
-    );
-  }
-};
-function parseRateLimit(headers) {
-  const limit = headers.get("X-RateLimit-Limit");
-  const remaining = headers.get("X-RateLimit-Remaining");
-  const reset = headers.get("X-RateLimit-Reset");
-  if (!limit || !remaining || !reset) return null;
-  return {
-    limit: parseInt(limit, 10),
-    remaining: parseInt(remaining, 10),
-    resetAt: new Date(reset)
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AuthenticationError,
-  AutoICD,
-  AutoICDError,
-  NotFoundError,
-  RateLimitError
-});
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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  CodeTermInfo,\n  PIIEntity,\n  AnonymizeResponse,\n  RateLimit,\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  CodeTermInfo,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\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 codes: Codes;\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.codes = new Codes(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      strategy: options?.strategy,\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  // ─── 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// ─── Codes Sub-resource ───\n\nclass Codes {\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.codes.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/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.codes.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/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Get all indexed terms/synonyms for an ICD-10 code.\n   *\n   * @example\n   * ```ts\n   * const terms = await autoicd.codes.terms(\"E11.9\");\n   * terms.forEach(t => console.log(t.term, t.term_type));\n   * ```\n   */\n  async terms(code: string): Promise<CodeTermInfo[]> {\n    return this.client.get<CodeTermInfo[]>(\n      `/api/v1/codes/${encodeURIComponent(code)}/terms`\n    );\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

@@ -1,210 +0,0 @@
-// src/errors.ts
-var AutoICDError = class extends Error {
-  status;
-  constructor(status, message) {
-    super(message);
-    this.name = "AutoICDError";
-    this.status = status;
-  }
-};
-var AuthenticationError = class extends AutoICDError {
-  constructor(message = "Invalid API key") {
-    super(401, message);
-    this.name = "AuthenticationError";
-  }
-};
-var RateLimitError = class extends AutoICDError {
-  rateLimit;
-  constructor(message, rateLimit) {
-    super(429, message);
-    this.name = "RateLimitError";
-    this.rateLimit = rateLimit;
-  }
-};
-var NotFoundError = class extends AutoICDError {
-  constructor(message = "Resource not found") {
-    super(404, message);
-    this.name = "NotFoundError";
-  }
-};
-
-// src/client.ts
-var DEFAULT_BASE_URL = "https://autoicdapi.com";
-var DEFAULT_TIMEOUT = 3e4;
-var AutoICD = class {
-  apiKey;
-  baseURL;
-  timeout;
-  _fetch;
-  /** Rate limit info from the most recent API response. */
-  lastRateLimit = null;
-  /** Sub-resource for ICD-10 code lookup. */
-  codes;
-  constructor(options) {
-    if (!options.apiKey) {
-      throw new Error("apiKey is required");
-    }
-    this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-    this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
-    this._fetch = options.fetch ?? globalThis.fetch;
-    this.codes = new Codes(this);
-  }
-  // ─── Public Methods ───
-  /**
-   * Code clinical text to ICD-10-CM diagnoses.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.code("Patient has type 2 diabetes");
-   * for (const entity of result.entities) {
-   *   console.log(entity.entity_text, entity.codes[0]?.code);
-   * }
-   * ```
-   */
-  async code(text, options) {
-    return this.post("/api/v1/code", {
-      text,
-      top_k: options?.topK,
-      include_negated: options?.includeNegated,
-      strategy: options?.strategy
-    });
-  }
-  /**
-   * Anonymize PHI/PII in clinical text.
-   *
-   * @example
-   * ```ts
-   * const result = await autoicd.anonymize("John Smith, DOB 01/15/1980, has COPD");
-   * console.log(result.anonymized_text);
-   * // "[NAME], DOB [DATE], has COPD"
-   * ```
-   */
-  async anonymize(text) {
-    return this.post("/api/v1/anonymize", { text });
-  }
-  // ─── Internal HTTP ───
-  /** @internal */
-  async get(path) {
-    return this.request("GET", path);
-  }
-  /** @internal */
-  async post(path, body) {
-    const clean = Object.fromEntries(
-      Object.entries(body).filter(([, v]) => v !== void 0)
-    );
-    return this.request("POST", path, clean);
-  }
-  async request(method, path, body) {
-    const url = `${this.baseURL}${path}`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const res = await this._fetch(url, {
-        method,
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json",
-          Accept: "application/json"
-        },
-        body: body ? JSON.stringify(body) : void 0,
-        signal: controller.signal
-      });
-      this.lastRateLimit = parseRateLimit(res.headers);
-      if (res.ok) {
-        return await res.json();
-      }
-      const errorBody = await res.json().catch(() => null);
-      const message = errorBody?.error ?? `HTTP ${res.status}`;
-      if (res.status === 401) throw new AuthenticationError(message);
-      if (res.status === 404) throw new NotFoundError(message);
-      if (res.status === 429) {
-        throw new RateLimitError(
-          message,
-          this.lastRateLimit ?? {
-            limit: errorBody?.limit ?? 0,
-            remaining: 0,
-            resetAt: errorBody?.resetAt ? new Date(errorBody.resetAt) : /* @__PURE__ */ new Date()
-          }
-        );
-      }
-      throw new AutoICDError(res.status, message);
-    } catch (err) {
-      if (err instanceof AutoICDError) throw err;
-      if (err instanceof DOMException && err.name === "AbortError") {
-        throw new AutoICDError(0, `Request timed out after ${this.timeout}ms`);
-      }
-      throw err;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-};
-var Codes = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Search ICD-10 codes by description.
-   *
-   * @example
-   * ```ts
-   * const results = await autoicd.codes.search("diabetes mellitus");
-   * ```
-   */
-  async search(query, options) {
-    const params = new URLSearchParams({ q: query });
-    if (options?.limit !== void 0) params.set("limit", String(options.limit));
-    if (options?.offset !== void 0) params.set("offset", String(options.offset));
-    return this.client.get(`/api/v1/codes/search?${params}`);
-  }
-  /**
-   * Get comprehensive details for a single ICD-10 code, including synonyms,
-   * hierarchy (parent/children), chapter, and SNOMED CT / UMLS cross-references.
-   *
-   * @example
-   * ```ts
-   * const detail = await autoicd.codes.get("E11.9");
-   * console.log(detail.long_description);
-   * console.log(detail.synonyms.snomed);  // SNOMED CT synonyms
-   * console.log(detail.chapter?.title);   // "Endocrine, Nutritional and Metabolic Diseases"
-   * console.log(detail.children.length);  // child codes
-   * ```
-   */
-  async get(code) {
-    return this.client.get(`/api/v1/codes/${encodeURIComponent(code)}`);
-  }
-  /**
-   * Get all indexed terms/synonyms for an ICD-10 code.
-   *
-   * @example
-   * ```ts
-   * const terms = await autoicd.codes.terms("E11.9");
-   * terms.forEach(t => console.log(t.term, t.term_type));
-   * ```
-   */
-  async terms(code) {
-    return this.client.get(
-      `/api/v1/codes/${encodeURIComponent(code)}/terms`
-    );
-  }
-};
-function parseRateLimit(headers) {
-  const limit = headers.get("X-RateLimit-Limit");
-  const remaining = headers.get("X-RateLimit-Remaining");
-  const reset = headers.get("X-RateLimit-Reset");
-  if (!limit || !remaining || !reset) return null;
-  return {
-    limit: parseInt(limit, 10),
-    remaining: parseInt(remaining, 10),
-    resetAt: new Date(reset)
-  };
-}
-export {
-  AuthenticationError,
-  AutoICD,
-  AutoICDError,
-  NotFoundError,
-  RateLimitError
-};
-//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"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  CodeTermInfo,\n  AnonymizeResponse,\n  RateLimit,\n  ErrorBody,\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 codes: Codes;\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.codes = new Codes(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      strategy: options?.strategy,\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  // ─── 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// ─── Codes Sub-resource ───\n\nclass Codes {\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.codes.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/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.codes.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/codes/${encodeURIComponent(code)}`);\n  }\n\n  /**\n   * Get all indexed terms/synonyms for an ICD-10 code.\n   *\n   * @example\n   * ```ts\n   * const terms = await autoicd.codes.terms(\"E11.9\");\n   * terms.forEach(t => console.log(t.term, t.term_type));\n   * ```\n   */\n  async terms(code: string): Promise<CodeTermInfo[]> {\n    return this.client.get<CodeTermInfo[]>(\n      `/api/v1/codes/${encodeURIComponent(code)}/terms`\n    );\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":[]}