@healthcloudai/hc-settings-connector 0.2.1 → 0.2.2

package/README.md

@@ -13,7 +13,8 @@ This connector gives authenticated patients access to account information and do
 3. Submit uploaded identification and insurance images for capture.
 4. Submit and retrieve insurance information.
 5. Update the patient profile image.
-6. Deactivate the authenticated patient account.
+6. Capture registration documents before the patient is authenticated.
+7. Deactivate the authenticated patient account.
 
 ---
 
@@ -59,7 +60,7 @@ const settingsClient = new HCSettingsClient(
 );
 ```
 
-`HCLoginClient` must be configured and authenticated before calling Settings methods.
+`HCLoginClient` must be configured before creating the Settings client. Most Settings methods require an authenticated patient session. `captureRegistrationDocument(...)` is intended for unauthenticated registration flows and does not send the auth token.
 
 ---
 
@@ -677,6 +678,77 @@ console.log(response);
 
 ---
 
+# Registration Document Capture
+
+Registration document capture is used during registration, before the user is authenticated. It sends the same capture request shape as patient capture, but it does not attach the patient authorization token.
+
+## Capture Registration Document
+
+Public signature:
+
+```ts
+settingsClient.captureRegistrationDocument(
+  fileKey,
+  type
+)
+```
+
+`type` must be one of:
+
+```ts
+"identification" | "healthinsurance"
+```
+
+Only `loginClient.configure(...)` is required for this method so the connector can resolve the API base URL.
+
+```ts
+const response =
+  await settingsClient.captureRegistrationDocument(
+    "idcard_example.jpeg",
+    "identification"
+  );
+
+console.log(response);
+```
+
+### API request
+
+```json
+{
+  "Data": {
+    "Type": "identification",
+    "FileID": "idcard_example.jpeg"
+  }
+}
+```
+
+### API response
+
+```json
+{
+  "Data": {
+    "CapturedData": {
+      "FirstName": "John",
+      "LastName": "Doe",
+      "StreetAddress": "123 Main St",
+      "City": "Springfield",
+      "ZipCode": "90210",
+      "State": "California",
+      "IssuedDate": "01/01/2024",
+      "ExpiresDate": "01/01/2028",
+      "Dob": "01/01/1990",
+      "IDNumber": null
+    },
+    "IsCaptured": true,
+    "InsurancePackages": null
+  },
+  "ErrorMessage": null,
+  "IsOK": true
+}
+```
+
+---
+
 # Account
 
 ## Deactivate User
@@ -726,6 +798,7 @@ console.log(response);
 * `captureDrivingLicense(...)` internally sends `Type: "identification"`.
 * `captureInsurance(...)` internally sends `Type: "healthinsurance"`.
 * `captureUserPhoto(...)` internally sends `Type: "userphoto"`.
+* `captureRegistrationDocument(...)` does not send the patient auth token.
 
 ```
 ```
@@ -735,7 +808,7 @@ console.log(response);
 
 ## Prerequisites
 
-`HCLoginClient` must be configured and the patient must be logged in before calling any method on this connector.
+`HCLoginClient` must be configured before using this connector. Most methods require the patient to be logged in. `captureRegistrationDocument(...)` is the unauthenticated exception and does not send the auth token.
 
 ```ts
 import { HCLoginClient } from "@healthcloudai/hc-login-connector";

package/dist/index.cjs

@@ -240,6 +240,29 @@ var HCSettingsClient = class extends import_hc_http.HCBaseConnector {
     );
   }
   // ===========================================================================
+  // Registration document capture
+  // ===========================================================================
+  /**
+   * Submits an uploaded registration document for capture without sending
+   * an authenticated patient token.
+   * fileKey is the storage key of the uploaded image.
+   */
+  async captureRegistrationDocument(fileKey, type) {
+    const resolvedFileKey = this.requireValue(fileKey, "File key", "fileKey");
+    const resolvedType = this.requireValue(type, "Capture type", "type");
+    const requestPayload = {
+      Data: { Type: resolvedType, FileID: resolvedFileKey }
+    };
+    return this.execute(
+      "captureRegistrationDocument",
+      () => this.http.post(
+        `${this.auth.getBaseUrl()}/api/registrationdocument/capture`,
+        requestPayload,
+        this.getHeaders()
+      )
+    );
+  }
+  // ===========================================================================
   // Account
   // ===========================================================================
   /**

package/dist/index.d.cts

@@ -51,7 +51,7 @@ interface PatientDashboard {
     EHR: string | null;
     PendingActions: string[];
 }
-type CaptureType = "healthinsurance" | "identification" | "userphoto";
+type CaptureType = "healthinsurance" | "identification";
 interface InsuranceCaptureData {
     FirstName: string | null;
     LastName: string | null;
@@ -83,6 +83,7 @@ interface CaptureResult<T> {
     IsCaptured: boolean;
     InsurancePackages: object[] | null;
 }
+type RegistrationDocumentCaptureResult = CaptureResult<InsuranceCaptureData | IdentificationCaptureData>;
 interface InsuranceRecord {
     LastUpdatedBy: string | null;
     IrcName: string | null;
@@ -164,6 +165,12 @@ declare class HCSettingsClient extends HCBaseConnector {
      * fileKey is the storage key of the uploaded image.
      */
     captureUserPhoto(fileKey: string): Promise<APIResponse<CaptureResult<UserPhotoCaptureData>>>;
+    /**
+     * Submits an uploaded registration document for capture without sending
+     * an authenticated patient token.
+     * fileKey is the storage key of the uploaded image.
+     */
+    captureRegistrationDocument(fileKey: string, type: CaptureType): Promise<APIResponse<RegistrationDocumentCaptureResult>>;
     /**
      * Soft-deactivates the current patient account.
      * The patient record is not permanently deleted.
@@ -172,4 +179,4 @@ declare class HCSettingsClient extends HCBaseConnector {
     private getAuthHeaders;
 }
 
-export { type CaptureResult, type CaptureType, type CoverageData, type Encounter, HCSettingsClient, type IdentificationCaptureData, type InsuranceCaptureData, type InsuranceRecord, type PatientDashboard, type PatientRecord, type UserImage, type UserPhotoCaptureData, UserStatus };
+export { type CaptureResult, type CaptureType, type CoverageData, type Encounter, HCSettingsClient, type IdentificationCaptureData, type InsuranceCaptureData, type InsuranceRecord, type PatientDashboard, type PatientRecord, type RegistrationDocumentCaptureResult, type UserImage, type UserPhotoCaptureData, UserStatus };

package/dist/index.d.ts

@@ -51,7 +51,7 @@ interface PatientDashboard {
     EHR: string | null;
     PendingActions: string[];
 }
-type CaptureType = "healthinsurance" | "identification" | "userphoto";
+type CaptureType = "healthinsurance" | "identification";
 interface InsuranceCaptureData {
     FirstName: string | null;
     LastName: string | null;
@@ -83,6 +83,7 @@ interface CaptureResult<T> {
     IsCaptured: boolean;
     InsurancePackages: object[] | null;
 }
+type RegistrationDocumentCaptureResult = CaptureResult<InsuranceCaptureData | IdentificationCaptureData>;
 interface InsuranceRecord {
     LastUpdatedBy: string | null;
     IrcName: string | null;
@@ -164,6 +165,12 @@ declare class HCSettingsClient extends HCBaseConnector {
      * fileKey is the storage key of the uploaded image.
      */
     captureUserPhoto(fileKey: string): Promise<APIResponse<CaptureResult<UserPhotoCaptureData>>>;
+    /**
+     * Submits an uploaded registration document for capture without sending
+     * an authenticated patient token.
+     * fileKey is the storage key of the uploaded image.
+     */
+    captureRegistrationDocument(fileKey: string, type: CaptureType): Promise<APIResponse<RegistrationDocumentCaptureResult>>;
     /**
      * Soft-deactivates the current patient account.
      * The patient record is not permanently deleted.
@@ -172,4 +179,4 @@ declare class HCSettingsClient extends HCBaseConnector {
     private getAuthHeaders;
 }
 
-export { type CaptureResult, type CaptureType, type CoverageData, type Encounter, HCSettingsClient, type IdentificationCaptureData, type InsuranceCaptureData, type InsuranceRecord, type PatientDashboard, type PatientRecord, type UserImage, type UserPhotoCaptureData, UserStatus };
+export { type CaptureResult, type CaptureType, type CoverageData, type Encounter, HCSettingsClient, type IdentificationCaptureData, type InsuranceCaptureData, type InsuranceRecord, type PatientDashboard, type PatientRecord, type RegistrationDocumentCaptureResult, type UserImage, type UserPhotoCaptureData, UserStatus };

package/dist/index.js

@@ -208,6 +208,29 @@ var HCSettingsClient = class extends HCBaseConnector {
     );
   }
   // ===========================================================================
+  // Registration document capture
+  // ===========================================================================
+  /**
+   * Submits an uploaded registration document for capture without sending
+   * an authenticated patient token.
+   * fileKey is the storage key of the uploaded image.
+   */
+  async captureRegistrationDocument(fileKey, type) {
+    const resolvedFileKey = this.requireValue(fileKey, "File key", "fileKey");
+    const resolvedType = this.requireValue(type, "Capture type", "type");
+    const requestPayload = {
+      Data: { Type: resolvedType, FileID: resolvedFileKey }
+    };
+    return this.execute(
+      "captureRegistrationDocument",
+      () => this.http.post(
+        `${this.auth.getBaseUrl()}/api/registrationdocument/capture`,
+        requestPayload,
+        this.getHeaders()
+      )
+    );
+  }
+  // ===========================================================================
   // Account
   // ===========================================================================
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@healthcloudai/hc-settings-connector",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Healthcheck Settings SDK with TypeScript",
   "author": "Healthcheck Systems Inc",
   "license": "MIT",