Merge branch 'alpha' into flaky-dist-test

Author: dplewis

package-lock.json

@@ -31,35 +31,35 @@
     "react-native": false
   },
   "dependencies": {
-    "@babel/runtime-corejs3": "7.27.0",
+    "@babel/runtime-corejs3": "7.27.1",
     "idb-keyval": "6.2.1",
     "react-native-crypto-js": "1.0.0",
     "uuid": "10.0.0",
-    "ws": "8.18.1"
+    "ws": "8.18.2"
   },
   "devDependencies": {
-    "@babel/core": "7.26.10",
+    "@babel/core": "7.27.1",
     "@babel/plugin-proposal-class-properties": "7.18.6",
-    "@babel/plugin-transform-runtime": "7.26.10",
+    "@babel/plugin-transform-runtime": "7.27.1",
     "@babel/preset-env": "7.26.9",
-    "@babel/preset-react": "7.26.3",
-    "@babel/preset-typescript": "7.27.0",
-    "@eslint/js": "9.25.1",
+    "@babel/preset-react": "7.27.1",
+    "@babel/preset-typescript": "7.27.1",
+    "@eslint/js": "9.26.0",
     "@parse/minami": "git+https://github.com/parse-community/minami#main",
     "@rollup/plugin-terser": "0.4.4",
     "@saithodev/semantic-release-backmerge": "4.0.1",
     "@semantic-release/changelog": "6.0.3",
     "@semantic-release/commit-analyzer": "13.0.1",
     "@semantic-release/git": "10.0.1",
-    "@semantic-release/github": "11.0.1",
+    "@semantic-release/github": "11.0.2",
     "@semantic-release/npm": "12.0.1",
     "@semantic-release/release-notes-generator": "14.0.3",
     "@types/facebook-js-sdk": "3.3.11",
     "babel-jest": "29.5.0",
     "babel-plugin-minify-dead-code-elimination": "0.5.2",
     "babel-plugin-transform-inline-environment-variables": "0.4.4",
     "codecov": "3.8.3",
-    "core-js": "3.41.0",
+    "core-js": "3.42.0",
     "cross-env": "7.0.2",
     "eslint": "9.25.1",
     "eslint-plugin-expect-type": "0.6.2",
@@ -68,7 +68,7 @@
     "gulp": "5.0.0",
     "gulp-babel": "8.0.0",
     "gulp-watch": "5.0.1",
-    "jasmine": "5.6.0",
+    "jasmine": "5.7.1",
     "jasmine-reporters": "2.5.2",
     "jasmine-spec-reporter": "7.0.0",
     "jest": "29.7.0",
@@ -78,13 +78,13 @@
     "lint-staged": "15.5.1",
     "madge": "8.0.0",
     "metro-react-native-babel-preset": "0.77.0",
-    "mongodb-runner": "5.8.2",
-    "parse-server": "8.1.0",
-    "puppeteer": "24.6.1",
+    "mongodb-runner": "5.8.3",
+    "parse-server": "8.2.0",
+    "puppeteer": "24.8.0",
     "regenerator-runtime": "0.14.1",
     "semantic-release": "24.2.3",
-    "typescript-eslint": "8.31.0",
-    "vite": "6.3.3",
+    "typescript-eslint": "8.31.1",
+    "vite": "6.3.4",
     "vite-plugin-commonjs": "0.10.4",
     "vite-plugin-node-polyfills": "0.23.0"
   },

package.json

@@ -355,6 +355,7 @@ const config: Config & Record<string, any> = {
   IDEMPOTENCY: false,
   ALLOW_CUSTOM_OBJECT_ID: false,
   PARSE_ERRORS: [],
+  NODE_LOGGING: false,
 };
 
 function requireMethods(name: string, methods: string[], controller: any) {

src/CoreManager.ts

@@ -314,6 +314,28 @@ const Parse = {
     return CoreManager.get('ALLOW_CUSTOM_OBJECT_ID');
   },
 
+  /**
+   * Setting this property to `true` enables enhanced logging for `Parse.Object`
+   * in Node.js environments. Specifically, it will log:
+   *
+   * ```
+   * ParseObject: className: <CLASS_NAME>, id: <OBJECT_ID>
+   * Attributes: <OBJECT_ATTRIBUTES>
+   * ```
+   *
+   * @warning This should not be enabled in production environments as this may
+   * expose sensitive information in server logs.
+   *
+   * @property {boolean} Parse.nodeLogging
+   * @static
+   */
+  set nodeLogging(value) {
+    CoreManager.set('NODE_LOGGING', value);
+  },
+  get nodeLogging() {
+    return CoreManager.get('NODE_LOGGING');
+  },
+
   _request(...args) {
     return CoreManager.getRESTController().request.apply(null, args);
   },

src/Parse.ts

@@ -186,6 +186,13 @@ class ParseObject<T extends Attributes = Attributes> {
         throw new Error("Can't create an invalid Parse Object");
       }
     }
+    if (CoreManager.get('NODE_LOGGING')) {
+      this[Symbol.for('nodejs.util.inspect.custom')] = function () {
+        return `ParseObject: className: ${this.className}, id: ${
+          this.id
+        }\nAttributes: ${JSON.stringify(this.attributes, null, 2)}`;
+      };
+    }
   }
 
   /**

src/ParseObject.ts

@@ -206,6 +206,13 @@ describe('Parse module', () => {
     Parse.allowCustomObjectId = false;
   });
 
+  it('can set nodeLogging', () => {
+    expect(Parse.nodeLogging).toBe(false);
+    Parse.nodeLogging = true;
+    expect(CoreManager.get('NODE_LOGGING')).toBe(true);
+    Parse.nodeLogging = false;
+  });
+
   it('getServerHealth', () => {
     const controller = {
       request: jest.fn(),

src/__tests__/Parse-test.js

@@ -3532,4 +3532,14 @@ describe('ParseObject pin', () => {
     });
     CoreManager.set('ALLOW_CUSTOM_OBJECT_ID', false);
   });
+
+  it('can log an object', () => {
+    CoreManager.set('NODE_LOGGING', true);
+    const o = new ParseObject('Person', { foo: 'bar' });
+    const symbol = Symbol.for('nodejs.util.inspect.custom');
+    expect(o[symbol]()).toBe(
+      `ParseObject: className: Person, id: undefined\nAttributes: {\n  \"foo\": \"bar\"\n}`
+    );
+    CoreManager.set('NODE_LOGGING', false);
+  });
 });

src/__tests__/ParseObject-test.js

@@ -322,6 +322,22 @@ declare const Parse: {
      * @static
      */
     allowCustomObjectId: any;
+    /**
+     * Setting this property to `true` enables enhanced logging for `Parse.Object`
+     * in Node.js environments. Specifically, it will log:
+     *
+     * ```
+     * ParseObject: className: <CLASS_NAME>, id: <OBJECT_ID>
+     * Attributes: <OBJECT_ATTRIBUTES>
+     * ```
+     *
+     * @warning This should not be enabled in production environments as this may
+     * expose sensitive information in server logs.
+     *
+     * @property {boolean} Parse.nodeLogging
+     * @static
+     */
+    nodeLogging: any;
     _request(...args: any[]): any;
     _ajax(...args: any[]): any;
     _decode(_: any, value: any): any;