@epilot/app-client 0.12.1 → 0.12.3

package/dist/definition.js

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

package/dist/openapi-runtime.json

@@ -501,6 +501,41 @@
         },
         "responses": {}
       }
+    },
+    "/v1/public/app/{appId}/proxy/{proxyName}/{path}": {
+      "parameters": [
+        {
+          "name": "appId",
+          "in": "path",
+          "required": true,
+          "description": "ID of the installed app"
+        },
+        {
+          "name": "proxyName",
+          "in": "path",
+          "required": true,
+          "description": "Name of the proxy target as defined in the app manifest"
+        },
+        {
+          "name": "path",
+          "in": "path",
+          "required": true,
+          "description": "Path to forward to the proxy target"
+        }
+      ],
+      "get": {
+        "operationId": "publicProxyGet",
+        "responses": {}
+      },
+      "post": {
+        "operationId": "publicProxyPost",
+        "requestBody": {
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
     }
   },
   "components": {

package/dist/openapi.d.ts

@@ -138,6 +138,35 @@ declare namespace Components {
                 };
             }[];
         }
+        export interface ApiProxyComponent {
+            component_type: "API_PROXY";
+            configuration: /* Configuration for an API proxy component */ ApiProxyConfig;
+        }
+        /**
+         * Configuration for an API proxy component
+         */
+        export interface ApiProxyConfig {
+            /**
+             * Human-friendly proxy name used in SDK calls
+             */
+            name: string; // ^[a-zA-Z0-9_-]+$
+            /**
+             * Base URL of the target API. Must be HTTPS.
+             */
+            target: string; // uri ^https://
+            /**
+             * Authentication strategy
+             */
+            auth_type: "header" | "bearer" | "oauth2" | "none";
+            /**
+             * Header name for 'header' auth type
+             */
+            auth_header?: string;
+            /**
+             * OAuth2 token endpoint URL
+             */
+            token_url?: string; // uri ^https://
+        }
         export interface AppBridgeSurfaceConfig {
             /**
              * URL of the uploaded App Bridge App. This is the entrypoint for the app
@@ -245,7 +274,7 @@ declare namespace Components {
             surfaces?: {
                 [key: string]: any;
             };
-        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent | CustomPageComponent);
+        } & (JourneyBlockComponent | PortalBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent | CustomCapabilityComponent | ExternalProductCatalogComponent | CustomPageComponent | ApiProxyComponent);
         export interface BaseComponentCommon {
             /**
              * Unique identifier for the component
@@ -407,6 +436,22 @@ declare namespace Components {
          * How often the subscription is billed
          */
         export type BillingFrequency = "MONTHLY" | "QUARTERLY" | "YEARLY" | "CUSTOM";
+        /**
+         * References another journey block by its ID. The configuring user picks
+         * a block from the journey via a dropdown in the journey-builder; the
+         * chosen block's ID is stored as the arg value (a string). The bundle can
+         * then call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.
+         *
+         */
+        export interface BlockReferenceArg {
+            type?: "block_reference";
+            /**
+             * Restrict the picker to blocks of these journey block types
+             * (e.g. ["availability-check", "address"]). Omit to allow any type.
+             *
+             */
+            allowed_types?: string[];
+        }
         export interface BlueprintRef {
             /**
              * ID of the blueprint
@@ -416,6 +461,10 @@ declare namespace Components {
              * ID of the job that created the blueprint
              */
             job_id?: string;
+            /**
+             * S3 key of a pre-exported blueprint zip used for cross-org installs
+             */
+            source_blueprint_file?: string;
         }
         export interface BooleanArg {
             type?: "boolean";
@@ -449,7 +498,7 @@ declare namespace Components {
         /**
          * Type of app component
          */
-        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE";
+        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "CUSTOM_PORTAL_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT" | "CUSTOM_CAPABILITY" | "EXTERNAL_PRODUCT_CATALOG" | "CUSTOM_PAGE" | "API_PROXY";
         /**
          * Configuration of the published app
          */
@@ -1210,7 +1259,7 @@ declare namespace Components {
              * Unique identifier for this component arg
              */
             key: string;
-            type: "text" | "boolean" | "enum";
+            type: "text" | "boolean" | "enum" | "block_reference";
             /**
              * Flag to indicate if this option is required
              */
@@ -1241,7 +1290,14 @@ declare namespace Components {
                  */
                 de: string;
             };
-        } & (TextArg | BooleanArg | EnumArg);
+        } & (TextArg | BooleanArg | EnumArg | /**
+         * References another journey block by its ID. The configuring user picks
+         * a block from the journey via a dropdown in the journey-builder; the
+         * chosen block's ID is stored as the arg value (a string). The bundle can
+         * then call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.
+         *
+         */
+        BlockReferenceArg);
         export interface JourneyBlockConfig {
             override_dev_mode?: /* Override URL when app is in dev mode */ OverrideDevMode;
             /**
@@ -1359,9 +1415,9 @@ declare namespace Components {
              */
             override_url?: string;
             /**
-             * Define which section of the portal this block can be placed in
+             * Define which surfaces of the portal this block can be placed in
              */
-            section?: "main" | "footer";
+            supported_surfaces?: ("main" | "footer_inline" | "footer_left_absolute" | "footer_right_absolute")[];
         }
         export interface PortalExtensionAuthBlock {
             /**
@@ -2603,6 +2659,32 @@ declare namespace Paths {
             }
         }
     }
+    namespace PublicProxyGet {
+        namespace Responses {
+            export interface $200 {
+            }
+            export interface $403 {
+            }
+            export interface $404 {
+            }
+            export interface $502 {
+            }
+        }
+    }
+    namespace PublicProxyPost {
+        export interface RequestBody {
+        }
+        namespace Responses {
+            export interface $200 {
+            }
+            export interface $403 {
+            }
+            export interface $404 {
+            }
+            export interface $502 {
+            }
+        }
+    }
     namespace QueryEvents {
         namespace Parameters {
             export type AppId = string;
@@ -2667,6 +2749,18 @@ declare namespace Paths {
             componentId: Parameters.ComponentId;
         }
     }
+    namespace V1PublicApp$AppIdProxy$ProxyName$Path {
+        namespace Parameters {
+            export type AppId = string;
+            export type Path = string;
+            export type ProxyName = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+            proxyName: Parameters.ProxyName;
+            path: Parameters.Path;
+        }
+    }
 }
 
 
@@ -2972,6 +3066,26 @@ export interface OperationMethods {
     data?: Paths.IngestEvent.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.IngestEvent.Responses.$202>
+  /**
+   * publicProxyGet - publicProxyGet
+   * 
+   * Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)
+   */
+  'publicProxyGet'(
+    parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublicProxyGet.Responses.$200>
+  /**
+   * publicProxyPost - publicProxyPost
+   * 
+   * Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)
+   */
+  'publicProxyPost'(
+    parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+    data?: Paths.PublicProxyPost.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PublicProxyPost.Responses.$200>
 }
 
 export interface PathsDictionary {
@@ -3314,6 +3428,28 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.IngestEvent.Responses.$202>
   }
+  ['/v1/public/app/{appId}/proxy/{proxyName}/{path}']: {
+    /**
+     * publicProxyGet - publicProxyGet
+     * 
+     * Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)
+     */
+    'get'(
+      parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublicProxyGet.Responses.$200>
+    /**
+     * publicProxyPost - publicProxyPost
+     * 
+     * Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)
+     */
+    'post'(
+      parameters?: Parameters<Paths.V1PublicApp$AppIdProxy$ProxyName$Path.PathParameters> | null,
+      data?: Paths.PublicProxyPost.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PublicProxyPost.Responses.$200>
+  }
 }
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
@@ -3321,6 +3457,8 @@ export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 export type Actor = Components.Schemas.Actor;
 export type AggregatedEvents = Components.Schemas.AggregatedEvents;
+export type ApiProxyComponent = Components.Schemas.ApiProxyComponent;
+export type ApiProxyConfig = Components.Schemas.ApiProxyConfig;
 export type AppBridgeSurfaceConfig = Components.Schemas.AppBridgeSurfaceConfig;
 export type AppEventData = Components.Schemas.AppEventData;
 export type Audit = Components.Schemas.Audit;
@@ -3330,6 +3468,7 @@ export type BaseComponentCommon = Components.Schemas.BaseComponentCommon;
 export type BaseCustomActionConfig = Components.Schemas.BaseCustomActionConfig;
 export type BatchEventRequest = Components.Schemas.BatchEventRequest;
 export type BillingFrequency = Components.Schemas.BillingFrequency;
+export type BlockReferenceArg = Components.Schemas.BlockReferenceArg;
 export type BlueprintRef = Components.Schemas.BlueprintRef;
 export type BooleanArg = Components.Schemas.BooleanArg;
 export type CallerIdentity = Components.Schemas.CallerIdentity;

package/dist/openapi.json

@@ -17,6 +17,10 @@
     {
       "name": "App Analytics",
       "description": "Analytics for installed apps"
+    },
+    {
+      "name": "App Proxy",
+      "description": "Forward requests to external APIs via registered proxy targets"
     }
   ],
   "servers": [
@@ -1468,6 +1472,100 @@
           }
         }
       }
+    },
+    "/v1/public/app/{appId}/proxy/{proxyName}/{path}": {
+      "parameters": [
+        {
+          "name": "appId",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "ID of the installed app"
+        },
+        {
+          "name": "proxyName",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "Name of the proxy target as defined in the app manifest"
+        },
+        {
+          "name": "path",
+          "in": "path",
+          "required": true,
+          "schema": {
+            "type": "string"
+          },
+          "description": "Path to forward to the proxy target"
+        }
+      ],
+      "get": {
+        "summary": "publicProxyGet",
+        "operationId": "publicProxyGet",
+        "description": "Forward a GET request to a registered proxy target from a public-facing component (e.g. journey blocks)",
+        "tags": [
+          "App Proxy"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Proxied response from the target API"
+          },
+          "403": {
+            "description": "Forbidden - app not installed or no public component uses this proxy"
+          },
+          "404": {
+            "description": "Proxy target not found"
+          },
+          "502": {
+            "description": "Bad gateway - proxy target unreachable or error"
+          }
+        }
+      },
+      "post": {
+        "summary": "publicProxyPost",
+        "operationId": "publicProxyPost",
+        "description": "Forward a POST request to a registered proxy target from a public-facing component (e.g. journey blocks)",
+        "tags": [
+          "App Proxy"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Proxied response from the target API"
+          },
+          "403": {
+            "description": "Forbidden - app not installed or no public component uses this proxy"
+          },
+          "404": {
+            "description": "Proxy target not found"
+          },
+          "502": {
+            "description": "Bad gateway - proxy target unreachable or error"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -1832,7 +1930,8 @@
           "ERP_INFORM_TOOLKIT",
           "CUSTOM_CAPABILITY",
           "EXTERNAL_PRODUCT_CATALOG",
-          "CUSTOM_PAGE"
+          "CUSTOM_PAGE",
+          "API_PROXY"
         ],
         "description": "Type of app component"
       },
@@ -1944,7 +2043,8 @@
                 "ERP_INFORM_TOOLKIT": "#/components/schemas/ErpInformToolkitComponent",
                 "CUSTOM_CAPABILITY": "#/components/schemas/CustomCapabilityComponent",
                 "EXTERNAL_PRODUCT_CATALOG": "#/components/schemas/ExternalProductCatalogComponent",
-                "CUSTOM_PAGE": "#/components/schemas/CustomPageComponent"
+                "CUSTOM_PAGE": "#/components/schemas/CustomPageComponent",
+                "API_PROXY": "#/components/schemas/ApiProxyComponent"
               }
             },
             "oneOf": [
@@ -1971,11 +2071,32 @@
               },
               {
                 "$ref": "#/components/schemas/CustomPageComponent"
+              },
+              {
+                "$ref": "#/components/schemas/ApiProxyComponent"
               }
             ]
           }
         ]
       },
+      "ApiProxyComponent": {
+        "type": "object",
+        "required": [
+          "component_type",
+          "configuration"
+        ],
+        "properties": {
+          "component_type": {
+            "type": "string",
+            "enum": [
+              "API_PROXY"
+            ]
+          },
+          "configuration": {
+            "$ref": "#/components/schemas/ApiProxyConfig"
+          }
+        }
+      },
       "CustomCapabilityComponent": {
         "type": "object",
         "required": [
@@ -3391,12 +3512,20 @@
           {
             "type": "object",
             "properties": {
-              "section": {
-                "description": "Define which section of the portal this block can be placed in",
-                "type": "string",
-                "enum": [
-                  "main",
-                  "footer"
+              "supported_surfaces": {
+                "description": "Define which surfaces of the portal this block can be placed in",
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "main",
+                    "footer_inline",
+                    "footer_left_absolute",
+                    "footer_right_absolute"
+                  ]
+                },
+                "default": [
+                  "main"
                 ]
               }
             }
@@ -3422,7 +3551,8 @@
                 "enum": [
                   "text",
                   "boolean",
-                  "enum"
+                  "enum",
+                  "block_reference"
                 ]
               },
               "required": {
@@ -3459,7 +3589,8 @@
               "mapping": {
                 "text": "#/components/schemas/TextArg",
                 "boolean": "#/components/schemas/BooleanArg",
-                "enum": "#/components/schemas/EnumArg"
+                "enum": "#/components/schemas/EnumArg",
+                "block_reference": "#/components/schemas/BlockReferenceArg"
               }
             },
             "oneOf": [
@@ -3471,6 +3602,9 @@
               },
               {
                 "$ref": "#/components/schemas/EnumArg"
+              },
+              {
+                "$ref": "#/components/schemas/BlockReferenceArg"
               }
             ]
           }
@@ -3498,6 +3632,25 @@
           }
         }
       },
+      "BlockReferenceArg": {
+        "type": "object",
+        "description": "References another journey block by its ID. The configuring user picks\na block from the journey via a dropdown in the journey-builder; the\nchosen block's ID is stored as the arg value (a string). The bundle can\nthen call `subscribe(blockId, cb)` / `getValue(blockId)` against that ID.\n",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "block_reference"
+            ]
+          },
+          "allowed_types": {
+            "type": "array",
+            "description": "Restrict the picker to blocks of these journey block types\n(e.g. [\"availability-check\", \"address\"]). Omit to allow any type.\n",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "EnumArg": {
         "type": "object",
         "required": [
@@ -3868,6 +4021,49 @@
           }
         }
       },
+      "ApiProxyConfig": {
+        "type": "object",
+        "description": "Configuration for an API proxy component",
+        "required": [
+          "name",
+          "target",
+          "auth_type"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Human-friendly proxy name used in SDK calls",
+            "pattern": "^[a-zA-Z0-9_-]+$",
+            "maxLength": 64
+          },
+          "target": {
+            "type": "string",
+            "format": "uri",
+            "description": "Base URL of the target API. Must be HTTPS.",
+            "pattern": "^https://"
+          },
+          "auth_type": {
+            "type": "string",
+            "enum": [
+              "header",
+              "bearer",
+              "oauth2",
+              "none"
+            ],
+            "description": "Authentication strategy"
+          },
+          "auth_header": {
+            "type": "string",
+            "description": "Header name for 'header' auth type"
+          },
+          "token_url": {
+            "type": "string",
+            "format": "uri",
+            "description": "OAuth2 token endpoint URL",
+            "pattern": "^https://"
+          }
+        }
+      },
       "Grants": {
         "type": "array",
         "description": "Required grants for the app in order to call APIs for the installing tenant",
@@ -3898,6 +4094,10 @@
           "job_id": {
             "type": "string",
             "description": "ID of the job that created the blueprint"
+          },
+          "source_blueprint_file": {
+            "type": "string",
+            "description": "S3 key of a pre-exported blueprint zip used for cross-org installs"
           }
         }
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/app-client",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "description": "JavaScript client library for the epilot App API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,7 +25,7 @@
     "test": "vitest",
     "typescript": "tsc",
     "bundle-definition": "webpack",
-    "openapi:local": "node ../../scripts/update-openapi.js ../../../app-api/openapi.yml",
+    "openapi:local": "node ../../scripts/update-openapi.js /Users/sauerer/epilot/app-api/openapi.yml",
     "openapi": "node ../../scripts/update-openapi.js https://docs.api.epilot.io/app.yaml",
     "typegen": "openapi typegen src/openapi.json --client > src/openapi.d.ts",
     "build": "tsc && npm run build:patch && npm run bundle-definition",
@@ -64,7 +64,7 @@
     "axios": "^1.11.0",
     "copy-webpack-plugin": "^7.0.0",
     "json-loader": "^0.5.7",
-    "openapicmd": "^2.7.0",
+    "openapicmd": "^2.9.2",
     "ts-loader": "^8.0.14",
     "ts-node": "^10.9.1",
     "typescript": "^4.1.3",