@evoke-platform/context 1.0.0-dev.99 → 1.0.1-dev.0

package/README.md

@@ -17,7 +17,8 @@ available and no further installation is necessary.
 
 -   [Working With Objects](#working-with-objects)
 -   [REST API Calls](#rest-api-calls)
--   [SignalR Connection](#signalr-connection)
+-   [Authentication Context](#authentication-context)
+-   [Notifications](#notifications)
 
 ### Working With Objects
 
@@ -160,7 +161,16 @@ Returns a function that can be used to navigate to another page. The returned fu
 
 #### `useApp()`
 
-Returns the currently loaded Evoke app.
+Returns the currently loaded Evoke App as well as the following function.
+
+-   `findDefaultPageSlugFor`: An asynchronous function that takes an `objectId` as a parameter and returns the default page slug for that object, if no default page slug is found and the object is a subtype, the page slug of the first ancestor with a default page will be used. It returns `undefined` if no default page slug is found for any ancestor type.
+
+Example usage:
+
+```javascript
+const { id: appId, findDefaultPageSlugFor } = useApp();
+const defaultPageSlug = await findDefaultPageSlugFor(objectId);
+```
 
 ### REST API calls
 
@@ -197,26 +207,46 @@ absolute URL.
 
 ##### `delete(url, options)`
 
-### SignalR Connection
+### Authentication Context
+
+-   [useAuthenticationContext](#useauthenticationcontext)
+
+#### `useAuthenticationContext()`
+
+Hook to obtain the authentication context based on the current logged-in user.
 
-Deprecated
+The authentication context includes the following property and functions.
 
--   [useSignalRConnection](#usesignalrconnection)
+-   `account` _[object]_
+    -   The account of the currently logged-in user. This includes both the user's `id` and `name`.
+-   `logout()`
+    -   A function that logs out the currently logged-in user. The user will be redirected to Evoke's logout page upon logout.
+-   `getAccessToken()`
+    -   A function that returns an access token that is associated to the currently logged-in user. This token can be used to make API calls to Evoke's APIs to authenticate the API call.
+    -   Note: As a general recommendation, the [ApiService](#class-apiservices) class should be used to make API calls as it will take care
+        of appending an access token to the call.
+
+### Notifications
+
+-   [useNofitication](#usenotification)
     -   [documentChanges](#documentchangessubscribeobjectidinstanceid-data-documentchange)
     -   [instanceChanges](#instancechangessubscribeobjectid-instanceids-instancechange)
+-   [useSignalRConnection](#usesignalrconnection) (_Deprecated_)
+    -   [documentChanges](#documentchangessubscribeobjectidinstanceid-data-documentchange) (_Deprecated_)
+    -   [instanceChanges](#instancechangessubscribeobjectid-instanceids-instancechange) (_Deprecated_)
 
-#### `useSignalRConnection()`
+#### `useNofitication()`
 
-Hook used to obtain an instanceChanges instance of `SignalRConnection` and a documentChanges instance of `SignalRConnection`.
+Hook used to obtain an instanceChanges instance and a documentChanges instance.
 
-##### `documentChanges.subscribe('{objectId}/{instanceId}', (data: DocumentChange[]]) => {})`
+##### `documentChanges.subscribe(objectId, instanceId, (data: DocumentChange[]]) => {})`
 
-Subscribe to the specified object instance document changes.
+Subscribe to the specified object instance changes.
 
 ```javascript
-const { documentChanges } = useSignalRConnection();
+const { documentChanges } = useNotification();
 
-documentChanges.subscribe('myObjectId/myInstanceId', (data) => {
+documentChanges.subscribe('myObjectId', 'myInstanceId', (data) => {
     console.log(data);
 });
 ```
@@ -233,53 +263,61 @@ following data:
 -   `type`
     -   The type of update. Possible values are `BlobCreated`, `BlobDeleted`, and `BlobMetadataUpdated`.
 
-##### `documentChanges.unsubscribe('{objectId}/{instanceId}', (data: DocumentChange[]) => {})`
+##### `documentChanges.unsubscribe(objectId, instanceId, (changes: DocumentChange[]) => {})`
 
-Unsubscribe to the specified object instance document changes.
+Unsubscribe to the specified object instance changes.
 
 Callback function is optional.
+If callback function is not defined, all subscriptions will be removed.
 If callback function is defined, you must pass the exact same Function instance as was previously passed to `documentChanges.subscribe`.
 Passing a different instance (even if the function body is the same) will not remove the subscription.
 
 ```javascript
-const { documentChanges } = useSignalRConnection();
+const { documentChanges } = useNotification();
 
-const callback = (data: DocumentChange[]) => {
-    console.log(data);
+const callback = (changes: DocumentChange[]) => {
+    console.log(changes);
 };
 
-documentChanges.subscribe('myObjectId/myInstanceId', callback);
+documentChanges.subscribe('myObjectId', 'myInstanceId', callback);
 
-documentChanges.unsubscribe('myObjectId/myInstanceId', callback);
+documentChanges.unsubscribe('myObjectId', 'myInstanceId', callback);
 ```
 
-##### `instanceChanges.subscribe('{objectId}', (instanceIds: InstanceChange[]) => {})`
+##### `instanceChanges.subscribe(objectId, (changes: InstanceChange[]) => {})`
 
-Subscribe to the specified object instance changes.
+Subscribe to the specified object changes.
 
 ```javascript
-const { instanceChanges } = useSignalRConnection();
+const { instanceChanges } = useNotification();
 
-instanceChanges.subscribe('myObjectId', (instanceIds) => {
-    console.log(instanceIds);
+instanceChanges.subscribe('myObjectId', (changes) => {
+    console.log(changes);
 });
 ```
 
-The data provided to the callback will be an array of instance IDs that were updated.
+The data provided to the callback will be an array of `InstanceChange` which contains the
+following data:
 
-##### `instanceChanges.unsubscribe('{objectId}', (instanceIds: InstanceChange[]) => {})`
+-   `objectId`
+    -   Object describing the instance associated with the updated document.
+-   `instanceId`
+    -   Instance that the updated document is associated with.
 
-Unsubscribe to the specified object instance changes.
+##### `instanceChanges.unsubscribe(objectId, (changes: InstanceChange[]) => {})`
+
+Unsubscribe to the specified object changes.
 
 Callback function is optional.
+If callback function is not defined, all subscriptions will be removed.
 If callback function is defined, you must pass the exact same Function instance as was previously passed to `instanceChanges.subscribe`.
 Passing a different instance (even if the function body is the same) will not remove the subscription.
 
 ```javascript
-const { instanceChanges } = useSignalRConnection();
+const { instanceChanges } = useNotification();
 
-const callback = (instanceIds: InstanceChange[]) => {
-    console.log(instanceIds);
+const callback = (changes: InstanceChange[]) => {
+    console.log(changes);
 };
 
 instanceChanges.subscribe('myObjectId', callback);
@@ -287,24 +325,24 @@ instanceChanges.subscribe('myObjectId', callback);
 instanceChanges.unsubscribe('myObjectId', callback);
 ```
 
-### Notification
+#### `useSignalRConnection()`
 
--   [useNofitication](#usenotification)
-    -   [documentChanges](#documentchangessubscribeobjectidinstanceid-data-documentchange)
-    -   [instanceChanges](#instancechangessubscribeobjectid-instanceids-instancechange)
+> **Deprecated**
+> This has been deprecated in favor of [useNotification](#usenofitication).
 
-#### `useNofitication()`
+Hook used to obtain an instanceChanges instance of `SignalRConnection` and a documentChanges instance of `SignalRConnection`.
 
-Hook used to obtain an instanceChanges instance and a documentChanges instance.
+##### `documentChanges.subscribe('{objectId}/{instanceId}', (data: DocumentChange[]]) => {})`
 
-##### `documentChanges.subscribe(objectId, instanceId, (data: DocumentChange[]]) => {})`
+> **Deprecated**
+> This has been deprecated in favor of [useNotification](#usenofitication).
 
-Subscribe to the specified object instance changes.
+Subscribe to the specified object instance document changes.
 
 ```javascript
-const { documentChanges } = useNotification();
+const { documentChanges } = useSignalRConnection();
 
-documentChanges.subscribe('myObjectId', 'myInstanceId', (data) => {
+documentChanges.subscribe('myObjectId/myInstanceId', (data) => {
     console.log(data);
 });
 ```
@@ -321,61 +359,62 @@ following data:
 -   `type`
     -   The type of update. Possible values are `BlobCreated`, `BlobDeleted`, and `BlobMetadataUpdated`.
 
-##### `documentChanges.unsubscribe(objectId, instanceId, (changes: DocumentChange[]) => {})`
+##### `documentChanges.unsubscribe('{objectId}/{instanceId}', (data: DocumentChange[]) => {})`
 
-Unsubscribe to the specified object instance changes.
+> **Deprecated**
+> This has been deprecated in favor of [useNotification](#usenofitication).
+
+Unsubscribe to the specified object instance document changes.
 
 Callback function is optional.
-If callback function is not defined, all subscriptions will be removed.
 If callback function is defined, you must pass the exact same Function instance as was previously passed to `documentChanges.subscribe`.
 Passing a different instance (even if the function body is the same) will not remove the subscription.
 
 ```javascript
-const { documentChanges } = useNotification();
+const { documentChanges } = useSignalRConnection();
 
-const callback = (changes: DocumentChange[]) => {
-    console.log(changes);
+const callback = (data: DocumentChange[]) => {
+    console.log(data);
 };
 
-documentChanges.subscribe('myObjectId', 'myInstanceId', callback);
+documentChanges.subscribe('myObjectId/myInstanceId', callback);
 
-documentChanges.unsubscribe('myObjectId', 'myInstanceId', callback);
+documentChanges.unsubscribe('myObjectId/myInstanceId', callback);
 ```
 
-##### `instanceChanges.subscribe(objectId, (changes: InstanceChange[]) => {})`
+##### `instanceChanges.subscribe('{objectId}', (instanceIds: InstanceChange[]) => {})`
 
-Subscribe to the specified object changes.
+> **Deprecated**
+> This has been deprecated in favor of [useNotification](#usenofitication).
+
+Subscribe to the specified object instance changes.
 
 ```javascript
-const { instanceChanges } = useNotification();
+const { instanceChanges } = useSignalRConnection();
 
-instanceChanges.subscribe('myObjectId', (changes) => {
-    console.log(changes);
+instanceChanges.subscribe('myObjectId', (instanceIds) => {
+    console.log(instanceIds);
 });
 ```
 
-The data provided to the callback will be an array of `InstanceChange` which contains the
-following data:
+The data provided to the callback will be an array of instance IDs that were updated.
 
--   `objectId`
-    -   Object describing the instance associated with the updated document.
--   `instanceId`
-    -   Instance that the updated document is associated with.
+##### `instanceChanges.unsubscribe('{objectId}', (instanceIds: InstanceChange[]) => {})`
 
-##### `instanceChanges.unsubscribe(objectId, (changes: InstanceChange[]) => {})`
+> **Deprecated**
+> This has been deprecated in favor of [useNotification](#usenofitication).
 
-Unsubscribe to the specified object changes.
+Unsubscribe to the specified object instance changes.
 
 Callback function is optional.
-If callback function is not defined, all subscriptions will be removed.
 If callback function is defined, you must pass the exact same Function instance as was previously passed to `instanceChanges.subscribe`.
 Passing a different instance (even if the function body is the same) will not remove the subscription.
 
 ```javascript
-const { instanceChanges } = useNotification();
+const { instanceChanges } = useSignalRConnection();
 
-const callback = (changes: InstanceChange[]) => {
-    console.log(changes);
+const callback = (instanceIds: InstanceChange[]) => {
+    console.log(instanceIds);
 };
 
 instanceChanges.subscribe('myObjectId', callback);

package/dist/api/apiServices.js

@@ -11,9 +11,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import axios from 'axios';
 import { useMemo } from 'react';
+import { v4 as uuidv4 } from 'uuid';
 import { useAuthenticationContext } from '../authentication/AuthenticationContextProvider.js';
 import { useApiBaseUrl } from './ApiBaseUrlProvider.js';
-import { v4 as uuidv4 } from 'uuid';
+import { paramsSerializer } from './paramsSerializer.js';
 const sessionId = uuidv4();
 export class ApiServices {
     constructor(api, authContext) {
@@ -143,6 +144,6 @@ export class ApiServices {
 export function useApiServices() {
     const authContext = useAuthenticationContext();
     const baseURL = useApiBaseUrl();
-    const apiServices = useMemo(() => new ApiServices(axios.create({ baseURL }), authContext), [authContext, baseURL]);
+    const apiServices = useMemo(() => new ApiServices(axios.create({ baseURL, paramsSerializer }), authContext), [authContext, baseURL]);
     return apiServices;
 }

package/dist/api/paramsSerializer.d.ts

@@ -0,0 +1,2 @@
+import { ParamsSerializerOptions } from 'axios';
+export declare function paramsSerializer(params: Record<string, unknown>, options?: ParamsSerializerOptions): string;

package/dist/api/paramsSerializer.js

@@ -0,0 +1,16 @@
+export function paramsSerializer(params, options) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (!validateParamKey(key) || !validateParamValue(value)) {
+            continue;
+        }
+        searchParams.append(key, typeof value !== 'string' ? JSON.stringify(value) : value);
+    }
+    return searchParams.toString();
+}
+function validateParamKey(item) {
+    return item.length;
+}
+function validateParamValue(item) {
+    return item !== undefined;
+}

package/dist/app/AppProvider.d.ts

@@ -38,10 +38,19 @@ export type NavigationItem = {
     pageId: string;
     pageName: string;
 };
+export type AppExtended = App & {
+    /**
+     * Looks up the default page slug for a given object or its nearest type ancestor.
+     *
+     * @param {string} objectId - The ID of the object to start the search from.
+     * @returns {Promise<string | undefined>} The default page slug, or `undefined` if no default page is found.
+     */
+    findDefaultPageSlugFor: (objectId: string) => Promise<string | undefined>;
+};
 export type AppProviderProps = {
     app: App;
     children?: ReactNode;
 };
 declare function AppProvider(props: AppProviderProps): import("react/jsx-runtime").JSX.Element;
-export declare function useApp(): App;
+export declare function useApp(): AppExtended;
 export default AppProvider;

package/dist/app/AppProvider.js

@@ -1,13 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { jsx as _jsx } from "react/jsx-runtime";
-// Copyright (c) 2023 System Automation Corporation.
-// This file is licensed under the MIT License.
-import { createContext, useContext } from 'react';
-const defaultApp = { id: '_evoke', name: 'Evoke Platform', type: 'public' };
-const AppContext = createContext(defaultApp);
+import { createContext, useCallback, useContext } from 'react';
+import { useApiServices } from '../api/index.js';
+const defaultApp = {
+    id: '_evoke',
+    name: 'Evoke Platform',
+    type: 'public',
+};
+const defaultAppExtended = Object.assign(Object.assign({}, defaultApp), { findDefaultPageSlugFor: (objectId) => Promise.resolve(undefined) });
+const AppContext = createContext(defaultAppExtended);
 AppContext.displayName = 'AppContext';
 function AppProvider(props) {
     const { app, children } = props;
-    return _jsx(AppContext.Provider, { value: app, children: children });
+    const apiServices = useApiServices();
+    const appExtended = Object.assign(Object.assign({}, app), { findDefaultPageSlugFor: useCallback((objectId) => __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            let defaultPageId;
+            let currentObjectId = objectId;
+            while (currentObjectId !== undefined) {
+                if ((_a = app.defaultPages) === null || _a === void 0 ? void 0 : _a[currentObjectId]) {
+                    defaultPageId = app.defaultPages[currentObjectId];
+                    break;
+                }
+                const effectiveObject = yield apiServices.get(`data/objects/${currentObjectId}/effective`, {
+                    params: { filter: { fields: ['baseObject'] } },
+                });
+                currentObjectId = (_c = (_b = effectiveObject === null || effectiveObject === void 0 ? void 0 : effectiveObject.baseObject) === null || _b === void 0 ? void 0 : _b.objectId) !== null && _c !== void 0 ? _c : undefined;
+            }
+            let defaultPage;
+            if (defaultPageId) {
+                const pageId = defaultPageId.includes('/')
+                    ? defaultPageId.split('/').slice(2).join('/')
+                    : defaultPageId;
+                try {
+                    defaultPage = yield apiServices.get(`/webContent/apps/${app.id}/pages/${encodeURIComponent(encodeURIComponent(pageId))}`);
+                }
+                catch (error) {
+                    const err = error;
+                    if (((_d = err.response) === null || _d === void 0 ? void 0 : _d.status) === 404) {
+                        defaultPage = undefined;
+                    }
+                }
+            }
+            if (defaultPage === null || defaultPage === void 0 ? void 0 : defaultPage.slug) {
+                return `/${app.id}/${defaultPage.slug}`;
+            }
+        }), [app]) });
+    return _jsx(AppContext.Provider, { value: appExtended, children: children });
 }
 export function useApp() {
     return useContext(AppContext);

package/dist/authentication/AuthenticationContextProvider.js

@@ -31,7 +31,10 @@ function AuthenticationContextProvider(props) {
         ? {
             account: { id: account.localAccountId, name: account.name },
             logout: () => {
-                msal.instance.logoutRedirect({ account });
+                msal.instance.logoutRedirect({
+                    account,
+                    postLogoutRedirectUri: `/logout?p=${encodeURIComponent(window.location.pathname + window.location.search)}`,
+                });
             },
             getAccessToken,
         }

package/dist/notification/NotificationProvider.js

@@ -8,7 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { jsx as _jsx } from "react/jsx-runtime";
-import { HubConnectionBuilder, LogLevel, } from '@microsoft/signalr/dist/esm/index.js';
+import { HubConnectionBuilder, LogLevel, } from '@microsoft/signalr';
 import { createContext, useContext, useEffect, useState } from 'react';
 import { useApiServices } from '../api/index.js';
 export const NotificationContext = createContext({});

package/dist/objects/objects.d.ts

@@ -4,12 +4,28 @@ export type BaseObjReference = {
     objectId: string;
     discriminatorValue: unknown;
 };
+export type ViewLayoutEntityReference = {
+    id: string;
+    objectId: string;
+};
+type ViewLayoutEntity = {
+    id: string;
+    name: string;
+    objectId: string;
+};
+export type TableViewLayoutEntity = ViewLayoutEntity & TableViewLayout;
+export type DropdownViewLayoutEntity = ViewLayoutEntity & DropdownViewLayout;
 export type ViewLayout = {
     table?: TableViewLayout;
     dropdown?: DropdownViewLayout;
 };
+export type DropdownViewLayoutSort = {
+    propertyId: string;
+    direction?: 'asc' | 'desc';
+};
 export type DropdownViewLayout = {
     secondaryTextExpression: string;
+    sort?: DropdownViewLayoutSort;
 };
 export type TableViewLayout = {
     properties: PropertyReference[];
@@ -35,7 +51,7 @@ export type Obj = {
 export type ObjWithRoot = Obj & {
     rootObjectId: string;
 };
-export type PropertyType = 'address' | 'array' | 'boolean' | 'collection' | 'date' | 'date-time' | 'image' | 'integer' | 'number' | 'object' | 'richText' | 'string' | 'time' | 'user';
+export type PropertyType = 'address' | 'array' | 'boolean' | 'collection' | 'criteria' | 'date' | 'date-time' | 'document' | 'image' | 'integer' | 'number' | 'object' | 'richText' | 'string' | 'time' | 'user';
 export type NumericValidation = {
     errorMessage?: string;
     minimum?: number;
@@ -51,12 +67,14 @@ export type CriteriaValidation = {
 };
 export type StringValidation = {
     operator: 'any' | 'all';
-    rules?: {
-        regex: string;
-        errorMessage?: string;
-    }[];
+    rules?: RegexValidation[];
+};
+export type DocumentValidation = {
+    errorMessage?: string;
+    maxDocuments?: number;
+    minDocuments?: number;
 };
-export type PropertyValidation = StringValidation | NumericValidation | DateValidation | CriteriaValidation;
+export type PropertyValidation = StringValidation | NumericValidation | DateValidation | CriteriaValidation | DocumentValidation;
 export type Property = {
     id: string;
     name: string;
@@ -109,7 +127,7 @@ export type ObjectInstance = {
 };
 export type RegexValidation = {
     regex: string;
-    errorMessage: string;
+    errorMessage?: string;
 };
 export type SelectOption = {
     label: string;
@@ -144,12 +162,18 @@ export type DisplayConfiguration = {
     mode?: 'default' | 'existingOnly';
     relatedObjectDisplay?: 'dropdown' | 'dialogBox';
     visibility?: VisibilityConfiguration | string;
+    viewLayout?: ViewLayoutEntityReference;
+    choicesDisplay?: {
+        type: 'dropdown' | 'radioButton';
+        sortBy?: 'ASC' | 'DESC' | 'NONE';
+    };
 };
 export type InputParameterReference = {
     type: 'input';
     parameterId: string;
     display?: DisplayConfiguration;
     enumWithLabels?: SelectOption[];
+    documentMetadata?: Record<string, string>;
 };
 export type Content = {
     type: 'content';
@@ -178,7 +202,7 @@ export type FormEntry = InputParameterReference | Columns | Sections | Content;
 export type Form = {
     entries?: FormEntry[];
 };
-export type ActionInputType = 'button' | 'Section' | 'Columns' | 'Content' | 'Select' | 'TextField' | 'DateTime' | 'RepeatableField' | 'MultiSelect' | 'Decimal' | 'RichText' | 'Date' | 'Integer' | 'Image' | 'Object' | 'Time' | 'User';
+export type ActionInputType = 'button' | 'Section' | 'Columns' | 'Content' | 'Criteria' | 'Select' | 'TextField' | 'DateTime' | 'Document' | 'RepeatableField' | 'ManyToManyRepeatableField' | 'MultiSelect' | 'Decimal' | 'RichText' | 'Date' | 'Integer' | 'Image' | 'Object' | 'Time' | 'User';
 /**
  * Represents an object action inputProperty object.
  */
@@ -187,7 +211,7 @@ export type ActionInput = {
     label?: string;
     type?: ActionInputType;
     key?: string;
-    initialValue?: string | number | SelectOption[] | SelectOption;
+    initialValue?: string | string[] | number | RelatedObjectDefaultValue | SelectOption[] | SelectOption;
     defaultToCurrentDate?: boolean;
     defaultToCurrentTime?: boolean;
     defaultValueCriteria?: object;
@@ -210,7 +234,7 @@ export type ActionInput = {
     inputMaskPlaceholderChar?: string;
     tableView?: boolean;
     mode?: 'default' | 'existingOnly';
-    displayOption?: 'dropdown' | 'dialogBox';
+    displayOption?: 'dropdown' | 'dialogBox' | 'radioButton';
     rows?: number;
     showCharCount?: boolean;
     readOnly?: boolean;
@@ -224,9 +248,9 @@ export type ActionInput = {
         when?: string;
         eq?: string | number | boolean;
     };
-    property?: {
-        id: string;
-    };
+    property?: InputParameter;
+    viewLayout?: ViewLayoutEntityReference;
+    documentMetadata?: Record<string, string>;
     validate?: {
         required?: boolean;
         criteria?: object;
@@ -240,6 +264,8 @@ export type ActionInput = {
         maxTime?: string;
         min?: number;
         max?: number;
+        minDocuments?: number;
+        maxDocuments?: number;
         customMessage?: string;
     };
     /**
@@ -306,3 +332,4 @@ export declare class ObjectStore {
     instanceAction<T extends ObjectInstance = ObjectInstance>(id: string, input: ActionRequest, cb: Callback<T>): void;
 }
 export declare function useObject(objectId: string): ObjectStore;
+export {};

package/dist/signalr/SignalRConnectionProvider.js

@@ -1,142 +1,53 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { jsx as _jsx } from "react/jsx-runtime";
 // Copyright (c) 2023 System Automation Corporation.
 // This file is licensed under the MIT License.
-import { HubConnectionBuilder, LogLevel } from '@microsoft/signalr/dist/esm/index.js';
-import { createContext, useContext, useEffect, useState } from 'react';
-import { useApiServices } from '../api/index.js';
+import { createContext, useContext, useState } from 'react';
+import { useNotification } from '../notification/index.js';
 export const SignalRConnectionContext = createContext({});
 SignalRConnectionContext.displayName = 'SignalRConnectionContext';
 function SignalRConnectionProvider({ children }) {
-    const [instancesSignalRConnection, setInstancesSignalRConnection] = useState();
-    const [documentsSignalRConnection, setDocumentsSignalRConnection] = useState();
-    const api = useApiServices();
-    useEffect(() => {
-        const getConnectionInfo = (hubName) => {
-            return api.post(`/signalr/hubs/${hubName}/negotiate`);
-        };
-        const getConnection = () => __awaiter(this, void 0, void 0, function* () {
-            try {
-                const instancesConnectionInfo = yield getConnectionInfo('instanceChanges');
-                const documentsConnectionInfo = yield getConnectionInfo('documentChanges');
-                if (instancesConnectionInfo) {
-                    const options = {
-                        accessTokenFactory: () => __awaiter(this, void 0, void 0, function* () {
-                            if (instancesConnectionInfo.accessToken) {
-                                return instancesConnectionInfo.accessToken;
-                            }
-                            else {
-                                return getConnection();
-                            }
-                        }),
-                    };
-                    const connection = new HubConnectionBuilder()
-                        .withUrl(instancesConnectionInfo.url, options)
-                        .configureLogging(LogLevel.Error)
-                        .withAutomaticReconnect()
-                        .build();
-                    setInstancesSignalRConnection(connection);
-                }
-                if (documentsConnectionInfo) {
-                    const options = {
-                        accessTokenFactory: () => __awaiter(this, void 0, void 0, function* () {
-                            if (documentsConnectionInfo.accessToken) {
-                                return documentsConnectionInfo.accessToken;
-                            }
-                            else {
-                                return getConnection();
-                            }
-                        }),
-                    };
-                    const connection = new HubConnectionBuilder()
-                        .withUrl(documentsConnectionInfo.url, options)
-                        .configureLogging(LogLevel.Error)
-                        .withAutomaticReconnect()
-                        .build();
-                    setDocumentsSignalRConnection(connection);
-                }
-                // eslint-disable-next-line no-empty
-            }
-            catch (err) { }
-        });
-        getConnection();
-    }, []);
-    useEffect(() => {
-        let documentsConnectionStopped = false;
-        const startConnection = (connection, numOfAttempts) => __awaiter(this, void 0, void 0, function* () {
-            yield connection.start().catch((error) => {
-                if (numOfAttempts < 4 && !documentsConnectionStopped) {
-                    setTimeout(() => {
-                        if (!documentsConnectionStopped) {
-                            startConnection(connection, numOfAttempts + 1);
-                        }
-                    }, 2000);
-                }
-                else {
-                    console.warn(`Cannot start connection to SignalR due to error "${error}"`);
-                }
-            });
-        });
-        if (documentsSignalRConnection) {
-            startConnection(documentsSignalRConnection, 0);
-        }
-        return () => {
-            documentsSignalRConnection === null || documentsSignalRConnection === void 0 ? void 0 : documentsSignalRConnection.stop();
-            documentsConnectionStopped = true;
-        };
-    }, [documentsSignalRConnection]);
-    useEffect(() => {
-        let instancesConnectionStopped = false;
-        const startConnection = (connection, numOfAttempts) => __awaiter(this, void 0, void 0, function* () {
-            yield connection.start().catch((error) => {
-                if (numOfAttempts < 4 && !instancesConnectionStopped) {
-                    setTimeout(() => {
-                        if (!instancesConnectionStopped) {
-                            startConnection(connection, numOfAttempts + 1);
-                        }
-                    }, 2000);
-                }
-                else {
-                    console.warn(`Cannot start connection to SignalR due to error "${error}"`);
-                }
-            });
-        });
-        if (instancesSignalRConnection) {
-            startConnection(instancesSignalRConnection, 0);
-        }
-        return () => {
-            instancesSignalRConnection === null || instancesSignalRConnection === void 0 ? void 0 : instancesSignalRConnection.stop();
-            instancesConnectionStopped = true;
-        };
-    }, [instancesSignalRConnection]);
+    const notifications = useNotification();
+    const [instanceCallbacks] = useState(
+    // Map provided callbacks to our wrappers that are sent to the underlying
+    // notification provider.
+    new WeakMap());
     return (_jsx(SignalRConnectionContext.Provider, { value: {
-            documentChanges: documentsSignalRConnection
-                ? {
-                    subscribe: (topicName, callback) => documentsSignalRConnection.on(topicName, callback),
-                    unsubscribe: (topicName, callback) => callback
-                        ? documentsSignalRConnection.off(topicName, callback)
-                        : documentsSignalRConnection.off(topicName),
-                }
-                : undefined,
-            instanceChanges: instancesSignalRConnection
-                ? {
-                    subscribe: (topicName, callback) => instancesSignalRConnection.on(topicName, callback),
-                    unsubscribe: (topicName, callback) => callback
-                        ? instancesSignalRConnection.off(topicName, callback)
-                        : instancesSignalRConnection.off(topicName),
-                }
-                : undefined,
+            documentChanges: {
+                subscribe: (topicName, callback) => {
+                    var _a;
+                    const [objectId, instanceId] = topicName.split('/');
+                    (_a = notifications.documentChanges) === null || _a === void 0 ? void 0 : _a.subscribe(objectId, instanceId, callback);
+                },
+                unsubscribe: (topicName, callback) => {
+                    var _a;
+                    const [objectId, instanceId] = topicName.split('/');
+                    (_a = notifications.documentChanges) === null || _a === void 0 ? void 0 : _a.unsubscribe(objectId, instanceId, callback);
+                },
+            },
+            instanceChanges: {
+                subscribe: (objectId, callback) => {
+                    var _a;
+                    // If there is already a wrapper for the given callback, we must reuse the
+                    // same one.  Otherwise, if we overwrite the entry in our cache, we'll lose
+                    // track of the original wrapper.
+                    let wrapper = instanceCallbacks.get(callback);
+                    if (!wrapper) {
+                        wrapper = (...changes) => {
+                            callback(...changes.map((change) => change.instanceId));
+                        };
+                        instanceCallbacks.set(callback, wrapper);
+                    }
+                    (_a = notifications.instanceChanges) === null || _a === void 0 ? void 0 : _a.subscribe(objectId, wrapper);
+                },
+                unsubscribe: (objectId, callback) => {
+                    var _a;
+                    (_a = notifications.instanceChanges) === null || _a === void 0 ? void 0 : _a.unsubscribe(objectId, callback && instanceCallbacks.get(callback));
+                },
+            },
         }, children: children }));
 }
 export function useSignalRConnection() {
+    console.warn('Use of useSignalRConnection is deprecated. Use useNotification instead.');
     return useContext(SignalRConnectionContext);
 }
 export default SignalRConnectionProvider;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@evoke-platform/context",
-    "version": "1.0.0-dev.99",
+    "version": "1.0.1-dev.0",
     "description": "Utilities that provide context to Evoke platform widgets",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -35,24 +35,29 @@
         "!dist/tests"
     ],
     "devDependencies": {
-        "@azure/msal-browser": "^2.38.2",
+        "@azure/msal-browser": "^2.38.4",
         "@azure/msal-react": "^1.5.9",
+        "@testing-library/dom": "^10.4.0",
+        "@testing-library/react": "^16.0.1",
         "@types/chai": "^4.3.11",
         "@types/dirty-chai": "^2.0.4",
         "@types/mocha": "^10.0.6",
         "@types/node": "^18.15.7",
         "@types/react": "^18.2.28",
-        "@types/uuid": "^9.0.8",
         "@types/sinon": "^17.0.3",
-        "chai": "^4.3.10",
+        "@types/uuid": "^9.0.8",
+        "chai": "^4.4.1",
         "commit-and-tag-version": "^12.1.0",
         "dirty-chai": "^2.0.1",
         "eslint-plugin-react": "^7.33.2",
+        "global-jsdom": "^25.0.0",
+        "jsdom": "^25.0.1",
         "mocha": "^10.2.0",
         "msw": "^1.3.1",
         "react": "^18.2.0",
+        "react-dom": "^18.3.1",
         "react-router-dom": "^6.16.0",
-        "sinon": "^17.0.1",
+        "sinon": "^18.0.0",
         "typescript": "^5.3.3"
     },
     "peerDependencies": {
@@ -63,7 +68,7 @@
     },
     "dependencies": {
         "@microsoft/signalr": "^7.0.12",
-        "axios": "^1.6.7",
+        "axios": "^1.7.9",
         "uuid": "^9.0.1"
     }
 }