@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.
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +22 -96
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +22 -96
- package/build/cjs/meta.js.map +1 -1
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +22 -96
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +22 -96
- package/build/es/meta.mjs.map +1 -1
- package/build/internal/cjs/index.typings.d.ts +22 -96
- package/build/internal/cjs/meta.d.ts +22 -96
- package/build/internal/es/index.typings.d.mts +22 -96
- package/build/internal/es/meta.d.mts +22 -96
- package/package.json +2 -2
|
@@ -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
|
|
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
|
-
/**
|
|
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
|
|
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
|
|
26241
|
-
* timestamp, and must be set together with timestamp_tolerance_seconds. The header
|
|
26242
|
-
* as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
|
|
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
|
|
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
|
-
/**
|
|
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
|
|
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
|
|
26283
|
-
* timestamp, and must be set together with timestamp_tolerance_seconds. The header
|
|
26284
|
-
* as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
|
|
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
|
|
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
|
-
/**
|
|
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
|
|
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
|
|
26241
|
-
* timestamp, and must be set together with timestamp_tolerance_seconds. The header
|
|
26242
|
-
* as epoch seconds, except under METHOD_URI_BODY_TIMESTAMP, which reads it as
|
|
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.
|