@fhirfly-io/terminology 0.1.3 → 0.2.0

package/dist/index.cjs

@@ -103,12 +103,71 @@ var TimeoutError = class _TimeoutError extends FhirflyError {
 };
 
 // src/http.ts
+var TokenManager = class {
+  credentials;
+  accessToken = null;
+  expiresAt = 0;
+  refreshPromise = null;
+  constructor(credentials) {
+    this.credentials = credentials;
+  }
+  /**
+   * Get a valid access token, refreshing if needed.
+   * Deduplicates concurrent refresh calls.
+   */
+  async getToken() {
+    if (this.accessToken && Date.now() < this.expiresAt) {
+      return this.accessToken;
+    }
+    if (this.refreshPromise) {
+      return this.refreshPromise;
+    }
+    this.refreshPromise = this.fetchToken();
+    try {
+      return await this.refreshPromise;
+    } finally {
+      this.refreshPromise = null;
+    }
+  }
+  /**
+   * Invalidate the cached token (e.g., after a 401 response).
+   */
+  invalidate() {
+    this.accessToken = null;
+    this.expiresAt = 0;
+  }
+  async fetchToken() {
+    const body = new URLSearchParams({
+      grant_type: "client_credentials",
+      client_id: this.credentials.clientId,
+      client_secret: this.credentials.clientSecret
+    });
+    if (this.credentials.scopes?.length) {
+      body.set("scope", this.credentials.scopes.join(" "));
+    }
+    const response = await fetch(this.credentials.tokenUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: body.toString()
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new AuthenticationError(
+        `OAuth2 token exchange failed (${response.status}): ${text}`
+      );
+    }
+    const data = await response.json();
+    this.accessToken = data.access_token;
+    this.expiresAt = Date.now() + (data.expires_in - 60) * 1e3;
+    return this.accessToken;
+  }
+};
 var HttpClient = class {
   config;
   constructor(config) {
     this.config = {
       baseUrl: config.baseUrl,
-      apiKey: config.apiKey,
+      auth: config.auth,
       timeout: config.timeout ?? 3e4,
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
@@ -130,6 +189,26 @@ var HttpClient = class {
     const queryString = params.toString();
     return queryString ? `?${queryString}` : "";
   }
+  /**
+   * Build query string from search params object.
+   */
+  buildSearchQueryString(params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value === void 0 || value === null) continue;
+      if (typeof value === "boolean") {
+        searchParams.set(key, value.toString());
+      } else if (typeof value === "number") {
+        searchParams.set(key, value.toString());
+      } else if (typeof value === "string" && value.length > 0) {
+        searchParams.set(key, value);
+      } else if (Array.isArray(value) && value.length > 0) {
+        searchParams.set(key, value.join(","));
+      }
+    }
+    const queryString = searchParams.toString();
+    return queryString ? `?${queryString}` : "";
+  }
   /**
    * Parse error response from API.
    */
@@ -182,10 +261,20 @@ var HttpClient = class {
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
+  /**
+   * Get auth headers for the current request.
+   */
+  async getAuthHeaders() {
+    if (this.config.auth.type === "api-key") {
+      return { "x-api-key": this.config.auth.apiKey };
+    }
+    const token = await this.config.auth.tokenManager.getToken();
+    return { "Authorization": `Bearer ${token}` };
+  }
   /**
    * Make an HTTP request with retries.
    */
-  async request(method, endpoint, body) {
+  async request(method, endpoint, body, isRetryAfter401 = false) {
     const url = `${this.config.baseUrl}${endpoint}`;
     let lastError;
     for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
@@ -195,10 +284,11 @@ var HttpClient = class {
           () => controller.abort(),
           this.config.timeout
         );
+        const authHeaders = await this.getAuthHeaders();
         const response = await fetch(url, {
           method,
           headers: {
-            "Authorization": `Bearer ${this.config.apiKey}`,
+            ...authHeaders,
             "Content-Type": "application/json",
             "User-Agent": this.config.userAgent,
             "Accept": "application/json"
@@ -208,6 +298,10 @@ var HttpClient = class {
         });
         clearTimeout(timeoutId);
         if (!response.ok) {
+          if (response.status === 401 && this.config.auth.type === "oauth" && !isRetryAfter401) {
+            this.config.auth.tokenManager.invalidate();
+            return this.request(method, endpoint, body, true);
+          }
           if (response.status < 500 && response.status !== 429) {
             await this.parseErrorResponse(response, endpoint);
           }
@@ -268,6 +362,14 @@ var HttpClient = class {
     const response = await this.request("POST", `${endpoint}${queryString}`, body);
     return response.data;
   }
+  /**
+   * Make a GET request with search parameters.
+   */
+  async search(endpoint, params) {
+    const queryString = this.buildSearchQueryString(params);
+    const response = await this.request("GET", `${endpoint}${queryString}`);
+    return response.data;
+  }
 };
 
 // src/endpoints/ndc.ts
@@ -322,6 +424,38 @@ var NdcEndpoint = class {
       options
     );
   }
+  /**
+   * Search for NDC products.
+   *
+   * @param params - Search parameters (q, name, brand, ingredient, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by drug name
+   * const results = await client.ndc.search({ q: "advil" });
+   *
+   * // Search with filters
+   * const results = await client.ndc.search({
+   *   ingredient: "ibuprofen",
+   *   dosage_form: "TABLET",
+   *   product_type: "otc"
+   * });
+   *
+   * console.log(`Found ${results.total} products`);
+   * for (const item of results.items) {
+   *   console.log(item.product_name);
+   * }
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/ndc/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/npi.ts
@@ -367,6 +501,35 @@ var NpiEndpoint = class {
       options
     );
   }
+  /**
+   * Search for healthcare providers.
+   *
+   * @param params - Search parameters (q, name, specialty, state, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by name
+   * const results = await client.npi.search({ q: "smith" });
+   *
+   * // Search with filters
+   * const results = await client.npi.search({
+   *   specialty: "cardiology",
+   *   state: "CA",
+   *   entity_type: "individual"
+   * });
+   *
+   * console.log(`Found ${results.total} providers`);
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/npi/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/rxnorm.ts
@@ -404,6 +567,32 @@ var RxNormEndpoint = class {
       options
     );
   }
+  /**
+   * Search for drugs in RxNorm.
+   *
+   * @param params - Search parameters (q, name, ingredient, brand, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by drug name
+   * const results = await client.rxnorm.search({ q: "lipitor" });
+   *
+   * // Search prescribable drugs by ingredient
+   * const results = await client.rxnorm.search({
+   *   ingredient: "metformin",
+   *   is_prescribable: true
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/rxnorm/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/loinc.ts
@@ -441,6 +630,33 @@ var LoincEndpoint = class {
       options
     );
   }
+  /**
+   * Search for LOINC codes.
+   *
+   * @param params - Search parameters (q, component, class, system, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by term
+   * const results = await client.loinc.search({ q: "glucose" });
+   *
+   * // Search blood chemistry tests
+   * const results = await client.loinc.search({
+   *   class: "CHEM",
+   *   system: "Bld",
+   *   scale: "Qn"
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/loinc/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/icd10.ts
@@ -508,6 +724,36 @@ var Icd10Endpoint = class {
       options
     );
   }
+  /**
+   * Search for ICD-10 codes (both CM and PCS).
+   *
+   * @param params - Search parameters (q, code_system, chapter, billable, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search diagnosis codes
+   * const results = await client.icd10.search({
+   *   q: "diabetes",
+   *   code_system: "CM",
+   *   billable: true
+   * });
+   *
+   * // Search procedure codes
+   * const results = await client.icd10.search({
+   *   q: "bypass",
+   *   code_system: "PCS"
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/icd10/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/cvx.ts
@@ -545,6 +791,32 @@ var CvxEndpoint = class {
       options
     );
   }
+  /**
+   * Search for vaccine codes.
+   *
+   * @param params - Search parameters (q, status, vaccine_type, is_covid_vaccine)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search for flu vaccines
+   * const results = await client.cvx.search({ q: "influenza" });
+   *
+   * // Find all COVID-19 vaccines
+   * const results = await client.cvx.search({
+   *   is_covid_vaccine: true,
+   *   status: "active"
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/cvx/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/mvx.ts
@@ -582,6 +854,29 @@ var MvxEndpoint = class {
       options
     );
   }
+  /**
+   * Search for vaccine manufacturers.
+   *
+   * @param params - Search parameters (q, status)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by name
+   * const results = await client.mvx.search({ q: "pfizer" });
+   *
+   * // List all active manufacturers
+   * const results = await client.mvx.search({ status: "active" });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/mvx/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/endpoints/fda-labels.ts
@@ -635,6 +930,38 @@ var FdaLabelsEndpoint = class {
       options
     );
   }
+  /**
+   * Search for FDA drug labels.
+   *
+   * @param params - Search parameters (q, name, brand, substance, manufacturer, etc.)
+   * @param options - Pagination and response shape options
+   * @returns Search results with facets
+   *
+   * @example
+   * ```ts
+   * // Search by drug name
+   * const results = await client.fdaLabels.search({ q: "advil" });
+   *
+   * // Search OTC pain relievers
+   * const results = await client.fdaLabels.search({
+   *   substance: "acetaminophen",
+   *   product_type: "otc"
+   * });
+   *
+   * // Search by manufacturer
+   * const results = await client.fdaLabels.search({
+   *   manufacturer: "pfizer",
+   *   product_type: "rx"
+   * });
+   * ```
+   */
+  async search(params, options) {
+    return this.http.search("/v1/fda-label/search", {
+      ...params,
+      ...options,
+      include: options?.include?.join(",")
+    });
+  }
 };
 
 // src/client.ts
@@ -675,22 +1002,39 @@ var Fhirfly = class {
   /**
    * Create a new FHIRfly client.
    *
-   * @param config - Client configuration
-   * @throws {Error} If apiKey is not provided
+   * @param config - Client configuration (API key or OAuth2 client credentials)
+   * @throws {Error} If neither apiKey nor clientId+clientSecret is provided
    */
   constructor(config) {
-    if (!config.apiKey) {
+    const baseUrl = config.baseUrl ?? "https://api.fhirfly.io";
+    let httpConfig;
+    if ("apiKey" in config && config.apiKey) {
+      httpConfig = {
+        baseUrl,
+        auth: { type: "api-key", apiKey: config.apiKey },
+        timeout: config.timeout,
+        maxRetries: config.maxRetries,
+        retryDelay: config.retryDelay
+      };
+    } else if ("clientId" in config && config.clientId && config.clientSecret) {
+      const tokenManager = new TokenManager({
+        clientId: config.clientId,
+        clientSecret: config.clientSecret,
+        tokenUrl: config.tokenUrl ?? `${baseUrl}/oauth2/token`,
+        scopes: config.scopes
+      });
+      httpConfig = {
+        baseUrl,
+        auth: { type: "oauth", tokenManager },
+        timeout: config.timeout,
+        maxRetries: config.maxRetries,
+        retryDelay: config.retryDelay
+      };
+    } else {
       throw new Error(
-        "FHIRfly API key is required. Get one at https://fhirfly.io/dashboard"
+        "FHIRfly requires either an apiKey or clientId+clientSecret. Get credentials at https://fhirfly.io/dashboard"
       );
     }
-    const httpConfig = {
-      baseUrl: config.baseUrl ?? "https://api.fhirfly.io",
-      apiKey: config.apiKey,
-      timeout: config.timeout,
-      maxRetries: config.maxRetries,
-      retryDelay: config.retryDelay
-    };
     this.http = new HttpClient(httpConfig);
     this.ndc = new NdcEndpoint(this.http);
     this.npi = new NpiEndpoint(this.http);
@@ -713,6 +1057,7 @@ exports.QuotaExceededError = QuotaExceededError;
 exports.RateLimitError = RateLimitError;
 exports.ServerError = ServerError;
 exports.TimeoutError = TimeoutError;
+exports.TokenManager = TokenManager;
 exports.ValidationError = ValidationError;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map