@wix/auto_sdk_connectors_connectors 1.0.0 → 1.0.2

package/build/internal/es/meta.d.mts

@@ -75,10 +75,12 @@ interface Connector extends ConnectorRegistrationOneOf {
      * identically here. Carried as the GrantedScopes message rather than a bare repeated string so a
      * provider that never reports scopes (reporting_state NOT_REPORTED) stays distinguishable from one
      * that explicitly reported an empty set (REPORTED with no scopes); flattening the two would turn an
-     * unknown into a false negative for anyone reading this field. Server-owned: no create or update path
-     * accepts a caller-supplied value for it. The producer only emits AccessKeyBindingPushed on a
-     * credential_state transition, so a scopes-only change at the shared access key (no state transition)
-     * does not reach this field -- it reflects scopes as of the last state transition, not necessarily the
+     * unknown into a false negative for anyone reading this field. INTERNAL exposure plus CreateConnector's
+     * WIX_APPS_ONLY audience are what protect this field: oauth-handler is the only writable() caller,
+     * supplying the real value it already holds from the token exchange at creation; no other create or
+     * update path can touch it. The producer only emits AccessKeyBindingPushed on a credential_state
+     * transition, so a scopes-only change at the shared access key (no state transition) does not reach
+     * this field after creation -- it reflects scopes as of the last state transition, not necessarily the
      * shared key's current scopes.
      * @internal
      * @readonly
@@ -92,12 +94,17 @@ interface Connector extends ConnectorRegistrationOneOf {
      * decision (dispatch, revocation, anything that gates behavior) must keep reading
      * connectors-access-keys-store synchronously. The same rule covers filtering by this field: a query
      * for credential_state == ACTIVE returns what the platform last believed, never a permission to use
-     * those bindings. UNKNOWN_CREDENTIAL_STATE means no push has ever arrived for the bound access key --
-     * including every row that predates this projection -- and is never a signal of a healthy connection.
-     * Server-owned: no create or update path accepts a caller-supplied value for it. When a push carries
-     * the source event's own timestamp, that timestamp is tracked on the domain row (not exposed on this
-     * contract) and a later push older than the stored value is dropped; a push with no timestamp only
-     * ever initializes a row that has never recorded one, never overwrites an already-timestamped
+     * those bindings. UNKNOWN_CREDENTIAL_STATE means the row predates this projection, or its creator's
+     * own upstream state was itself unknown at creation -- never a signal of a healthy connection either
+     * way; every new row otherwise gets the real value at creation.
+     * readOnly plus CreateConnector's WIX_APPS_ONLY audience are what protect this field: it is
+     * writable() only on that one RPC, so only oauth-handler can supply the real value at creation; every
+     * other create or update path still can't touch it. Deliberately NOT field_exposure = INTERNAL, so
+     * this field stays filterable/visible to the same external callers as SiteConnector's sibling field,
+     * which was never internal. When a push
+     * carries the source event's own timestamp, that timestamp is tracked on the domain row (not exposed
+     * on this contract) and a later push older than the stored value is dropped; a push with no timestamp
+     * only ever initializes a row that has never recorded one, never overwrites an already-timestamped
      * snapshot.
      * @readonly
      */
@@ -693,6 +700,38 @@ interface RawHttpResponse {
     statusCode?: number | null;
     headers?: HeadersEntry[];
 }
+interface DispatchByAccessKeyRequest {
+    /**
+     * ID of the ConnectorAccessKey to dispatch under. Never authorization by itself — the caller's
+     * Plazma grant on this method is what authorizes the call; this id only selects the credential.
+     * @format GUID
+     */
+    accessKeyId?: string;
+    /**
+     * The connector app that declares the CONNECTOR_CONFIG component to authorize this dispatch
+     * against. Supplied directly because there is no connector binding to resolve it from.
+     * @format GUID
+     */
+    appId?: string;
+    /**
+     * The CONNECTOR_CONFIG component within that app, whose dispatch policy governs this request.
+     * @format GUID
+     */
+    componentId?: string;
+    /** Raw provider request. Callers must not include credentials; Wix injects them at dispatch. */
+    providerRequest?: RawHttpRequest;
+    /**
+     * Optional caller-supplied key making a retry of this dispatch safe: the same key on the same
+     * access key will not produce a second provider attempt through Wix. Scoped to the access key,
+     * so callers need only make it unique per access key. Guarantees at-most-once ATTEMPT by Wix — it
+     * cannot guarantee the provider applied the effect at most once when an attempt's outcome is
+     * unknown (timeout, connection reset). For that, include the provider's own idempotency header in
+     * provider_request. A repeated key fails with a duplicate-dispatch error rather than replaying the
+     * original response, which Wix does not retain; callers needing it must store it themselves.
+     * @maxLength 128
+     */
+    idempotencyKey?: string;
+}
 interface ListMcpToolsRequest {
     /**
      * ID of the Connector whose callable MCP tools are requested.
@@ -749,4 +788,4 @@ declare function listMcpTools(): __PublicMethodMetaInfo<'GET', {
     connectorId: string;
 }, ListMcpToolsRequest$1, ListMcpToolsRequest, ListMcpToolsResponse$1, ListMcpToolsResponse>;
 
-export { type AccountInfo as AccountInfoOriginal, type ActionEvent as ActionEventOriginal, type Completed as CompletedOriginal, type Connector as ConnectorOriginal, type ConnectorRegistrationOneOf as ConnectorRegistrationOneOfOriginal, type CreateConnectorRequest as CreateConnectorRequestOriginal, type CreateConnectorResponse as CreateConnectorResponseOriginal, CredentialState as CredentialStateOriginal, type CredentialStateWithLiterals as CredentialStateWithLiteralsOriginal, type CursorPagingMetadata as CursorPagingMetadataOriginal, type CursorPaging as CursorPagingOriginal, type CursorQuery as CursorQueryOriginal, type CursorQueryPagingMethodOneOf as CursorQueryPagingMethodOneOfOriginal, type Cursors as CursorsOriginal, type DeleteConnectorRequest as DeleteConnectorRequestOriginal, type DeleteConnectorResponse as DeleteConnectorResponseOriginal, type DispatchRequest as DispatchRequestOriginal, type DomainEventBodyOneOf as DomainEventBodyOneOfOriginal, type DomainEvent as DomainEventOriginal, type DynamicRegistration as DynamicRegistrationOriginal, type Empty as EmptyOriginal, type EntityCreatedEvent as EntityCreatedEventOriginal, type EntityDeletedEvent as EntityDeletedEventOriginal, type EntityUpdatedEvent as EntityUpdatedEventOriginal, Exposure as ExposureOriginal, type ExposureWithLiterals as ExposureWithLiteralsOriginal, type GetConnectorRequest as GetConnectorRequestOriginal, type GetConnectorResponse as GetConnectorResponseOriginal, type GrantedScopes as GrantedScopesOriginal, type HeadersEntry as HeadersEntryOriginal, type IdentificationDataIdOneOf as IdentificationDataIdOneOfOriginal, type IdentificationData as IdentificationDataOriginal, type ListMcpToolsRequest as ListMcpToolsRequestOriginal, type ListMcpToolsResponse as ListMcpToolsResponseOriginal, type McpTool as McpToolOriginal, type MessageEnvelope as MessageEnvelopeOriginal, type PathParametersEntry as PathParametersEntryOriginal, type PredefinedRegistration as PredefinedRegistrationOriginal, type QueryConnectorsRequest as QueryConnectorsRequestOriginal, type QueryConnectorsResponse as QueryConnectorsResponseOriginal, type QueryParametersEntry as QueryParametersEntryOriginal, type RawHttpRequest as RawHttpRequestOriginal, type RawHttpResponse as RawHttpResponseOriginal, type Redirect as RedirectOriginal, RegistrationType as RegistrationTypeOriginal, type RegistrationTypeWithLiterals as RegistrationTypeWithLiteralsOriginal, type RestoreInfo as RestoreInfoOriginal, ScopeReportingState as ScopeReportingStateOriginal, type ScopeReportingStateWithLiterals as ScopeReportingStateWithLiteralsOriginal, SortOrder as SortOrderOriginal, type SortOrderWithLiterals as SortOrderWithLiteralsOriginal, type Sorting as SortingOriginal, type StartConnectRequest as StartConnectRequestOriginal, type StartConnectRequestOwnerOneOf as StartConnectRequestOwnerOneOfOriginal, StartConnectRequestRegistrationType as StartConnectRequestRegistrationTypeOriginal, type StartConnectRequestRegistrationTypeWithLiterals as StartConnectRequestRegistrationTypeWithLiteralsOriginal, type StartConnectResponseNextActionOneOf as StartConnectResponseNextActionOneOfOriginal, type StartConnectResponse as StartConnectResponseOriginal, WebhookIdentityType as WebhookIdentityTypeOriginal, type WebhookIdentityTypeWithLiterals as WebhookIdentityTypeWithLiteralsOriginal, type __PublicMethodMetaInfo, deleteConnector, dispatcherDispatch, getConnector, listMcpTools, queryConnectors, startConnect };
+export { type AccountInfo as AccountInfoOriginal, type ActionEvent as ActionEventOriginal, type Completed as CompletedOriginal, type Connector as ConnectorOriginal, type ConnectorRegistrationOneOf as ConnectorRegistrationOneOfOriginal, type CreateConnectorRequest as CreateConnectorRequestOriginal, type CreateConnectorResponse as CreateConnectorResponseOriginal, CredentialState as CredentialStateOriginal, type CredentialStateWithLiterals as CredentialStateWithLiteralsOriginal, type CursorPagingMetadata as CursorPagingMetadataOriginal, type CursorPaging as CursorPagingOriginal, type CursorQuery as CursorQueryOriginal, type CursorQueryPagingMethodOneOf as CursorQueryPagingMethodOneOfOriginal, type Cursors as CursorsOriginal, type DeleteConnectorRequest as DeleteConnectorRequestOriginal, type DeleteConnectorResponse as DeleteConnectorResponseOriginal, type DispatchByAccessKeyRequest as DispatchByAccessKeyRequestOriginal, type DispatchRequest as DispatchRequestOriginal, type DomainEventBodyOneOf as DomainEventBodyOneOfOriginal, type DomainEvent as DomainEventOriginal, type DynamicRegistration as DynamicRegistrationOriginal, type Empty as EmptyOriginal, type EntityCreatedEvent as EntityCreatedEventOriginal, type EntityDeletedEvent as EntityDeletedEventOriginal, type EntityUpdatedEvent as EntityUpdatedEventOriginal, Exposure as ExposureOriginal, type ExposureWithLiterals as ExposureWithLiteralsOriginal, type GetConnectorRequest as GetConnectorRequestOriginal, type GetConnectorResponse as GetConnectorResponseOriginal, type GrantedScopes as GrantedScopesOriginal, type HeadersEntry as HeadersEntryOriginal, type IdentificationDataIdOneOf as IdentificationDataIdOneOfOriginal, type IdentificationData as IdentificationDataOriginal, type ListMcpToolsRequest as ListMcpToolsRequestOriginal, type ListMcpToolsResponse as ListMcpToolsResponseOriginal, type McpTool as McpToolOriginal, type MessageEnvelope as MessageEnvelopeOriginal, type PathParametersEntry as PathParametersEntryOriginal, type PredefinedRegistration as PredefinedRegistrationOriginal, type QueryConnectorsRequest as QueryConnectorsRequestOriginal, type QueryConnectorsResponse as QueryConnectorsResponseOriginal, type QueryParametersEntry as QueryParametersEntryOriginal, type RawHttpRequest as RawHttpRequestOriginal, type RawHttpResponse as RawHttpResponseOriginal, type Redirect as RedirectOriginal, RegistrationType as RegistrationTypeOriginal, type RegistrationTypeWithLiterals as RegistrationTypeWithLiteralsOriginal, type RestoreInfo as RestoreInfoOriginal, ScopeReportingState as ScopeReportingStateOriginal, type ScopeReportingStateWithLiterals as ScopeReportingStateWithLiteralsOriginal, SortOrder as SortOrderOriginal, type SortOrderWithLiterals as SortOrderWithLiteralsOriginal, type Sorting as SortingOriginal, type StartConnectRequest as StartConnectRequestOriginal, type StartConnectRequestOwnerOneOf as StartConnectRequestOwnerOneOfOriginal, StartConnectRequestRegistrationType as StartConnectRequestRegistrationTypeOriginal, type StartConnectRequestRegistrationTypeWithLiterals as StartConnectRequestRegistrationTypeWithLiteralsOriginal, type StartConnectResponseNextActionOneOf as StartConnectResponseNextActionOneOfOriginal, type StartConnectResponse as StartConnectResponseOriginal, WebhookIdentityType as WebhookIdentityTypeOriginal, type WebhookIdentityTypeWithLiterals as WebhookIdentityTypeWithLiteralsOriginal, type __PublicMethodMetaInfo, deleteConnector, dispatcherDispatch, getConnector, listMcpTools, queryConnectors, startConnect };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_connectors_connectors",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.connectors.v1.connector"
     }
   },
-  "falconPackageHash": "89928584315838bbbbd27e99d8d029799400ffff4f50f15e55111b34"
+  "falconPackageHash": "2516d84196ccac90b9e071f117b6b2492f4605c9444f6e95d1e1666e"
 }