@epilot/app-client 0.10.4 → 0.11.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330:function(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/app/{appId}/components/{componentId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"},{"name":"componentId","in":"path","required":true,"description":"ID of the component to retrieve"}],"get":{"operationId":"getPublicFacingComponent","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/review":{"get":{"operationId":"getReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"post":{"operationId":"createReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateReviewRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"requestBodies":{"CreateReviewRequest":{"required":true,"content":{"application/json":{}}},"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(330),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={330(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default},466(e){e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/app/{appId}/components/{componentId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"},{"name":"componentId","in":"path","required":true,"description":"ID of the component to retrieve"}],"get":{"operationId":"getPublicFacingComponent","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public":{"get":{"operationId":"listPublicConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/review":{"get":{"operationId":"getReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"post":{"operationId":"createReview","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateReviewRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"requestBodies":{"CreateReviewRequest":{"required":true,"content":{"application/json":{}}},"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(330),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -53,6 +53,22 @@
         "responses": {}
       }
     },
+    "/v1/app-configurations/public": {
+      "get": {
+        "operationId": "listPublicConfigurations",
+        "parameters": [
+          {
+            "name": "page",
+            "in": "query"
+          },
+          {
+            "name": "pageSize",
+            "in": "query"
+          }
+        ],
+        "responses": {}
+      }
+    },
     "/v1/app-configurations/public/{appId}": {
       "parameters": [
         {

package/dist/openapi.d.ts

@@ -247,7 +247,7 @@ declare namespace Components {
             surfaces?: {
                 [key: string]: any;
             };
-        } & (JourneyBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent);
+        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent);
         export interface BaseComponentCommon {
             /**
              * Unique identifier for the component
@@ -451,7 +451,7 @@ declare namespace Components {
         /**
          * Type of app component
          */
-        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG";
+        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG";
         /**
          * Configuration of the published app
          */
@@ -992,7 +992,7 @@ declare namespace Components {
              * JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.
              */
             body?: {
-                [name: string]: string;
+                [name: string]: any;
             };
         }
         export interface ExternalProductCatalogComponent {
@@ -1008,19 +1008,19 @@ declare namespace Components {
              * Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
              *
              */
-            ExternalProductCatalogHookProductsRecommendation)[];
+            ExternalProductCatalogHookProductRecommendations)[];
         }
         /**
-         * Hook for getting products from an external catalog. This hook makes a call to retrieve product data from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+         * Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
          *
          */
-        export interface ExternalProductCatalogHookProducts {
+        export interface ExternalProductCatalogHookProductRecommendations {
             /**
              * Identifier of the hook. Should not change between updates.
              */
             id: string; // ^[a-zA-Z0-9_-]+$
             name?: TranslatedString;
-            type: "products";
+            type: "product-recommendations";
             auth?: ExternalProductCatalogAuthBlock;
             call: {
                 /**
@@ -1047,21 +1047,21 @@ declare namespace Components {
                  * JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).
                  */
                 body?: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
             };
         }
         /**
-         * Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
+         * Hook for getting products from an external catalog. This hook makes a call to retrieve product data from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.
          *
          */
-        export interface ExternalProductCatalogHookProductsRecommendation {
+        export interface ExternalProductCatalogHookProducts {
             /**
              * Identifier of the hook. Should not change between updates.
              */
             id: string; // ^[a-zA-Z0-9_-]+$
             name?: TranslatedString;
-            type: "products-recommendation";
+            type: "products";
             auth?: ExternalProductCatalogAuthBlock;
             call: {
                 /**
@@ -1088,7 +1088,7 @@ declare namespace Components {
                  * JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).
                  */
                 body?: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
             };
         }
@@ -1307,6 +1307,33 @@ declare namespace Components {
              */
             override_url?: string;
         }
+        export interface PortalBlockComponent {
+            component_type: "CUSTOM_PORTAL_BLOCK";
+            configuration: PortalBlockConfig;
+            surfaces?: {
+                portal_block?: PortalBlockSurfaceConfig;
+            };
+        }
+        export interface PortalBlockConfig {
+        }
+        export interface PortalBlockSurfaceConfig {
+            /**
+             * URL of the uploaded App Bridge App. This is the entrypoint for the app
+             */
+            app_url?: string;
+            /**
+             * URL of the uploaded zip file containing the app
+             */
+            zip_url?: string;
+            /**
+             * URL of the app in dev mode
+             */
+            override_url?: string;
+            /**
+             * Define which section of the portal this block can be placed in
+             */
+            section?: "main" | "footer";
+        }
         export interface PortalExtensionAuthBlock {
             /**
              * HTTP method to use for authentication
@@ -1332,7 +1359,7 @@ declare namespace Components {
              * JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.
              */
             body?: {
-                [name: string]: string;
+                [name: string]: any;
             };
             cache?: {
                 /**
@@ -1470,7 +1497,7 @@ declare namespace Components {
                  * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
                  */
                 body?: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
             };
             resolved?: {
@@ -1534,7 +1561,7 @@ declare namespace Components {
                     [key: string]: any;
                 };
                 /**
-                 * Contract or Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. Supports variable interpolation.
+                 * Contract or Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation.
                  */
                 result?: string;
             };
@@ -1607,7 +1634,7 @@ declare namespace Components {
                  * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
                  */
                 body?: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
             };
             resolved?: {
@@ -1637,6 +1664,13 @@ declare namespace Components {
             id: string; // ^[a-zA-Z0-9_-]+$
             name?: TranslatedString;
             type: "meterReadingPlausibilityCheck";
+            /**
+             * Mode for plausibility check:
+             * - "check": Validates meter reading and returns valid: boolean (used during submission)
+             * - "range": Returns min/max allowed values for each counter for validation before submission
+             *
+             */
+            plausibility_mode?: "check" | "range";
             auth?: PortalExtensionAuthBlock;
             call: {
                 /**
@@ -1647,7 +1681,7 @@ declare namespace Components {
                  * JSON body to use for the call. Supports variable interpolation.
                  */
                 body: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
                 /**
                  * Headers to use. Supports variable interpolation.
@@ -1661,7 +1695,30 @@ declare namespace Components {
              */
             resolved: {
                 /**
-                 * Indicate whether the meter reading is plausible
+                 * Optional path to an array in the response. If specified and the path points to an array,
+                 * the hook will map over each item using 'Item' variable for interpolation.
+                 * Relevant only if plausibility_mode is "range".
+                 *
+                 * example:
+                 * data.results
+                 */
+                dataPath?: string;
+                /**
+                 * Counter identifier(s) used to match against the meter's counters.
+                 * Can be a string (counter ID) or an object with counter properties.
+                 * The backend resolves this to meter_counter_id in the final response.
+                 * Relevant only if plausibility_mode is "range".
+                 *
+                 * example:
+                 * {
+                 *   "obis_code": "{{Item.obis}}"
+                 * }
+                 */
+                counter_identifiers?: {
+                    [name: string]: string;
+                };
+                /**
+                 * Indicate whether the meter reading is plausible. Relevant only if plausibility_mode is "check".
                  * example:
                  * {{CallResponse.data.valid}}
                  */
@@ -1726,7 +1783,7 @@ declare namespace Components {
                  * Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.
                  */
                 body?: {
-                    [name: string]: string;
+                    [name: string]: any;
                 };
             };
             resolved?: {
@@ -1782,7 +1839,7 @@ declare namespace Components {
                     [key: string]: any;
                 };
                 /**
-                 * Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. Supports variable interpolation.
+                 * Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation.
                  */
                 result: string;
             };
@@ -2371,6 +2428,26 @@ declare namespace Paths {
             }
         }
     }
+    namespace ListPublicConfigurations {
+        namespace Parameters {
+            export type Page = number;
+            export type PageSize = number;
+        }
+        export interface QueryParameters {
+            page?: Parameters.Page;
+            pageSize?: Parameters.PageSize;
+        }
+        namespace Responses {
+            export interface $200 {
+                configurations?: /* Basic metadata about your app configuration which does not get versioned */ Components.Schemas.ConfigurationMetadata[];
+                pagination?: {
+                    total?: number;
+                    page?: number;
+                    pageSize?: number;
+                };
+            }
+        }
+    }
     namespace ListVersions {
         namespace Parameters {
             export type AppId = string;
@@ -2576,6 +2653,16 @@ export interface OperationMethods {
     data?: Paths.CreateConfiguration.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateConfiguration.Responses.$201>
+  /**
+   * listPublicConfigurations - listPublicConfigurations
+   * 
+   * List all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.
+   */
+  'listPublicConfigurations'(
+    parameters?: Parameters<Paths.ListPublicConfigurations.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListPublicConfigurations.Responses.$200>
   /**
    * getPublicConfiguration - getPublicConfiguration
    * 
@@ -2874,6 +2961,18 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.CreateConfiguration.Responses.$201>
   }
+  ['/v1/app-configurations/public']: {
+    /**
+     * listPublicConfigurations - listPublicConfigurations
+     * 
+     * List all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListPublicConfigurations.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListPublicConfigurations.Responses.$200>
+  }
   ['/v1/app-configurations/public/{appId}']: {
     /**
      * getPublicConfiguration - getPublicConfiguration
@@ -3201,8 +3300,8 @@ export type ExternalIntegrationCustomActionConfig = Components.Schemas.ExternalI
 export type ExternalProductCatalogAuthBlock = Components.Schemas.ExternalProductCatalogAuthBlock;
 export type ExternalProductCatalogComponent = Components.Schemas.ExternalProductCatalogComponent;
 export type ExternalProductCatalogConfig = Components.Schemas.ExternalProductCatalogConfig;
+export type ExternalProductCatalogHookProductRecommendations = Components.Schemas.ExternalProductCatalogHookProductRecommendations;
 export type ExternalProductCatalogHookProducts = Components.Schemas.ExternalProductCatalogHookProducts;
-export type ExternalProductCatalogHookProductsRecommendation = Components.Schemas.ExternalProductCatalogHookProductsRecommendation;
 export type Grants = Components.Schemas.Grants;
 export type Installation = Components.Schemas.Installation;
 export type JourneyBlockComponent = Components.Schemas.JourneyBlockComponent;
@@ -3214,6 +3313,9 @@ export type Option = Components.Schemas.Option;
 export type Options = Components.Schemas.Options;
 export type OptionsRef = Components.Schemas.OptionsRef;
 export type OverrideDevMode = Components.Schemas.OverrideDevMode;
+export type PortalBlockComponent = Components.Schemas.PortalBlockComponent;
+export type PortalBlockConfig = Components.Schemas.PortalBlockConfig;
+export type PortalBlockSurfaceConfig = Components.Schemas.PortalBlockSurfaceConfig;
 export type PortalExtensionAuthBlock = Components.Schemas.PortalExtensionAuthBlock;
 export type PortalExtensionComponent = Components.Schemas.PortalExtensionComponent;
 export type PortalExtensionConfig = Components.Schemas.PortalExtensionConfig;

package/dist/openapi.json

@@ -183,6 +183,70 @@
         }
       }
     },
+    "/v1/app-configurations/public": {
+      "get": {
+        "summary": "listPublicConfigurations",
+        "description": "List all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.",
+        "operationId": "listPublicConfigurations",
+        "tags": [
+          "App Configuration"
+        ],
+        "parameters": [
+          {
+            "name": "page",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 1
+            },
+            "description": "Page number for pagination"
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "default": 20
+            },
+            "description": "Number of items per page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of public app configurations",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "configurations": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/ConfigurationMetadata"
+                      }
+                    },
+                    "pagination": {
+                      "type": "object",
+                      "properties": {
+                        "total": {
+                          "type": "integer"
+                        },
+                        "page": {
+                          "type": "integer"
+                        },
+                        "pageSize": {
+                          "type": "integer"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/app-configurations/public/{appId}": {
       "parameters": [
         {
@@ -1762,6 +1826,7 @@
         "type": "string",
         "enum": [
           "CUSTOM_JOURNEY_BLOCK",
+          "CUSTOM_PORTAL_BLOCK",
           "PORTAL_EXTENSION",
           "CUSTOM_FLOW_ACTION",
           "ERP_INFORM_TOOLKIT",
@@ -1872,6 +1937,7 @@
               "propertyName": "component_type",
               "mapping": {
                 "CUSTOM_JOURNEY_BLOCK": "#/components/schemas/JourneyBlockComponent",
+                "CUSTOM_PORTAL_BLOCK": "#/components/schemas/PortalBlockComponent",
                 "PORTAL_EXTENSION": "#/components/schemas/PortalExtensionComponent",
                 "CUSTOM_FLOW_ACTION": "#/components/schemas/CustomFlowActionComponent",
                 "ERP_INFORM_TOOLKIT": "#/components/schemas/ErpInformToolkitComponent",
@@ -1883,6 +1949,9 @@
               {
                 "$ref": "#/components/schemas/JourneyBlockComponent"
               },
+              {
+                "$ref": "#/components/schemas/PortalBlockComponent"
+              },
               {
                 "$ref": "#/components/schemas/PortalExtensionComponent"
               },
@@ -1965,6 +2034,32 @@
           }
         }
       },
+      "PortalBlockComponent": {
+        "type": "object",
+        "required": [
+          "component_type",
+          "configuration"
+        ],
+        "properties": {
+          "component_type": {
+            "type": "string",
+            "enum": [
+              "CUSTOM_PORTAL_BLOCK"
+            ]
+          },
+          "configuration": {
+            "$ref": "#/components/schemas/PortalBlockConfig"
+          },
+          "surfaces": {
+            "type": "object",
+            "properties": {
+              "portal_block": {
+                "$ref": "#/components/schemas/PortalBlockSurfaceConfig"
+              }
+            }
+          }
+        }
+      },
       "ErpInformToolkitComponent": {
         "type": "object",
         "required": [
@@ -2150,7 +2245,7 @@
                 "propertyName": "type",
                 "mapping": {
                   "products": "#/components/schemas/ExternalProductCatalogHookProducts",
-                  "products-recommendation": "#/components/schemas/ExternalProductCatalogHookProductsRecommendation"
+                  "product-recommendations": "#/components/schemas/ExternalProductCatalogHookProductRecommendations"
                 }
               },
               "oneOf": [
@@ -2158,7 +2253,7 @@
                   "$ref": "#/components/schemas/ExternalProductCatalogHookProducts"
                 },
                 {
-                  "$ref": "#/components/schemas/ExternalProductCatalogHookProductsRecommendation"
+                  "$ref": "#/components/schemas/ExternalProductCatalogHookProductRecommendations"
                 }
               ]
             }
@@ -2218,10 +2313,7 @@
               "body": {
                 "type": "object",
                 "description": "JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               }
             },
             "required": [
@@ -2237,7 +2329,7 @@
         ],
         "additionalProperties": false
       },
-      "ExternalProductCatalogHookProductsRecommendation": {
+      "ExternalProductCatalogHookProductRecommendations": {
         "description": "Hook for getting product recommendations from an external catalog. This hook makes a call to retrieve product recommendations from an external source. Check the docs or the response API call contract https://docs.api.epilot.io/pricing-api-external-catalog for more details.\n",
         "type": "object",
         "properties": {
@@ -2252,7 +2344,7 @@
           "type": {
             "type": "string",
             "enum": [
-              "products-recommendation"
+              "product-recommendations"
             ]
           },
           "auth": {
@@ -2289,10 +2381,7 @@
               "body": {
                 "type": "object",
                 "description": "JSON body to use for the call. Supports variable interpolation. If empty / not provided, the default request context will be used based on the consumer (e.g. Journey).",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               }
             },
             "required": [
@@ -2434,7 +2523,7 @@
               },
               "result": {
                 "type": "string",
-                "description": "Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. Supports variable interpolation."
+                "description": "Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation."
               }
             },
             "required": [
@@ -2512,7 +2601,7 @@
               },
               "result": {
                 "type": "string",
-                "description": "Contract or Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. Supports variable interpolation."
+                "description": "Contract or Contact ID usually retrieved from the response body, e.g. `{{CallResponse.data.contact_id}}`. If no result is passed and the request suceeds, we attempt to resolve the Contact ID automatically. Supports variable interpolation."
               }
             },
             "required": [
@@ -2585,6 +2674,15 @@
               "meterReadingPlausibilityCheck"
             ]
           },
+          "plausibility_mode": {
+            "type": "string",
+            "enum": [
+              "check",
+              "range"
+            ],
+            "default": "check",
+            "description": "Mode for plausibility check:\n- \"check\": Validates meter reading and returns valid: boolean (used during submission)\n- \"range\": Returns min/max allowed values for each counter for validation before submission\n"
+          },
           "auth": {
             "$ref": "#/components/schemas/PortalExtensionAuthBlock"
           },
@@ -2598,10 +2696,7 @@
               "body": {
                 "type": "object",
                 "description": "JSON body to use for the call. Supports variable interpolation.",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               },
               "headers": {
                 "type": "object",
@@ -2623,9 +2718,24 @@
             "type": "object",
             "description": "Response to the call",
             "properties": {
+              "dataPath": {
+                "type": "string",
+                "description": "Optional path to an array in the response. If specified and the path points to an array,\nthe hook will map over each item using 'Item' variable for interpolation.\nRelevant only if plausibility_mode is \"range\".\n",
+                "example": "data.results"
+              },
+              "counter_identifiers": {
+                "description": "Counter identifier(s) used to match against the meter's counters.\nCan be a string (counter ID) or an object with counter properties.\nThe backend resolves this to meter_counter_id in the final response.\nRelevant only if plausibility_mode is \"range\".\n",
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "example": {
+                  "obis_code": "{{Item.obis}}"
+                }
+              },
               "valid": {
                 "type": "string",
-                "description": "Indicate whether the meter reading is plausible",
+                "description": "Indicate whether the meter reading is plausible. Relevant only if plausibility_mode is \"check\".",
                 "example": "{{CallResponse.data.valid}}"
               },
               "upper_limit": {
@@ -2720,10 +2830,7 @@
               "body": {
                 "type": "object",
                 "description": "Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               }
             },
             "required": [
@@ -2819,10 +2926,7 @@
               "body": {
                 "type": "object",
                 "description": "Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               }
             },
             "required": [
@@ -2918,10 +3022,7 @@
               "body": {
                 "type": "object",
                 "description": "Request body to send. Supports variable interpolation. Content format is determined by Content-Type header.",
-                "additionalProperties": {
-                  "type": "string"
-                },
-                "default": {}
+                "additionalProperties": true
               }
             },
             "required": [
@@ -3038,10 +3139,7 @@
           "body": {
             "type": "object",
             "description": "JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.",
-            "additionalProperties": {
-              "type": "string"
-            },
-            "default": {}
+            "additionalProperties": true
           },
           "cache": {
             "type": "object",
@@ -3100,10 +3198,7 @@
           "body": {
             "type": "object",
             "description": "JSON body to use for authentication. Supports variable interpolation. Content format is determined by Content-Type header.",
-            "additionalProperties": {
-              "type": "string"
-            },
-            "default": {}
+            "additionalProperties": true
           }
         },
         "required": [
@@ -3171,6 +3266,9 @@
           }
         }
       },
+      "PortalBlockConfig": {
+        "type": "object"
+      },
       "AppBridgeSurfaceConfig": {
         "type": "object",
         "properties": {
@@ -3188,6 +3286,26 @@
           }
         }
       },
+      "PortalBlockSurfaceConfig": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AppBridgeSurfaceConfig"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "section": {
+                "description": "Define which section of the portal this block can be placed in",
+                "type": "string",
+                "enum": [
+                  "main",
+                  "footer"
+                ]
+              }
+            }
+          }
+        ]
+      },
       "JourneyBlockComponentArgs": {
         "allOf": [
           {

package/package.json

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