@oystehr/sdk 4.3.1 → 4.3.3

package/dist/esm/resources/types/ErxGetMedicationHistoryResponse.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Success
+ */
+export type ErxGetMedicationHistoryResponse = {
+    /**
+     * Unique identifier for the medication history item.
+     */
+    id: number;
+    /**
+     * The Medi-Span identifier for the medication.
+     */
+    medicationId: number;
+    /**
+     * National Drug Code (NDC) identifier of medication.
+     */
+    ndc: string | null;
+    /**
+     * RxNorm Concept Unique (RxCUI) identifier of medication.
+     */
+    rxcui: number | null;
+    /**
+     * Human readable name of medication.
+     */
+    name: string;
+    route: string | null;
+    doseForm: string | null;
+    strength: string | null;
+    dispenseUnit: string | null;
+    isBrandName: boolean;
+    genericName: string | null;
+    isOtc: boolean;
+    refills: string;
+    daysSupply: number | null;
+    quantity: number;
+    classification: string | null;
+    schedule: number | null;
+    directions: string | null;
+    substitutionsAllowed: boolean;
+    writtenDate: string;
+    effectiveDate: string | null;
+    lastFillDate: string | null;
+    expirationDate: string | null;
+}[];

package/dist/esm/resources/types/ErxGetMedicationResponse.d.ts

@@ -7,7 +7,7 @@ export interface ErxGetMedicationResponse {
      */
     id: number;
     /**
-     * RxNorm Concept Unique (RxCUI) identifier of medication.
+     * National Drug Code (NDC) identifier of medication.
      */
     ndc?: string | null;
     /**

package/dist/esm/resources/types/RcmGetPayerParams.d.ts

@@ -0,0 +1,3 @@
+export interface RcmGetPayerParams {
+    id: string;
+}

package/dist/esm/resources/types/RcmGetPayerResponse.d.ts

@@ -0,0 +1,5 @@
+import { Organization } from 'fhir/r4b';
+/**
+ * A valid FHIR Organization object corresponding to the payer.
+ */
+export type RcmGetPayerResponse = Organization;

package/dist/esm/resources/types/RcmListPayersParams.d.ts

@@ -0,0 +1,5 @@
+export interface RcmListPayersParams {
+    name?: string;
+    identifier?: string;
+    includeInactive?: boolean;
+}

package/dist/esm/resources/types/RcmListPayersResponse.d.ts

@@ -0,0 +1,5 @@
+import { Organization } from 'fhir/r4b';
+/**
+ * List of payers matching the search criteria.
+ */
+export type RcmListPayersResponse = Organization[];

package/dist/esm/resources/types/RcmSetClaimStatusParams.d.ts

@@ -0,0 +1,7 @@
+export interface RcmSetClaimStatusParams {
+    /**
+     * The new status for the claim.
+     */
+    status: 'accepted' | 'rejected';
+    claimId: string;
+}

package/dist/esm/resources/types/RcmSetClaimStatusResponse.d.ts

@@ -0,0 +1,5 @@
+import { ClaimResponse } from 'fhir/r4b';
+/**
+ * A valid FHIR ClaimResponse object will be returned with details on the claim result.
+ */
+export type RcmSetClaimStatusResponse = ClaimResponse;

package/dist/esm/resources/types/RcmSubmitClaimParams.d.ts

@@ -0,0 +1,3 @@
+export interface RcmSubmitClaimParams {
+    claimId: string;
+}

package/dist/esm/resources/types/RcmSubmitClaimResponse.d.ts

@@ -0,0 +1,5 @@
+import { ClaimResponse } from 'fhir/r4b';
+/**
+ * A valid FHIR ClaimResponse object will be returned with details on the claim result.
+ */
+export type RcmSubmitClaimResponse = ClaimResponse;

package/dist/esm/resources/types/UserChangePasswordParams.d.ts

@@ -0,0 +1,7 @@
+export interface UserChangePasswordParams {
+    /**
+     * The new password for the user.
+     */
+    password: string;
+    id: string;
+}

package/dist/esm/resources/types/index.d.ts

@@ -8,9 +8,6 @@ export * from './Application';
 export * from './RoleStub';
 export * from './RoleListItem';
 export * from './Role';
-export * from './ZambdaSchedule';
-export * from './ZambdaFunction';
-export * from './ZambdaExecuteResult';
 export * from './Secret';
 export * from './SecretListItem';
 export * from './UserListItem';
@@ -87,12 +84,6 @@ export * from './ChargeStatusResponse';
 export * from './ProjectGetResponse';
 export * from './ProjectUpdateParams';
 export * from './ProjectUpdateResponse';
-export * from './RcmEligibilityCheckParams';
-export * from './RcmEligibilityCheckResponse';
-export * from './RcmValidateProfessionalClaimParams';
-export * from './RcmValidateProfessionalClaimResponse';
-export * from './RcmSubmitProfessionalClaimParams';
-export * from './RcmSubmitProfessionalClaimResponse';
 export * from './RoleListResponse';
 export * from './RoleCreateParams';
 export * from './RoleCreateResponse';
@@ -119,6 +110,7 @@ export * from './UserUpdateResponse';
 export * from './UserDeleteParams';
 export * from './UserResetMfaParams';
 export * from './UserResetPasswordLinkParams';
+export * from './UserChangePasswordParams';
 export * from './UserInviteParams';
 export * from './UserInviteResponse';
 export * from './UserListResponse';
@@ -134,26 +126,6 @@ export * from './Z3ListObjectsResponse';
 export * from './Z3GetPresignedUrlParams';
 export * from './Z3GetPresignedUrlResponse';
 export * from './Z3DeleteObjectParams';
-export * from './ZambdaListResponse';
-export * from './ZambdaCreateParams';
-export * from './ZambdaCreateResponse';
-export * from './ZambdaGetParams';
-export * from './ZambdaGetResponse';
-export * from './ZambdaUpdateParams';
-export * from './ZambdaUpdateResponse';
-export * from './ZambdaDeleteParams';
-export * from './ZambdaExecuteParams';
-export * from './ZambdaExecuteResponse';
-export * from './ZambdaExecutePublicParams';
-export * from './ZambdaExecutePublicResponse';
-export * from './ZambdaLogStreamListParams';
-export * from './ZambdaLogStreamListResponse';
-export * from './ZambdaS3UploadParams';
-export * from './ZambdaS3UploadResponse';
-export * from './ZambdaLogStreamSearchParams';
-export * from './ZambdaLogStreamSearchResponse';
-export * from './ZambdaLogStreamGetParams';
-export * from './ZambdaLogStreamGetResponse';
 export * from './FaxOnboardResponse';
 export * from './FaxGetConfigurationResponse';
 export * from './FaxSendParams';
@@ -184,6 +156,8 @@ export * from './ErxCheckMedicationInteractionsParams';
 export * from './ErxCheckMedicationInteractionsResponse';
 export * from './ErxCheckPrecheckInteractionsParams';
 export * from './ErxCheckPrecheckInteractionsResponse';
+export * from './ErxGetMedicationHistoryParams';
+export * from './ErxGetMedicationHistoryResponse';
 export * from './ErxAddPatientPharmacyParams';
 export * from './ErxCancelPrescriptionParams';
 export * from './ErxSyncPatientParams';
@@ -199,3 +173,36 @@ export * from './TerminologySearchCptParams';
 export * from './TerminologySearchCptResponse';
 export * from './TerminologySearchHcpcsParams';
 export * from './TerminologySearchHcpcsResponse';
+export * from './ZambdaSchedule';
+export * from './ZambdaFunction';
+export * from './ZambdaExecuteResult';
+export * from './ZambdaListResponse';
+export * from './ZambdaCreateParams';
+export * from './ZambdaCreateResponse';
+export * from './ZambdaGetParams';
+export * from './ZambdaGetResponse';
+export * from './ZambdaUpdateParams';
+export * from './ZambdaUpdateResponse';
+export * from './ZambdaDeleteParams';
+export * from './ZambdaExecuteParams';
+export * from './ZambdaExecuteResponse';
+export * from './ZambdaExecutePublicParams';
+export * from './ZambdaExecutePublicResponse';
+export * from './ZambdaLogStreamListParams';
+export * from './ZambdaLogStreamListResponse';
+export * from './ZambdaS3UploadParams';
+export * from './ZambdaS3UploadResponse';
+export * from './ZambdaLogStreamSearchParams';
+export * from './ZambdaLogStreamSearchResponse';
+export * from './ZambdaLogStreamGetParams';
+export * from './ZambdaLogStreamGetResponse';
+export * from './RcmEligibilityCheckParams';
+export * from './RcmEligibilityCheckResponse';
+export * from './RcmSubmitClaimParams';
+export * from './RcmSubmitClaimResponse';
+export * from './RcmSetClaimStatusParams';
+export * from './RcmSetClaimStatusResponse';
+export * from './RcmListPayersParams';
+export * from './RcmListPayersResponse';
+export * from './RcmGetPayerParams';
+export * from './RcmGetPayerResponse';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oystehr/sdk",
-  "version": "4.3.1",
+  "version": "4.3.3",
   "description": "Oystehr SDK",
   "scripts": {
     "lint": "eslint .",
@@ -14,7 +14,7 @@
     "parser": "tsx debug-parser.ts",
     "publish-to-npmjs": "npm run build && npm publish",
     "publish-to-npmjs-next": "npm run build && npm publish --tag next",
-    "generate": "ts-node --project scripts/tsconfig.json scripts/generate-sdk-v3 project,fax,lab,erx,terminology src/resources"
+    "generate": "ts-node --project scripts/tsconfig.json scripts/generate-sdk-v3 project,fax,lab,erx,terminology,zambda,rcm src/resources"
   },
   "engines": {
     "npm": ">=8.0.0",

package/src/client/client.ts

@@ -1,6 +1,7 @@
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4, validate as uuidValidate } from 'uuid';
 import { OystehrConfig } from '../config';
 import { OystehrFHIRError, OystehrSdkError } from '../errors';
+import { Logger } from '../logger';
 import { FhirBundle, FhirResource, OperationOutcome } from '../resources/types';
 
 type HttpMethod = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
@@ -51,17 +52,24 @@ export type FhirFetcherResponse<T extends FhirData<FhirResource> = any> = T;
 
 export class SDKResource {
   protected readonly config: OystehrConfig;
+  protected readonly logger: Logger;
   constructor(config: OystehrConfig) {
     this.config = config;
+    this.logger = new Logger({
+      level: this.config.logLevel,
+    });
   }
 
   protected request(path: string, method: string, baseUrlThunk: () => string): FetcherFunction {
     return async (params: any, request?: InternalClientRequest): Promise<FetcherResponse> => {
       const configThunk = (): OystehrConfig => this.config;
+      const loggerThunk = (): Logger => this.logger;
       try {
-        return await fetcher(baseUrlThunk, configThunk, path, method)(params, request);
+        // must await here to catch
+        return await fetcher(baseUrlThunk, configThunk, loggerThunk, path, method)(params, request);
       } catch (err: any) {
         const error = err as { message: string; code: number; cause?: unknown };
+        this.logger.error(error.message, { code: error.code, cause: error.cause });
         throw new OystehrSdkError({ message: error.message, code: error.code, cause: error.cause });
       }
     };
@@ -72,8 +80,9 @@ export class SDKResource {
       try {
         const baseUrlThunk = (): string => this.config.services?.fhirApiUrl ?? defaultFhirApiUrl;
         const configThunk = (): OystehrConfig => this.config;
+        const loggerThunk = (): Logger => this.logger;
         // must await here to catch
-        return await fetcher(baseUrlThunk, configThunk, path, method)(params, request);
+        return await fetcher(baseUrlThunk, configThunk, loggerThunk, path, method)(params, request);
       } catch (err: unknown) {
         // FHIR API error messages are JSON strings
         const fullError = err as { message: string | Record<string, any>; code: number; cause?: unknown };
@@ -101,7 +110,13 @@ export type FetcherFunction = (
 ) => Promise<FetcherResponse>;
 
 function isInternalClientRequest(request: Record<string, any>): request is InternalClientRequest {
-  return 'accessToken' in request;
+  return (
+    'accessToken' in request ||
+    ('projectId' in request && uuidValidate(request.projectId)) ||
+    ('contentType' in request && request.contentType?.split('/').length === 2) ||
+    'requestId' in request ||
+    ('ifMatch' in request && request.ifMatch.startsWith('W/"'))
+  );
 }
 
 /**
@@ -130,6 +145,7 @@ function parseXmlResponse(xmlString: string): Record<string, unknown> | null {
 function fetcher(
   baseUrlThunk: () => string,
   configThunk: () => OystehrConfig,
+  loggerThunk: () => Logger,
   path: string,
   methodParam: string
 ): FetcherFunction {
@@ -141,19 +157,21 @@ function fetcher(
     // or fetcher(baseUrl, path, method)(params) or fetcher(baseUrl, path, method)(). the types for this are handled by Client<Path, Methods>
     // and this is the backend implementation behind it. the heuristic we're using is that if the first param is an object with an accessToken
     // and there is no second param, assume the first one is the request object instead
-    const providedParams: Record<string, unknown> | [any] =
-      !!params && !request && !Array.isArray(params) && isInternalClientRequest(params)
-        ? {}
-        : (params as Record<string, unknown>) ?? {};
-    const requestCtx =
-      !!params && !request && !Array.isArray(params) && isInternalClientRequest(params)
-        ? (params as InternalClientRequest)
-        : request;
-    const method = methodParam.toLowerCase() as HttpMethod;
+    // eslint-disable-next-line prefer-const
+    let [providedParams, requestCtx] = extractParamsAndRequest(params, request);
+    requestCtx ??= {};
+    requestCtx.requestId ??= uuidv4();
     const config = configThunk();
+    const logger = loggerThunk();
+    const method = methodParam.toLowerCase() as HttpMethod;
+    logger.debug('Beginning fetch', {
+      method,
+      path,
+      requestId: requestCtx?.requestId,
+    });
     const fetchImpl = config.fetch ?? fetch;
     const accessToken = requestCtx?.accessToken ?? config.accessToken;
-    const projectId = requestCtx?.projectId ?? configThunk().projectId;
+    const projectId = requestCtx?.projectId ?? config.projectId;
     let finalPath = path;
     let finalParams = providedParams;
     if (!Array.isArray(providedParams)) {
@@ -161,6 +179,11 @@ function fetcher(
       finalPath = subbedPath;
       finalParams = addlParams;
     }
+    logger.debug('Substituted parameters in path', {
+      method,
+      path,
+      requestId: requestCtx?.requestId,
+    });
     finalPath = finalPath.replace(/^\//, ''); // remove leading slash
     const baseUrlEvaluated = baseUrlThunk();
     const fullBaseUrl = baseUrlEvaluated.endsWith('/') ? baseUrlEvaluated : baseUrlEvaluated + '/';
@@ -185,6 +208,11 @@ function fetcher(
         body = '{}';
       }
     }
+    logger.debug('Prepared request body', {
+      method,
+      path,
+      requestId: requestCtx?.requestId,
+    });
 
     const headers: Record<string, string> = Object.assign(
       projectId
@@ -198,7 +226,7 @@ function fetcher(
       },
       accessToken ? { Authorization: `Bearer ${accessToken}` } : {},
       requestCtx?.ifMatch ? { 'If-Match': requestCtx.ifMatch } : {},
-      { 'x-oystehr-request-id': requestCtx?.requestId ?? uuidv4() }
+      { 'x-oystehr-request-id': requestCtx?.requestId }
     );
     const retryConfig: ConstructedRetryConfig = {
       retries: config.retry?.retries ?? 3,
@@ -210,6 +238,12 @@ function fetcher(
     };
     retryConfig.retryOn.push(...STATUS_CODES_TO_RETRY);
     return retry(async () => {
+      logger.info('Request start', {
+        method,
+        url,
+        requestId: requestCtx?.requestId,
+      });
+      const now = Date.now();
       const response = await fetchImpl(
         new Request(url, {
           method: method.toUpperCase(),
@@ -217,6 +251,12 @@ function fetcher(
           headers,
         })
       );
+      logger.info('Request end', {
+        method,
+        url,
+        duration: Date.now() - now,
+        requestId: requestCtx?.requestId,
+      });
       const responseBody = response.body ? await response.text() : null;
       let responseJson: Record<string, unknown> | null;
       const contentType = response.headers.get('content-type');
@@ -225,10 +265,30 @@ function fetcher(
           responseBody &&
           (contentType?.includes('application/json') || contentType?.includes('application/fhir+json'))
         ) {
+          logger.time('Deserialized JSON response', {
+            method,
+            url,
+            requestId: requestCtx?.requestId,
+          });
           responseJson = JSON.parse(responseBody);
+          logger.timeEnd('Deserialized JSON response', {
+            method,
+            url,
+            requestId: requestCtx?.requestId,
+          });
         } else if (responseBody && (contentType?.includes('application/xml') || contentType?.includes('text/xml'))) {
           // Parse XML response into { status, output } structure
+          logger.time('Deserialized XML response', {
+            method,
+            url,
+            requestId: requestCtx?.requestId,
+          });
           responseJson = parseXmlResponse(responseBody);
+          logger.timeEnd('Deserialized XML response', {
+            method,
+            url,
+            requestId: requestCtx?.requestId,
+          });
         } else {
           responseJson = null;
         }
@@ -236,6 +296,11 @@ function fetcher(
         // ignore JSON.parse errors
         responseJson = null;
       }
+      logger.debug('Deserialized response', {
+        method,
+        url,
+        requestId: requestCtx?.requestId,
+      });
       const isError = !response.ok || response.status >= 400;
       if (isError) {
         const errObj = {
@@ -349,3 +414,18 @@ export function addParamsToSearch(params: Record<string, unknown>, search: URLSe
     search.append(key, value as string);
   }
 }
+
+export function extractParamsAndRequest(
+  params?: Record<string, unknown> | [any] | InternalClientRequest,
+  request?: InternalClientRequest
+): [Record<string, unknown>, InternalClientRequest | undefined] {
+  const providedParams: Record<string, unknown> | [any] =
+    !!params && !request && !Array.isArray(params) && isInternalClientRequest(params)
+      ? {}
+      : (params as Record<string, unknown>) ?? {};
+  const requestCtx =
+    !!params && !request && !Array.isArray(params) && isInternalClientRequest(params)
+      ? (params as InternalClientRequest)
+      : request;
+  return [providedParams, requestCtx];
+}

package/src/config.ts

@@ -10,6 +10,10 @@ export interface OystehrConfig {
    * Optional Oystehr Project ID. Required for developer accessTokens.
    */
   projectId?: string;
+  /**
+   * Optional log level for the SDK logger. Possible values are 'error', 'info', and 'debug'.
+   */
+  logLevel?: 'error' | 'info' | 'debug';
   fhirApiUrl?: string;
   projectApiUrl?: string;
   services?: {
@@ -18,7 +22,9 @@ export interface OystehrConfig {
     fhirApiUrl?: string;
     labApiUrl?: string;
     projectApiUrl?: string;
+    rcmApiUrl?: string;
     terminologyApiUrl?: string;
+    zambdaApiUrl?: string;
   };
   /**
    * Optionally provide a custom fetch implementation. This must conform to the

package/src/logger.ts

@@ -0,0 +1,36 @@
+export class Logger {
+  _level?: 'error' | 'info' | 'debug';
+  constructor({ level }: { level?: 'error' | 'info' | 'debug' }) {
+    this._level = level;
+  }
+
+  error(message: string, extra: Record<string, any> = {}): void {
+    if (this._level && ['error', 'info', 'debug'].includes(this._level)) {
+      console.error(JSON.stringify({ message, ...extra }));
+    }
+  }
+
+  info(message: string, extra: Record<string, any> = {}): void {
+    if (this._level && ['info', 'debug'].includes(this._level)) {
+      console.info(JSON.stringify({ message, ...extra }));
+    }
+  }
+
+  debug(message: string, extra: Record<string, any> = {}): void {
+    if (this._level && ['debug'].includes(this._level)) {
+      console.debug(JSON.stringify({ message, ...extra }));
+    }
+  }
+
+  time(message: string, extra: Record<string, any> = {}): void {
+    if (this._level && ['debug'].includes(this._level)) {
+      console.time(JSON.stringify({ message, ...extra }));
+    }
+  }
+
+  timeEnd(message: string, extra: Record<string, any> = {}): void {
+    if (this._level && ['debug'].includes(this._level)) {
+      console.timeEnd(JSON.stringify({ message, ...extra }));
+    }
+  }
+}

package/src/resources/classes/erx.ts

@@ -15,6 +15,8 @@ import {
   ErxConnectPractitionerResponse,
   ErxEnrollPractitionerParams,
   ErxGetConfigurationResponse,
+  ErxGetMedicationHistoryParams,
+  ErxGetMedicationHistoryResponse,
   ErxGetMedicationParams,
   ErxGetMedicationResponse,
   ErxSearchAllergensParams,
@@ -135,6 +137,21 @@ export class Erx extends SDKResource {
       this.#baseUrlThunk.bind(this)
     )(params, request);
   }
+  /**
+   * Retrieve claims-based medication history for a patient. This endpoint requires the patient to be synced with the upstream eRx provider.
+   * Action: `eRx:GetMedicationHistory`
+   * Access Policy Resource: `eRx:Patient`
+   */
+  getMedicationHistory(
+    params: ErxGetMedicationHistoryParams,
+    request?: OystehrClientRequest
+  ): Promise<ErxGetMedicationHistoryResponse> {
+    return this.request(
+      '/patient/{patientId}/medication-history',
+      'get',
+      this.#baseUrlThunk.bind(this)
+    )(params, request);
+  }
   /**
    * Adds pharmacy for a patient with the upstream eRx provider, setting it as primary if specified.
    * Action: `eRx:AddPatientPharmacy`

package/src/resources/classes/index.ts

@@ -36,19 +36,19 @@ export class Oystehr {
   readonly paymentMethod: PaymentMethod;
   readonly charge: Charge;
   readonly project: Project;
-  readonly rcm: Rcm;
   readonly role: Role;
   readonly secret: Secret;
   readonly telemed: Telemed;
   readonly user: User;
   readonly version: Version;
   readonly z3: Z3;
-  readonly zambda: Zambda;
-  readonly zambdaLogStream: ZambdaLogStream;
   readonly fax: Fax;
   readonly lab: Lab;
   readonly erx: Erx;
   readonly terminology: Terminology;
+  readonly zambda: Zambda;
+  readonly zambdaLogStream: ZambdaLogStream;
+  readonly rcm: Rcm;
   readonly fhir: Fhir;
   constructor(config: OystehrConfig) {
     this.config = config;
@@ -64,19 +64,19 @@ export class Oystehr {
     this.paymentMethod = new PaymentMethod(config);
     this.charge = new Charge(config);
     this.project = new Project(config);
-    this.rcm = new Rcm(config);
     this.role = new Role(config);
     this.secret = new Secret(config);
     this.telemed = new Telemed(config);
     this.user = new User(config);
     this.version = new Version(config);
     this.z3 = new Z3(config);
-    this.zambda = new Zambda(config);
-    this.zambdaLogStream = new ZambdaLogStream(config);
     this.fax = new Fax(config);
     this.lab = new Lab(config);
     this.erx = new Erx(config);
     this.terminology = new Terminology(config);
+    this.zambda = new Zambda(config);
+    this.zambdaLogStream = new ZambdaLogStream(config);
+    this.rcm = new Rcm(config);
     this.fhir = new Fhir(config);
   }
 }