@icanbwell/bwell-sdk-ts 1.98.0 → 1.99.0

package/dist/__version__.d.ts

@@ -1,4 +1,4 @@
 /**
  * This file is automatically generated. Please do not edit this file directly.
  */
-export declare const VERSION = "1.98.0";
+export declare const VERSION = "1.99.0";

package/dist/__version__.js

@@ -1,4 +1,4 @@
 /**
  * This file is automatically generated. Please do not edit this file directly.
  */
-export const VERSION = "1.98.0";
+export const VERSION = "1.99.0";

package/dist/api/base/user/user-manager.d.ts

@@ -1,5 +1,5 @@
 import { ValidationError } from "../../../errors/validation-error.js";
-import { CreateConsentMutationResults, CreateDataExportDirectDownloadUrlMutationResults, CreateVerificationUrlMutationResults, DeleteMutationResults, GetProfileQueryResults, SearchConsentQueryResults, UpdateUserProfileMutationResults, VerificationStatusQueryResults } from "../../../graphql/operations/types.js";
+import { CreateConsentMutationResults, CreateDataExportDirectDownloadUrlMutationResults, CreateVerificationUrlMutationResults, DeleteMutationResults, GetAccessHistoryQueryResults, GetProfileQueryResults, SearchConsentQueryResults, UpdateUserProfileMutationResults, VerificationStatusQueryResults } from "../../../graphql/operations/types.js";
 import type { BWellQueryResult, BWellTransactionResult } from "../../../results/index.js";
 import { BaseManagerError } from "../errors.js";
 import { CreateConsentRequest } from "./create-consent-request.js";
@@ -8,6 +8,7 @@ import { CreateVerificationUrlRequest } from "./create-verification-url-request.
 import { GetConsentsRequest } from "./get-consents-request.js";
 import { UpdateProfileRequest } from "./update-profile-request.js";
 export type ProfileResults = GetProfileQueryResults["userProfile"];
+export type GetAccessHistoryResults = GetAccessHistoryQueryResults["getAccessHistory"];
 export type DeleteUserResultsType = DeleteMutationResults["updateUserAccountStatus"];
 export interface DeleteUserResults extends DeleteUserResultsType {
 }
@@ -27,6 +28,15 @@ export interface UserManager {
      * @returns {Promise<BWellQueryResult<ProfileResults>>} A promise resolving to an object holding the demographic data from the user.
      */
     getProfile(): Promise<BWellQueryResult<ProfileResults, BaseManagerError>>;
+    /**
+     * Retrieves the authenticated user's access history — who has accessed their
+     * data, how often, when it was last accessed, and for what reason — as a
+     * per-accessor summary over a rolling window. The person is resolved from the
+     * auth context; a user can only retrieve their own access history.
+     *
+     * @returns {Promise<BWellQueryResult<GetAccessHistoryResults, BaseManagerError>>} A promise resolving to the user's access history.
+     */
+    getAccessHistory(): Promise<BWellQueryResult<GetAccessHistoryResults, BaseManagerError>>;
     /**
      * Deletes a user’s account and associated user data.
      *

package/dist/api/graphql-api/user/graphql-user-manager.d.ts

@@ -5,13 +5,14 @@ import { BaseManagerError } from "../../base/errors.js";
 import { CreateConsentResults, GetConsentsResults, ProfileResults, UpdateProfileResults } from "../../base/index.js";
 import { CreateDataExportDirectDownloadUrlRequest } from "../../base/user/create-data-export-direct-download-url-request.js";
 import { CreateConsentRequest, CreateVerificationUrlRequest, GetConsentsRequest, UpdateProfileRequest } from "../../base/user/index.js";
-import type { CreateDataExportDirectDownloadUrlResults, CreateVerificationUrlResults, GetVerificationStatusResults, UserManager } from "../../base/user/user-manager.js";
+import type { CreateDataExportDirectDownloadUrlResults, CreateVerificationUrlResults, GetAccessHistoryResults, GetVerificationStatusResults, UserManager } from "../../base/user/user-manager.js";
 import { GraphQLManager } from "../graphql-manager/index.js";
 import type { GraphQLSdk } from "../graphql-sdk/index.js";
 export declare class GraphQLUserManager extends GraphQLManager implements UserManager {
     #private;
     constructor(sdk: GraphQLSdk, loggerProvider?: LoggerProvider);
     getProfile(): Promise<BWellQueryResult<ProfileResults, BaseManagerError>>;
+    getAccessHistory(): Promise<BWellQueryResult<GetAccessHistoryResults, BaseManagerError>>;
     delete(): Promise<BWellTransactionResult<null, BaseManagerError>>;
     updateProfile(request: UpdateProfileRequest): Promise<BWellTransactionResult<UpdateProfileResults, BaseManagerError | ValidationError>>;
     getConsents(request?: GetConsentsRequest): Promise<BWellQueryResult<GetConsentsResults, BaseManagerError | ValidationError>>;

package/dist/api/graphql-api/user/graphql-user-manager.js

@@ -55,6 +55,21 @@ export class GraphQLUserManager extends GraphQLManager {
             return new BWellQueryResult((_a = result.data) === null || _a === void 0 ? void 0 : _a.userProfile, result.error);
         });
     }
+    getAccessHistory() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            __classPrivateFieldGet(this, _GraphQLUserManager_logger, "f").verbose("calling getAccessHistory...");
+            const result = yield this.handleQuery(__classPrivateFieldGet(this, _GraphQLUserManager_sdk, "f").GetAccessHistory());
+            __classPrivateFieldGet(this, _GraphQLUserManager_logger, "f").verbose("getAccessHistory complete");
+            if (result.hasError()) {
+                __classPrivateFieldGet(this, _GraphQLUserManager_logger, "f").error("getAccessHistory failed", result.error);
+            }
+            else {
+                __classPrivateFieldGet(this, _GraphQLUserManager_logger, "f").info("successfully called getAccessHistory");
+            }
+            return new BWellQueryResult((_a = result.data) === null || _a === void 0 ? void 0 : _a.getAccessHistory, result.error);
+        });
+    }
     delete() {
         return __awaiter(this, void 0, void 0, function* () {
             __classPrivateFieldGet(this, _GraphQLUserManager_logger, "f").verbose("calling delete...");

package/dist/graphql/operations/index.d.ts

@@ -185,6 +185,7 @@ export declare const CreateConsentDocument = "\n    mutation createConsent($cons
 export declare const CreateDataExportDirectDownloadUrlDocument = "\n    mutation CreateDataExportDirectDownloadUrl($exportId: String!, $password: String!) {\n  createDataExportDirectDownloadUrl(exportId: $exportId, password: $password)\n}\n    ";
 export declare const CreateVerificationUrlDocument = "\n    mutation CreateVerificationUrl($callbackURL: String, $includeAttributeMatchingCheck: Boolean) {\n  createVerificationUrl(\n    callbackURL: $callbackURL\n    includeAttributeMatchingCheck: $includeAttributeMatchingCheck\n  )\n}\n    ";
 export declare const DeleteDocument = "\n    mutation delete {\n  updateUserAccountStatus(operation: IMMEDIATE_EXECUTION) {\n    resourceType\n    issue {\n      code\n      severity\n      details {\n        text\n      }\n    }\n  }\n}\n    ";
+export declare const GetAccessHistoryDocument = "\n    query GetAccessHistory {\n  getAccessHistory {\n    summary {\n      generatedAt\n      windowDays\n    }\n    accessors {\n      reference {\n        reference\n        display\n      }\n      totalCount\n      lastAccessed\n      organizations {\n        reference\n        name\n        sourceId\n      }\n      purposeOfEvent {\n        system\n        code\n        display\n      }\n      resourceTypes {\n        type\n        count\n      }\n    }\n  }\n}\n    ";
 export declare const GetProfileDocument = "\n    query getProfile {\n  userProfile {\n    id\n    address {\n      line\n      city\n      state\n      postalCode\n    }\n    telecom {\n      system\n      value\n      use\n    }\n    gender\n    birthDate\n    name {\n      family\n      given\n    }\n    language\n    identifier {\n      ...IdentifierFields\n    }\n  }\n}\n    \n    fragment IdentifierFields on Identifier {\n  id\n  type {\n    ...CodeableConceptFields\n  }\n  system\n  value\n}\n    \n    fragment CodeableConceptFields on CodeableConcept {\n  text\n  coding {\n    ...CodingFields\n  }\n}\n    \n    fragment CodingFields on Coding {\n  system\n  code\n  display\n}\n    ";
 export declare const SearchConsentDocument = "\n    query searchConsent($categoryCode: CategoryCode) {\n  search(params: {category: $categoryCode}) {\n    resourceType\n    id\n    meta {\n      ...MetaFields\n    }\n    status\n    scope {\n      text\n      coding {\n        code\n        system\n        display\n      }\n    }\n    category {\n      text\n      coding {\n        code\n        system\n        display\n      }\n    }\n    patient {\n      reference\n    }\n    provision {\n      type\n    }\n  }\n}\n    \n    fragment MetaFields on Meta {\n  versionId\n  lastUpdated\n  source\n  security {\n    ...CodingFields\n  }\n  tag {\n    ...CodingFields\n  }\n}\n    \n    fragment CodingFields on Coding {\n  system\n  code\n  display\n}\n    ";
 export declare const UpdateUserProfileDocument = "\n    mutation updateUserProfile($person: FHIRPersonInput) {\n  updateUserProfile(input: $person) {\n    id\n    address {\n      line\n      city\n      state\n      postalCode\n    }\n    telecom {\n      system\n      value\n      use\n    }\n    gender\n    birthDate\n    name {\n      family\n      given\n    }\n    language\n  }\n}\n    ";
@@ -828,6 +829,13 @@ export declare function getSdk(client: GraphQLClient, withWrapper?: SdkFunctionW
         headers: Headers;
         status: number;
     }>;
+    GetAccessHistory(variables?: Types.GetAccessHistoryQueryVariables, requestHeaders?: GraphQLClientRequestHeaders): Promise<{
+        data: Types.GetAccessHistoryQueryResults;
+        errors?: GraphQLError[];
+        extensions?: any;
+        headers: Headers;
+        status: number;
+    }>;
     getProfile(variables?: Types.GetProfileQueryVariables, requestHeaders?: GraphQLClientRequestHeaders): Promise<{
         data: Types.GetProfileQueryResults;
         errors?: GraphQLError[];

package/dist/graphql/operations/index.js

@@ -5014,6 +5014,38 @@ export const DeleteDocument = `
   }
 }
     `;
+export const GetAccessHistoryDocument = `
+    query GetAccessHistory {
+  getAccessHistory {
+    summary {
+      generatedAt
+      windowDays
+    }
+    accessors {
+      reference {
+        reference
+        display
+      }
+      totalCount
+      lastAccessed
+      organizations {
+        reference
+        name
+        sourceId
+      }
+      purposeOfEvent {
+        system
+        code
+        display
+      }
+      resourceTypes {
+        type
+        count
+      }
+    }
+  }
+}
+    `;
 export const GetProfileDocument = `
     query getProfile {
   userProfile {
@@ -5389,6 +5421,9 @@ export function getSdk(client, withWrapper = defaultWrapper) {
         delete(variables, requestHeaders) {
             return withWrapper((wrappedRequestHeaders) => client.rawRequest(DeleteDocument, variables, Object.assign(Object.assign({}, requestHeaders), wrappedRequestHeaders)), 'delete', 'mutation', variables);
         },
+        GetAccessHistory(variables, requestHeaders) {
+            return withWrapper((wrappedRequestHeaders) => client.rawRequest(GetAccessHistoryDocument, variables, Object.assign(Object.assign({}, requestHeaders), wrappedRequestHeaders)), 'GetAccessHistory', 'query', variables);
+        },
         getProfile(variables, requestHeaders) {
             return withWrapper((wrappedRequestHeaders) => client.rawRequest(GetProfileDocument, variables, Object.assign(Object.assign({}, requestHeaders), wrappedRequestHeaders)), 'getProfile', 'query', variables);
         },

package/dist/graphql/operations/types.d.ts

@@ -30420,6 +30420,39 @@ export type DeleteMutationResults = {
         }> | null;
     };
 };
+export type GetAccessHistoryQueryVariables = Types.Exact<{
+    [key: string]: never;
+}>;
+export type GetAccessHistoryQueryResults = {
+    getAccessHistory: {
+        summary: {
+            generatedAt: any | null;
+            windowDays: number | null;
+        } | null;
+        accessors: Array<{
+            totalCount: number;
+            lastAccessed: any;
+            reference: {
+                reference: string;
+                display: string | null;
+            };
+            organizations: Array<{
+                reference: string;
+                name: string;
+                sourceId: string;
+            }>;
+            purposeOfEvent: Array<{
+                system: string | null;
+                code: string;
+                display: string | null;
+            }>;
+            resourceTypes: Array<{
+                type: string;
+                count: number;
+            }>;
+        }>;
+    };
+};
 export type GetProfileQueryVariables = Types.Exact<{
     [key: string]: never;
 }>;

package/dist/graphql/schema.d.ts

@@ -165,6 +165,78 @@ export type Scalars = {
 export type AcceptDataSharingInvitationInput = {
     code: Scalars['String']['input'];
 };
+/** Aggregated access activity for a single accessor over the window. */
+export type AccessHistoryAccessor = {
+    __typename?: 'AccessHistoryAccessor';
+    /** The most recent access time across this accessor's events. */
+    lastAccessed: Scalars['DateTime']['output'];
+    /** The organization(s) the accessor belongs to. */
+    organizations: Array<AccessHistoryOrganization>;
+    /** The reason(s) the data was accessed (FHIR purposeOfEvent codings). */
+    purposeOfEvent: Array<AccessHistoryPurpose>;
+    /** Who accessed the data (Practitioner or Patient), with display set to the human name. */
+    reference: AccessHistoryReference;
+    /** Per-resource-type breakdown of what this accessor accessed. */
+    resourceTypes: Array<AccessHistoryResourceTypeCount>;
+    /** Total accesses by this accessor in the window. */
+    totalCount: Scalars['Int']['output'];
+};
+/** An organization an accessor belongs to. */
+export type AccessHistoryOrganization = {
+    __typename?: 'AccessHistoryOrganization';
+    /** Human-readable organization name. */
+    name: Scalars['String']['output'];
+    /** The FHIR reference, e.g. Organization/{uuid}, with display set to the organization name. */
+    reference: Scalars['String']['output'];
+    /**
+     * The bwell Organization id, surfaced so the client UI can display/link the
+     *   organization. Same value as the id in `reference`; it is not an upstream
+     *   source-system identifier.
+     */
+    sourceId: Scalars['String']['output'];
+};
+/** A reason the data was accessed (FHIR purposeOfEvent coding). */
+export type AccessHistoryPurpose = {
+    __typename?: 'AccessHistoryPurpose';
+    /** The purpose code, e.g. TREAT, PATRQT. */
+    code: Scalars['String']['output'];
+    /** Human-readable display for the purpose code. */
+    display?: Maybe<Scalars['String']['output']>;
+    /** The code system, typically http://terminology.hl7.org/CodeSystem/v3-ActReason. */
+    system?: Maybe<Scalars['String']['output']>;
+};
+/** A reference to an accessor, with a human-readable display. */
+export type AccessHistoryReference = {
+    __typename?: 'AccessHistoryReference';
+    /** Human-readable name for the accessor. */
+    display?: Maybe<Scalars['String']['output']>;
+    /** The FHIR reference, e.g. Practitioner/{uuid} or Patient/{uuid}. */
+    reference: Scalars['String']['output'];
+};
+/** Number of access events for a single FHIR resource type. */
+export type AccessHistoryResourceTypeCount = {
+    __typename?: 'AccessHistoryResourceTypeCount';
+    /** The number of access events for this resource type by this accessor. */
+    count: Scalars['Int']['output'];
+    /** The FHIR resource type that was accessed (e.g. DiagnosticReport, MedicationRequest). */
+    type: Scalars['String']['output'];
+};
+/** The access-history response: a per-accessor summary plus response-level metadata. */
+export type AccessHistoryResult = {
+    __typename?: 'AccessHistoryResult';
+    /** One entry per distinct accessor. Empty when there is no recorded access. */
+    accessors: Array<AccessHistoryAccessor>;
+    /** Response-level metadata about how/when this summary was computed. */
+    summary?: Maybe<AccessHistorySummary>;
+};
+/** Response-level metadata about the access-history summary. */
+export type AccessHistorySummary = {
+    __typename?: 'AccessHistorySummary';
+    /** When this summary was computed (freshness signal). */
+    generatedAt?: Maybe<Scalars['DateTime']['output']>;
+    /** Length of the rolling window covered, in days (currently 90). */
+    windowDays?: Maybe<Scalars['Int']['output']>;
+};
 export type AccessTokenPayload = {
     __typename?: 'AccessTokenPayload';
     jwtToken: Scalars['String']['output'];
@@ -1447,6 +1519,7 @@ export type ConsentQuestionnaireResponse = {
 };
 export type ConsentSearch = {
     category?: InputMaybe<CategoryCode>;
+    organizationId?: InputMaybe<Scalars['String']['input']>;
     patientId?: InputMaybe<Scalars['String']['input']>;
 };
 export type ConsentSourceInput = {
@@ -5838,6 +5911,18 @@ export type Query = {
     diagnosticReports?: Maybe<DiagnosticReportBundle>;
     explanationOfBenefits?: Maybe<ExplanationOfBenefitBundle>;
     findPersonWithClientSlugAndId?: Maybe<PersonInfoForLogin>;
+    /**
+     * Returns the access history for the currently authenticated person — who has
+     *   accessed their data, how often, when it was last accessed, and for what reason
+     *   — as a per-accessor summary over a rolling window (currently 90 days).
+     *
+     *   HDS proxies this to the FHIR server's `Person/{id}/$access-history` operation,
+     *   scoped to the person id in the caller's JWT, and flattens the returned FHIR
+     *   `Parameters` resource into this typed shape. The FHIR server enforces
+     *   authorization (a user can only read their own access history) and requires both
+     *   `Person.read` and `AuditEvent.read` scopes.
+     */
+    getAccessHistory: AccessHistoryResult;
     getAllergyIntoleranceGroups: AllergyIntoleranceGroupQueryResults;
     /** Retrieves a list of AllergyIntolerance resources based on the provided search criteria. */
     getAllergyIntolerances: AllergyIntoleranceQueryResults;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icanbwell/bwell-sdk-ts",
-  "version": "1.98.0",
+  "version": "1.99.0",
   "description": "b.well TypeScript SDK",
   "license": "UNLICENSED",
   "type": "module",