Merge remote-tracking branch 'upstream/alpha' into alpha

Author: mtrezza

changelogs/CHANGELOG_alpha.md

@@ -1,3 +1,24 @@
+## [8.1.1-alpha.6](https://github.com/parse-community/Parse-SDK-JS/compare/8.1.1-alpha.5...8.1.1-alpha.6) (2026-02-11)
+
+
+### Bug Fixes
+
+* `Parse.serverURL` not accessible via global `Parse` scope ([#2917](https://github.com/parse-community/Parse-SDK-JS/issues/2917)) ([4e78681](https://github.com/parse-community/Parse-SDK-JS/commit/4e78681881320a0b8ec383955b47d693cb8add9c))
+
+## [8.1.1-alpha.5](https://github.com/parse-community/Parse-SDK-JS/compare/8.1.1-alpha.4...8.1.1-alpha.5) (2026-02-11)
+
+
+### Bug Fixes
+
+* Type error in `Parse.Query.equalTo` when matching optional array ([#2901](https://github.com/parse-community/Parse-SDK-JS/issues/2901)) ([8c96da9](https://github.com/parse-community/Parse-SDK-JS/commit/8c96da9d507dfd61c907f88861e5233807e7ba36))
+
+## [8.1.1-alpha.4](https://github.com/parse-community/Parse-SDK-JS/compare/8.1.1-alpha.3...8.1.1-alpha.4) (2026-02-09)
+
+
+### Bug Fixes
+
+* Missing or incorrect type exports ([#2909](https://github.com/parse-community/Parse-SDK-JS/issues/2909)) ([3caa4ec](https://github.com/parse-community/Parse-SDK-JS/commit/3caa4ec995e0cc02082e55e9873e12b3bc10393f))
+
 ## [8.1.1-alpha.3](https://github.com/parse-community/Parse-SDK-JS/compare/8.1.1-alpha.2...8.1.1-alpha.3) (2026-02-07)
 
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "parse",
-  "version": "8.1.1-alpha.3",
+  "version": "8.1.1-alpha.6",
   "description": "Parse JavaScript SDK",
   "homepage": "https://parseplatform.org",
   "keywords": [
@@ -88,7 +88,7 @@
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/git": "10.0.1",
     "@semantic-release/github": "12.0.5",
-    "@semantic-release/npm": "13.1.3",
+    "@semantic-release/npm": "13.1.4",
     "@semantic-release/release-notes-generator": "14.1.0",
     "@types/facebook-js-sdk": "3.3.11",
     "babel-jest": "30.2.0",
@@ -114,12 +114,12 @@
     "lint-staged": "16.2.7",
     "madge": "8.0.0",
     "metro-react-native-babel-preset": "0.77.0",
-    "mongodb-runner": "6.6.0",
+    "mongodb-runner": "6.6.1",
     "parse-server": "9.2.0",
     "puppeteer": "24.37.2",
     "regenerator-runtime": "0.14.1",
     "semantic-release": "25.0.3",
-    "typescript-eslint": "8.54.0",
+    "typescript-eslint": "8.55.0",
     "vite": "7.3.1",
     "vite-plugin-commonjs": "0.10.4",
     "vite-plugin-node-polyfills": "0.25.0"

package.json

@@ -4,7 +4,9 @@ import encode from './encode';
 import ParseError from './ParseError';
 import ParseQuery from './ParseQuery';
 import ParseObject from './ParseObject';
-import type { RequestOptions } from './RESTController';
+import type { RequestOptions, BaseRequestOptions } from './RESTController';
+
+export type RunOptions = BaseRequestOptions;
 
 /**
  * Contains functions for calling and declaring
@@ -40,12 +42,12 @@ import type { RequestOptions } from './RESTController';
 export function run<T extends () => any>(
   name: string,
   data?: null,
-  options?: RequestOptions
+  options?: RunOptions
 ): Promise<ReturnType<T>>;
 export function run<
   T extends (param: { [P in keyof Parameters<T>[0]]: Parameters<T>[0][P] }) => any,
->(name: string, data: Parameters<T>[0], options?: RequestOptions): Promise<ReturnType<T>>;
-export function run(name: string, data?: any, options?: RequestOptions): Promise<any> {
+>(name: string, data: Parameters<T>[0], options?: RunOptions): Promise<ReturnType<T>>;
+export function run(name: string, data?: any, options?: RunOptions): Promise<any> {
   if (typeof name !== 'string' || name.length === 0) {
     throw new TypeError('Cloud function name must be a string.');
   }

src/Cloud.ts

@@ -28,7 +28,7 @@ import * as UniqueInstanceStateController from './UniqueInstanceStateController'
 import unsavedChildren from './unsavedChildren';
 
 import type { AttributeMap, OpsMap } from './ObjectStateMutations';
-import type { RequestOptions, FullOptions } from './RESTController';
+import type { RequestOptions, FullOptions, BaseRequestOptions } from './RESTController';
 import type ParseGeoPoint from './ParseGeoPoint';
 import type ParsePolygon from './ParsePolygon';
 
@@ -45,35 +45,63 @@ interface SaveParams {
   body: AttributeMap;
 }
 
-export type SaveOptions = FullOptions & {
+export interface SaveOptions extends BaseRequestOptions {
+  /** If `false`, nested objects will not be saved (default is `true`). */
   cascadeSave?: boolean;
-  context?: AttributeMap;
   batchSize?: number;
   transaction?: boolean;
-};
+}
 
-interface FetchOptions {
-  useMasterKey?: boolean;
-  sessionToken?: string;
+export interface FetchOptions extends BaseRequestOptions {
   include?: string | string[];
-  context?: AttributeMap;
 }
 
 export interface SetOptions {
   ignoreValidation?: boolean;
   unset?: boolean;
 }
 
+export type DestroyOptions = BaseRequestOptions;
+
+/** Options for destroyAll batch operation */
+export interface DestroyAllOptions extends BaseRequestOptions {
+  /** batchSize: How many objects to yield in each batch (default: 20) */
+  batchSize?: number;
+  /** Set to true to enable transactions */
+  transaction?: boolean;
+}
+
+/** Options for saveAll batch operation */
+export interface SaveAllOptions extends BaseRequestOptions {
+  /** batchSize: How many objects to yield in each batch (default: 20) */
+  batchSize?: number;
+  /** If `false`, nested objects will not be saved (default is `true`). */
+  cascadeSave?: boolean;
+  /** Set to true to enable transactions */
+  transaction?: boolean;
+}
+
+/** Options for fetchAll batch operation */
+export interface FetchAllOptions extends BaseRequestOptions {
+  include?: string | string[];
+}
+
 export type AttributeKey<T> = Extract<keyof T, string>;
 
 export type Attributes = Record<string, any>;
 
-interface JSONBaseAttributes {
+export interface JSONBaseAttributes {
   objectId: string;
   createdAt: string;
   updatedAt: string;
 }
 
+export interface BaseAttributes {
+  objectId: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
 interface CommonAttributes {
   ACL: ParseACL;
 }
@@ -82,7 +110,7 @@ type AtomicKey<T> = {
   [K in keyof T]: NonNullable<T[K]> extends any[] ? K : never;
 };
 
-type Encode<T> = T extends ParseObject
+export type Encode<T> = T extends ParseObject
   ? ReturnType<T['toJSON']> | Pointer
   : T extends ParseACL | ParseGeoPoint | ParsePolygon | ParseRelation | ParseFile
     ? ReturnType<T['toJSON']>
@@ -96,7 +124,7 @@ type Encode<T> = T extends ParseObject
             ? ToJSON<T>
             : T;
 
-type ToJSON<T> = {
+export type ToJSON<T> = {
   [K in keyof T]: Encode<T[K]>;
 };
 
@@ -1481,7 +1509,7 @@ class ParseObject<T extends Attributes = Attributes> {
    * @returns {Promise} A promise that is fulfilled when the destroy
    *     completes.
    */
-  destroy(options?: RequestOptions): Promise<ParseObject | undefined> {
+  destroy(options?: DestroyOptions): Promise<ParseObject | undefined> {
     if (!this.id) {
       return Promise.resolve(undefined);
     }
@@ -1637,7 +1665,7 @@ class ParseObject<T extends Attributes = Attributes> {
    * @static
    * @returns {Parse.Object[]}
    */
-  static fetchAll<T extends ParseObject>(list: T[], options?: RequestOptions): Promise<T[]> {
+  static fetchAll<T extends ParseObject>(list: T[], options?: FetchAllOptions): Promise<T[]> {
     const fetchOptions = ParseObject._getRequestOptions(options);
     return CoreManager.getObjectController().fetch(list, true, fetchOptions) as Promise<T[]>;
   }
@@ -1748,7 +1776,10 @@ class ParseObject<T extends Attributes = Attributes> {
    * @static
    * @returns {Parse.Object[]}
    */
-  static fetchAllIfNeeded<T extends ParseObject>(list: T[], options?: FetchOptions): Promise<T[]> {
+  static fetchAllIfNeeded<T extends ParseObject>(
+    list: T[],
+    options?: FetchAllOptions
+  ): Promise<T[]> {
     const fetchOptions = ParseObject._getRequestOptions(options);
     return CoreManager.getObjectController().fetch(list, false, fetchOptions) as Promise<T[]>;
   }
@@ -1824,9 +1855,9 @@ class ParseObject<T extends Attributes = Attributes> {
    * @returns {Promise} A promise that is fulfilled when the destroyAll
    * completes.
    */
-  static destroyAll(list: ParseObject[], options?: SaveOptions) {
+  static destroyAll<T extends ParseObject>(list: T[], options?: DestroyAllOptions): Promise<T[]> {
     const destroyOptions = ParseObject._getRequestOptions(options);
-    return CoreManager.getObjectController().destroy(list, destroyOptions);
+    return CoreManager.getObjectController().destroy(list, destroyOptions) as Promise<T[]>;
   }
 
   /**
@@ -1858,7 +1889,7 @@ class ParseObject<T extends Attributes = Attributes> {
    * @static
    * @returns {Parse.Object[]}
    */
-  static saveAll<T extends ParseObject[]>(list: T, options?: SaveOptions): Promise<T> {
+  static saveAll<T extends ParseObject[]>(list: T, options?: SaveAllOptions): Promise<T> {
     const saveOptions = ParseObject._getRequestOptions(options);
     return CoreManager.getObjectController().save(list, saveOptions) as any;
   }
@@ -2657,4 +2688,41 @@ const DefaultController = {
 CoreManager.setParseObject(ParseObject);
 CoreManager.setObjectController(DefaultController);
 
+export interface ObjectStatic<T extends ParseObject = ParseObject> {
+  new (...args: any[]): T;
+  createWithoutData(id: string): T;
+  destroyAll<U extends ParseObject>(list: U[], options?: DestroyAllOptions): Promise<U[]>;
+  extend(className: string | { className: string }, protoProps?: any, classProps?: any): any;
+  fetchAll<U extends ParseObject>(list: U[], options?: FetchAllOptions): Promise<U[]>;
+  fetchAllIfNeeded<U extends ParseObject>(list: U[], options?: FetchAllOptions): Promise<U[]>;
+  fetchAllIfNeededWithInclude<U extends ParseObject>(
+    list: U[],
+    keys: keyof U['attributes'] | (keyof U['attributes'])[],
+    options?: RequestOptions
+  ): Promise<U[]>;
+  fetchAllWithInclude<U extends ParseObject>(
+    list: U[],
+    keys: keyof U['attributes'] | (keyof U['attributes'])[],
+    options?: RequestOptions
+  ): Promise<U[]>;
+  fromJSON(json: any, override?: boolean, dirty?: boolean): T;
+  pinAll(objects: ParseObject[]): Promise<void>;
+  pinAllWithName(name: string, objects: ParseObject[]): Promise<void>;
+  registerSubclass(className: string, clazz: new (options?: any) => T): void;
+  saveAll<U extends ParseObject[]>(list: U, options?: SaveAllOptions): Promise<U>;
+  unPinAll(objects: ParseObject[]): Promise<void>;
+  unPinAllObjects(): Promise<void>;
+  unPinAllObjectsWithName(name: string): Promise<void>;
+  unPinAllWithName(name: string, objects: ParseObject[]): Promise<void>;
+}
+
+export interface ObjectConstructor extends ObjectStatic {
+  new <T extends Attributes>(className: string, attributes: T, options?: any): ParseObject<T>;
+  new (
+    className?: string | { className: string; [attr: string]: any },
+    attributes?: Attributes,
+    options?: any
+  ): ParseObject;
+}
+
 export default ParseObject;