@metriport/api-sdk 6.0.1-alpha.1

package/src/medical/models/common/us-data.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+
+export enum USState {
+  AL = "AL",
+  AK = "AK",
+  AZ = "AZ",
+  AR = "AR",
+  CA = "CA",
+  CO = "CO",
+  CT = "CT",
+  DE = "DE",
+  DC = "DC",
+  FL = "FL",
+  GA = "GA",
+  HI = "HI",
+  ID = "ID",
+  IL = "IL",
+  IN = "IN",
+  IA = "IA",
+  KS = "KS",
+  KY = "KY",
+  LA = "LA",
+  ME = "ME",
+  MD = "MD",
+  MA = "MA",
+  MI = "MI",
+  MN = "MN",
+  MS = "MS",
+  MO = "MO",
+  MT = "MT",
+  NE = "NE",
+  NV = "NV",
+  NH = "NH",
+  NJ = "NJ",
+  NM = "NM",
+  NY = "NY",
+  NC = "NC",
+  ND = "ND",
+  OH = "OH",
+  OK = "OK",
+  OR = "OR",
+  PA = "PA",
+  RI = "RI",
+  SC = "SC",
+  SD = "SD",
+  TN = "TN",
+  TX = "TX",
+  UT = "UT",
+  VT = "VT",
+  VA = "VA",
+  WA = "WA",
+  WV = "WV",
+  WI = "WI",
+  WY = "WY",
+}
+export const usStateSchema = z.nativeEnum(USState);

package/src/medical/models/demographics.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { addressSchema } from "./common/address";
+import { usStateSchema } from "./common/us-data";
+import {
+  defaultDateString,
+  defaultNameString,
+  defaultOptionalString,
+  stripNonNumericChars,
+} from "../../shared";
+
+const basePersonalIdentifierSchema = z.object({
+  value: z.string(),
+  period: z
+    .object({
+      start: z.string(),
+      end: z.string().optional(),
+    })
+    .or(
+      z.object({
+        start: z.string().optional(),
+        end: z.string(),
+      })
+    )
+    .optional(),
+  assigner: z.string().optional(),
+});
+
+export const driverLicenseIdentifierSchema = z.object({
+  type: z.literal("driversLicense"),
+  state: usStateSchema,
+});
+
+export const personalIdentifierSchema = basePersonalIdentifierSchema.merge(
+  driverLicenseIdentifierSchema
+);
+export type PersonalIdentifier = z.infer<typeof personalIdentifierSchema>;
+
+export const genderAtBirthSchema = z.enum(["F", "M"]);
+
+const phoneLength = 10;
+export const contactSchema = z
+  .object({
+    phone: z.coerce
+      .string()
+      .transform(phone => stripNonNumericChars(phone))
+      .refine(phone => phone.length === phoneLength, {
+        message: `Phone must be a string consisting of ${phoneLength} numbers. For example: 4153245540`,
+      })
+      .or(defaultOptionalString),
+    email: z.string().email().or(defaultOptionalString),
+  })
+  .refine(c => c.email || c.phone, { message: "Either email or phone must be present" });
+
+export const demographicsSchema = z.object({
+  firstName: defaultNameString,
+  lastName: defaultNameString,
+  dob: defaultDateString,
+  genderAtBirth: genderAtBirthSchema,
+  personalIdentifiers: z.array(personalIdentifierSchema).optional(),
+  address: z.array(addressSchema).or(addressSchema),
+  contact: z.array(contactSchema).optional().or(contactSchema.optional()),
+});
+export type Demographics = z.infer<typeof demographicsSchema>;

package/src/medical/models/document.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+export const documentReferenceSchema = z.object({
+  id: z.string(),
+  fileName: z.string(),
+  location: z.string(),
+  description: z.string().optional(),
+  status: z.string().optional(),
+  indexed: z.string().optional(), // ISO-8601
+  mimeType: z.string().optional(),
+  size: z.number().optional(), // bytes
+  type: z
+    .object({
+      coding: z
+        .array(
+          z.object({
+            system: z.string().optional().nullable(),
+            code: z.string().optional().nullable(),
+            display: z.string().optional().nullable(),
+          })
+        )
+        .optional(),
+      text: z.string().optional(),
+    })
+    .optional(),
+});
+export type DocumentReference = z.infer<typeof documentReferenceSchema>;
+
+export const documentQueryStatusSchema = z.enum(["processing", "completed", "failed"]);
+export type DocumentQueryStatus = z.infer<typeof documentQueryStatusSchema>;
+
+export const progressSchema = z.object({
+  status: documentQueryStatusSchema,
+  total: z.number().optional(),
+  successful: z.number().optional(),
+  errors: z.number().optional(),
+});
+
+export const documentQuerySchema = z.object({
+  download: progressSchema.optional(),
+  convert: progressSchema.optional(),
+});
+
+export type DocumentQuery = z.infer<typeof documentQuerySchema>;
+
+export const documentListSchema = z.object({
+  documents: z.array(documentReferenceSchema),
+});
+export type DocumentList = z.infer<typeof documentListSchema>;

package/src/medical/models/facility.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { addressSchema } from "./common/address";
+import { baseUpdateSchema } from "./common/base-update";
+import { validateNPI } from "@metriport/commonwell-sdk/common/validate-npi";
+
+export const facilityCreateSchema = z.object({
+  name: z.string().min(1),
+  npi: z
+    .string()
+    .length(10)
+    .refine(npi => validateNPI(npi), { message: "NPI is not valid" }),
+  tin: z.string().optional().nullable(),
+  active: z.boolean().optional().nullable(),
+  address: addressSchema,
+});
+export type FacilityCreate = z.infer<typeof facilityCreateSchema>;
+
+export const facilitySchema = facilityCreateSchema.merge(baseUpdateSchema);
+export type Facility = z.infer<typeof facilitySchema>;
+
+export const facilityListSchema = z.object({
+  facilities: z.array(facilitySchema),
+});

package/src/medical/models/organization.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { addressSchema } from "./common/address";
+import { baseUpdateSchema } from "./common/base-update";
+
+export enum OrgType {
+  acuteCare = "acuteCare",
+  ambulatory = "ambulatory",
+  hospital = "hospital",
+  labSystems = "labSystems",
+  pharmacy = "pharmacy",
+  postAcuteCare = "postAcuteCare",
+}
+
+export const orgTypeSchema = z.nativeEnum(OrgType);
+
+export const organizationCreateSchema = z.object({
+  name: z.string(),
+  type: orgTypeSchema,
+  location: addressSchema,
+});
+export type OrganizationCreate = z.infer<typeof organizationCreateSchema>;
+
+export const organizationSchema = organizationCreateSchema.merge(baseUpdateSchema);
+export type Organization = z.infer<typeof organizationSchema>;

package/src/medical/models/patient.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { baseUpdateSchema } from "./common/base-update";
+import { demographicsSchema } from "./demographics";
+
+export const patientCreateSchema = demographicsSchema;
+export type PatientCreate = z.infer<typeof patientCreateSchema>;
+
+export const patientUpdateSchema = patientCreateSchema.merge(baseUpdateSchema);
+export type PatientUpdate = z.infer<typeof patientUpdateSchema>;
+
+export const patientSchema = patientUpdateSchema.extend({
+  facilityIds: z.array(z.string()),
+});
+export type Patient = z.infer<typeof patientSchema>;
+
+export const patientListSchema = z.object({
+  patients: z.array(patientSchema),
+});

package/src/shared.ts

@@ -0,0 +1,25 @@
+import dayjs from "dayjs";
+import { z, ZodString } from "zod";
+
+export const BASE_ADDRESS = "https://api.metriport.com";
+export const BASE_ADDRESS_SANDBOX = "https://api.sandbox.metriport.com";
+export const API_KEY_HEADER = "x-api-key";
+export const DEFAULT_AXIOS_TIMEOUT_MILLIS = 20_000;
+
+export const emptyStringToUndefined = (v: string | undefined | null) =>
+  v == null || v.length < 1 ? undefined : v;
+
+export const optionalString = (zodSchema: ZodString) =>
+  zodSchema.or(z.string().optional()).transform(emptyStringToUndefined);
+
+export function stripNonNumericChars(str: string): string {
+  return str.trim().replace(/\D/g, "");
+}
+
+export const ISO_DATE = "YYYY-MM-DD";
+export const defaultString = z.string().trim();
+export const defaultOptionalString = optionalString(defaultString);
+export const defaultDateString = defaultString.refine(v => dayjs(v, ISO_DATE, true).isValid(), {
+  message: `Date must be a valid ISO 8601 date formatted ${ISO_DATE}. Example: 2023-05-03`,
+});
+export const defaultNameString = defaultString.min(1);

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "extends": "@tsconfig/recommended/tsconfig.json",
+  "compilerOptions": {
+    "target": "es2020",
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true, // enables importers to jump to source
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    // START - From @tsconfig/strictest
+    "allowUnusedLabels": false,
+    "allowUnreachableCode": false,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noUnusedLocals": true,
+    "checkJs": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitReturns": true,
+    // END - From @tsconfig/strictest
+    "outDir": "./dist"
+  },
+  "include": ["./src"],
+  "exclude": ["./dist"]
+}

package/tsconfig.ref.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["src/**/*"],
+  "compilerOptions": {
+    "composite": true,
+  },
+}