@icure/api 8.6.4 → 8.6.6

package/icc-x-api/icc-form-x-api.js

@@ -74,9 +74,9 @@ class IccFormXApi extends icc_api_1.IccFormApi {
      *      3.2.  if it doesn't exist in the cache, it has to be loaded from Browser Local store, and then import it to WebCrypto
      * 4. Obtain the array of delegations which are delegated to his ID (hcpartyId) in this patient
      * 5. Decrypt and collect all keys (secretForeignKeys) within delegations of previous step (with obtained AES key of step 4)
-     * 6. Do the REST call to get all contacts with (allSecretForeignKeysDelimitedByComa, hcpartyId)
+     * 6. Do the REST call to get all forms with (allSecretForeignKeysDelimitedByComa, hcpartyId)
      *
-     * After these painful steps, you have the contacts of the patient.
+     * After these painful steps, you have the forms of the patient.
      * @deprecated use {@link findIdsBy} instead.
      * @param hcpartyId
      * @param patient
@@ -93,8 +93,14 @@ class IccFormXApi extends icc_api_1.IccFormApi {
         });
     }
     /**
-     * Same as {@link findBy} but it will only return the ids of the forms. It can also filter the forms where Form.openingDate is between
-     * startDate and endDate in ascending or descending order by that field. (default: ascending).
+     * Same as {@link findBy} but it will only return the ids of the forms. It can also filter the forms by opening date
+     * (the date when the form was opened/started) between startDate and endDate in ascending or descending order by that field (default: ascending).
+     * @param hcpartyId the id of the data owner.
+     * @param patient the patient whose forms to retrieve.
+     * @param startDate optional start date filter (inclusive). Only forms with openingDate >= startDate will be returned.
+     * @param endDate optional end date filter (inclusive). Only forms with openingDate <= endDate will be returned.
+     * @param descending if true, results are sorted by openingDate in descending order; otherwise in ascending order (default).
+     * @return an array of form ids.
      */
     findIdsBy(hcpartyId, patient, startDate, endDate, descending) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -102,6 +108,12 @@ class IccFormXApi extends icc_api_1.IccFormApi {
             return this.findFormIdsByDataOwnerPatientOpeningDate(hcpartyId, _.uniq(extractedKeys), startDate, endDate, descending);
         });
     }
+    /**
+     * Decrypts the encrypted content of the provided forms.
+     * @param hcpartyId the id of the data owner attempting to decrypt the forms.
+     * @param forms the forms to decrypt.
+     * @return an array of decrypted forms. Forms that could not be decrypted will be returned as-is.
+     */
     decrypt(hcpartyId, forms) {
         return __awaiter(this, void 0, void 0, function* () {
             return (yield this.crypto.xapi.tryDecryptEntities(forms, utils_1.EntityWithDelegationTypeName.Form, (x) => new models.Form(x))).map(({ entity }) => entity);
@@ -201,12 +213,30 @@ class IccFormXApi extends icc_api_1.IccFormApi {
                 .then((r) => r.mapSuccessAsync((e) => this.decrypt(self, [e]).then((es) => es[0])));
         });
     }
+    /**
+     * Gets all data owners that have access to the given form, along with their access levels.
+     * @param entity the form to check.
+     * @return an object containing:
+     * - permissionsByDataOwnerId: a map of data owner id to their access level.
+     * - hasUnknownAnonymousDataOwners: true if there are anonymous data owners with access that could not be identified.
+     */
     getDataOwnersWithAccessTo(entity) {
         return this.crypto.delegationsDeAnonymization.getDataOwnersWithAccessTo({ entity, type: utils_1.EntityWithDelegationTypeName.Form });
     }
+    /**
+     * Retrieves all encryption keys of the given form that are available to the current data owner.
+     * @param entity the form whose encryption keys to retrieve.
+     * @return an array of encryption keys in hexadecimal string format.
+     */
     getEncryptionKeysOf(entity) {
         return this.crypto.xapi.encryptionKeysOf({ entity, type: utils_1.EntityWithDelegationTypeName.Form }, undefined);
     }
+    /**
+     * Creates or updates de-anonymization metadata for the given form, allowing the delegates to be identified
+     * even if they were initially anonymous (e.g., in keyless mode).
+     * @param entity the form for which to create de-anonymization metadata.
+     * @param delegates the ids of the data owners for which to create de-anonymization information.
+     */
     createDelegationDeAnonymizationMetadata(entity, delegates) {
         return this.crypto.delegationsDeAnonymization.createOrUpdateDeAnonymizationInfo({ entity, type: utils_1.EntityWithDelegationTypeName.Form }, delegates);
     }

package/icc-x-api/icc-form-x-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"icc-form-x-api.js","sourceRoot":"","sources":["../../icc-x-api/icc-form-x-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { IccFormApi } from '../icc-api'\nimport { IccCryptoXApi } from './icc-crypto-x-api'\n\nimport * as _ from 'lodash'\nimport * as models from '../icc-api/model/models'\n\nimport { IccDataOwnerXApi } from './icc-data-owner-x-api'\nimport { AuthenticationProvider, NoAuthenticationProvider } from './auth/AuthenticationProvider'\nimport { SecureDelegation } from '../icc-api/model/SecureDelegation'\nimport AccessLevelEnum = SecureDelegation.AccessLevelEnum\nimport { ShareMetadataBehaviour } from './crypto/ShareMetadataBehaviour'\nimport { ShareResult } from './utils/ShareResult'\nimport { EntityShareRequest } from '../icc-api/model/requests/EntityShareRequest'\nimport RequestedPermissionEnum = EntityShareRequest.RequestedPermissionEnum\nimport { XHR } from '../icc-api/api/XHR'\nimport { EncryptedEntityXApi } from './basexapi/EncryptedEntityXApi'\nimport { EntityWithDelegationTypeName } from './utils'\nimport { SecretIdUseOption } from './crypto/SecretIdUseOption'\n\n// noinspection JSUnusedGlobalSymbols\nexport class IccFormXApi extends IccFormApi implements EncryptedEntityXApi<models.Form> {\n  crypto: IccCryptoXApi\n  dataOwnerApi: IccDataOwnerXApi\n\n  get headers(): Promise<Array<XHR.Header>> {\n    return super.headers.then((h) => this.crypto.accessControlKeysHeaders.addAccessControlKeysHeaders(h, EntityWithDelegationTypeName.Form))\n  }\n\n  constructor(\n    host: string,\n    headers: { [key: string]: string },\n    crypto: IccCryptoXApi,\n    dataOwnerApi: IccDataOwnerXApi,\n    private readonly autofillAuthor: boolean,\n    authenticationProvider: AuthenticationProvider = new NoAuthenticationProvider(),\n    fetchImpl: (input: RequestInfo, init?: RequestInit) => Promise<Response> = typeof window !== 'undefined'\n      ? window.fetch\n      : typeof self !== 'undefined'\n      ? self.fetch\n      : fetch\n  ) {\n    super(host, headers, authenticationProvider, fetchImpl)\n    this.crypto = crypto\n    this.dataOwnerApi = dataOwnerApi\n  }\n\n  /**\n   * Creates a new instance of form with initialised encryption metadata (not in the database).\n   * @param user the current user.\n   * @param patient the patient this form refers to.\n   * @param c initialised data for the form. Metadata such as id, creation data, etc. will be automatically initialised, but you can specify\n   * other kinds of data or overwrite generated metadata with this. You can't specify encryption metadata.\n   * @param options optional parameters:\n   * - additionalDelegates: delegates which will have access to the entity in addition to the current data owner and delegates from the\n   * auto-delegations. Must be an object which associates each data owner id with the access level to give to that data owner. May overlap with\n   * auto-delegations, in such case the access level specified here will be used.\n   * - sfkOption: specifies which sfk of the owning entity to use.\n   * - ignoreAutoDelegations: if true the data won't be shared with the autodelegations of the user, but only with additional delegates\n   * - alternateRootDelegation: by default a new entity is created with a root delegation from self to self. In keyless mode this is not possible,\n   * and instead the root delegation will be from self to another. You have to specify which delegate will be part of the root delegation.\n   * @return a new instance of form.\n   */\n  async newInstance(\n    user: models.User,\n    patient: models.Patient,\n    c: any = {},\n    options: {\n      additionalDelegates?: { [dataOwnerId: string]: AccessLevelEnum }\n      sfkOption?: SecretIdUseOption\n      ignoreAutoDelegations?: boolean\n      alternateRootDelegation?: string\n    } = {}\n  ) {\n    const form = {\n      ...(c ?? {}),\n      _type: 'org.taktik.icure.entities.Form',\n      id: c?.id ?? this.crypto.primitives.randomUuid(),\n      created: c?.created ?? new Date().getTime(),\n      modified: c?.modified ?? new Date().getTime(),\n      responsible: c?.responsible ?? (this.autofillAuthor ? this.dataOwnerApi.getDataOwnerIdOf(user) : undefined),\n      author: c?.author ?? (this.autofillAuthor ? user.id : undefined),\n      codes: c?.codes ?? [],\n      tags: c?.tags ?? [],\n    }\n\n    const ownerId = this.dataOwnerApi.getDataOwnerIdOf(user)\n    if (ownerId !== (await this.dataOwnerApi.getCurrentDataOwnerId())) throw new Error('Can only initialise entities as current data owner.')\n    const sfk = await this.crypto.xapi.resolveSecretIdUseOptions(\n      { entity: patient, type: EntityWithDelegationTypeName.Patient },\n      options.sfkOption ?? SecretIdUseOption.UseAnySharedWithParent\n    )\n    const extraDelegations = {\n      ...(options.ignoreAutoDelegations == true\n        ? {}\n        : Object.fromEntries(\n            [...(user.autoDelegations?.all ?? []), ...(user.autoDelegations?.medicalInformation ?? [])].map((d) => [d, AccessLevelEnum.WRITE])\n          )),\n      ...(options?.additionalDelegates ?? {}),\n    }\n    return new models.Form(\n      await this.crypto.xapi\n        .entityWithInitialisedEncryptedMetadata(\n          form,\n          EntityWithDelegationTypeName.Form,\n          patient.id,\n          sfk,\n          true,\n          extraDelegations,\n          options.alternateRootDelegation\n        )\n        .then((x) => x.updatedEntity)\n    )\n  }\n\n  // noinspection JSUnusedGlobalSymbols\n  /**\n   * 1. Check whether there is a delegation with 'hcpartyId' or not.\n   * 2. 'fetchHcParty[hcpartyId][1]': is encrypted AES exchange key by RSA public key of him.\n   * 3. Obtain the AES exchange key, by decrypting the previous step value with hcparty private key\n   *      3.1.  KeyPair should be fetch from cache (in jwk)\n   *      3.2.  if it doesn't exist in the cache, it has to be loaded from Browser Local store, and then import it to WebCrypto\n   * 4. Obtain the array of delegations which are delegated to his ID (hcpartyId) in this patient\n   * 5. Decrypt and collect all keys (secretForeignKeys) within delegations of previous step (with obtained AES key of step 4)\n   * 6. Do the REST call to get all contacts with (allSecretForeignKeysDelimitedByComa, hcpartyId)\n   *\n   * After these painful steps, you have the contacts of the patient.\n   * @deprecated use {@link findIdsBy} instead.\n   * @param hcpartyId\n   * @param patient\n   * @param usingPost (Promise)\n   */\n  async findBy(hcpartyId: string, patient: models.Patient, usingPost: boolean = false) {\n    const extractedKeys = await this.crypto.xapi.secretIdsOf({ entity: patient, type: EntityWithDelegationTypeName.Patient }, hcpartyId)\n    const topmostParentId = (await this.dataOwnerApi.getCurrentDataOwnerHierarchyIds())[0]\n    let forms: Array<models.Form> = await (usingPost\n      ? this.findFormsByHCPartyPatientForeignKeysUsingPost(hcpartyId!, undefined, undefined, undefined, _.uniq(extractedKeys))\n      : this.findFormsByHCPartyPatientForeignKeys(hcpartyId!, _.uniq(extractedKeys).join(',')))\n    return await this.decrypt(hcpartyId, forms)\n  }\n\n  /**\n   * Same as {@link findBy} but it will only return the ids of the forms. It can also filter the forms where Form.openingDate is between\n   * startDate and endDate in ascending or descending order by that field. (default: ascending).\n   */\n  async findIdsBy(hcpartyId: string, patient: models.Patient, startDate?: number, endDate?: number, descending?: boolean) {\n    const extractedKeys = await this.crypto.xapi.secretIdsOf({ entity: patient, type: EntityWithDelegationTypeName.Patient }, hcpartyId)\n    return this.findFormIdsByDataOwnerPatientOpeningDate(hcpartyId, _.uniq(extractedKeys), startDate, endDate, descending)\n  }\n\n  async decrypt(hcpartyId: string, forms: Array<models.Form>) {\n    return (await this.crypto.xapi.tryDecryptEntities(forms, EntityWithDelegationTypeName.Form, (x) => new models.Form(x))).map(\n      ({ entity }) => entity\n    )\n  }\n\n  /**\n   * @param form a form\n   * @return the id of the patient that the form refers to, retrieved from the encrypted metadata. Normally there should only be one element\n   * in the returned array, but in case of entity merges there could be multiple values.\n   */\n  async decryptPatientIdOf(form: models.Form): Promise<string[]> {\n    return this.crypto.xapi.owningEntityIdsOf({ entity: form, type: EntityWithDelegationTypeName.Form }, undefined)\n  }\n\n  /**\n   * @return if the logged data owner has write access to the content of the given form\n   */\n  async hasWriteAccess(form: models.Form): Promise<boolean> {\n    return this.crypto.xapi.hasWriteAccess({ entity: form, type: EntityWithDelegationTypeName.Form })\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param delegateId the id of the data owner which will be granted access to the form.\n   * @param form the form to share.\n   * @param options optional parameters to customize the sharing behaviour:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return the updated entity\n   */\n  async shareWith(\n    delegateId: string,\n    form: models.Form,\n    options: {\n      shareSecretIds?: string[]\n      requestedPermissions?: RequestedPermissionEnum\n      shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n    } = {}\n  ): Promise<models.Form> {\n    return this.shareWithMany(form, { [delegateId]: options })\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param form the form to share.\n   * @param delegates associates the id of data owners which will be granted access to the entity, to the following sharing options:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return the updated entity\n   */\n  async shareWithMany(\n    form: models.Form,\n    delegates: {\n      [delegateId: string]: {\n        shareSecretIds?: string[]\n        requestedPermissions?: RequestedPermissionEnum\n        shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n        sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      }\n    }\n  ): Promise<models.Form> {\n    return (await this.tryShareWithMany(form, delegates)).updatedEntityOrThrow\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param form the form to share.\n   * @param delegates associates the id of data owners which will be granted access to the entity, to the following sharing options:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return a promise which will contain the result of the operation: the updated entity if the operation was successful or details of the error if\n   * the operation failed.\n   */\n  async tryShareWithMany(\n    form: models.Form,\n    delegates: {\n      [delegateId: string]: {\n        shareSecretIds?: string[]\n        requestedPermissions?: RequestedPermissionEnum\n        shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n        sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      }\n    }\n  ): Promise<ShareResult<models.Form>> {\n    const self = await this.dataOwnerApi.getCurrentDataOwnerId()\n    // All entities should have an encryption key.\n    const entityWithEncryptionKey = await this.crypto.xapi.ensureEncryptionKeysInitialised(form, EntityWithDelegationTypeName.Form)\n    const updatedEntity = entityWithEncryptionKey ? await this.modifyForm(entityWithEncryptionKey) : form\n    return this.crypto.xapi\n      .simpleShareOrUpdateEncryptedEntityMetadata(\n        {\n          entity: updatedEntity,\n          type: EntityWithDelegationTypeName.Form,\n        },\n        Object.fromEntries(\n          Object.entries(delegates).map(([delegateId, options]) => [\n            delegateId,\n            {\n              requestedPermissions: options.requestedPermissions,\n              shareEncryptionKeys: options.shareEncryptionKey,\n              shareOwningEntityIds: options.sharePatientId,\n              shareSecretIds: options.shareSecretIds,\n            },\n          ])\n        ),\n        (x) => this.bulkShareForms(x)\n      )\n      .then((r) => r.mapSuccessAsync((e) => this.decrypt(self, [e]).then((es) => es[0])))\n  }\n\n  getDataOwnersWithAccessTo(\n    entity: models.Form\n  ): Promise<{ permissionsByDataOwnerId: { [p: string]: AccessLevelEnum }; hasUnknownAnonymousDataOwners: boolean }> {\n    return this.crypto.delegationsDeAnonymization.getDataOwnersWithAccessTo({ entity, type: EntityWithDelegationTypeName.Form })\n  }\n\n  getEncryptionKeysOf(entity: models.Form): Promise<string[]> {\n    return this.crypto.xapi.encryptionKeysOf({ entity, type: EntityWithDelegationTypeName.Form }, undefined)\n  }\n\n  createDelegationDeAnonymizationMetadata(entity: models.Form, delegates: string[]): Promise<void> {\n    return this.crypto.delegationsDeAnonymization.createOrUpdateDeAnonymizationInfo({ entity, type: EntityWithDelegationTypeName.Form }, delegates)\n  }\n}\n"]}
+{"version":3,"file":"icc-form-x-api.js","sourceRoot":"","sources":["../../icc-x-api/icc-form-x-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { IccFormApi } from '../icc-api'\nimport { IccCryptoXApi } from './icc-crypto-x-api'\n\nimport * as _ from 'lodash'\nimport * as models from '../icc-api/model/models'\n\nimport { IccDataOwnerXApi } from './icc-data-owner-x-api'\nimport { AuthenticationProvider, NoAuthenticationProvider } from './auth/AuthenticationProvider'\nimport { SecureDelegation } from '../icc-api/model/SecureDelegation'\nimport AccessLevelEnum = SecureDelegation.AccessLevelEnum\nimport { ShareMetadataBehaviour } from './crypto/ShareMetadataBehaviour'\nimport { ShareResult } from './utils/ShareResult'\nimport { EntityShareRequest } from '../icc-api/model/requests/EntityShareRequest'\nimport RequestedPermissionEnum = EntityShareRequest.RequestedPermissionEnum\nimport { XHR } from '../icc-api/api/XHR'\nimport { EncryptedEntityXApi } from './basexapi/EncryptedEntityXApi'\nimport { EntityWithDelegationTypeName } from './utils'\nimport { SecretIdUseOption } from './crypto/SecretIdUseOption'\n\n// noinspection JSUnusedGlobalSymbols\nexport class IccFormXApi extends IccFormApi implements EncryptedEntityXApi<models.Form> {\n  crypto: IccCryptoXApi\n  dataOwnerApi: IccDataOwnerXApi\n\n  get headers(): Promise<Array<XHR.Header>> {\n    return super.headers.then((h) => this.crypto.accessControlKeysHeaders.addAccessControlKeysHeaders(h, EntityWithDelegationTypeName.Form))\n  }\n\n  constructor(\n    host: string,\n    headers: { [key: string]: string },\n    crypto: IccCryptoXApi,\n    dataOwnerApi: IccDataOwnerXApi,\n    private readonly autofillAuthor: boolean,\n    authenticationProvider: AuthenticationProvider = new NoAuthenticationProvider(),\n    fetchImpl: (input: RequestInfo, init?: RequestInit) => Promise<Response> = typeof window !== 'undefined'\n      ? window.fetch\n      : typeof self !== 'undefined'\n      ? self.fetch\n      : fetch\n  ) {\n    super(host, headers, authenticationProvider, fetchImpl)\n    this.crypto = crypto\n    this.dataOwnerApi = dataOwnerApi\n  }\n\n  /**\n   * Creates a new instance of form with initialised encryption metadata (not in the database).\n   * @param user the current user.\n   * @param patient the patient this form refers to.\n   * @param c initialised data for the form. Metadata such as id, creation data, etc. will be automatically initialised, but you can specify\n   * other kinds of data or overwrite generated metadata with this. You can't specify encryption metadata.\n   * @param options optional parameters:\n   * - additionalDelegates: delegates which will have access to the entity in addition to the current data owner and delegates from the\n   * auto-delegations. Must be an object which associates each data owner id with the access level to give to that data owner. May overlap with\n   * auto-delegations, in such case the access level specified here will be used.\n   * - sfkOption: specifies which sfk of the owning entity to use.\n   * - ignoreAutoDelegations: if true the data won't be shared with the autodelegations of the user, but only with additional delegates\n   * - alternateRootDelegation: by default a new entity is created with a root delegation from self to self. In keyless mode this is not possible,\n   * and instead the root delegation will be from self to another. You have to specify which delegate will be part of the root delegation.\n   * @return a new instance of form.\n   */\n  async newInstance(\n    user: models.User,\n    patient: models.Patient,\n    c: any = {},\n    options: {\n      additionalDelegates?: { [dataOwnerId: string]: AccessLevelEnum }\n      sfkOption?: SecretIdUseOption\n      ignoreAutoDelegations?: boolean\n      alternateRootDelegation?: string\n    } = {}\n  ) {\n    const form = {\n      ...(c ?? {}),\n      _type: 'org.taktik.icure.entities.Form',\n      id: c?.id ?? this.crypto.primitives.randomUuid(),\n      created: c?.created ?? new Date().getTime(),\n      modified: c?.modified ?? new Date().getTime(),\n      responsible: c?.responsible ?? (this.autofillAuthor ? this.dataOwnerApi.getDataOwnerIdOf(user) : undefined),\n      author: c?.author ?? (this.autofillAuthor ? user.id : undefined),\n      codes: c?.codes ?? [],\n      tags: c?.tags ?? [],\n    }\n\n    const ownerId = this.dataOwnerApi.getDataOwnerIdOf(user)\n    if (ownerId !== (await this.dataOwnerApi.getCurrentDataOwnerId())) throw new Error('Can only initialise entities as current data owner.')\n    const sfk = await this.crypto.xapi.resolveSecretIdUseOptions(\n      { entity: patient, type: EntityWithDelegationTypeName.Patient },\n      options.sfkOption ?? SecretIdUseOption.UseAnySharedWithParent\n    )\n    const extraDelegations = {\n      ...(options.ignoreAutoDelegations == true\n        ? {}\n        : Object.fromEntries(\n            [...(user.autoDelegations?.all ?? []), ...(user.autoDelegations?.medicalInformation ?? [])].map((d) => [d, AccessLevelEnum.WRITE])\n          )),\n      ...(options?.additionalDelegates ?? {}),\n    }\n    return new models.Form(\n      await this.crypto.xapi\n        .entityWithInitialisedEncryptedMetadata(\n          form,\n          EntityWithDelegationTypeName.Form,\n          patient.id,\n          sfk,\n          true,\n          extraDelegations,\n          options.alternateRootDelegation\n        )\n        .then((x) => x.updatedEntity)\n    )\n  }\n\n  // noinspection JSUnusedGlobalSymbols\n  /**\n   * 1. Check whether there is a delegation with 'hcpartyId' or not.\n   * 2. 'fetchHcParty[hcpartyId][1]': is encrypted AES exchange key by RSA public key of him.\n   * 3. Obtain the AES exchange key, by decrypting the previous step value with hcparty private key\n   *      3.1.  KeyPair should be fetch from cache (in jwk)\n   *      3.2.  if it doesn't exist in the cache, it has to be loaded from Browser Local store, and then import it to WebCrypto\n   * 4. Obtain the array of delegations which are delegated to his ID (hcpartyId) in this patient\n   * 5. Decrypt and collect all keys (secretForeignKeys) within delegations of previous step (with obtained AES key of step 4)\n   * 6. Do the REST call to get all forms with (allSecretForeignKeysDelimitedByComa, hcpartyId)\n   *\n   * After these painful steps, you have the forms of the patient.\n   * @deprecated use {@link findIdsBy} instead.\n   * @param hcpartyId\n   * @param patient\n   * @param usingPost (Promise)\n   */\n  async findBy(hcpartyId: string, patient: models.Patient, usingPost: boolean = false) {\n    const extractedKeys = await this.crypto.xapi.secretIdsOf({ entity: patient, type: EntityWithDelegationTypeName.Patient }, hcpartyId)\n    const topmostParentId = (await this.dataOwnerApi.getCurrentDataOwnerHierarchyIds())[0]\n    let forms: Array<models.Form> = await (usingPost\n      ? this.findFormsByHCPartyPatientForeignKeysUsingPost(hcpartyId!, undefined, undefined, undefined, _.uniq(extractedKeys))\n      : this.findFormsByHCPartyPatientForeignKeys(hcpartyId!, _.uniq(extractedKeys).join(',')))\n    return await this.decrypt(hcpartyId, forms)\n  }\n\n  /**\n   * Same as {@link findBy} but it will only return the ids of the forms. It can also filter the forms by opening date\n   * (the date when the form was opened/started) between startDate and endDate in ascending or descending order by that field (default: ascending).\n   * @param hcpartyId the id of the data owner.\n   * @param patient the patient whose forms to retrieve.\n   * @param startDate optional start date filter (inclusive). Only forms with openingDate >= startDate will be returned.\n   * @param endDate optional end date filter (inclusive). Only forms with openingDate <= endDate will be returned.\n   * @param descending if true, results are sorted by openingDate in descending order; otherwise in ascending order (default).\n   * @return an array of form ids.\n   */\n  async findIdsBy(hcpartyId: string, patient: models.Patient, startDate?: number, endDate?: number, descending?: boolean) {\n    const extractedKeys = await this.crypto.xapi.secretIdsOf({ entity: patient, type: EntityWithDelegationTypeName.Patient }, hcpartyId)\n    return this.findFormIdsByDataOwnerPatientOpeningDate(hcpartyId, _.uniq(extractedKeys), startDate, endDate, descending)\n  }\n\n  /**\n   * Decrypts the encrypted content of the provided forms.\n   * @param hcpartyId the id of the data owner attempting to decrypt the forms.\n   * @param forms the forms to decrypt.\n   * @return an array of decrypted forms. Forms that could not be decrypted will be returned as-is.\n   */\n  async decrypt(hcpartyId: string, forms: Array<models.Form>) {\n    return (await this.crypto.xapi.tryDecryptEntities(forms, EntityWithDelegationTypeName.Form, (x) => new models.Form(x))).map(\n      ({ entity }) => entity\n    )\n  }\n\n  /**\n   * @param form a form\n   * @return the id of the patient that the form refers to, retrieved from the encrypted metadata. Normally there should only be one element\n   * in the returned array, but in case of entity merges there could be multiple values.\n   */\n  async decryptPatientIdOf(form: models.Form): Promise<string[]> {\n    return this.crypto.xapi.owningEntityIdsOf({ entity: form, type: EntityWithDelegationTypeName.Form }, undefined)\n  }\n\n  /**\n   * @return if the logged data owner has write access to the content of the given form\n   */\n  async hasWriteAccess(form: models.Form): Promise<boolean> {\n    return this.crypto.xapi.hasWriteAccess({ entity: form, type: EntityWithDelegationTypeName.Form })\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param delegateId the id of the data owner which will be granted access to the form.\n   * @param form the form to share.\n   * @param options optional parameters to customize the sharing behaviour:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return the updated entity\n   */\n  async shareWith(\n    delegateId: string,\n    form: models.Form,\n    options: {\n      shareSecretIds?: string[]\n      requestedPermissions?: RequestedPermissionEnum\n      shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n    } = {}\n  ): Promise<models.Form> {\n    return this.shareWithMany(form, { [delegateId]: options })\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param form the form to share.\n   * @param delegates associates the id of data owners which will be granted access to the entity, to the following sharing options:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return the updated entity\n   */\n  async shareWithMany(\n    form: models.Form,\n    delegates: {\n      [delegateId: string]: {\n        shareSecretIds?: string[]\n        requestedPermissions?: RequestedPermissionEnum\n        shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n        sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      }\n    }\n  ): Promise<models.Form> {\n    return (await this.tryShareWithMany(form, delegates)).updatedEntityOrThrow\n  }\n\n  /**\n   * Share an existing form with other data owners, allowing them to access the non-encrypted data of the form and optionally also\n   * the encrypted content, with read-only or read-write permissions.\n   * @param form the form to share.\n   * @param delegates associates the id of data owners which will be granted access to the entity, to the following sharing options:\n   * - shareSecretIds: specifies which secret ids of the entity should be shared. If not provided all secret ids available to the current user will be shared\n   * - shareEncryptionKey: specifies if the encryption key of the access log should be shared with the delegate, giving access to all encrypted\n   * content of the entity, excluding other encrypted metadata (defaults to {@link ShareMetadataBehaviour.IF_AVAILABLE}). Note that by default a\n   * form does not have encrypted content.\n   * - sharePatientId: specifies if the id of the patient that this form refers to should be shared with the delegate (defaults to\n   * {@link ShareMetadataBehaviour.IF_AVAILABLE}).\n   * - requestedPermissions: the requested permissions for the delegate, defaults to {@link RequestedPermissionEnum.MAX_WRITE}.\n   * @return a promise which will contain the result of the operation: the updated entity if the operation was successful or details of the error if\n   * the operation failed.\n   */\n  async tryShareWithMany(\n    form: models.Form,\n    delegates: {\n      [delegateId: string]: {\n        shareSecretIds?: string[]\n        requestedPermissions?: RequestedPermissionEnum\n        shareEncryptionKey?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n        sharePatientId?: ShareMetadataBehaviour // Defaults to ShareMetadataBehaviour.IF_AVAILABLE\n      }\n    }\n  ): Promise<ShareResult<models.Form>> {\n    const self = await this.dataOwnerApi.getCurrentDataOwnerId()\n    // All entities should have an encryption key.\n    const entityWithEncryptionKey = await this.crypto.xapi.ensureEncryptionKeysInitialised(form, EntityWithDelegationTypeName.Form)\n    const updatedEntity = entityWithEncryptionKey ? await this.modifyForm(entityWithEncryptionKey) : form\n    return this.crypto.xapi\n      .simpleShareOrUpdateEncryptedEntityMetadata(\n        {\n          entity: updatedEntity,\n          type: EntityWithDelegationTypeName.Form,\n        },\n        Object.fromEntries(\n          Object.entries(delegates).map(([delegateId, options]) => [\n            delegateId,\n            {\n              requestedPermissions: options.requestedPermissions,\n              shareEncryptionKeys: options.shareEncryptionKey,\n              shareOwningEntityIds: options.sharePatientId,\n              shareSecretIds: options.shareSecretIds,\n            },\n          ])\n        ),\n        (x) => this.bulkShareForms(x)\n      )\n      .then((r) => r.mapSuccessAsync((e) => this.decrypt(self, [e]).then((es) => es[0])))\n  }\n\n  /**\n   * Gets all data owners that have access to the given form, along with their access levels.\n   * @param entity the form to check.\n   * @return an object containing:\n   * - permissionsByDataOwnerId: a map of data owner id to their access level.\n   * - hasUnknownAnonymousDataOwners: true if there are anonymous data owners with access that could not be identified.\n   */\n  getDataOwnersWithAccessTo(\n    entity: models.Form\n  ): Promise<{ permissionsByDataOwnerId: { [p: string]: AccessLevelEnum }; hasUnknownAnonymousDataOwners: boolean }> {\n    return this.crypto.delegationsDeAnonymization.getDataOwnersWithAccessTo({ entity, type: EntityWithDelegationTypeName.Form })\n  }\n\n  /**\n   * Retrieves all encryption keys of the given form that are available to the current data owner.\n   * @param entity the form whose encryption keys to retrieve.\n   * @return an array of encryption keys in hexadecimal string format.\n   */\n  getEncryptionKeysOf(entity: models.Form): Promise<string[]> {\n    return this.crypto.xapi.encryptionKeysOf({ entity, type: EntityWithDelegationTypeName.Form }, undefined)\n  }\n\n  /**\n   * Creates or updates de-anonymization metadata for the given form, allowing the delegates to be identified\n   * even if they were initially anonymous (e.g., in keyless mode).\n   * @param entity the form for which to create de-anonymization metadata.\n   * @param delegates the ids of the data owners for which to create de-anonymization information.\n   */\n  createDelegationDeAnonymizationMetadata(entity: models.Form, delegates: string[]): Promise<void> {\n    return this.crypto.delegationsDeAnonymization.createOrUpdateDeAnonymizationInfo({ entity, type: EntityWithDelegationTypeName.Form }, delegates)\n  }\n}\n"]}

package/icc-x-api/icc-hcparty-x-api.d.ts

@@ -21,15 +21,82 @@ export declare class IccHcpartyXApi extends IccHcpartyApi {
         [key: string]: string;
     }, authenticationProvider: AuthenticationProvider | undefined, authApi: IccAuthApi, fetchImpl?: (input: RequestInfo, init?: RequestInit) => Promise<Response>);
     private getHcPartyFromCache;
+    /**
+     * Ensures the healthcare party has consistent name fields. If lastName/name are set but there is no Official
+     * PersonName, one is created. Conversely, if an Official PersonName exists but lastName/name are missing, they
+     * are populated from the PersonName.
+     * @param hcParty the healthcare party whose names should be completed.
+     * @return the healthcare party with completed name fields, or undefined if the input was undefined.
+     */
     completeNames(hcParty?: models.HealthcareParty): models.HealthcareParty | undefined;
+    /**
+     * Stores a healthcare party promise in the local cache with a time-to-live.
+     * @param key the cache key (typically the healthcare party id).
+     * @param hcpPromise the promise resolving to the healthcare party to cache.
+     * @return the same promise that was cached.
+     */
     putHcPartyInCache(key: string, hcpPromise: Promise<HealthcareParty>): Promise<HealthcareParty>;
+    /**
+     * Creates a new healthcare party after completing its name fields.
+     * @param body the healthcare party to create.
+     * @return the created healthcare party.
+     */
     createHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty>;
+    /**
+     * Creates a new healthcare party in the specified group after completing its name fields.
+     * @param groupId the id of the group in which to create the healthcare party.
+     * @param body the healthcare party to create.
+     * @return the created healthcare party.
+     */
     createHealthcarePartyInGroup(groupId: string, body?: HealthcareParty): Promise<HealthcareParty>;
+    /**
+     * Modifies an existing healthcare party after completing its name fields. Evicts the party from the local cache
+     * before modifying, and re-caches the updated version upon success.
+     * @param body the healthcare party with updated fields.
+     * @return the modified healthcare party.
+     */
     modifyHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty | any>;
+    /**
+     * Retrieves a healthcare party by id. Returns a cached version if available and not expired, otherwise fetches
+     * from the server and caches the result.
+     * @param healthcarePartyId the id of the healthcare party to retrieve.
+     * @param bypassCache if true, skips the cache and fetches directly from the server.
+     * @return the healthcare party.
+     */
     getHealthcareParty(healthcarePartyId: string, bypassCache?: boolean): Promise<HealthcareParty | any>;
+    /**
+     * Retrieves the full hierarchy of healthcare party ids, from the topmost parent down to the given party.
+     * Recursively walks up the parentId chain.
+     * @param healthcarePartyId the id of the healthcare party whose hierarchy to retrieve.
+     * @param bypassCache if true, bypasses the cache for each party in the hierarchy.
+     * @return an array of healthcare party ids ordered from the topmost ancestor to the given party.
+     */
     getHealthcarePartyHierarchyIds(healthcarePartyId: string, bypassCache?: boolean): Promise<string[]>;
+    /**
+     * Retrieves multiple healthcare parties by their ids. Uses the cache where possible, and fetches any missing
+     * parties from the server in a single bulk request. Parties not found on the server are filtered out.
+     * @param healthcarePartyIds the list of healthcare party ids to retrieve.
+     * @return an array of healthcare parties (excluding any that were not found).
+     */
     getHealthcareParties(healthcarePartyIds: ListOfIds): Promise<Array<HealthcareParty> | any>;
+    /**
+     * Retrieves the currently logged-in healthcare party and caches it.
+     * @return the current healthcare party.
+     */
     getCurrentHealthcareParty(): Promise<HealthcareParty>;
+    /**
+     * Validates a Belgian CBE (Crossroads Bank for Enterprises) number using the modulo 97 check.
+     * @param cbe the CBE number to validate (non-digit characters are stripped).
+     * @return true if the CBE number is valid, false otherwise.
+     */
     isValidCbe(cbe: string): boolean;
+    /**
+     * Subscribes to real-time healthcare party events using a WebSocket connection.
+     * @param eventTypes the types of events to listen for (e.g. 'CREATE', 'UPDATE', 'DELETE').
+     * @param filter an optional filter to restrict which healthcare party events trigger the callback.
+     * @param eventFired the callback function invoked when a matching healthcare party event is received.
+     * @param options optional subscription configuration such as connection parameters and retry behaviour.
+     * @return a connection object that can be used to manage the WebSocket subscription lifecycle.
+     */
     subscribeToHealthcarePartyEvents(eventTypes: ('CREATE' | 'UPDATE' | 'DELETE')[], filter: AbstractFilter<HealthcareParty> | undefined, eventFired: (dataSample: HealthcareParty) => Promise<void>, options?: SubscriptionOptions): Promise<Connection>;
 }

package/icc-x-api/icc-hcparty-x-api.js

@@ -46,6 +46,13 @@ class IccHcpartyXApi extends icc_api_1.IccHcpartyApi {
         }
         return null;
     }
+    /**
+     * Ensures the healthcare party has consistent name fields. If lastName/name are set but there is no Official
+     * PersonName, one is created. Conversely, if an Official PersonName exists but lastName/name are missing, they
+     * are populated from the PersonName.
+     * @param hcParty the healthcare party whose names should be completed.
+     * @return the healthcare party with completed name fields, or undefined if the input was undefined.
+     */
     completeNames(hcParty) {
         if (!hcParty) {
             return hcParty;
@@ -60,16 +67,39 @@ class IccHcpartyXApi extends icc_api_1.IccHcpartyApi {
         }
         return finalHcParty;
     }
+    /**
+     * Stores a healthcare party promise in the local cache with a time-to-live.
+     * @param key the cache key (typically the healthcare party id).
+     * @param hcpPromise the promise resolving to the healthcare party to cache.
+     * @return the same promise that was cached.
+     */
     putHcPartyInCache(key, hcpPromise) {
         this.hcPartyCache[key] = [Date.now() + this.CACHE_RETENTION_IN_MS, hcpPromise];
         return hcpPromise;
     }
+    /**
+     * Creates a new healthcare party after completing its name fields.
+     * @param body the healthcare party to create.
+     * @return the created healthcare party.
+     */
     createHealthcareParty(body) {
         return super.createHealthcareParty(this.completeNames(body));
     }
+    /**
+     * Creates a new healthcare party in the specified group after completing its name fields.
+     * @param groupId the id of the group in which to create the healthcare party.
+     * @param body the healthcare party to create.
+     * @return the created healthcare party.
+     */
     createHealthcarePartyInGroup(groupId, body) {
         return super.createHealthcarePartyInGroup(groupId, this.completeNames(body));
     }
+    /**
+     * Modifies an existing healthcare party after completing its name fields. Evicts the party from the local cache
+     * before modifying, and re-caches the updated version upon success.
+     * @param body the healthcare party with updated fields.
+     * @return the modified healthcare party.
+     */
     modifyHealthcareParty(body) {
         if (body && body.id) {
             console.log(`Evict key ${body.id} because of modification`);
@@ -77,6 +107,13 @@ class IccHcpartyXApi extends icc_api_1.IccHcpartyApi {
         }
         return super.modifyHealthcareParty(this.completeNames(body)).then((hcp) => this.putHcPartyInCache(hcp.id, Promise.resolve(hcp)));
     }
+    /**
+     * Retrieves a healthcare party by id. Returns a cached version if available and not expired, otherwise fetches
+     * from the server and caches the result.
+     * @param healthcarePartyId the id of the healthcare party to retrieve.
+     * @param bypassCache if true, skips the cache and fetches directly from the server.
+     * @return the healthcare party.
+     */
     getHealthcareParty(healthcarePartyId_1) {
         const _super = Object.create(null, {
             getHealthcareParty: { get: () => super.getHealthcareParty }
@@ -99,11 +136,24 @@ class IccHcpartyXApi extends icc_api_1.IccHcpartyApi {
             }
         });
     }
+    /**
+     * Retrieves the full hierarchy of healthcare party ids, from the topmost parent down to the given party.
+     * Recursively walks up the parentId chain.
+     * @param healthcarePartyId the id of the healthcare party whose hierarchy to retrieve.
+     * @param bypassCache if true, bypasses the cache for each party in the hierarchy.
+     * @return an array of healthcare party ids ordered from the topmost ancestor to the given party.
+     */
     getHealthcarePartyHierarchyIds(healthcarePartyId, bypassCache = false) {
         return this.getHealthcareParty(healthcarePartyId, bypassCache).then((hcp) => __awaiter(this, void 0, void 0, function* () {
             return hcp ? (hcp.parentId ? (yield this.getHealthcarePartyHierarchyIds(hcp.parentId, bypassCache)).concat([hcp.id]) : [hcp.id]) : [];
         }));
     }
+    /**
+     * Retrieves multiple healthcare parties by their ids. Uses the cache where possible, and fetches any missing
+     * parties from the server in a single bulk request. Parties not found on the server are filtered out.
+     * @param healthcarePartyIds the list of healthcare party ids to retrieve.
+     * @return an array of healthcare parties (excluding any that were not found).
+     */
     getHealthcareParties(healthcarePartyIds) {
         const _super = Object.create(null, {
             getHealthcareParties: { get: () => super.getHealthcareParties }
@@ -149,14 +199,31 @@ class IccHcpartyXApi extends icc_api_1.IccHcpartyApi {
             })).then((results) => results.filter((it) => it != null));
         });
     }
+    /**
+     * Retrieves the currently logged-in healthcare party and caches it.
+     * @return the current healthcare party.
+     */
     getCurrentHealthcareParty() {
         return super.getCurrentHealthcareParty().then((hcp) => this.putHcPartyInCache(hcp.id, Promise.resolve(hcp)));
     }
+    /**
+     * Validates a Belgian CBE (Crossroads Bank for Enterprises) number using the modulo 97 check.
+     * @param cbe the CBE number to validate (non-digit characters are stripped).
+     * @return true if the CBE number is valid, false otherwise.
+     */
     isValidCbe(cbe) {
         cbe = cbe.replace(new RegExp('[^(0-9)]', 'g'), '');
         cbe = cbe.length == 9 ? '0' + cbe : cbe;
         return 97 - (Number(cbe.substring(0, 8)) % 97) === Number(cbe.substring(8, 10));
     }
+    /**
+     * Subscribes to real-time healthcare party events using a WebSocket connection.
+     * @param eventTypes the types of events to listen for (e.g. 'CREATE', 'UPDATE', 'DELETE').
+     * @param filter an optional filter to restrict which healthcare party events trigger the callback.
+     * @param eventFired the callback function invoked when a matching healthcare party event is received.
+     * @param options optional subscription configuration such as connection parameters and retry behaviour.
+     * @return a connection object that can be used to manage the WebSocket subscription lifecycle.
+     */
     subscribeToHealthcarePartyEvents(eventTypes_1, filter_1, eventFired_1) {
         return __awaiter(this, arguments, void 0, function* (eventTypes, filter, eventFired, options = {}) {
             return (0, utils_1.subscribeToEntityEvents)(this.host, this.authApi, 'HealthcareParty', eventTypes, filter, eventFired, options).then((rs) => new Connection_1.ConnectionImpl(rs));

package/icc-x-api/icc-hcparty-x-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"icc-hcparty-x-api.js","sourceRoot":"","sources":["../../icc-x-api/icc-hcparty-x-api.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wCAAsD;AAEtD,kDAAiD;AACjD,qDAA8E;AAC9E,0EAAgG;AAEhG,mCAAsE;AACtE,4DAAwE;AACxE,oDAAmD;AACnD,4CAAwC;AACxC,IAAO,QAAQ,GAAG,SAAG,CAAC,QAAQ,CAAA;AAE9B,qCAAqC;AACrC,MAAa,cAAe,SAAQ,uBAAa;IAK/C,YACE,IAAY,EACZ,OAAkC,EAClC,yBAAiD,IAAI,iDAAwB,EAAE,EAC9D,OAAmB,EACpC,YAA2E,OAAO,MAAM,KAAK,WAAW;QACtG,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,OAAO,IAAI,KAAK,WAAW;YAC7B,CAAC,CAAC,IAAI,CAAC,KAAK;YACZ,CAAC,CAAC,KAAK;QAET,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAA;QAPtC,YAAO,GAAP,OAAO,CAAY;QARtC,qBAAgB,GAAiD,EAAE,CAAA;QACnE,iBAAY,GAA0D,EAAE,CAAA;QAEhE,0BAAqB,GAAG,MAAO,CAAA;IAavC,CAAC;IAEO,mBAAmB,CAAC,GAAW;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC;YACtC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAA;QACtB,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,uBAAuB,CAAC,CAAA;QAC/D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,YAAY,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;QAC5E,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,aAAa,CAAC,OAAgC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,IAAI,YAAY,GAAG,OAAO,CAAA;QAE1B,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAA,qBAAO,EAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnH,YAAY,GAAG,IAAA,mCAAqB,EAClC,YAAY,EACZ,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAClC,YAAY,CAAC,QAAQ,EACrB,YAAY,CAAC,SAAS,EACtB,YAAY,CAAC,IAAI,CAClB,CAAA;QACH,CAAC;QAED,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAA,qBAAO,EAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClH,IAAI,YAAY,GAAG,IAAA,sBAAQ,EAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YAC7E,YAAY,mCACP,YAAY,KACf,QAAQ,EAAE,YAAa,CAAC,QAAQ,EAChC,SAAS,EAAE,YAAa,CAAC,UAAU,CAAC,CAAC,CAAC,YAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAC7E,IAAI,EAAE,YAAa,CAAC,IAAI,GACzB,CAAA;QACH,CAAC;QAED,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,iBAAiB,CAAC,GAAW,EAAE,UAAoC;QACjE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAA;QAC9E,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,qBAAqB,CAAC,IAAsB;QAC1C,OAAO,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,4BAA4B,CAAC,OAAe,EAAE,IAAsB;QAClE,OAAO,KAAK,CAAC,4BAA4B,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,qBAAqB,CAAC,IAAsB;QAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAA;YAC3D,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACnC,CAAC;QAED,OAAO,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACnI,CAAC;IAEK,kBAAkB;;;;6DAAC,iBAAyB,EAAE,WAAW,GAAG,KAAK;YACrE,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;YACvF,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,CAAA;gBACxB,CAAC;gBAAC,WAAM,CAAC;oBACP,IAAI,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;wBAC1D,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAA;oBAC7C,CAAC;oBACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAA;gBAChE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,OAAM,kBAAkB,YAAC,iBAAiB,EAAE,CAAA;YACrG,CAAC;QACH,CAAC;KAAA;IAED,8BAA8B,CAAC,iBAAyB,EAAE,WAAW,GAAG,KAAK;QAC3E,OAAO,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAO,GAAoB,EAAE,EAAE;YACjG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC,QAAS,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1I,CAAC,CAAA,CAAC,CAAA;IACJ,CAAC;IAEK,oBAAoB,CAAC,kBAA6B;;;;;YACtD,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAA;YAClC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;gBACxB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YAC5B,CAAC;YACD,MAAM,MAAM,GAA4C,EAAE,CAAA;YAC1D,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,GAAG,CAAA;gBACP,IAAI,CAAC;oBACH,GAAG,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAA;gBAC1C,CAAC;gBAAC,WAAM,CAAC;oBACP,GAAG,GAAG,IAAI,CAAA;oBACV,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;gBAC9B,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA;YACxB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAE5D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAA;YAC9C,CAAC;YAED,MAAM,IAAI,GAA+B,OAAM,oBAAoB,YAAC,IAAI,kBAAS,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;YACpG,OAAO,OAAO,CAAC,GAAG,CAChB,MAAM,CAAC,GAAG,CACR,CAAC,CAAC,EAAE,EAAE;;gBACJ,OAAA,MAAA,CAAC,CAAC,CAAC,CAAC,mCACJ,IAAI,CAAC,iBAAiB,CACpB,CAAC,CAAC,CAAC,CAAC,EACJ,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oBACjB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;oBAC3C,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;wBACV,OAAO,GAAG,CAAA;oBACZ,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;oBAClD,CAAC;gBACH,CAAC,CAAC,CACH,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;oBACZ,IAAI,CAAC,YAAY,QAAQ,EAAE,CAAC;wBAC1B,MAAM,CAAC,CAAA;oBACT,CAAC;oBACD,OAAO,IAAI,CAAA;gBACb,CAAC,CAAC,CAAA;aAAA,CACL,CACF,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAA;QACzD,CAAC;KAAA;IAED,yBAAyB;QACvB,OAAO,KAAK,CAAC,yBAAyB,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAC/G,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;QAClD,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAEvC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACjF,CAAC;IAEK,gCAAgC;6DACpC,UAA8C,EAC9C,MAAmD,EACnD,UAA0D,EAC1D,UAA+B,EAAE;YAEjC,OAAO,IAAA,+BAAuB,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CACtH,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,2BAAc,CAAC,EAAE,CAAC,CAC/B,CAAA;QACH,CAAC;KAAA;CACF;AA/KD,wCA+KC","sourcesContent":["import { IccAuthApi, IccHcpartyApi } from '../icc-api'\nimport { HealthcareParty } from '../icc-api/model/HealthcareParty'\nimport * as models from '../icc-api/model/models'\nimport { findName, garnishPersonWithName, hasName } from './utils/person-util'\nimport { AuthenticationProvider, NoAuthenticationProvider } from './auth/AuthenticationProvider'\nimport { AbstractFilter } from './filters/filters'\nimport { subscribeToEntityEvents, SubscriptionOptions } from './utils'\nimport { Connection, ConnectionImpl } from '../icc-api/model/Connection'\nimport { ListOfIds } from '../icc-api/model/models'\nimport { XHR } from '../icc-api/api/XHR'\nimport XHRError = XHR.XHRError\n\n// noinspection JSUnusedGlobalSymbols\nexport class IccHcpartyXApi extends IccHcpartyApi {\n  hcPartyKeysCache: { [key: string]: { [key: string]: string } } = {}\n  hcPartyCache: { [key: string]: [number, Promise<HealthcareParty>] } = {}\n\n  private CACHE_RETENTION_IN_MS = 300_000\n  constructor(\n    host: string,\n    headers: { [key: string]: string },\n    authenticationProvider: AuthenticationProvider = new NoAuthenticationProvider(),\n    private readonly authApi: IccAuthApi,\n    fetchImpl: (input: RequestInfo, init?: RequestInit) => Promise<Response> = typeof window !== 'undefined'\n      ? window.fetch\n      : typeof self !== 'undefined'\n      ? self.fetch\n      : fetch\n  ) {\n    super(host, headers, authenticationProvider, fetchImpl)\n  }\n\n  private getHcPartyFromCache(key: string) {\n    const hcpInCache = this.hcPartyCache[key]\n    const now = Date.now()\n    if (hcpInCache && hcpInCache[0] > now) {\n      return hcpInCache[1]\n    }\n    if (!hcpInCache) {\n      console.log(`Cache miss for key ${key} because not in cache`)\n    } else {\n      console.log(`Cache miss for key ${key} because ${hcpInCache[0]} > ${now}`)\n    }\n    return null\n  }\n\n  completeNames(hcParty?: models.HealthcareParty): models.HealthcareParty | undefined {\n    if (!hcParty) {\n      return hcParty\n    }\n\n    let finalHcParty = hcParty\n\n    if ((!!finalHcParty.lastName || !!finalHcParty.name) && !hasName(finalHcParty, models.PersonName.UseEnum.Official)) {\n      finalHcParty = garnishPersonWithName(\n        finalHcParty,\n        models.PersonName.UseEnum.Official,\n        finalHcParty.lastName,\n        finalHcParty.firstName,\n        finalHcParty.name\n      )\n    }\n\n    if ((!finalHcParty.lastName || !finalHcParty.name) && !!hasName(finalHcParty, models.PersonName.UseEnum.Official)) {\n      let officialName = findName(finalHcParty, models.PersonName.UseEnum.Official)\n      finalHcParty = {\n        ...finalHcParty,\n        lastName: officialName!.lastName,\n        firstName: officialName!.firstNames ? officialName!.firstNames[0] : undefined,\n        name: officialName!.text,\n      }\n    }\n\n    return finalHcParty\n  }\n\n  putHcPartyInCache(key: string, hcpPromise: Promise<HealthcareParty>): Promise<HealthcareParty> {\n    this.hcPartyCache[key] = [Date.now() + this.CACHE_RETENTION_IN_MS, hcpPromise]\n    return hcpPromise\n  }\n\n  createHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty> {\n    return super.createHealthcareParty(this.completeNames(body))\n  }\n\n  createHealthcarePartyInGroup(groupId: string, body?: HealthcareParty): Promise<HealthcareParty> {\n    return super.createHealthcarePartyInGroup(groupId, this.completeNames(body))\n  }\n\n  modifyHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty | any> {\n    if (body && body.id) {\n      console.log(`Evict key ${body.id} because of modification`)\n      delete this.hcPartyCache[body.id]\n    }\n\n    return super.modifyHealthcareParty(this.completeNames(body)).then((hcp) => this.putHcPartyInCache(hcp.id!, Promise.resolve(hcp)))\n  }\n\n  async getHealthcareParty(healthcarePartyId: string, bypassCache = false): Promise<HealthcareParty | any> {\n    const fromCache = bypassCache ? undefined : this.getHcPartyFromCache(healthcarePartyId)\n    if (fromCache) {\n      try {\n        return await fromCache\n      } catch {\n        if (this.hcPartyCache[healthcarePartyId][1] === fromCache) {\n          delete this.hcPartyCache[healthcarePartyId]\n        }\n        return this.getHealthcareParty(healthcarePartyId, bypassCache)\n      }\n    } else {\n      return await this.putHcPartyInCache(healthcarePartyId, super.getHealthcareParty(healthcarePartyId))\n    }\n  }\n\n  getHealthcarePartyHierarchyIds(healthcarePartyId: string, bypassCache = false): Promise<string[]> {\n    return this.getHealthcareParty(healthcarePartyId, bypassCache).then(async (hcp: HealthcareParty) => {\n      return hcp ? (hcp.parentId ? (await this.getHealthcarePartyHierarchyIds(hcp.parentId!, bypassCache)).concat([hcp.id!]) : [hcp.id!]) : []\n    })\n  }\n\n  async getHealthcareParties(healthcarePartyIds: ListOfIds): Promise<Array<HealthcareParty> | any> {\n    const ids = healthcarePartyIds.ids\n    if (!ids || !ids.length) {\n      return Promise.resolve([])\n    }\n    const cached: Array<[string, HealthcareParty | null]> = []\n    for (const id of ids) {\n      let hcp\n      try {\n        hcp = await this.getHcPartyFromCache(id)\n      } catch {\n        hcp = null\n        delete this.hcPartyCache[id]\n      }\n      cached.push([id, hcp])\n    }\n    const toFetch = cached.filter((x) => !x[1]).map((x) => x[0])\n\n    if (!toFetch.length) {\n      return Promise.all(cached.map((x) => x[1]!))\n    }\n\n    const prom: Promise<HealthcareParty[]> = super.getHealthcareParties(new ListOfIds({ ids: toFetch }))\n    return Promise.all(\n      cached.map(\n        (x) =>\n          x[1] ??\n          this.putHcPartyInCache(\n            x[0],\n            prom.then((hcps) => {\n              const hcp = hcps.find((h) => h.id === x[0])\n              if (!!hcp) {\n                return hcp\n              } else {\n                throw new Error(`Hcp with id ${x[0]} not found`)\n              }\n            })\n          ).catch((e) => {\n            if (e instanceof XHRError) {\n              throw e\n            }\n            return null\n          })\n      )\n    ).then((results) => results.filter((it) => it != null))\n  }\n\n  getCurrentHealthcareParty(): Promise<HealthcareParty> {\n    return super.getCurrentHealthcareParty().then((hcp) => this.putHcPartyInCache(hcp.id!, Promise.resolve(hcp)))\n  }\n\n  isValidCbe(cbe: string) {\n    cbe = cbe.replace(new RegExp('[^(0-9)]', 'g'), '')\n    cbe = cbe.length == 9 ? '0' + cbe : cbe\n\n    return 97 - (Number(cbe.substring(0, 8)) % 97) === Number(cbe.substring(8, 10))\n  }\n\n  async subscribeToHealthcarePartyEvents(\n    eventTypes: ('CREATE' | 'UPDATE' | 'DELETE')[],\n    filter: AbstractFilter<HealthcareParty> | undefined,\n    eventFired: (dataSample: HealthcareParty) => Promise<void>,\n    options: SubscriptionOptions = {}\n  ): Promise<Connection> {\n    return subscribeToEntityEvents(this.host, this.authApi, 'HealthcareParty', eventTypes, filter, eventFired, options).then(\n      (rs) => new ConnectionImpl(rs)\n    )\n  }\n}\n"]}
+{"version":3,"file":"icc-hcparty-x-api.js","sourceRoot":"","sources":["../../icc-x-api/icc-hcparty-x-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { IccAuthApi, IccHcpartyApi } from '../icc-api'\nimport { HealthcareParty } from '../icc-api/model/HealthcareParty'\nimport * as models from '../icc-api/model/models'\nimport { findName, garnishPersonWithName, hasName } from './utils/person-util'\nimport { AuthenticationProvider, NoAuthenticationProvider } from './auth/AuthenticationProvider'\nimport { AbstractFilter } from './filters/filters'\nimport { subscribeToEntityEvents, SubscriptionOptions } from './utils'\nimport { Connection, ConnectionImpl } from '../icc-api/model/Connection'\nimport { ListOfIds } from '../icc-api/model/models'\nimport { XHR } from '../icc-api/api/XHR'\nimport XHRError = XHR.XHRError\n\n// noinspection JSUnusedGlobalSymbols\nexport class IccHcpartyXApi extends IccHcpartyApi {\n  hcPartyKeysCache: { [key: string]: { [key: string]: string } } = {}\n  hcPartyCache: { [key: string]: [number, Promise<HealthcareParty>] } = {}\n\n  private CACHE_RETENTION_IN_MS = 300_000\n  constructor(\n    host: string,\n    headers: { [key: string]: string },\n    authenticationProvider: AuthenticationProvider = new NoAuthenticationProvider(),\n    private readonly authApi: IccAuthApi,\n    fetchImpl: (input: RequestInfo, init?: RequestInit) => Promise<Response> = typeof window !== 'undefined'\n      ? window.fetch\n      : typeof self !== 'undefined'\n      ? self.fetch\n      : fetch\n  ) {\n    super(host, headers, authenticationProvider, fetchImpl)\n  }\n\n  private getHcPartyFromCache(key: string) {\n    const hcpInCache = this.hcPartyCache[key]\n    const now = Date.now()\n    if (hcpInCache && hcpInCache[0] > now) {\n      return hcpInCache[1]\n    }\n    if (!hcpInCache) {\n      console.log(`Cache miss for key ${key} because not in cache`)\n    } else {\n      console.log(`Cache miss for key ${key} because ${hcpInCache[0]} > ${now}`)\n    }\n    return null\n  }\n\n  /**\n   * Ensures the healthcare party has consistent name fields. If lastName/name are set but there is no Official\n   * PersonName, one is created. Conversely, if an Official PersonName exists but lastName/name are missing, they\n   * are populated from the PersonName.\n   * @param hcParty the healthcare party whose names should be completed.\n   * @return the healthcare party with completed name fields, or undefined if the input was undefined.\n   */\n  completeNames(hcParty?: models.HealthcareParty): models.HealthcareParty | undefined {\n    if (!hcParty) {\n      return hcParty\n    }\n\n    let finalHcParty = hcParty\n\n    if ((!!finalHcParty.lastName || !!finalHcParty.name) && !hasName(finalHcParty, models.PersonName.UseEnum.Official)) {\n      finalHcParty = garnishPersonWithName(\n        finalHcParty,\n        models.PersonName.UseEnum.Official,\n        finalHcParty.lastName,\n        finalHcParty.firstName,\n        finalHcParty.name\n      )\n    }\n\n    if ((!finalHcParty.lastName || !finalHcParty.name) && !!hasName(finalHcParty, models.PersonName.UseEnum.Official)) {\n      let officialName = findName(finalHcParty, models.PersonName.UseEnum.Official)\n      finalHcParty = {\n        ...finalHcParty,\n        lastName: officialName!.lastName,\n        firstName: officialName!.firstNames ? officialName!.firstNames[0] : undefined,\n        name: officialName!.text,\n      }\n    }\n\n    return finalHcParty\n  }\n\n  /**\n   * Stores a healthcare party promise in the local cache with a time-to-live.\n   * @param key the cache key (typically the healthcare party id).\n   * @param hcpPromise the promise resolving to the healthcare party to cache.\n   * @return the same promise that was cached.\n   */\n  putHcPartyInCache(key: string, hcpPromise: Promise<HealthcareParty>): Promise<HealthcareParty> {\n    this.hcPartyCache[key] = [Date.now() + this.CACHE_RETENTION_IN_MS, hcpPromise]\n    return hcpPromise\n  }\n\n  /**\n   * Creates a new healthcare party after completing its name fields.\n   * @param body the healthcare party to create.\n   * @return the created healthcare party.\n   */\n  createHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty> {\n    return super.createHealthcareParty(this.completeNames(body))\n  }\n\n  /**\n   * Creates a new healthcare party in the specified group after completing its name fields.\n   * @param groupId the id of the group in which to create the healthcare party.\n   * @param body the healthcare party to create.\n   * @return the created healthcare party.\n   */\n  createHealthcarePartyInGroup(groupId: string, body?: HealthcareParty): Promise<HealthcareParty> {\n    return super.createHealthcarePartyInGroup(groupId, this.completeNames(body))\n  }\n\n  /**\n   * Modifies an existing healthcare party after completing its name fields. Evicts the party from the local cache\n   * before modifying, and re-caches the updated version upon success.\n   * @param body the healthcare party with updated fields.\n   * @return the modified healthcare party.\n   */\n  modifyHealthcareParty(body?: HealthcareParty): Promise<HealthcareParty | any> {\n    if (body && body.id) {\n      console.log(`Evict key ${body.id} because of modification`)\n      delete this.hcPartyCache[body.id]\n    }\n\n    return super.modifyHealthcareParty(this.completeNames(body)).then((hcp) => this.putHcPartyInCache(hcp.id!, Promise.resolve(hcp)))\n  }\n\n  /**\n   * Retrieves a healthcare party by id. Returns a cached version if available and not expired, otherwise fetches\n   * from the server and caches the result.\n   * @param healthcarePartyId the id of the healthcare party to retrieve.\n   * @param bypassCache if true, skips the cache and fetches directly from the server.\n   * @return the healthcare party.\n   */\n  async getHealthcareParty(healthcarePartyId: string, bypassCache = false): Promise<HealthcareParty | any> {\n    const fromCache = bypassCache ? undefined : this.getHcPartyFromCache(healthcarePartyId)\n    if (fromCache) {\n      try {\n        return await fromCache\n      } catch {\n        if (this.hcPartyCache[healthcarePartyId][1] === fromCache) {\n          delete this.hcPartyCache[healthcarePartyId]\n        }\n        return this.getHealthcareParty(healthcarePartyId, bypassCache)\n      }\n    } else {\n      return await this.putHcPartyInCache(healthcarePartyId, super.getHealthcareParty(healthcarePartyId))\n    }\n  }\n\n  /**\n   * Retrieves the full hierarchy of healthcare party ids, from the topmost parent down to the given party.\n   * Recursively walks up the parentId chain.\n   * @param healthcarePartyId the id of the healthcare party whose hierarchy to retrieve.\n   * @param bypassCache if true, bypasses the cache for each party in the hierarchy.\n   * @return an array of healthcare party ids ordered from the topmost ancestor to the given party.\n   */\n  getHealthcarePartyHierarchyIds(healthcarePartyId: string, bypassCache = false): Promise<string[]> {\n    return this.getHealthcareParty(healthcarePartyId, bypassCache).then(async (hcp: HealthcareParty) => {\n      return hcp ? (hcp.parentId ? (await this.getHealthcarePartyHierarchyIds(hcp.parentId!, bypassCache)).concat([hcp.id!]) : [hcp.id!]) : []\n    })\n  }\n\n  /**\n   * Retrieves multiple healthcare parties by their ids. Uses the cache where possible, and fetches any missing\n   * parties from the server in a single bulk request. Parties not found on the server are filtered out.\n   * @param healthcarePartyIds the list of healthcare party ids to retrieve.\n   * @return an array of healthcare parties (excluding any that were not found).\n   */\n  async getHealthcareParties(healthcarePartyIds: ListOfIds): Promise<Array<HealthcareParty> | any> {\n    const ids = healthcarePartyIds.ids\n    if (!ids || !ids.length) {\n      return Promise.resolve([])\n    }\n    const cached: Array<[string, HealthcareParty | null]> = []\n    for (const id of ids) {\n      let hcp\n      try {\n        hcp = await this.getHcPartyFromCache(id)\n      } catch {\n        hcp = null\n        delete this.hcPartyCache[id]\n      }\n      cached.push([id, hcp])\n    }\n    const toFetch = cached.filter((x) => !x[1]).map((x) => x[0])\n\n    if (!toFetch.length) {\n      return Promise.all(cached.map((x) => x[1]!))\n    }\n\n    const prom: Promise<HealthcareParty[]> = super.getHealthcareParties(new ListOfIds({ ids: toFetch }))\n    return Promise.all(\n      cached.map(\n        (x) =>\n          x[1] ??\n          this.putHcPartyInCache(\n            x[0],\n            prom.then((hcps) => {\n              const hcp = hcps.find((h) => h.id === x[0])\n              if (!!hcp) {\n                return hcp\n              } else {\n                throw new Error(`Hcp with id ${x[0]} not found`)\n              }\n            })\n          ).catch((e) => {\n            if (e instanceof XHRError) {\n              throw e\n            }\n            return null\n          })\n      )\n    ).then((results) => results.filter((it) => it != null))\n  }\n\n  /**\n   * Retrieves the currently logged-in healthcare party and caches it.\n   * @return the current healthcare party.\n   */\n  getCurrentHealthcareParty(): Promise<HealthcareParty> {\n    return super.getCurrentHealthcareParty().then((hcp) => this.putHcPartyInCache(hcp.id!, Promise.resolve(hcp)))\n  }\n\n  /**\n   * Validates a Belgian CBE (Crossroads Bank for Enterprises) number using the modulo 97 check.\n   * @param cbe the CBE number to validate (non-digit characters are stripped).\n   * @return true if the CBE number is valid, false otherwise.\n   */\n  isValidCbe(cbe: string) {\n    cbe = cbe.replace(new RegExp('[^(0-9)]', 'g'), '')\n    cbe = cbe.length == 9 ? '0' + cbe : cbe\n\n    return 97 - (Number(cbe.substring(0, 8)) % 97) === Number(cbe.substring(8, 10))\n  }\n\n  /**\n   * Subscribes to real-time healthcare party events using a WebSocket connection.\n   * @param eventTypes the types of events to listen for (e.g. 'CREATE', 'UPDATE', 'DELETE').\n   * @param filter an optional filter to restrict which healthcare party events trigger the callback.\n   * @param eventFired the callback function invoked when a matching healthcare party event is received.\n   * @param options optional subscription configuration such as connection parameters and retry behaviour.\n   * @return a connection object that can be used to manage the WebSocket subscription lifecycle.\n   */\n  async subscribeToHealthcarePartyEvents(\n    eventTypes: ('CREATE' | 'UPDATE' | 'DELETE')[],\n    filter: AbstractFilter<HealthcareParty> | undefined,\n    eventFired: (dataSample: HealthcareParty) => Promise<void>,\n    options: SubscriptionOptions = {}\n  ): Promise<Connection> {\n    return subscribeToEntityEvents(this.host, this.authApi, 'HealthcareParty', eventTypes, filter, eventFired, options).then(\n      (rs) => new ConnectionImpl(rs)\n    )\n  }\n}\n"]}