ci: Add integration tests for Parse Server

.eslintrc.json

@@ -3,11 +3,12 @@
     "extends": "eslint:recommended",
     "env": {
         "node": true,
-        "es6": true
+        "es2020": true
     },
     "parserOptions": {
-        "ecmaVersion": 8,
-        "sourceType": "module"
+        "ecmaVersion": 2020,
+        "sourceType": "module",
+        "requireConfigFile": false
     },
     "rules": {
         "indent": ["error", 2, { "SwitchCase": 1 }],
@@ -19,6 +20,12 @@
         "prefer-const": "error",
         "space-infix-ops": "error",
         "no-useless-escape": "off",
-        "require-atomic-updates": "off"
+        "require-atomic-updates": "off",
+        "object-curly-spacing": ["error", "always"],
+        "curly": ["error", "all"],
+        "block-spacing": ["error", "always"]
+    },
+    "globals": {
+        "Parse": true
     }
 }

.github/workflows/ci.yml

@@ -25,23 +25,34 @@ jobs:
     strategy:
       matrix:
         include:
-          - name: Node.js 18
+          - name: Parse Server 7, Node.js 18
             NODE_VERSION: 18.20.4
-          - name: Node.js 20
+            PARSE_SERVER_VERSION: 7
+          - name: Parse Server 7, Node.js 20
             NODE_VERSION: 20.15.1
-          - name: Node.js 22
+            PARSE_SERVER_VERSION: 7
+          - name: Parse Server 7, Node.js 22
             NODE_VERSION: 22.4.1
+            PARSE_SERVER_VERSION: 7
+          - name: Parse Server 6
+            NODE_VERSION: 18
+            PARSE_SERVER_VERSION: 6
       fail-fast: false
     name: ${{ matrix.name }}
     timeout-minutes: 15
     runs-on: ubuntu-latest
+    env:
+      NODE_VERSION: ${{ matrix.NODE_VERSION }}
+      PARSE_SERVER_VERSION: ${{ matrix.PARSE_SERVER_VERSION }}
     steps:
       - uses: actions/checkout@v4
       - name: Use Node.js ${{ matrix.NODE_VERSION }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.NODE_VERSION }}
           cache: npm
+      - name: Install Parse Server ${{ matrix.PARSE_SERVER_VERSION }}
+        run: npm i -DE parse-server@${{ matrix.PARSE_SERVER_VERSION }}
       - name: Install dependencies
         run: npm ci
       - name: Run tests

.gitignore

@@ -36,4 +36,8 @@ node_modules
 # Webstorm
 .idea/
 
+# Lint
 .eslintcache
+
+# Parse Server
+test_logs

.nycrc

@@ -5,7 +5,9 @@
     "text-summary"
   ],
   "include": [
-    "src/**/*.js"
+    "src/**/*.js",
+    "lib/**/*.js",
+    "index.js"
   ],
   "exclude": [
     "**/spec/**"

README.md

@@ -16,6 +16,7 @@ The official AWS S3 file storage adapter for Parse Server. See [Parse Server S3
 - [Getting Started](#getting-started)
   - [Installation](#installation)
   - [Compatibility](#compatibility)
+    - [Parse Server](#parse-server)
     - [Node.js](#nodejs)
   - [AWS Credentials](#aws-credentials)
   - [Deprecated Configuration](#deprecated-configuration)
@@ -37,6 +38,14 @@ The official AWS S3 file storage adapter for Parse Server. See [Parse Server S3
 
 ## Compatibility
 
+### Parse Server
+
+| Version | End-of-Life   | Compatible |
+|---------|---------------|------------|
+| <=5     | December 2023 | ✅ Yes      |
+| 6       | December 2024 | ✅ Yes      |
+| 7       | December 2025 | ✅ Yes      |
+
 ### Node.js
 
 This product is continuously tested with the most recent releases of Node.js to ensure compatibility. We follow the [Node.js Long Term Support plan](https://github.com/nodejs/Release) and only test against versions that are officially supported and have not reached their end-of-life date.
@@ -88,11 +97,11 @@ The preferred method is to use the default AWS credentials pattern.  If no AWS c
 
 *(This list is still incomplete and in the works, in the meantime find more descriptions in the chapters below.)*
 
-| Parameter | Optional | Default value | Environment variable | Description |
-|-----------|----------|---------------|----------------------|-------------|
-| `fileAcl` | yes | `undefined` | S3_FILE_ACL | Sets the [Canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) of the file when storing it in the S3 bucket. Setting this parameter overrides the file ACL that would otherwise depend on the `directAccess` parameter. Setting the value `'none'` causes any ACL parameter to be removed that would otherwise be set. |
-| `presignedUrl` | yes | `false` | S3_PRESIGNED_URL | If `true` a [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html) is returned when requesting the URL of file. The URL is only valid for a specified duration, see parameter `presignedUrlExpires`. |
-| `presignedUrlExpires` | yes | `undefined` | S3_PRESIGNED_URL_EXPIRES | Sets the duration in seconds after which the [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html) of the file expires. If no value is set, the AWS S3 SDK default [Expires](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getSignedUrl-property) value applies. This parameter requires `presignedUrl` to be `true`. |
+| Parameter             | Optional | Default value | Environment variable     | Description                                                                                                                                                                                                                                                                                                                                                                     |
+|-----------------------|----------|---------------|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `fileAcl`             | yes      | `undefined`   | S3_FILE_ACL              | Sets the [Canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) of the file when storing it in the S3 bucket. Setting this parameter overrides the file ACL that would otherwise depend on the `directAccess` parameter. Setting the value `'none'` causes any ACL parameter to be removed that would otherwise be set.                     |
+| `presignedUrl`        | yes      | `false`       | S3_PRESIGNED_URL         | If `true` a [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html) is returned when requesting the URL of file. The URL is only valid for a specified duration, see parameter `presignedUrlExpires`.                                                                                                                                     |
+| `presignedUrlExpires` | yes      | `undefined`   | S3_PRESIGNED_URL_EXPIRES | Sets the duration in seconds after which the [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/dev/ShareObjectPreSignedURL.html) of the file expires. If no value is set, the AWS S3 SDK default [Expires](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getSignedUrl-property) value applies. This parameter requires `presignedUrl` to be `true`. |
 
 ## Using a Config File