@healthcloudai/hc-import-vitals 0.1.1

package/README.md

@@ -0,0 +1,229 @@
+# Healthcheck Import Vitals Connector
+
+SDK connector for importing vital signs and retrieving stored vitals from the Healthcheck platform.
+
+`HCImportVitalsClient` uses a configured and authenticated `HCLoginClient` for environment resolution and auth headers. The base URL is derived from the login client so it stays in sync with the configured environment.
+
+---
+
+## Installation
+
+```sh
+npm install @healthcloudai/hc-import-vitals \
+  @healthcloudai/hc-login-connector \
+  @healthcloudai/hc-http
+```
+
+---
+
+## Import
+
+```ts
+import { HCImportVitalsClient } from "@healthcloudai/hc-import-vitals";
+import { HCLoginClient } from "@healthcloudai/hc-login-connector";
+import { FetchClient } from "@healthcloudai/hc-http";
+
+import type {
+  APIResponse,
+  ImportVitalsRequest,
+  ImportVitalDBRecord,
+  LogVitalsRequest,
+} from "@healthcloudai/hc-import-vitals";
+```
+
+---
+
+## Setup
+
+```ts
+const httpClient = new FetchClient();
+const loginClient = new HCLoginClient(httpClient);
+
+loginClient.configure("healthcheck", "dev");
+await loginClient.login("john.smith@example.com", "ExamplePassword123!");
+
+const client = new HCImportVitalsClient(httpClient, loginClient);
+```
+
+The constructor reads the base URL directly from `loginClient.getBaseUrl()` — no separate environment mapping is needed.
+
+---
+
+## API Key
+
+If the environment requires an API key, configure it once:
+
+```ts
+client.setApiKey("x-api-key", process.env.HEALTHCLOUD_API_KEY ?? "");
+```
+
+---
+
+## Response Format
+
+All methods return:
+
+```ts
+APIResponse<T>
+```
+
+```ts
+export interface APIResponse<T> {
+  Data: T | null;
+  IsOK: boolean;
+  ErrorMessage: string | null;
+}
+```
+
+---
+
+## Methods
+
+### `getVitals(limit?)`
+
+Returns stored vital sign records for the authenticated patient.
+
+- `limit` — optional, default `50`, max `500`
+
+```ts
+await client.getVitals();
+await client.getVitals(5);
+```
+
+Returns `Promise<APIResponse<ImportVitalDBRecord[]>>`.
+
+Example response:
+
+```json
+{
+  "Data": [
+    {
+      "ID": "EC1FCB0C-26EF-45C6-B1B7-ECD1EDCE4E55",
+      "TenantID": "healthcheck",
+      "PatientID": "john.smith@example.com",
+      "Type": "bloodpressuresystolic",
+      "Value": 125,
+      "Unit": "mmHg",
+      "TimeStamp": "2026-05-27T19:46:17Z",
+      "SourceName": "Apple Health (Native)",
+      "SourcePlatform": "ios"
+    },
+    {
+      "ID": "93BD0AD4-C71B-4CB6-9A6F-A7E62309D28A",
+      "TenantID": "healthcheck",
+      "PatientID": "john.smith@example.com",
+      "Type": "bloodpressurediastolic",
+      "Value": 85,
+      "Unit": "mmHg",
+      "TimeStamp": "2026-05-27T19:46:17Z",
+      "SourceName": "Apple Health (Native)",
+      "SourcePlatform": "ios"
+    }
+  ],
+  "ErrorMessage": null,
+  "IsOK": true
+}
+```
+
+---
+
+### `importVitals(vitals)`
+
+Imports vital sign records from a connected device. `User.Email` and at least one record are required.
+
+```ts
+await client.importVitals({
+  User: {
+    Email: "john.smith@example.com",
+  },
+  Records: [
+    {
+      Type: "HeartRate",
+      Value: 72,
+      Unit: "bpm",
+      StartDate: "2026-05-29T08:00:00.000Z",
+      EndDate: "2026-05-29T08:00:00.000Z",
+      SourceName: "Apple Health",
+      SourcePlatform: "ios",
+    },
+    {
+      Type: "BloodPressureSystolic",
+      Value: 120,
+      Unit: "mmHg",
+      StartDate: "2026-05-29T08:00:00.000Z",
+      EndDate: "2026-05-29T08:00:00.000Z",
+      SourceName: "Apple Health",
+      SourcePlatform: "ios",
+    },
+    {
+      Type: "BloodPressureDiastolic",
+      Value: 78,
+      Unit: "mmHg",
+      StartDate: "2026-05-29T08:00:00.000Z",
+      EndDate: "2026-05-29T08:00:00.000Z",
+      SourceName: "Apple Health",
+      SourcePlatform: "ios",
+    },
+  ],
+  SyncTimestamp: "2026-05-29T08:00:00.000Z",
+  DevicePlatform: "ios",
+});
+```
+
+Returns `Promise<APIResponse<boolean>>`.
+
+Example response:
+
+```json
+{
+  "Data": true,
+  "ErrorMessage": null,
+  "IsOK": true
+}
+```
+
+---
+
+### `logVitals(logData)`
+
+Logs a vitals event. No authorization required — accepts any key-value data.
+
+```ts
+await client.logVitals({
+  event: "sync-complete",
+  source: "mobile-app",
+  timestamp: new Date().toISOString(),
+  email: "john.smith@example.com",
+});
+```
+
+Returns `Promise<APIResponse<boolean>>`.
+
+Example response:
+
+```json
+{
+  "Data": true,
+  "ErrorMessage": null,
+  "IsOK": true
+}
+```
+
+---
+
+## Method Summary
+
+| Method | HTTP | Auth required |
+| --- | --- | --- |
+| `getVitals(limit?)` | GET `/api/imports/vitals` | Yes |
+| `importVitals(vitals)` | POST `/api/imports/vitals` | Yes |
+| `logVitals(logData)` | POST `/api/imports/logs` | No |
+
+---
+
+## Notes
+
+- `getVitals` and `importVitals` require an authenticated patient token.
+- `logVitals` does not require authorization.
+- `Type` values observed from live data: `bloodpressuresystolic`, `bloodpressurediastolic`, `HeartRate` — always send the type exactly as the source device provides it.
+- `SourcePlatform` observed values: `ios`, `manual`.

package/dist/index.cjs

@@ -0,0 +1,258 @@
+"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, {
+  APIError: () => import_hc_http2.APIError,
+  ConfigError: () => import_hc_http2.ConfigError,
+  HCImportVitalsClient: () => HCImportVitalsClient,
+  HCServiceError: () => import_hc_http2.HCServiceError,
+  NetworkError: () => import_hc_http2.NetworkError,
+  ValidationError: () => import_hc_http2.ValidationError,
+  errorFromHttpStatus: () => import_hc_http2.errorFromHttpStatus
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_hc_http = require("@healthcloudai/hc-http");
+var HCImportVitalsClient = class {
+  constructor(httpClient, loginClient) {
+    this.http = httpClient;
+    this.auth = loginClient;
+    this.baseUrl = loginClient.getBaseUrl();
+  }
+  setApiKey(headerName, value) {
+    const trimmedHeaderName = headerName == null ? void 0 : headerName.trim();
+    const trimmedValue = value == null ? void 0 : value.trim();
+    if (!trimmedHeaderName) {
+      throw new import_hc_http.ConfigError(
+        "API key header name is required."
+      );
+    }
+    if (!trimmedValue) {
+      throw new import_hc_http.ConfigError(
+        "API key value is required."
+      );
+    }
+    this.apiKeyHeaderName = trimmedHeaderName;
+    this.apiKeyValue = trimmedValue;
+  }
+  // =========================================================================
+  // Import Vitals
+  // =========================================================================
+  /**
+   * Import vital signs from a connected device.
+   * Requires PatientAuthorization.
+   * 
+   * @param vitals The vital signs import request
+   * @returns Success indicator
+   */
+  async importVitals(vitals) {
+    var _a, _b;
+    if (!vitals) {
+      throw new import_hc_http.ValidationError({
+        message: "Vitals import request is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (!((_b = (_a = vitals == null ? void 0 : vitals.User) == null ? void 0 : _a.Email) == null ? void 0 : _b.trim())) {
+      throw new import_hc_http.ValidationError({
+        message: "User email is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (!(vitals == null ? void 0 : vitals.Records) || vitals.Records.length === 0) {
+      throw new import_hc_http.ValidationError({
+        message: "At least one vital record is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return this.execute(
+      "importVitals",
+      () => this.http.post(
+        `${this.baseUrl}/api/imports/vitals`,
+        vitals,
+        this.headers()
+      )
+    );
+  }
+  /**
+   * Get vital signs for current patient.
+   * Requires PatientAuthorization.
+   * 
+   * @param limit Maximum number of records to retrieve (default: 50, max: 500)
+   * @returns List of vital sign records
+   */
+  async getVitals(limit) {
+    const queryLimit = limit != null ? limit : 50;
+    if (queryLimit <= 0) {
+      throw new import_hc_http.ValidationError({
+        message: "Limit must be greater than 0.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (queryLimit > 500) {
+      throw new import_hc_http.ValidationError({
+        message: "Limit cannot exceed 500.",
+        code: "INVALID_INPUT"
+      });
+    }
+    const qs = new URLSearchParams({ limit: queryLimit.toString() });
+    return this.execute(
+      "getVitals",
+      () => this.http.get(
+        `${this.baseUrl}/api/imports/vitals?${qs.toString()}`,
+        this.headers()
+      )
+    );
+  }
+  // =========================================================================
+  // Log Vitals
+  // =========================================================================
+  /**
+   * Log vital signs data.
+   * No authorization required.
+   * 
+   * @param logData Log entry data
+   * @returns Success indicator
+   */
+  async logVitals(logData) {
+    if (!logData) {
+      throw new import_hc_http.ValidationError({
+        message: "Log data is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return this.execute(
+      "logVitals",
+      () => this.http.post(
+        `${this.baseUrl}/api/imports/logs`,
+        logData,
+        this.headers()
+      )
+    );
+  }
+  // =========================================================================
+  // Private
+  // =========================================================================
+  /**
+   * Unified request execution layer.
+   * Handles error mapping, response validation, and error transformation.
+   */
+  async execute(operation, request) {
+    let response;
+    try {
+      response = await request();
+    } catch (err) {
+      if (err instanceof import_hc_http.APIError) {
+        throw err;
+      }
+      if (err instanceof Error) {
+        throw new import_hc_http.APIError({
+          message: `${operation}: ${err.message}`,
+          code: "UNKNOWN_ERROR",
+          details: err
+        });
+      }
+      throw new import_hc_http.APIError({
+        message: `${operation}: unexpected runtime failure`,
+        code: "UNKNOWN_ERROR",
+        details: err
+      });
+    }
+    if (response == null) {
+      throw new import_hc_http.APIError({
+        message: `${operation}: empty response received`,
+        code: "EMPTY_RESPONSE",
+        details: response
+      });
+    }
+    return response;
+  }
+  /**
+   * Extension point for connector-specific backend error handling.
+   */
+  mapBackendError(operation, response) {
+    return new import_hc_http.HCServiceError(
+      operation,
+      response.ErrorMessage || "Unknown error",
+      response
+    );
+  }
+  /**
+   * Validates response structure against APIResponse contract.
+   * Ensures all required fields are present and correctly typed.
+   */
+  isApiResponse(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const response = value;
+    return "IsOK" in response && typeof response.IsOK === "boolean" && "Data" in response && "ErrorMessage" in response;
+  }
+  /**
+   * Builds authorization headers from login client.
+   * Includes standard HTTP headers for API communication.
+   */
+  headers() {
+    return {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+      ...this.auth.getAuthHeader(),
+      ...this.getApiKeyHeader()
+    };
+  }
+  getApiKeyHeader() {
+    if (!this.apiKeyHeaderName || !this.apiKeyValue) {
+      return {};
+    }
+    return {
+      [this.apiKeyHeaderName]: this.apiKeyValue
+    };
+  }
+  /**
+   * Validates and encodes path parameter values.
+   * Ensures parameter is non-empty before URL encoding.
+   * Throws ValidationError if parameter is missing or empty.
+   */
+  encode(value) {
+    const trimmed = value == null ? void 0 : value.trim();
+    if (!trimmed) {
+      throw new import_hc_http.ValidationError({
+        message: "Path parameter value is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return encodeURIComponent(trimmed);
+  }
+};
+
+// src/errors.ts
+var import_hc_http2 = require("@healthcloudai/hc-http");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIError,
+  ConfigError,
+  HCImportVitalsClient,
+  HCServiceError,
+  NetworkError,
+  ValidationError,
+  errorFromHttpStatus
+});

package/dist/index.d.cts

@@ -0,0 +1,115 @@
+import { HCLoginClient } from '@healthcloudai/hc-login-connector';
+import { HttpClient, APIError } from '@healthcloudai/hc-http';
+export { APIError, ConfigError, HCServiceError, NetworkError, ValidationError, errorFromHttpStatus } from '@healthcloudai/hc-http';
+
+type ISODateString = string;
+interface APIResponse<T> {
+    Data: T | null;
+    IsOK: boolean;
+    ErrorMessage: string | null;
+}
+interface APIRequest<T> {
+    Data: T;
+}
+interface ImportVitalsUser {
+    TenantID?: string | null;
+    Email?: string | null;
+}
+interface ImportVitalRecord {
+    Id?: string | null;
+    Type?: string | null;
+    Value?: number | null;
+    Unit?: string | null;
+    StartDate?: ISODateString | null;
+    EndDate?: ISODateString | null;
+    SourceName?: string | null;
+    SourcePlatform?: string | null;
+}
+interface ImportVitalsRequest {
+    User?: ImportVitalsUser | null;
+    Records?: ImportVitalRecord[] | null;
+    SyncTimestamp?: ISODateString | null;
+    DevicePlatform?: string | null;
+    AuthCode?: string | null;
+    RedirectURL?: string | null;
+}
+interface ImportVitalDBRecord {
+    ID?: string | null;
+    TenantID?: string | null;
+    PatientID?: string | null;
+    Type?: string | null;
+    Value?: number | null;
+    Unit?: string | null;
+    TimeStamp?: ISODateString | null;
+    SourceName?: string | null;
+    SourcePlatform?: string | null;
+}
+interface GetVitalsResponse {
+    vitals: ImportVitalDBRecord[];
+    totalCount: number;
+}
+interface LogVitalsRequest {
+    [key: string]: any;
+}
+
+declare class HCImportVitalsClient {
+    private readonly http;
+    private readonly auth;
+    private readonly baseUrl;
+    private apiKeyHeaderName?;
+    private apiKeyValue?;
+    constructor(httpClient: HttpClient, loginClient: HCLoginClient);
+    setApiKey(headerName: string, value: string): void;
+    /**
+     * Import vital signs from a connected device.
+     * Requires PatientAuthorization.
+     *
+     * @param vitals The vital signs import request
+     * @returns Success indicator
+     */
+    importVitals(vitals: ImportVitalsRequest): Promise<APIResponse<boolean>>;
+    /**
+     * Get vital signs for current patient.
+     * Requires PatientAuthorization.
+     *
+     * @param limit Maximum number of records to retrieve (default: 50, max: 500)
+     * @returns List of vital sign records
+     */
+    getVitals(limit?: number): Promise<APIResponse<ImportVitalDBRecord[]>>;
+    /**
+     * Log vital signs data.
+     * No authorization required.
+     *
+     * @param logData Log entry data
+     * @returns Success indicator
+     */
+    logVitals(logData: LogVitalsRequest): Promise<APIResponse<boolean>>;
+    /**
+     * Unified request execution layer.
+     * Handles error mapping, response validation, and error transformation.
+     */
+    protected execute<T>(operation: string, request: () => Promise<APIResponse<T>>): Promise<APIResponse<T>>;
+    /**
+     * Extension point for connector-specific backend error handling.
+     */
+    protected mapBackendError(operation: string, response: APIResponse<unknown>): APIError;
+    /**
+     * Validates response structure against APIResponse contract.
+     * Ensures all required fields are present and correctly typed.
+     */
+    private isApiResponse;
+    /**
+     * Builds authorization headers from login client.
+     * Includes standard HTTP headers for API communication.
+     */
+    private headers;
+    private getApiKeyHeader;
+    /**
+     * Validates and encodes path parameter values.
+     * Ensures parameter is non-empty before URL encoding.
+     * Throws ValidationError if parameter is missing or empty.
+     */
+    private encode;
+}
+
+export { type APIRequest, type APIResponse, type GetVitalsResponse, HCImportVitalsClient, type ISODateString, type ImportVitalDBRecord, type ImportVitalRecord, type ImportVitalsRequest, type ImportVitalsUser, type LogVitalsRequest };

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+import { HCLoginClient } from '@healthcloudai/hc-login-connector';
+import { HttpClient, APIError } from '@healthcloudai/hc-http';
+export { APIError, ConfigError, HCServiceError, NetworkError, ValidationError, errorFromHttpStatus } from '@healthcloudai/hc-http';
+
+type ISODateString = string;
+interface APIResponse<T> {
+    Data: T | null;
+    IsOK: boolean;
+    ErrorMessage: string | null;
+}
+interface APIRequest<T> {
+    Data: T;
+}
+interface ImportVitalsUser {
+    TenantID?: string | null;
+    Email?: string | null;
+}
+interface ImportVitalRecord {
+    Id?: string | null;
+    Type?: string | null;
+    Value?: number | null;
+    Unit?: string | null;
+    StartDate?: ISODateString | null;
+    EndDate?: ISODateString | null;
+    SourceName?: string | null;
+    SourcePlatform?: string | null;
+}
+interface ImportVitalsRequest {
+    User?: ImportVitalsUser | null;
+    Records?: ImportVitalRecord[] | null;
+    SyncTimestamp?: ISODateString | null;
+    DevicePlatform?: string | null;
+    AuthCode?: string | null;
+    RedirectURL?: string | null;
+}
+interface ImportVitalDBRecord {
+    ID?: string | null;
+    TenantID?: string | null;
+    PatientID?: string | null;
+    Type?: string | null;
+    Value?: number | null;
+    Unit?: string | null;
+    TimeStamp?: ISODateString | null;
+    SourceName?: string | null;
+    SourcePlatform?: string | null;
+}
+interface GetVitalsResponse {
+    vitals: ImportVitalDBRecord[];
+    totalCount: number;
+}
+interface LogVitalsRequest {
+    [key: string]: any;
+}
+
+declare class HCImportVitalsClient {
+    private readonly http;
+    private readonly auth;
+    private readonly baseUrl;
+    private apiKeyHeaderName?;
+    private apiKeyValue?;
+    constructor(httpClient: HttpClient, loginClient: HCLoginClient);
+    setApiKey(headerName: string, value: string): void;
+    /**
+     * Import vital signs from a connected device.
+     * Requires PatientAuthorization.
+     *
+     * @param vitals The vital signs import request
+     * @returns Success indicator
+     */
+    importVitals(vitals: ImportVitalsRequest): Promise<APIResponse<boolean>>;
+    /**
+     * Get vital signs for current patient.
+     * Requires PatientAuthorization.
+     *
+     * @param limit Maximum number of records to retrieve (default: 50, max: 500)
+     * @returns List of vital sign records
+     */
+    getVitals(limit?: number): Promise<APIResponse<ImportVitalDBRecord[]>>;
+    /**
+     * Log vital signs data.
+     * No authorization required.
+     *
+     * @param logData Log entry data
+     * @returns Success indicator
+     */
+    logVitals(logData: LogVitalsRequest): Promise<APIResponse<boolean>>;
+    /**
+     * Unified request execution layer.
+     * Handles error mapping, response validation, and error transformation.
+     */
+    protected execute<T>(operation: string, request: () => Promise<APIResponse<T>>): Promise<APIResponse<T>>;
+    /**
+     * Extension point for connector-specific backend error handling.
+     */
+    protected mapBackendError(operation: string, response: APIResponse<unknown>): APIError;
+    /**
+     * Validates response structure against APIResponse contract.
+     * Ensures all required fields are present and correctly typed.
+     */
+    private isApiResponse;
+    /**
+     * Builds authorization headers from login client.
+     * Includes standard HTTP headers for API communication.
+     */
+    private headers;
+    private getApiKeyHeader;
+    /**
+     * Validates and encodes path parameter values.
+     * Ensures parameter is non-empty before URL encoding.
+     * Throws ValidationError if parameter is missing or empty.
+     */
+    private encode;
+}
+
+export { type APIRequest, type APIResponse, type GetVitalsResponse, HCImportVitalsClient, type ISODateString, type ImportVitalDBRecord, type ImportVitalRecord, type ImportVitalsRequest, type ImportVitalsUser, type LogVitalsRequest };

package/dist/index.js

@@ -0,0 +1,237 @@
+// src/client.ts
+import {
+  APIError,
+  HCServiceError,
+  ValidationError,
+  ConfigError
+} from "@healthcloudai/hc-http";
+var HCImportVitalsClient = class {
+  constructor(httpClient, loginClient) {
+    this.http = httpClient;
+    this.auth = loginClient;
+    this.baseUrl = loginClient.getBaseUrl();
+  }
+  setApiKey(headerName, value) {
+    const trimmedHeaderName = headerName == null ? void 0 : headerName.trim();
+    const trimmedValue = value == null ? void 0 : value.trim();
+    if (!trimmedHeaderName) {
+      throw new ConfigError(
+        "API key header name is required."
+      );
+    }
+    if (!trimmedValue) {
+      throw new ConfigError(
+        "API key value is required."
+      );
+    }
+    this.apiKeyHeaderName = trimmedHeaderName;
+    this.apiKeyValue = trimmedValue;
+  }
+  // =========================================================================
+  // Import Vitals
+  // =========================================================================
+  /**
+   * Import vital signs from a connected device.
+   * Requires PatientAuthorization.
+   * 
+   * @param vitals The vital signs import request
+   * @returns Success indicator
+   */
+  async importVitals(vitals) {
+    var _a, _b;
+    if (!vitals) {
+      throw new ValidationError({
+        message: "Vitals import request is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (!((_b = (_a = vitals == null ? void 0 : vitals.User) == null ? void 0 : _a.Email) == null ? void 0 : _b.trim())) {
+      throw new ValidationError({
+        message: "User email is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (!(vitals == null ? void 0 : vitals.Records) || vitals.Records.length === 0) {
+      throw new ValidationError({
+        message: "At least one vital record is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return this.execute(
+      "importVitals",
+      () => this.http.post(
+        `${this.baseUrl}/api/imports/vitals`,
+        vitals,
+        this.headers()
+      )
+    );
+  }
+  /**
+   * Get vital signs for current patient.
+   * Requires PatientAuthorization.
+   * 
+   * @param limit Maximum number of records to retrieve (default: 50, max: 500)
+   * @returns List of vital sign records
+   */
+  async getVitals(limit) {
+    const queryLimit = limit != null ? limit : 50;
+    if (queryLimit <= 0) {
+      throw new ValidationError({
+        message: "Limit must be greater than 0.",
+        code: "INVALID_INPUT"
+      });
+    }
+    if (queryLimit > 500) {
+      throw new ValidationError({
+        message: "Limit cannot exceed 500.",
+        code: "INVALID_INPUT"
+      });
+    }
+    const qs = new URLSearchParams({ limit: queryLimit.toString() });
+    return this.execute(
+      "getVitals",
+      () => this.http.get(
+        `${this.baseUrl}/api/imports/vitals?${qs.toString()}`,
+        this.headers()
+      )
+    );
+  }
+  // =========================================================================
+  // Log Vitals
+  // =========================================================================
+  /**
+   * Log vital signs data.
+   * No authorization required.
+   * 
+   * @param logData Log entry data
+   * @returns Success indicator
+   */
+  async logVitals(logData) {
+    if (!logData) {
+      throw new ValidationError({
+        message: "Log data is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return this.execute(
+      "logVitals",
+      () => this.http.post(
+        `${this.baseUrl}/api/imports/logs`,
+        logData,
+        this.headers()
+      )
+    );
+  }
+  // =========================================================================
+  // Private
+  // =========================================================================
+  /**
+   * Unified request execution layer.
+   * Handles error mapping, response validation, and error transformation.
+   */
+  async execute(operation, request) {
+    let response;
+    try {
+      response = await request();
+    } catch (err) {
+      if (err instanceof APIError) {
+        throw err;
+      }
+      if (err instanceof Error) {
+        throw new APIError({
+          message: `${operation}: ${err.message}`,
+          code: "UNKNOWN_ERROR",
+          details: err
+        });
+      }
+      throw new APIError({
+        message: `${operation}: unexpected runtime failure`,
+        code: "UNKNOWN_ERROR",
+        details: err
+      });
+    }
+    if (response == null) {
+      throw new APIError({
+        message: `${operation}: empty response received`,
+        code: "EMPTY_RESPONSE",
+        details: response
+      });
+    }
+    return response;
+  }
+  /**
+   * Extension point for connector-specific backend error handling.
+   */
+  mapBackendError(operation, response) {
+    return new HCServiceError(
+      operation,
+      response.ErrorMessage || "Unknown error",
+      response
+    );
+  }
+  /**
+   * Validates response structure against APIResponse contract.
+   * Ensures all required fields are present and correctly typed.
+   */
+  isApiResponse(value) {
+    if (!value || typeof value !== "object") {
+      return false;
+    }
+    const response = value;
+    return "IsOK" in response && typeof response.IsOK === "boolean" && "Data" in response && "ErrorMessage" in response;
+  }
+  /**
+   * Builds authorization headers from login client.
+   * Includes standard HTTP headers for API communication.
+   */
+  headers() {
+    return {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+      ...this.auth.getAuthHeader(),
+      ...this.getApiKeyHeader()
+    };
+  }
+  getApiKeyHeader() {
+    if (!this.apiKeyHeaderName || !this.apiKeyValue) {
+      return {};
+    }
+    return {
+      [this.apiKeyHeaderName]: this.apiKeyValue
+    };
+  }
+  /**
+   * Validates and encodes path parameter values.
+   * Ensures parameter is non-empty before URL encoding.
+   * Throws ValidationError if parameter is missing or empty.
+   */
+  encode(value) {
+    const trimmed = value == null ? void 0 : value.trim();
+    if (!trimmed) {
+      throw new ValidationError({
+        message: "Path parameter value is required.",
+        code: "INVALID_INPUT"
+      });
+    }
+    return encodeURIComponent(trimmed);
+  }
+};
+
+// src/errors.ts
+import {
+  APIError as APIError2,
+  ConfigError as ConfigError2,
+  HCServiceError as HCServiceError2,
+  NetworkError,
+  ValidationError as ValidationError2,
+  errorFromHttpStatus
+} from "@healthcloudai/hc-http";
+export {
+  APIError2 as APIError,
+  ConfigError2 as ConfigError,
+  HCImportVitalsClient,
+  HCServiceError2 as HCServiceError,
+  NetworkError,
+  ValidationError2 as ValidationError,
+  errorFromHttpStatus
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@healthcloudai/hc-import-vitals",
+  "version": "0.1.1",
+  "description": "Healthcheck Import Vitals connector SDK with TypeScript",
+  "author": "Healthcheck Systems Inc",
+  "license": "MIT",
+  "keywords": [
+    "health-cloud",
+    "import-vitals",
+    "vitals",
+    "react-native",
+    "typescript",
+    "sdk",
+    "fetch",
+    "axios"
+  ],
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "react-native": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@healthcloudai/hc-http": "^0.1.0",
+    "@healthcloudai/hc-login-connector": "^0.2.0",
+    "axios": "^1.13.4"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.70.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.30",
+    "eslint": "^8.56.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}