@epilot/erp-integration-client 0.30.0-rc3 → 0.31.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466(e){e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v3/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV3","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/inbound-events":{"post":{"operationId":"queryInboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/timeseries":{"post":{"operationId":"getMonitoringTimeSeries","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/outbound-status":{"get":{"operationId":"getOutboundStatus","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/monitoring/access-logs":{"post":{"operationId":"queryAccessLogs","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/outbound-events":{"post":{"operationId":"queryOutboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/events":{"post":{"operationId":"queryMonitoringEventsV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStatsV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/time-series":{"post":{"operationId":"getMonitoringTimeSeriesV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated":{"get":{"operationId":"getAssociatedMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"eventId","in":"path","required":true}],"responses":{}}},"/v1/integrations/secure-proxies":{"get":{"operationId":"listSecureProxies","responses":{}}},"/v1/secure-proxy":{"post":{"operationId":"secureProxy","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/managed-call/{slug}/execute":{"post":{"operationId":"managedCallExecute","parameters":[{"name":"slug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"Forbidden":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryInboundMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"GetMonitoringTimeSeriesResponse":{"content":{"application/json":{}}},"QueryAccessLogsResponse":{"content":{"application/json":{}}},"QueryOutboundMonitoringEventsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}},"QueryMonitoringEventsV2Response":{"content":{"application/json":{}}},"GetMonitoringStatsV2Response":{"content":{"application/json":{}}},"GetMonitoringTimeSeriesV2Response":{"content":{"application/json":{}}},"GetAssociatedMonitoringEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={330(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466(e){e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"deprecated":true,"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v3/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV3","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/inbound-events":{"post":{"operationId":"queryInboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/timeseries":{"post":{"operationId":"getMonitoringTimeSeries","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/outbound-status":{"get":{"operationId":"getOutboundStatus","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/monitoring/access-logs":{"post":{"operationId":"queryAccessLogs","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/outbound-events":{"post":{"operationId":"queryOutboundMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/events":{"post":{"operationId":"queryMonitoringEventsV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStatsV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/time-series":{"post":{"operationId":"getMonitoringTimeSeriesV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated":{"get":{"operationId":"getAssociatedMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"eventId","in":"path","required":true}],"responses":{}}},"/v1/integrations/secure-proxies":{"get":{"operationId":"listSecureProxies","responses":{}}},"/v1/secure-proxy":{"post":{"operationId":"secureProxy","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/managed-call/{slug}/execute":{"post":{"operationId":"managedCallExecute","parameters":[{"name":"slug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/generate-types-preview":{"post":{"operationId":"generateTypesPreview","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/generate-types":{"post":{"operationId":"generateTypes","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/commit-types":{"post":{"operationId":"commitTypes","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"Forbidden":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryInboundMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"GetMonitoringTimeSeriesResponse":{"content":{"application/json":{}}},"QueryAccessLogsResponse":{"content":{"application/json":{}}},"QueryOutboundMonitoringEventsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}},"QueryMonitoringEventsV2Response":{"content":{"application/json":{}}},"GetMonitoringStatsV2Response":{"content":{"application/json":{}}},"GetMonitoringTimeSeriesV2Response":{"content":{"application/json":{}}},"GetAssociatedMonitoringEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -608,6 +608,57 @@
         },
         "responses": {}
       }
+    },
+    "/v1/integrations/{integrationId}/generate-types-preview": {
+      "post": {
+        "operationId": "generateTypesPreview",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/integrations/{integrationId}/generate-types": {
+      "post": {
+        "operationId": "generateTypes",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
+    "/v1/integrations/{integrationId}/commit-types": {
+      "post": {
+        "operationId": "commitTypes",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
     }
   },
   "components": {

package/dist/openapi.d.ts

@@ -238,6 +238,30 @@ declare namespace Components {
              */
             freshnessThresholdMinutes?: number;
         }
+        export interface CommitTypesRequest {
+            /**
+             * npm package name
+             * example:
+             * @epilot/hems-cleverpv
+             */
+            package_name: string;
+            /**
+             * Package version
+             * example:
+             * 1.0.0
+             */
+            version: string;
+            /**
+             * Type annotations per use case slug
+             */
+            annotations?: {
+                [name: string]: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
+            };
+        }
+        export interface CommitTypesResponse {
+            committed: boolean;
+            warnings?: string[];
+        }
         /**
          * Shared configuration for connector-type integrations
          */
@@ -247,6 +271,24 @@ declare namespace Components {
              */
             base_url?: string;
             auth?: /* Authentication configuration for managed call requests */ ManagedCallAuth;
+            /**
+             * History of generated type package versions
+             */
+            types_versions?: {
+                version: string;
+                package_name: string;
+                generated_at: string; // date-time
+                generated_by: string;
+                status: "active" | "deprecated";
+            }[];
+            /**
+             * Latest active types package version
+             */
+            latest_types_version?: string;
+            /**
+             * Latest active types package name
+             */
+            latest_types_package_name?: string;
         }
         export interface CreateFileProxyUseCaseRequest {
             /**
@@ -328,6 +370,10 @@ declare namespace Components {
              * If true, integration is displayed in read-only mode in the UI to discourage changes
              */
             protected?: boolean;
+            /**
+             * The manifest IDs associated with this integration
+             */
+            _manifest?: string[];
         }
         export interface CreateManagedCallUseCaseRequest {
             /**
@@ -1149,6 +1195,69 @@ declare namespace Components {
              */
             FileProxyUseCaseConfiguration;
         }
+        export interface GenerateTypesPreviewResponse {
+            integration_name?: string;
+            use_cases: /* Scaffolded type descriptors for a single use case */ UseCaseTypePreview[];
+            /**
+             * Previously generated version, if any
+             */
+            previous_version?: string;
+            /**
+             * Suggested next version based on detected changes
+             */
+            suggested_version?: string;
+            suggested_bump?: "major" | "minor";
+            detected_changes?: {
+                slug: string;
+                field: string;
+                type: "breaking" | "non-breaking";
+                description: string;
+            }[];
+        }
+        export interface GenerateTypesRequest {
+            /**
+             * npm package name
+             * example:
+             * @epilot/hems-cleverpv
+             */
+            package_name: string;
+            /**
+             * Package version
+             * example:
+             * 1.0.0
+             */
+            version: string;
+            description?: string;
+            /**
+             * Domain standard package to extend
+             * example:
+             * @epilot/hems
+             */
+            domain_package?: string;
+            /**
+             * Name of the domain UseCaseMap to extend
+             * example:
+             * HemsUseCaseMap
+             */
+            domain_map_name?: string;
+            /**
+             * Type annotations per use case slug
+             */
+            annotations?: {
+                [name: string]: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
+            };
+        }
+        export interface GenerateTypesResponse {
+            package_name: string;
+            version: string;
+            /**
+             * Generated file contents keyed by file path
+             */
+            files: {
+                [name: string]: string;
+            };
+            warnings?: string[];
+        }
         export interface GetMonitoringStatsRequest {
             /**
              * Start date for statistics period (inclusive)
@@ -1458,6 +1567,10 @@ declare namespace Components {
              * If true, integration is displayed in read-only mode in the UI to discourage changes
              */
             protected?: boolean;
+            /**
+             * The manifest IDs associated with this integration
+             */
+            _manifest?: string[];
         }
         export interface IntegrationAppMapping {
             /**
@@ -1525,6 +1638,10 @@ declare namespace Components {
              * If true, integration is displayed in read-only mode in the UI to discourage changes
              */
             protected?: boolean;
+            /**
+             * The manifest IDs associated with this integration
+             */
+            _manifest?: string[];
         }
         export interface IntegrationEntity {
             /**
@@ -1735,6 +1852,10 @@ declare namespace Components {
              * If true, integration is displayed in read-only mode in the UI to discourage changes
              */
             protected?: boolean;
+            /**
+             * The manifest IDs associated with this integration
+             */
+            _manifest?: string[];
             /**
              * All use cases belonging to this integration
              */
@@ -1857,9 +1978,15 @@ declare namespace Components {
              * URL path template with {{variable}} interpolation
              */
             path: string;
+            /**
+             * Custom HTTP headers for the request. Values support {{variable}} interpolation from the request payload and {{env.VAR}} references for environment variables.
+             */
             headers?: {
                 [name: string]: string;
             };
+            /**
+             * Query parameters for the request. Values support {{variable}} interpolation from the request payload.
+             */
             query_params?: {
                 [name: string]: string;
             };
@@ -1921,6 +2048,11 @@ declare namespace Components {
              */
             updated_at: string; // date-time
             configuration?: /* Configuration for managed_call use cases. Defines a single API operation with JSONata mapping. */ ManagedCallOperationConfig;
+            type_annotations?: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
+            /**
+             * Whether types have been generated for this use case
+             */
+            types_locked?: boolean;
         }
         export interface ManagedCallUseCaseHistoryEntry {
             /**
@@ -1968,6 +2100,11 @@ declare namespace Components {
              */
             type: "managed_call";
             configuration?: /* Configuration for managed_call use cases. Defines a single API operation with JSONata mapping. */ ManagedCallOperationConfig;
+            type_annotations?: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
+            /**
+             * Whether types have been generated for this use case
+             */
+            types_locked?: boolean;
         }
         export interface MappingSimulationRequest {
             mapping_configuration: IntegrationConfigurationV1 | IntegrationConfigurationV2;
@@ -3353,6 +3490,67 @@ declare namespace Components {
             end_date?: string;
             event_id?: string;
         }
+        /**
+         * Developer-provided type annotations for a use case's request and response fields
+         */
+        export interface TypeAnnotations {
+            /**
+             * Type annotations for request fields, keyed by dot-path (e.g., "vendors[].id" -> "string")
+             */
+            request?: {
+                [name: string]: string;
+            };
+            /**
+             * Type annotations for response fields
+             */
+            response?: {
+                [name: string]: string;
+            };
+        }
+        /**
+         * Describes the inferred type shape of a JSONata expression
+         */
+        export interface TypeDescriptor {
+            kind: "object" | "array" | "string" | "number" | "boolean" | "null" | "unknown" | "union";
+            /**
+             * For kind=object, the properties and their type descriptors
+             */
+            properties?: {
+                [name: string]: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor;
+            };
+            /**
+             * For kind=array, the type of array items
+             */
+            items?: {
+                kind: "object" | "array" | "string" | "number" | "boolean" | "null" | "unknown" | "union";
+                /**
+                 * For kind=object, the properties and their type descriptors
+                 */
+                properties?: {
+                    [name: string]: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor;
+                };
+                /**
+                 * For kind=array, the type of array items
+                 */
+                items?: any;
+                /**
+                 * For kind=unknown, the JSONata path that produced this value
+                 */
+                source?: string;
+                /**
+                 * For kind=union, the variant types
+                 */
+                variants?: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor[];
+            };
+            /**
+             * For kind=unknown, the JSONata path that produced this value
+             */
+            source?: string;
+            /**
+             * For kind=union, the variant types
+             */
+            variants?: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor[];
+        }
         export interface UpdateFileProxyUseCaseRequest {
             /**
              * Use case name
@@ -3433,6 +3631,7 @@ declare namespace Components {
              */
             type?: "managed_call";
             configuration?: /* Configuration for managed_call use cases. Defines a single API operation with JSONata mapping. */ ManagedCallOperationConfig;
+            type_annotations?: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
         }
         export interface UpdateOutboundUseCaseRequest {
             /**
@@ -3543,6 +3742,10 @@ declare namespace Components {
              * If true, integration is displayed in read-only mode in the UI to discourage changes
              */
             protected?: boolean;
+            /**
+             * The manifest IDs associated with this integration
+             */
+            _manifest?: string[];
             /**
              * Full list of use cases (declarative). This replaces ALL existing use cases.
              * - Use cases with an `id` field matching an existing use case will be updated
@@ -3632,6 +3835,16 @@ declare namespace Components {
              */
             history_created_at: string; // date-time
         }
+        /**
+         * Scaffolded type descriptors for a single use case
+         */
+        export interface UseCaseTypePreview {
+            slug: string;
+            name?: string;
+            request_shape: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor;
+            response_shape: /* Describes the inferred type shape of a JSONata expression */ TypeDescriptor;
+            existing_annotations?: /* Developer-provided type annotations for a use case's request and response fields */ TypeAnnotations;
+        }
         export interface WebhookStatus {
             /**
              * Unique identifier for the webhook
@@ -3670,6 +3883,22 @@ declare namespace Paths {
             }
         }
     }
+    namespace CommitTypes {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.CommitTypesRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.CommitTypesResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace CreateIntegration {
         export type RequestBody = Components.Schemas.CreateIntegrationRequest;
         namespace Responses {
@@ -3782,6 +4011,37 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GenerateTypes {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.GenerateTypesRequest;
+        namespace Responses {
+            export type $200 = Components.Schemas.GenerateTypesResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
+    namespace GenerateTypesPreview {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.GenerateTypesPreviewResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetAssociatedMonitoringEvents {
         namespace Parameters {
             export type EventId = string;
@@ -4760,6 +5020,39 @@ export interface OperationMethods {
     data?: Paths.ManagedCallExecute.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ManagedCallExecute.Responses.$200>
+  /**
+   * generateTypesPreview - Preview scaffolded types for a connector integration
+   * 
+   * Analyses the JSONata mappings of all managed-call use cases in the integration and returns scaffolded type descriptors. The frontend uses these to show the type editor modal where developers fill in leaf types.
+   * 
+   */
+  'generateTypesPreview'(
+    parameters?: Parameters<Paths.GenerateTypesPreview.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GenerateTypesPreview.Responses.$200>
+  /**
+   * generateTypes - Generate a TypeScript npm package for a connector integration
+   * 
+   * Generates a complete TypeScript npm package with typed interfaces for all managed-call use cases. This is a stateless operation that does not persist any changes. Use the commit-types endpoint to lock configurations after review.
+   * 
+   */
+  'generateTypes'(
+    parameters?: Parameters<Paths.GenerateTypes.PathParameters> | null,
+    data?: Paths.GenerateTypes.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GenerateTypes.Responses.$200>
+  /**
+   * commitTypes - Commit generated types and lock use case configurations
+   * 
+   * Commits the generated types by locking use case configurations and updating version tracking. Should be called after the user reviews and downloads the generated package.
+   * 
+   */
+  'commitTypes'(
+    parameters?: Parameters<Paths.CommitTypes.PathParameters> | null,
+    data?: Paths.CommitTypes.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CommitTypes.Responses.$200>
 }
 
 export interface PathsDictionary {
@@ -5287,6 +5580,45 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ManagedCallExecute.Responses.$200>
   }
+  ['/v1/integrations/{integrationId}/generate-types-preview']: {
+    /**
+     * generateTypesPreview - Preview scaffolded types for a connector integration
+     * 
+     * Analyses the JSONata mappings of all managed-call use cases in the integration and returns scaffolded type descriptors. The frontend uses these to show the type editor modal where developers fill in leaf types.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.GenerateTypesPreview.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GenerateTypesPreview.Responses.$200>
+  }
+  ['/v1/integrations/{integrationId}/generate-types']: {
+    /**
+     * generateTypes - Generate a TypeScript npm package for a connector integration
+     * 
+     * Generates a complete TypeScript npm package with typed interfaces for all managed-call use cases. This is a stateless operation that does not persist any changes. Use the commit-types endpoint to lock configurations after review.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.GenerateTypes.PathParameters> | null,
+      data?: Paths.GenerateTypes.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GenerateTypes.Responses.$200>
+  }
+  ['/v1/integrations/{integrationId}/commit-types']: {
+    /**
+     * commitTypes - Commit generated types and lock use case configurations
+     * 
+     * Commits the generated types by locking use case configurations and updating version tracking. Should be called after the user reviews and downloads the generated package.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.CommitTypes.PathParameters> | null,
+      data?: Paths.CommitTypes.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CommitTypes.Responses.$200>
+  }
 }
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
@@ -5294,6 +5626,8 @@ export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 export type AccessLogEntry = Components.Schemas.AccessLogEntry;
 export type AutoRefreshSettings = Components.Schemas.AutoRefreshSettings;
+export type CommitTypesRequest = Components.Schemas.CommitTypesRequest;
+export type CommitTypesResponse = Components.Schemas.CommitTypesResponse;
 export type ConnectorConfig = Components.Schemas.ConnectorConfig;
 export type CreateFileProxyUseCaseRequest = Components.Schemas.CreateFileProxyUseCaseRequest;
 export type CreateInboundUseCaseRequest = Components.Schemas.CreateInboundUseCaseRequest;
@@ -5330,6 +5664,9 @@ export type FileProxyUrlParams = Components.Schemas.FileProxyUrlParams;
 export type FileProxyUseCase = Components.Schemas.FileProxyUseCase;
 export type FileProxyUseCaseConfiguration = Components.Schemas.FileProxyUseCaseConfiguration;
 export type FileProxyUseCaseHistoryEntry = Components.Schemas.FileProxyUseCaseHistoryEntry;
+export type GenerateTypesPreviewResponse = Components.Schemas.GenerateTypesPreviewResponse;
+export type GenerateTypesRequest = Components.Schemas.GenerateTypesRequest;
+export type GenerateTypesResponse = Components.Schemas.GenerateTypesResponse;
 export type GetMonitoringStatsRequest = Components.Schemas.GetMonitoringStatsRequest;
 export type GetMonitoringStatsV2Request = Components.Schemas.GetMonitoringStatsV2Request;
 export type GetMonitoringTimeSeriesRequest = Components.Schemas.GetMonitoringTimeSeriesRequest;
@@ -5401,6 +5738,8 @@ export type TimeSeriesBucket = Components.Schemas.TimeSeriesBucket;
 export type TimeSeriesBucketV2 = Components.Schemas.TimeSeriesBucketV2;
 export type TriggerErpActionRequest = Components.Schemas.TriggerErpActionRequest;
 export type TriggerWebhookResp = Components.Schemas.TriggerWebhookResp;
+export type TypeAnnotations = Components.Schemas.TypeAnnotations;
+export type TypeDescriptor = Components.Schemas.TypeDescriptor;
 export type UpdateFileProxyUseCaseRequest = Components.Schemas.UpdateFileProxyUseCaseRequest;
 export type UpdateInboundUseCaseRequest = Components.Schemas.UpdateInboundUseCaseRequest;
 export type UpdateIntegrationRequest = Components.Schemas.UpdateIntegrationRequest;
@@ -5414,4 +5753,5 @@ export type UseCase = Components.Schemas.UseCase;
 export type UseCaseBase = Components.Schemas.UseCaseBase;
 export type UseCaseHistoryEntry = Components.Schemas.UseCaseHistoryEntry;
 export type UseCaseHistoryEntryBase = Components.Schemas.UseCaseHistoryEntryBase;
+export type UseCaseTypePreview = Components.Schemas.UseCaseTypePreview;
 export type WebhookStatus = Components.Schemas.WebhookStatus;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.51.0",
+    "version": "0.58.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -2668,6 +2668,176 @@
           }
         }
       }
+    },
+    "/v1/integrations/{integrationId}/generate-types-preview": {
+      "post": {
+        "operationId": "generateTypesPreview",
+        "summary": "Preview scaffolded types for a connector integration",
+        "description": "Analyses the JSONata mappings of all managed-call use cases in the integration and returns scaffolded type descriptors. The frontend uses these to show the type editor modal where developers fill in leaf types.\n",
+        "tags": [
+          "integrations"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Scaffolded type preview",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GenerateTypesPreviewResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/integrations/{integrationId}/generate-types": {
+      "post": {
+        "operationId": "generateTypes",
+        "summary": "Generate a TypeScript npm package for a connector integration",
+        "description": "Generates a complete TypeScript npm package with typed interfaces for all managed-call use cases. This is a stateless operation that does not persist any changes. Use the commit-types endpoint to lock configurations after review.\n",
+        "tags": [
+          "integrations"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GenerateTypesRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Generated package",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GenerateTypesResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/integrations/{integrationId}/commit-types": {
+      "post": {
+        "operationId": "commitTypes",
+        "summary": "Commit generated types and lock use case configurations",
+        "description": "Commits the generated types by locking use case configurations and updating version tracking. Should be called after the user reviews and downloads the generated package.\n",
+        "tags": [
+          "integrations"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommitTypesRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Types committed successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommitTypesResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -3026,6 +3196,13 @@
           "protected": {
             "type": "boolean",
             "description": "If true, integration is displayed in read-only mode in the UI to discourage changes"
+          },
+          "_manifest": {
+            "type": "array",
+            "description": "The manifest IDs associated with this integration",
+            "items": {
+              "type": "string"
+            }
           }
         }
       },
@@ -3039,6 +3216,50 @@
           },
           "auth": {
             "$ref": "#/components/schemas/ManagedCallAuth"
+          },
+          "types_versions": {
+            "type": "array",
+            "description": "History of generated type package versions",
+            "items": {
+              "type": "object",
+              "required": [
+                "version",
+                "package_name",
+                "generated_at",
+                "generated_by",
+                "status"
+              ],
+              "properties": {
+                "version": {
+                  "type": "string"
+                },
+                "package_name": {
+                  "type": "string"
+                },
+                "generated_at": {
+                  "type": "string",
+                  "format": "date-time"
+                },
+                "generated_by": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "active",
+                    "deprecated"
+                  ]
+                }
+              }
+            }
+          },
+          "latest_types_version": {
+            "type": "string",
+            "description": "Latest active types package version"
+          },
+          "latest_types_package_name": {
+            "type": "string",
+            "description": "Latest active types package name"
           }
         }
       },
@@ -4032,6 +4253,13 @@
               },
               "configuration": {
                 "$ref": "#/components/schemas/ManagedCallOperationConfig"
+              },
+              "type_annotations": {
+                "$ref": "#/components/schemas/TypeAnnotations"
+              },
+              "types_locked": {
+                "type": "boolean",
+                "description": "Whether types have been generated for this use case"
               }
             }
           }
@@ -4411,6 +4639,9 @@
               },
               "configuration": {
                 "$ref": "#/components/schemas/ManagedCallOperationConfig"
+              },
+              "type_annotations": {
+                "$ref": "#/components/schemas/TypeAnnotations"
               }
             }
           }
@@ -4624,6 +4855,13 @@
               },
               "configuration": {
                 "$ref": "#/components/schemas/ManagedCallOperationConfig"
+              },
+              "type_annotations": {
+                "$ref": "#/components/schemas/TypeAnnotations"
+              },
+              "types_locked": {
+                "type": "boolean",
+                "description": "Whether types have been generated for this use case"
               }
             }
           }
@@ -4866,12 +5104,14 @@
           },
           "headers": {
             "type": "object",
+            "description": "Custom HTTP headers for the request. Values support {{variable}} interpolation from the request payload and {{env.VAR}} references for environment variables.",
             "additionalProperties": {
               "type": "string"
             }
           },
           "query_params": {
             "type": "object",
+            "description": "Query parameters for the request. Values support {{variable}} interpolation from the request payload.",
             "additionalProperties": {
               "type": "string"
             }
@@ -4934,6 +5174,273 @@
           }
         }
       },
+      "TypeAnnotations": {
+        "type": "object",
+        "description": "Developer-provided type annotations for a use case's request and response fields",
+        "properties": {
+          "request": {
+            "type": "object",
+            "description": "Type annotations for request fields, keyed by dot-path (e.g., \"vendors[].id\" -> \"string\")",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "response": {
+            "type": "object",
+            "description": "Type annotations for response fields",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "TypeDescriptor": {
+        "type": "object",
+        "description": "Describes the inferred type shape of a JSONata expression",
+        "required": [
+          "kind"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "enum": [
+              "object",
+              "array",
+              "string",
+              "number",
+              "boolean",
+              "null",
+              "unknown",
+              "union"
+            ]
+          },
+          "properties": {
+            "type": "object",
+            "description": "For kind=object, the properties and their type descriptors",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/TypeDescriptor"
+            }
+          },
+          "items": {
+            "description": "For kind=array, the type of array items",
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/TypeDescriptor"
+              }
+            ]
+          },
+          "source": {
+            "type": "string",
+            "description": "For kind=unknown, the JSONata path that produced this value"
+          },
+          "variants": {
+            "type": "array",
+            "description": "For kind=union, the variant types",
+            "items": {
+              "$ref": "#/components/schemas/TypeDescriptor"
+            }
+          }
+        }
+      },
+      "UseCaseTypePreview": {
+        "type": "object",
+        "description": "Scaffolded type descriptors for a single use case",
+        "required": [
+          "slug",
+          "request_shape",
+          "response_shape"
+        ],
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "request_shape": {
+            "$ref": "#/components/schemas/TypeDescriptor"
+          },
+          "response_shape": {
+            "$ref": "#/components/schemas/TypeDescriptor"
+          },
+          "existing_annotations": {
+            "$ref": "#/components/schemas/TypeAnnotations"
+          }
+        }
+      },
+      "GenerateTypesPreviewResponse": {
+        "type": "object",
+        "required": [
+          "use_cases"
+        ],
+        "properties": {
+          "integration_name": {
+            "type": "string"
+          },
+          "use_cases": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UseCaseTypePreview"
+            }
+          },
+          "previous_version": {
+            "type": "string",
+            "description": "Previously generated version, if any"
+          },
+          "suggested_version": {
+            "type": "string",
+            "description": "Suggested next version based on detected changes"
+          },
+          "suggested_bump": {
+            "type": "string",
+            "enum": [
+              "major",
+              "minor"
+            ]
+          },
+          "detected_changes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "slug",
+                "field",
+                "type",
+                "description"
+              ],
+              "properties": {
+                "slug": {
+                  "type": "string"
+                },
+                "field": {
+                  "type": "string"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "breaking",
+                    "non-breaking"
+                  ]
+                },
+                "description": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "GenerateTypesRequest": {
+        "type": "object",
+        "required": [
+          "package_name",
+          "version"
+        ],
+        "properties": {
+          "package_name": {
+            "type": "string",
+            "description": "npm package name",
+            "example": "@epilot/hems-cleverpv"
+          },
+          "version": {
+            "type": "string",
+            "description": "Package version",
+            "example": "1.0.0"
+          },
+          "description": {
+            "type": "string"
+          },
+          "domain_package": {
+            "type": "string",
+            "description": "Domain standard package to extend",
+            "example": "@epilot/hems"
+          },
+          "domain_map_name": {
+            "type": "string",
+            "description": "Name of the domain UseCaseMap to extend",
+            "example": "HemsUseCaseMap"
+          },
+          "annotations": {
+            "type": "object",
+            "description": "Type annotations per use case slug",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/TypeAnnotations"
+            }
+          }
+        }
+      },
+      "GenerateTypesResponse": {
+        "type": "object",
+        "required": [
+          "package_name",
+          "version",
+          "files"
+        ],
+        "properties": {
+          "package_name": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          },
+          "files": {
+            "type": "object",
+            "description": "Generated file contents keyed by file path",
+            "additionalProperties": {
+              "type": "string"
+            }
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "CommitTypesRequest": {
+        "type": "object",
+        "required": [
+          "package_name",
+          "version"
+        ],
+        "properties": {
+          "package_name": {
+            "type": "string",
+            "description": "npm package name",
+            "example": "@epilot/hems-cleverpv"
+          },
+          "version": {
+            "type": "string",
+            "description": "Package version",
+            "example": "1.0.0"
+          },
+          "annotations": {
+            "type": "object",
+            "description": "Type annotations per use case slug",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/TypeAnnotations"
+            }
+          }
+        }
+      },
+      "CommitTypesResponse": {
+        "type": "object",
+        "required": [
+          "committed"
+        ],
+        "properties": {
+          "committed": {
+            "type": "boolean"
+          },
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "FileProxyUseCaseConfiguration": {
         "type": "object",
         "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/erp-integration-client",
-  "version": "0.30.0-rc3",
+  "version": "0.31.0",
   "description": "Client library for ePilot ERP Integration API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/.claude/settings.local.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(pnpm install:*)"
-    ]
-  }
-}