@wix/auto_sdk_app-components_components-catalog 1.0.109 → 1.0.110

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -25686,12 +25686,15 @@ declare enum VerificationSource {
25686
25686
  CONNECTOR_WIDE = "CONNECTOR_WIDE",
25687
25687
  /**
25688
25688
  * Material is issued per registration and lives on the registration the delivery was sent to.
25689
- * Requires registration_required.
25689
+ * Requires registration_required. A registration is the provider-side one for a single
25690
+ * account, which is that account's subscription; there is no separate registration entity.
25690
25691
  */
25691
25692
  PER_REGISTRATION = "PER_REGISTRATION",
25692
25693
  /**
25693
25694
  * There is no material, because nothing is verified. The only legal scope for
25694
- * NO_VERIFICATION, and legal for nothing else.
25695
+ * NO_VERIFICATION, and legal for nothing else. Redundant with NO_VERIFICATION on purpose:
25696
+ * every enum in a valid config is explicitly set, so "nothing was declared" and "the
25697
+ * declaration is that nothing is verified" stay distinguishable.
25695
25698
  */
25696
25699
  UNSIGNED = "UNSIGNED"
25697
25700
  }
@@ -25736,7 +25739,7 @@ type SignedPayloadWithLiterals = SignedPayload | 'RAW_BODY' | 'TIMESTAMP_DOT_RAW
25736
25739
  /**
25737
25740
  * Per-method payload for the `verification` oneof above. Shared by HMAC_SHA256,
25738
25741
  * HMAC_SHA1, and (wrapped) PUBLIC_KEY - the three methods signatureMethods already groups
25739
- * together in the validator. timestamp_header / timestamp_tolerance_seconds stay flat on
25742
+ * together in the validator. timestamp_header / timestamp_tolerance_seconds stay on
25740
25743
  * WebhookConfig rather than moving in here, since BODY_HASH_WITHIN_TIMESTAMP_WINDOW borrows
25741
25744
  * them independently of which verification_method is selected.
25742
25745
  */
@@ -25750,13 +25753,20 @@ interface HmacConfig {
25750
25753
  signatureHeader?: string;
25751
25754
  /**
25752
25755
  * Literal prefix the provider places in front of the encoded signature, for example
25753
- * "sha256=" or "v0=". Empty when the header holds the bare signature.
25756
+ * "sha256=" or "v0=". Empty when the header holds the bare signature. A constant, never a
25757
+ * template: compared verbatim against the start of the header, and a delivery whose header
25758
+ * does not start with it is rejected.
25754
25759
  * @maxLength 20
25755
25760
  */
25756
25761
  signatureValuePrefix?: string;
25757
25762
  /** How the signature bytes are encoded in signature_header. */
25758
25763
  signatureEncoding?: SignatureEncodingWithLiterals;
25759
- /** Which canonical string the signature is computed over. */
25764
+ /**
25765
+ * Which canonical string the signature is computed over, from a closed set of recipes. There
25766
+ * is deliberately no free-form signing template, which would make the inbound path an
25767
+ * interpreter of app-owner input; a provider whose canonical string is not listed needs a new
25768
+ * enum value.
25769
+ */
25760
25770
  signedPayload?: SignedPayloadWithLiterals;
25761
25771
  }
25762
25772
  declare enum EventsLocation {
@@ -26131,8 +26141,8 @@ interface DispatchConfig {
26131
26141
  *
26132
26142
  * No credential material is declared here. This config lives in the app component catalog and is
26133
26143
  * readable by app owners; signing secrets and callback tokens are stored separately and are
26134
- * located through verification_source. public_key_url is the only credential-adjacent field, and
26135
- * it points at material the provider publishes.
26144
+ * located through the selected verification arm's verification_source. public_key_url is the
26145
+ * only credential-adjacent field, and it points at material the provider publishes.
26136
26146
  *
26137
26147
  * Fields naming something the provider owns carry a provider_ prefix, so the identifiers a
26138
26148
  * delivery arrives with are never confused with the ones Wix mints.
@@ -26163,90 +26173,19 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26163
26173
  * must select a concrete method — an unset method is rejected rather than treated as a default.
26164
26174
  */
26165
26175
  verificationMethod?: VerificationMethodWithLiterals;
26166
- /**
26167
- * Scope of the material used by verification_method: shared by the whole connector, or issued
26168
- * per registration. Names the scope rather than the kind of material, so it stays accurate for
26169
- * PUBLIC_KEY, where the connector-wide material is a published key URL and nothing is stored.
26170
- *
26171
- * "Per registration" is the provider-side registration for one account, which is that account's
26172
- * subscription - there is no separate registration entity to look for.
26173
- *
26174
- * The UNSIGNED arm is redundant with verification_method = NO_VERIFICATION, and deliberately so:
26175
- * every enum in a valid config is explicitly set, which keeps "nothing was declared" and "the
26176
- * declaration is that nothing is verified" distinguishable states rather than the same unset
26177
- * field. The alternative - dropping the arm and making this field conditionally required - moves
26178
- * the same fact into a validation rule instead of removing it.
26179
- *
26180
- * Deprecated: superseded by each `verification` arm's own verification_source field. Kept live
26181
- * and enforced for the flat-shape configs this migration has not yet moved off of.
26182
- * @deprecated
26183
- * @replacedBy verification (each arm's own verification_source field)
26184
- * @targetRemovalDate 2027-06-30
26185
- */
26186
- verificationSource?: VerificationSourceWithLiterals;
26187
- /**
26188
- * Header carrying the signature to verify. Required for HMAC_SHA256, HMAC_SHA1 and PUBLIC_KEY,
26189
- * and must be empty for every other method. For example: "X-Hub-Signature-256".
26190
- *
26191
- * Deprecated: superseded by HmacConfig.signature_header (via the `verification` oneof's
26192
- * hmac_sha256_config, hmac_sha1_config and public_key_config arms).
26193
- * @maxLength 120
26194
- * @deprecated
26195
- * @replacedBy HmacConfig.signature_header (via the verification oneof)
26196
- * @targetRemovalDate 2027-06-30
26197
- */
26198
- signatureHeader?: string;
26199
- /**
26200
- * Literal prefix the provider places in front of the encoded signature, for example "sha256="
26201
- * or "v0=". Empty when the header holds the bare signature.
26202
- *
26203
- * The value is a constant, never a template: it is compared verbatim against the start of the
26204
- * header and stripped before decoding, and a delivery whose header does not start with it is
26205
- * rejected. Nothing in it is interpreted or substituted.
26206
- *
26207
- * Deprecated: superseded by HmacConfig.signature_value_prefix.
26208
- * @maxLength 20
26209
- * @deprecated
26210
- * @replacedBy HmacConfig.signature_value_prefix (via the verification oneof)
26211
- * @targetRemovalDate 2027-06-30
26212
- */
26213
- signatureValuePrefix?: string;
26214
- /**
26215
- * How the signature bytes are encoded in signature_header. Required whenever signature_header
26216
- * is required.
26217
- *
26218
- * Deprecated: superseded by HmacConfig.signature_encoding.
26219
- * @deprecated
26220
- * @replacedBy HmacConfig.signature_encoding (via the verification oneof)
26221
- * @targetRemovalDate 2027-06-30
26222
- */
26223
- signatureEncoding?: SignatureEncodingWithLiterals;
26224
- /**
26225
- * Which canonical string the signature is computed over, selected from a closed set of recipes
26226
- * the server implements. Required whenever signature_header is required.
26227
- *
26228
- * There is deliberately no free-form signing template: a configurable template would make the
26229
- * inbound path an interpreter of app-owner input and an injection surface. A provider whose
26230
- * canonical string is not listed here needs a new enum value, not a new template.
26231
- *
26232
- * Deprecated: superseded by HmacConfig.signed_payload.
26233
- * @deprecated
26234
- * @replacedBy HmacConfig.signed_payload (via the verification oneof)
26235
- * @targetRemovalDate 2027-06-30
26236
- */
26237
- signedPayload?: SignedPayloadWithLiterals;
26238
26176
  /**
26239
26177
  * Header carrying the delivery timestamp, used to reject stale and replayed deliveries. For
26240
- * example: "X-Slack-Request-Timestamp". Required by the signed_payload recipes that include a
26241
- * timestamp, and must be set together with timestamp_tolerance_seconds. The header value is read
26242
- * as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as epoch milliseconds.
26178
+ * example: "X-Slack-Request-Timestamp". Required by the HmacConfig.signed_payload recipes that
26179
+ * include a timestamp, and must be set together with timestamp_tolerance_seconds. The header
26180
+ * value is read as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
26181
+ * epoch milliseconds.
26243
26182
  * @maxLength 120
26244
26183
  */
26245
26184
  timestampHeader?: string;
26246
26185
  /**
26247
26186
  * How far the delivery timestamp may be from server time before the delivery is rejected. Must
26248
26187
  * be greater than zero when timestamp_header is set, and zero when it is not. Always in seconds,
26249
- * whatever unit the signed_payload recipe reads timestamp_header in.
26188
+ * whatever unit the HmacConfig.signed_payload recipe reads timestamp_header in.
26250
26189
  *
26251
26190
  * The tolerance is a floor on replay-protection retention, not only a freshness bound: whatever
26252
26191
  * remembers seen deliveries has to outlive this window, or a delivery still inside its accepted
@@ -26259,19 +26198,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26259
26198
  * @max 3600
26260
26199
  */
26261
26200
  timestampToleranceSeconds?: number;
26262
- /**
26263
- * Header carrying the shared token the provider echoes on every delivery. Required for
26264
- * CALLBACK_TOKEN and must be empty for every other method. For example:
26265
- * "X-Goog-Channel-Token". The token itself is never declared here — it is located through
26266
- * verification_source.
26267
- *
26268
- * Deprecated: superseded by CallbackTokenConfig.callback_token_header.
26269
- * @maxLength 120
26270
- * @deprecated
26271
- * @replacedBy verification.callback_token_config.callback_token_header
26272
- * @targetRemovalDate 2027-06-30
26273
- */
26274
- callbackTokenHeader?: string;
26275
26201
  /**
26276
26202
  * Endpoint publishing the provider's public keys. Required for PUBLIC_KEY and OIDC_BEARER, and
26277
26203
  * must be empty for every other method.
@@ -25728,12 +25728,15 @@ declare enum VerificationSource {
25728
25728
  CONNECTOR_WIDE = "CONNECTOR_WIDE",
25729
25729
  /**
25730
25730
  * Material is issued per registration and lives on the registration the delivery was sent to.
25731
- * Requires registration_required.
25731
+ * Requires registration_required. A registration is the provider-side one for a single
25732
+ * account, which is that account's subscription; there is no separate registration entity.
25732
25733
  */
25733
25734
  PER_REGISTRATION = "PER_REGISTRATION",
25734
25735
  /**
25735
25736
  * There is no material, because nothing is verified. The only legal scope for
25736
- * NO_VERIFICATION, and legal for nothing else.
25737
+ * NO_VERIFICATION, and legal for nothing else. Redundant with NO_VERIFICATION on purpose:
25738
+ * every enum in a valid config is explicitly set, so "nothing was declared" and "the
25739
+ * declaration is that nothing is verified" stay distinguishable.
25737
25740
  */
25738
25741
  UNSIGNED = "UNSIGNED"
25739
25742
  }
@@ -25778,7 +25781,7 @@ type SignedPayloadWithLiterals = SignedPayload | 'RAW_BODY' | 'TIMESTAMP_DOT_RAW
25778
25781
  /**
25779
25782
  * Per-method payload for the `verification` oneof above. Shared by HMAC_SHA256,
25780
25783
  * HMAC_SHA1, and (wrapped) PUBLIC_KEY - the three methods signatureMethods already groups
25781
- * together in the validator. timestamp_header / timestamp_tolerance_seconds stay flat on
25784
+ * together in the validator. timestamp_header / timestamp_tolerance_seconds stay on
25782
25785
  * WebhookConfig rather than moving in here, since BODY_HASH_WITHIN_TIMESTAMP_WINDOW borrows
25783
25786
  * them independently of which verification_method is selected.
25784
25787
  */
@@ -25792,13 +25795,20 @@ interface HmacConfig {
25792
25795
  signatureHeader?: string;
25793
25796
  /**
25794
25797
  * Literal prefix the provider places in front of the encoded signature, for example
25795
- * "sha256=" or "v0=". Empty when the header holds the bare signature.
25798
+ * "sha256=" or "v0=". Empty when the header holds the bare signature. A constant, never a
25799
+ * template: compared verbatim against the start of the header, and a delivery whose header
25800
+ * does not start with it is rejected.
25796
25801
  * @maxLength 20
25797
25802
  */
25798
25803
  signatureValuePrefix?: string;
25799
25804
  /** How the signature bytes are encoded in signature_header. */
25800
25805
  signatureEncoding?: SignatureEncodingWithLiterals;
25801
- /** Which canonical string the signature is computed over. */
25806
+ /**
25807
+ * Which canonical string the signature is computed over, from a closed set of recipes. There
25808
+ * is deliberately no free-form signing template, which would make the inbound path an
25809
+ * interpreter of app-owner input; a provider whose canonical string is not listed needs a new
25810
+ * enum value.
25811
+ */
25802
25812
  signedPayload?: SignedPayloadWithLiterals;
25803
25813
  }
25804
25814
  declare enum EventsLocation {
@@ -26173,8 +26183,8 @@ interface DispatchConfig {
26173
26183
  *
26174
26184
  * No credential material is declared here. This config lives in the app component catalog and is
26175
26185
  * readable by app owners; signing secrets and callback tokens are stored separately and are
26176
- * located through verification_source. public_key_url is the only credential-adjacent field, and
26177
- * it points at material the provider publishes.
26186
+ * located through the selected verification arm's verification_source. public_key_url is the
26187
+ * only credential-adjacent field, and it points at material the provider publishes.
26178
26188
  *
26179
26189
  * Fields naming something the provider owns carry a provider_ prefix, so the identifiers a
26180
26190
  * delivery arrives with are never confused with the ones Wix mints.
@@ -26205,90 +26215,19 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26205
26215
  * must select a concrete method — an unset method is rejected rather than treated as a default.
26206
26216
  */
26207
26217
  verificationMethod?: VerificationMethodWithLiterals;
26208
- /**
26209
- * Scope of the material used by verification_method: shared by the whole connector, or issued
26210
- * per registration. Names the scope rather than the kind of material, so it stays accurate for
26211
- * PUBLIC_KEY, where the connector-wide material is a published key URL and nothing is stored.
26212
- *
26213
- * "Per registration" is the provider-side registration for one account, which is that account's
26214
- * subscription - there is no separate registration entity to look for.
26215
- *
26216
- * The UNSIGNED arm is redundant with verification_method = NO_VERIFICATION, and deliberately so:
26217
- * every enum in a valid config is explicitly set, which keeps "nothing was declared" and "the
26218
- * declaration is that nothing is verified" distinguishable states rather than the same unset
26219
- * field. The alternative - dropping the arm and making this field conditionally required - moves
26220
- * the same fact into a validation rule instead of removing it.
26221
- *
26222
- * Deprecated: superseded by each `verification` arm's own verification_source field. Kept live
26223
- * and enforced for the flat-shape configs this migration has not yet moved off of.
26224
- * @deprecated
26225
- * @replacedBy verification (each arm's own verification_source field)
26226
- * @targetRemovalDate 2027-06-30
26227
- */
26228
- verificationSource?: VerificationSourceWithLiterals;
26229
- /**
26230
- * Header carrying the signature to verify. Required for HMAC_SHA256, HMAC_SHA1 and PUBLIC_KEY,
26231
- * and must be empty for every other method. For example: "X-Hub-Signature-256".
26232
- *
26233
- * Deprecated: superseded by HmacConfig.signature_header (via the `verification` oneof's
26234
- * hmac_sha256_config, hmac_sha1_config and public_key_config arms).
26235
- * @maxLength 120
26236
- * @deprecated
26237
- * @replacedBy HmacConfig.signature_header (via the verification oneof)
26238
- * @targetRemovalDate 2027-06-30
26239
- */
26240
- signatureHeader?: string;
26241
- /**
26242
- * Literal prefix the provider places in front of the encoded signature, for example "sha256="
26243
- * or "v0=". Empty when the header holds the bare signature.
26244
- *
26245
- * The value is a constant, never a template: it is compared verbatim against the start of the
26246
- * header and stripped before decoding, and a delivery whose header does not start with it is
26247
- * rejected. Nothing in it is interpreted or substituted.
26248
- *
26249
- * Deprecated: superseded by HmacConfig.signature_value_prefix.
26250
- * @maxLength 20
26251
- * @deprecated
26252
- * @replacedBy HmacConfig.signature_value_prefix (via the verification oneof)
26253
- * @targetRemovalDate 2027-06-30
26254
- */
26255
- signatureValuePrefix?: string;
26256
- /**
26257
- * How the signature bytes are encoded in signature_header. Required whenever signature_header
26258
- * is required.
26259
- *
26260
- * Deprecated: superseded by HmacConfig.signature_encoding.
26261
- * @deprecated
26262
- * @replacedBy HmacConfig.signature_encoding (via the verification oneof)
26263
- * @targetRemovalDate 2027-06-30
26264
- */
26265
- signatureEncoding?: SignatureEncodingWithLiterals;
26266
- /**
26267
- * Which canonical string the signature is computed over, selected from a closed set of recipes
26268
- * the server implements. Required whenever signature_header is required.
26269
- *
26270
- * There is deliberately no free-form signing template: a configurable template would make the
26271
- * inbound path an interpreter of app-owner input and an injection surface. A provider whose
26272
- * canonical string is not listed here needs a new enum value, not a new template.
26273
- *
26274
- * Deprecated: superseded by HmacConfig.signed_payload.
26275
- * @deprecated
26276
- * @replacedBy HmacConfig.signed_payload (via the verification oneof)
26277
- * @targetRemovalDate 2027-06-30
26278
- */
26279
- signedPayload?: SignedPayloadWithLiterals;
26280
26218
  /**
26281
26219
  * Header carrying the delivery timestamp, used to reject stale and replayed deliveries. For
26282
- * example: "X-Slack-Request-Timestamp". Required by the signed_payload recipes that include a
26283
- * timestamp, and must be set together with timestamp_tolerance_seconds. The header value is read
26284
- * as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as epoch milliseconds.
26220
+ * example: "X-Slack-Request-Timestamp". Required by the HmacConfig.signed_payload recipes that
26221
+ * include a timestamp, and must be set together with timestamp_tolerance_seconds. The header
26222
+ * value is read as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
26223
+ * epoch milliseconds.
26285
26224
  * @maxLength 120
26286
26225
  */
26287
26226
  timestampHeader?: string;
26288
26227
  /**
26289
26228
  * How far the delivery timestamp may be from server time before the delivery is rejected. Must
26290
26229
  * be greater than zero when timestamp_header is set, and zero when it is not. Always in seconds,
26291
- * whatever unit the signed_payload recipe reads timestamp_header in.
26230
+ * whatever unit the HmacConfig.signed_payload recipe reads timestamp_header in.
26292
26231
  *
26293
26232
  * The tolerance is a floor on replay-protection retention, not only a freshness bound: whatever
26294
26233
  * remembers seen deliveries has to outlive this window, or a delivery still inside its accepted
@@ -26301,19 +26240,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26301
26240
  * @max 3600
26302
26241
  */
26303
26242
  timestampToleranceSeconds?: number;
26304
- /**
26305
- * Header carrying the shared token the provider echoes on every delivery. Required for
26306
- * CALLBACK_TOKEN and must be empty for every other method. For example:
26307
- * "X-Goog-Channel-Token". The token itself is never declared here — it is located through
26308
- * verification_source.
26309
- *
26310
- * Deprecated: superseded by CallbackTokenConfig.callback_token_header.
26311
- * @maxLength 120
26312
- * @deprecated
26313
- * @replacedBy verification.callback_token_config.callback_token_header
26314
- * @targetRemovalDate 2027-06-30
26315
- */
26316
- callbackTokenHeader?: string;
26317
26243
  /**
26318
26244
  * Endpoint publishing the provider's public keys. Required for PUBLIC_KEY and OIDC_BEARER, and
26319
26245
  * must be empty for every other method.
@@ -25686,12 +25686,15 @@ declare enum VerificationSource {
25686
25686
  CONNECTOR_WIDE = "CONNECTOR_WIDE",
25687
25687
  /**
25688
25688
  * Material is issued per registration and lives on the registration the delivery was sent to.
25689
- * Requires registration_required.
25689
+ * Requires registration_required. A registration is the provider-side one for a single
25690
+ * account, which is that account's subscription; there is no separate registration entity.
25690
25691
  */
25691
25692
  PER_REGISTRATION = "PER_REGISTRATION",
25692
25693
  /**
25693
25694
  * There is no material, because nothing is verified. The only legal scope for
25694
- * NO_VERIFICATION, and legal for nothing else.
25695
+ * NO_VERIFICATION, and legal for nothing else. Redundant with NO_VERIFICATION on purpose:
25696
+ * every enum in a valid config is explicitly set, so "nothing was declared" and "the
25697
+ * declaration is that nothing is verified" stay distinguishable.
25695
25698
  */
25696
25699
  UNSIGNED = "UNSIGNED"
25697
25700
  }
@@ -25736,7 +25739,7 @@ type SignedPayloadWithLiterals = SignedPayload | 'RAW_BODY' | 'TIMESTAMP_DOT_RAW
25736
25739
  /**
25737
25740
  * Per-method payload for the `verification` oneof above. Shared by HMAC_SHA256,
25738
25741
  * HMAC_SHA1, and (wrapped) PUBLIC_KEY - the three methods signatureMethods already groups
25739
- * together in the validator. timestamp_header / timestamp_tolerance_seconds stay flat on
25742
+ * together in the validator. timestamp_header / timestamp_tolerance_seconds stay on
25740
25743
  * WebhookConfig rather than moving in here, since BODY_HASH_WITHIN_TIMESTAMP_WINDOW borrows
25741
25744
  * them independently of which verification_method is selected.
25742
25745
  */
@@ -25750,13 +25753,20 @@ interface HmacConfig {
25750
25753
  signatureHeader?: string;
25751
25754
  /**
25752
25755
  * Literal prefix the provider places in front of the encoded signature, for example
25753
- * "sha256=" or "v0=". Empty when the header holds the bare signature.
25756
+ * "sha256=" or "v0=". Empty when the header holds the bare signature. A constant, never a
25757
+ * template: compared verbatim against the start of the header, and a delivery whose header
25758
+ * does not start with it is rejected.
25754
25759
  * @maxLength 20
25755
25760
  */
25756
25761
  signatureValuePrefix?: string;
25757
25762
  /** How the signature bytes are encoded in signature_header. */
25758
25763
  signatureEncoding?: SignatureEncodingWithLiterals;
25759
- /** Which canonical string the signature is computed over. */
25764
+ /**
25765
+ * Which canonical string the signature is computed over, from a closed set of recipes. There
25766
+ * is deliberately no free-form signing template, which would make the inbound path an
25767
+ * interpreter of app-owner input; a provider whose canonical string is not listed needs a new
25768
+ * enum value.
25769
+ */
25760
25770
  signedPayload?: SignedPayloadWithLiterals;
25761
25771
  }
25762
25772
  declare enum EventsLocation {
@@ -26131,8 +26141,8 @@ interface DispatchConfig {
26131
26141
  *
26132
26142
  * No credential material is declared here. This config lives in the app component catalog and is
26133
26143
  * readable by app owners; signing secrets and callback tokens are stored separately and are
26134
- * located through verification_source. public_key_url is the only credential-adjacent field, and
26135
- * it points at material the provider publishes.
26144
+ * located through the selected verification arm's verification_source. public_key_url is the
26145
+ * only credential-adjacent field, and it points at material the provider publishes.
26136
26146
  *
26137
26147
  * Fields naming something the provider owns carry a provider_ prefix, so the identifiers a
26138
26148
  * delivery arrives with are never confused with the ones Wix mints.
@@ -26163,90 +26173,19 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26163
26173
  * must select a concrete method — an unset method is rejected rather than treated as a default.
26164
26174
  */
26165
26175
  verificationMethod?: VerificationMethodWithLiterals;
26166
- /**
26167
- * Scope of the material used by verification_method: shared by the whole connector, or issued
26168
- * per registration. Names the scope rather than the kind of material, so it stays accurate for
26169
- * PUBLIC_KEY, where the connector-wide material is a published key URL and nothing is stored.
26170
- *
26171
- * "Per registration" is the provider-side registration for one account, which is that account's
26172
- * subscription - there is no separate registration entity to look for.
26173
- *
26174
- * The UNSIGNED arm is redundant with verification_method = NO_VERIFICATION, and deliberately so:
26175
- * every enum in a valid config is explicitly set, which keeps "nothing was declared" and "the
26176
- * declaration is that nothing is verified" distinguishable states rather than the same unset
26177
- * field. The alternative - dropping the arm and making this field conditionally required - moves
26178
- * the same fact into a validation rule instead of removing it.
26179
- *
26180
- * Deprecated: superseded by each `verification` arm's own verification_source field. Kept live
26181
- * and enforced for the flat-shape configs this migration has not yet moved off of.
26182
- * @deprecated
26183
- * @replacedBy verification (each arm's own verification_source field)
26184
- * @targetRemovalDate 2027-06-30
26185
- */
26186
- verificationSource?: VerificationSourceWithLiterals;
26187
- /**
26188
- * Header carrying the signature to verify. Required for HMAC_SHA256, HMAC_SHA1 and PUBLIC_KEY,
26189
- * and must be empty for every other method. For example: "X-Hub-Signature-256".
26190
- *
26191
- * Deprecated: superseded by HmacConfig.signature_header (via the `verification` oneof's
26192
- * hmac_sha256_config, hmac_sha1_config and public_key_config arms).
26193
- * @maxLength 120
26194
- * @deprecated
26195
- * @replacedBy HmacConfig.signature_header (via the verification oneof)
26196
- * @targetRemovalDate 2027-06-30
26197
- */
26198
- signatureHeader?: string;
26199
- /**
26200
- * Literal prefix the provider places in front of the encoded signature, for example "sha256="
26201
- * or "v0=". Empty when the header holds the bare signature.
26202
- *
26203
- * The value is a constant, never a template: it is compared verbatim against the start of the
26204
- * header and stripped before decoding, and a delivery whose header does not start with it is
26205
- * rejected. Nothing in it is interpreted or substituted.
26206
- *
26207
- * Deprecated: superseded by HmacConfig.signature_value_prefix.
26208
- * @maxLength 20
26209
- * @deprecated
26210
- * @replacedBy HmacConfig.signature_value_prefix (via the verification oneof)
26211
- * @targetRemovalDate 2027-06-30
26212
- */
26213
- signatureValuePrefix?: string;
26214
- /**
26215
- * How the signature bytes are encoded in signature_header. Required whenever signature_header
26216
- * is required.
26217
- *
26218
- * Deprecated: superseded by HmacConfig.signature_encoding.
26219
- * @deprecated
26220
- * @replacedBy HmacConfig.signature_encoding (via the verification oneof)
26221
- * @targetRemovalDate 2027-06-30
26222
- */
26223
- signatureEncoding?: SignatureEncodingWithLiterals;
26224
- /**
26225
- * Which canonical string the signature is computed over, selected from a closed set of recipes
26226
- * the server implements. Required whenever signature_header is required.
26227
- *
26228
- * There is deliberately no free-form signing template: a configurable template would make the
26229
- * inbound path an interpreter of app-owner input and an injection surface. A provider whose
26230
- * canonical string is not listed here needs a new enum value, not a new template.
26231
- *
26232
- * Deprecated: superseded by HmacConfig.signed_payload.
26233
- * @deprecated
26234
- * @replacedBy HmacConfig.signed_payload (via the verification oneof)
26235
- * @targetRemovalDate 2027-06-30
26236
- */
26237
- signedPayload?: SignedPayloadWithLiterals;
26238
26176
  /**
26239
26177
  * Header carrying the delivery timestamp, used to reject stale and replayed deliveries. For
26240
- * example: "X-Slack-Request-Timestamp". Required by the signed_payload recipes that include a
26241
- * timestamp, and must be set together with timestamp_tolerance_seconds. The header value is read
26242
- * as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as epoch milliseconds.
26178
+ * example: "X-Slack-Request-Timestamp". Required by the HmacConfig.signed_payload recipes that
26179
+ * include a timestamp, and must be set together with timestamp_tolerance_seconds. The header
26180
+ * value is read as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
26181
+ * epoch milliseconds.
26243
26182
  * @maxLength 120
26244
26183
  */
26245
26184
  timestampHeader?: string;
26246
26185
  /**
26247
26186
  * How far the delivery timestamp may be from server time before the delivery is rejected. Must
26248
26187
  * be greater than zero when timestamp_header is set, and zero when it is not. Always in seconds,
26249
- * whatever unit the signed_payload recipe reads timestamp_header in.
26188
+ * whatever unit the HmacConfig.signed_payload recipe reads timestamp_header in.
26250
26189
  *
26251
26190
  * The tolerance is a floor on replay-protection retention, not only a freshness bound: whatever
26252
26191
  * remembers seen deliveries has to outlive this window, or a delivery still inside its accepted
@@ -26259,19 +26198,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26259
26198
  * @max 3600
26260
26199
  */
26261
26200
  timestampToleranceSeconds?: number;
26262
- /**
26263
- * Header carrying the shared token the provider echoes on every delivery. Required for
26264
- * CALLBACK_TOKEN and must be empty for every other method. For example:
26265
- * "X-Goog-Channel-Token". The token itself is never declared here — it is located through
26266
- * verification_source.
26267
- *
26268
- * Deprecated: superseded by CallbackTokenConfig.callback_token_header.
26269
- * @maxLength 120
26270
- * @deprecated
26271
- * @replacedBy verification.callback_token_config.callback_token_header
26272
- * @targetRemovalDate 2027-06-30
26273
- */
26274
- callbackTokenHeader?: string;
26275
26201
  /**
26276
26202
  * Endpoint publishing the provider's public keys. Required for PUBLIC_KEY and OIDC_BEARER, and
26277
26203
  * must be empty for every other method.