@wix/crm 1.0.80 → 1.0.82

package/build/cjs/src/contacts-v4-extended-field.types.d.ts

@@ -3,7 +3,7 @@ export interface ExtendedField {
     /**
      * Extended field namespace.
      *
-     * Extended fields created by site contributors or 3rd-party apps
+     * Extended fields created by site collaborators or 3rd-party apps
      * are automatically assigned to the `custom` namespace.
      * @readonly
      */
@@ -255,6 +255,73 @@ export interface QueryExtendedFieldsResponse {
     /** Details on the paged set of results returned. */
     pagingMetadata?: PagingMetadata;
 }
+export interface DomainEvent extends DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+    /**
+     * Unique event ID.
+     * Allows clients to ignore duplicate webhooks.
+     */
+    id?: string;
+    /**
+     * Assumes actions are also always typed to an entity_type
+     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
+     */
+    entityFqdn?: string;
+    /**
+     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
+     * This is although the created/updated/deleted notion is duplication of the oneof types
+     * Example: created/updated/deleted/started/completed/email_opened
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp. */
+    eventTime?: Date;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number defining the order of updates to the underlying entity.
+     * For example, given that some entity was updated at 16:00 and than again at 16:01,
+     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
+     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
+     * To do so, you will need to persist this number on your end, and compare the sequence number from the
+     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     */
+    entityEventSequence?: string | null;
+}
+/** @oneof */
+export interface DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+}
+export interface EntityCreatedEvent {
+    entityAsJson?: string;
+}
+export interface EntityUpdatedEvent {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntityAsJson?: string;
+}
+export interface EntityDeletedEvent {
+    /** Entity that was deleted */
+    deletedEntityAsJson?: string | null;
+}
+export interface ActionEvent {
+    bodyAsJson?: string;
+}
 export interface FindOrCreateExtendedFieldResponseNonNullableFields {
     field?: {
         key: string;

package/build/cjs/src/contacts-v4-extended-field.types.js

@@ -8,16 +8,16 @@ var FieldDataType;
     FieldDataType["NUMBER"] = "NUMBER";
     FieldDataType["DATE"] = "DATE";
     FieldDataType["URL"] = "URL";
-})(FieldDataType = exports.FieldDataType || (exports.FieldDataType = {}));
+})(FieldDataType || (exports.FieldDataType = FieldDataType = {}));
 var FieldType;
 (function (FieldType) {
     FieldType["UNKNOWN"] = "UNKNOWN";
     FieldType["SYSTEM"] = "SYSTEM";
     FieldType["USER_DEFINED"] = "USER_DEFINED";
-})(FieldType = exports.FieldType || (exports.FieldType = {}));
+})(FieldType || (exports.FieldType = FieldType = {}));
 var SortOrder;
 (function (SortOrder) {
     SortOrder["ASC"] = "ASC";
     SortOrder["DESC"] = "DESC";
-})(SortOrder = exports.SortOrder || (exports.SortOrder = {}));
+})(SortOrder || (exports.SortOrder = SortOrder = {}));
 //# sourceMappingURL=contacts-v4-extended-field.types.js.map

package/build/cjs/src/contacts-v4-extended-field.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"contacts-v4-extended-field.types.js","sourceRoot":"","sources":["../../../src/contacts-v4-extended-field.types.ts"],"names":[],"mappings":";;;AA4DA,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,wDAAuC,CAAA;IACvC,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,4BAAW,CAAA;AACb,CAAC,EANW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAMxB;AAED,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,8BAAiB,CAAA;IACjB,0CAA6B,CAAA;AAC/B,CAAC,EAJW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAIpB;AA+BD,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAGpB"}
+{"version":3,"file":"contacts-v4-extended-field.types.js","sourceRoot":"","sources":["../../../src/contacts-v4-extended-field.types.ts"],"names":[],"mappings":";;;AA4DA,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,wDAAuC,CAAA;IACvC,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,4BAAW,CAAA;AACb,CAAC,EANW,aAAa,6BAAb,aAAa,QAMxB;AAED,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,8BAAiB,CAAA;IACjB,0CAA6B,CAAA;AAC/B,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB;AA+BD,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,yBAAT,SAAS,QAGpB"}

package/build/cjs/src/contacts-v4-extended-field.universal.d.ts

@@ -1,15 +1,10 @@
-export declare const __debug: {
-    verboseLogging: {
-        on: () => boolean;
-        off: () => boolean;
-    };
-};
+import { EventDefinition } from '@wix/sdk-types';
 /** Extended field that was found or created. */
 export interface ExtendedField {
     /**
      * Extended field namespace.
      *
-     * Extended fields created by site contributors or 3rd-party apps
+     * Extended fields created by site collaborators or 3rd-party apps
      * are automatically assigned to the `custom` namespace.
      * @readonly
      */
@@ -44,8 +39,8 @@ export interface ExtendedField {
      * Indicates whether the extended field is a system field or custom field.
      *
      * One of:
-     * - `"SYSTEM"`: The field is a system field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors.
-     * - `"USER_DEFINED"`: The field is a custom field and can be modified by 3rd-party apps or site contributors.
+     * - `"SYSTEM"`: System field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors.
+     * - `"USER_DEFINED"`: Custom field that can be modified by 3rd-party apps or site admins.
      * @readonly
      */
     fieldType?: FieldType;
@@ -263,6 +258,81 @@ export interface QueryExtendedFieldsResponse {
     /** Details on the paged set of results returned. */
     pagingMetadata?: PagingMetadata;
 }
+export interface DomainEvent<T = string> extends DomainEventBodyOneOf<T> {
+    createdEvent?: EntityCreatedEvent<T>;
+    updatedEvent?: EntityUpdatedEvent<T>;
+    deletedEvent?: EntityDeletedEvent<T>;
+    actionEvent?: ActionEvent<T>;
+    /**
+     * Unique event ID.
+     * Allows clients to ignore duplicate webhooks.
+     */
+    _id?: string;
+    /**
+     * Assumes actions are also always typed to an entity_type
+     * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
+     */
+    entityFqdn?: string;
+    /**
+     * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
+     * This is although the created/updated/deleted notion is duplication of the oneof types
+     * Example: created/updated/deleted/started/completed/email_opened
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp. */
+    eventTime?: Date;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number defining the order of updates to the underlying entity.
+     * For example, given that some entity was updated at 16:00 and than again at 16:01,
+     * it is guaranteed that the sequence number of the second update is strictly higher than the first.
+     * As the consumer, you can use this value to ensure that you handle messages in the correct order.
+     * To do so, you will need to persist this number on your end, and compare the sequence number from the
+     * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
+     */
+    entityEventSequence?: string | null;
+}
+export interface DomainCreatedEvent<T> extends Omit<DomainEvent<T>, 'deletedEvent' | 'updatedEvent' | 'actionEvent'> {
+}
+export interface DomainDeletedEvent<T> extends Omit<DomainEvent<T>, 'createdEvent' | 'updatedEvent' | 'actionEvent'> {
+}
+export interface DomainUpdatedEvent<T> extends Omit<DomainEvent<T>, 'createdEvent' | 'deletedEvent' | 'actionEvent'> {
+}
+export interface DomainActionEvent<T> extends Omit<DomainEvent<T>, 'createdEvent' | 'deletedEvent' | 'updatedEvent'> {
+}
+/** @oneof */
+export interface DomainEventBodyOneOf<T> {
+    createdEvent?: EntityCreatedEvent<T>;
+    updatedEvent?: EntityUpdatedEvent<T>;
+    deletedEvent?: EntityDeletedEvent<T>;
+    actionEvent?: ActionEvent<T>;
+}
+export interface EntityCreatedEvent<T> {
+    entity?: T;
+}
+export interface EntityUpdatedEvent<T> {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntity?: T;
+}
+export interface EntityDeletedEvent<T> {
+    /** Entity that was deleted */
+    deletedEntity?: T | null;
+}
+export interface ActionEvent<T> {
+    body?: T;
+}
 export interface FindOrCreateExtendedFieldResponseNonNullableFields {
     field?: {
         key: string;
@@ -296,6 +366,9 @@ export interface QueryExtendedFieldsResponseNonNullableFields {
         fieldType: FieldType;
     }[];
 }
+export declare const onExtendedFieldCreated: EventDefinition<DomainCreatedEvent<ExtendedField>, "wix.contacts.v4.extended_field_created">;
+export declare const onExtendedFieldUpdated: EventDefinition<DomainUpdatedEvent<ExtendedField>, "wix.contacts.v4.extended_field_updated">;
+export declare const onExtendedFieldDeleted: EventDefinition<DomainDeletedEvent<ExtendedField>, "wix.contacts.v4.extended_field_deleted">;
 /**
  * Retrieves a custom field with a given name, or creates one if it doesn't exist.
  *
@@ -303,9 +376,7 @@ export interface QueryExtendedFieldsResponseNonNullableFields {
  *
  * Successful calls to `findOrCreateExtendedField()` always return an extended field, which can be passed to subsequent function calls.
  *
- * To find an existing extended field without potentially creating a new one, use [`getExtendedField()`](#getextendedfield) or [`queryExtendedFields()`](#queryextendedfields).
- *
- * >**Note:** Only visitors with **Manage Contacts** permissions can find or create extended fields.
+ * To find an existing extended field without potentially creating a new one, use `getExtendedField()` or `queryExtendedFields()`.
  *
  * @param displayName - Display name to find or create.
  *
@@ -322,9 +393,13 @@ export interface QueryExtendedFieldsResponseNonNullableFields {
  * - `"DATE"`: Accepts dates formatted as `YYYY-MM-DD`.
  * - `"URL"`: Accepts strings. Prepends `https://` if no protocol is included.
  * @public
+ * @documentationMaturity preview
  * @requiredField dataType
  * @requiredField displayName
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns Extended field that was found or created.
  */
@@ -334,7 +409,6 @@ export declare function findOrCreateExtendedField(displayName: string, dataType:
  *
  * The `getExtendedField()` function returns a Promise that resolves when the extended field is retrieved.
  *
- * >**Note:** Only visitors with **Manage Contacts** permissions can retrieve extended fields.
  * @public
  * @documentationMaturity preview
  * @requiredField key
@@ -346,7 +420,12 @@ export declare function findOrCreateExtendedField(displayName: string, dataType:
  * the value can be accessed at `fields["custom.notes"]`.
  *
  * Once set, `key` cannot be modified, even if `displayName` changes.
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns The specified field.
  */
@@ -356,7 +435,6 @@ export declare function getExtendedField(key: string): Promise<ExtendedField & N
  *
  * The `renameExtendedField()` function returns a Promise that resolves when the specified extended field's display name is changed
  *
- * > **Note:** Only visitors with **Manage Contacts** permissions can rename extended fields.
  * @public
  * @documentationMaturity preview
  * @requiredField field
@@ -370,8 +448,11 @@ export declare function getExtendedField(key: string): Promise<ExtendedField & N
  * the value can be accessed at `fields["custom.notes"]`.
  *
  * Once set, `key` cannot be modified, even if `displayName` changes.
- * @param field - Extended field display name to rename.
+ * @param field - Extended field to rename.
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns Updated extended field.
  */
@@ -380,7 +461,7 @@ export interface RenameExtendedField {
     /**
      * Extended field namespace.
      *
-     * Extended fields created by site contributors or 3rd-party apps
+     * Extended fields created by site collaborators or 3rd-party apps
      * are automatically assigned to the `custom` namespace.
      * @readonly
      */
@@ -402,8 +483,8 @@ export interface RenameExtendedField {
      * Indicates whether the extended field is a system field or custom field.
      *
      * One of:
-     * - `"SYSTEM"`: The field is a system field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors.
-     * - `"USER_DEFINED"`: The field is a custom field and can be modified by 3rd-party apps or site contributors.
+     * - `"SYSTEM"`: System field managed by Wix. System fields cannot be modified by 3rd-party apps or site contributors.
+     * - `"USER_DEFINED"`: Custom field that can be modified by 3rd-party apps or site admins.
      * @readonly
      */
     fieldType?: FieldType;
@@ -430,42 +511,47 @@ export interface RenameExtendedField {
  *
  * When an extended field is deleted, any contact data stored in the field is permanently deleted as well.
  *
- * >**Note:** Only visitors with **Manage Contacts** permissions can delete extended fields.
  * @param key - Extended field key.
  * @public
  * @documentationMaturity preview
  * @requiredField key
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  */
 export declare function deleteExtendedField(key: string): Promise<void>;
 /**
  * Creates a query to retrieve a list of extended fields.
  *
- * The `queryExtendedFields()` function builds a query to retrieve a list of extended fields and returns an [`FieldsQueryBuilder`](#fieldsquerybuilder) object.
+ * The `queryExtendedFields()` function builds a query to retrieve a list of extended fields and returns an `FieldsQueryBuilder` object.
  *
- * The returned object contains the query definition, which is used to run the query using the [`find()`](#fieldsquerybuilder/find) function.
+ * The returned object contains the query definition, which is used to run the query using the `find()` function.
  *
  * You can refine the query by chaining `FieldsQueryBuilder` functions onto the query. `FieldsQueryBuilder` functions enable you to filter, sort, and control the results that `queryExtendedFields()` returns.
  *
  * `queryExtendedFields()` runs with these `FieldsQueryBuilder` defaults, which you can override:
- * - [`skip()`](#fieldsquerybuilder/skip)
- * - [`limit(50)`](#fieldsquerybuilder/limit)
- * - [`descending('_createdDate')`](#fieldsquerybuilder/descending)
- *
- * > **Note:** Only visitors with **Manage Contacts** permissions can query extended fields.
+ * - `skip()`
+ * - `limit(50)`
+ * - `descending('_createdDate')`
  *
- * The following `FieldsQueryBuilder` functions are supported for `queryExtendedFields()`. For a full description of the `Extended Field` object, see the object returned for the [`items`](#fieldsqueryresult/items) property in [`FieldsQueryResult`](#fieldsqueryresult).
+ * The following `FieldsQueryBuilder` functions are supported for `queryExtendedFields()`. For a full description of the `Extended Field` object, see the object returned for the `items` property in `FieldsQueryResult`.
  * @public
  * @documentationMaturity preview
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  */
 export declare function queryExtendedFields(): FieldsQueryBuilder;
 interface QueryOffsetResult {
-    currentPage: number;
-    totalPages: number;
-    totalCount: number;
+    currentPage: number | undefined;
+    totalPages: number | undefined;
+    totalCount: number | undefined;
     hasNext: () => boolean;
     hasPrev: () => boolean;
     length: number;

package/build/cjs/src/contacts-v4-extended-field.universal.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -28,24 +32,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryExtendedFields = exports.deleteExtendedField = exports.renameExtendedField = exports.getExtendedField = exports.findOrCreateExtendedField = exports.SortOrder = exports.FieldType = exports.FieldDataType = exports.__debug = void 0;
+exports.queryExtendedFields = exports.deleteExtendedField = exports.renameExtendedField = exports.getExtendedField = exports.findOrCreateExtendedField = exports.onExtendedFieldDeleted = exports.onExtendedFieldUpdated = exports.onExtendedFieldCreated = exports.SortOrder = exports.FieldType = exports.FieldDataType = void 0;
 const velo_1 = require("@wix/metro-runtime/velo");
+const transform_error_1 = require("@wix/sdk-runtime/transform-error");
+const sdk_types_1 = require("@wix/sdk-types");
 const ambassadorWixContactsV4ExtendedField = __importStar(require("./contacts-v4-extended-field.http"));
 // @ts-ignore
 const motion_edm_autogen_query_wrapper_1 = require("@wix/motion-edm-autogen-query-wrapper");
-let __verbose = false;
-function __log(...args) {
-    __verbose && console.log(...args);
-}
-function __inspect(obj) {
-    return obj;
-}
-exports.__debug = {
-    verboseLogging: {
-        on: () => (__verbose = true),
-        off: () => (__verbose = false),
-    },
-};
 const _toVeloEntity = '$';
 const _fromVeloEntity = '$';
 var FieldDataType;
@@ -55,18 +48,18 @@ var FieldDataType;
     FieldDataType["NUMBER"] = "NUMBER";
     FieldDataType["DATE"] = "DATE";
     FieldDataType["URL"] = "URL";
-})(FieldDataType = exports.FieldDataType || (exports.FieldDataType = {}));
+})(FieldDataType || (exports.FieldDataType = FieldDataType = {}));
 var FieldType;
 (function (FieldType) {
     FieldType["UNKNOWN"] = "UNKNOWN";
     FieldType["SYSTEM"] = "SYSTEM";
     FieldType["USER_DEFINED"] = "USER_DEFINED";
-})(FieldType = exports.FieldType || (exports.FieldType = {}));
+})(FieldType || (exports.FieldType = FieldType = {}));
 var SortOrder;
 (function (SortOrder) {
     SortOrder["ASC"] = "ASC";
     SortOrder["DESC"] = "DESC";
-})(SortOrder = exports.SortOrder || (exports.SortOrder = {}));
+})(SortOrder || (exports.SortOrder = SortOrder = {}));
 const _deleteExtendedFieldRequest = {};
 const _deleteExtendedFieldResponse = {};
 const _findOrCreateExtendedFieldRequest = {};
@@ -77,6 +70,9 @@ const _queryExtendedFieldsRequest = {};
 const _queryExtendedFieldsResponse = {};
 const _updateExtendedFieldRequest = {};
 const _updateExtendedFieldResponse = {};
+exports.onExtendedFieldCreated = (0, sdk_types_1.EventDefinition)('wix.contacts.v4.extended_field_created')();
+exports.onExtendedFieldUpdated = (0, sdk_types_1.EventDefinition)('wix.contacts.v4.extended_field_updated')();
+exports.onExtendedFieldDeleted = (0, sdk_types_1.EventDefinition)('wix.contacts.v4.extended_field_deleted')();
 /**
  * Retrieves a custom field with a given name, or creates one if it doesn't exist.
  *
@@ -84,9 +80,7 @@ const _updateExtendedFieldResponse = {};
  *
  * Successful calls to `findOrCreateExtendedField()` always return an extended field, which can be passed to subsequent function calls.
  *
- * To find an existing extended field without potentially creating a new one, use [`getExtendedField()`](#getextendedfield) or [`queryExtendedFields()`](#queryextendedfields).
- *
- * >**Note:** Only visitors with **Manage Contacts** permissions can find or create extended fields.
+ * To find an existing extended field without potentially creating a new one, use `getExtendedField()` or `queryExtendedFields()`.
  *
  * @param displayName - Display name to find or create.
  *
@@ -103,9 +97,13 @@ const _updateExtendedFieldResponse = {};
  * - `"DATE"`: Accepts dates formatted as `YYYY-MM-DD`.
  * - `"URL"`: Accepts strings. Prepends `https://` if no protocol is included.
  * @public
+ * @documentationMaturity preview
  * @requiredField dataType
  * @requiredField displayName
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns Extended field that was found or created.
  */
@@ -136,7 +134,6 @@ function findOrCreateExtendedField(displayName, dataType) {
         });
         const payload = toAmbassadorRequest([displayName, dataType]);
         const reqOpts = ambassadorWixContactsV4ExtendedField.findOrCreateExtendedField(payload);
-        __log(`"FindOrCreateExtendedField" sending request with: ${__inspect(reqOpts)}`);
         (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
         try {
             const result = yield httpClient.request(reqOpts);
@@ -144,10 +141,11 @@ function findOrCreateExtendedField(displayName, dataType) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'displayName',
-                'dataType',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { displayName: '$[0]', dataType: '$[1]' },
+                singleArgumentUnchanged: false,
+            }, ['displayName', 'dataType']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -159,7 +157,6 @@ exports.findOrCreateExtendedField = findOrCreateExtendedField;
  *
  * The `getExtendedField()` function returns a Promise that resolves when the extended field is retrieved.
  *
- * >**Note:** Only visitors with **Manage Contacts** permissions can retrieve extended fields.
  * @public
  * @documentationMaturity preview
  * @requiredField key
@@ -171,7 +168,12 @@ exports.findOrCreateExtendedField = findOrCreateExtendedField;
  * the value can be accessed at `fields["custom.notes"]`.
  *
  * Once set, `key` cannot be modified, even if `displayName` changes.
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns The specified field.
  */
@@ -202,7 +204,6 @@ function getExtendedField(key) {
         });
         const payload = toAmbassadorRequest([key]);
         const reqOpts = ambassadorWixContactsV4ExtendedField.getExtendedField(payload);
-        __log(`"GetExtendedField" sending request with: ${__inspect(reqOpts)}`);
         (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
         try {
             const result = yield httpClient.request(reqOpts);
@@ -210,9 +211,11 @@ function getExtendedField(key) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'key',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { key: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['key']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -224,7 +227,6 @@ exports.getExtendedField = getExtendedField;
  *
  * The `renameExtendedField()` function returns a Promise that resolves when the specified extended field's display name is changed
  *
- * > **Note:** Only visitors with **Manage Contacts** permissions can rename extended fields.
  * @public
  * @documentationMaturity preview
  * @requiredField field
@@ -238,8 +240,11 @@ exports.getExtendedField = getExtendedField;
  * the value can be accessed at `fields["custom.notes"]`.
  *
  * Once set, `key` cannot be modified, even if `displayName` changes.
- * @param field - Extended field display name to rename.
+ * @param field - Extended field to rename.
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  * @returns Updated extended field.
  */
@@ -270,7 +275,6 @@ function renameExtendedField(key, field) {
         });
         const payload = toAmbassadorRequest([key, field]);
         const reqOpts = ambassadorWixContactsV4ExtendedField.updateExtendedField(payload);
-        __log(`"UpdateExtendedField" sending request with: ${__inspect(reqOpts)}`);
         (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
         try {
             const result = yield httpClient.request(reqOpts);
@@ -278,10 +282,11 @@ function renameExtendedField(key, field) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'key',
-                'field',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: { field: '$[1]' },
+                explicitPathsToArguments: { 'field.key': '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['key', 'field']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -295,12 +300,14 @@ exports.renameExtendedField = renameExtendedField;
  *
  * When an extended field is deleted, any contact data stored in the field is permanently deleted as well.
  *
- * >**Note:** Only visitors with **Manage Contacts** permissions can delete extended fields.
  * @param key - Extended field key.
  * @public
  * @documentationMaturity preview
  * @requiredField key
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  */
 function deleteExtendedField(key) {
@@ -330,16 +337,17 @@ function deleteExtendedField(key) {
         });
         const payload = toAmbassadorRequest([key]);
         const reqOpts = ambassadorWixContactsV4ExtendedField.deleteExtendedField(payload);
-        __log(`"DeleteExtendedField" sending request with: ${__inspect(reqOpts)}`);
         (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
         try {
             const result = yield httpClient.request(reqOpts);
             (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'key',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { key: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['key']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -349,23 +357,26 @@ exports.deleteExtendedField = deleteExtendedField;
 /**
  * Creates a query to retrieve a list of extended fields.
  *
- * The `queryExtendedFields()` function builds a query to retrieve a list of extended fields and returns an [`FieldsQueryBuilder`](#fieldsquerybuilder) object.
+ * The `queryExtendedFields()` function builds a query to retrieve a list of extended fields and returns an `FieldsQueryBuilder` object.
  *
- * The returned object contains the query definition, which is used to run the query using the [`find()`](#fieldsquerybuilder/find) function.
+ * The returned object contains the query definition, which is used to run the query using the `find()` function.
  *
  * You can refine the query by chaining `FieldsQueryBuilder` functions onto the query. `FieldsQueryBuilder` functions enable you to filter, sort, and control the results that `queryExtendedFields()` returns.
  *
  * `queryExtendedFields()` runs with these `FieldsQueryBuilder` defaults, which you can override:
- * - [`skip()`](#fieldsquerybuilder/skip)
- * - [`limit(50)`](#fieldsquerybuilder/limit)
- * - [`descending('_createdDate')`](#fieldsquerybuilder/descending)
- *
- * > **Note:** Only visitors with **Manage Contacts** permissions can query extended fields.
+ * - `skip()`
+ * - `limit(50)`
+ * - `descending('_createdDate')`
  *
- * The following `FieldsQueryBuilder` functions are supported for `queryExtendedFields()`. For a full description of the `Extended Field` object, see the object returned for the [`items`](#fieldsqueryresult/items) property in [`FieldsQueryResult`](#fieldsqueryresult).
+ * The following `FieldsQueryBuilder` functions are supported for `queryExtendedFields()`. For a full description of the `Extended Field` object, see the object returned for the `items` property in `FieldsQueryResult`.
  * @public
  * @documentationMaturity preview
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScopeId SCOPE.BOOKINGS.CONFIGURATION
  * @permissionScope Manage Contact Extended Fields
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-EX-FIELDS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
  * @applicableIdentity APP
  */
 function queryExtendedFields() {