@wix/bex-utils 2.115.0 → 2.116.0

package/@wix/ambassador-hub-v1-job/src/main/proto/wix/hub/v1/oauth_service.proto

@@ -0,0 +1,218 @@
+syntax = "proto3";
+
+package wix.hub.v1;
+
+option java_package = "com.wixpress.hub.v1";
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/wrappers.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+import "wix/api/annotations.proto";
+import "wix/api/entity.proto";
+import "wix/api/permissions.proto";
+import "wix/api/validations.proto";
+import "raw-http-messages.proto";
+
+// OAuth providers
+enum OAuthProvider {
+  UNKNOWN_OAUTH_PROVIDER = 0;
+  GOOGLE = 1;
+}
+
+// OAuth token statuses
+enum TokenStatus {
+  UNKNOWN_OAUTH_TOKEN_STATUS = 0;
+  ACTIVE = 1;
+  INVALID = 2;
+  REVOKED = 3;
+}
+
+message OAuthConnection {
+  option (.wix.api.entity) = {
+    fqdn: "wix.hub.v1.oauth_connection"
+    segment: USERS
+  };
+  string id = 1 [(.wix.api.immutable) = true, (wix.api.maxLength) = 128];
+}
+
+// Represents an OAuth account with its current status
+message OAuthAccount {
+  // ID of the token
+  string id = 1 [(.wix.api.immutable) = true, (.wix.api.format) = GUID];
+  
+  // OAuth account identifier (email, username, etc.)
+  string oauth_account_id = 2 [(.wix.api.pii) = true, (.wix.api.maxLength) = 255];
+  
+  // OAuth provider
+  OAuthProvider provider = 3;
+  
+  // Token status
+  TokenStatus token_status = 4;
+  
+  // When the token was created
+  google.protobuf.Timestamp created_date = 5;
+  
+  // When the token was last refreshed
+  google.protobuf.Timestamp last_refreshed = 6;
+  
+  // When the last failure occurred (if any)
+  google.protobuf.Timestamp last_failure_date = 7;
+  
+  // Reason for the last failure (if any)
+  string last_failure_reason = 8 [(.wix.api.maxLength) = 2000];
+}
+
+service OAuthService {
+  option (.wix.api.service_entity).message = "wix.hub.v1.OAuthConnection";
+  option (.wix.api.service_maturity) = BETA;
+  option (wix.api.service_exposure) = INTERNAL;
+
+  // Initiates OAuth2 flow for the specified provider
+  rpc InitiateOAuth (InitiateOAuthRequest) returns (InitiateOAuthResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_PROCESS";
+    option (.google.api.http) = {
+      post: "/v1/jobs/oauth/initiate"
+    };
+  }
+  
+  // Completes OAuth2 flow with authorization code
+  rpc CompleteOAuth (CompleteOAuthRequest) returns (CompleteOAuthResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_PROCESS";
+    option (.google.api.http) = {
+      post: "/v1/jobs/oauth/complete"
+    };
+  }
+  
+  // Completes OAuth2 flow with authorization code and returns HTML response
+  rpc CompleteOAuthHttp (CompleteOAuthHttpRequest) returns (com.wixpress.rest.RawHttpResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_PROCESS";
+    option (.google.api.http) = {
+      get: "/v1/jobs/oauth/complete/http"
+    };
+  }
+  
+  // Gets current OAuth status
+  rpc GetOAuthStatus (GetOAuthStatusRequest) returns (GetOAuthStatusResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_STATUS";
+    option (.google.api.http) = {
+      get: "/v1/jobs/oauth/status"
+    };
+  }
+  
+  // Revokes OAuth token
+  rpc RevokeOAuth (RevokeOAuthRequest) returns (RevokeOAuthResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_REVOKE";
+    option (.google.api.http) = {
+      post: "/v1/jobs/oauth/revoke"
+    };
+  }
+  
+  // Lists all OAuth accounts for the current user and provider
+  rpc ListOAuthAccounts (ListOAuthAccountsRequest) returns (ListOAuthAccountsResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_STATUS";
+    option (.google.api.http) = {
+      get: "/v1/jobs/oauth/accounts"
+    };
+  }
+
+  // Gets OAuth access token for the specified provider
+  rpc GetOAuthAccessToken (GetOAuthAccessTokenRequest) returns (GetOAuthAccessTokenResponse) {
+    option (.wix.api.maturity) = BETA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_DATA.DATA_JOB_OAUTH_STATUS";
+    option (.google.api.http) = {
+      get: "/v1/jobs/oauth/token"
+    };
+  }
+}
+
+message InitiateOAuthRequest {
+  // OAuth provider
+  OAuthProvider provider = 1;
+  // Redirect URI to be used in the OAuth flow
+  string redirect_uri = 2 [(.wix.api.format) = WEB_URL];
+  // Optional: SDL entity ID of existing OAuth token for re-authorization
+  google.protobuf.StringValue oauth_token_id = 3 [(.wix.api.format) = GUID];
+}
+
+message InitiateOAuthResponse {
+  // URL to redirect the user to for authorization
+  string authorization_url = 1 [(.wix.api.format) = WEB_URL];
+  // State parameter to be used in the OAuth flow
+  string state = 2 [(.wix.api.maxLength) = 512];
+  // SDL entity ID of the OAuth token (for storage and future use)
+  string oauth_token_id = 3 [(.wix.api.format) = GUID];
+}
+
+message CompleteOAuthRequest {
+  // Authorization code received from the OAuth provider
+  string code = 1 [(.wix.api.maxLength) = 512];
+  // State parameter received from the OAuth provider
+  string state = 2 [(.wix.api.maxLength) = 512];
+}
+
+message CompleteOAuthResponse {
+  // Indicates if the operation was successful
+  bool success = 1;
+  // OAuth entity ID of the created/updated token
+  string oauth_id = 2 [(.wix.api.format) = GUID];
+  // OAuth account identifier (email, username, etc.)
+  string oauth_account_id = 3 [(.wix.api.pii) = true, (.wix.api.maxLength) = 255];
+}
+
+message CompleteOAuthHttpRequest {
+  // Authorization code received from the OAuth provider
+  string code = 1 [(.wix.api.maxLength) = 512];
+  // State parameter received from the OAuth provider
+  string state = 2 [(.wix.api.maxLength) = 512];
+}
+
+message GetOAuthStatusRequest {
+  OAuthProvider provider = 1;
+}
+
+message GetOAuthStatusResponse {
+  bool authorized = 1;
+  google.protobuf.Timestamp last_refreshed = 2;
+}
+
+message RevokeOAuthRequest {
+  OAuthProvider provider = 1;
+}
+
+message RevokeOAuthResponse {
+  bool success = 1;
+}
+
+message ListOAuthAccountsRequest {
+  OAuthProvider provider = 1;
+}
+
+message ListOAuthAccountsResponse {
+  repeated OAuthAccount accounts = 1;
+}
+
+message GetOAuthAccessTokenRequest {
+  OAuthProvider provider = 1;
+}
+
+message GetOAuthAccessTokenResponse {
+  // OAuth token ID
+  string token_id = 1 [(.wix.api.format) = GUID];
+  // OAuth access token (decrypted)
+  string oauth_access_token = 2 [(.wix.api.pii) = true, (.wix.api.maxLength) = 2048];
+}
+

package/@wix/ambassador-hub-v1-job/src/main/proto/wix/hub/v1/schema.proto

@@ -0,0 +1,48 @@
+syntax = "proto3";
+
+package wix.hub.v1;
+option java_package = "com.wixpress.hub.v1";
+
+import "wix/api/validations.proto";
+
+// NOTE this is used in executor types
+
+// Schema used to specify item format.
+message Schema {
+  // Item fields to move to the destination file.
+  repeated Field fields = 2 [(wix.api.maxSize) = 1000];
+}
+
+message Field {
+  enum FieldType {
+    ANY = 0; // Any data type.
+    STRING = 1; // String.
+    NUMBER = 2; // Number.
+    BOOLEAN = 3; // Boolean.
+    DATE = 4; // Date string in ISO 8601 date format: `YYYY-MM-DD`. 
+    DATETIME = 5; // [Date object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) (SDK) or an object in the following format: `"someFieldKey": { "$date": "YYYY-MM-DDTHH:mm:ss.sssZ"}`.
+    BINARY = 6; // Binary file.
+    OBJECT = 7; // object.
+    ARRAY = 8; // Array.
+    URL = 9; // Web URL.
+    WIX_MEDIA_URL = 10; 
+    WIX_MEDIA_IMAGE_URL = 11;
+    WIX_MEDIA_VIDEO_URL = 12; 
+    WIX_MEDIA_DOCUMENT_URL = 13;
+    IMAGE_URL = 14;
+    VIDEO_URL = 15;
+  }
+
+  // Field ID.
+  //  
+  // If the field type is `Array`, specify the item index. If the field type is `Object`, specify the field path. Use dot notation to specify nested fields, for example: `data.address.city`.
+  string key = 1 [(wix.api.maxLength) = 1024];
+  // Field display name. 
+  //
+  // When moving items to CSV files, use this to set the header of the target column.
+  string display_name = 2 [(wix.api.maxLength) = 1024];
+  // Field data type. Default: `ANY`.
+  //
+  // Learn more about [data types in Wix Data](https://dev.wix.com/docs/rest/business-solutions/cms/data-types-in-wix-data). 
+  FieldType field_type = 3;
+}

package/@wix/ambassador-hub-v1-job/src/main/proto/wix/hub/v1/shared.proto

@@ -0,0 +1,98 @@
+syntax = "proto3";
+
+package wix.hub.v1;
+
+option java_package = "com.wixpress.hub.v1";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+
+import "wix/api/validations.proto";
+import "wix/api/errors.proto";
+import 'wix/hub/v1/job.proto';
+import 'wix/hub/v1/common.proto';
+import 'wix/hub/v1/sources.proto';
+import 'wix/hub/v1/destinations.proto';
+import 'wix/hub/v1/transformations.proto';
+import "wix/common/data/dataextensions/extended-fields.proto";
+
+// Note: These messages are used by https://github.com/wix-private/wix-data-hub/tree/master/packages/wix-data-hub-executor-c
+// and by its GRPC API https://github.com/wix-private/wix-data-hub/tree/master/packages/wix-data-hub-executor-api
+// especially SubmitJobRequest which is sent to executor as JSON
+
+message SubmitJobRequest {
+  // Source to move data from.
+  Source source = 1;
+
+  // Destination to move data to.
+  Destination destination = 2;
+
+  // Transformations to apply to the data before moving to the destination.
+  repeated Transformation transformations = 3 [(wix.api.maxSize) = 32, (wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+  // Job name.
+  string name = 4;
+
+  // Allows moving data between sites. When used, this is an account-level API. 
+
+  oneof site_override {
+  // When moving data from the Wix data collection of a site other than the current one, the source site ID. 
+  //
+  // By default, the source site is the current site. However, you can move data from any site in the same [Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account).
+  //
+  // > **Note**: You can specify the ID of another source site or destination site, but not both.
+  string source_site_id = 5 [(wix.api.format) = GUID];
+ 
+  // When moving data to the Wix data collection of a site other than the current one, the destination site ID. 
+  // 
+  // By default, the destination site is the current site. However, you can move data to any site in the same [Wix Account](https://support.wix.com/en/article/managing-multiple-sites-under-one-account) by specifying its ID. You can retrieve this ID by calling [Get App Instance](https://dev.wix.com/docs/rest/app-management/app-instance/get-app-instance).
+  //
+  // > **Note**: You can specify the ID of another source site or destination site, but not both. 
+  string destination_site_id = 6 [(wix.api.format) = GUID];
+  }
+
+  // Sync Schedule ID, if the job was triggered by a sync schedule.
+  google.protobuf.StringValue schedule_id = 7 [(wix.api.format) = GUID, (wix.api.field_exposure) = PRIVATE];
+
+  // Workflow ID, if the job was triggered as a workflow child step.
+  google.protobuf.StringValue workflow_id = 8 [(wix.api.format) = GUID, (wix.api.field_exposure) = PRIVATE];
+}
+
+
+message JobCallback {
+  // ID of the job that triggered this callback.
+  string job_id = 1 [(wix.api.format) = GUID];
+
+  // Job status.
+  JobStatus status = 2;
+
+  oneof options {
+    option (.wix.api.aligned_with_enum).field = "status";
+    // Options for the callback's `IN_PROGRESS` stage.
+    InProgressOptions in_progress_options = 3;
+    // Options for the callback's `FAILED` stage.
+    FailedOptions failed_options = 4;
+    // Options for the callback's `PARTIALLY_SUCCESSFUL` stage.
+    PartiallySuccessfulOptions partially_successful_options = 5;
+  }
+
+  // Additional data to be merged into the job entity's extended_fields.
+  wix.common.data.dataextensions.ExtendedFields additional_data = 6;
+
+  message InProgressOptions {
+    // When the job status is `IN_PROGRESS`, the job progress information. 
+    Progress progress = 1;
+    // Job movement log. Includes information about failed items or items that succeeded with notes.
+    repeated MovementLog log = 2 [(wix.api.maxSize) = 1024];
+  }
+
+  message FailedOptions {
+    // Details of the failure.
+    wix.api.ApplicationError error = 2;
+  }
+
+  message PartiallySuccessfulOptions {
+    // Why the job was partially successful.
+    string cause = 1 [(wix.api.maxLength) = 1000];
+  }
+}

package/@wix/ambassador-hub-v1-job/src/main/proto/wix/hub/v1/sources.proto

@@ -0,0 +1,234 @@
+syntax = "proto3";
+
+package wix.hub.v1;
+option java_package = "com.wixpress.hub.v1";
+
+import 'wix/hub/v1/common.proto';
+import "google/protobuf/wrappers.proto";
+import "google/protobuf/struct.proto";
+import "wix/api/validations.proto";
+import "wix/api/annotations.proto";
+import "com/wixpress/cloud/data/api/data/message/aggregate-pipeline.proto";
+import "wix/hub/v1/schema.proto";
+
+message Source {
+  oneof source {
+    // Wix data collection. 
+    //
+    // You can move items from native Wix collections, [Wix app collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code), and [external database collections](https://dev.wix.com/docs/develop-websites/articles/databases/external-databases/overview/integrating-external-databases-with-your-wix-site).
+    WixDataSource wix_data_collection = 101;
+
+    // Localized CMS content. Available when the site has [Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-an-overview) installed. 
+    //
+    // Learn more about working with [translated CMS content](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content).
+    LocalizationSource localization = 102;
+
+    // Source file.
+    // 
+    // You can import data from files in CSV or JSONL formats. Uploading a file with an invalid format causes the movement job to fail.
+    //
+    // To upload a file, call Create File Upload Url ([SDK](https://dev.wix.com/docs/sdk/backend-modules/data/movement-jobs/create-file-upload-url) | [REST](https://dev.wix.com/docs/rest/business-solutions/cms/data-movement-jobs/create-file-upload-url)) and use the `uploadUrl` from the response. For example:
+    //
+    // `curl --request PUT --upload-file "${path_to_file}" "${uploadUrl}"`
+    //
+    FileSource file = 105;
+
+    // Test source used for sources under development. When development is completed, a dedicated source must be added with a robust API.
+    TestSource test = 106 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+    // Job logs.
+    DataMovementJobLogs data_movement_logs = 107 [(wix.api.field_maturity) = NOT_IMPLEMENTED, (wix.api.field_exposure) = INTERNAL];
+
+    // File.
+    ExternalFileSource external_file = 108 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+    // Google Sheets source.
+    GoogleSheetsSource google_sheets = 109 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+    // Wix Media Manager source.
+    //
+    // You can use the Wix Media source to retrieve all media in a site, including download links. It can also be
+    // used to copy media to another site.
+    //
+    // It will traverse all media recursively starting with `sourceFolderId` or root folder if not supplied.
+    WixMediaSource wix_media = 110 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+    // Structure of Wix data collections (fields, permissions, etc.).
+    //
+    // Reads collection structure for the specified collection IDs.
+    WixDataCollectionDefinitionSource wix_data_collection_definition = 111 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+
+  }
+
+  message TestSource {
+    // Discriminator value for a particular test source.
+    string type = 1 [(wix.api.maxLength) = 512];
+    // Test source details.
+    google.protobuf.Struct details = 2;
+  }
+
+  message LocalizationSource {
+    // Translated CMS content in the specified languages. Content in these languages is exported to the destination, with the first specified language treated as the main one.
+    //
+    // Use two-letter language codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format. You can also specify a two-letter country code in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) format. 
+    //
+    // Learn more about [available languages in Wix Multilingual](https://support.wix.com/en/article/wix-multilingual-languages-available).
+    repeated string languages = 1 [(wix.api.format) = LANGUAGE_TAG, (wix.api.minSize) = 2, (wix.api.maxSize) = 64];
+  }
+
+  // Wix data collection.
+  message WixDataSource {
+    // ID of the data collection.
+    string collection_id = 1 [(wix.api.minLength) = 1, (wix.api.maxLength) = 256];
+    // [Collection environment](https://support.wix.com/en/article/cms-about-sandbox-and-live-collections-and-syncing) from which to move data. Default: `LIVE`.
+    WixDataEnvironment environment = 2 [(wix.api.field_exposure) = INTERNAL];
+    // Filter to apply to the items. Only items that pass the filter are moved.
+    //
+    // Learn more about building a query filter using [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
+    // Deprecated: Use `filter_query.filter` instead.
+    google.protobuf.Struct filter = 3 [
+      deprecated = true,
+      (.wix.api.field_deprecated) = {
+        replaced_by: "filter_query"
+        target_removal_date: "2027-01-01"
+      }
+    ];
+
+    // The data collections API doesn't limit this.
+    // flynt-disable missing-array-limits
+    // flynt-disable missing-string-validations
+
+    // Deprecated: Use `filter_query.fields` instead.
+    repeated string fields = 4 [
+      deprecated = true,
+      (.wix.api.field_deprecated) = {
+        replaced_by: "filter_query"
+        target_removal_date: "2027-01-01"
+      }
+    ];
+    // Grid App ID. Optional in the collection's LIVE environment.
+    google.protobuf.StringValue app_id = 5 [(wix.api.format) = GUID, (wix.api.field_exposure) = INTERNAL];
+
+    // Query to run on the collection. Either a filter with optional field selection, or an aggregation pipeline.
+    oneof query {
+      // Filter and field selection to apply to the collection items.
+      FilterQuery filter_query = 6;
+
+      // Aggregation pipeline to run on the collection.
+      AggregationQuery aggregation_query = 7;
+    }
+
+    // Filter and field selection query.
+    message FilterQuery {
+      // Filter to apply to the items. Only items that pass the filter are moved.
+      //
+      // Learn more about building a query filter using [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
+      google.protobuf.Struct filter = 1;
+
+      // The data collections API doesn't limit this.
+      // flynt-disable missing-array-limits
+      // flynt-disable missing-string-validations
+
+      // Item fields to move. If not set, the method moves the full items.
+      repeated string fields = 2;
+    }
+
+    message AggregationQuery {
+      // Aggregation pipeline to run on the collection.
+      com.wixpress.cloud.data.api.data.AggregatePipelineDataItemsRequest.AggregationPipeline aggregation_pipeline = 1;
+
+      // Fields, will be used to map aggregation pipeline result to export result.
+      // Fields in the aggregation pipeline results that are not in the provided list will be ignored.
+      // If no fields provided, data will be exported as is, without transformation or field name mapping.
+      repeated Field fields = 2 [
+        (wix.api.minSize) = 0,
+        (wix.api.maxSize) = 1000
+      ];
+    }
+  }
+
+  // File.
+  message ExternalFileSource {
+    // File format. If not specified, automatically determined by Wix.
+    FileFormat format = 1;
+    // URL where the source file is located.
+    string url = 101 [(wix.api.maxLength) = 2048, (wix.api.format) = WEB_URL];
+  }
+
+  // File.
+  //
+  // To create a file upload URL, call the Create File Upload Url method and use the `uploadURL` in the response to upload the source file.
+  message FileSource {
+    // File format. If not specified, automatically determined by Wix.
+    FileFormat format = 1;
+    // File ID as returned in the `fileId` property of the Create File Upload URL method's response.
+    string file_id = 2 [(wix.api.maxLength) = 512];
+    // URL where the source file is uploaded. Automatically generated by Wix.
+    string url = 101 [(wix.api.readOnly) = true, (wix.api.maxLength) = 2048];
+  }
+
+  // Job logs.
+  message DataMovementJobLogs {
+    // ID of the job from which to export logs.
+    string job_id = 1 [(wix.api.format) = GUID];
+  }
+  
+  reserved 103; // GoogleDriveSource google_drive = 103;
+  reserved 104; // HttpFileSource http = 104;
+
+  // Google Sheets source.
+  message GoogleSheetsSource {
+    // ID of the Google Sheets spreadsheet.
+    string spreadsheet_id = 1 [(wix.api.minLength) = 1, (wix.api.maxLength) = 256];
+
+    // Name of the sheet within the spreadsheet.
+    google.protobuf.StringValue sheet_name = 2 [(wix.api.maxLength) = 256];
+
+    // Range of cells within the sheet.
+    google.protobuf.StringValue range = 3 [(wix.api.maxLength) = 256];
+
+    // Entity ID of the saved OAuth token.
+    string oauth_token_id = 4 [(wix.api.format) = GUID];
+    
+    // OAuth2 access token for authenticated access
+    // 
+    // This field is SERVER-MANAGED ONLY
+    // - Client-provided values are IGNORED for security reasons
+    // - Server refreshes token using stored refresh_token on job submission
+    google.protobuf.StringValue access_token = 5 [
+      (wix.api.field_exposure) = INTERNAL,
+      (wix.api.field_maturity) = ALPHA,
+      (wix.api.maxLength) = 8192
+    ];
+  }
+
+  // Exports collection structure (fields, permissions, etc.) from a site.
+  message WixDataCollectionDefinitionSource {
+    // IDs of collections whose definitions to read.
+    repeated string collection_ids = 1 [(wix.api.minSize) = 1, (wix.api.maxSize) = 1000, (wix.api.maxLength) = 256];
+  }
+
+  // Wix Media Manager source.
+  message WixMediaSource {
+    reserved 1;
+    // ID of the source folder in the Media Manager. If not specified, all media items are included.
+    google.protobuf.StringValue source_folder_id = 3 [(wix.api.maxLength) = 256];
+
+    // Type of media to include. Default: all media types.
+    // Not currently supported.
+    MediaType media_type = 2 [(wix.api.field_exposure) = INTERNAL];
+
+    enum MediaType {
+      // All media types.
+      ALL = 0;
+      // Images.
+      IMAGE = 1;
+      // Videos.
+      VIDEO = 2;
+      // Audio files.
+      AUDIO = 3;
+      // Documents.
+      DOCUMENT = 4;
+    }
+  }
+}

package/@wix/ambassador-hub-v1-job/src/main/proto/wix/hub/v1/transformations.proto

@@ -0,0 +1,23 @@
+syntax = "proto3";
+
+package wix.hub.v1;
+option java_package = "com.wixpress.hub.v1";
+
+import "google/protobuf/struct.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+
+message Transformation {
+  oneof transformation {
+    // Test transformation used for transformation under development.
+    // Once development is completed, a dedicated transformation must be added with a well-defined API.
+    TestTransformation test = 1 [(wix.api.field_exposure) = INTERNAL, (wix.api.field_maturity) = ALPHA];
+  }
+}
+
+message TestTransformation {
+  // Discriminator value for a particular test transformation.
+  string type = 1 [(wix.api.field_exposure) = INTERNAL, (wix.api.maxLength) = 512];
+  // Test transformation details.
+  google.protobuf.Struct details = 2 [(wix.api.field_exposure) = INTERNAL];
+}