@wix/auto_sdk_app-components_components-catalog 1.0.109 → 1.0.111

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.
@@ -25680,18 +25680,21 @@ interface DispatchOrigin {
25680
25680
  declare enum VerificationSource {
25681
25681
  /**
25682
25682
  * One set of material covers every delivery of this connector: a single stored secret for the
25683
- * HMAC and callback-token methods, or the published key set at public_key_url for PUBLIC_KEY
25684
- * and OIDC_BEARER, where nothing is stored at all. The only legal scope for either.
25683
+ * HMAC and callback-token methods, or the published key set at the arm's public_key_url for
25684
+ * PUBLIC_KEY and OIDC_BEARER, where nothing is stored at all. The only legal scope for either.
25685
25685
  */
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 {
@@ -25776,7 +25786,7 @@ declare enum VerificationMethod {
25776
25786
  HMAC_SHA1 = "HMAC_SHA1",
25777
25787
  /**
25778
25788
  * Asymmetric signature over the canonical string, verified with a key fetched from
25779
- * public_key_url.
25789
+ * PublicKeyConfig.public_key_url.
25780
25790
  */
25781
25791
  PUBLIC_KEY = "PUBLIC_KEY",
25782
25792
  /**
@@ -25789,9 +25799,10 @@ declare enum VerificationMethod {
25789
25799
  NO_VERIFICATION = "NO_VERIFICATION",
25790
25800
  /**
25791
25801
  * OIDC bearer JWT in the Authorization header, verified against the key set at
25792
- * public_key_url with the expected audience, issuer and subject, for example Cloud Pub/Sub
25793
- * push authentication. Carries no payload binding, the same limitation CALLBACK_TOKEN
25794
- * documents for itself: it proves the sender's identity, not that the body is intact.
25802
+ * OidcBearerConfig.public_key_url with the expected audience, issuer and subject, for
25803
+ * example Cloud Pub/Sub push authentication. Carries no payload binding, the same
25804
+ * limitation CALLBACK_TOKEN documents for itself: it proves the sender's identity, not that
25805
+ * the body is intact.
25795
25806
  */
25796
25807
  OIDC_BEARER = "OIDC_BEARER"
25797
25808
  }
@@ -25800,8 +25811,8 @@ type VerificationMethodWithLiterals = VerificationMethod | 'HMAC_SHA256' | 'HMAC
25800
25811
  /** How a repeated delivery is recognized, so the same event is not processed twice. */
25801
25812
  declare enum ReplayProtection {
25802
25813
  /**
25803
- * The provider sends a per-delivery id, named by delivery_id_header, and a delivery already
25804
- * seen under that id is discarded.
25814
+ * The provider sends a per-delivery id, named by DeliveryIdHeaderConfig.delivery_id_header,
25815
+ * and a delivery already seen under that id is discarded.
25805
25816
  */
25806
25817
  DELIVERY_ID_HEADER = "DELIVERY_ID_HEADER",
25807
25818
  /**
@@ -26131,8 +26142,9 @@ interface DispatchConfig {
26131
26142
  *
26132
26143
  * No credential material is declared here. This config lives in the app component catalog and is
26133
26144
  * 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.
26145
+ * located through the selected verification arm's verification_source. The public_key_url on
26146
+ * PublicKeyConfig and OidcBearerConfig is the only credential-adjacent field, and it points at
26147
+ * material the provider publishes.
26136
26148
  *
26137
26149
  * Fields naming something the provider owns carry a provider_ prefix, so the identifiers a
26138
26150
  * delivery arrives with are never confused with the ones Wix mints.
@@ -26163,90 +26175,19 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26163
26175
  * must select a concrete method — an unset method is rejected rather than treated as a default.
26164
26176
  */
26165
26177
  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
26178
  /**
26239
26179
  * 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.
26180
+ * example: "X-Slack-Request-Timestamp". Required by the HmacConfig.signed_payload recipes that
26181
+ * include a timestamp, and must be set together with timestamp_tolerance_seconds. The header
26182
+ * value is read as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
26183
+ * epoch milliseconds.
26243
26184
  * @maxLength 120
26244
26185
  */
26245
26186
  timestampHeader?: string;
26246
26187
  /**
26247
26188
  * How far the delivery timestamp may be from server time before the delivery is rejected. Must
26248
26189
  * 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.
26190
+ * whatever unit the HmacConfig.signed_payload recipe reads timestamp_header in.
26250
26191
  *
26251
26192
  * The tolerance is a floor on replay-protection retention, not only a freshness bound: whatever
26252
26193
  * remembers seen deliveries has to outlive this window, or a delivery still inside its accepted
@@ -26259,52 +26200,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26259
26200
  * @max 3600
26260
26201
  */
26261
26202
  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
- /**
26276
- * Endpoint publishing the provider's public keys. Required for PUBLIC_KEY and OIDC_BEARER, and
26277
- * must be empty for every other method.
26278
- *
26279
- * Deliberately has no (wix.api.format), following revoke_url above: WEB_URL rejects the empty
26280
- * value this field carries for every other method. HTTPS and a parseable endpoint are enforced
26281
- * when the keys are fetched instead.
26282
- *
26283
- * Deprecated: superseded by PublicKeyConfig.public_key_url for PUBLIC_KEY, and by
26284
- * OidcBearerConfig.public_key_url for OIDC_BEARER.
26285
- * @maxLength 2000
26286
- * @deprecated
26287
- * @replacedBy verification.public_key_config.public_key_url (PUBLIC_KEY) or verification.oidc_bearer_config.public_key_url (OIDC_BEARER)
26288
- * @targetRemovalDate 2027-06-30
26289
- */
26290
- publicKeyUrl?: string;
26291
- /**
26292
- * Header carrying the provider's unique id for this delivery, for example "X-GitHub-Delivery".
26293
- * Required by, and legal only with, replay_protection = DELIVERY_ID_HEADER.
26294
- *
26295
- * The id is only as unique as the provider makes it. Google Calendar's X-Goog-Message-Number,
26296
- * for instance, counts per notification channel rather than globally, so a delivery is
26297
- * identified by the registration it arrived on together with this value, never by the value
26298
- * alone.
26299
- *
26300
- * Deprecated: superseded by DeliveryIdHeaderConfig.delivery_id_header (via the
26301
- * `replay_protection_config` oneof's delivery_id_header_config arm).
26302
- * @maxLength 120
26303
- * @deprecated
26304
- * @replacedBy replay_protection_config.delivery_id_header_config.delivery_id_header
26305
- * @targetRemovalDate 2027-06-30
26306
- */
26307
- deliveryIdHeader?: string;
26308
26203
  /**
26309
26204
  * Header carrying the event type of the delivery, for example "X-GitHub-Event". Optional: at
26310
26205
  * most one of event_type_header and event_type_json_pointer may be set, and a provider with no
@@ -26422,47 +26317,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26422
26317
  * @immutable
26423
26318
  */
26424
26319
  deliveryTopic?: string;
26425
- /**
26426
- * Expected `aud` claim of an OIDC_BEARER token. An OIDC issuer's audience is chosen by whoever
26427
- * requested the token, not by the issuer, so pinning the value expected here is what stops a
26428
- * bearer token minted for a different audience — a different Pub/Sub push subscription, for
26429
- * instance — from authenticating against this one. Required for OIDC_BEARER and must be empty
26430
- * for every other method.
26431
- *
26432
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_audience.
26433
- * @maxLength 2000
26434
- * @deprecated
26435
- * @replacedBy verification.oidc_bearer_config.oidc_expected_audience
26436
- * @targetRemovalDate 2027-06-30
26437
- */
26438
- oidcExpectedAudience?: string;
26439
- /**
26440
- * Expected `iss` claim of an OIDC_BEARER token, for example "https://accounts.google.com".
26441
- * Required for OIDC_BEARER and must be empty for every other method.
26442
- *
26443
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_issuer.
26444
- * @maxLength 2000
26445
- * @deprecated
26446
- * @replacedBy verification.oidc_bearer_config.oidc_expected_issuer
26447
- * @targetRemovalDate 2027-06-30
26448
- */
26449
- oidcExpectedIssuer?: string;
26450
- /**
26451
- * Expected `sub` claim of an OIDC_BEARER token — the stable identifier of the specific caller
26452
- * trusted to send this connector's deliveries, for example a Pub/Sub push subscription's
26453
- * service account. iss and aud alone do not identify the sender: aud is a value the token
26454
- * *requester* chooses, not the issuer, so any principal able to mint a same-issuer,
26455
- * same-audience token — a different Google service account with permission to request an ID
26456
- * token for this audience, for instance — would otherwise pass. Required for OIDC_BEARER and
26457
- * must be empty for every other method.
26458
- *
26459
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_subject.
26460
- * @maxLength 2000
26461
- * @deprecated
26462
- * @replacedBy verification.oidc_bearer_config.oidc_expected_subject
26463
- * @targetRemovalDate 2027-06-30
26464
- */
26465
- oidcExpectedSubject?: string;
26466
26320
  /**
26467
26321
  * Set when one delivery body is a batch of events, each possibly for a different provider tenant.
26468
26322
  * The whole request is verified once, then split into one delivery per element.
@@ -25722,18 +25722,21 @@ interface DispatchOrigin {
25722
25722
  declare enum VerificationSource {
25723
25723
  /**
25724
25724
  * One set of material covers every delivery of this connector: a single stored secret for the
25725
- * HMAC and callback-token methods, or the published key set at public_key_url for PUBLIC_KEY
25726
- * and OIDC_BEARER, where nothing is stored at all. The only legal scope for either.
25725
+ * HMAC and callback-token methods, or the published key set at the arm's public_key_url for
25726
+ * PUBLIC_KEY and OIDC_BEARER, where nothing is stored at all. The only legal scope for either.
25727
25727
  */
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 {
@@ -25818,7 +25828,7 @@ declare enum VerificationMethod {
25818
25828
  HMAC_SHA1 = "HMAC_SHA1",
25819
25829
  /**
25820
25830
  * Asymmetric signature over the canonical string, verified with a key fetched from
25821
- * public_key_url.
25831
+ * PublicKeyConfig.public_key_url.
25822
25832
  */
25823
25833
  PUBLIC_KEY = "PUBLIC_KEY",
25824
25834
  /**
@@ -25831,9 +25841,10 @@ declare enum VerificationMethod {
25831
25841
  NO_VERIFICATION = "NO_VERIFICATION",
25832
25842
  /**
25833
25843
  * OIDC bearer JWT in the Authorization header, verified against the key set at
25834
- * public_key_url with the expected audience, issuer and subject, for example Cloud Pub/Sub
25835
- * push authentication. Carries no payload binding, the same limitation CALLBACK_TOKEN
25836
- * documents for itself: it proves the sender's identity, not that the body is intact.
25844
+ * OidcBearerConfig.public_key_url with the expected audience, issuer and subject, for
25845
+ * example Cloud Pub/Sub push authentication. Carries no payload binding, the same
25846
+ * limitation CALLBACK_TOKEN documents for itself: it proves the sender's identity, not that
25847
+ * the body is intact.
25837
25848
  */
25838
25849
  OIDC_BEARER = "OIDC_BEARER"
25839
25850
  }
@@ -25842,8 +25853,8 @@ type VerificationMethodWithLiterals = VerificationMethod | 'HMAC_SHA256' | 'HMAC
25842
25853
  /** How a repeated delivery is recognized, so the same event is not processed twice. */
25843
25854
  declare enum ReplayProtection {
25844
25855
  /**
25845
- * The provider sends a per-delivery id, named by delivery_id_header, and a delivery already
25846
- * seen under that id is discarded.
25856
+ * The provider sends a per-delivery id, named by DeliveryIdHeaderConfig.delivery_id_header,
25857
+ * and a delivery already seen under that id is discarded.
25847
25858
  */
25848
25859
  DELIVERY_ID_HEADER = "DELIVERY_ID_HEADER",
25849
25860
  /**
@@ -26173,8 +26184,9 @@ interface DispatchConfig {
26173
26184
  *
26174
26185
  * No credential material is declared here. This config lives in the app component catalog and is
26175
26186
  * 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.
26187
+ * located through the selected verification arm's verification_source. The public_key_url on
26188
+ * PublicKeyConfig and OidcBearerConfig is the only credential-adjacent field, and it points at
26189
+ * material the provider publishes.
26178
26190
  *
26179
26191
  * Fields naming something the provider owns carry a provider_ prefix, so the identifiers a
26180
26192
  * delivery arrives with are never confused with the ones Wix mints.
@@ -26205,90 +26217,19 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26205
26217
  * must select a concrete method — an unset method is rejected rather than treated as a default.
26206
26218
  */
26207
26219
  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
26220
  /**
26281
26221
  * 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.
26222
+ * example: "X-Slack-Request-Timestamp". Required by the HmacConfig.signed_payload recipes that
26223
+ * include a timestamp, and must be set together with timestamp_tolerance_seconds. The header
26224
+ * value is read as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
26225
+ * epoch milliseconds.
26285
26226
  * @maxLength 120
26286
26227
  */
26287
26228
  timestampHeader?: string;
26288
26229
  /**
26289
26230
  * How far the delivery timestamp may be from server time before the delivery is rejected. Must
26290
26231
  * 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.
26232
+ * whatever unit the HmacConfig.signed_payload recipe reads timestamp_header in.
26292
26233
  *
26293
26234
  * The tolerance is a floor on replay-protection retention, not only a freshness bound: whatever
26294
26235
  * remembers seen deliveries has to outlive this window, or a delivery still inside its accepted
@@ -26301,52 +26242,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26301
26242
  * @max 3600
26302
26243
  */
26303
26244
  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
- /**
26318
- * Endpoint publishing the provider's public keys. Required for PUBLIC_KEY and OIDC_BEARER, and
26319
- * must be empty for every other method.
26320
- *
26321
- * Deliberately has no (wix.api.format), following revoke_url above: WEB_URL rejects the empty
26322
- * value this field carries for every other method. HTTPS and a parseable endpoint are enforced
26323
- * when the keys are fetched instead.
26324
- *
26325
- * Deprecated: superseded by PublicKeyConfig.public_key_url for PUBLIC_KEY, and by
26326
- * OidcBearerConfig.public_key_url for OIDC_BEARER.
26327
- * @maxLength 2000
26328
- * @deprecated
26329
- * @replacedBy verification.public_key_config.public_key_url (PUBLIC_KEY) or verification.oidc_bearer_config.public_key_url (OIDC_BEARER)
26330
- * @targetRemovalDate 2027-06-30
26331
- */
26332
- publicKeyUrl?: string;
26333
- /**
26334
- * Header carrying the provider's unique id for this delivery, for example "X-GitHub-Delivery".
26335
- * Required by, and legal only with, replay_protection = DELIVERY_ID_HEADER.
26336
- *
26337
- * The id is only as unique as the provider makes it. Google Calendar's X-Goog-Message-Number,
26338
- * for instance, counts per notification channel rather than globally, so a delivery is
26339
- * identified by the registration it arrived on together with this value, never by the value
26340
- * alone.
26341
- *
26342
- * Deprecated: superseded by DeliveryIdHeaderConfig.delivery_id_header (via the
26343
- * `replay_protection_config` oneof's delivery_id_header_config arm).
26344
- * @maxLength 120
26345
- * @deprecated
26346
- * @replacedBy replay_protection_config.delivery_id_header_config.delivery_id_header
26347
- * @targetRemovalDate 2027-06-30
26348
- */
26349
- deliveryIdHeader?: string;
26350
26245
  /**
26351
26246
  * Header carrying the event type of the delivery, for example "X-GitHub-Event". Optional: at
26352
26247
  * most one of event_type_header and event_type_json_pointer may be set, and a provider with no
@@ -26464,47 +26359,6 @@ interface WebhookConfig extends WebhookConfigVerificationOneOf, WebhookConfigRep
26464
26359
  * @immutable
26465
26360
  */
26466
26361
  deliveryTopic?: string;
26467
- /**
26468
- * Expected `aud` claim of an OIDC_BEARER token. An OIDC issuer's audience is chosen by whoever
26469
- * requested the token, not by the issuer, so pinning the value expected here is what stops a
26470
- * bearer token minted for a different audience — a different Pub/Sub push subscription, for
26471
- * instance — from authenticating against this one. Required for OIDC_BEARER and must be empty
26472
- * for every other method.
26473
- *
26474
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_audience.
26475
- * @maxLength 2000
26476
- * @deprecated
26477
- * @replacedBy verification.oidc_bearer_config.oidc_expected_audience
26478
- * @targetRemovalDate 2027-06-30
26479
- */
26480
- oidcExpectedAudience?: string;
26481
- /**
26482
- * Expected `iss` claim of an OIDC_BEARER token, for example "https://accounts.google.com".
26483
- * Required for OIDC_BEARER and must be empty for every other method.
26484
- *
26485
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_issuer.
26486
- * @maxLength 2000
26487
- * @deprecated
26488
- * @replacedBy verification.oidc_bearer_config.oidc_expected_issuer
26489
- * @targetRemovalDate 2027-06-30
26490
- */
26491
- oidcExpectedIssuer?: string;
26492
- /**
26493
- * Expected `sub` claim of an OIDC_BEARER token — the stable identifier of the specific caller
26494
- * trusted to send this connector's deliveries, for example a Pub/Sub push subscription's
26495
- * service account. iss and aud alone do not identify the sender: aud is a value the token
26496
- * *requester* chooses, not the issuer, so any principal able to mint a same-issuer,
26497
- * same-audience token — a different Google service account with permission to request an ID
26498
- * token for this audience, for instance — would otherwise pass. Required for OIDC_BEARER and
26499
- * must be empty for every other method.
26500
- *
26501
- * Deprecated: superseded by OidcBearerConfig.oidc_expected_subject.
26502
- * @maxLength 2000
26503
- * @deprecated
26504
- * @replacedBy verification.oidc_bearer_config.oidc_expected_subject
26505
- * @targetRemovalDate 2027-06-30
26506
- */
26507
- oidcExpectedSubject?: string;
26508
26362
  /**
26509
26363
  * Set when one delivery body is a batch of events, each possibly for a different provider tenant.
26510
26364
  * The whole request is verified once, then split into one delivery per element.