@epilot/sdk 2.18.5 → 2.18.7

package/dist/{integration-toolkit.d-E2nrIdIM.d.cts → integration-toolkit.d-CVI89-A-.d.cts}

@@ -1338,10 +1338,11 @@ declare namespace Components {
              */
             latest_types_package_name?: string;
         }
+        /**
+         * Register an already-uploaded file as an import. The use case is chosen later, via `:validate` — upload and interpretation are separate decisions.
+         */
         export interface CreateErpImportRequest {
             s3_reference: S3Reference;
-            integration_id: string;
-            use_case_slug?: string;
         }
         export interface CreateErpImportResponse {
             /**
@@ -2066,14 +2067,17 @@ declare namespace Components {
             import_id: string;
             org_id: string;
             created_by?: string;
-            integration_id: string;
             /**
-             * The inbound use case whose mapping drives both phases.
+             * The integration owning the chosen use case. Absent until the first `:validate`.
+             */
+            integration_id?: string;
+            /**
+             * The inbound use case whose mapping drives both phases. Absent until the first `:validate`, and MUTABLE — re-validating with a different use case replaces it.
              */
             use_case_slug?: string;
             format: "csv" | "xlsx";
             /**
-             * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. IMPORTED, FAILED and CANCELLED are terminal and final.
+             * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. Only IMPORTED and CANCELLED are terminal. READY and FAILED both accept a further `:validate`, which is how a wrong use case is corrected without re-uploading the file.
              * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.code = VALIDATION_BLOCKED.
              * READY is legitimately idle for as long as the user takes to confirm, so it carries no running work and never goes stale.
              * CANCELLING is transient and cooperative: the abort has been recorded but the worker only notices at its next batch boundary. Rows already published stay published — a stop is not a rollback.
@@ -2116,6 +2120,20 @@ declare namespace Components {
              */
             total_rows?: number;
         }
+        export interface ErpImportUseCaseSuggestion {
+            integration_id: string;
+            integration_name: string;
+            use_case_slug: string;
+            use_case_name: string;
+            /**
+             * How many of the FILE's columns this use case reads, by exact trimmed name.
+             */
+            matched_columns: number;
+            /**
+             * Columns in the file. Identical across entries; repeated per entry so each row renders standalone as "matches N of your M columns".
+             */
+            file_columns: number;
+        }
         /**
          * Validate-phase summary: what the file will create, and whether it may be confirmed. Absent until the validate phase completes. No per-row detail is kept — a rejected file is corrected and imported again.
          */
@@ -6172,6 +6190,9 @@ declare namespace Components {
              */
             overwrite?: boolean;
         }
+        export interface SuggestErpImportUseCasesResponse {
+            suggestions: ErpImportUseCaseSuggestion[];
+        }
         export interface TestNotificationRequest {
             /**
              * The kind of notification to render and send.
@@ -6724,6 +6745,13 @@ declare namespace Components {
             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 ValidateErpImportRequest {
+            integration_id: string;
+            /**
+             * An inbound use case's slug, unique within its integration.
+             */
+            use_case_slug: string;
+        }
         /**
          * Push delivery of the transformed event to a webhook via svc-webhooks
          */
@@ -6832,7 +6860,7 @@ declare namespace Paths {
         }
     }
     namespace CreateErpImport {
-        export type RequestBody = Components.Schemas.CreateErpImportRequest;
+        export type RequestBody = /* Register an already-uploaded file as an import. The use case is chosen later, via `:validate` — upload and interpretation are separate decisions. */ Components.Schemas.CreateErpImportRequest;
         namespace Responses {
             export type $202 = Components.Schemas.CreateErpImportResponse;
             export type $400 = Components.Responses.BadRequest;
@@ -7660,6 +7688,21 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace SuggestErpImportUseCases {
+        namespace Parameters {
+            export type ImportId = string;
+        }
+        export interface PathParameters {
+            importId: Parameters.ImportId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.SuggestErpImportUseCasesResponse;
+            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 TestSendNotification {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -7800,6 +7843,23 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace ValidateErpImport {
+        namespace Parameters {
+            export type ImportId = string;
+        }
+        export interface PathParameters {
+            importId: Parameters.ImportId;
+        }
+        export type RequestBody = Components.Schemas.ValidateErpImportRequest;
+        namespace Responses {
+            export type $202 = Components.Schemas.ErpImportJob;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $409 = Components.Responses.Conflict;
+            export type $422 = Components.Schemas.ErrorResponseBase;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
 }
 
 
@@ -8549,7 +8609,7 @@ interface OperationMethods {
   /**
    * createErpImport - createErpImport
    * 
-   * Create a pricing-file import job from an already-uploaded file (S3 ref). Returns a job id and starts the validate phase asynchronously — poll GET /v2/erp/imports/{importId}.
+   * Register an already-uploaded file (S3 ref) as a pricing-file import job and return its id. Nothing runs yet: no use case is chosen and no validation starts here. Rank the candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start the validate phase with POST /v2/erp/imports/{importId}:validate.
    */
   'createErpImport'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -8566,6 +8626,29 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetErpImport.Responses.$200>
+  /**
+   * validateErpImport - validateErpImport
+   * 
+   * Choose the use case to read this file with, and start the validate phase.
+   * Callable from PENDING, READY and FAILED — so a wrong choice is corrected by calling this again with a different use case, rather than re-uploading. Each call replaces any previous verdict. Any other status returns 409.
+   */
+  'validateErpImport'(
+    parameters?: Parameters<Paths.ValidateErpImport.PathParameters> | null,
+    data?: Paths.ValidateErpImport.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ValidateErpImport.Responses.$202>
+  /**
+   * suggestErpImportUseCases - suggestErpImportUseCases
+   * 
+   * Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Reads only the file's first row, not its data.
+   * Every eligible use case is returned, including ones matching nothing: the "nothing fits, pick anyway" view needs the full list. Highest match first.
+   * CSV only — an xlsx import fails with 400 rather than silently returning zero matches, which would look identical to "we checked and nothing matches".
+   */
+  'suggestErpImportUseCases'(
+    parameters?: Parameters<Paths.SuggestErpImportUseCases.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.SuggestErpImportUseCases.Responses.$200>
   /**
    * executeErpImport - executeErpImport
    * 
@@ -9412,7 +9495,7 @@ interface PathsDictionary {
     /**
      * createErpImport - createErpImport
      * 
-     * Create a pricing-file import job from an already-uploaded file (S3 ref). Returns a job id and starts the validate phase asynchronously — poll GET /v2/erp/imports/{importId}.
+     * Register an already-uploaded file (S3 ref) as a pricing-file import job and return its id. Nothing runs yet: no use case is chosen and no validation starts here. Rank the candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start the validate phase with POST /v2/erp/imports/{importId}:validate.
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -9447,6 +9530,33 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetErpImport.Responses.$200>
   }
+  ['/v2/erp/imports/{importId}:validate']: {
+    /**
+     * validateErpImport - validateErpImport
+     * 
+     * Choose the use case to read this file with, and start the validate phase.
+     * Callable from PENDING, READY and FAILED — so a wrong choice is corrected by calling this again with a different use case, rather than re-uploading. Each call replaces any previous verdict. Any other status returns 409.
+     */
+    'post'(
+      parameters?: Parameters<Paths.ValidateErpImport.PathParameters> | null,
+      data?: Paths.ValidateErpImport.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ValidateErpImport.Responses.$202>
+  }
+  ['/v2/erp/imports/{importId}:suggest-use-cases']: {
+    /**
+     * suggestErpImportUseCases - suggestErpImportUseCases
+     * 
+     * Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Reads only the file's first row, not its data.
+     * Every eligible use case is returned, including ones matching nothing: the "nothing fits, pick anyway" view needs the full list. Highest match first.
+     * CSV only — an xlsx import fails with 400 rather than silently returning zero matches, which would look identical to "we checked and nothing matches".
+     */
+    'post'(
+      parameters?: Parameters<Paths.SuggestErpImportUseCases.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.SuggestErpImportUseCases.Responses.$200>
+  }
   ['/v2/erp/imports/{importId}:execute']: {
     /**
      * executeErpImport - executeErpImport
@@ -9516,6 +9626,7 @@ type ErpImportIssue = Components.Schemas.ErpImportIssue;
 type ErpImportJob = Components.Schemas.ErpImportJob;
 type ErpImportList = Components.Schemas.ErpImportList;
 type ErpImportProgress = Components.Schemas.ErpImportProgress;
+type ErpImportUseCaseSuggestion = Components.Schemas.ErpImportUseCaseSuggestion;
 type ErpImportValidation = Components.Schemas.ErpImportValidation;
 type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
 type ErpUpdatesEventsV3Request = Components.Schemas.ErpUpdatesEventsV3Request;
@@ -9635,6 +9746,7 @@ type SecureProxyUseCaseHistoryEntry = Components.Schemas.SecureProxyUseCaseHisto
 type SecureProxyWhitelist = Components.Schemas.SecureProxyWhitelist;
 type SecureProxyWhitelistUpdate = Components.Schemas.SecureProxyWhitelistUpdate;
 type SetIntegrationAppMappingRequest = Components.Schemas.SetIntegrationAppMappingRequest;
+type SuggestErpImportUseCasesResponse = Components.Schemas.SuggestErpImportUseCasesResponse;
 type TestNotificationRequest = Components.Schemas.TestNotificationRequest;
 type TestNotificationResponse = Components.Schemas.TestNotificationResponse;
 type TimeSeriesBreakdownItemV2 = Components.Schemas.TimeSeriesBreakdownItemV2;
@@ -9660,7 +9772,8 @@ type UseCaseBase = Components.Schemas.UseCaseBase;
 type UseCaseHistoryEntry = Components.Schemas.UseCaseHistoryEntry;
 type UseCaseHistoryEntryBase = Components.Schemas.UseCaseHistoryEntryBase;
 type UseCaseTypePreview = Components.Schemas.UseCaseTypePreview;
+type ValidateErpImportRequest = Components.Schemas.ValidateErpImportRequest;
 type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
 type WebhookStatus = Components.Schemas.WebhookStatus;
 
-export { type FileProxyStep as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportValidation as R, type ErpUpdatesEventsV2Request as S, type ErpUpdatesEventsV3Request as T, type ErrorResponseBase as U, type ExecuteErpImportRequest as V, type ExternalMonitoringSpan as W, type FileProxyAuth as X, type FileProxyParam as Y, type FileProxyResponseConfig as Z, type FileProxySecureProxyAttachment as _, Components as a, type OutboundIntegrationEventConfiguration as a$, type FileProxyUrlConfig as a0, type FileProxyUrlParam as a1, type FileProxyUrlParams as a2, type FileProxyUseCase as a3, type FileProxyUseCaseConfiguration as a4, type FileProxyUseCaseHistoryEntry as a5, type GenerateTypesPreviewResponse as a6, type GenerateTypesRequest as a7, type GenerateTypesResponse as a8, type GetMonitoringStatsRequest as a9, type ManagedCallOperation as aA, type ManagedCallOperationConfig as aB, type ManagedCallUseCase as aC, type ManagedCallUseCaseHistoryEntry as aD, type MappingSimulationRequest as aE, type MappingSimulationResponse as aF, type MappingSimulationV2Request as aG, type MappingSimulationWarning as aH, type MeterReadingPruneScopeConfig as aI, type MeterReadingPruneScopeUpdate as aJ, type MeterReadingUpdate as aK, type MeterUniqueIdsConfig as aL, type MonitoringEventV2 as aM, type MonitoringStats as aN, type MonitoringStatsV2 as aO, type MonitoringTraceResponse as aP, type NotificationChannelSet as aQ, type NotificationDigestConfig as aR, type NotificationHistoryItem as aS, type NotificationHistoryResponse as aT, type NotificationRecipient as aU, type NotificationRule as aV, type NotificationRuleStatus as aW, type NotificationStatusResponse as aX, type OutboundConflict as aY, type OutboundDlqListResponse as aZ, type OutboundDlqMessage as a_, type GetMonitoringStatsV2Request as aa, type GetMonitoringTimeSeriesRequest as ab, type GetMonitoringTimeSeriesV2Request as ac, type InboundIntegrationEventConfiguration as ad, type InboundMonitoringEvent as ae, type InboundUseCase as af, type InboundUseCaseHistoryEntry as ag, type IngestExternalMonitoringEventsRequest as ah, type IngestExternalMonitoringEventsResponse as ai, type Integration as aj, type IntegrationAppMapping as ak, type IntegrationConfigurationV1 as al, type IntegrationConfigurationV2 as am, type IntegrationEditableFields as an, type IntegrationEntity as ao, type IntegrationEntityField as ap, type IntegrationFieldV1 as aq, type IntegrationMeterReading as ar, type IntegrationNotificationConfig as as, type IntegrationObjectV1 as at, type IntegrationSettings as au, type IntegrationWithUseCases as av, type ManagedCallAuth as aw, type ManagedCallErrorResponse as ax, type ManagedCallExecuteRequest as ay, type ManagedCallExecuteResponse as az, type PathsDictionary as b, type UpsertIntegrationWithUseCasesRequest as b$, type OutboundMapping as b0, type OutboundMessage as b1, type OutboundMonitoringEvent as b2, type OutboundPollStatus as b3, type OutboundStatusResponse as b4, type OutboundUseCase as b5, type OutboundUseCaseHistoryEntry as b6, type OutboundUseCaseStatus as b7, type PollDeliveryConfig as b8, type PollOutboundMessagesRequest as b9, type SecureProxySummary as bA, type SecureProxyUpstreamError as bB, type SecureProxyUseCase as bC, type SecureProxyUseCaseConfiguration as bD, type SecureProxyUseCaseHistoryEntry as bE, type SecureProxyWhitelist as bF, type SecureProxyWhitelistUpdate as bG, type SetIntegrationAppMappingRequest as bH, type TestNotificationRequest as bI, type TestNotificationResponse as bJ, type TimeSeriesBreakdownItemV2 as bK, type TimeSeriesBucket as bL, type TimeSeriesBucketV2 as bM, type TriggerErpActionRequest as bN, type TriggerWebhookResp as bO, type TypeAnnotations as bP, type TypeDescriptor as bQ, type UnblockOutboundStreamRequest as bR, type UnblockOutboundStreamResponse as bS, type UpdateFileProxyUseCaseRequest as bT, type UpdateInboundUseCaseRequest as bU, type UpdateIntegrationRequest as bV, type UpdateManagedCallUseCaseRequest as bW, type UpdateOutboundUseCaseRequest as bX, type UpdateSecureProxyUseCaseRequest as bY, type UpdateUseCaseRequest as bZ, type UpdateUseCaseRequestBase as b_, type PollOutboundMessagesResponse as ba, type PortalOrigin as bb, type PortalRefConfig as bc, type PortalRefFilter as bd, type PruneScopeConfig as be, type QueryAccessLogsRequest as bf, type QueryEventsRequest as bg, type QueryInboundMonitoringEventsRequest as bh, type QueryMonitoringEventsV2Request as bi, type QueryOutboundMonitoringEventsRequest as bj, type RedriveOutboundDlqRequest as bk, type RedriveOutboundDlqResponse as bl, type RedriveOutboundDlqResult as bm, type RelationConfig as bn, type RelationItemConfig as bo, type RelationRefItemConfig as bp, type RelationRefValueConfig as bq, type RelationRefsConfig as br, type RelationUniqueIdField as bs, type RepeatableFieldType as bt, type ReplayEventsRequest as bu, type RuleBaselineBucket as bv, type RuleBaselineStatus as bw, type S3Reference as bx, type SecureProxyRequest as by, type SecureProxyResponse as bz, type AckOutboundMessagesRequest as c, type UseCase as c0, type UseCaseBase as c1, type UseCaseHistoryEntry as c2, type UseCaseHistoryEntryBase as c3, type UseCaseTypePreview as c4, type WebhookDeliveryConfig as c5, type WebhookStatus as c6, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
+export { type FileProxySecureProxyAttachment as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportUseCaseSuggestion as R, type ErpImportValidation as S, type ErpUpdatesEventsV2Request as T, type ErpUpdatesEventsV3Request as U, type ErrorResponseBase as V, type ExecuteErpImportRequest as W, type ExternalMonitoringSpan as X, type FileProxyAuth as Y, type FileProxyParam as Z, type FileProxyResponseConfig as _, Components as a, type OutboundDlqMessage as a$, type FileProxyStep as a0, type FileProxyUrlConfig as a1, type FileProxyUrlParam as a2, type FileProxyUrlParams as a3, type FileProxyUseCase as a4, type FileProxyUseCaseConfiguration as a5, type FileProxyUseCaseHistoryEntry as a6, type GenerateTypesPreviewResponse as a7, type GenerateTypesRequest as a8, type GenerateTypesResponse as a9, type ManagedCallExecuteResponse as aA, type ManagedCallOperation as aB, type ManagedCallOperationConfig as aC, type ManagedCallUseCase as aD, type ManagedCallUseCaseHistoryEntry as aE, type MappingSimulationRequest as aF, type MappingSimulationResponse as aG, type MappingSimulationV2Request as aH, type MappingSimulationWarning as aI, type MeterReadingPruneScopeConfig as aJ, type MeterReadingPruneScopeUpdate as aK, type MeterReadingUpdate as aL, type MeterUniqueIdsConfig as aM, type MonitoringEventV2 as aN, type MonitoringStats as aO, type MonitoringStatsV2 as aP, type MonitoringTraceResponse as aQ, type NotificationChannelSet as aR, type NotificationDigestConfig as aS, type NotificationHistoryItem as aT, type NotificationHistoryResponse as aU, type NotificationRecipient as aV, type NotificationRule as aW, type NotificationRuleStatus as aX, type NotificationStatusResponse as aY, type OutboundConflict as aZ, type OutboundDlqListResponse as a_, type GetMonitoringStatsRequest as aa, type GetMonitoringStatsV2Request as ab, type GetMonitoringTimeSeriesRequest as ac, type GetMonitoringTimeSeriesV2Request as ad, type InboundIntegrationEventConfiguration as ae, type InboundMonitoringEvent as af, type InboundUseCase as ag, type InboundUseCaseHistoryEntry as ah, type IngestExternalMonitoringEventsRequest as ai, type IngestExternalMonitoringEventsResponse as aj, type Integration as ak, type IntegrationAppMapping as al, type IntegrationConfigurationV1 as am, type IntegrationConfigurationV2 as an, type IntegrationEditableFields as ao, type IntegrationEntity as ap, type IntegrationEntityField as aq, type IntegrationFieldV1 as ar, type IntegrationMeterReading as as, type IntegrationNotificationConfig as at, type IntegrationObjectV1 as au, type IntegrationSettings as av, type IntegrationWithUseCases as aw, type ManagedCallAuth as ax, type ManagedCallErrorResponse as ay, type ManagedCallExecuteRequest as az, type PathsDictionary as b, type UpdateUseCaseRequest as b$, type OutboundIntegrationEventConfiguration as b0, type OutboundMapping as b1, type OutboundMessage as b2, type OutboundMonitoringEvent as b3, type OutboundPollStatus as b4, type OutboundStatusResponse as b5, type OutboundUseCase as b6, type OutboundUseCaseHistoryEntry as b7, type OutboundUseCaseStatus as b8, type PollDeliveryConfig as b9, type SecureProxyResponse as bA, type SecureProxySummary as bB, type SecureProxyUpstreamError as bC, type SecureProxyUseCase as bD, type SecureProxyUseCaseConfiguration as bE, type SecureProxyUseCaseHistoryEntry as bF, type SecureProxyWhitelist as bG, type SecureProxyWhitelistUpdate as bH, type SetIntegrationAppMappingRequest as bI, type SuggestErpImportUseCasesResponse as bJ, type TestNotificationRequest as bK, type TestNotificationResponse as bL, type TimeSeriesBreakdownItemV2 as bM, type TimeSeriesBucket as bN, type TimeSeriesBucketV2 as bO, type TriggerErpActionRequest as bP, type TriggerWebhookResp as bQ, type TypeAnnotations as bR, type TypeDescriptor as bS, type UnblockOutboundStreamRequest as bT, type UnblockOutboundStreamResponse as bU, type UpdateFileProxyUseCaseRequest as bV, type UpdateInboundUseCaseRequest as bW, type UpdateIntegrationRequest as bX, type UpdateManagedCallUseCaseRequest as bY, type UpdateOutboundUseCaseRequest as bZ, type UpdateSecureProxyUseCaseRequest as b_, type PollOutboundMessagesRequest as ba, type PollOutboundMessagesResponse as bb, type PortalOrigin as bc, type PortalRefConfig as bd, type PortalRefFilter as be, type PruneScopeConfig as bf, type QueryAccessLogsRequest as bg, type QueryEventsRequest as bh, type QueryInboundMonitoringEventsRequest as bi, type QueryMonitoringEventsV2Request as bj, type QueryOutboundMonitoringEventsRequest as bk, type RedriveOutboundDlqRequest as bl, type RedriveOutboundDlqResponse as bm, type RedriveOutboundDlqResult as bn, type RelationConfig as bo, type RelationItemConfig as bp, type RelationRefItemConfig as bq, type RelationRefValueConfig as br, type RelationRefsConfig as bs, type RelationUniqueIdField as bt, type RepeatableFieldType as bu, type ReplayEventsRequest as bv, type RuleBaselineBucket as bw, type RuleBaselineStatus as bx, type S3Reference as by, type SecureProxyRequest as bz, type AckOutboundMessagesRequest as c, type UpdateUseCaseRequestBase as c0, type UpsertIntegrationWithUseCasesRequest as c1, type UseCase as c2, type UseCaseBase as c3, type UseCaseHistoryEntry as c4, type UseCaseHistoryEntryBase as c5, type UseCaseTypePreview as c6, type ValidateErpImportRequest as c7, type WebhookDeliveryConfig as c8, type WebhookStatus as c9, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };

package/dist/{integration-toolkit.d-E2nrIdIM.d.ts → integration-toolkit.d-CVI89-A-.d.ts}

@@ -1338,10 +1338,11 @@ declare namespace Components {
              */
             latest_types_package_name?: string;
         }
+        /**
+         * Register an already-uploaded file as an import. The use case is chosen later, via `:validate` — upload and interpretation are separate decisions.
+         */
         export interface CreateErpImportRequest {
             s3_reference: S3Reference;
-            integration_id: string;
-            use_case_slug?: string;
         }
         export interface CreateErpImportResponse {
             /**
@@ -2066,14 +2067,17 @@ declare namespace Components {
             import_id: string;
             org_id: string;
             created_by?: string;
-            integration_id: string;
             /**
-             * The inbound use case whose mapping drives both phases.
+             * The integration owning the chosen use case. Absent until the first `:validate`.
+             */
+            integration_id?: string;
+            /**
+             * The inbound use case whose mapping drives both phases. Absent until the first `:validate`, and MUTABLE — re-validating with a different use case replaces it.
              */
             use_case_slug?: string;
             format: "csv" | "xlsx";
             /**
-             * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. IMPORTED, FAILED and CANCELLED are terminal and final.
+             * PENDING → VALIDATING → READY → PROCESSING → IMPORTED, with FAILED reachable from any working status, and CANCELLING → CANCELLED reachable from VALIDATING or PROCESSING via :abort. Only IMPORTED and CANCELLED are terminal. READY and FAILED both accept a further `:validate`, which is how a wrong use case is corrected without re-uploading the file.
              * IMPORTED means every row was handed to the platform, not that the platform finished — per-row outcomes live in monitoring, filtered by correlation_id. A file that fails validation is FAILED with error.code = VALIDATION_BLOCKED.
              * READY is legitimately idle for as long as the user takes to confirm, so it carries no running work and never goes stale.
              * CANCELLING is transient and cooperative: the abort has been recorded but the worker only notices at its next batch boundary. Rows already published stay published — a stop is not a rollback.
@@ -2116,6 +2120,20 @@ declare namespace Components {
              */
             total_rows?: number;
         }
+        export interface ErpImportUseCaseSuggestion {
+            integration_id: string;
+            integration_name: string;
+            use_case_slug: string;
+            use_case_name: string;
+            /**
+             * How many of the FILE's columns this use case reads, by exact trimmed name.
+             */
+            matched_columns: number;
+            /**
+             * Columns in the file. Identical across entries; repeated per entry so each row renders standalone as "matches N of your M columns".
+             */
+            file_columns: number;
+        }
         /**
          * Validate-phase summary: what the file will create, and whether it may be confirmed. Absent until the validate phase completes. No per-row detail is kept — a rejected file is corrected and imported again.
          */
@@ -6172,6 +6190,9 @@ declare namespace Components {
              */
             overwrite?: boolean;
         }
+        export interface SuggestErpImportUseCasesResponse {
+            suggestions: ErpImportUseCaseSuggestion[];
+        }
         export interface TestNotificationRequest {
             /**
              * The kind of notification to render and send.
@@ -6724,6 +6745,13 @@ declare namespace Components {
             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 ValidateErpImportRequest {
+            integration_id: string;
+            /**
+             * An inbound use case's slug, unique within its integration.
+             */
+            use_case_slug: string;
+        }
         /**
          * Push delivery of the transformed event to a webhook via svc-webhooks
          */
@@ -6832,7 +6860,7 @@ declare namespace Paths {
         }
     }
     namespace CreateErpImport {
-        export type RequestBody = Components.Schemas.CreateErpImportRequest;
+        export type RequestBody = /* Register an already-uploaded file as an import. The use case is chosen later, via `:validate` — upload and interpretation are separate decisions. */ Components.Schemas.CreateErpImportRequest;
         namespace Responses {
             export type $202 = Components.Schemas.CreateErpImportResponse;
             export type $400 = Components.Responses.BadRequest;
@@ -7660,6 +7688,21 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace SuggestErpImportUseCases {
+        namespace Parameters {
+            export type ImportId = string;
+        }
+        export interface PathParameters {
+            importId: Parameters.ImportId;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.SuggestErpImportUseCasesResponse;
+            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 TestSendNotification {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -7800,6 +7843,23 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace ValidateErpImport {
+        namespace Parameters {
+            export type ImportId = string;
+        }
+        export interface PathParameters {
+            importId: Parameters.ImportId;
+        }
+        export type RequestBody = Components.Schemas.ValidateErpImportRequest;
+        namespace Responses {
+            export type $202 = Components.Schemas.ErpImportJob;
+            export type $403 = Components.Responses.Forbidden;
+            export type $404 = Components.Responses.NotFound;
+            export type $409 = Components.Responses.Conflict;
+            export type $422 = Components.Schemas.ErrorResponseBase;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
 }
 
 
@@ -8549,7 +8609,7 @@ interface OperationMethods {
   /**
    * createErpImport - createErpImport
    * 
-   * Create a pricing-file import job from an already-uploaded file (S3 ref). Returns a job id and starts the validate phase asynchronously — poll GET /v2/erp/imports/{importId}.
+   * Register an already-uploaded file (S3 ref) as a pricing-file import job and return its id. Nothing runs yet: no use case is chosen and no validation starts here. Rank the candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start the validate phase with POST /v2/erp/imports/{importId}:validate.
    */
   'createErpImport'(
     parameters?: Parameters<UnknownParamsObject> | null,
@@ -8566,6 +8626,29 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetErpImport.Responses.$200>
+  /**
+   * validateErpImport - validateErpImport
+   * 
+   * Choose the use case to read this file with, and start the validate phase.
+   * Callable from PENDING, READY and FAILED — so a wrong choice is corrected by calling this again with a different use case, rather than re-uploading. Each call replaces any previous verdict. Any other status returns 409.
+   */
+  'validateErpImport'(
+    parameters?: Parameters<Paths.ValidateErpImport.PathParameters> | null,
+    data?: Paths.ValidateErpImport.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ValidateErpImport.Responses.$202>
+  /**
+   * suggestErpImportUseCases - suggestErpImportUseCases
+   * 
+   * Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Reads only the file's first row, not its data.
+   * Every eligible use case is returned, including ones matching nothing: the "nothing fits, pick anyway" view needs the full list. Highest match first.
+   * CSV only — an xlsx import fails with 400 rather than silently returning zero matches, which would look identical to "we checked and nothing matches".
+   */
+  'suggestErpImportUseCases'(
+    parameters?: Parameters<Paths.SuggestErpImportUseCases.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.SuggestErpImportUseCases.Responses.$200>
   /**
    * executeErpImport - executeErpImport
    * 
@@ -9412,7 +9495,7 @@ interface PathsDictionary {
     /**
      * createErpImport - createErpImport
      * 
-     * Create a pricing-file import job from an already-uploaded file (S3 ref). Returns a job id and starts the validate phase asynchronously — poll GET /v2/erp/imports/{importId}.
+     * Register an already-uploaded file (S3 ref) as a pricing-file import job and return its id. Nothing runs yet: no use case is chosen and no validation starts here. Rank the candidates with POST /v2/erp/imports/{importId}:suggest-use-cases, then start the validate phase with POST /v2/erp/imports/{importId}:validate.
      */
     'post'(
       parameters?: Parameters<UnknownParamsObject> | null,
@@ -9447,6 +9530,33 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetErpImport.Responses.$200>
   }
+  ['/v2/erp/imports/{importId}:validate']: {
+    /**
+     * validateErpImport - validateErpImport
+     * 
+     * Choose the use case to read this file with, and start the validate phase.
+     * Callable from PENDING, READY and FAILED — so a wrong choice is corrected by calling this again with a different use case, rather than re-uploading. Each call replaces any previous verdict. Any other status returns 409.
+     */
+    'post'(
+      parameters?: Parameters<Paths.ValidateErpImport.PathParameters> | null,
+      data?: Paths.ValidateErpImport.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ValidateErpImport.Responses.$202>
+  }
+  ['/v2/erp/imports/{importId}:suggest-use-cases']: {
+    /**
+     * suggestErpImportUseCases - suggestErpImportUseCases
+     * 
+     * Rank the org's inbound use cases against this file's columns — the input to the ranked picker ("matches 6 of your 7 columns"). Reads only the file's first row, not its data.
+     * Every eligible use case is returned, including ones matching nothing: the "nothing fits, pick anyway" view needs the full list. Highest match first.
+     * CSV only — an xlsx import fails with 400 rather than silently returning zero matches, which would look identical to "we checked and nothing matches".
+     */
+    'post'(
+      parameters?: Parameters<Paths.SuggestErpImportUseCases.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.SuggestErpImportUseCases.Responses.$200>
+  }
   ['/v2/erp/imports/{importId}:execute']: {
     /**
      * executeErpImport - executeErpImport
@@ -9516,6 +9626,7 @@ type ErpImportIssue = Components.Schemas.ErpImportIssue;
 type ErpImportJob = Components.Schemas.ErpImportJob;
 type ErpImportList = Components.Schemas.ErpImportList;
 type ErpImportProgress = Components.Schemas.ErpImportProgress;
+type ErpImportUseCaseSuggestion = Components.Schemas.ErpImportUseCaseSuggestion;
 type ErpImportValidation = Components.Schemas.ErpImportValidation;
 type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
 type ErpUpdatesEventsV3Request = Components.Schemas.ErpUpdatesEventsV3Request;
@@ -9635,6 +9746,7 @@ type SecureProxyUseCaseHistoryEntry = Components.Schemas.SecureProxyUseCaseHisto
 type SecureProxyWhitelist = Components.Schemas.SecureProxyWhitelist;
 type SecureProxyWhitelistUpdate = Components.Schemas.SecureProxyWhitelistUpdate;
 type SetIntegrationAppMappingRequest = Components.Schemas.SetIntegrationAppMappingRequest;
+type SuggestErpImportUseCasesResponse = Components.Schemas.SuggestErpImportUseCasesResponse;
 type TestNotificationRequest = Components.Schemas.TestNotificationRequest;
 type TestNotificationResponse = Components.Schemas.TestNotificationResponse;
 type TimeSeriesBreakdownItemV2 = Components.Schemas.TimeSeriesBreakdownItemV2;
@@ -9660,7 +9772,8 @@ type UseCaseBase = Components.Schemas.UseCaseBase;
 type UseCaseHistoryEntry = Components.Schemas.UseCaseHistoryEntry;
 type UseCaseHistoryEntryBase = Components.Schemas.UseCaseHistoryEntryBase;
 type UseCaseTypePreview = Components.Schemas.UseCaseTypePreview;
+type ValidateErpImportRequest = Components.Schemas.ValidateErpImportRequest;
 type WebhookDeliveryConfig = Components.Schemas.WebhookDeliveryConfig;
 type WebhookStatus = Components.Schemas.WebhookStatus;
 
-export { type FileProxyStep as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportValidation as R, type ErpUpdatesEventsV2Request as S, type ErpUpdatesEventsV3Request as T, type ErrorResponseBase as U, type ExecuteErpImportRequest as V, type ExternalMonitoringSpan as W, type FileProxyAuth as X, type FileProxyParam as Y, type FileProxyResponseConfig as Z, type FileProxySecureProxyAttachment as _, Components as a, type OutboundIntegrationEventConfiguration as a$, type FileProxyUrlConfig as a0, type FileProxyUrlParam as a1, type FileProxyUrlParams as a2, type FileProxyUseCase as a3, type FileProxyUseCaseConfiguration as a4, type FileProxyUseCaseHistoryEntry as a5, type GenerateTypesPreviewResponse as a6, type GenerateTypesRequest as a7, type GenerateTypesResponse as a8, type GetMonitoringStatsRequest as a9, type ManagedCallOperation as aA, type ManagedCallOperationConfig as aB, type ManagedCallUseCase as aC, type ManagedCallUseCaseHistoryEntry as aD, type MappingSimulationRequest as aE, type MappingSimulationResponse as aF, type MappingSimulationV2Request as aG, type MappingSimulationWarning as aH, type MeterReadingPruneScopeConfig as aI, type MeterReadingPruneScopeUpdate as aJ, type MeterReadingUpdate as aK, type MeterUniqueIdsConfig as aL, type MonitoringEventV2 as aM, type MonitoringStats as aN, type MonitoringStatsV2 as aO, type MonitoringTraceResponse as aP, type NotificationChannelSet as aQ, type NotificationDigestConfig as aR, type NotificationHistoryItem as aS, type NotificationHistoryResponse as aT, type NotificationRecipient as aU, type NotificationRule as aV, type NotificationRuleStatus as aW, type NotificationStatusResponse as aX, type OutboundConflict as aY, type OutboundDlqListResponse as aZ, type OutboundDlqMessage as a_, type GetMonitoringStatsV2Request as aa, type GetMonitoringTimeSeriesRequest as ab, type GetMonitoringTimeSeriesV2Request as ac, type InboundIntegrationEventConfiguration as ad, type InboundMonitoringEvent as ae, type InboundUseCase as af, type InboundUseCaseHistoryEntry as ag, type IngestExternalMonitoringEventsRequest as ah, type IngestExternalMonitoringEventsResponse as ai, type Integration as aj, type IntegrationAppMapping as ak, type IntegrationConfigurationV1 as al, type IntegrationConfigurationV2 as am, type IntegrationEditableFields as an, type IntegrationEntity as ao, type IntegrationEntityField as ap, type IntegrationFieldV1 as aq, type IntegrationMeterReading as ar, type IntegrationNotificationConfig as as, type IntegrationObjectV1 as at, type IntegrationSettings as au, type IntegrationWithUseCases as av, type ManagedCallAuth as aw, type ManagedCallErrorResponse as ax, type ManagedCallExecuteRequest as ay, type ManagedCallExecuteResponse as az, type PathsDictionary as b, type UpsertIntegrationWithUseCasesRequest as b$, type OutboundMapping as b0, type OutboundMessage as b1, type OutboundMonitoringEvent as b2, type OutboundPollStatus as b3, type OutboundStatusResponse as b4, type OutboundUseCase as b5, type OutboundUseCaseHistoryEntry as b6, type OutboundUseCaseStatus as b7, type PollDeliveryConfig as b8, type PollOutboundMessagesRequest as b9, type SecureProxySummary as bA, type SecureProxyUpstreamError as bB, type SecureProxyUseCase as bC, type SecureProxyUseCaseConfiguration as bD, type SecureProxyUseCaseHistoryEntry as bE, type SecureProxyWhitelist as bF, type SecureProxyWhitelistUpdate as bG, type SetIntegrationAppMappingRequest as bH, type TestNotificationRequest as bI, type TestNotificationResponse as bJ, type TimeSeriesBreakdownItemV2 as bK, type TimeSeriesBucket as bL, type TimeSeriesBucketV2 as bM, type TriggerErpActionRequest as bN, type TriggerWebhookResp as bO, type TypeAnnotations as bP, type TypeDescriptor as bQ, type UnblockOutboundStreamRequest as bR, type UnblockOutboundStreamResponse as bS, type UpdateFileProxyUseCaseRequest as bT, type UpdateInboundUseCaseRequest as bU, type UpdateIntegrationRequest as bV, type UpdateManagedCallUseCaseRequest as bW, type UpdateOutboundUseCaseRequest as bX, type UpdateSecureProxyUseCaseRequest as bY, type UpdateUseCaseRequest as bZ, type UpdateUseCaseRequestBase as b_, type PollOutboundMessagesResponse as ba, type PortalOrigin as bb, type PortalRefConfig as bc, type PortalRefFilter as bd, type PruneScopeConfig as be, type QueryAccessLogsRequest as bf, type QueryEventsRequest as bg, type QueryInboundMonitoringEventsRequest as bh, type QueryMonitoringEventsV2Request as bi, type QueryOutboundMonitoringEventsRequest as bj, type RedriveOutboundDlqRequest as bk, type RedriveOutboundDlqResponse as bl, type RedriveOutboundDlqResult as bm, type RelationConfig as bn, type RelationItemConfig as bo, type RelationRefItemConfig as bp, type RelationRefValueConfig as bq, type RelationRefsConfig as br, type RelationUniqueIdField as bs, type RepeatableFieldType as bt, type ReplayEventsRequest as bu, type RuleBaselineBucket as bv, type RuleBaselineStatus as bw, type S3Reference as bx, type SecureProxyRequest as by, type SecureProxyResponse as bz, type AckOutboundMessagesRequest as c, type UseCase as c0, type UseCaseBase as c1, type UseCaseHistoryEntry as c2, type UseCaseHistoryEntryBase as c3, type UseCaseTypePreview as c4, type WebhookDeliveryConfig as c5, type WebhookStatus as c6, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };
+export { type FileProxySecureProxyAttachment as $, type AccessLogEntry as A, type EntityPruneScopeUpdate as B, type Client as C, type DeleteIntegrationAppMappingRequest as D, type EmbeddedFileProxyUseCaseRequest as E, type EntityUpdate as F, type EnvVarRefConfig as G, type EnvironmentFieldConfig as H, type ErpEvent as I, type ErpEventV3 as J, type ErpImportError as K, type ErpImportIssue as L, type ErpImportJob as M, type ErpImportList as N, type OperationMethods as O, Paths as P, type ErpImportProgress as Q, type ErpImportUseCaseSuggestion as R, type ErpImportValidation as S, type ErpUpdatesEventsV2Request as T, type ErpUpdatesEventsV3Request as U, type ErrorResponseBase as V, type ExecuteErpImportRequest as W, type ExternalMonitoringSpan as X, type FileProxyAuth as Y, type FileProxyParam as Z, type FileProxyResponseConfig as _, Components as a, type OutboundDlqMessage as a$, type FileProxyStep as a0, type FileProxyUrlConfig as a1, type FileProxyUrlParam as a2, type FileProxyUrlParams as a3, type FileProxyUseCase as a4, type FileProxyUseCaseConfiguration as a5, type FileProxyUseCaseHistoryEntry as a6, type GenerateTypesPreviewResponse as a7, type GenerateTypesRequest as a8, type GenerateTypesResponse as a9, type ManagedCallExecuteResponse as aA, type ManagedCallOperation as aB, type ManagedCallOperationConfig as aC, type ManagedCallUseCase as aD, type ManagedCallUseCaseHistoryEntry as aE, type MappingSimulationRequest as aF, type MappingSimulationResponse as aG, type MappingSimulationV2Request as aH, type MappingSimulationWarning as aI, type MeterReadingPruneScopeConfig as aJ, type MeterReadingPruneScopeUpdate as aK, type MeterReadingUpdate as aL, type MeterUniqueIdsConfig as aM, type MonitoringEventV2 as aN, type MonitoringStats as aO, type MonitoringStatsV2 as aP, type MonitoringTraceResponse as aQ, type NotificationChannelSet as aR, type NotificationDigestConfig as aS, type NotificationHistoryItem as aT, type NotificationHistoryResponse as aU, type NotificationRecipient as aV, type NotificationRule as aW, type NotificationRuleStatus as aX, type NotificationStatusResponse as aY, type OutboundConflict as aZ, type OutboundDlqListResponse as a_, type GetMonitoringStatsRequest as aa, type GetMonitoringStatsV2Request as ab, type GetMonitoringTimeSeriesRequest as ac, type GetMonitoringTimeSeriesV2Request as ad, type InboundIntegrationEventConfiguration as ae, type InboundMonitoringEvent as af, type InboundUseCase as ag, type InboundUseCaseHistoryEntry as ah, type IngestExternalMonitoringEventsRequest as ai, type IngestExternalMonitoringEventsResponse as aj, type Integration as ak, type IntegrationAppMapping as al, type IntegrationConfigurationV1 as am, type IntegrationConfigurationV2 as an, type IntegrationEditableFields as ao, type IntegrationEntity as ap, type IntegrationEntityField as aq, type IntegrationFieldV1 as ar, type IntegrationMeterReading as as, type IntegrationNotificationConfig as at, type IntegrationObjectV1 as au, type IntegrationSettings as av, type IntegrationWithUseCases as aw, type ManagedCallAuth as ax, type ManagedCallErrorResponse as ay, type ManagedCallExecuteRequest as az, type PathsDictionary as b, type UpdateUseCaseRequest as b$, type OutboundIntegrationEventConfiguration as b0, type OutboundMapping as b1, type OutboundMessage as b2, type OutboundMonitoringEvent as b3, type OutboundPollStatus as b4, type OutboundStatusResponse as b5, type OutboundUseCase as b6, type OutboundUseCaseHistoryEntry as b7, type OutboundUseCaseStatus as b8, type PollDeliveryConfig as b9, type SecureProxyResponse as bA, type SecureProxySummary as bB, type SecureProxyUpstreamError as bC, type SecureProxyUseCase as bD, type SecureProxyUseCaseConfiguration as bE, type SecureProxyUseCaseHistoryEntry as bF, type SecureProxyWhitelist as bG, type SecureProxyWhitelistUpdate as bH, type SetIntegrationAppMappingRequest as bI, type SuggestErpImportUseCasesResponse as bJ, type TestNotificationRequest as bK, type TestNotificationResponse as bL, type TimeSeriesBreakdownItemV2 as bM, type TimeSeriesBucket as bN, type TimeSeriesBucketV2 as bO, type TriggerErpActionRequest as bP, type TriggerWebhookResp as bQ, type TypeAnnotations as bR, type TypeDescriptor as bS, type UnblockOutboundStreamRequest as bT, type UnblockOutboundStreamResponse as bU, type UpdateFileProxyUseCaseRequest as bV, type UpdateInboundUseCaseRequest as bW, type UpdateIntegrationRequest as bX, type UpdateManagedCallUseCaseRequest as bY, type UpdateOutboundUseCaseRequest as bZ, type UpdateSecureProxyUseCaseRequest as b_, type PollOutboundMessagesRequest as ba, type PollOutboundMessagesResponse as bb, type PortalOrigin as bc, type PortalRefConfig as bd, type PortalRefFilter as be, type PruneScopeConfig as bf, type QueryAccessLogsRequest as bg, type QueryEventsRequest as bh, type QueryInboundMonitoringEventsRequest as bi, type QueryMonitoringEventsV2Request as bj, type QueryOutboundMonitoringEventsRequest as bk, type RedriveOutboundDlqRequest as bl, type RedriveOutboundDlqResponse as bm, type RedriveOutboundDlqResult as bn, type RelationConfig as bo, type RelationItemConfig as bp, type RelationRefItemConfig as bq, type RelationRefValueConfig as br, type RelationRefsConfig as bs, type RelationUniqueIdField as bt, type RepeatableFieldType as bu, type ReplayEventsRequest as bv, type RuleBaselineBucket as bw, type RuleBaselineStatus as bx, type S3Reference as by, type SecureProxyRequest as bz, type AckOutboundMessagesRequest as c, type UpdateUseCaseRequestBase as c0, type UpsertIntegrationWithUseCasesRequest as c1, type UseCase as c2, type UseCaseBase as c3, type UseCaseHistoryEntry as c4, type UseCaseHistoryEntryBase as c5, type UseCaseTypePreview as c6, type ValidateErpImportRequest as c7, type WebhookDeliveryConfig as c8, type WebhookStatus as c9, type AckOutboundMessagesResponse as d, type AckResult as e, type AutoRefreshSettings as f, type CommitTypesRequest as g, type CommitTypesResponse as h, type ConnectorConfig as i, type CreateErpImportRequest as j, type CreateErpImportResponse as k, type CreateFileProxyUseCaseRequest as l, type CreateInboundUseCaseRequest as m, type CreateIntegrationRequest as n, type CreateManagedCallUseCaseRequest as o, type CreateOutboundUseCaseRequest as p, type CreateSecureProxyUseCaseRequest as q, type CreateUseCaseRequest as r, type CreateUseCaseRequestBase as s, type DeliveryConfig as t, type EmbeddedInboundUseCaseRequest as u, type EmbeddedManagedCallUseCaseRequest as v, type EmbeddedOutboundUseCaseRequest as w, type EmbeddedSecureProxyUseCaseRequest as x, type EmbeddedUseCaseRequest as y, type EmbeddedUseCaseRequestBase as z };

package/docs/email-settings.md

@@ -1045,7 +1045,7 @@ const { data } = await client.listSmtpConnections()
     {
       "connection_id": "string",
       "smtp_host": "string",
-      "smtp_port": 0,
+      "smtp_port": "string",
       "smtp_secure": "tls",
       "smtp_username": "string",
       "smtp_password": "string",
@@ -1070,17 +1070,19 @@ const { data } = await client.listSmtpConnections()
 ### `createSmtpConnection`
 
 Creates a new custom SMTP connection. Runs a live verify against the SMTP server
-before persisting; on failure the request is rejected and nothing is saved.
-The password is encrypted via KMS before be
+before persisting; on failure the request is rejected and nothing is saved. Pass
+`skip_test=true` to store the configur
 
 `POST /v2/smtp/connections`
 
 ```ts
 const { data } = await client.createSmtpConnection(
-  null,
+  {
+    skip_test: true,
+  },
   {
     smtp_host: 'string',
-    smtp_port: 1,
+    smtp_port: 'string',
     smtp_secure: 'tls',
     smtp_username: 'string',
     smtp_password: '{{ env.smtp_password }}'
@@ -1095,7 +1097,7 @@ const { data } = await client.createSmtpConnection(
 {
   "connection_id": "string",
   "smtp_host": "string",
-  "smtp_port": 0,
+  "smtp_port": "string",
   "smtp_secure": "tls",
   "smtp_username": "string",
   "smtp_password": "string",
@@ -1133,7 +1135,7 @@ const { data } = await client.getSmtpConnection({
 {
   "connection_id": "string",
   "smtp_host": "string",
-  "smtp_port": 0,
+  "smtp_port": "string",
   "smtp_secure": "tls",
   "smtp_username": "string",
   "smtp_password": "string",
@@ -1155,7 +1157,8 @@ const { data } = await client.getSmtpConnection({
 ### `updateSmtpConnection`
 
 Partial update; omitted fields keep their existing values. The merged
-configuration is verified against the SMTP server before persisting.
+configuration is verified against the SMTP server before persisting. Pass
+`skip_test=true` to store it untested instead, which als
 
 `PUT /v2/smtp/connections/{connectionId}`
 
@@ -1163,10 +1166,11 @@ configuration is verified against the SMTP server before persisting.
 const { data } = await client.updateSmtpConnection(
   {
     connectionId: 'example',
+    skip_test: true,
   },
   {
     smtp_host: 'string',
-    smtp_port: 1,
+    smtp_port: 'string',
     smtp_secure: 'tls',
     smtp_username: 'string',
     smtp_password: 'string'
@@ -1181,7 +1185,7 @@ const { data } = await client.updateSmtpConnection(
 {
   "connection_id": "string",
   "smtp_host": "string",
-  "smtp_port": 0,
+  "smtp_port": "string",
   "smtp_secure": "tls",
   "smtp_username": "string",
   "smtp_password": "string",
@@ -2118,7 +2122,7 @@ type OutlookConnectionStatus = {
 type SmtpConnection = {
   connection_id: string
   smtp_host: string
-  smtp_port: number
+  smtp_port: string
   smtp_secure: "tls" | "starttls"
   smtp_username: string
   smtp_password?: string
@@ -2138,7 +2142,7 @@ type SmtpConnection = {
 ```ts
 type CreateSmtpConnectionRequest = {
   smtp_host: string
-  smtp_port: number
+  smtp_port: string | number
   smtp_secure: "tls" | "starttls"
   smtp_username: string
   smtp_password: string
@@ -2152,7 +2156,7 @@ Partial update; omitted fields keep their existing values.
 ```ts
 type UpdateSmtpConnectionRequest = {
   smtp_host?: string
-  smtp_port?: number
+  smtp_port?: string | number
   smtp_secure?: "tls" | "starttls"
   smtp_username?: string
   smtp_password?: string