bigbluebutton-html-plugin-sdk 0.0.87 → 0.0.88

package/README.md

@@ -132,11 +132,6 @@ Here is as complete `manifest.json` example with all possible configurations:
   ], // One can enable more data-channels to better organize client communication
   "eventPersistence": {
     "isEnabled": true, // By default it is not enabled
-    "maximumPayloadSizeInBytes": 1024,
-    "rateLimiting": {
-      "messagesAllowedPerSecond": 10,
-      "messagesAllowedPerMinute": 20
-    }
   },
   "remoteDataSources": [
     {
@@ -145,12 +140,52 @@ Here is as complete `manifest.json` example with all possible configurations:
       "fetchMode": "onMeetingCreate", // Possible values: "onMeetingCreate", "onDemand" 
       "permissions": ["moderator", "viewer"]
     }
+  ],
+  "settingsSchema": [
+    {
+      "name": "myJson",
+      "label": "myJson",
+      "required": true,
+      "defaultValue": {
+        "abc": 123
+      },
+      "type": "json" // Possible values: "int", "float", "string", "boolean", "json"
+    }
   ]
 }
 ```
 
 To better understand remote-data-sources, please, refer to [this section](#external-data-resources)
 
+**settingsSchema:**
+
+The settingsSchema serves two main purposes:
+
+1. **Validation:** Ensures that all required settings are provided for a plugin. If any required setting is missing, the plugin will not load.
+2. **Configuration Exposure:** Lists all available settings for the plugin, enabling external systems—such as a Learning Management System (LMS)—to present these settings to a meeting organizer. This allows the organizer to configure the plugin manually before the meeting begins.
+
+| **Name**       | **Required** | **Description**                                                                                                |
+| -------------- | ------------ | -------------------------------------------------------------------------------------------------------------- |
+| `name`         | Yes          | The name of the setting as defined in the YAML file                                                            |
+| `label`        | No           | A user-facing label that appears in the integration UI                                                         |
+| `required`     | Yes          | Indicates whether this setting must be provided (`true` or `false`)                                            |
+| `defaultValue` | No           | The default value to use if no setting is explicitly defined                                                   |
+| `type`         | Yes          | The expected data type for the setting. Possible values: `"int"`, `"float"`, `"string"`, `"boolean"`, `"json"` |
+
+**Example**
+
+Given the `settingsSchema` defined in the `manifest.json` seen, the corresponding YAML configuration file (`/etc/bigbluebutton/bbb-html5.yml`) would look like:
+
+```yml
+public:
+  plugins:
+    - name: MyPlugin
+      settings:
+        myJson:
+          abc: my123
+          def: 3234
+```
+
 ## Testing SDK
 
 To setup and run the automated tests for the plugin SDK samples, check the [testing doc](/tests/README.md)
@@ -222,6 +257,59 @@ export interface GraphqlResponseWrapper<TData> {
 
 So we have the `data`, which is different for each hook, that's why it's a generic, the error, that will be set if, and only if, there is an error, otherwise it is undefined, and loading, which tells the developer if the query is still loading (being fetched) or not.
 
+### Realtime Data Creation
+
+**`useCustomMutation` Hook**
+
+The `useCustomMutation` hook enables you to post data to the backend (Postgres) using existing GraphQL mutations, respecting user permissions.
+
+It works similarly to Apollo Client’s `useMutation`, returning a *trigger function* and a *result object* with information about the mutation execution. These will be described in more detail below.
+
+One important difference is that the mutation query **must** be provided as a string. This is due to how the SDK communicates with the HTML5 client. As a consequence, you must explicitly define the type of the `variables` argument for the trigger function, as shown in the example below.
+
+```typescript
+interface MutationVariablesType {
+  reactionEmoji: string;
+}
+
+const [trigger, result] = pluginApi.useCustomMutation<MutationVariablesType>(`
+  mutation SetReactionEmoji($reactionEmoji: String!) {
+    userSetReactionEmoji(reactionEmoji: $reactionEmoji)
+  }
+`);
+
+// Later in the code, you can trigger the mutation:
+trigger({
+  variables: {
+    reactionEmoji: '👏',
+  },
+});
+```
+
+Note that the same type (`MutationVariablesType`) passed as the generic parameter to `useCustomMutation` is also the type of the `variables` object in the trigger function.
+
+The `result` object returned by the hook contains the following fields:
+
+```typescript
+const {
+  called,
+  data,
+  error,
+  loading,
+} = result;
+```
+
+which follow this interface:
+
+```typescript
+interface MutationResultObject {
+  called: boolean;   // Indicates if the trigger function has been called
+  data?: object;     // Response data after the mutation is triggered
+  error?: object;    // Error details from the mutation execution
+  loading: boolean;  // Whether the mutation is currently loading (triggered or in progress)
+}
+```
+
 ### Real time data exchange
 
 - `useDataChannel` hook: this will allow you to exchange information (Send and receive) amongst different users through the same plugin;
@@ -451,7 +539,7 @@ This feature is mainly used for security purposes, see [external data section](#
 
 ### Event persistence
 
-This feature will allow the developer to save an information (which is basically an event) in the `event.xml` file of the meeting if it's being recorded.
+This feature will allow the developer to save an information (an event) in the `event.xml` file of the meeting, if it's being recorded.
 
 To use it, one first need to add the following lines to their `manifest.json`:
 
@@ -460,11 +548,6 @@ To use it, one first need to add the following lines to their `manifest.json`:
   // ...rest of manifest configuration
   "eventPersistence": {
       "isEnabled": true,
-      "maximumPayloadSizeInBytes": 1024,
-      "rateLimiting": {
-          "messagesAllowedPerSecond": 10,
-          "messagesAllowedPerMinute": 20
-      }
   }
 }
 ```

package/dist/cjs/core/api/BbbPluginSdk.js

@@ -30,6 +30,8 @@ var utils_1 = require("../../remote-data/utils");
 var hooks_14 = require("../../event-persistence/hooks");
 var useLocaleMessages_1 = __importDefault(require("../auxiliary/plugin-information/locale-messages/useLocaleMessages"));
 var getters_1 = require("../../ui-data/getters/getters");
+var hooks_15 = require("../../data-consumption/domain/shared/custom-query/hooks");
+var hook_2 = require("../../data-creation/hook");
 /**
  * Class responsible for either initialize or get the PluginApi
  *
@@ -56,6 +58,8 @@ var BbbPluginSdk = /** @class */ (function () {
             throw new Error('Initializing pluginApi outside of a react function component. It should be done inside');
         var pluginApi = window.bbb_plugins[uuid];
         pluginApi.useCustomSubscription = (function (query, variablesObjectWrapper) { return (0, hooks_3.useCustomSubscription)(query, variablesObjectWrapper); });
+        pluginApi.useCustomQuery = (function (query, variablesObjectWrapper) { return (0, hooks_15.useCustomQuery)(query, variablesObjectWrapper); });
+        pluginApi.useCustomMutation = (function (mutation, options) { return (0, hook_2.useCustomMutation)(mutation, options); });
         pluginApi.useCurrentPresentation = (function () { return (0, hooks_2.useCurrentPresentation)(); });
         pluginApi.useLoadedUserList = (function () { return (0, hooks_4.useLoadedUserList)(); });
         pluginApi.useCurrentUser = (function () { return (0, hooks_5.useCurrentUser)(); });
@@ -81,7 +85,8 @@ var BbbPluginSdk = /** @class */ (function () {
             pluginApi.serverCommands = (0, commands_2.serverCommands)(pluginName);
             pluginApi.sendGenericDataForLearningAnalyticsDashboard = function (data) { return (0, hooks_13.sendGenericDataForLearningAnalyticsDashboard)(data, pluginName); };
             pluginApi.getRemoteData = function (dataSourceName) { return (0, utils_1.getRemoteData)(dataSourceName, pluginName); };
-            pluginApi.persistEvent = function (eventName, payload) { return (0, hooks_14.persistEventFunctionWrapper)(pluginName, eventName, payload); };
+            pluginApi
+                .persistEvent = function (eventName, payload) { return (0, hooks_14.persistEventFunctionWrapper)(pluginName, eventName, payload); };
             pluginApi.useLocaleMessages = function (fetchConfigs) { return (0, useLocaleMessages_1.default)({ pluginApi: pluginApi, fetchConfigs: fetchConfigs }); };
         }
         else {

package/dist/cjs/core/api/BbbPluginSdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"BbbPluginSdk.js","sourceRoot":"","sources":["../../../../src/core/api/BbbPluginSdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BbbPluginSdk.js","sourceRoot":"","sources":["../../../../src/core/api/BbbPluginSdk.ts"],"names":[],"mappings":"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"}

package/dist/cjs/core/api/types.d.ts

@@ -35,6 +35,8 @@ import { PersistEventFunction } from '../../event-persistence/types';
 import { UseLocaleMessagesFunction } from '../auxiliary/plugin-information/locale-messages/types';
 import { UseShouldUnmountPluginFunction } from '../auxiliary/plugin-unmount/types';
 import { GetUiDataFunction } from '../../ui-data/getters/types';
+import { UseCustomQueryFunction } from '../../data-consumption/domain/shared/custom-query/types';
+import { UseCustomMutationFunction } from '../../data-creation/types';
 export type SetPresentationToolbarItems = (presentationToolbarItem: PresentationToolbarInterface[]) => string[];
 export type SetUserListDropdownItems = (userListDropdownItem: UserListDropdownInterface[]) => string[];
 export type SetActionButtonDropdownItems = (actionButtonDropdownInterface: ActionButtonDropdownInterface[]) => string[];
@@ -110,11 +112,11 @@ export interface PluginApi {
      */
     useUsersBasicInfo?: UseUsersBasicInfoFunction;
     /**
-    * Returns an object containing brief data on the messages already loaded in the chat.
-    *
-    * @returns `GraphqlResponseWrapper` with the LoadedChatMessages.
-    *
-    */
+     * Returns an object containing brief data on the messages already loaded in the chat.
+     *
+     * @returns `GraphqlResponseWrapper` with the LoadedChatMessages.
+     *
+     */
     useLoadedChatMessages?: UseLoadedChatMessagesFunction;
     /**
      * Returns an object containing the settings for the current plugin (with pluginName
@@ -144,13 +146,29 @@ export interface PluginApi {
      */
     useShouldUnmountPlugin?: UseShouldUnmountPluginFunction;
     /**
-     * Returns an object containing the data on the current presentation being displayed
-     * in the presentation area, and its current page.
+     * Returns an object containing the data related to the custom subscription made.
+     * This hook is reactive - If the resulting data changes, it updates the hook.
      *
      * @returns `GraphqlResponseWrapper` with the data type specified in the generic type.
      *
      */
     useCustomSubscription?: UseCustomSubscriptionFunction;
+    /**
+     * Returns an object containing the data related to the custom subscription made.
+     * This hook is not reactive - Once the data is returned, it doesn't update anymore.
+     *
+     * @returns `GraphqlResponseWrapper` with the data type specified in the generic type.
+     *
+     */
+    useCustomQuery?: UseCustomQueryFunction;
+    /**
+     * Gives developer the ability to manipulate data from bbb using custom mutations.
+     * It can only use mutations that already exist in bbb.
+     *
+     * @returns an array with the trigger function and the result of the mutation.
+     *
+     */
+    useCustomMutation?: UseCustomMutationFunction;
     /**
      * Returns an array with tha data wrapped in the `GraphqlResponseWrapper` in the first
      * position of the array, the push function with which one plugin can inform

package/dist/cjs/core/enum.d.ts

@@ -1,17 +1,20 @@
 import { DataChannelHooks } from '../data-channel/enums';
 import { DomElementManipulationHooks } from '../dom-element-manipulation/enums';
 import { DataConsumptionHooks } from '../data-consumption/enums';
+import { DataCreationHookEnums } from '../data-creation/enums';
 export declare enum HookEvents {
     BBB_CORE_SENT_NEW_DATA = "BBB_CORE_SENT_NEW_DATA",
+    BBB_CORE_UPDATED_STATE = "BBB_CORE_UPDATED_STATE",
     BBB_CORE_UPDATED_MEETING_STATUS = "BBB_CORE_UPDATED_MEETING_STATUS",
     /**
      * PLUGIN_SENT_CHANGES_TO_BBB_CORE is used to:
-     *  - Comunicate that the subscription has changed for the dom-element-manipulation hook;
+     *  - Communicate that the subscription has changed for the dom-element-manipulation hook;
      *  - Send replace/delete event for useDataChannel;
+     *  - Trigger the mutation function already created
      */
     PLUGIN_SENT_CHANGES_TO_BBB_CORE = "PLUGIN_SENT_CHANGES_TO_BBB_CORE",
     PLUGIN_SUBSCRIBED_TO_BBB_CORE = "PLUGIN_SUBSCRIBED_TO_BBB_CORE",
     PLUGIN_UNSUBSCRIBED_FROM_BBB_CORE = "PLUGIN_UNSUBSCRIBED_FROM_BBB_CORE"
 }
 export declare const GENERIC_HOOK_PLUGIN = "GENERIC_HOOK_PLUGIN";
-export type Hooks = DataConsumptionHooks | DataChannelHooks | DomElementManipulationHooks | typeof GENERIC_HOOK_PLUGIN;
+export type Hooks = DataConsumptionHooks | DataChannelHooks | DomElementManipulationHooks | DataCreationHookEnums | typeof GENERIC_HOOK_PLUGIN;

package/dist/cjs/core/enum.js

@@ -4,11 +4,13 @@ exports.GENERIC_HOOK_PLUGIN = exports.HookEvents = void 0;
 var HookEvents;
 (function (HookEvents) {
     HookEvents["BBB_CORE_SENT_NEW_DATA"] = "BBB_CORE_SENT_NEW_DATA";
+    HookEvents["BBB_CORE_UPDATED_STATE"] = "BBB_CORE_UPDATED_STATE";
     HookEvents["BBB_CORE_UPDATED_MEETING_STATUS"] = "BBB_CORE_UPDATED_MEETING_STATUS";
     /**
      * PLUGIN_SENT_CHANGES_TO_BBB_CORE is used to:
-     *  - Comunicate that the subscription has changed for the dom-element-manipulation hook;
+     *  - Communicate that the subscription has changed for the dom-element-manipulation hook;
      *  - Send replace/delete event for useDataChannel;
+     *  - Trigger the mutation function already created
      */
     HookEvents["PLUGIN_SENT_CHANGES_TO_BBB_CORE"] = "PLUGIN_SENT_CHANGES_TO_BBB_CORE";
     HookEvents["PLUGIN_SUBSCRIBED_TO_BBB_CORE"] = "PLUGIN_SUBSCRIBED_TO_BBB_CORE";

package/dist/cjs/core/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/core/enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,+DAAiD,CAAA;IACjD,iFAAmE,CAAA;IACnE;;;;OAIG;IACH,iFAAmE,CAAA;IACnE,6EAA+D,CAAA;IAC/D,qFAAuE,CAAA;AACzE,CAAC,EAXW,UAAU,0BAAV,UAAU,QAWrB;AAEY,QAAA,mBAAmB,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../../src/core/enum.ts"],"names":[],"mappings":";;;AAKA,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,+DAAiD,CAAA;IACjD,+DAAiD,CAAA;IACjD,iFAAmE,CAAA;IACnE;;;;;OAKG;IACH,iFAAmE,CAAA;IACnE,6EAA+D,CAAA;IAC/D,qFAAuE,CAAA;AACzE,CAAC,EAbW,UAAU,0BAAV,UAAU,QAarB;AAEY,QAAA,mBAAmB,GAAG,qBAAqB,CAAC"}

package/dist/cjs/core/types.d.ts

@@ -3,6 +3,7 @@ import { CustomSubscriptionArguments } from '../data-consumption/domain/shared/c
 import { Hooks } from './enum';
 import { DataChannelArguments } from '../data-channel/types';
 import { DomElementManipulationArguments } from '../dom-element-manipulation/type';
+import { UseCustomMutationArguments } from '../data-creation/types';
 /**
  * Wrapper for the data that comes from the core. With this more complex object
  * it is also possible to know whether the data is still loading, of even if something
@@ -15,7 +16,7 @@ export interface GraphqlResponseWrapper<TData> {
     data?: TData;
     error?: ApolloError;
 }
-export type HookArguments = CustomSubscriptionArguments | DataChannelArguments | DomElementManipulationArguments;
+export type HookArguments = CustomSubscriptionArguments | DataChannelArguments | DomElementManipulationArguments | UseCustomMutationArguments;
 export interface UpdatedEventDetails<T> {
     hook: Hooks;
     hookArguments?: HookArguments;

package/dist/cjs/data-consumption/domain/shared/custom-query/hooks.d.ts

@@ -0,0 +1,2 @@
+import { UseCustomQueryFunction } from './types';
+export declare const useCustomQuery: UseCustomQueryFunction;

package/dist/cjs/data-consumption/domain/shared/custom-query/hooks.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCustomQuery = void 0;
+var enums_1 = require("../../../../data-consumption/enums");
+var hookCreator_1 = require("../../../factory/hookCreator");
+var useCustomQuery = function (query, options) { return (0, hookCreator_1.createDataConsumptionHook)(enums_1.DataConsumptionHooks.CUSTOM_QUERY, {
+    query: query,
+    variables: options === null || options === void 0 ? void 0 : options.variables,
+}); };
+exports.useCustomQuery = useCustomQuery;
+//# sourceMappingURL=hooks.js.map

package/dist/cjs/data-consumption/domain/shared/custom-query/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../src/data-consumption/domain/shared/custom-query/hooks.ts"],"names":[],"mappings":";;;AAAA,4DAA0E;AAC1E,4DAAyE;AAGlE,IAAM,cAAc,GAA2B,UACpD,KAAa,EACb,OAAgC,IAC7B,OAAA,IAAA,uCAAyB,EAAI,4BAAoB,CAAC,YAAY,EAAE;IACnE,KAAK,OAAA;IACL,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;CACN,CAAC,EAHrB,CAGqB,CAAC;AANd,QAAA,cAAc,kBAMA"}

package/dist/cjs/data-consumption/domain/shared/custom-query/types.d.ts

@@ -0,0 +1,9 @@
+import { GraphqlResponseWrapper } from '../../../../core';
+export interface CustomQueryArguments {
+    query?: string;
+    variables?: object;
+}
+export interface CustomQueryHookOptions {
+    variables: object;
+}
+export type UseCustomQueryFunction = <T>(query: string, variablesObjectWrapper?: CustomQueryHookOptions) => GraphqlResponseWrapper<T>;

package/dist/cjs/data-consumption/domain/shared/custom-query/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/data-consumption/domain/shared/custom-query/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/data-consumption/domain/shared/custom-query/types.ts"],"names":[],"mappings":""}

package/dist/cjs/data-consumption/domain/shared/index.d.ts

@@ -1 +1,2 @@
 export { CustomSubscriptionHookOptions } from './custom-subscription/types';
+export { CustomQueryHookOptions } from './custom-query/types';

package/dist/cjs/data-consumption/domain/shared/types.d.ts

@@ -0,0 +1,3 @@
+import { CustomQueryArguments } from './custom-query/types';
+import { CustomSubscriptionArguments } from './custom-subscription/types';
+export type DataConsumptionArguments = CustomSubscriptionArguments | CustomQueryArguments;

package/dist/cjs/data-consumption/domain/shared/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/data-consumption/domain/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/data-consumption/domain/shared/types.ts"],"names":[],"mappings":""}

package/dist/cjs/data-consumption/enums.d.ts

@@ -5,5 +5,6 @@ export declare enum DataConsumptionHooks {
     LOADED_CHAT_MESSAGES = "Hooks::UseLoadedChatMessages",
     MEETING = "Hooks::UseMeeting",
     TALKING_INDICATOR = "Hooks::UseTalkingIndicator",
-    CUSTOM_SUBSCRIPTION = "Hooks::CustomSubscription"
+    CUSTOM_SUBSCRIPTION = "Hooks::CustomSubscription",
+    CUSTOM_QUERY = "Hooks::CustomQuery"
 }

package/dist/cjs/data-consumption/enums.js

@@ -10,5 +10,6 @@ var DataConsumptionHooks;
     DataConsumptionHooks["MEETING"] = "Hooks::UseMeeting";
     DataConsumptionHooks["TALKING_INDICATOR"] = "Hooks::UseTalkingIndicator";
     DataConsumptionHooks["CUSTOM_SUBSCRIPTION"] = "Hooks::CustomSubscription";
+    DataConsumptionHooks["CUSTOM_QUERY"] = "Hooks::CustomQuery";
 })(DataConsumptionHooks || (exports.DataConsumptionHooks = DataConsumptionHooks = {}));
 //# sourceMappingURL=enums.js.map

package/dist/cjs/data-consumption/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/data-consumption/enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,oBAQX;AARD,WAAY,oBAAoB;IAC9B,8EAAsD,CAAA;IACtD,qEAA6C,CAAA;IAC7C,8DAAsC,CAAA;IACtC,6EAAqD,CAAA;IACrD,qDAA6B,CAAA;IAC7B,wEAAgD,CAAA;IAChD,yEAAiD,CAAA;AACnD,CAAC,EARW,oBAAoB,oCAApB,oBAAoB,QAQ/B"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/data-consumption/enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,oBASX;AATD,WAAY,oBAAoB;IAC9B,8EAAsD,CAAA;IACtD,qEAA6C,CAAA;IAC7C,8DAAsC,CAAA;IACtC,6EAAqD,CAAA;IACrD,qDAA6B,CAAA;IAC7B,wEAAgD,CAAA;IAChD,yEAAiD,CAAA;IACjD,2DAAmC,CAAA;AACrC,CAAC,EATW,oBAAoB,oCAApB,oBAAoB,QAS/B"}

package/dist/cjs/data-creation/enums.d.ts

@@ -0,0 +1,6 @@
+export declare enum DataCreationHookEnums {
+    CREATE_NEW_CUSTOM_MUTATION = "Hooks::CreateNewCustomMutation",
+    TRIGGER_MUTATION = "Hooks::TriggerMutation",
+    MUTATION_READY = "Hooks::MutationReady",
+    MUTATION_RESULT_SENT = "Hooks::MutationResultSent"
+}

package/dist/cjs/data-creation/enums.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataCreationHookEnums = void 0;
+var DataCreationHookEnums;
+(function (DataCreationHookEnums) {
+    DataCreationHookEnums["CREATE_NEW_CUSTOM_MUTATION"] = "Hooks::CreateNewCustomMutation";
+    DataCreationHookEnums["TRIGGER_MUTATION"] = "Hooks::TriggerMutation";
+    DataCreationHookEnums["MUTATION_READY"] = "Hooks::MutationReady";
+    DataCreationHookEnums["MUTATION_RESULT_SENT"] = "Hooks::MutationResultSent";
+})(DataCreationHookEnums || (exports.DataCreationHookEnums = DataCreationHookEnums = {}));
+//# sourceMappingURL=enums.js.map

package/dist/cjs/data-creation/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/data-creation/enums.ts"],"names":[],"mappings":";;;AAAA,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC/B,sFAA6D,CAAA;IAC7D,oEAA2C,CAAA;IAC3C,gEAAuC,CAAA;IACvC,2EAAkD,CAAA;AACpD,CAAC,EALW,qBAAqB,qCAArB,qBAAqB,QAKhC"}

package/dist/cjs/data-creation/hook.d.ts

@@ -0,0 +1,2 @@
+import { UseCustomMutationReturnType } from './types';
+export declare function useCustomMutation<T>(mutation: string, options?: object): UseCustomMutationReturnType<T>;

package/dist/cjs/data-creation/hook.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCustomMutation = void 0;
+var react_1 = require("react");
+var enum_1 = require("../core/enum");
+var enums_1 = require("./enums");
+var utils_1 = __importDefault(require("./utils"));
+function useCustomMutation(mutation, options) {
+    var _a = (0, react_1.useState)({
+        triggerFunction: null,
+        result: {
+            loading: true,
+            called: false,
+        },
+    }), mutationHookResult = _a[0], setMutationHookResult = _a[1];
+    var triggerFunction = (function (data) {
+        window.dispatchEvent(new CustomEvent(enum_1.HookEvents.PLUGIN_SENT_CHANGES_TO_BBB_CORE, {
+            detail: {
+                hook: enums_1.DataCreationHookEnums.TRIGGER_MUTATION,
+                hookArguments: {
+                    mutation: mutation,
+                    options: options,
+                },
+                data: data,
+            },
+        }));
+    });
+    // This function is responsible for setting the trigger function of the mutation
+    var handleMutationReadyEvent = (function (event) {
+        (0, utils_1.default)(setMutationHookResult, function (prevMutationResultObject) { return ({
+            triggerFunction: triggerFunction,
+            result: prevMutationResultObject.result,
+        }); }, enums_1.DataCreationHookEnums.MUTATION_READY, event, mutation, options);
+    });
+    // This function is responsible for setting the result of the mutation;
+    var handleMutationResultSentEvent = (function (event) {
+        (0, utils_1.default)(setMutationHookResult, function (prevMutationResultObject, dataFromEvent) { return ({
+            triggerFunction: prevMutationResultObject.triggerFunction,
+            result: dataFromEvent,
+        }); }, enums_1.DataCreationHookEnums.MUTATION_RESULT_SENT, event, mutation, options);
+    });
+    (0, react_1.useEffect)(function () {
+        window.dispatchEvent(new CustomEvent(enum_1.HookEvents.PLUGIN_SUBSCRIBED_TO_BBB_CORE, {
+            detail: {
+                hook: enums_1.DataCreationHookEnums.CREATE_NEW_CUSTOM_MUTATION,
+                hookArguments: {
+                    mutation: mutation,
+                    options: options,
+                },
+            },
+        }));
+        window.addEventListener(enum_1.HookEvents.BBB_CORE_UPDATED_STATE, handleMutationReadyEvent);
+        window.addEventListener(enum_1.HookEvents.BBB_CORE_UPDATED_STATE, handleMutationResultSentEvent);
+        return function () {
+            window.dispatchEvent(new CustomEvent(enum_1.HookEvents.PLUGIN_UNSUBSCRIBED_FROM_BBB_CORE, {
+                detail: {
+                    hook: enums_1.DataCreationHookEnums.CREATE_NEW_CUSTOM_MUTATION,
+                    hookArguments: {
+                        mutation: mutation,
+                        options: options,
+                    },
+                },
+            }));
+            window.removeEventListener(enum_1.HookEvents.BBB_CORE_UPDATED_STATE, handleMutationReadyEvent);
+            window.removeEventListener(enum_1.HookEvents.BBB_CORE_UPDATED_STATE, handleMutationResultSentEvent);
+        };
+    }, []);
+    return [mutationHookResult.triggerFunction, mutationHookResult.result];
+}
+exports.useCustomMutation = useCustomMutation;
+//# sourceMappingURL=hook.js.map

package/dist/cjs/data-creation/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../../src/data-creation/hook.ts"],"names":[],"mappings":";;;;;;AAAA,+BAA4C;AAO5C,qCAA0C;AAO1C,iCAAgD;AAChD,kDAAsD;AAEtD,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,OAAgB;IAEV,IAAA,KAA8C,IAAA,gBAAQ,EAC1D;QACE,eAAe,EAAE,IAAI;QACrB,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,KAAK;SACd;KACF,CACF,EARM,kBAAkB,QAAA,EAAE,qBAAqB,QAQ/C,CAAC;IAEF,IAAM,eAAe,GAAG,CAAC,UAAC,IAAiC;QACzD,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAEZ,iBAAU,CAAC,+BAA+B,EAAE;YAC7C,MAAM,EAAE;gBACN,IAAI,EAAE,6BAAqB,CAAC,gBAAgB;gBAC5C,aAAa,EAAE;oBACb,QAAQ,UAAA;oBACR,OAAO,SAAA;iBACR;gBACD,IAAI,MAAA;aACL;SACF,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,gFAAgF;IAChF,IAAM,wBAAwB,GAAkB,CAC9C,UAAC,KAAqD;QACpD,IAAA,eAA+B,EAC7B,qBAAqB,EACrB,UAAC,wBAAwB,IAAK,OAAA,CAAC;YAC7B,eAAe,iBAAA;YACf,MAAM,EAAE,wBAAwB,CAAC,MAAM;SACxC,CAAC,EAH4B,CAG5B,EACF,6BAAqB,CAAC,cAAc,EACpC,KAAK,EACL,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC,CAAkB,CAAC;IAEtB,uEAAuE;IACvE,IAAM,6BAA6B,GAAkB,CACnD,UAAC,KAAqD;QACpD,IAAA,eAA+B,EAC7B,qBAAqB,EACrB,UAAC,wBAAwB,EAAE,aAAa,IAAK,OAAA,CAAC;YAC5C,eAAe,EAAE,wBAAwB,CAAC,eAAe;YACzD,MAAM,EAAE,aAAa;SACtB,CAAC,EAH2C,CAG3C,EACF,6BAAqB,CAAC,oBAAoB,EAC1C,KAAK,EACL,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC,CAAkB,CAAC;IAEtB,IAAA,iBAAS,EAAC;QACR,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAyB,iBAAU,CAAC,6BAA6B,EAAE;YAChF,MAAM,EAAE;gBACN,IAAI,EAAE,6BAAqB,CAAC,0BAA0B;gBACtD,aAAa,EAAE;oBACb,QAAQ,UAAA;oBACR,OAAO,SAAA;iBACR;aACF;SACF,CAAC,CACH,CAAC;QACF,MAAM,CAAC,gBAAgB,CACrB,iBAAU,CAAC,sBAAsB,EACjC,wBAAwB,CACzB,CAAC;QACF,MAAM,CAAC,gBAAgB,CACrB,iBAAU,CAAC,sBAAsB,EACjC,6BAA6B,CAC9B,CAAC;QAEF,OAAO;YACL,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CAAyB,iBAAU,CAAC,iCAAiC,EAAE;gBACpF,MAAM,EAAE;oBACN,IAAI,EAAE,6BAAqB,CAAC,0BAA0B;oBACtD,aAAa,EAAE;wBACb,QAAQ,UAAA;wBACR,OAAO,SAAA;qBACR;iBACF;aACF,CAAC,CACH,CAAC;YACF,MAAM,CAAC,mBAAmB,CACxB,iBAAU,CAAC,sBAAsB,EACjC,wBAAwB,CACzB,CAAC;YACF,MAAM,CAAC,mBAAmB,CACxB,iBAAU,CAAC,sBAAsB,EACjC,6BAA6B,CAC9B,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CAAC,kBAAkB,CAAC,eAAe,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AA5GD,8CA4GC"}

package/dist/cjs/data-creation/types.d.ts

@@ -0,0 +1,21 @@
+export interface MutationVariablesWrapper<T> {
+    variables: T;
+}
+export type TriggerMutationFunction<T> = (args: MutationVariablesWrapper<T>) => void;
+export type UseCustomMutationReturnType<T> = [TriggerMutationFunction<T> | null, object | null];
+export type UseCustomMutationFunction = <T = any>(mutation: string, options?: object) => UseCustomMutationReturnType<T>;
+export interface UseCustomMutationArguments {
+    mutation: string;
+    options?: object;
+}
+export interface MutationResultObject {
+    called: boolean;
+    data?: object;
+    error?: object;
+    loading: boolean;
+}
+export interface MutationHookResultType<T> {
+    triggerFunction: TriggerMutationFunction<T> | null;
+    result: MutationResultObject | null;
+}
+export type SetterFunctionCallbackType<T, K> = (previousObject: MutationHookResultType<T>, dataFromEvent: K) => MutationHookResultType<T>;

package/dist/cjs/data-creation/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/data-creation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/data-creation/types.ts"],"names":[],"mappings":""}

package/dist/cjs/data-creation/utils.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import { GraphqlResponseWrapper, HookEventWrapper } from '../core/types';
+import { DataCreationHookEnums } from './enums';
+import { MutationHookResultType, SetterFunctionCallbackType } from './types';
+declare const validateMutationEventFromClient: <T, K>(setMutationResult: React.Dispatch<React.SetStateAction<MutationHookResultType<T>>>, setterFunctionCallback: SetterFunctionCallbackType<T, K>, hook: DataCreationHookEnums, event: HookEventWrapper<GraphqlResponseWrapper<object>>, mutation: string, options?: object) => void;
+export default validateMutationEventFromClient;

package/dist/cjs/data-creation/utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var utils_1 = require("../data-consumption/utils");
+var validateMutationEventFromClient = function (setMutationResult, setterFunctionCallback, hook, event, mutation, options) {
+    var _a = event.detail, hookReceived = _a.hook, hookArguments = _a.hookArguments, data = _a.data;
+    var _b = (hookArguments || { mutation: null, options: null }), mutationReceived = _b.mutation, optionsReceived = _b.options;
+    if (hookReceived === hook
+        && ((0, utils_1.makeCustomHookIdentifier)(mutationReceived, optionsReceived)
+            === (0, utils_1.makeCustomHookIdentifier)(mutation, options))) {
+        setMutationResult(function (prevObject) { return setterFunctionCallback(prevObject, data); });
+    }
+};
+exports.default = validateMutationEventFromClient;
+//# sourceMappingURL=utils.js.map

package/dist/cjs/data-creation/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/data-creation/utils.ts"],"names":[],"mappings":";;AACA,mDAAqE;AAKrE,IAAM,+BAA+B,GAAG,UACtC,iBAAkF,EAClF,sBAAwD,EACxD,IAA2B,EAC3B,KAAuD,EACvD,QAAgB,EAChB,OAAgB;IAEV,IAAA,KAIF,KAAK,CAAC,MAAgC,EAHlC,YAAY,UAAA,EAClB,aAAa,mBAAA,EACb,IAAI,UACoC,CAAC;IACrC,IAAA,KAGF,CAAC,aAAa,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAA+B,EAF1E,gBAAgB,cAAA,EACjB,eAAe,aAC4D,CAAC;IACvF,IACE,YAAY,KAAK,IAAI;WAClB,CAAC,IAAA,gCAAwB,EAAC,gBAAgB,EAAE,eAAe,CAAC;gBACzD,IAAA,gCAAwB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAClD;QACA,iBAAiB,CAAC,UAAC,UAAU,IAAK,OAAA,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,EAAxC,CAAwC,CAAC,CAAC;KAC7E;AACH,CAAC,CAAC;AAEF,kBAAe,+BAA+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigbluebutton-html-plugin-sdk",
-  "version": "0.0.87",
+  "version": "0.0.88",
   "homepage": "https://github.com/bigbluebutton/bigbluebutton-html-plugin-sdk",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",