@epilot/app-client 0.10.0 → 0.10.1

package/dist/openapi.d.ts

@@ -821,7 +821,7 @@ declare namespace Components {
                 flow_action_config?: AppBridgeSurfaceConfig;
             };
         }
-        export type CustomFlowConfig = ExternalIntegrationCustomActionConfig | SandboxCustomActionConfig;
+        export type CustomFlowConfig = ExternalIntegrationCustomActionConfig;
         export interface EnumArg {
             type?: "enum";
             /**
@@ -1246,12 +1246,17 @@ declare namespace Components {
              *
              */
             PortalExtensionHookRegistrationIdentifiersCheck | /**
-             * Hook that replaces the built-in contract identification for self-assignment. This hook makes a POST call whenever a user is trying to self-assign a contract to find the corresponding contract(s). The expected response to the call is:
-             *   - 200 if found with either:
-             *     - contract_id array
-             *     - contact_id string
-             *   - 404 if no contract is found
-             * If `contact_id` is provided in the response, Contracts are retrieved from this Contact. In that case, optionally, if you also specify `contact_relation_attribute`, the specified Contact attribute of the user performing the action will be modified to add the matched Contact.
+             * Hook that replaces the built-in Contract identification for self-assignment. This hook involves an HTTP request whenever a user is trying to self-assign Contract(s).
+             * The expected response http status code to the call is:
+             *   - 200 if found
+             *   - 404 if not found
+             *
+             * The following assignment modes are supported:
+             *   - `contracts`: We expect the response to contain Contract ids (customizable using `result` property).
+             *   - `contact_to_contracts`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact as a Customer to the Contracts and (optionally) update the Contact attribute specified by `contact_relation_attribute` to add the matched Contact.
+             *   - `contact_to_portal_user`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact to the Portal User. Portal User will be able to see all data including Contracts transitively.
+             *
+             * Defaults to `contact_to_contracts` for backwards compatibility. We recommend using `contact_to_portal_user` as it does not influence the data model of business entities.
              *
              */
             PortalExtensionHookContractIdentification | /**
@@ -1367,12 +1372,17 @@ declare namespace Components {
             use_static_ips?: boolean;
         }
         /**
-         * Hook that replaces the built-in contract identification for self-assignment. This hook makes a POST call whenever a user is trying to self-assign a contract to find the corresponding contract(s). The expected response to the call is:
-         *   - 200 if found with either:
-         *     - contract_id array
-         *     - contact_id string
-         *   - 404 if no contract is found
-         * If `contact_id` is provided in the response, Contracts are retrieved from this Contact. In that case, optionally, if you also specify `contact_relation_attribute`, the specified Contact attribute of the user performing the action will be modified to add the matched Contact.
+         * Hook that replaces the built-in Contract identification for self-assignment. This hook involves an HTTP request whenever a user is trying to self-assign Contract(s).
+         * The expected response http status code to the call is:
+         *   - 200 if found
+         *   - 404 if not found
+         *
+         * The following assignment modes are supported:
+         *   - `contracts`: We expect the response to contain Contract ids (customizable using `result` property).
+         *   - `contact_to_contracts`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact as a Customer to the Contracts and (optionally) update the Contact attribute specified by `contact_relation_attribute` to add the matched Contact.
+         *   - `contact_to_portal_user`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact to the Portal User. Portal User will be able to see all data including Contracts transitively.
+         *
+         * Defaults to `contact_to_contracts` for backwards compatibility. We recommend using `contact_to_portal_user` as it does not influence the data model of business entities.
          *
          */
         export interface PortalExtensionHookContractIdentification {
@@ -1407,7 +1417,11 @@ declare namespace Components {
                 };
             };
             /**
-             * Name of the Contact attribute to update with the matched Contact ID. Must be a Contact relation attribute supporting multiple entities.
+             * Mode of contract assignment. See hook description for mode details.
+             */
+            assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user";
+            /**
+             * Name of the Contact attribute to update with the matched Contact ID when using `contact_to_contracts` mode. Must be a Contact relation attribute supporting multiple entities.
              * example:
              * represents_contact
              */
@@ -1420,7 +1434,7 @@ declare namespace Components {
                 /**
                  * Explanation of the functionality shown to the end user.
                  * example:
-                 * This process will give you access to all Contracts kept
+                 * This process will give you access to the matching Contracts.
                  */
                 en: string;
             };
@@ -1807,28 +1821,6 @@ declare namespace Components {
              */
             key: string;
         }
-        export interface SandboxCustomActionConfig {
-            /**
-             * Name of the custom action
-             */
-            name?: string;
-            /**
-             * Description of the custom action
-             */
-            description?: string;
-            /**
-             * Wait for callback_url to be called before completing the action
-             */
-            wait_for_callback?: boolean;
-            type: "sandbox";
-            sandbox_settings?: {
-                /**
-                 * JavaScript code to execute for the sandbox action. Maximum size: 300KB (hard limit). Code is stored as raw JavaScript and will be syntax-validated on save. Security restrictions: eval() and Function() constructor are not allowed.
-                 *
-                 */
-                code?: string;
-            };
-        }
         export interface TextArg {
             type?: "text";
         }
@@ -3070,6 +3062,5 @@ export type RawEvents = Components.Schemas.RawEvents;
 export type Review = Components.Schemas.Review;
 export type Role = Components.Schemas.Role;
 export type S3Reference = Components.Schemas.S3Reference;
-export type SandboxCustomActionConfig = Components.Schemas.SandboxCustomActionConfig;
 export type TextArg = Components.Schemas.TextArg;
 export type TranslatedString = Components.Schemas.TranslatedString;

package/dist/openapi.json

@@ -2070,52 +2070,17 @@
           }
         ]
       },
-      "SandboxCustomActionConfig": {
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/BaseCustomActionConfig"
-          },
-          {
-            "type": "object",
-            "properties": {
-              "type": {
-                "type": "string",
-                "enum": [
-                  "sandbox"
-                ]
-              },
-              "sandbox_settings": {
-                "type": "object",
-                "properties": {
-                  "code": {
-                    "type": "string",
-                    "description": "JavaScript code to execute for the sandbox action. Maximum size: 300KB (hard limit). Code is stored as raw JavaScript and will be syntax-validated on save. Security restrictions: eval() and Function() constructor are not allowed.\n",
-                    "maxLength": 307200
-                  }
-                }
-              }
-            },
-            "required": [
-              "type"
-            ]
-          }
-        ]
-      },
       "CustomFlowConfig": {
         "type": "object",
         "oneOf": [
           {
             "$ref": "#/components/schemas/ExternalIntegrationCustomActionConfig"
-          },
-          {
-            "$ref": "#/components/schemas/SandboxCustomActionConfig"
           }
         ],
         "discriminator": {
           "propertyName": "type",
           "mapping": {
-            "external_integration": "#/components/schemas/ExternalIntegrationCustomActionConfig",
-            "sandbox": "#/components/schemas/SandboxCustomActionConfig"
+            "external_integration": "#/components/schemas/ExternalIntegrationCustomActionConfig"
           }
         }
       },
@@ -2273,7 +2238,7 @@
         "additionalProperties": false
       },
       "PortalExtensionHookContractIdentification": {
-        "description": "Hook that replaces the built-in contract identification for self-assignment. This hook makes a POST call whenever a user is trying to self-assign a contract to find the corresponding contract(s). The expected response to the call is:\n  - 200 if found with either:\n    - contract_id array\n    - contact_id string\n  - 404 if no contract is found\nIf `contact_id` is provided in the response, Contracts are retrieved from this Contact. In that case, optionally, if you also specify `contact_relation_attribute`, the specified Contact attribute of the user performing the action will be modified to add the matched Contact.\n",
+        "description": "Hook that replaces the built-in Contract identification for self-assignment. This hook involves an HTTP request whenever a user is trying to self-assign Contract(s).\nThe expected response http status code to the call is:\n  - 200 if found\n  - 404 if not found\n\nThe following assignment modes are supported:\n  - `contracts`: We expect the response to contain Contract ids (customizable using `result` property).\n  - `contact_to_contracts`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact as a Customer to the Contracts and (optionally) update the Contact attribute specified by `contact_relation_attribute` to add the matched Contact.\n  - `contact_to_portal_user`: We expect the response to contain a Contact id (customizable using `result` property) and we will assign the Contact to the Portal User. Portal User will be able to see all data including Contracts transitively.\n\nDefaults to `contact_to_contracts` for backwards compatibility. We recommend using `contact_to_portal_user` as it does not influence the data model of business entities.\n",
         "type": "object",
         "properties": {
           "type": {
@@ -2324,9 +2289,19 @@
             ],
             "additionalProperties": false
           },
+          "assignment_mode": {
+            "type": "string",
+            "enum": [
+              "contracts",
+              "contact_to_contracts",
+              "contact_to_portal_user"
+            ],
+            "description": "Mode of contract assignment. See hook description for mode details.",
+            "default": "contact_to_contracts"
+          },
           "contact_relation_attribute": {
             "type": "string",
-            "description": "Name of the Contact attribute to update with the matched Contact ID. Must be a Contact relation attribute supporting multiple entities.",
+            "description": "Name of the Contact attribute to update with the matched Contact ID when using `contact_to_contracts` mode. Must be a Contact relation attribute supporting multiple entities.",
             "example": "represents_contact"
           },
           "explanation": {
@@ -2335,7 +2310,7 @@
               "en": {
                 "type": "string",
                 "description": "Explanation of the functionality shown to the end user.",
-                "example": "This process will give you access to all Contracts kept"
+                "example": "This process will give you access to the matching Contracts."
               }
             },
             "additionalProperties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/app-client",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "JavaScript client library for the epilot App API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",