@openmrs/esm-framework 10.0.1-pre.5542 → 10.0.1-pre.5561

package/.turbo/turbo-build.log

@@ -1,3 +1,3 @@
-[0] Successfully compiled: 3 files with swc (124.93ms)
+[0] Successfully compiled: 4 files with swc (120.94ms)
 [0] swc --strip-leading-paths src -d dist exited with code 0
 [1] tsc --project tsconfig.build.json exited with code 0

package/dist/deprecated.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Compatibility shims for APIs that have been removed from the framework.
+ *
+ * These exist only so that frontend modules built against an older framework
+ * don't break at runtime while their authors migrate. They are intentionally
+ * no-ops and will be removed in a future major release.
+ */
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call `setupOfflineSync`
+ * during registration don't throw. Remove your offline sync handlers; queued
+ * items will no longer be synchronized.
+ */
+export declare function setupOfflineSync<T = unknown>(_type: string, _dependsOn: Array<string>, _process: (item: T, options: unknown) => Promise<unknown>, _options?: unknown): void;
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `setupDynamicOfflineDataHandler` during registration don't throw. Remove your
+ * dynamic offline data handlers; their data will no longer be cached for offline use.
+ */
+export declare function setupDynamicOfflineDataHandler(_handler: {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}): void;
+/**
+ * @deprecated Offline support has been removed from the framework. This is a stub kept only so that
+ * frontend modules that still read the dynamic offline data registry keep working. It always resolves
+ * to an empty array, since nothing is registered for offline use any more.
+ */
+export declare function getDynamicOfflineDataEntries<T = unknown>(_type?: string): Promise<Array<T>>;
+/**
+ * @deprecated Offline support has been removed from the framework. This is a stub kept only so that
+ * frontend modules that still read the sync queue keep working. It always resolves to an empty array,
+ * since nothing is queued for synchronization any more.
+ */
+export declare function getSynchronizationItems<T = unknown>(_type?: string): Promise<Array<T>>;
+/**
+ * @deprecated The offline service worker has been removed from the framework.
+ * This is a no-op kept only so that frontend modules that still call
+ * `messageOmrsServiceWorker` don't throw. It always resolves to an
+ * unsuccessful result, mirroring the previous "no service worker registered"
+ * behavior.
+ */
+export declare function messageOmrsServiceWorker(_message: unknown): Promise<{
+    success: false;
+    result: undefined;
+    error: string;
+}>;
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `subscribePrecacheStaticDependencies` don't throw. The callback is never
+ * invoked. Returns a no-op unsubscribe function so existing teardown code keeps working.
+ */
+export declare function subscribePrecacheStaticDependencies(_callback: (data: unknown) => void): () => void;
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `useConnectivity` don't throw.
+ */
+export declare function useConnectivity(): boolean;
+//# sourceMappingURL=deprecated.d.ts.map

package/dist/deprecated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated.d.ts","sourceRoot":"","sources":["../src/deprecated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EACzD,QAAQ,CAAC,EAAE,OAAO,GACjB,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,IAAI,CAEnH;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAEtF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAM/D;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAGlG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,YAE9B"}

package/dist/deprecated.js

@@ -0,0 +1,65 @@
+/**
+ * Compatibility shims for APIs that have been removed from the framework.
+ *
+ * These exist only so that frontend modules built against an older framework
+ * don't break at runtime while their authors migrate. They are intentionally
+ * no-ops and will be removed in a future major release.
+ */ /**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call `setupOfflineSync`
+ * during registration don't throw. Remove your offline sync handlers; queued
+ * items will no longer be synchronized.
+ */ export function setupOfflineSync(_type, _dependsOn, _process, _options) {
+// no-op: offline synchronization was removed from the framework
+}
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `setupDynamicOfflineDataHandler` during registration don't throw. Remove your
+ * dynamic offline data handlers; their data will no longer be cached for offline use.
+ */ export function setupDynamicOfflineDataHandler(_handler) {
+// no-op: dynamic offline data was removed from the framework
+}
+/**
+ * @deprecated Offline support has been removed from the framework. This is a stub kept only so that
+ * frontend modules that still read the dynamic offline data registry keep working. It always resolves
+ * to an empty array, since nothing is registered for offline use any more.
+ */ export function getDynamicOfflineDataEntries(_type) {
+    return Promise.resolve([]);
+}
+/**
+ * @deprecated Offline support has been removed from the framework. This is a stub kept only so that
+ * frontend modules that still read the sync queue keep working. It always resolves to an empty array,
+ * since nothing is queued for synchronization any more.
+ */ export function getSynchronizationItems(_type) {
+    return Promise.resolve([]);
+}
+/**
+ * @deprecated The offline service worker has been removed from the framework.
+ * This is a no-op kept only so that frontend modules that still call
+ * `messageOmrsServiceWorker` don't throw. It always resolves to an
+ * unsuccessful result, mirroring the previous "no service worker registered"
+ * behavior.
+ */ export function messageOmrsServiceWorker(_message) {
+    return Promise.resolve({
+        success: false,
+        result: undefined,
+        error: 'No service worker has been registered. Offline-related features have been removed from the framework.'
+    });
+}
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `subscribePrecacheStaticDependencies` don't throw. The callback is never
+ * invoked. Returns a no-op unsubscribe function so existing teardown code keeps working.
+ */ export function subscribePrecacheStaticDependencies(_callback) {
+    // no-op: static dependency precaching was removed from the framework
+    return ()=>{};
+}
+/**
+ * @deprecated Offline support has been removed from the framework. This is a
+ * no-op kept only so that frontend modules that still call
+ * `useConnectivity` don't throw.
+ */ export function useConnectivity() {
+    return true;
+}

package/dist/index.d.ts

@@ -9,10 +9,10 @@ export * from '@openmrs/esm-extensions/src/public';
 export * from '@openmrs/esm-feature-flags/src/public';
 export * from '@openmrs/esm-globals/src/public';
 export * from '@openmrs/esm-navigation/src/public';
-export * from '@openmrs/esm-offline/src/public';
 export * from '@openmrs/esm-react-utils/src/public';
 export * from '@openmrs/esm-state/src/public';
 export * from '@openmrs/esm-styleguide/src/public';
 export * from '@openmrs/esm-translations/src/public';
 export * from '@openmrs/esm-utils';
+export * from './deprecated';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,oCAAoC,CAAC;AACnD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -9,9 +9,9 @@ export * from "@openmrs/esm-extensions/src/public";
 export * from "@openmrs/esm-feature-flags/src/public";
 export * from "@openmrs/esm-globals/src/public";
 export * from "@openmrs/esm-navigation/src/public";
-export * from "@openmrs/esm-offline/src/public";
 export * from "@openmrs/esm-react-utils/src/public";
 export * from "@openmrs/esm-state/src/public";
 export * from "@openmrs/esm-styleguide/src/public";
 export * from "@openmrs/esm-translations/src/public";
 export * from "@openmrs/esm-utils";
+export * from "./deprecated.js";

package/dist/internal.d.ts

@@ -8,11 +8,11 @@ export * from '@openmrs/esm-extensions';
 export * from '@openmrs/esm-feature-flags';
 export * from '@openmrs/esm-globals';
 export * from '@openmrs/esm-navigation';
-export * from '@openmrs/esm-offline';
 export * from '@openmrs/esm-react-utils';
 export * from '@openmrs/esm-routes';
 export * from '@openmrs/esm-state';
 export * from '@openmrs/esm-styleguide/src/internal';
 export * from '@openmrs/esm-translations';
 export * from '@openmrs/esm-utils';
+export * from './deprecated';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/internal.js

@@ -8,10 +8,10 @@ export * from "@openmrs/esm-extensions";
 export * from "@openmrs/esm-feature-flags";
 export * from "@openmrs/esm-globals";
 export * from "@openmrs/esm-navigation";
-export * from "@openmrs/esm-offline";
 export * from "@openmrs/esm-react-utils";
 export * from "@openmrs/esm-routes";
 export * from "@openmrs/esm-state";
 export * from "@openmrs/esm-styleguide/src/internal";
 export * from "@openmrs/esm-translations";
 export * from "@openmrs/esm-utils";
+export * from "./deprecated.js";

package/docs/API.md

@@ -4,7 +4,6 @@
 
 - [makeUrl](functions/makeUrl.md)
 - [openmrsFetch](functions/openmrsFetch.md)
-- [openmrsObservableFetch](functions/openmrsObservableFetch.md)
 - [OpenmrsFetchError](classes/OpenmrsFetchError.md)
 - [FetchConfig](interfaces/FetchConfig.md)
 - [FetchHeaders](interfaces/FetchHeaders.md)
@@ -98,52 +97,6 @@
 - [getHistory](functions/getHistory.md)
 - [goBackInHistory](functions/goBackInHistory.md)
 
-## Offline
-
-- [~~getOfflinePatientDataStore~~](functions/getOfflinePatientDataStore.md)
-- [~~registerOfflinePatientHandler~~](functions/registerOfflinePatientHandler.md)
-- [~~syncOfflinePatientData~~](functions/syncOfflinePatientData.md)
-- [~~OfflinePatientDataSyncStore~~](interfaces/OfflinePatientDataSyncStore.md)
-- [~~OfflinePatientDataSyncState~~](interfaces/OfflinePatientDataSyncState.md)
-- [~~OfflinePatientDataSyncHandler~~](interfaces/OfflinePatientDataSyncHandler.md)
-- [~~OfflinePatientArgs~~](interfaces/OfflinePatientArgs.md)
-- [messageOmrsServiceWorker](functions/messageOmrsServiceWorker.md)
-- [OmrsServiceWorkerMessage](interfaces/OmrsServiceWorkerMessage.md)
-- [OnImportMapChangedMessage](interfaces/OnImportMapChangedMessage.md)
-- [ClearDynamicRoutesMessage](interfaces/ClearDynamicRoutesMessage.md)
-- [RegisterDynamicRouteMessage](interfaces/RegisterDynamicRouteMessage.md)
-- [MessageServiceWorkerResult](interfaces/MessageServiceWorkerResult.md)
-- [generateOfflineUuid](functions/generateOfflineUuid.md)
-- [isOfflineUuid](functions/isOfflineUuid.md)
-- [getDynamicOfflineDataHandlers](functions/getDynamicOfflineDataHandlers.md)
-- [setupDynamicOfflineDataHandler](functions/setupDynamicOfflineDataHandler.md)
-- [getDynamicOfflineDataEntries](functions/getDynamicOfflineDataEntries.md)
-- [getDynamicOfflineDataEntriesFor](functions/getDynamicOfflineDataEntriesFor.md)
-- [putDynamicOfflineData](functions/putDynamicOfflineData.md)
-- [putDynamicOfflineDataFor](functions/putDynamicOfflineDataFor.md)
-- [removeDynamicOfflineData](functions/removeDynamicOfflineData.md)
-- [removeDynamicOfflineDataFor](functions/removeDynamicOfflineDataFor.md)
-- [syncAllDynamicOfflineData](functions/syncAllDynamicOfflineData.md)
-- [syncDynamicOfflineData](functions/syncDynamicOfflineData.md)
-- [DynamicOfflineDataHandler](interfaces/DynamicOfflineDataHandler.md)
-- [DynamicOfflineData](interfaces/DynamicOfflineData.md)
-- [DynamicOfflineDataSyncState](interfaces/DynamicOfflineDataSyncState.md)
-- [useConnectivity](functions/useConnectivity.md)
-- [OfflineModeResult](interfaces/OfflineModeResult.md)
-- [getCurrentOfflineMode](functions/getCurrentOfflineMode.md)
-- [QueueItemDescriptor](interfaces/QueueItemDescriptor.md)
-- [SyncItem](interfaces/SyncItem.md)
-- [SyncProcessOptions](interfaces/SyncProcessOptions.md)
-- [queueSynchronizationItem](functions/queueSynchronizationItem.md)
-- [getSynchronizationItem](functions/getSynchronizationItem.md)
-- [getSynchronizationItems](functions/getSynchronizationItems.md)
-- [getFullSynchronizationItems](functions/getFullSynchronizationItems.md)
-- [getFullSynchronizationItemsFor](functions/getFullSynchronizationItemsFor.md)
-- [canBeginEditSynchronizationItemsOfType](functions/canBeginEditSynchronizationItemsOfType.md)
-- [beginEditSynchronizationItem](functions/beginEditSynchronizationItem.md)
-- [deleteSynchronizationItem](functions/deleteSynchronizationItem.md)
-- [setupOfflineSync](functions/setupOfflineSync.md)
-
 ## Extension
 
 - [ExtensionSlot](functions/ExtensionSlot.md)

package/docs/classes/OpenmrsFetchError.md

@@ -2,7 +2,7 @@
 
 # Class: OpenmrsFetchError
 
-Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:320](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L320)
+Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:258](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L258)
 
 ## Extends
 
@@ -18,7 +18,7 @@ Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:320](https://github
 
 > **new OpenmrsFetchError**(`url`, `response`, `responseBody`, `requestStacktrace`): `OpenmrsFetchError`
 
-Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:321](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L321)
+Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:259](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L259)
 
 #### Parameters
 
@@ -88,7 +88,7 @@ Defined in: node\_modules/typescript/lib/lib.es5.d.ts:1076
 
 > **response**: `Response`
 
-Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:329](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L329)
+Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:267](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L267)
 
 #### Implementation of
 
@@ -100,7 +100,7 @@ Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:329](https://github
 
 > **responseBody**: `null` \| `string` \| [`FetchResponseJson`](../interfaces/FetchResponseJson.md)
 
-Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:330](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L330)
+Defined in: [packages/framework/esm-api/src/openmrs-fetch.ts:268](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/openmrs-fetch.ts#L268)
 
 #### Implementation of
 

package/docs/enumerations/VisitMode.md

@@ -2,7 +2,7 @@
 
 # Enumeration: VisitMode
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:14](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L14)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:13](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L13)
 
 ## Enumeration Members
 
@@ -10,7 +10,7 @@ Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:14](https://githu
 
 > **EDITVISIT**: `"editVisit"`
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:16](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L16)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:15](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L15)
 
 ***
 
@@ -18,7 +18,7 @@ Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:16](https://githu
 
 > **LOADING**: `"loadingVisit"`
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:17](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L17)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:16](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L16)
 
 ***
 
@@ -26,4 +26,4 @@ Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:17](https://githu
 
 > **NEWVISIT**: `"startVisit"`
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:15](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L15)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:14](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L14)

package/docs/enumerations/VisitStatus.md

@@ -2,7 +2,7 @@
 
 # Enumeration: VisitStatus
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:20](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L20)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:19](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L19)
 
 ## Enumeration Members
 
@@ -10,7 +10,7 @@ Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:20](https://githu
 
 > **NOTSTARTED**: `"notStarted"`
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:21](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L21)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:20](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L20)
 
 ***
 
@@ -18,4 +18,4 @@ Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:21](https://githu
 
 > **ONGOING**: `"ongoing"`
 
-Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:22](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L22)
+Defined in: [packages/framework/esm-emr-api/src/visit-utils.ts:21](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/visit-utils.ts#L21)

package/docs/functions/attach.md

@@ -4,7 +4,7 @@
 
 > **attach**(`slotName`, `extensionId`): `void`
 
-Defined in: [packages/framework/esm-extensions/src/extensions.ts:309](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L309)
+Defined in: [packages/framework/esm-extensions/src/extensions.ts:303](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L303)
 
 Attach an extension to an extension slot.
 

package/docs/functions/clearCurrentUser.md

@@ -4,7 +4,7 @@
 
 > **clearCurrentUser**(): `void`
 
-Defined in: [packages/framework/esm-api/src/current-user.ts:234](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L234)
+Defined in: [packages/framework/esm-api/src/current-user.ts:261](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L261)
 
 Clears the current user session from the session store, setting the session
 to an unauthenticated state. This is typically called during logout to reset

package/docs/functions/createErrorHandler.md

@@ -4,7 +4,7 @@
 
 > **createErrorHandler**(): (`incomingErr`) => `void`
 
-Defined in: [packages/framework/esm-error-handling/src/index.ts:70](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-error-handling/src/index.ts#L70)
+Defined in: [packages/framework/esm-error-handling/src/index.ts:94](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-error-handling/src/index.ts#L94)
 
 Creates an error handler function that captures the current stack trace at
 the time of creation. When the returned handler is invoked with an error,

package/docs/functions/detach.md

@@ -4,7 +4,7 @@
 
 > **detach**(`extensionSlotName`, `extensionId`): `void`
 
-Defined in: [packages/framework/esm-extensions/src/extensions.ts:347](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L347)
+Defined in: [packages/framework/esm-extensions/src/extensions.ts:341](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L341)
 
 Detaches an extension from an extension slot.
 

package/docs/functions/detachAll.md

@@ -4,7 +4,7 @@
 
 > **detachAll**(`extensionSlotName`): `void`
 
-Defined in: [packages/framework/esm-extensions/src/extensions.ts:375](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L375)
+Defined in: [packages/framework/esm-extensions/src/extensions.ts:369](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L369)
 
 Detaches all extensions from an extension slot.
 

package/docs/functions/fetchCurrentPatient.md

@@ -2,14 +2,11 @@
 
 # Function: fetchCurrentPatient()
 
-> **fetchCurrentPatient**(`patientUuid`, `fetchInit?`, `includeOfflinePatients?`): `Promise`\<`null` \| `Patient`\>
+> **fetchCurrentPatient**(`patientUuid`, `fetchInit?`): `Promise`\<`null` \| `Patient`\>
 
-Defined in: [packages/framework/esm-emr-api/src/current-patient.ts:44](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/current-patient.ts#L44)
+Defined in: [packages/framework/esm-emr-api/src/current-patient.ts:38](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-emr-api/src/current-patient.ts#L38)
 
-Fetches a patient by their UUID from the FHIR API. This function first attempts
-to fetch the patient from the server. If the server request fails and offline
-patients are included, it will check for a matching patient in the offline
-patient registration sync queue.
+Fetches a patient by their UUID from the FHIR API.
 
 ## Parameters
 
@@ -25,23 +22,16 @@ The UUID of the patient to fetch, or `null`.
 
 Optional fetch configuration options to pass to the request.
 
-### includeOfflinePatients?
-
-`boolean` = `true`
-
-Whether to include patients from the offline
-  registration queue if the server request fails. Defaults to `true`.
-
 ## Returns
 
 `Promise`\<`null` \| `Patient`\>
 
 A Promise that resolves with the FHIR Patient object, or `null` if
-  the patient UUID is null or the patient is not found.
+  the patient UUID is null.
 
 ## Throws
 
-Rethrows any error from the server request if no offline patient is found.
+Rethrows any error from the server request.
 
 ## Example
 

package/docs/functions/getAssignedExtensions.md

@@ -4,7 +4,7 @@
 
 > **getAssignedExtensions**(`slotName`, `state?`): [`AssignedExtension`](../interfaces/AssignedExtension.md)[]
 
-Defined in: [packages/framework/esm-extensions/src/extensions.ts:554](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L554)
+Defined in: [packages/framework/esm-extensions/src/extensions.ts:541](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-extensions/src/extensions.ts#L541)
 
 Gets the extensions a given rendering of a slot should display, in order. This is the supported
 way to ask what belongs in a slot; reading the extension store directly skips display conditions.

package/docs/functions/getCoreTranslation.md

@@ -19,7 +19,7 @@ invalid key to this function will result in a type error.
 
 The translation key from the set of core translations.
 
-`"cancel"` | `"change"` | `"close"` | `"error"` | `"unknown"` | `"state"` | `"Clinic"` | `"abnormalValue"` | `"actions"` | `"actionableNotification"` | `"address"` | `"age"` | `"batchActionItemSelected"` | `"batchActionsItemsSelected"` | `"closesActionableNotification"` | `"closeSnackbar"` | `"confirm"` | `"contactAdministratorIfIssuePersists"` | `"contactDetails"` | `"delete"` | `"discardChanges"` | `"edit"` | `"emptyStateText"` | `"errorCopy"` | `"errorLoadingLoginLocations"` | `"female"` | `"leftNavigation"` | `"loading"` | `"localVersion"` | `"male"` | `"navigateNonHttp"` | `"noResultsToDisplay"` | `"notAvailable"` | `"other"` | `"paginationItemsCount"` | `"paginationOfPages"` | `"patientAvatarAlt"` | `"patientIdentifierSticker"` | `"patientLists"` | `"patientPhotoAlt"` | `"patientPhotoPlaceholder"` | `"prereleaseVersion"` | `"print"` | `"printError"` | `"printErrorExplainer"` | `"printIdentifierSticker"` | `"printing"` | `"recordNewEntry"` | `"relationships"` | `"resetOverrides"` | `"save"` | `"scriptLoadingFailed"` | `"scriptLoadingError"` | `"searchForLocation"` | `"seeAll"` | `"seeMoreLists"` | `"selectAll"` | `"sex"` | `"showLess"` | `"showMore"` | `"snackbarNotification"` | `"toggleDevTools"` | `"yearAbbreviation"` | `"yearsAbbreviation"` | `"discardUnsavedChangesPromptBodyMultiple"` | `"discardUnsavedChangesPromptBodySingle"` | `"discardUnsavedChangesPromptTitle"` | `"keepEditing"` | `"closeAllOpenedWorkspaces"` | `"closingAllWorkspacesPromptBody"` | `"closingAllWorkspacesPromptTitle"` | `"discard"` | `"hide"` | `"maximize"` | `"minimize"` | `"openAnyway"` | `"unsavedChangesInOpenedWorkspace"` | `"unsavedChangesInWorkspace"` | `"unsavedChangesTitleText"` | `"workspaceHeader"` | `"address1"` | `"address2"` | `"address3"` | `"address4"` | `"address5"` | `"address6"` | `"city"` | `"cityVillage"` | `"country"` | `"countyDistrict"` | `"district"` | `"postalCode"` | `"stateProvince"`
+`"error"` | `"cancel"` | `"change"` | `"close"` | `"unknown"` | `"state"` | `"Clinic"` | `"abnormalValue"` | `"actions"` | `"actionableNotification"` | `"address"` | `"age"` | `"batchActionItemSelected"` | `"batchActionsItemsSelected"` | `"closesActionableNotification"` | `"closeSnackbar"` | `"confirm"` | `"contactAdministratorIfIssuePersists"` | `"contactDetails"` | `"delete"` | `"discardChanges"` | `"edit"` | `"emptyStateText"` | `"errorCopy"` | `"errorLoadingLoginLocations"` | `"female"` | `"leftNavigation"` | `"loading"` | `"localVersion"` | `"male"` | `"navigateNonHttp"` | `"noResultsToDisplay"` | `"notAvailable"` | `"other"` | `"paginationItemsCount"` | `"paginationOfPages"` | `"patientAvatarAlt"` | `"patientIdentifierSticker"` | `"patientLists"` | `"patientPhotoAlt"` | `"patientPhotoPlaceholder"` | `"prereleaseVersion"` | `"print"` | `"printError"` | `"printErrorExplainer"` | `"printIdentifierSticker"` | `"printing"` | `"recordNewEntry"` | `"relationships"` | `"resetOverrides"` | `"save"` | `"scriptLoadingFailed"` | `"scriptLoadingError"` | `"searchForLocation"` | `"seeAll"` | `"seeMoreLists"` | `"selectAll"` | `"sex"` | `"showLess"` | `"showMore"` | `"snackbarNotification"` | `"toggleDevTools"` | `"yearAbbreviation"` | `"yearsAbbreviation"` | `"discardUnsavedChangesPromptBodyMultiple"` | `"discardUnsavedChangesPromptBodySingle"` | `"discardUnsavedChangesPromptTitle"` | `"keepEditing"` | `"closeAllOpenedWorkspaces"` | `"closingAllWorkspacesPromptBody"` | `"closingAllWorkspacesPromptTitle"` | `"discard"` | `"hide"` | `"maximize"` | `"minimize"` | `"openAnyway"` | `"unsavedChangesInOpenedWorkspace"` | `"unsavedChangesInWorkspace"` | `"unsavedChangesTitleText"` | `"workspaceHeader"` | `"address1"` | `"address2"` | `"address3"` | `"address4"` | `"address5"` | `"address6"` | `"city"` | `"cityVillage"` | `"country"` | `"countyDistrict"` | `"district"` | `"postalCode"` | `"stateProvince"`
 
 ### defaultText?
 

package/docs/functions/getCurrentUser.md

@@ -4,56 +4,46 @@
 
 ## Call Signature
 
-> **getCurrentUser**(): `Observable`\<[`Session`](../interfaces/Session.md)\>
+> **getCurrentUser**(): `Promise`\<[`Session`](../interfaces/Session.md)\>
 
-Defined in: [packages/framework/esm-api/src/current-user.ts:66](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L66)
+Defined in: [packages/framework/esm-api/src/current-user.ts:88](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L88)
 
-The getCurrentUser function returns an observable that produces
-**zero or more values, over time**. It will produce zero values
-by default if the user is not logged in. And it will provide a
-first value when the logged in user is fetched from the server.
-Subsequent values will be produced whenever the user object is
-updated.
+The getCurrentUser function returns a Promise that resolves once with the
+current user's session. If the session hasn't been loaded, was loaded more than
+a minute ago, or is in the middle of being refetched, the Promise waits for the
+fetch in question rather than resolving with data that may be out of date. The
+session it resolves with is therefore never more than a minute old.
 
-The function accepts an optional `opts` object with an `includeAuthStatus`
-boolean property that defaults to `true`. When `includeAuthStatus` is `true`,
-the entire [Session](../interfaces/Session.md) object from the API will be provided. When
-`includeAuthStatus` is `false`, only the [LoggedInUser](../interfaces/LoggedInUser.md) property of the
-response object will be provided.
+The function accepts an optional `opts` object with an `includeAuthStatus` boolean
+property that defaults to `true`. When `true`, the entire [Session](../interfaces/Session.md) object
+from the API is provided. When `false`, only the [LoggedInUser](../interfaces/LoggedInUser.md) property of
+the response is provided.
+
+To react to subsequent session changes (login, logout, user-property updates),
+use [getSessionStore](getSessionStore.md) (`getState()` / `subscribe()`) or the `useSession`
+React hook rather than calling this repeatedly.
 
 ### Returns
 
-`Observable`\<[`Session`](../interfaces/Session.md)\>
+`Promise`\<[`Session`](../interfaces/Session.md)\>
 
-An Observable that produces zero or more values (as described above).
-  The values produced will be a [LoggedInUser](../interfaces/LoggedInUser.md) object (if `includeAuthStatus`
-  is set to `false`) or a [Session](../interfaces/Session.md) object with authentication status
-  (if `includeAuthStatus` is set to `true` or not provided).
+A Promise resolving to a [LoggedInUser](../interfaces/LoggedInUser.md) object (if `includeAuthStatus`
+  is `false`) or a [Session](../interfaces/Session.md) object (if `includeAuthStatus` is `true` or not
+  provided).
 
 ### Example
 
 ```js
 import { getCurrentUser } from '@openmrs/esm-api'
-const subscription = getCurrentUser().subscribe(
-  user => console.log(user)
-)
-subscription.unsubscribe()
-getCurrentUser({includeAuthStatus: true}).subscribe(
-  data => console.log(data.authenticated)
-)
+const session = await getCurrentUser({ includeAuthStatus: true })
+console.log(session.authenticated)
 ```
 
-#### Be sure to unsubscribe when your component unmounts
-
-Otherwise your code will continue getting updates to the user object
-even after the UI component is gone from the screen. This is a memory
-leak and source of bugs.
-
 ## Call Signature
 
-> **getCurrentUser**(`opts`): `Observable`\<[`Session`](../interfaces/Session.md)\>
+> **getCurrentUser**(`opts`): `Promise`\<[`Session`](../interfaces/Session.md)\>
 
-Defined in: [packages/framework/esm-api/src/current-user.ts:73](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L73)
+Defined in: [packages/framework/esm-api/src/current-user.ts:95](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L95)
 
 ### Parameters
 
@@ -65,20 +55,20 @@ Options for controlling the response format.
 
 `true`
 
-When `true`, returns the full [Session](../interfaces/Session.md) object
+When `true`, resolves with the full [Session](../interfaces/Session.md) object
   including authentication status.
 
 ### Returns
 
-`Observable`\<[`Session`](../interfaces/Session.md)\>
+`Promise`\<[`Session`](../interfaces/Session.md)\>
 
-An Observable that produces [Session](../interfaces/Session.md) objects.
+A Promise resolving to a [Session](../interfaces/Session.md) object.
 
 ## Call Signature
 
-> **getCurrentUser**(`opts`): `Observable`\<[`LoggedInUser`](../interfaces/LoggedInUser.md)\>
+> **getCurrentUser**(`opts`): `Promise`\<[`LoggedInUser`](../interfaces/LoggedInUser.md)\>
 
-Defined in: [packages/framework/esm-api/src/current-user.ts:80](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L80)
+Defined in: [packages/framework/esm-api/src/current-user.ts:102](https://github.com/openmrs/openmrs-esm-core/blob/main/packages/framework/esm-api/src/current-user.ts#L102)
 
 ### Parameters
 
@@ -90,11 +80,11 @@ Options for controlling the response format.
 
 `false`
 
-When `false`, returns only the [LoggedInUser](../interfaces/LoggedInUser.md) object
+When `false`, resolves with only the [LoggedInUser](../interfaces/LoggedInUser.md) object
   without the surrounding session information.
 
 ### Returns
 
-`Observable`\<[`LoggedInUser`](../interfaces/LoggedInUser.md)\>
+`Promise`\<[`LoggedInUser`](../interfaces/LoggedInUser.md)\>
 
-An Observable that produces [LoggedInUser](../interfaces/LoggedInUser.md) objects.
+A Promise resolving to a [LoggedInUser](../interfaces/LoggedInUser.md) object.