@wix/wix-data-items-common 1.0.304 → 1.0.306

package/dist/esm/api/impl/BaseFieldModificationsBuilder.js

@@ -0,0 +1,87 @@
+import { AggregatingValidator, messages } from '../../errors';
+import { isNumber } from '../../utils';
+export class BaseFieldModificationsBuilder {
+    constructor(origin) {
+        this.ownInvalidArguments = origin.invalidArguments ?? [];
+        this.fieldModifications = origin.fieldModifications ?? [];
+    }
+    incrementField(fieldName, by) {
+        const [invalidArguments] = this.patchValidator('.incrementField')
+            .arityIsTwo(arguments)
+            .isNumber(fieldName, by)
+            .validateAndAggregate();
+        return this.copy({
+            invalidArguments,
+            addFieldModification: {
+                fieldPath: fieldName,
+                action: 'INCREMENT_FIELD',
+                value: by,
+            },
+        });
+    }
+    setField(fieldName, value) {
+        const [invalidArguments] = this.patchValidator('.setField')
+            .arityIsTwo(arguments)
+            .validateAndAggregate();
+        return this.copy({
+            invalidArguments,
+            addFieldModification: {
+                fieldPath: fieldName,
+                action: 'SET_FIELD',
+                value,
+            },
+        });
+    }
+    appendToArray(fieldName, value) {
+        const [invalidArguments] = this.patchValidator('.appendToArray')
+            .arityIsTwo(arguments)
+            .validateAndAggregate();
+        return this.copy({
+            invalidArguments,
+            addFieldModification: {
+                fieldPath: fieldName,
+                action: 'APPEND_TO_ARRAY',
+                value,
+            },
+        });
+    }
+    removeFromArray(fieldName, value) {
+        const [invalidArguments] = this.patchValidator('.removeFromArray')
+            .arityIsTwo(arguments)
+            .validateAndAggregate();
+        return this.copy({
+            invalidArguments,
+            addFieldModification: {
+                fieldPath: fieldName,
+                action: 'REMOVE_FROM_ARRAY',
+                value,
+            },
+        });
+    }
+    removeField(fieldName) {
+        const [invalidArguments] = this.patchValidator('.removeField')
+            .arityIsTwo(arguments)
+            .validateAndAggregate();
+        return this.copy({
+            invalidArguments,
+            addFieldModification: {
+                fieldPath: fieldName,
+                action: 'REMOVE_FIELD',
+            },
+        });
+    }
+    patchValidator(operatorName) {
+        return new FieldModificationsValidator(operatorName, this.ownInvalidArguments);
+    }
+}
+class FieldModificationsValidator extends AggregatingValidator {
+    constructor(operatorName, previousInvalidArguments) {
+        super(previousInvalidArguments);
+        this.operatorName = operatorName;
+        this.operatorName = operatorName;
+    }
+    isNumber(specifier, operand) {
+        return this.addValidation(() => isNumber(operand), () => messages.queryValidations.isNumber(this.operatorName, specifier, operand));
+    }
+}
+//# sourceMappingURL=BaseFieldModificationsBuilder.js.map

package/dist/esm/api/impl/BaseFieldModificationsBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseFieldModificationsBuilder.js","sourceRoot":"","sources":["../../../../src/api/impl/BaseFieldModificationsBuilder.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/impl/WixDataPatchImpl.js

@@ -1,89 +1,15 @@
-import { AggregatingValidator, messages } from '../../errors';
-import { isNumber } from '../../utils';
-class WixDataPatchBase {
-    constructor(origin) {
-        this.ownInvalidArguments = origin.invalidArguments ?? [];
-        this.fieldModifications = origin.fieldModifications ?? [];
-        this.collectionName = origin.collectionName;
-    }
-    incrementField(fieldName, by) {
-        const [invalidArguments] = this.patchValidator('.incrementField')
-            .arityIsTwo(arguments)
-            .isNumber(fieldName, by)
-            .validateAndAggregate();
-        return this.copy({
-            invalidArguments,
-            addFieldModification: {
-                fieldPath: fieldName,
-                action: 'INCREMENT_FIELD',
-                actionOptions: by,
-            },
-        });
-    }
-    setField(fieldName, value) {
-        const [invalidArguments] = this.patchValidator('.setField')
-            .arityIsTwo(arguments)
-            .validateAndAggregate();
-        return this.copy({
-            invalidArguments,
-            addFieldModification: {
-                fieldPath: fieldName,
-                action: 'SET_FIELD',
-                actionOptions: value,
-            },
-        });
-    }
-    appendToArray(fieldName, value) {
-        const [invalidArguments] = this.patchValidator('.appendToArray')
-            .arityIsTwo(arguments)
-            .validateAndAggregate();
-        return this.copy({
-            invalidArguments,
-            addFieldModification: {
-                fieldPath: fieldName,
-                action: 'APPEND_TO_ARRAY',
-                actionOptions: value,
-            },
-        });
-    }
-    removeFromArray(fieldName, value) {
-        const [invalidArguments] = this.patchValidator('.removeFromArray')
-            .arityIsTwo(arguments)
-            .validateAndAggregate();
-        return this.copy({
-            invalidArguments,
-            addFieldModification: {
-                fieldPath: fieldName,
-                action: 'REMOVE_FROM_ARRAY',
-                actionOptions: value,
-            },
-        });
-    }
-    removeField(fieldName) {
-        const [invalidArguments] = this.patchValidator('.removeField')
-            .arityIsTwo(arguments)
-            .validateAndAggregate();
-        return this.copy({
-            invalidArguments,
-            addFieldModification: {
-                fieldPath: fieldName,
-                action: 'REMOVE_FIELD',
-            },
-        });
-    }
-    patchValidator(operatorName) {
-        return new PatchValidator(operatorName, this.ownInvalidArguments);
-    }
-}
-export class WixDataBulkPatchImpl extends WixDataPatchBase {
+import { BaseFieldModificationsBuilder } from './BaseFieldModificationsBuilder';
+export class WixDataBulkPatchImpl extends BaseFieldModificationsBuilder {
     constructor(origin) {
         super(origin);
+        this.collectionName = origin.collectionName;
         this.onRun = origin.onRun;
         this.itemIds = origin.itemIds;
     }
     copy(params) {
         return new WixDataBulkPatchImpl({
             ...this,
+            collectionName: this.collectionName,
             invalidArguments: params.invalidArguments ?? this.ownInvalidArguments,
             fieldModifications: [
                 ...this.fieldModifications,
@@ -101,15 +27,17 @@ export class WixDataBulkPatchImpl extends WixDataPatchBase {
         }, options);
     }
 }
-export class WixDataPatchImpl extends WixDataPatchBase {
+export class WixDataPatchImpl extends BaseFieldModificationsBuilder {
     constructor(origin) {
         super(origin);
+        this.collectionName = origin.collectionName;
         this.onRun = origin.onRun;
         this.itemId = origin.itemId;
     }
     copy(params) {
         return new WixDataPatchImpl({
             ...this,
+            collectionName: this.collectionName,
             invalidArguments: params.invalidArguments ?? this.ownInvalidArguments,
             fieldModifications: [
                 ...this.fieldModifications,
@@ -127,15 +55,17 @@ export class WixDataPatchImpl extends WixDataPatchBase {
         }, options);
     }
 }
-export class WixDataPatchByFilterImpl extends WixDataPatchBase {
+export class WixDataPatchByFilterImpl extends BaseFieldModificationsBuilder {
     constructor(origin) {
         super(origin);
+        this.collectionName = origin.collectionName;
         this.onRun = origin.onRun;
         this.filter = origin.filter;
     }
     copy(params) {
         return new WixDataPatchByFilterImpl({
             ...this,
+            collectionName: this.collectionName,
             invalidArguments: params.invalidArguments ?? this.ownInvalidArguments,
             fieldModifications: [
                 ...this.fieldModifications,
@@ -153,14 +83,4 @@ export class WixDataPatchByFilterImpl extends WixDataPatchBase {
         }, options);
     }
 }
-class PatchValidator extends AggregatingValidator {
-    constructor(operatorName, previousInvalidArguments) {
-        super(previousInvalidArguments);
-        this.operatorName = operatorName;
-        this.operatorName = operatorName;
-    }
-    isNumber(specifier, operand) {
-        return this.addValidation(() => isNumber(operand), () => messages.queryValidations.isNumber(this.operatorName, specifier, operand));
-    }
-}
 //# sourceMappingURL=WixDataPatchImpl.js.map

package/dist/esm/api/impl/WixDataPatchImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"WixDataPatchImpl.js","sourceRoot":"","sources":["../../../../src/api/impl/WixDataPatchImpl.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WixDataPatchImpl.js","sourceRoot":"","sources":["../../../../src/api/impl/WixDataPatchImpl.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/index.js

@@ -1,6 +1,7 @@
 export { WixDataApi } from './WixDataApi';
 export { QueryValidator } from './QueryValidator';
 export { QueryBase } from './QueryBase';
+export { FieldModificationsBuilder, } from './WixDataFieldModificationsBuilder';
 export { stages, } from './stages/stages';
 export { pipelineBuilder } from './PipelineBuilder';
 export { QueryBuilder, Sort, Filter, } from './WixDataQueryBuilder';

package/dist/esm/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AA4CvC,OAAO,EACL,MAAM,GAGP,MAAM,iBAAiB,CAAA;AASxB,OAAO,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,MAAM,GAEP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EACL,WAAW,GAEZ,MAAM,2BAA2B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAYzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAgBvC,OAAO,EACL,yBAAyB,GAE1B,MAAM,oCAAoC,CAAA;AAsC3C,OAAO,EACL,MAAM,GAGP,MAAM,iBAAiB,CAAA;AASxB,OAAO,EAAmB,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACpE,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,MAAM,GAEP,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EACL,WAAW,GAEZ,MAAM,2BAA2B,CAAA"}

package/dist/esm/types/data-item-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-item-types.js","sourceRoot":"","sources":["../../../src/types/data-item-types.ts"],"names":[],"mappings":"AA8DA,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,kCAAmB,CAAA;IACnB,sDAAuC,CAAA;AACzC,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAwGD,MAAM,CAAN,IAAY,MAOX;AAPD,WAAY,MAAM;IAChB,2CAAiC,CAAA;IACjC,iCAAuB,CAAA;IACvB,uCAA6B,CAAA;IAC7B,6CAAmC,CAAA;IACnC,6CAAmC,CAAA;IACnC,iDAAuC,CAAA;AACzC,CAAC,EAPW,MAAM,KAAN,MAAM,QAOjB;AAgID,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,6DAA2C,CAAA;IAC3C,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,iCAAe,CAAA;AACjB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAsID,MAAM,CAAN,IAAY,MAIX;AAJD,WAAY,MAAM;IAChB,2CAAiC,CAAA;IACjC,+BAAqB,CAAA;IACrB,6BAAmB,CAAA;AACrB,CAAC,EAJW,MAAM,KAAN,MAAM,QAIjB;AA+SD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA6BD,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,0CAA0C;IAC1C,mDAAuC,CAAA;IACvC,+CAA+C;IAC/C,mCAAuB,CAAA;IACvB,+DAA+D;IAC/D,6BAAiB,CAAA;AACnB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAglBD,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,mDAAiC,CAAA;IACjC,6CAA2B,CAAA;IAC3B,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;AACnB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAicD,MAAM,CAAN,IAAY,IAKX;AALD,WAAY,IAAI;IACd,+CAA+C;IAC/C,iBAAS,CAAA;IACT,wCAAwC;IACxC,mBAAW,CAAA;AACb,CAAC,EALW,IAAI,KAAJ,IAAI,QAKf"}
+{"version":3,"file":"data-item-types.js","sourceRoot":"","sources":["../../../src/types/data-item-types.ts"],"names":[],"mappings":"AA8DA,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,kCAAmB,CAAA;IACnB,sDAAuC,CAAA;AACzC,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAwGD,MAAM,CAAN,IAAY,MAOX;AAPD,WAAY,MAAM;IAChB,2CAAiC,CAAA;IACjC,iCAAuB,CAAA;IACvB,uCAA6B,CAAA;IAC7B,6CAAmC,CAAA;IACnC,6CAAmC,CAAA;IACnC,iDAAuC,CAAA;AACzC,CAAC,EAPW,MAAM,KAAN,MAAM,QAOjB;AAgID,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,6DAA2C,CAAA;IAC3C,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,mCAAiB,CAAA;IACjB,iCAAe,CAAA;AACjB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAsID,MAAM,CAAN,IAAY,MAIX;AAJD,WAAY,MAAM;IAChB,2CAAiC,CAAA;IACjC,+BAAqB,CAAA;IACrB,6BAAmB,CAAA;AACrB,CAAC,EAJW,MAAM,KAAN,MAAM,QAIjB;AA+SD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA6BD,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,0CAA0C;IAC1C,mDAAuC,CAAA;IACvC,+CAA+C;IAC/C,mCAAuB,CAAA;IACvB,+DAA+D;IAC/D,6BAAiB,CAAA;AACnB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAglBD,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,mDAAiC,CAAA;IACjC,6CAA2B,CAAA;IAC3B,2CAAyB,CAAA;IACzB,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;AACnB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB;AAocD,MAAM,CAAN,IAAY,IAKX;AALD,WAAY,IAAI;IACd,+CAA+C;IAC/C,iBAAS,CAAA;IACT,wCAAwC;IACxC,mBAAW,CAAA;AACb,CAAC,EALW,IAAI,KAAJ,IAAI,QAKf"}

package/dist/types/api/FieldModification.d.ts

@@ -0,0 +1,41 @@
+export interface SetField {
+    /**
+     * Path of the field ID to be modified. Nested fields can be specified using dot notation.
+     */
+    fieldPath: string;
+    action: 'SET_FIELD';
+    value: any;
+}
+export interface RemoveField {
+    /**
+     * Path of the field ID to be modified. Nested fields can be specified using dot notation.
+     */
+    fieldPath: string;
+    action: 'REMOVE_FIELD';
+}
+export interface IncrementField {
+    /**
+     * Path of the field ID to be modified. Nested fields can be specified using dot notation.
+     */
+    fieldPath: string;
+    action: 'INCREMENT_FIELD';
+    value: any;
+}
+export interface AppendToArray {
+    /**
+     * Path of the field ID to be modified. Nested fields can be specified using dot notation.
+     */
+    fieldPath: string;
+    action: 'APPEND_TO_ARRAY';
+    value: any;
+}
+export interface RemoveFromArray {
+    /**
+     * Path of the field ID to be modified. Nested fields can be specified using dot notation.
+     */
+    fieldPath: string;
+    action: 'REMOVE_FROM_ARRAY';
+    value: any;
+}
+export type FieldModification = SetField | RemoveField | IncrementField | AppendToArray | RemoveFromArray;
+//# sourceMappingURL=FieldModification.d.ts.map

package/dist/types/api/FieldModification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldModification.d.ts","sourceRoot":"","sources":["../../../src/api/FieldModification.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,iBAAiB,CAAA;IACzB,KAAK,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,iBAAiB,CAAA;IACzB,KAAK,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,GAAG,CAAA;CACX;AAED,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,WAAW,GACX,cAAc,GACd,aAAa,GACb,eAAe,CAAA"}

package/dist/types/api/PagingMetadata.d.ts

@@ -0,0 +1,25 @@
+export interface PagingMetadata {
+    /** Number of items returned in the response. */
+    count?: number | null;
+    /** Offset that was requested. */
+    offset?: number | null;
+    /** Total number of items that match the query. Returned if offset paging is used, `returnTotalCount` is `true` in the request, and `tooManyToCount` is false. */
+    total?: number | null;
+    /** Whether the server failed to calculate the `total` field. */
+    tooManyToCount?: boolean | null;
+    /** Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used. */
+    cursors?: Cursors;
+    /**
+     * Indicates if there are more results after the current page.
+     * If `true`, another page of results can be retrieved.
+     * If `false`, this is the last page.
+     */
+    hasNext?: boolean | null;
+}
+export interface Cursors {
+    /** Cursor pointing to next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to previous page in the list of results. */
+    prev?: string | null;
+}
+//# sourceMappingURL=PagingMetadata.d.ts.map

package/dist/types/api/PagingMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagingMetadata.d.ts","sourceRoot":"","sources":["../../../src/api/PagingMetadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,iKAAiK;IACjK,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB"}

package/dist/types/api/WixDataAggregateResponse.d.ts

@@ -0,0 +1,8 @@
+import { PagingMetadata } from './PagingMetadata';
+export interface WixDataAggregateResponse<Result = Record<string, any>> {
+    /** Aggregated results. */
+    results: Result[];
+    /** Paging information. */
+    pagingMetadata: PagingMetadata;
+}
+//# sourceMappingURL=WixDataAggregateResponse.d.ts.map

package/dist/types/api/WixDataAggregateResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WixDataAggregateResponse.d.ts","sourceRoot":"","sources":["../../../src/api/WixDataAggregateResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACpE,0BAA0B;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IAEjB,0BAA0B;IAC1B,cAAc,EAAE,cAAc,CAAA;CAC/B"}

package/dist/types/api/WixDataApi.d.ts

@@ -1,15 +1,22 @@
 import { HttpApiClientFactory } from '../types';
 import * as apiTypes from '../types/data-item-types';
-import { Provider, WixDataAggregateOptions, WixDataBulkResult, WixDataItem, WixDataItemOrId, WixDataOptions, WixDataRemoveOptions, WixDataQueryReferencedOptions, WixDataCountOptions, WixDataReadOptions, WixDataReadWithProjectionOptions, WithIncludeFieldGroupsOption, WixDataReference, WixDataUpdateOptions, WixDataBulkUpdateOptions, WixDataSaveOptions, WixDataQueryRequest, WixDataDirectQueryOptions, WixDataDistinctOptions, WixDataSearchRequest, WixDataDirectSearchOptions, WixDataBulkInsertOptions, WixDataBulkSaveOptions, WixDataAsyncByFilterOptions, WixDataAsyncJob, WixDataAsyncJobStatus, WixDataFilterInput } from './types';
+import { Provider, WixDataAggregateOptions, WixDataBulkResult, WixDataItem, WixDataItemOrId, WixDataOptions, WixDataRemoveOptions, WixDataQueryReferencedOptions, WixDataQueryReferencedItemsOptions, WixDataCountOptions, WixDataReadOptions, WixDataReadWithProjectionOptions, WithIncludeFieldGroupsOption, WixDataReference, WixDataUpdateOptions, WixDataBulkUpdateOptions, WixDataSaveOptions, WixDataQueryRequest, WixDataDirectQueryOptions, WixDataDistinctOptions, WixDataSearchRequest, WixDataDirectSearchOptions, WixDataBulkInsertOptions, WixDataBulkSaveOptions, WixDataAsyncByFilterOptions, WixDataAsyncJob, WixDataAsyncJobStatus, WixDataFilterInput } from './types';
 import { WixDataQuery } from './WixDataQuery';
 import { WixDataResultImpl } from './impl/WixDataResultImpl';
-import { WixDataPatch, WixDataBulkPatch, WixDataPatchByFilter } from './WixDataPatch';
+import { WixDataPatch, WixDataBulkPatch, WixDataPatchByFilter, WixDataBulkPatchOptions, WixDataPatchOptions } from './WixDataPatch';
+import { WixDataQueryResponse } from './WixDataQueryResponse';
+import { WixDataSearchResponse } from './WixDataSearchResponse';
+import { WixDataAggregateResponse } from './WixDataAggregateResponse';
+import { WixDataDistinctResponse } from './WixDataDistinctResponse';
+import { WixDataQueryReferencedItemsResponse } from './WixDataQueryReferencedItemsResponse';
+import { FieldModification } from './FieldModification';
 import { WixDataAggregate } from './WixDataAggregate';
 import { WixDataFilter } from './WixDataFilter';
 import { WixDataResult } from './WixDataResult';
 import { WixDataSearch } from './WixDataSearch';
 type ProvidedOpt<T> = T | undefined | Provider<T | undefined>;
 type TraceWith = (label: string, opts?: object) => <T>(fn: () => Promise<T>) => Promise<T>;
+type QueryReferencedItems = <Item = WixDataItem>(collectionName: string, referringItem: WixDataItemOrId | WixDataItemOrId[], referringItemFieldName: string, options?: WixDataQueryReferencedItemsOptions) => Promise<WixDataQueryReferencedItemsResponse<Item>>;
 export declare class WixDataApi {
     private readonly environment?;
     private readonly gridAppId?;
@@ -25,8 +32,36 @@ export declare class WixDataApi {
     update: (collectionName: string, item: WixDataItem, options?: WixDataUpdateOptions | undefined) => Promise<WixDataItem>;
     remove: (collectionName: string, itemId: string, options?: WixDataRemoveOptions | undefined) => Promise<WixDataItem | null>;
     private toFieldModificationApi;
-    patch: (collectionName: string, itemId: string) => WixDataPatch;
-    bulkPatch: (collectionName: string, itemIds: string[]) => WixDataBulkPatch;
+    /**
+     * Returns a patch builder for the specified collection and item.
+     * @param collectionName - Name of the collection containing the item to patch.
+     * @param itemId - ID of the item to patch.
+     * @returns A `WixDataPatch` builder object.
+     */
+    patch(collectionName: string, itemId: string): WixDataPatch;
+    /**
+     * Executes a patch directly without using the builder pattern.
+     * @internal
+     * @param collectionName - Name of the collection containing the item to patch.
+     * @param itemId - ID of the item to patch.
+     * @param fieldModifications - Field modifications to apply to the item.
+     * @param options - Additional options for the patch operation.
+     * @returns Promise that resolves to the patched item, or `null` if no item was returned.
+     */
+    patch<Item = WixDataItem>(collectionName: string, itemId: string, fieldModifications?: FieldModification[], options?: WixDataPatchOptions): Promise<Item | null>;
+    private executeDirectPatch;
+    bulkPatch(collectionName: string, itemIds: string[]): WixDataBulkPatch;
+    /**
+     * Executes a bulk patch directly without using the builder pattern.
+     * @internal
+     * @param collectionName - Name of the collection containing the items to patch.
+     * @param itemIds - IDs of the items to patch.
+     * @param fieldModifications - Field modifications to apply to the items.
+     * @param options - Additional options for the bulk patch operation.
+     * @returns Promise that resolves to bulk operation results.
+     */
+    bulkPatch(collectionName: string, itemIds: string[], fieldModifications?: FieldModification[], options?: WixDataBulkPatchOptions): Promise<WixDataBulkResult>;
+    private executeDirectBulkPatch;
     asyncPatchByFilter: (collectionName: string, filter: WixDataFilterInput) => WixDataPatchByFilter;
     asyncRemoveByFilter: (collectionName: string, filter: WixDataFilterInput, options?: WixDataAsyncByFilterOptions | undefined) => Promise<WixDataAsyncJob>;
     getAsyncJobStatus: (jobId: string) => Promise<WixDataAsyncJobStatus>;
@@ -44,7 +79,7 @@ export declare class WixDataApi {
      * @param options - Additional options including includeReferences.
      * @returns Promise that resolves to the query results.
      */
-    query<Item = WixDataItem>(collectionName: string, queryRequest: WixDataQueryRequest, options?: WixDataDirectQueryOptions): Promise<WixDataResult<Item>>;
+    query<Item = WixDataItem>(collectionName: string, queryRequest: WixDataQueryRequest, options?: WixDataDirectQueryOptions): Promise<WixDataQueryResponse<Item>>;
     private executeDirectQuery;
     /**
      * Returns a search builder for the specified collection.
@@ -60,7 +95,7 @@ export declare class WixDataApi {
      * @param options - Additional options including referencedItemOptions.
      * @returns Promise that resolves to the search results.
      */
-    search(collectionName: string, searchRequest: WixDataSearchRequest, options?: WixDataDirectSearchOptions): Promise<WixDataResult>;
+    search<Item = WixDataItem>(collectionName: string, searchRequest: WixDataSearchRequest, options?: WixDataDirectSearchOptions): Promise<WixDataSearchResponse<Item>>;
     private executeDirectSearch;
     fetch: (collectionName: string, cursor: string, limit?: number | undefined, options?: WixDataReadOptions | undefined) => Promise<WixDataResult<WixDataItem>>;
     aggregate(collectionName: string): WixDataAggregate;
@@ -72,10 +107,11 @@ export declare class WixDataApi {
      * @param options - Options for running the aggregation.
      * @returns Promise that resolves to the aggregation results.
      */
-    aggregate(collectionName: string, pipeline: apiTypes.AggregationPipeline, options?: WixDataAggregateOptions): Promise<apiTypes.AggregatePipelineDataItemsResponse>;
+    aggregate<Result = Record<string, any>>(collectionName: string, pipeline: apiTypes.AggregationPipeline, options?: WixDataAggregateOptions): Promise<WixDataAggregateResponse<Result>>;
     fetchAggregate: (collectionName: string, cursor: string, limit?: number | undefined, options?: WixDataReadOptions | undefined) => Promise<WixDataResultImpl<Record<string, any>>>;
+    private executeDirectAggregate;
     aggregatePipeline: (collectionName: string, pipeline: apiTypes.AggregationPipeline, options?: WixDataAggregateOptions | undefined) => Promise<apiTypes.AggregatePipelineDataItemsResponse>;
-    distinct: (collectionName: string, fieldName: string, options?: WixDataDistinctOptions | undefined) => Promise<WixDataResult<WixDataItem>>;
+    distinct: (collectionName: string, fieldName: string, options?: WixDataDistinctOptions | undefined) => Promise<WixDataDistinctResponse<any>>;
     /** @internal */
     count: (collectionName: string, options?: WixDataCountOptions | undefined) => Promise<number>;
     bulkRemove: (collectionName: string, itemIds: string[], options?: WixDataOptions | undefined) => Promise<WixDataBulkResult>;
@@ -87,6 +123,7 @@ export declare class WixDataApi {
     bulkUpdate: (collectionName: string, items: WixDataItem[], options?: WixDataBulkUpdateOptions | undefined) => Promise<WixDataBulkResult>;
     fetchReferenced: (collectionName: string, cursor: string, limit?: number | undefined, options?: WixDataReadWithProjectionOptions | undefined) => Promise<WixDataResult<string | WixDataItem>>;
     queryReferenced: (collectionName: string, holdingItem: WixDataItemOrId, relationshipAttribute: string, options?: WixDataQueryReferencedOptions | undefined) => Promise<WixDataResult<WixDataItem>>;
+    queryReferencedItems: QueryReferencedItems;
     insertReference: {
         (collectionName: string, refs: WixDataReference[], options?: WixDataOptions): Promise<void>;
         (collectionName: string, relationshipAttribute: string, left: WixDataItemOrId, right: WixDataItemOrId | WixDataItemOrId[], options?: WixDataOptions): Promise<void>;

package/dist/types/api/WixDataApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WixDataApi.d.ts","sourceRoot":"","sources":["../../../src/api/WixDataApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WixDataApi.d.ts","sourceRoot":"","sources":["../../../src/api/WixDataApi.ts"],"names":[],"mappings":"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"}

package/dist/types/api/WixDataDistinctResponse.d.ts

@@ -0,0 +1,8 @@
+import { PagingMetadata } from './PagingMetadata';
+export interface WixDataDistinctResponse<Value = any> {
+    /** Retrieved distinct values. */
+    values: Value[];
+    /** Paging information. */
+    pagingMetadata: PagingMetadata;
+}
+//# sourceMappingURL=WixDataDistinctResponse.d.ts.map

package/dist/types/api/WixDataDistinctResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WixDataDistinctResponse.d.ts","sourceRoot":"","sources":["../../../src/api/WixDataDistinctResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,WAAW,uBAAuB,CAAC,KAAK,GAAG,GAAG;IAClD,iCAAiC;IACjC,MAAM,EAAE,KAAK,EAAE,CAAA;IAEf,0BAA0B;IAC1B,cAAc,EAAE,cAAc,CAAA;CAC/B"}

package/dist/types/api/WixDataFieldModificationsBuilder.d.ts

@@ -0,0 +1,88 @@
+import type { FieldModification } from './FieldModification';
+/**
+ * WixData FieldModificationsBuilder type.
+ * @internal
+ */
+export interface FieldModificationsBuilder<Self> {
+    /**
+     * Refines a patch operation to increment the specified field value by the specified parameter.
+     * @public
+     * @documentationMaturity preview
+     * @param field - Field whose value is incremented. Nested fields can be specified using dot notation. For example: `address.street`.
+     * @requiredField field
+     * @param by - Value by which to increment the specified field. To decrement, specify a negative value.
+     * @requiredField by
+     * @returns Updated patch object.
+     */
+    incrementField(field: string, by: number): Self;
+    /**
+     * Refines a patch operation to set the specified field to the specified value.
+     * @public
+     * @documentationMaturity preview
+     * @param field - Field whose value is set. Nested fields can be specified using dot notation. For example: `address.street`.
+     * @requiredField field
+     * @param value - Value to set for the specified field.
+     * @requiredField value
+     * @returns Updated patch object.
+     */
+    setField(field: string, value: any): Self;
+    /**
+     * Refines a patch operation to append the specified value to the specified array field.
+     * @public
+     * @documentationMaturity preview
+     * @param field - Array field to append the specified value to. Nested fields can be specified using dot notation. For example: `address.street`.
+     * @requiredField field
+     * @param value - Value to append to the specified array field.
+     * @requiredField value
+     * @returns Updated patch object.
+     */
+    appendToArray(field: string, value: any): Self;
+    /**
+     * Refines a patch operation to remove the first instance of the specified value from the specified array field.
+     * @public
+     * @documentationMaturity preview
+     * @param field - Array field to remove the specified value from. Nested fields can be specified using dot notation. For example: `address.street`.
+     * @requiredField field
+     * @param value - Value whose first instance is removed from the specified array field.
+     * @requiredField value
+     * @returns Updated patch object.
+     */
+    removeFromArray(field: string, value: any): Self;
+    /**
+     * Refines a patch operation to clear the specified field.
+     * @public
+     * @documentationMaturity preview
+     * @param field - Field whose value is cleared. Nested fields can be specified using dot notation. For example: `address.street`.
+     * @requiredField field
+     * @returns Updated patch object.
+     */
+    removeField(field: string): Self;
+}
+/**
+ * WixData field modifications builder.
+ * @internal
+ */
+export interface WixDataFieldModificationsBuilder extends FieldModificationsBuilder<WixDataFieldModificationsBuilder> {
+    /** Build the final array of field modifications */
+    build(): FieldModification[];
+}
+/**
+ * Creates a new WixData field modifications builder.
+ * @internal
+ *
+ * @example
+ * ```ts
+ * import { FieldModificationsBuilder } from '@wix/wix-data-items-common'
+ *
+ * const fieldModifications = FieldModificationsBuilder()
+ *   .setField('title', 'Updated title')
+ *   .incrementField('viewCount', 1)
+ *   .appendToArray('tags', 'featured')
+ *   .removeField('legacyField')
+ *   .build()
+ *
+ * const item = await wixData.patch('myCollection', 'itemId', fieldModifications)
+ * ```
+ */
+export declare const FieldModificationsBuilder: () => WixDataFieldModificationsBuilder;
+//# sourceMappingURL=WixDataFieldModificationsBuilder.d.ts.map

package/dist/types/api/WixDataFieldModificationsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WixDataFieldModificationsBuilder.d.ts","sourceRoot":"","sources":["../../../src/api/WixDataFieldModificationsBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,IAAI;IAC7C;;;;;;;;;OASG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAA;IAEzC;;;;;;;;;OASG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAA;IAE9C;;;;;;;;;OASG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAA;IAEhD;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gCACf,SAAQ,yBAAyB,CAAC,gCAAgC,CAAC;IACnE,mDAAmD;IACnD,KAAK,IAAI,iBAAiB,EAAE,CAAA;CAC7B;AA+BD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,gCACI,CAAA"}