@formio/appserver 2.3.2 → 2.5.0

package/LICENSE.txt

@@ -1,6 +1,6 @@
 OSL-3.0
 https://opensource.org/licenses/OSL-3.0
-Copyright (c) 2020, Form.io LLC
+Copyright (c) 2025, Form.io LLC
 All rights reserved.
 
 This Open Software License (the "License") applies to any original work of authorship (the "Original Work") whose owner (the "Licensor") has placed the following licensing notice adjacent to the copyright notice for the Original Work:

package/README.md

@@ -4,14 +4,14 @@ The Form.io App Server is a performant run-time application server used to serve
 It's goals are as follows:
  - Provide a single project runtime server where non-submission resources are cached in memory.
  - Enable multi-tenant / multi-database deployments.
- - Provide extensible server-side functionality
+ - Provide extensible server-side functionality, like custom actions.
  - Support other databases besides MongoDB compliant databases for submission data.
 
 ### Installation
 To use this library, you must mount it within an Express.js application. As an example, you can create a simple Express.js application with this library by first creating a new [Express.js application](https://expressjs.com/en/starter/installing.html) and then install and use the Server as follows.
 
 ```
-npm install --save @formio/appserver@rc
+npm install --save @formio/appserver
 ```
 
 Then within your server.js file, you would add the following.
@@ -24,9 +24,6 @@ const { Server } = require('@formio/appserver');
     // Create the server.
     const server = new Server();
 
-    // Initialize the server.
-    await server.init();
-
     // Add the server router.
     app.use(await server.router());
 
@@ -65,9 +62,9 @@ This library uses environment variables to configure the configurations required
 | Variable Name         | Required | Description | Example |
 |--------------|-----|-----------|-----|
 | MONGO | yes | Your MongoDB Connection string to use the default DB. | mongodb://localhost:27017/appserver |
-| PROJECT_ENDPOINT | yes | The endpoint for your deployed Form.io Enterprise project. | https://mydeployment.com/myproject |
+| PROJECT | yes | The endpoint for your deployed Form.io Enterprise project. | https://mydeployment.com/myproject |
 | PROJECT_KEY | yes | The API Key for your deployed Form.io Enterprise Project. | abc123 |
-| LICENSE_KEY | yes | Your License Key for this App Server deployment. | <LONG LICENSE KEY> |
+| APPSERVER_LICENSE | yes | Your License Key for this App Server deployment. | <LONG LICENSE KEY> |
 | PORT | no | The port that your server will run on. Default 3005 | 3005 |
 | JWT_SECRET | yes | The key used to protect your JWT authentication tokens. | YOUR_SECRET_KEY |
 | JWT_EXPIRE_TIME | no | The number of minutes to expire your JWT token. | 240 |
@@ -75,128 +72,6 @@ This library uses environment variables to configure the configurations required
 | PROJECT_CACHE | no | Disables the cache for project resources (such as Project template, Project Settings, and Access Settings). Default "true" | true |
 | MONGO_CONFIG | no | Additional configurations to add to the DB connection string | {} |
 
-### Developer Portal Connection
-Once you have the App Server running within your own environment, and connected to your own database, you can now deploy your new changes to your forms, resources, project settings, etc. To accomplish this, you must first run the App Server using the ```PORTAL_SECRET``` described above.
-
-Once you have this set, you can then log into your Developer Portal, and then navigate to your Project.
-
-Once there, you will then go to your **Staging | Connect Environment**.  Here you will put your App Server endpoint and the PORTAL_SECRET value. You will then want to set the **Project Path Type** to use **Subdirectory**. Then click **Continue**. 
-
-You will then see the next page, where you will select your Stage in the dropdown. You should see it since the App Server connects to the project on bootup.
-
-Once you are connected, any changes you make within the Developer portal will now be directly reflected within your App Server deployment.
-
-### Custom Configuration
-The App Server is very extensible, and many things can be altered and modified as well as custom implementations of different components are possible using configurations.
-
-The following configurations can be provided to the Server instance. Here are some configurations that are supported.
-
-```js
-const express = require('express');
-const app = express();
-const { Server, Prepper } = require('@formio/appserver');
-const { CustomDB } = require('./customDb');
-const { CustomAuth } = require('./customAuth');
-const { CustomAction } = require('./actions/custom');
-(async function bootup() {
-    // Create the server.
-    const server = new Server({
-        /**
-         * The "db" configuration provides a way to use a Custom database implementation.
-         * 
-         * See https://github.com/formio/appserver/blob/main/src/db.ts for an example on 
-         * how to implement your own custom db.
-         */
-        db: CustomDB,
-
-        /**
-         * The "auth" configuration provides a way to implement your own custom Authentication
-         * system. 
-         * 
-         * See https://github.com/formio/appserver/blob/main/src/auth.ts for an example on 
-         * how to implement one.
-         */
-        auth: CustomAuth,
-
-        /**
-         * The "actions" is a map of new Actions you wish to implement into the application
-         * server. Each one that is provided will then become available within the Form
-         * builder and can be configured as an action that is executed when the form is 
-         * submitted.
-         */
-        actions: {
-            custom: CustomAction
-        },
-
-        /**
-         * Preppers provide you a way to hook into the data preparation methods that are
-         * called before the submission is saved into the database, as well as when the data
-         * is read from the database and sent up to the client. They provide a way to manipulate
-         * the data before it is transfered. A good example of a prepper is to remove any 
-         * "protected" fields so they are not sent up to the client application. 
-         * 
-         * See https://github.com/formio/appserver/tree/main/src/prepare for examples.
-         * 
-         * There are two types of preppers... those called on "save" and those called on "read".
-         * 
-         *  - save: Called when the submission is being saved.
-         *  - read: Called when the submission is being read from the database and sent to the
-         *          client application.
-         * 
-         * The "scope" argument is a PrepScope type. See https://github.com/formio/appserver/blob/main/src/types/submission.ts
-         */
-        preppers: {
-            save: Prepper.preppers.save.concat([
-                async (scope) => {
-                    const { component, data, value, path } = scope;
-                    // Do something with "data" property to mutate data prepped.
-                    console.log('Save Prepper 1');
-                }
-            ]),
-            read: Prepper.preppers.read.concat([
-                async (scope) => {
-                    const { component, data, value, path } = scope;
-                    console.log('Read Prepper 1');
-                }
-            ])
-        },
-
-        /**
-         * Processors provide a way to process data during the Create and Update phase for
-         * submissions. They should return an "errors" array if there are any errors during the
-         * processing phase. A good example of a processor is submission validation.
-         * 
-         * See https://github.com/formio/appserver/tree/main/src/process for other examples.
-         * 
-         * The "scope" argument is a ProcessScope type. See https://github.com/formio/appserver/blob/main/src/types/submission.ts
-         */
-        processors: {
-            submission: [
-                (scope) => {},
-                (scope) => {}
-            ],
-            evaluator: [
-                (scope) => {}
-            ],
-            prepare: [
-                (scope) => {}
-            ]
-        }
-    });
-
-    // Initialize the server.
-    await server.init();
-
-    // Add the server router.
-    app.use(await server.router());
-
-    // Start server.
-    app.listen(process.env.PORT, () => {
-        console.log(`Server running on port ${process.env.PORT}`);
-    });
-})();
-```
-
 Enjoy
 
 - The Form.io Team

package/lib/modules/mongodb/db.d.ts

@@ -1,4 +1,4 @@
-import { Collection, Document, Db, FindOptions, MongoClient } from 'mongodb';
+import { Collection, Document, Db, MongoClient, FindOneOptions } from 'mongodb';
 import { Component, Submission } from '@formio/core';
 import { ServerDB, DBConfig, AppServerForm, DatabaseIndexResponse } from '@formio/appserver-core';
 export declare class Database implements ServerDB {
@@ -92,7 +92,7 @@ export declare class Database implements ServerDB {
     /**
      * Find a record for a provided query.
      */
-    findOne(form: AppServerForm, dbQuery?: any, options?: FindOptions<Document>): Promise<Submission | null>;
+    findOne(form: AppServerForm, dbQuery?: any, options?: FindOneOptions | undefined): Promise<Submission | null>;
     /**
      * Read a single submission from a form
      *

package/lib/modules/mongodb/db.js

@@ -592,14 +592,14 @@ class Database {
      * Find a record for a provided query.
      */
     findOne(form_1) {
-        return __awaiter(this, arguments, void 0, function* (form, dbQuery = {}, options = {}) {
+        return __awaiter(this, arguments, void 0, function* (form, dbQuery = {}, options) {
             try {
                 debug('db.findOne()', dbQuery);
                 const collection = yield this.formCollection(form);
                 if (!collection) {
                     return null;
                 }
-                const doc = yield collection.findOne(this.query(form, dbQuery));
+                const doc = yield collection.findOne(this.query(form, dbQuery), options);
                 if (!doc) {
                     return null;
                 }

package/lib/server.js

@@ -56,6 +56,7 @@ class Server extends appserver_core_1.Server {
                 }
             },
             project: (0, lodash_1.get)(process.env, 'PROJECT', ''),
+            ttl: parseInt((0, lodash_1.get)(process.env, 'PROJECT_TTL', 900).toString(), 10),
             submissionProxy: (0, lodash_1.get)(process.env, 'SUBMISSION_PROXY', '').toString(),
             projects: (0, lodash_1.get)(process.env, 'PROJECTS', '').split(',').filter((p) => !!p),
             maxBodySize: (0, lodash_1.get)(process.env, 'MAX_BODY_SIZE', '100mb')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formio/appserver",
-  "version": "2.3.2",
+  "version": "2.5.0",
   "description": "A highly performant and extensible Application Server for Form.io Multi-Tenant Deployments.",
   "main": "lib/server.js",
   "types": "lib/server.d.ts",
@@ -26,11 +26,12 @@
     "lib",
     "server.js",
     "package.json",
-    "README.md"
+    "README.md",
+    "LICENSE.txt"
   ],
   "homepage": "https://github.com/formio/appserver#readme",
   "dependencies": {
-    "@formio/appserver-core": "^2.3.2",
+    "@formio/appserver-core": "^2.5.0",
     "@formio/core": "2.5.1-dev.291.6557e4e",
     "async": "^3.2.6",
     "bcryptjs": "^3.0.3",
@@ -39,7 +40,7 @@
     "express": "^5.1.0",
     "jsonwebtoken": "^9.0.2",
     "lodash": "^4.17.21",
-    "mongodb": "^6.19.0"
+    "mongodb": "^7.0.0"
   },
   "devDependencies": {
     "@types/async": "^3.2.25",
@@ -49,10 +50,10 @@
     "@types/jsonwebtoken": "^9.0.10",
     "@types/lodash": "^4.17.20",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.10.0",
-    "chai": "^6.0.1",
+    "@types/node": "^24.10.1",
+    "chai": "^6.2.1",
     "cross-env": "^10.1.0",
-    "mocha": "^11.7.4",
+    "mocha": "^11.7.5",
     "mongodb-memory-server": "^10.3.0",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",