@epilot/sdk 2.4.4 → 2.6.0

package/docs/notes.md

@@ -179,14 +179,17 @@ const { data } = await client.updateNote(
       }
     ],
     pinned_at: '1970-01-01T00:00:00.000Z',
-    created_by: {
-      type: 'user',
-      user_id: 'string',
-      display_name: 'string',
-      org_id: 'string',
-      email: 'string',
-      phone: 'string'
-    },
+    edited_at: '1970-01-01T00:00:00.000Z',
+    created_by: [
+      {
+        type: 'user',
+        user_id: 'string',
+        display_name: 'string',
+        org_id: 'string',
+        email: 'string',
+        phone: 'string'
+      }
+    ],
     read_by: ['string'],
     reactions: {}
   },
@@ -225,6 +228,7 @@ const { data } = await client.searchNotesByContext(
         id: 'string'
       }
     ],
+    include_related_schemas: ['string'],
     from: 0,
     size: 10
   },
@@ -476,14 +480,15 @@ type NotePatchRequestBody = {
     id: string
   }>
   pinned_at?: string // date-time
-  created_by?: {
+  edited_at?: string // date-time
+  created_by?: Array<{
     type: "user" | "group"
     user_id?: string
     display_name?: string
     org_id?: string
     email?: string
     phone?: string
-  }
+  }>
   read_by?: string[]
   reactions?: Record<string, string[]>
 }
@@ -561,14 +566,15 @@ type NotePutRequestBody = {
     id: string
   }>
   pinned_at?: string // date-time
-  created_by?: {
+  edited_at?: string // date-time
+  created_by?: Array<{
     type: "user" | "group"
     user_id?: string
     display_name?: string
     org_id?: string
     email?: string
     phone?: string
-  }
+  }>
   read_by?: string[]
   reactions?: Record<string, string[]>
 }
@@ -582,6 +588,7 @@ type NoteSearchByContextRequestBody = {
     type: "workflow_execution" | "workflow_task" | "workflow_configuration" | "journey_configuration" | "entity"
     id: string
   }>
+  include_related_schemas?: string[]
   from?: number
   size?: number
 }

package/docs/pricing.md

@@ -4659,10 +4659,11 @@ type RecurrenceAmount = {
 
 ### `CashbackAmount`
 
-An amount associated with a specific cashback period.
+A detail associated with a specific cashback.
 
 ```ts
 type CashbackAmount = {
+  cashback_name?: string
   cashback_period: "0" | "12"
   amount_total: number
 }
@@ -4726,6 +4727,7 @@ type TotalDetails = {
       before_discount_amount_subtotal_decimal?: { ... }
     }>
     cashbacks?: Array<{
+      cashback_name?: { ... }
       cashback_period: { ... }
       amount_total: { ... }
     }>

package/docs/webhooks.md

@@ -32,6 +32,7 @@ const { data } = await webhooksClient.getPublicKey(...)
 - [`getConfig`](#getconfig)
 - [`updateConfig`](#updateconfig)
 - [`deleteConfig`](#deleteconfig)
+- [`testOAuth`](#testoauth)
 - [`triggerWebhook`](#triggerwebhook)
 - [`batchReplayEvents`](#batchreplayevents)
 - [`getEventById`](#geteventbyid)
@@ -67,6 +68,7 @@ const { data } = await webhooksClient.getPublicKey(...)
 - [`WebhookEvent`](#webhookevent)
 - [`ExampleRequest`](#examplerequest)
 - [`ExampleResponse`](#exampleresponse)
+- [`TestOAuthResponse`](#testoauthresponse)
 - [`BatchReplayRequest`](#batchreplayrequest)
 
 ### `getPublicKey`
@@ -331,6 +333,34 @@ const { data } = await client.deleteConfig({
 
 ---
 
+### `testOAuth`
+
+Test OAuth connection
+
+`POST /v1/webhooks/configs/{configId}/test-oauth`
+
+```ts
+const { data } = await client.testOAuth({
+  configId: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "success": true,
+  "expires_in": 3600,
+  "token_type": "Bearer",
+  "message": "OAuth token exchange successful"
+}
+```
+
+</details>
+
+---
+
 ### `triggerWebhook`
 
 triggers a webhook event either async or sync
@@ -798,6 +828,7 @@ type WebhookConfig = {
   eventName: string
   url?: string
   creationTime?: string
+  updatedTime?: string
   httpMethod?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD"
   enabled?: boolean
   auth?: {
@@ -830,6 +861,7 @@ type WebhookConfig = {
     include_relations?: boolean
     include_activity?: boolean
     include_changed_attributes?: boolean
+    apply_changesets?: boolean
     custom_headers?: Record<string, string>
   }
   enableStaticIP?: boolean
@@ -840,6 +872,11 @@ type WebhookConfig = {
   }
   status?: "active" | "inactive" | "incomplete"
   jsonataExpression?: string
+  deliveryMode?: "json_base64" | "binary_multipart"
+  multipartConfig?: {
+    fileFieldName?: string
+    metadataFieldName?: string
+  }
   filterConditions?: {
     conditions?: Array<{
       field: { ... }
@@ -907,6 +944,7 @@ type PayloadConfiguration = {
   include_relations?: boolean
   include_activity?: boolean
   include_changed_attributes?: boolean
+  apply_changesets?: boolean
   custom_headers?: Record<string, string>
 }
 ```
@@ -1038,6 +1076,17 @@ type ExampleResponse = {
 }
 ```
 
+### `TestOAuthResponse`
+
+```ts
+type TestOAuthResponse = {
+  success: boolean
+  expires_in?: number
+  token_type?: string
+  message: string
+}
+```
+
 ### `BatchReplayRequest`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.4.4",
+  "version": "2.6.0",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/app-5KSVSKDU.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/app.json
-var app_default = '# App API\n\n- **Base URL:** `https://app.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/app](https://docs.epilot.io/api/app)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.app.getPublicFacingComponent(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/app\'\n\nconst appClient = getClient()\nauthorize(appClient, () => \'<token>\')\nconst { data } = await appClient.getPublicFacingComponent(...)\n```\n\n## Operations\n\n**App Installation**\n- [`getPublicFacingComponent`](#getpublicfacingcomponent)\n- [`listInstallations`](#listinstallations)\n- [`getInstallation`](#getinstallation)\n- [`install`](#install)\n- [`patchInstallation`](#patchinstallation)\n- [`uninstall`](#uninstall)\n- [`promoteVersion`](#promoteversion)\n\n**App Configuration**\n- [`listConfigurations`](#listconfigurations)\n- [`createConfiguration`](#createconfiguration)\n- [`listPublicConfigurations`](#listpublicconfigurations)\n- [`getPublicConfiguration`](#getpublicconfiguration)\n- [`getConfiguration`](#getconfiguration)\n- [`patchMetadata`](#patchmetadata)\n- [`deleteConfiguration`](#deleteconfiguration)\n- [`createBundleUploadUrl`](#createbundleuploadurl)\n- [`createZipUploadUrl`](#createzipuploadurl)\n- [`createLogoUploadUrl`](#createlogouploadurl)\n- [`deleteLogo`](#deletelogo)\n- [`listVersions`](#listversions)\n- [`getVersion`](#getversion)\n- [`deleteVersion`](#deleteversion)\n- [`patchVersion`](#patchversion)\n- [`getReview`](#getreview)\n- [`createReview`](#createreview)\n- [`createComponent`](#createcomponent)\n- [`patchComponent`](#patchcomponent)\n- [`deleteComponent`](#deletecomponent)\n- [`cloneVersion`](#cloneversion)\n\n**App Analytics**\n- [`queryEvents`](#queryevents)\n- [`ingestEvent`](#ingestevent)\n\n**Schemas**\n- [`Role`](#role)\n- [`Options`](#options)\n- [`Option`](#option)\n- [`OptionsRef`](#optionsref)\n- [`S3Reference`](#s3reference)\n- [`ComponentType`](#componenttype)\n- [`Author`](#author)\n- [`NotificationConfig`](#notificationconfig)\n- [`NotificationEvent`](#notificationevent)\n- [`BaseComponentCommon`](#basecomponentcommon)\n- [`BaseComponent`](#basecomponent)\n- [`CustomCapabilityComponent`](#customcapabilitycomponent)\n- [`CustomPageComponent`](#custompagecomponent)\n- [`CustomPageConfig`](#custompageconfig)\n- [`JourneyBlockComponent`](#journeyblockcomponent)\n- [`PortalBlockComponent`](#portalblockcomponent)\n- [`ErpInformToolkitComponent`](#erpinformtoolkitcomponent)\n- [`CustomFlowActionComponent`](#customflowactioncomponent)\n- [`BaseCustomActionConfig`](#basecustomactionconfig)\n- [`ExternalIntegrationCustomActionConfig`](#externalintegrationcustomactionconfig)\n- [`SandboxCustomActionConfig`](#sandboxcustomactionconfig)\n- [`CustomFlowConfig`](#customflowconfig)\n- [`ExternalProductCatalogComponent`](#externalproductcatalogcomponent)\n- [`ExternalProductCatalogConfig`](#externalproductcatalogconfig)\n- [`ExternalProductCatalogHookProducts`](#externalproductcataloghookproducts)\n- [`ExternalProductCatalogHookProductRecommendations`](#externalproductcataloghookproductrecommendations)\n- [`PortalExtensionComponent`](#portalextensioncomponent)\n- [`PortalExtensionConfig`](#portalextensionconfig)\n- [`PortalExtensionHookRegistrationIdentifiersCheck`](#portalextensionhookregistrationidentifierscheck)\n- [`PortalExtensionHookContractIdentification`](#portalextensionhookcontractidentification)\n- [`PortalExtensionHookMeterReadingPlausibilityCheck`](#portalextensionhookmeterreadingplausibilitycheck)\n- [`PortalExtensionHookPriceDataRetrieval`](#portalextensionhookpricedataretrieval)\n- [`PortalExtensionHookConsumptionDataRetrieval`](#portalextensionhookconsumptiondataretrieval)\n- [`PortalExtensionHookCostDataRetrieval`](#portalextensionhookcostdataretrieval)\n- [`PortalExtensionSeamlessLink`](#portalextensionseamlesslink)\n- [`PortalExtensionAuthBlock`](#portalextensionauthblock)\n- [`PortalExtensionSecureProxy`](#portalextensionsecureproxy)\n- [`ExternalProductCatalogAuthBlock`](#externalproductcatalogauthblock)\n- [`OverrideDevMode`](#overridedevmode)\n- [`JourneyBlockConfig`](#journeyblockconfig)\n- [`PortalBlockConfig`](#portalblockconfig)\n- [`AppBridgeSurfaceConfig`](#appbridgesurfaceconfig)\n- [`PortalBlockSurfaceConfig`](#portalblocksurfaceconfig)\n- [`JourneyBlockComponentArgs`](#journeyblockcomponentargs)\n- [`TextArg`](#textarg)\n- [`BooleanArg`](#booleanarg)\n- [`EnumArg`](#enumarg)\n- [`BillingFrequency`](#billingfrequency)\n- [`Pricing`](#pricing)\n- [`Audit`](#audit)\n- [`Review`](#review)\n- [`ConfigurationMetadata`](#configurationmetadata)\n- [`ConfigurationVersion`](#configurationversion)\n- [`Grants`](#grants)\n- [`BlueprintRef`](#blueprintref)\n- [`Installation`](#installation)\n- [`PublicConfiguration`](#publicconfiguration)\n- [`Configuration`](#configuration)\n- [`TranslatedString`](#translatedstring)\n- [`CallerIdentity`](#calleridentity)\n- [`BatchEventRequest`](#batcheventrequest)\n- [`Actor`](#actor)\n- [`AppEventData`](#appeventdata)\n- [`EventsQuery`](#eventsquery)\n- [`EventsQueryResponse`](#eventsqueryresponse)\n- [`RawEvents`](#rawevents)\n- [`AggregatedEvents`](#aggregatedevents)\n\n### `getPublicFacingComponent`\n\nRetrieve public facing components for an installed app\n\n`GET /v1/public/app/{appId}/components/{componentId}`\n\n```ts\nconst { data } = await client.getPublicFacingComponent({\n  appId: \'example\',\n  componentId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component": {\n    "component_type": "CUSTOM_JOURNEY_BLOCK",\n    "configuration": {\n      "override_dev_mode": {\n        "override_url": "http://localhost:3000"\n      },\n      "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n      "component_tag": "string",\n      "component_args": [\n        {\n          "type": "text"\n        }\n      ],\n      "component_size": 0,\n      "component_mapping": {}\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `listConfigurations`\n\nList all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.\n\n`GET /v1/app-configurations`\n\n```ts\nconst { data } = await client.listConfigurations({\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configurations": [\n    {\n      "app_id": "string",\n      "name": "string",\n      "author": {\n        "name": "string",\n        "company": "string",\n        "email": "string"\n      },\n      "dev_mode": true,\n      "versions": ["string"],\n      "public_versions": ["string"],\n      "support_email": "string",\n      "latest_version": "string",\n      "category": "string",\n      "icon_url": "string",\n      "documentation_url": "string",\n      "description": {\n        "en": "string",\n        "de": "string"\n      },\n      "notifications": {\n        "email": "developer@example.com",\n        "events": ["app.installed"]\n      },\n      "owner_org_id": "string",\n      "internal": false,\n      "pricing": {\n        "pricing_type": "FREE",\n        "billing_frequency": "MONTHLY"\n      },\n      "configuration_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `createConfiguration`\n\nCreate a new private app configuration. To make it public a verification process needs to be triggered\n\n`POST /v1/app-configurations`\n\n```ts\nconst { data } = await client.createConfiguration(\n  null,\n  {\n    name: \'string\',\n    description: {\n      en: \'string\',\n      de: \'string\'\n    },\n    category: \'string\',\n    logo_url_key: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string"\n}\n```\n\n</details>\n\n---\n\n### `listPublicConfigurations`\n\nList all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.\n\n`GET /v1/app-configurations/public`\n\n```ts\nconst { data } = await client.listPublicConfigurations({\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configurations": [\n    {\n      "app_id": "string",\n      "name": "string",\n      "author": {\n        "name": "string",\n        "company": "string",\n        "email": "string"\n      },\n      "dev_mode": true,\n      "versions": ["string"],\n      "public_versions": ["string"],\n      "support_email": "string",\n      "latest_version": "string",\n      "category": "string",\n      "icon_url": "string",\n      "documentation_url": "string",\n      "description": {\n        "en": "string",\n        "de": "string"\n      },\n      "notifications": {\n        "email": "developer@example.com",\n        "events": ["app.installed"]\n      },\n      "owner_org_id": "string",\n      "internal": false,\n      "pricing": {\n        "pricing_type": "FREE",\n        "billing_frequency": "MONTHLY"\n      },\n      "configuration_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getPublicConfiguration`\n\nRetrieve the public configuration of an app to install in your tenant\n\n`GET /v1/app-configurations/public/{appId}`\n\n```ts\nconst { data } = await client.getPublicConfiguration({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "support_email": "string",\n  "owner_org_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {}\n    }\n  ],\n  "is_beta": true,\n  "deprecated_at": "string",\n  "version": "string",\n  "role": {\n    "id": "string",\n    "grants": [\n      {}\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "latest_version": "string",\n  "public": true,\n  "versions": [\n    {\n      "app_id": "string",\n      "owner_org_id": "string",\n      "components": [],\n      "visibility": "private",\n      "public": false,\n      "pending": false,\n      "version": "string",\n      "is_beta": true,\n      "deprecated_at": "string",\n      "changelog": "string",\n      "review_status": "approved",\n      "role": {},\n      "blueprint_ref": {},\n      "version_audit": {}\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getConfiguration`\n\nRetrieve a specific app configuration\n\n`GET /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.getConfiguration({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "versions": ["string"],\n  "public_versions": ["string"],\n  "support_email": "string",\n  "latest_version": "string",\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "notifications": {\n    "email": "developer@example.com",\n    "events": ["app.installed"]\n  },\n  "owner_org_id": "string",\n  "internal": false,\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "configuration_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "visibility": "private",\n  "public": false,\n  "pending": false,\n  "version": "string",\n  "is_beta": true,\n  "deprecated_at": "string",\n  "changelog": "string",\n  "review_status": "approved",\n  "role": {\n    "id": "string",\n    "grants": [\n      {\n        "action": "string",\n        "resource": "string"\n      }\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "version_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string",\n    "versioned_at": "string",\n    "versioned_by": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `patchMetadata`\n\nPatch non-versioned configuration metadata of a given app configuration.\n\n`PATCH /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.patchMetadata(\n  {\n    appId: \'example\',\n  },\n  {\n    name: \'string\',\n    description: {\n      en: \'string\',\n      de: \'string\'\n    },\n    category: \'string\',\n    documentation_url: \'string\',\n    notifications: {\n      email: \'developer@example.com\',\n      events: [\'app.installed\']\n    },\n    pricing: {\n      pricing_type: \'FREE\',\n      billing_frequency: \'MONTHLY\'\n    },\n    logo_url_key: \'string\',\n    support_email: \'string\',\n    dev_mode: true\n  },\n)\n```\n\n---\n\n### `deleteConfiguration`\n\nDelete app configuration\n\n`DELETE /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.deleteConfiguration({\n  appId: \'example\',\n})\n```\n\n---\n\n### `queryEvents`\n\nQuery analytics events for a specific app with flexible filtering\n\n`POST /v1/app-configurations/{appId}/events`\n\n```ts\nconst { data } = await client.queryEvents(\n  {\n    appId: \'example\',\n  },\n  {\n    time_range: {\n      start: \'1970-01-01T00:00:00.000Z\',\n      end: \'1970-01-01T00:00:00.000Z\',\n      preset: \'1h\'\n    },\n    filters: {\n      source: [\'CUSTOM_JOURNEY_BLOCK\'],\n      component_id: [\'string\'],\n      event_type: [\'ERROR\'],\n      correlation_id: \'string\'\n    },\n    aggregation: {\n      group_by: [\'source\'],\n      metrics: [\'count\']\n    },\n    pagination: {\n      page: 1,\n      page_size: 100\n    },\n    sort: {\n      field: \'timestamp\',\n      order: \'desc\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "query": {\n    "time_range": {\n      "start": "1970-01-01T00:00:00.000Z",\n      "end": "1970-01-01T00:00:00.000Z",\n      "preset": "1h"\n    },\n    "filters": {\n      "source": ["CUSTOM_JOURNEY_BLOCK"],\n      "component_id": ["string"],\n      "event_type": ["ERROR"],\n      "correlation_id": "string"\n    },\n    "aggregation": {\n      "group_by": ["source"],\n      "metrics": ["count"]\n    },\n    "pagination": {\n      "page": 1,\n      "page_size": 100\n    },\n    "sort": {\n      "field": "timestamp",\n      "order": "desc"\n    }\n  },\n  "results": {\n    "type": "raw",\n    "events": [\n      {\n        "app_id": "string",\n        "version": "string",\n        "event_id": "string",\n        "component_id": "string",\n        "timestamp": "string",\n        "correlation_id": "string",\n        "event_type": "ERROR",\n        "source": "CUSTOM_JOURNEY_BLOCK",\n        "actor": {\n          "org_id": "string",\n          "user_id": "string",\n          "type": "user"\n        },\n        "details": {}\n      }\n    ]\n  },\n  "pagination": {\n    "page": 0,\n    "page_size": 0,\n    "total_items": 0,\n    "has_next": true\n  }\n}\n```\n\n</details>\n\n---\n\n### `createBundleUploadUrl`\n\nGenerate a presigned URL for uploading app bundle to /``<app-id>``/bundle.js path\n\n`POST /v1/app-configurations/{appId}/bundle`\n\n```ts\nconst { data } = await client.createBundleUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    component_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component_id": "string",\n  "component_url": "string",\n  "upload_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `createZipUploadUrl`\n\nGenerate a presigned URL to upload a zip file with artifacts that will be unpacked in a new directory under the /``<app-id>``/ path\n\n`POST /v1/app-configurations/{appId}/zip`\n\n```ts\nconst { data } = await client.createZipUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'1.0.0\',\n    component_id: \'string\',\n    filename: \'dist.zip\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component_id": "string",\n  "upload_url": "string",\n  "artifact_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `createLogoUploadUrl`\n\nGenerate a presigned URL for uploading app logo to /``<app-id>``/logo.png path\n\n`POST /v1/app-configurations/{appId}/logo`\n\n```ts\nconst { data } = await client.createLogoUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    filename: \'company-logo.png\',\n    mime_type: \'image/png\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "upload_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteLogo`\n\nDelete the app logo from /``<app-id>``/logo.png path\n\n`DELETE /v1/app-configurations/{appId}/logo`\n\n```ts\nconst { data } = await client.deleteLogo({\n  appId: \'example\',\n})\n```\n\n---\n\n### `listVersions`\n\nRetrieve a list of versions for an app configuration\n\n`GET /v1/app-configurations/{appId}/versions`\n\n```ts\nconst { data } = await client.listVersions({\n  appId: \'example\',\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "versions": [\n    {\n      "app_id": "string",\n      "owner_org_id": "string",\n      "components": [\n        {\n          "component_type": "CUSTOM_JOURNEY_BLOCK",\n          "configuration": {\n            "override_dev_mode": {\n              "override_url": "http://localhost:3000"\n            },\n            "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n            "component_tag": "string",\n            "component_args": [\n              {\n                "type": "text"\n              }\n            ],\n            "component_size": 0,\n            "component_mapping": {}\n          }\n        }\n      ],\n      "visibility": "private",\n      "public": false,\n      "pending": false,\n      "version": "string",\n      "is_beta": true,\n      "deprecated_at": "string",\n      "changelog": "string",\n      "review_status": "approved",\n      "role": {\n        "id": "string",\n        "grants": [\n          {\n            "action": "string",\n            "resource": "string"\n          }\n        ]\n      },\n      "blueprint_ref": {\n        "manifest_id": "string",\n        "job_id": "string",\n        "source_blueprint_file": "string"\n      },\n      "version_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string",\n        "versioned_at": "string",\n        "versioned_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getVersion`\n\nRetrieve a specific version of an app configuration\n\n`GET /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.getVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "versions": ["string"],\n  "public_versions": ["string"],\n  "support_email": "string",\n  "latest_version": "string",\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "notifications": {\n    "email": "developer@example.com",\n    "events": ["app.installed"]\n  },\n  "owner_org_id": "string",\n  "internal": false,\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "configuration_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "visibility": "private",\n  "public": false,\n  "pending": false,\n  "version": "string",\n  "is_beta": true,\n  "deprecated_at": "string",\n  "changelog": "string",\n  "review_status": "approved",\n  "role": {\n    "id": "string",\n    "grants": [\n      {\n        "action": "string",\n        "resource": "string"\n      }\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "version_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string",\n    "versioned_at": "string",\n    "versioned_by": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteVersion`\n\nDelete a specific version of an app configuration\n\n`DELETE /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.deleteVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n---\n\n### `patchVersion`\n\nPatch an existing app version\n\n`PATCH /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.patchVersion(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    manifest_id: \'string\',\n    role_id: \'string\',\n    grants: [\n      {\n        action: \'string\',\n        resource: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `getReview`\n\nRetrieve the review status of a specific app version\n\n`GET /v1/app-configurations/{appId}/versions/{version}/review`\n\n```ts\nconst { data } = await client.getReview({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "review": {\n    "version": "string",\n    "review_status": "approved",\n    "requested_at": "string",\n    "requested_by": "string",\n    "technical_contact": "string",\n    "marketing_contact": "string",\n    "demo_url": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createReview`\n\nSubmit an app version for review to make it public\n\n`POST /v1/app-configurations/{appId}/versions/{version}/review`\n\n```ts\nconst { data } = await client.createReview(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    technical_contact: \'string\',\n    marketing_contact: \'string\',\n    demo_url: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "review": {\n    "version": "string",\n    "review_status": "approved",\n    "requested_at": "string",\n    "requested_by": "string",\n    "technical_contact": "string",\n    "marketing_contact": "string",\n    "demo_url": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createComponent`\n\nPatch an existing app version to create/add a component\n\n`POST /v1/app-configurations/{appId}/versions/{version}/components`\n\n```ts\nconst { data } = await client.createComponent(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    component_type: \'CUSTOM_JOURNEY_BLOCK\',\n    configuration: {\n      override_dev_mode: {\n        override_url: \'http://localhost:3000\'\n      },\n      component_url: \'https://cdn.apps.com/123/v1.0.0/bundle.js\',\n      component_tag: \'string\',\n      component_args: [\n        {\n          type: \'text\'\n        }\n      ],\n      component_size: 0,\n      component_mapping: {}\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component": {\n    "component_type": "CUSTOM_JOURNEY_BLOCK",\n    "configuration": {\n      "override_dev_mode": {\n        "override_url": "http://localhost:3000"\n      },\n      "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n      "component_tag": "string",\n      "component_args": [\n        {\n          "type": "text"\n        }\n      ],\n      "component_size": 0,\n      "component_mapping": {}\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `patchComponent`\n\nPatch an existing app version to update its components\n\n`PATCH /v1/app-configurations/{appId}/versions/{version}/components/{componentId}`\n\n```ts\nconst { data } = await client.patchComponent(\n  {\n    appId: \'example\',\n    version: \'example\',\n    componentId: \'example\',\n  },\n  {\n    component_type: \'CUSTOM_JOURNEY_BLOCK\',\n    configuration: {\n      override_dev_mode: {\n        override_url: \'http://localhost:3000\'\n      },\n      component_url: \'https://cdn.apps.com/123/v1.0.0/bundle.js\',\n      component_tag: \'string\',\n      component_args: [\n        {\n          type: \'text\'\n        }\n      ],\n      component_size: 0,\n      component_mapping: {}\n    }\n  },\n)\n```\n\n---\n\n### `deleteComponent`\n\nDelete a specific component from an app version\n\n`DELETE /v1/app-configurations/{appId}/versions/{version}/components/{componentId}`\n\n```ts\nconst { data } = await client.deleteComponent({\n  appId: \'example\',\n  version: \'example\',\n  componentId: \'example\',\n})\n```\n\n---\n\n### `cloneVersion`\n\nClone an existing app version to create a new version\n\n`POST /v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}`\n\n```ts\nconst { data } = await client.cloneVersion({\n  appId: \'example\',\n  sourceVersion: \'example\',\n  targetVersion: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "version": "string",\n  "status": "pending"\n}\n```\n\n</details>\n\n---\n\n### `listInstallations`\n\nRetrieve a list of installed apps for the organization.\n\n`GET /v1/app`\n\n```ts\nconst { data } = await client.listInstallations({\n  componentType: \'example\',\n  enabled: true,\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "apps": [\n    {\n      "app_id": "string",\n      "installer_org_id": "string",\n      "owner_org_id": "string",\n      "enabled": true,\n      "name": "string",\n      "option_values": [\n        {\n          "component_id": "string",\n          "options": [\n            {\n              "key": "string",\n              "value": {}\n            }\n          ]\n        }\n      ],\n      "components": [\n        {\n          "component_type": "CUSTOM_JOURNEY_BLOCK",\n          "configuration": {\n            "override_dev_mode": {\n              "override_url": "http://localhost:3000"\n            },\n            "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n            "component_tag": "string",\n            "component_args": [\n              {\n                "type": "text"\n              }\n            ],\n            "component_size": 0,\n            "component_mapping": {}\n          }\n        }\n      ],\n      "installed_version": "string",\n      "role": "string",\n      "blueprint_ref": {\n        "manifest_id": "string",\n        "job_id": "string",\n        "source_blueprint_file": "string"\n      },\n      "installation_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      },\n      "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getInstallation`\n\nRetrieve details of an installed app by its ID.\n\n`GET /v1/app/{appId}`\n\n```ts\nconst { data } = await client.getInstallation({\n  appId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `install`\n\nUpsert app installation by its ID.\n\n`POST /v1/app/{appId}`\n\n```ts\nconst { data } = await client.install(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    option_values: [\n      {\n        component_id: \'string\',\n        options: [\n          {\n            key: \'string\',\n            value: {}\n          }\n        ]\n      }\n    ],\n    _manifest: [\'123e4567-e89b-12d3-a456-426614174000\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `patchInstallation`\n\nPatch an installed app by its ID.\n\n`PATCH /v1/app/{appId}`\n\n```ts\nconst { data } = await client.patchInstallation(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    option_values: [\n      {\n        component_id: \'string\',\n        options: [\n          {\n            key: \'string\',\n            value: {}\n          }\n        ]\n      }\n    ],\n    _manifest: [\'123e4567-e89b-12d3-a456-426614174000\']\n  },\n)\n```\n\n---\n\n### `uninstall`\n\nUninstall an app by its ID.\n\n`DELETE /v1/app/{appId}`\n\n```ts\nconst { data } = await client.uninstall({\n  appId: \'example\',\n})\n```\n\n---\n\n### `promoteVersion`\n\nUpdate an installed app to a new version\n\n`POST /v1/app/{appId}/promote-to/{version}`\n\n```ts\nconst { data } = await client.promoteVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `ingestEvent`\n\nInternal endpoint for services to submit app events for analytic purposes\n\n`POST /v1/app-events`\n\n```ts\nconst { data } = await client.ingestEvent(\n  null,\n  {\n    app_id: \'string\',\n    version: \'string\',\n    event_id: \'string\',\n    component_id: \'string\',\n    timestamp: \'string\',\n    correlation_id: \'string\',\n    event_type: \'ERROR\',\n    source: \'CUSTOM_JOURNEY_BLOCK\',\n    actor: {\n      org_id: \'string\',\n      user_id: \'string\',\n      type: \'user\'\n    },\n    details: {}\n  },\n)\n```\n\n---\n\n## Schemas\n\n### `Role`\n\n```ts\ntype Role = {\n  id?: string\n  grants?: Array<{\n    action: string\n    resource?: string\n  }>\n}\n```\n\n### `Options`\n\nOptions for the component configuration\n\n```ts\ntype Options = {\n  key: string\n  label?: string\n  required?: boolean\n  description?: string\n  value?: unknown\n  type: "text" | "number" | "boolean" | "secret"\n}\n```\n\n### `Option`\n\n```ts\ntype Option = {\n  key: string\n  value: unknown\n}\n```\n\n### `OptionsRef`\n\n```ts\ntype OptionsRef = {\n  component_id: string\n  options: Array<{\n    key: string\n    value: unknown\n  }>\n}\n```\n\n### `S3Reference`\n\n```ts\ntype S3Reference = {\n  bucket: string\n  key: string\n}\n```\n\n### `ComponentType`\n\nType of app component\n\n```ts\ntype ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n```\n\n### `Author`\n\n```ts\ntype Author = {\n  name?: string\n  company: string\n  email?: string\n}\n```\n\n### `NotificationConfig`\n\n```ts\ntype NotificationConfig = {\n  email?: string // email\n  events?: "app.installed" | "app.uninstalled"[]\n}\n```\n\n### `NotificationEvent`\n\n```ts\ntype NotificationEvent = "app.installed" | "app.uninstalled"\n```\n\n### `BaseComponentCommon`\n\n```ts\ntype BaseComponentCommon = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  options?: Array<{\n    key: string\n    label?: string\n    required?: boolean\n    description?: string\n    value?: unknown\n    type: "text" | "number" | "boolean" | "secret"\n  }>\n  surfaces?: object\n}\n```\n\n### `BaseComponent`\n\n```ts\ntype BaseComponent = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  options?: Array<{\n    key: string\n    label?: string\n    required?: boolean\n    description?: string\n    value?: unknown\n    type: "text" | "number" | "boolean" | "secret"\n  }>\n  surfaces?: object\n}\n```\n\n### `CustomCapabilityComponent`\n\n```ts\ntype CustomCapabilityComponent = {\n  component_type: "CUSTOM_CAPABILITY"\n  configuration: {\n    type?: "tab" | "group"\n    allowed_schemas?: string[]\n  }\n  surfaces?: {\n    capability_config?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `CustomPageComponent`\n\n```ts\ntype CustomPageComponent = {\n  component_type: "CUSTOM_PAGE"\n  configuration: {\n    slug: string\n    nav_label?: string\n    nav_icon?: string\n    nav_description?: string\n  }\n  surfaces?: {\n    page?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `CustomPageConfig`\n\n```ts\ntype CustomPageConfig = {\n  slug: string\n  nav_label?: string\n  nav_icon?: string\n  nav_description?: string\n}\n```\n\n### `JourneyBlockComponent`\n\n```ts\ntype JourneyBlockComponent = {\n  component_type: "CUSTOM_JOURNEY_BLOCK"\n  configuration: {\n    override_dev_mode?: {\n      override_url?: { ... }\n    }\n    component_url: string\n    component_tag: string\n    component_args?: Array<{\n      key: { ... }\n      type: { ... }\n      required?: { ... }\n      description?: { ... }\n      label: { ... }\n    }>\n    component_size?: number\n    component_mapping?: Record<string, "string" | "boolean" | "date" | "datetime" | "link" | "number">\n  }\n}\n```\n\n### `PortalBlockComponent`\n\n```ts\ntype PortalBlockComponent = {\n  component_type: "CUSTOM_PORTAL_BLOCK"\n  configuration: object\n  surfaces?: {\n    portal_block?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n      supported_surfaces?: { ... }\n    }\n  }\n}\n```\n\n### `ErpInformToolkitComponent`\n\n```ts\ntype ErpInformToolkitComponent = {\n  component_type: "ERP_INFORM_TOOLKIT"\n  configuration: {\n    type: "inbound" | "outbound"\n  }\n}\n```\n\n### `CustomFlowActionComponent`\n\n```ts\ntype CustomFlowActionComponent = {\n  component_type: "CUSTOM_FLOW_ACTION"\n  configuration: {\n    name?: string\n    description?: string\n    wait_for_callback?: boolean\n    type: "external_integration"\n    external_integration_settings?: {\n      url?: { ... }\n      headers?: { ... }\n    }\n  } | {\n    name?: string\n    description?: string\n    wait_for_callback?: boolean\n    type: "sandbox"\n    sandbox_settings?: {\n      code?: { ... }\n    }\n  }\n  surfaces?: {\n    flow_action_config?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `BaseCustomActionConfig`\n\n```ts\ntype BaseCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n}\n```\n\n### `ExternalIntegrationCustomActionConfig`\n\n```ts\ntype ExternalIntegrationCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "external_integration"\n  external_integration_settings?: {\n    url?: string\n    headers?: Record<string, unknown>\n  }\n}\n```\n\n### `SandboxCustomActionConfig`\n\n```ts\ntype SandboxCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "sandbox"\n  sandbox_settings?: {\n    code?: string\n  }\n}\n```\n\n### `CustomFlowConfig`\n\n```ts\ntype CustomFlowConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "external_integration"\n  external_integration_settings?: {\n    url?: string\n    headers?: Record<string, unknown>\n  }\n} | {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "sandbox"\n  sandbox_settings?: {\n    code?: string\n  }\n}\n```\n\n### `ExternalProductCatalogComponent`\n\n```ts\ntype ExternalProductCatalogComponent = {\n  component_type: "EXTERNAL_PRODUCT_CATALOG"\n  configuration: {\n    hooks?: Array<{\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n    }>\n  }\n}\n```\n\n### `ExternalProductCatalogConfig`\n\n```ts\ntype ExternalProductCatalogConfig = {\n  hooks?: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "products"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "product-recommendations"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n  }>\n}\n```\n\n### `ExternalProductCatalogHookProducts`\n\nHook 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.\n\n\n```ts\ntype ExternalProductCatalogHookProducts = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "products"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n}\n```\n\n### `ExternalProductCatalogHookProductRecommendations`\n\nHook 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\n\n```ts\ntype ExternalProductCatalogHookProductRecommendations = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "product-recommendations"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n}\n```\n\n### `PortalExtensionComponent`\n\n```ts\ntype PortalExtensionComponent = {\n  component_type: "PORTAL_EXTENSION"\n  configuration: {\n    hooks?: Array<{\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n      assignment_mode?: { ... }\n      contact_relation_attribute?: { ... }\n      explanation?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      plausibility_mode?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    }>\n    links?: Array<{\n      id: { ... }\n      name: { ... }\n      description?: { ... }\n      type: { ... }\n      condition?: { ... }\n      auth?: { ... }\n      redirect: { ... }\n    }>\n  }\n}\n```\n\n### `PortalExtensionConfig`\n\n```ts\ntype PortalExtensionConfig = {\n  hooks?: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "registrationIdentifiersCheck"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers: { ... }\n      body?: { ... }\n      result: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "contractIdentification"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers: { ... }\n      body?: { ... }\n      result?: { ... }\n    }\n    assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user"\n    contact_relation_attribute?: string\n    explanation?: {\n      en: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "priceDataRetrieval"\n    intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    resolved?: {\n      dataPath?: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "consumptionDataRetrieval"\n  // ...\n}\n```\n\n### `PortalExtensionHookRegistrationIdentifiersCheck`\n\nHook that replaces the built-in registration identifiers check. This hook makes a POST call whenever a user is trying to register to find the corresponding contact. The expected response to the call is:\n  - 200 with contact id if exactly one contact is found\n  - 404 if no contact is found or more th\n\n```ts\ntype PortalExtensionHookRegistrationIdentifiersCheck = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "registrationIdentifiersCheck"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers: Record<string, string>\n    body?: object\n    result: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookContractIdentification`\n\nHook 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 suppo\n\n```ts\ntype PortalExtensionHookContractIdentification = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "contractIdentification"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers: Record<string, string>\n    body?: object\n    result?: string\n  }\n  assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user"\n  contact_relation_attribute?: string\n  explanation?: {\n    en: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookMeterReadingPlausibilityCheck`\n\nHook that checks the plausibility of meter readings before they are saved. This hook makes a POST call whenever a user is trying to save a meter reading. The expected response to the call is:\n  - 200:\n    If meter reading is plausible, the response should contain:\n      - valid: true\n    If meter re\n\n```ts\ntype PortalExtensionHookMeterReadingPlausibilityCheck = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "meterReadingPlausibilityCheck"\n  plausibility_mode?: "check" | "range"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    url: string\n    body: Record<string, unknown>\n    headers: Record<string, string>\n  }\n  resolved: {\n    dataPath?: string\n    counter_identifiers?: Record<string, string>\n    valid?: string\n    upper_limit?: string\n    lower_limit?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookPriceDataRetrieval`\n\nHook that will allow using the specified source as data for price visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookPriceDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "priceDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookConsumptionDataRetrieval`\n\nHook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookConsumptionDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "consumptionDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookCostDataRetrieval`\n\nHook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookCostDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "costDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionSeamlessLink`\n\n```ts\ntype PortalExtensionSeamlessLink = {\n  id: string\n  name: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  type: "seamless"\n  condition?: string\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  redirect: {\n    url?: string\n    params?: Record<string, string>\n  }\n}\n```\n\n### `PortalExtensionAuthBlock`\n\n```ts\ntype PortalExtensionAuthBlock = {\n  method?: string\n  url: string\n  params?: Record<string, string>\n  headers?: Record<string, string>\n  body?: Record<string, unknown>\n  cache?: {\n    key: string\n    ttl: string\n  }\n}\n```\n\n### `PortalExtensionSecureProxy`\n\nIf set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips.\n\n```ts\ntype PortalExtensionSecureProxy = {\n  integration_id: string // uuid\n  use_case_slug: string\n}\n```\n\n### `ExternalProductCatalogAuthBlock`\n\n```ts\ntype ExternalProductCatalogAuthBlock = {\n  method?: string\n  url: string\n  params?: Record<string, string>\n  headers?: Record<string, string>\n  body?: Record<string, unknown>\n}\n```\n\n### `OverrideDevMode`\n\nOverride URL when app is in dev mode\n\n```ts\ntype OverrideDevMode = {\n  override_url?: string\n}\n```\n\n### `JourneyBlockConfig`\n\n```ts\ntype JourneyBlockConfig = {\n  override_dev_mode?: {\n    override_url?: string\n  }\n  component_url: string\n  component_tag: string\n  component_args?: Array<{\n    key: string\n    type: "text" | "boolean" | "enum"\n    required?: boolean\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    label: {\n      en?: { ... }\n      de: { ... }\n    }\n  }>\n  component_size?: number\n  component_mapping?: Record<string, "string" | "boolean" | "date" | "datetime" | "link" | "number">\n}\n```\n\n### `PortalBlockConfig`\n\n```ts\ntype PortalBlockConfig = object\n```\n\n### `AppBridgeSurfaceConfig`\n\n```ts\ntype AppBridgeSurfaceConfig = {\n  app_url?: string\n  zip_url?: string\n  override_url?: string\n}\n```\n\n### `PortalBlockSurfaceConfig`\n\n```ts\ntype PortalBlockSurfaceConfig = {\n  app_url?: string\n  zip_url?: string\n  override_url?: string\n  supported_surfaces?: "main" | "footer_inline" | "footer_left_absolute" | "footer_right_absolute"[]\n}\n```\n\n### `JourneyBlockComponentArgs`\n\n```ts\ntype JourneyBlockComponentArgs = {\n  key: string\n  type: "text" | "boolean" | "enum"\n  required?: boolean\n  description?: {\n    en?: string\n    de: string\n  }\n  label: {\n    en?: string\n    de: string\n  }\n}\n```\n\n### `TextArg`\n\n```ts\ntype TextArg = {\n  type?: "text"\n}\n```\n\n### `BooleanArg`\n\n```ts\ntype BooleanArg = {\n  type?: "boolean"\n}\n```\n\n### `EnumArg`\n\n```ts\ntype EnumArg = {\n  type?: "enum"\n  isMulti?: boolean\n  options: Array<{\n    id: string\n    label: {\n      en?: { ... }\n      de: { ... }\n    }\n  }>\n}\n```\n\n### `BillingFrequency`\n\nHow often the subscription is billed\n\n```ts\ntype BillingFrequency = "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n```\n\n### `Pricing`\n\n```ts\ntype Pricing = {\n  pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n  billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n}\n```\n\n### `Audit`\n\n```ts\ntype Audit = {\n  created_at?: string\n  created_by?: string\n  updated_at?: string\n  updated_by?: string\n}\n```\n\n### `Review`\n\n```ts\ntype Review = {\n  version?: string\n  review_status?: "approved" | "rejected" | "pending"\n  requested_at?: string\n  requested_by?: string\n  technical_contact?: string\n  marketing_contact?: string\n  demo_url?: string\n}\n```\n\n### `ConfigurationMetadata`\n\nBasic metadata about your app configuration which does not get versioned\n\n```ts\ntype ConfigurationMetadata = {\n  app_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  versions: string[]\n  public_versions?: string[]\n  support_email?: string\n  latest_version: string\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description: {\n    en?: string\n    de: string\n  }\n  notifications?: {\n    email?: string // email\n    events?: "app.installed" | "app.uninstalled"[]\n  }\n  owner_org_id: string\n  internal?: boolean\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  configuration_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n}\n```\n\n### `ConfigurationVersion`\n\nConfiguration data about your app which is versionable\n\n```ts\ntype ConfigurationVersion = {\n  app_id: string\n  owner_org_id: string\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  visibility?: "public" | "private"\n  public?: boolean\n  pending?: boolean\n  version: string\n  is_beta?: boolean\n  deprecated_at?: string\n  changelog?: string\n  review_status?: "approved" | "rejected" | "pending"\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  version_audit: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n    versioned_at?: string\n    versioned_by?: string\n  }\n}\n```\n\n### `Grants`\n\nRequired grants for the app in order to call APIs for the installing tenant\n\n```ts\ntype Grants = Array<{\n  action: string\n  resource?: string\n}>\n```\n\n### `BlueprintRef`\n\n```ts\ntype BlueprintRef = {\n  manifest_id?: string\n  job_id?: string\n  source_blueprint_file?: string\n}\n```\n\n### `Installation`\n\nInformation about the installed app. Has configuration data of the installed version\n\n```ts\ntype Installation = {\n  app_id: string\n  installer_org_id: string\n  owner_org_id?: string\n  enabled: boolean\n  name: string\n  option_values?: Array<{\n    component_id: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }>\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  installed_version: string\n  role?: string\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  installation_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n  _manifest?: string // uuid[]\n}\n```\n\n### `PublicConfiguration`\n\nPublic configuration of the published app\n\n```ts\ntype PublicConfiguration = {\n  app_id: string\n  support_email?: string\n  owner_org_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description?: {\n    en?: string\n    de: string\n  }\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  is_beta?: boolean\n  deprecated_at?: string\n  version: string\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  latest_version?: string\n  public?: boolean\n  versions?: Array<{\n    app_id: string\n    owner_org_id: string\n    components: Array<{\n      id: { ... }\n      name?: { ... }\n      description?: { ... }\n      options?: { ... }\n      surfaces?: { ... }\n    }>\n    visibility?: "public" | "private"\n    public?: boolean\n    pending?: boolean\n    version: string\n    is_beta?: boolean\n    deprecated_at?: string\n    changelog?: string\n    review_status?: "approved" | "rejected" | "pending"\n    role?: {\n      id?: { ... }\n      grants?: { ... }\n    }\n    blueprint_ref?: {\n      manifest_id?: { ... }\n      job_id?: { ... }\n      source_blueprint_file?: { ... }\n    }\n    version_audit: {\n      created_at?: { ... }\n      created_by?: { ... }\n      updated_at?: { ... }\n      updated_by?: { ... }\n      versioned_at?: { ... }\n      versioned_by?: { ... }\n    }\n  }>\n}\n```\n\n### `Configuration`\n\nConfiguration of the published app\n\n```ts\ntype Configuration = {\n  app_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  versions: string[]\n  public_versions?: string[]\n  support_email?: string\n  latest_version: string\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description: {\n    en?: string\n    de: string\n  }\n  notifications?: {\n    email?: string // email\n    events?: "app.installed" | "app.uninstalled"[]\n  }\n  owner_org_id: string\n  internal?: boolean\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  configuration_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  visibility?: "public" | "private"\n  public?: boolean\n  pending?: boolean\n  version: string\n  is_beta?: boolean\n  deprecated_at?: string\n  changelog?: string\n  review_status?: "approved" | "rejected" | "pending"\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  version_audit: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n    versioned_at?: string\n    versioned_by?: string\n  }\n}\n```\n\n### `TranslatedString`\n\n```ts\ntype TranslatedString = {\n  en?: string\n  de: string\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name?: unknown\n  org_id: string\n  user_id?: string\n  token_id?: string\n}\n```\n\n### `BatchEventRequest`\n\n```ts\ntype BatchEventRequest = {\n  events: Array<{\n    app_id: string\n    version: string\n    event_id?: string\n    component_id: string\n    timestamp?: string\n    correlation_id?: string\n    event_type: "ERROR" | "WARNING" | "INFO"\n    source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n    actor: {\n      org_id?: { ... }\n      user_id?: { ... }\n      type: { ... }\n    }\n    details?: Record<string, unknown>\n  }>\n}\n```\n\n### `Actor`\n\n```ts\ntype Actor = {\n  org_id?: string\n  user_id?: string\n  type: "user" | "system"\n}\n```\n\n### `AppEventData`\n\n```ts\ntype AppEventData = {\n  app_id: string\n  version: string\n  event_id?: string\n  component_id: string\n  timestamp?: string\n  correlation_id?: string\n  event_type: "ERROR" | "WARNING" | "INFO"\n  source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n  actor: {\n    org_id?: string\n    user_id?: string\n    type: "user" | "system"\n  }\n  details?: Record<string, unknown>\n}\n```\n\n### `EventsQuery`\n\n```ts\ntype EventsQuery = {\n  time_range?: {\n    start?: string // date-time\n    end?: string // date-time\n    preset?: "1h" | "6h" | "24h" | "7d" | "30d"\n  }\n  filters?: {\n    source?: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"[]\n    component_id?: string[]\n    event_type?: "ERROR" | "WARNING" | "INFO"[]\n    correlation_id?: string\n  }\n  aggregation?: {\n    group_by?: "source" | "component_id" | "event_type" | "hour" | "day"[]\n    metrics?: "count" | "error_rate" | "unique_users"[]\n  }\n  pagination?: {\n    page?: number\n    page_size?: number\n  }\n  sort?: {\n    field?: "timestamp" | "event_type" | "component_id"\n    order?: "asc" | "desc"\n  }\n}\n```\n\n### `EventsQueryResponse`\n\n```ts\ntype EventsQueryResponse = {\n  query?: {\n    time_range?: {\n      start?: { ... }\n      end?: { ... }\n      preset?: { ... }\n    }\n    filters?: {\n      source?: { ... }\n      component_id?: { ... }\n      event_type?: { ... }\n      correlation_id?: { ... }\n    }\n    aggregation?: {\n      group_by?: { ... }\n      metrics?: { ... }\n    }\n    pagination?: {\n      page?: { ... }\n      page_size?: { ... }\n    }\n    sort?: {\n      field?: { ... }\n      order?: { ... }\n    }\n  }\n  results?: {\n    type?: "raw"\n    events?: Array<{\n      app_id: { ... }\n      version: { ... }\n      event_id?: { ... }\n      component_id: { ... }\n      timestamp?: { ... }\n      correlation_id?: { ... }\n      event_type: { ... }\n      source: { ... }\n      actor: { ... }\n      details?: { ... }\n    }>\n  } | {\n    type?: "aggregated"\n    groups?: Array<{\n      dimensions?: { ... }\n      metrics?: { ... }\n    }>\n  }\n  pagination?: {\n    page?: number\n    page_size?: number\n    total_items?: number\n    has_next?: boolean\n  }\n}\n```\n\n### `RawEvents`\n\n```ts\ntype RawEvents = {\n  type?: "raw"\n  events?: Array<{\n    app_id: string\n    version: string\n    event_id?: string\n    component_id: string\n    timestamp?: string\n    correlation_id?: string\n    event_type: "ERROR" | "WARNING" | "INFO"\n    source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n    actor: {\n      org_id?: { ... }\n      user_id?: { ... }\n      type: { ... }\n    }\n    details?: Record<string, unknown>\n  }>\n}\n```\n\n### `AggregatedEvents`\n\n```ts\ntype AggregatedEvents = {\n  type?: "aggregated"\n  groups?: Array<{\n    dimensions?: Record<string, unknown>\n    metrics?: {\n      count?: { ... }\n      error_rate?: { ... }\n    }\n  }>\n}\n```\n';
-export {
-  app_default as default
-};

package/dist/app-PL3IOROO.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/app.json
-var app_default = '# App API\n\n- **Base URL:** `https://app.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/app](https://docs.epilot.io/api/app)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.app.getPublicFacingComponent(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/app\'\n\nconst appClient = getClient()\nauthorize(appClient, () => \'<token>\')\nconst { data } = await appClient.getPublicFacingComponent(...)\n```\n\n## Operations\n\n**App Installation**\n- [`getPublicFacingComponent`](#getpublicfacingcomponent)\n- [`listInstallations`](#listinstallations)\n- [`getInstallation`](#getinstallation)\n- [`install`](#install)\n- [`patchInstallation`](#patchinstallation)\n- [`uninstall`](#uninstall)\n- [`promoteVersion`](#promoteversion)\n\n**App Configuration**\n- [`listConfigurations`](#listconfigurations)\n- [`createConfiguration`](#createconfiguration)\n- [`listPublicConfigurations`](#listpublicconfigurations)\n- [`getPublicConfiguration`](#getpublicconfiguration)\n- [`getConfiguration`](#getconfiguration)\n- [`patchMetadata`](#patchmetadata)\n- [`deleteConfiguration`](#deleteconfiguration)\n- [`createBundleUploadUrl`](#createbundleuploadurl)\n- [`createZipUploadUrl`](#createzipuploadurl)\n- [`createLogoUploadUrl`](#createlogouploadurl)\n- [`deleteLogo`](#deletelogo)\n- [`listVersions`](#listversions)\n- [`getVersion`](#getversion)\n- [`deleteVersion`](#deleteversion)\n- [`patchVersion`](#patchversion)\n- [`getReview`](#getreview)\n- [`createReview`](#createreview)\n- [`createComponent`](#createcomponent)\n- [`patchComponent`](#patchcomponent)\n- [`deleteComponent`](#deletecomponent)\n- [`cloneVersion`](#cloneversion)\n\n**App Analytics**\n- [`queryEvents`](#queryevents)\n- [`ingestEvent`](#ingestevent)\n\n**Schemas**\n- [`Role`](#role)\n- [`Options`](#options)\n- [`Option`](#option)\n- [`OptionsRef`](#optionsref)\n- [`S3Reference`](#s3reference)\n- [`ComponentType`](#componenttype)\n- [`Author`](#author)\n- [`NotificationConfig`](#notificationconfig)\n- [`NotificationEvent`](#notificationevent)\n- [`BaseComponentCommon`](#basecomponentcommon)\n- [`BaseComponent`](#basecomponent)\n- [`CustomCapabilityComponent`](#customcapabilitycomponent)\n- [`CustomPageComponent`](#custompagecomponent)\n- [`CustomPageConfig`](#custompageconfig)\n- [`JourneyBlockComponent`](#journeyblockcomponent)\n- [`PortalBlockComponent`](#portalblockcomponent)\n- [`ErpInformToolkitComponent`](#erpinformtoolkitcomponent)\n- [`CustomFlowActionComponent`](#customflowactioncomponent)\n- [`BaseCustomActionConfig`](#basecustomactionconfig)\n- [`ExternalIntegrationCustomActionConfig`](#externalintegrationcustomactionconfig)\n- [`SandboxCustomActionConfig`](#sandboxcustomactionconfig)\n- [`CustomFlowConfig`](#customflowconfig)\n- [`ExternalProductCatalogComponent`](#externalproductcatalogcomponent)\n- [`ExternalProductCatalogConfig`](#externalproductcatalogconfig)\n- [`ExternalProductCatalogHookProducts`](#externalproductcataloghookproducts)\n- [`ExternalProductCatalogHookProductRecommendations`](#externalproductcataloghookproductrecommendations)\n- [`PortalExtensionComponent`](#portalextensioncomponent)\n- [`PortalExtensionConfig`](#portalextensionconfig)\n- [`PortalExtensionHookRegistrationIdentifiersCheck`](#portalextensionhookregistrationidentifierscheck)\n- [`PortalExtensionHookContractIdentification`](#portalextensionhookcontractidentification)\n- [`PortalExtensionHookMeterReadingPlausibilityCheck`](#portalextensionhookmeterreadingplausibilitycheck)\n- [`PortalExtensionHookPriceDataRetrieval`](#portalextensionhookpricedataretrieval)\n- [`PortalExtensionHookConsumptionDataRetrieval`](#portalextensionhookconsumptiondataretrieval)\n- [`PortalExtensionHookCostDataRetrieval`](#portalextensionhookcostdataretrieval)\n- [`PortalExtensionSeamlessLink`](#portalextensionseamlesslink)\n- [`PortalExtensionAuthBlock`](#portalextensionauthblock)\n- [`PortalExtensionSecureProxy`](#portalextensionsecureproxy)\n- [`ExternalProductCatalogAuthBlock`](#externalproductcatalogauthblock)\n- [`OverrideDevMode`](#overridedevmode)\n- [`JourneyBlockConfig`](#journeyblockconfig)\n- [`PortalBlockConfig`](#portalblockconfig)\n- [`AppBridgeSurfaceConfig`](#appbridgesurfaceconfig)\n- [`PortalBlockSurfaceConfig`](#portalblocksurfaceconfig)\n- [`JourneyBlockComponentArgs`](#journeyblockcomponentargs)\n- [`TextArg`](#textarg)\n- [`BooleanArg`](#booleanarg)\n- [`EnumArg`](#enumarg)\n- [`BillingFrequency`](#billingfrequency)\n- [`Pricing`](#pricing)\n- [`Audit`](#audit)\n- [`Review`](#review)\n- [`ConfigurationMetadata`](#configurationmetadata)\n- [`ConfigurationVersion`](#configurationversion)\n- [`Grants`](#grants)\n- [`BlueprintRef`](#blueprintref)\n- [`Installation`](#installation)\n- [`PublicConfiguration`](#publicconfiguration)\n- [`Configuration`](#configuration)\n- [`TranslatedString`](#translatedstring)\n- [`CallerIdentity`](#calleridentity)\n- [`BatchEventRequest`](#batcheventrequest)\n- [`Actor`](#actor)\n- [`AppEventData`](#appeventdata)\n- [`EventsQuery`](#eventsquery)\n- [`EventsQueryResponse`](#eventsqueryresponse)\n- [`RawEvents`](#rawevents)\n- [`AggregatedEvents`](#aggregatedevents)\n\n### `getPublicFacingComponent`\n\nRetrieve public facing components for an installed app\n\n`GET /v1/public/app/{appId}/components/{componentId}`\n\n```ts\nconst { data } = await client.getPublicFacingComponent({\n  appId: \'example\',\n  componentId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component": {\n    "component_type": "CUSTOM_JOURNEY_BLOCK",\n    "configuration": {\n      "override_dev_mode": {\n        "override_url": "http://localhost:3000"\n      },\n      "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n      "component_tag": "string",\n      "component_args": [\n        {\n          "type": "text"\n        }\n      ],\n      "component_size": 0,\n      "component_mapping": {}\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `listConfigurations`\n\nList all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.\n\n`GET /v1/app-configurations`\n\n```ts\nconst { data } = await client.listConfigurations({\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configurations": [\n    {\n      "app_id": "string",\n      "name": "string",\n      "author": {\n        "name": "string",\n        "company": "string",\n        "email": "string"\n      },\n      "dev_mode": true,\n      "versions": ["string"],\n      "public_versions": ["string"],\n      "support_email": "string",\n      "latest_version": "string",\n      "category": "string",\n      "icon_url": "string",\n      "documentation_url": "string",\n      "description": {\n        "en": "string",\n        "de": "string"\n      },\n      "notifications": {\n        "email": "developer@example.com",\n        "events": ["app.installed"]\n      },\n      "owner_org_id": "string",\n      "internal": false,\n      "pricing": {\n        "pricing_type": "FREE",\n        "billing_frequency": "MONTHLY"\n      },\n      "configuration_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `createConfiguration`\n\nCreate a new private app configuration. To make it public a verification process needs to be triggered\n\n`POST /v1/app-configurations`\n\n```ts\nconst { data } = await client.createConfiguration(\n  null,\n  {\n    name: \'string\',\n    description: {\n      en: \'string\',\n      de: \'string\'\n    },\n    category: \'string\',\n    logo_url_key: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string"\n}\n```\n\n</details>\n\n---\n\n### `listPublicConfigurations`\n\nList all publicly available app configurations that can be installed. This endpoint returns apps that have at least one public version.\n\n`GET /v1/app-configurations/public`\n\n```ts\nconst { data } = await client.listPublicConfigurations({\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "configurations": [\n    {\n      "app_id": "string",\n      "name": "string",\n      "author": {\n        "name": "string",\n        "company": "string",\n        "email": "string"\n      },\n      "dev_mode": true,\n      "versions": ["string"],\n      "public_versions": ["string"],\n      "support_email": "string",\n      "latest_version": "string",\n      "category": "string",\n      "icon_url": "string",\n      "documentation_url": "string",\n      "description": {\n        "en": "string",\n        "de": "string"\n      },\n      "notifications": {\n        "email": "developer@example.com",\n        "events": ["app.installed"]\n      },\n      "owner_org_id": "string",\n      "internal": false,\n      "pricing": {\n        "pricing_type": "FREE",\n        "billing_frequency": "MONTHLY"\n      },\n      "configuration_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getPublicConfiguration`\n\nRetrieve the public configuration of an app to install in your tenant\n\n`GET /v1/app-configurations/public/{appId}`\n\n```ts\nconst { data } = await client.getPublicConfiguration({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "support_email": "string",\n  "owner_org_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {}\n    }\n  ],\n  "is_beta": true,\n  "deprecated_at": "string",\n  "version": "string",\n  "role": {\n    "id": "string",\n    "grants": [\n      {}\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "latest_version": "string",\n  "public": true,\n  "versions": [\n    {\n      "app_id": "string",\n      "owner_org_id": "string",\n      "components": [],\n      "visibility": "private",\n      "public": false,\n      "pending": false,\n      "version": "string",\n      "is_beta": true,\n      "deprecated_at": "string",\n      "changelog": "string",\n      "review_status": "approved",\n      "role": {},\n      "blueprint_ref": {},\n      "version_audit": {}\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getConfiguration`\n\nRetrieve a specific app configuration\n\n`GET /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.getConfiguration({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "versions": ["string"],\n  "public_versions": ["string"],\n  "support_email": "string",\n  "latest_version": "string",\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "notifications": {\n    "email": "developer@example.com",\n    "events": ["app.installed"]\n  },\n  "owner_org_id": "string",\n  "internal": false,\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "configuration_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "visibility": "private",\n  "public": false,\n  "pending": false,\n  "version": "string",\n  "is_beta": true,\n  "deprecated_at": "string",\n  "changelog": "string",\n  "review_status": "approved",\n  "role": {\n    "id": "string",\n    "grants": [\n      {\n        "action": "string",\n        "resource": "string"\n      }\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "version_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string",\n    "versioned_at": "string",\n    "versioned_by": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `patchMetadata`\n\nPatch non-versioned configuration metadata of a given app configuration.\n\n`PATCH /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.patchMetadata(\n  {\n    appId: \'example\',\n  },\n  {\n    name: \'string\',\n    description: {\n      en: \'string\',\n      de: \'string\'\n    },\n    category: \'string\',\n    documentation_url: \'string\',\n    notifications: {\n      email: \'developer@example.com\',\n      events: [\'app.installed\']\n    },\n    pricing: {\n      pricing_type: \'FREE\',\n      billing_frequency: \'MONTHLY\'\n    },\n    logo_url_key: \'string\',\n    support_email: \'string\',\n    dev_mode: true\n  },\n)\n```\n\n---\n\n### `deleteConfiguration`\n\nDelete app configuration\n\n`DELETE /v1/app-configurations/{appId}`\n\n```ts\nconst { data } = await client.deleteConfiguration({\n  appId: \'example\',\n})\n```\n\n---\n\n### `queryEvents`\n\nQuery analytics events for a specific app with flexible filtering\n\n`POST /v1/app-configurations/{appId}/events`\n\n```ts\nconst { data } = await client.queryEvents(\n  {\n    appId: \'example\',\n  },\n  {\n    time_range: {\n      start: \'1970-01-01T00:00:00.000Z\',\n      end: \'1970-01-01T00:00:00.000Z\',\n      preset: \'1h\'\n    },\n    filters: {\n      source: [\'CUSTOM_JOURNEY_BLOCK\'],\n      component_id: [\'string\'],\n      event_type: [\'ERROR\'],\n      correlation_id: \'string\'\n    },\n    aggregation: {\n      group_by: [\'source\'],\n      metrics: [\'count\']\n    },\n    pagination: {\n      page: 1,\n      page_size: 100\n    },\n    sort: {\n      field: \'timestamp\',\n      order: \'desc\'\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "query": {\n    "time_range": {\n      "start": "1970-01-01T00:00:00.000Z",\n      "end": "1970-01-01T00:00:00.000Z",\n      "preset": "1h"\n    },\n    "filters": {\n      "source": ["CUSTOM_JOURNEY_BLOCK"],\n      "component_id": ["string"],\n      "event_type": ["ERROR"],\n      "correlation_id": "string"\n    },\n    "aggregation": {\n      "group_by": ["source"],\n      "metrics": ["count"]\n    },\n    "pagination": {\n      "page": 1,\n      "page_size": 100\n    },\n    "sort": {\n      "field": "timestamp",\n      "order": "desc"\n    }\n  },\n  "results": {\n    "type": "raw",\n    "events": [\n      {\n        "app_id": "string",\n        "version": "string",\n        "event_id": "string",\n        "component_id": "string",\n        "timestamp": "string",\n        "correlation_id": "string",\n        "event_type": "ERROR",\n        "source": "CUSTOM_JOURNEY_BLOCK",\n        "actor": {\n          "org_id": "string",\n          "user_id": "string",\n          "type": "user"\n        },\n        "details": {}\n      }\n    ]\n  },\n  "pagination": {\n    "page": 0,\n    "page_size": 0,\n    "total_items": 0,\n    "has_next": true\n  }\n}\n```\n\n</details>\n\n---\n\n### `createBundleUploadUrl`\n\nGenerate a presigned URL for uploading app bundle to /``<app-id>``/bundle.js path\n\n`POST /v1/app-configurations/{appId}/bundle`\n\n```ts\nconst { data } = await client.createBundleUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    component_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component_id": "string",\n  "component_url": "string",\n  "upload_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `createZipUploadUrl`\n\nGenerate a presigned URL to upload a zip file with artifacts that will be unpacked in a new directory under the /``<app-id>``/ path\n\n`POST /v1/app-configurations/{appId}/zip`\n\n```ts\nconst { data } = await client.createZipUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'1.0.0\',\n    component_id: \'string\',\n    filename: \'dist.zip\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component_id": "string",\n  "upload_url": "string",\n  "artifact_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `createLogoUploadUrl`\n\nGenerate a presigned URL for uploading app logo to /``<app-id>``/logo.png path\n\n`POST /v1/app-configurations/{appId}/logo`\n\n```ts\nconst { data } = await client.createLogoUploadUrl(\n  {\n    appId: \'example\',\n  },\n  {\n    filename: \'company-logo.png\',\n    mime_type: \'image/png\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "upload_url": "string",\n  "s3ref": {\n    "bucket": "my-bucket",\n    "key": "manifest.json"\n  },\n  "expires_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `deleteLogo`\n\nDelete the app logo from /``<app-id>``/logo.png path\n\n`DELETE /v1/app-configurations/{appId}/logo`\n\n```ts\nconst { data } = await client.deleteLogo({\n  appId: \'example\',\n})\n```\n\n---\n\n### `listVersions`\n\nRetrieve a list of versions for an app configuration\n\n`GET /v1/app-configurations/{appId}/versions`\n\n```ts\nconst { data } = await client.listVersions({\n  appId: \'example\',\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "versions": [\n    {\n      "app_id": "string",\n      "owner_org_id": "string",\n      "components": [\n        {\n          "component_type": "CUSTOM_JOURNEY_BLOCK",\n          "configuration": {\n            "override_dev_mode": {\n              "override_url": "http://localhost:3000"\n            },\n            "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n            "component_tag": "string",\n            "component_args": [\n              {\n                "type": "text"\n              }\n            ],\n            "component_size": 0,\n            "component_mapping": {}\n          }\n        }\n      ],\n      "visibility": "private",\n      "public": false,\n      "pending": false,\n      "version": "string",\n      "is_beta": true,\n      "deprecated_at": "string",\n      "changelog": "string",\n      "review_status": "approved",\n      "role": {\n        "id": "string",\n        "grants": [\n          {\n            "action": "string",\n            "resource": "string"\n          }\n        ]\n      },\n      "blueprint_ref": {\n        "manifest_id": "string",\n        "job_id": "string",\n        "source_blueprint_file": "string"\n      },\n      "version_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string",\n        "versioned_at": "string",\n        "versioned_by": "string"\n      }\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getVersion`\n\nRetrieve a specific version of an app configuration\n\n`GET /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.getVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "name": "string",\n  "author": {\n    "name": "string",\n    "company": "string",\n    "email": "string"\n  },\n  "dev_mode": true,\n  "versions": ["string"],\n  "public_versions": ["string"],\n  "support_email": "string",\n  "latest_version": "string",\n  "category": "string",\n  "icon_url": "string",\n  "documentation_url": "string",\n  "description": {\n    "en": "string",\n    "de": "string"\n  },\n  "notifications": {\n    "email": "developer@example.com",\n    "events": ["app.installed"]\n  },\n  "owner_org_id": "string",\n  "internal": false,\n  "pricing": {\n    "pricing_type": "FREE",\n    "billing_frequency": "MONTHLY"\n  },\n  "configuration_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "visibility": "private",\n  "public": false,\n  "pending": false,\n  "version": "string",\n  "is_beta": true,\n  "deprecated_at": "string",\n  "changelog": "string",\n  "review_status": "approved",\n  "role": {\n    "id": "string",\n    "grants": [\n      {\n        "action": "string",\n        "resource": "string"\n      }\n    ]\n  },\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "version_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string",\n    "versioned_at": "string",\n    "versioned_by": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `deleteVersion`\n\nDelete a specific version of an app configuration\n\n`DELETE /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.deleteVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n---\n\n### `patchVersion`\n\nPatch an existing app version\n\n`PATCH /v1/app-configurations/{appId}/versions/{version}`\n\n```ts\nconst { data } = await client.patchVersion(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    manifest_id: \'string\',\n    role_id: \'string\',\n    grants: [\n      {\n        action: \'string\',\n        resource: \'string\'\n      }\n    ]\n  },\n)\n```\n\n---\n\n### `getReview`\n\nRetrieve the review status of a specific app version\n\n`GET /v1/app-configurations/{appId}/versions/{version}/review`\n\n```ts\nconst { data } = await client.getReview({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "review": {\n    "version": "string",\n    "review_status": "approved",\n    "requested_at": "string",\n    "requested_by": "string",\n    "technical_contact": "string",\n    "marketing_contact": "string",\n    "demo_url": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createReview`\n\nSubmit an app version for review to make it public\n\n`POST /v1/app-configurations/{appId}/versions/{version}/review`\n\n```ts\nconst { data } = await client.createReview(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    technical_contact: \'string\',\n    marketing_contact: \'string\',\n    demo_url: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "review": {\n    "version": "string",\n    "review_status": "approved",\n    "requested_at": "string",\n    "requested_by": "string",\n    "technical_contact": "string",\n    "marketing_contact": "string",\n    "demo_url": "string"\n  }\n}\n```\n\n</details>\n\n---\n\n### `createComponent`\n\nPatch an existing app version to create/add a component\n\n`POST /v1/app-configurations/{appId}/versions/{version}/components`\n\n```ts\nconst { data } = await client.createComponent(\n  {\n    appId: \'example\',\n    version: \'example\',\n  },\n  {\n    component_type: \'CUSTOM_JOURNEY_BLOCK\',\n    configuration: {\n      override_dev_mode: {\n        override_url: \'http://localhost:3000\'\n      },\n      component_url: \'https://cdn.apps.com/123/v1.0.0/bundle.js\',\n      component_tag: \'string\',\n      component_args: [\n        {\n          type: \'text\'\n        }\n      ],\n      component_size: 0,\n      component_mapping: {}\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "component": {\n    "component_type": "CUSTOM_JOURNEY_BLOCK",\n    "configuration": {\n      "override_dev_mode": {\n        "override_url": "http://localhost:3000"\n      },\n      "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n      "component_tag": "string",\n      "component_args": [\n        {\n          "type": "text"\n        }\n      ],\n      "component_size": 0,\n      "component_mapping": {}\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `patchComponent`\n\nPatch an existing app version to update its components\n\n`PATCH /v1/app-configurations/{appId}/versions/{version}/components/{componentId}`\n\n```ts\nconst { data } = await client.patchComponent(\n  {\n    appId: \'example\',\n    version: \'example\',\n    componentId: \'example\',\n  },\n  {\n    component_type: \'CUSTOM_JOURNEY_BLOCK\',\n    configuration: {\n      override_dev_mode: {\n        override_url: \'http://localhost:3000\'\n      },\n      component_url: \'https://cdn.apps.com/123/v1.0.0/bundle.js\',\n      component_tag: \'string\',\n      component_args: [\n        {\n          type: \'text\'\n        }\n      ],\n      component_size: 0,\n      component_mapping: {}\n    }\n  },\n)\n```\n\n---\n\n### `deleteComponent`\n\nDelete a specific component from an app version\n\n`DELETE /v1/app-configurations/{appId}/versions/{version}/components/{componentId}`\n\n```ts\nconst { data } = await client.deleteComponent({\n  appId: \'example\',\n  version: \'example\',\n  componentId: \'example\',\n})\n```\n\n---\n\n### `cloneVersion`\n\nClone an existing app version to create a new version\n\n`POST /v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}`\n\n```ts\nconst { data } = await client.cloneVersion({\n  appId: \'example\',\n  sourceVersion: \'example\',\n  targetVersion: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "version": "string",\n  "status": "pending"\n}\n```\n\n</details>\n\n---\n\n### `listInstallations`\n\nRetrieve a list of installed apps for the organization.\n\n`GET /v1/app`\n\n```ts\nconst { data } = await client.listInstallations({\n  componentType: \'example\',\n  enabled: true,\n  page: 1,\n  pageSize: 1,\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "apps": [\n    {\n      "app_id": "string",\n      "installer_org_id": "string",\n      "owner_org_id": "string",\n      "enabled": true,\n      "name": "string",\n      "option_values": [\n        {\n          "component_id": "string",\n          "options": [\n            {\n              "key": "string",\n              "value": {}\n            }\n          ]\n        }\n      ],\n      "components": [\n        {\n          "component_type": "CUSTOM_JOURNEY_BLOCK",\n          "configuration": {\n            "override_dev_mode": {\n              "override_url": "http://localhost:3000"\n            },\n            "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n            "component_tag": "string",\n            "component_args": [\n              {\n                "type": "text"\n              }\n            ],\n            "component_size": 0,\n            "component_mapping": {}\n          }\n        }\n      ],\n      "installed_version": "string",\n      "role": "string",\n      "blueprint_ref": {\n        "manifest_id": "string",\n        "job_id": "string",\n        "source_blueprint_file": "string"\n      },\n      "installation_audit": {\n        "created_at": "string",\n        "created_by": "string",\n        "updated_at": "string",\n        "updated_by": "string"\n      },\n      "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n    }\n  ],\n  "pagination": {\n    "total": 0,\n    "page": 0,\n    "pageSize": 0\n  }\n}\n```\n\n</details>\n\n---\n\n### `getInstallation`\n\nRetrieve details of an installed app by its ID.\n\n`GET /v1/app/{appId}`\n\n```ts\nconst { data } = await client.getInstallation({\n  appId: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `install`\n\nUpsert app installation by its ID.\n\n`POST /v1/app/{appId}`\n\n```ts\nconst { data } = await client.install(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    option_values: [\n      {\n        component_id: \'string\',\n        options: [\n          {\n            key: \'string\',\n            value: {}\n          }\n        ]\n      }\n    ],\n    _manifest: [\'123e4567-e89b-12d3-a456-426614174000\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `patchInstallation`\n\nPatch an installed app by its ID.\n\n`PATCH /v1/app/{appId}`\n\n```ts\nconst { data } = await client.patchInstallation(\n  {\n    appId: \'example\',\n  },\n  {\n    version: \'string\',\n    option_values: [\n      {\n        component_id: \'string\',\n        options: [\n          {\n            key: \'string\',\n            value: {}\n          }\n        ]\n      }\n    ],\n    _manifest: [\'123e4567-e89b-12d3-a456-426614174000\']\n  },\n)\n```\n\n---\n\n### `uninstall`\n\nUninstall an app by its ID.\n\n`DELETE /v1/app/{appId}`\n\n```ts\nconst { data } = await client.uninstall({\n  appId: \'example\',\n})\n```\n\n---\n\n### `promoteVersion`\n\nUpdate an installed app to a new version\n\n`POST /v1/app/{appId}/promote-to/{version}`\n\n```ts\nconst { data } = await client.promoteVersion({\n  appId: \'example\',\n  version: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "app_id": "string",\n  "installer_org_id": "string",\n  "owner_org_id": "string",\n  "enabled": true,\n  "name": "string",\n  "option_values": [\n    {\n      "component_id": "string",\n      "options": [\n        {\n          "key": "string",\n          "value": {}\n        }\n      ]\n    }\n  ],\n  "components": [\n    {\n      "component_type": "CUSTOM_JOURNEY_BLOCK",\n      "configuration": {\n        "override_dev_mode": {\n          "override_url": "http://localhost:3000"\n        },\n        "component_url": "https://cdn.apps.com/123/v1.0.0/bundle.js",\n        "component_tag": "string",\n        "component_args": [\n          {\n            "type": "text"\n          }\n        ],\n        "component_size": 0,\n        "component_mapping": {}\n      }\n    }\n  ],\n  "installed_version": "string",\n  "role": "string",\n  "blueprint_ref": {\n    "manifest_id": "string",\n    "job_id": "string",\n    "source_blueprint_file": "string"\n  },\n  "installation_audit": {\n    "created_at": "string",\n    "created_by": "string",\n    "updated_at": "string",\n    "updated_by": "string"\n  },\n  "_manifest": ["123e4567-e89b-12d3-a456-426614174000"]\n}\n```\n\n</details>\n\n---\n\n### `ingestEvent`\n\nInternal endpoint for services to submit app events for analytic purposes\n\n`POST /v1/app-events`\n\n```ts\nconst { data } = await client.ingestEvent(\n  null,\n  {\n    app_id: \'string\',\n    version: \'string\',\n    event_id: \'string\',\n    component_id: \'string\',\n    timestamp: \'string\',\n    correlation_id: \'string\',\n    event_type: \'ERROR\',\n    source: \'CUSTOM_JOURNEY_BLOCK\',\n    actor: {\n      org_id: \'string\',\n      user_id: \'string\',\n      type: \'user\'\n    },\n    details: {}\n  },\n)\n```\n\n---\n\n## Schemas\n\n### `Role`\n\n```ts\ntype Role = {\n  id?: string\n  grants?: Array<{\n    action: string\n    resource?: string\n  }>\n}\n```\n\n### `Options`\n\nOptions for the component configuration\n\n```ts\ntype Options = {\n  key: string\n  label?: string\n  required?: boolean\n  description?: string\n  value?: unknown\n  type: "text" | "number" | "boolean" | "secret"\n}\n```\n\n### `Option`\n\n```ts\ntype Option = {\n  key: string\n  value: unknown\n}\n```\n\n### `OptionsRef`\n\n```ts\ntype OptionsRef = {\n  component_id: string\n  options: Array<{\n    key: string\n    value: unknown\n  }>\n}\n```\n\n### `S3Reference`\n\n```ts\ntype S3Reference = {\n  bucket: string\n  key: string\n}\n```\n\n### `ComponentType`\n\nType of app component\n\n```ts\ntype ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n```\n\n### `Author`\n\n```ts\ntype Author = {\n  name?: string\n  company: string\n  email?: string\n}\n```\n\n### `NotificationConfig`\n\n```ts\ntype NotificationConfig = {\n  email?: string // email\n  events?: "app.installed" | "app.uninstalled"[]\n}\n```\n\n### `NotificationEvent`\n\n```ts\ntype NotificationEvent = "app.installed" | "app.uninstalled"\n```\n\n### `BaseComponentCommon`\n\n```ts\ntype BaseComponentCommon = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  options?: Array<{\n    key: string\n    label?: string\n    required?: boolean\n    description?: string\n    value?: unknown\n    type: "text" | "number" | "boolean" | "secret"\n  }>\n  surfaces?: object\n}\n```\n\n### `BaseComponent`\n\n```ts\ntype BaseComponent = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  options?: Array<{\n    key: string\n    label?: string\n    required?: boolean\n    description?: string\n    value?: unknown\n    type: "text" | "number" | "boolean" | "secret"\n  }>\n  surfaces?: object\n}\n```\n\n### `CustomCapabilityComponent`\n\n```ts\ntype CustomCapabilityComponent = {\n  component_type: "CUSTOM_CAPABILITY"\n  configuration: {\n    type?: "tab" | "group"\n    allowed_schemas?: string[]\n  }\n  surfaces?: {\n    capability_config?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `CustomPageComponent`\n\n```ts\ntype CustomPageComponent = {\n  component_type: "CUSTOM_PAGE"\n  configuration: {\n    slug: string\n    nav_label?: string\n    nav_icon?: string\n    nav_description?: string\n  }\n  surfaces?: {\n    page?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `CustomPageConfig`\n\n```ts\ntype CustomPageConfig = {\n  slug: string\n  nav_label?: string\n  nav_icon?: string\n  nav_description?: string\n}\n```\n\n### `JourneyBlockComponent`\n\n```ts\ntype JourneyBlockComponent = {\n  component_type: "CUSTOM_JOURNEY_BLOCK"\n  configuration: {\n    override_dev_mode?: {\n      override_url?: { ... }\n    }\n    component_url: string\n    component_tag: string\n    component_args?: Array<{\n      key: { ... }\n      type: { ... }\n      required?: { ... }\n      description?: { ... }\n      label: { ... }\n    }>\n    component_size?: number\n    component_mapping?: Record<string, "string" | "boolean" | "date" | "datetime" | "link" | "number">\n  }\n}\n```\n\n### `PortalBlockComponent`\n\n```ts\ntype PortalBlockComponent = {\n  component_type: "CUSTOM_PORTAL_BLOCK"\n  configuration: object\n  surfaces?: {\n    portal_block?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n      supported_surfaces?: { ... }\n    }\n  }\n}\n```\n\n### `ErpInformToolkitComponent`\n\n```ts\ntype ErpInformToolkitComponent = {\n  component_type: "ERP_INFORM_TOOLKIT"\n  configuration: {\n    type: "inbound" | "outbound"\n  }\n}\n```\n\n### `CustomFlowActionComponent`\n\n```ts\ntype CustomFlowActionComponent = {\n  component_type: "CUSTOM_FLOW_ACTION"\n  configuration: {\n    name?: string\n    description?: string\n    wait_for_callback?: boolean\n    type: "external_integration"\n    external_integration_settings?: {\n      url?: { ... }\n      headers?: { ... }\n    }\n  } | {\n    name?: string\n    description?: string\n    wait_for_callback?: boolean\n    type: "sandbox"\n    sandbox_settings?: {\n      code?: { ... }\n    }\n  }\n  surfaces?: {\n    flow_action_config?: {\n      app_url?: { ... }\n      zip_url?: { ... }\n      override_url?: { ... }\n    }\n  }\n}\n```\n\n### `BaseCustomActionConfig`\n\n```ts\ntype BaseCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n}\n```\n\n### `ExternalIntegrationCustomActionConfig`\n\n```ts\ntype ExternalIntegrationCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "external_integration"\n  external_integration_settings?: {\n    url?: string\n    headers?: Record<string, unknown>\n  }\n}\n```\n\n### `SandboxCustomActionConfig`\n\n```ts\ntype SandboxCustomActionConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "sandbox"\n  sandbox_settings?: {\n    code?: string\n  }\n}\n```\n\n### `CustomFlowConfig`\n\n```ts\ntype CustomFlowConfig = {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "external_integration"\n  external_integration_settings?: {\n    url?: string\n    headers?: Record<string, unknown>\n  }\n} | {\n  name?: string\n  description?: string\n  wait_for_callback?: boolean\n  type: "sandbox"\n  sandbox_settings?: {\n    code?: string\n  }\n}\n```\n\n### `ExternalProductCatalogComponent`\n\n```ts\ntype ExternalProductCatalogComponent = {\n  component_type: "EXTERNAL_PRODUCT_CATALOG"\n  configuration: {\n    hooks?: Array<{\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n    }>\n  }\n}\n```\n\n### `ExternalProductCatalogConfig`\n\n```ts\ntype ExternalProductCatalogConfig = {\n  hooks?: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "products"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "product-recommendations"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n  }>\n}\n```\n\n### `ExternalProductCatalogHookProducts`\n\nHook 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.\n\n\n```ts\ntype ExternalProductCatalogHookProducts = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "products"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n}\n```\n\n### `ExternalProductCatalogHookProductRecommendations`\n\nHook 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\n\n```ts\ntype ExternalProductCatalogHookProductRecommendations = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "product-recommendations"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n}\n```\n\n### `PortalExtensionComponent`\n\n```ts\ntype PortalExtensionComponent = {\n  component_type: "PORTAL_EXTENSION"\n  configuration: {\n    hooks?: Array<{\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      auth?: { ... }\n      call: { ... }\n      assignment_mode?: { ... }\n      contact_relation_attribute?: { ... }\n      explanation?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      intervals?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved?: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    } | {\n      id: { ... }\n      name?: { ... }\n      type: { ... }\n      plausibility_mode?: { ... }\n      auth?: { ... }\n      call: { ... }\n      resolved: { ... }\n      use_static_ips?: { ... }\n      secure_proxy?: { ... }\n    }>\n    links?: Array<{\n      id: { ... }\n      name: { ... }\n      description?: { ... }\n      type: { ... }\n      condition?: { ... }\n      auth?: { ... }\n      redirect: { ... }\n    }>\n  }\n}\n```\n\n### `PortalExtensionConfig`\n\n```ts\ntype PortalExtensionConfig = {\n  hooks?: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "registrationIdentifiersCheck"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers: { ... }\n      body?: { ... }\n      result: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "contractIdentification"\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers: { ... }\n      body?: { ... }\n      result?: { ... }\n    }\n    assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user"\n    contact_relation_attribute?: string\n    explanation?: {\n      en: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "priceDataRetrieval"\n    intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n    auth?: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n      cache?: { ... }\n    }\n    call: {\n      method?: { ... }\n      url: { ... }\n      params?: { ... }\n      headers?: { ... }\n      body?: { ... }\n    }\n    resolved?: {\n      dataPath?: { ... }\n    }\n    use_static_ips?: boolean\n    secure_proxy?: {\n      integration_id: { ... }\n      use_case_slug: { ... }\n    }\n  } | {\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    type: "consumptionDataRetrieval"\n  // ...\n}\n```\n\n### `PortalExtensionHookRegistrationIdentifiersCheck`\n\nHook that replaces the built-in registration identifiers check. This hook makes a POST call whenever a user is trying to register to find the corresponding contact. The expected response to the call is:\n  - 200 with contact id if exactly one contact is found\n  - 404 if no contact is found or more th\n\n```ts\ntype PortalExtensionHookRegistrationIdentifiersCheck = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "registrationIdentifiersCheck"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers: Record<string, string>\n    body?: object\n    result: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookContractIdentification`\n\nHook 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 suppo\n\n```ts\ntype PortalExtensionHookContractIdentification = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "contractIdentification"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers: Record<string, string>\n    body?: object\n    result?: string\n  }\n  assignment_mode?: "contracts" | "contact_to_contracts" | "contact_to_portal_user"\n  contact_relation_attribute?: string\n  explanation?: {\n    en: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookMeterReadingPlausibilityCheck`\n\nHook that checks the plausibility of meter readings before they are saved. This hook makes a POST call whenever a user is trying to save a meter reading. The expected response to the call is:\n  - 200:\n    If meter reading is plausible, the response should contain:\n      - valid: true\n    If meter re\n\n```ts\ntype PortalExtensionHookMeterReadingPlausibilityCheck = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "meterReadingPlausibilityCheck"\n  plausibility_mode?: "check" | "range"\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    url: string\n    body: Record<string, unknown>\n    headers: Record<string, string>\n  }\n  resolved: {\n    dataPath?: string\n    counter_identifiers?: Record<string, string>\n    valid?: string\n    upper_limit?: string\n    lower_limit?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookPriceDataRetrieval`\n\nHook that will allow using the specified source as data for price visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookPriceDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "priceDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookConsumptionDataRetrieval`\n\nHook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookConsumptionDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "consumptionDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionHookCostDataRetrieval`\n\nHook that will allow using the specified source as data for consumption visualizations. This hook is triggered to fetch the data. Format of the request and response has to follow the following specification: TBD. The expected response to the call is:\n  - 200 with the time series data\n\n\n```ts\ntype PortalExtensionHookCostDataRetrieval = {\n  id: string\n  name?: {\n    en?: string\n    de: string\n  }\n  type: "costDataRetrieval"\n  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  call: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n  }\n  resolved?: {\n    dataPath?: string\n  }\n  use_static_ips?: boolean\n  secure_proxy?: {\n    integration_id: string // uuid\n    use_case_slug: string\n  }\n}\n```\n\n### `PortalExtensionSeamlessLink`\n\n```ts\ntype PortalExtensionSeamlessLink = {\n  id: string\n  name: {\n    en?: string\n    de: string\n  }\n  description?: {\n    en?: string\n    de: string\n  }\n  type: "seamless"\n  condition?: string\n  auth?: {\n    method?: string\n    url: string\n    params?: Record<string, string>\n    headers?: Record<string, string>\n    body?: Record<string, unknown>\n    cache?: {\n      key: { ... }\n      ttl: { ... }\n    }\n  }\n  redirect: {\n    url?: string\n    params?: Record<string, string>\n  }\n}\n```\n\n### `PortalExtensionAuthBlock`\n\n```ts\ntype PortalExtensionAuthBlock = {\n  method?: string\n  url: string\n  params?: Record<string, string>\n  headers?: Record<string, string>\n  body?: Record<string, unknown>\n  cache?: {\n    key: string\n    ttl: string\n  }\n}\n```\n\n### `PortalExtensionSecureProxy`\n\nIf set, requests are routed through the ERP Integration secure proxy. Mutually exclusive with use_static_ips.\n\n```ts\ntype PortalExtensionSecureProxy = {\n  integration_id: string // uuid\n  use_case_slug: string\n}\n```\n\n### `ExternalProductCatalogAuthBlock`\n\n```ts\ntype ExternalProductCatalogAuthBlock = {\n  method?: string\n  url: string\n  params?: Record<string, string>\n  headers?: Record<string, string>\n  body?: Record<string, unknown>\n}\n```\n\n### `OverrideDevMode`\n\nOverride URL when app is in dev mode\n\n```ts\ntype OverrideDevMode = {\n  override_url?: string\n}\n```\n\n### `JourneyBlockConfig`\n\n```ts\ntype JourneyBlockConfig = {\n  override_dev_mode?: {\n    override_url?: string\n  }\n  component_url: string\n  component_tag: string\n  component_args?: Array<{\n    key: string\n    type: "text" | "boolean" | "enum"\n    required?: boolean\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    label: {\n      en?: { ... }\n      de: { ... }\n    }\n  }>\n  component_size?: number\n  component_mapping?: Record<string, "string" | "boolean" | "date" | "datetime" | "link" | "number">\n}\n```\n\n### `PortalBlockConfig`\n\n```ts\ntype PortalBlockConfig = object\n```\n\n### `AppBridgeSurfaceConfig`\n\n```ts\ntype AppBridgeSurfaceConfig = {\n  app_url?: string\n  zip_url?: string\n  override_url?: string\n}\n```\n\n### `PortalBlockSurfaceConfig`\n\n```ts\ntype PortalBlockSurfaceConfig = {\n  app_url?: string\n  zip_url?: string\n  override_url?: string\n  supported_surfaces?: "main" | "footer_inline" | "footer_left_absolute" | "footer_right_absolute"[]\n}\n```\n\n### `JourneyBlockComponentArgs`\n\n```ts\ntype JourneyBlockComponentArgs = {\n  key: string\n  type: "text" | "boolean" | "enum"\n  required?: boolean\n  description?: {\n    en?: string\n    de: string\n  }\n  label: {\n    en?: string\n    de: string\n  }\n}\n```\n\n### `TextArg`\n\n```ts\ntype TextArg = {\n  type?: "text"\n}\n```\n\n### `BooleanArg`\n\n```ts\ntype BooleanArg = {\n  type?: "boolean"\n}\n```\n\n### `EnumArg`\n\n```ts\ntype EnumArg = {\n  type?: "enum"\n  isMulti?: boolean\n  options: Array<{\n    id: string\n    label: {\n      en?: { ... }\n      de: { ... }\n    }\n  }>\n}\n```\n\n### `BillingFrequency`\n\nHow often the subscription is billed\n\n```ts\ntype BillingFrequency = "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n```\n\n### `Pricing`\n\n```ts\ntype Pricing = {\n  pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n  billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n}\n```\n\n### `Audit`\n\n```ts\ntype Audit = {\n  created_at?: string\n  created_by?: string\n  updated_at?: string\n  updated_by?: string\n}\n```\n\n### `Review`\n\n```ts\ntype Review = {\n  version?: string\n  review_status?: "approved" | "rejected" | "pending"\n  requested_at?: string\n  requested_by?: string\n  technical_contact?: string\n  marketing_contact?: string\n  demo_url?: string\n}\n```\n\n### `ConfigurationMetadata`\n\nBasic metadata about your app configuration which does not get versioned\n\n```ts\ntype ConfigurationMetadata = {\n  app_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  versions: string[]\n  public_versions?: string[]\n  support_email?: string\n  latest_version: string\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description: {\n    en?: string\n    de: string\n  }\n  notifications?: {\n    email?: string // email\n    events?: "app.installed" | "app.uninstalled"[]\n  }\n  owner_org_id: string\n  internal?: boolean\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  configuration_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n}\n```\n\n### `ConfigurationVersion`\n\nConfiguration data about your app which is versionable\n\n```ts\ntype ConfigurationVersion = {\n  app_id: string\n  owner_org_id: string\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  visibility?: "public" | "private"\n  public?: boolean\n  pending?: boolean\n  version: string\n  is_beta?: boolean\n  deprecated_at?: string\n  changelog?: string\n  review_status?: "approved" | "rejected" | "pending"\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  version_audit: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n    versioned_at?: string\n    versioned_by?: string\n  }\n}\n```\n\n### `Grants`\n\nRequired grants for the app in order to call APIs for the installing tenant\n\n```ts\ntype Grants = Array<{\n  action: string\n  resource?: string\n}>\n```\n\n### `BlueprintRef`\n\n```ts\ntype BlueprintRef = {\n  manifest_id?: string\n  job_id?: string\n  source_blueprint_file?: string\n}\n```\n\n### `Installation`\n\nInformation about the installed app. Has configuration data of the installed version\n\n```ts\ntype Installation = {\n  app_id: string\n  installer_org_id: string\n  owner_org_id?: string\n  enabled: boolean\n  name: string\n  option_values?: Array<{\n    component_id: string\n    options: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }>\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  installed_version: string\n  role?: string\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  installation_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n  _manifest?: string // uuid[]\n}\n```\n\n### `PublicConfiguration`\n\nPublic configuration of the published app\n\n```ts\ntype PublicConfiguration = {\n  app_id: string\n  support_email?: string\n  owner_org_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description?: {\n    en?: string\n    de: string\n  }\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  is_beta?: boolean\n  deprecated_at?: string\n  version: string\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  latest_version?: string\n  public?: boolean\n  versions?: Array<{\n    app_id: string\n    owner_org_id: string\n    components: Array<{\n      id: { ... }\n      name?: { ... }\n      description?: { ... }\n      options?: { ... }\n      surfaces?: { ... }\n    }>\n    visibility?: "public" | "private"\n    public?: boolean\n    pending?: boolean\n    version: string\n    is_beta?: boolean\n    deprecated_at?: string\n    changelog?: string\n    review_status?: "approved" | "rejected" | "pending"\n    role?: {\n      id?: { ... }\n      grants?: { ... }\n    }\n    blueprint_ref?: {\n      manifest_id?: { ... }\n      job_id?: { ... }\n      source_blueprint_file?: { ... }\n    }\n    version_audit: {\n      created_at?: { ... }\n      created_by?: { ... }\n      updated_at?: { ... }\n      updated_by?: { ... }\n      versioned_at?: { ... }\n      versioned_by?: { ... }\n    }\n  }>\n}\n```\n\n### `Configuration`\n\nConfiguration of the published app\n\n```ts\ntype Configuration = {\n  app_id: string\n  name: string\n  author?: {\n    name?: string\n    company: string\n    email?: string\n  }\n  dev_mode?: boolean\n  versions: string[]\n  public_versions?: string[]\n  support_email?: string\n  latest_version: string\n  category?: string\n  icon_url?: string\n  documentation_url?: string\n  description: {\n    en?: string\n    de: string\n  }\n  notifications?: {\n    email?: string // email\n    events?: "app.installed" | "app.uninstalled"[]\n  }\n  owner_org_id: string\n  internal?: boolean\n  pricing?: {\n    pricing_type?: "FREE" | "SUBSCRIPTION" | "USAGE_BASED" | "ONE_TIME" | "CUSTOM" | "UNKNOWN"\n    billing_frequency?: "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM"\n  }\n  configuration_audit?: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n  }\n  components: Array<{\n    id: string\n    name?: {\n      en?: { ... }\n      de: { ... }\n    }\n    description?: {\n      en?: { ... }\n      de: { ... }\n    }\n    options?: Array<{\n      key: { ... }\n      label?: { ... }\n      required?: { ... }\n      description?: { ... }\n      value?: { ... }\n      type: { ... }\n    }>\n    surfaces?: object\n  }>\n  visibility?: "public" | "private"\n  public?: boolean\n  pending?: boolean\n  version: string\n  is_beta?: boolean\n  deprecated_at?: string\n  changelog?: string\n  review_status?: "approved" | "rejected" | "pending"\n  role?: {\n    id?: string\n    grants?: Array<{\n      action: { ... }\n      resource?: { ... }\n    }>\n  }\n  blueprint_ref?: {\n    manifest_id?: string\n    job_id?: string\n    source_blueprint_file?: string\n  }\n  version_audit: {\n    created_at?: string\n    created_by?: string\n    updated_at?: string\n    updated_by?: string\n    versioned_at?: string\n    versioned_by?: string\n  }\n}\n```\n\n### `TranslatedString`\n\n```ts\ntype TranslatedString = {\n  en?: string\n  de: string\n}\n```\n\n### `CallerIdentity`\n\n```ts\ntype CallerIdentity = {\n  name?: unknown\n  org_id: string\n  user_id?: string\n  token_id?: string\n}\n```\n\n### `BatchEventRequest`\n\n```ts\ntype BatchEventRequest = {\n  events: Array<{\n    app_id: string\n    version: string\n    event_id?: string\n    component_id: string\n    timestamp?: string\n    correlation_id?: string\n    event_type: "ERROR" | "WARNING" | "INFO"\n    source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n    actor: {\n      org_id?: { ... }\n      user_id?: { ... }\n      type: { ... }\n    }\n    details?: Record<string, unknown>\n  }>\n}\n```\n\n### `Actor`\n\n```ts\ntype Actor = {\n  org_id?: string\n  user_id?: string\n  type: "user" | "system"\n}\n```\n\n### `AppEventData`\n\n```ts\ntype AppEventData = {\n  app_id: string\n  version: string\n  event_id?: string\n  component_id: string\n  timestamp?: string\n  correlation_id?: string\n  event_type: "ERROR" | "WARNING" | "INFO"\n  source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n  actor: {\n    org_id?: string\n    user_id?: string\n    type: "user" | "system"\n  }\n  details?: Record<string, unknown>\n}\n```\n\n### `EventsQuery`\n\n```ts\ntype EventsQuery = {\n  time_range?: {\n    start?: string // date-time\n    end?: string // date-time\n    preset?: "1h" | "6h" | "24h" | "7d" | "30d"\n  }\n  filters?: {\n    source?: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"[]\n    component_id?: string[]\n    event_type?: "ERROR" | "WARNING" | "INFO"[]\n    correlation_id?: string\n  }\n  aggregation?: {\n    group_by?: "source" | "component_id" | "event_type" | "hour" | "day"[]\n    metrics?: "count" | "error_rate" | "unique_users"[]\n  }\n  pagination?: {\n    page?: number\n    page_size?: number\n  }\n  sort?: {\n    field?: "timestamp" | "event_type" | "component_id"\n    order?: "asc" | "desc"\n  }\n}\n```\n\n### `EventsQueryResponse`\n\n```ts\ntype EventsQueryResponse = {\n  query?: {\n    time_range?: {\n      start?: { ... }\n      end?: { ... }\n      preset?: { ... }\n    }\n    filters?: {\n      source?: { ... }\n      component_id?: { ... }\n      event_type?: { ... }\n      correlation_id?: { ... }\n    }\n    aggregation?: {\n      group_by?: { ... }\n      metrics?: { ... }\n    }\n    pagination?: {\n      page?: { ... }\n      page_size?: { ... }\n    }\n    sort?: {\n      field?: { ... }\n      order?: { ... }\n    }\n  }\n  results?: {\n    type?: "raw"\n    events?: Array<{\n      app_id: { ... }\n      version: { ... }\n      event_id?: { ... }\n      component_id: { ... }\n      timestamp?: { ... }\n      correlation_id?: { ... }\n      event_type: { ... }\n      source: { ... }\n      actor: { ... }\n      details?: { ... }\n    }>\n  } | {\n    type?: "aggregated"\n    groups?: Array<{\n      dimensions?: { ... }\n      metrics?: { ... }\n    }>\n  }\n  pagination?: {\n    page?: number\n    page_size?: number\n    total_items?: number\n    has_next?: boolean\n  }\n}\n```\n\n### `RawEvents`\n\n```ts\ntype RawEvents = {\n  type?: "raw"\n  events?: Array<{\n    app_id: string\n    version: string\n    event_id?: string\n    component_id: string\n    timestamp?: string\n    correlation_id?: string\n    event_type: "ERROR" | "WARNING" | "INFO"\n    source: "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE"\n    actor: {\n      org_id?: { ... }\n      user_id?: { ... }\n      type: { ... }\n    }\n    details?: Record<string, unknown>\n  }>\n}\n```\n\n### `AggregatedEvents`\n\n```ts\ntype AggregatedEvents = {\n  type?: "aggregated"\n  groups?: Array<{\n    dimensions?: Record<string, unknown>\n    metrics?: {\n      count?: { ... }\n      error_rate?: { ... }\n    }\n  }>\n}\n```\n';
-
-
-exports.default = app_default;

package/dist/app-runtime-SSNHSBR7.cjs

@@ -1,5 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkL66IX6GXcjs = require('./chunk-L66IX6GX.cjs');
-require('./chunk-NJK5F5TF.cjs');
-exports. default = _chunkL66IX6GXcjs.require_app_runtime.call(void 0, );