Develop

.github/actions/publish-website/action.yml

@@ -1,6 +1,9 @@
 name: "Publish website"
 description: "Publish website to web hosting"
 inputs:
+  image-name:
+    required: true
+    description: Mokapi image name
   username:
     required: true
     description: ftp username
@@ -18,14 +21,27 @@ runs:
   steps:
     - uses: actions/setup-node@v4
       with:
-        node-version: 20
+        node-version: 23.11.1
         registry-url: 'https://registry.npmjs.org'
     - id: release
       uses: pozetroninc/github-action-get-latest-release@master
       with:
         repository: marle3003/mokapi
         excludes: prerelease, draft
         token: ${{ inputs.token }}
+    - name: Run mokapi image
+      run: docker run --name mokapi --rm -d -p 80:80 -p 8080:8080 -p 9092:9092 -p 8389:8389 -p 8025:8025 --mount type=bind,source=$(pwd)/webui/scripts/dashboard-demo/demo-configs,target=/data --env MOKAPI_Providers_File_Directory=/data ${{ inputs.image-name }}
+      shell: bash
+    - name: Build Demo Dashboard
+      working-directory: ./webui/scripts/dashboard-demo
+      run: |
+        npm install
+        node ci.ts
+      shell: bash
+    - name: Stop Mokapi
+      if: always()
+      run: docker stop mokapi || true
+      shell: bash
     - name: build website
       working-directory: ./webui
       run: |

.github/actions/run-frontend-tests/action.yml

@@ -34,15 +34,15 @@ runs:
         npm ci
         npm run copy-docs
         npm run build-sitemap
-        npm run build
+        npm run build-dashboard
       shell: bash
     - name: Install Playwright
       working-directory: ./webui
       run: npx playwright install --with-deps
       shell: bash
     - name: Run your tests
       working-directory: ./webui
-      run: npx playwright test
+      run: npx playwright test --project=dashboard
       shell: bash
     - name: Upload test results
       if: always()
@@ -59,4 +59,8 @@ runs:
       uses: actions/upload-artifact@v4
       with:
         name: mokapi-test-logs
-        path: /var/tmp/mokapi.log
+        path: /var/tmp/mokapi.log
+    - name: Stop Mokapi
+      if: always()
+      run: docker stop mokapi || true
+      shell: bash

.github/workflows/alpha.yml

@@ -74,7 +74,7 @@ jobs:
     name: Publish website
     runs-on: ubuntu-latest
     if: "success()"
-    needs: [ build-alpha ]
+    needs: [ setup, build-alpha ]
     steps:
       - name: Check out code
         uses: actions/checkout@v4
@@ -84,6 +84,7 @@ jobs:
         uses: chetan/git-restore-mtime-action@v2
       - uses: ./.github/actions/publish-website
         with:
+          image-name: ${{ needs.setup.outputs.image-name }}
           username: ${{ secrets.FTP_USERNAME }}
           password: ${{ secrets.FTP_PASSWORD }}
           server: ${{ secrets.FTP_SERVER }}

.github/workflows/build.yml

@@ -12,7 +12,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v5
         with:
-          go-version: 1.25.1
+          go-version: 1.25.5
 
       - name: Check out code
         uses: actions/checkout@v4

.github/workflows/release.yml

@@ -26,7 +26,7 @@ jobs:
           password: ${{ secrets.DOCKER_PASSWORD }}
       - uses: actions/setup-go@v5
         with:
-          go-version: 1.25.1
+          go-version: 1.25.5
       - uses: actions/setup-node@v4
         with:
           node-version: 23
@@ -59,7 +59,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-go@v5
         with:
-          go-version: 1.25.1
+          go-version: 1.25.5
       - uses: actions/setup-node@v4
         with:
           node-version: 23

Taskfile.yml

@@ -33,7 +33,7 @@ tasks:
       - npm run clean
       - npm run copy-docs
       - npm version {{.VERSION}}
-      - npm run build
+      - npm run build-dashboard
   build-npm-package:
     deps: [build-vue-app]
     cmds:

api/handler_http.go

@@ -53,7 +53,7 @@ type param struct {
 	Required      bool           `json:"required"`
 	Deprecated    bool           `json:"deprecated"`
 	Style         string         `json:"style,omitempty"`
-	Exploded      bool           `json:"exploded"`
+	Explode       bool           `json:"explode"`
 	AllowReserved bool           `json:"allowReserved"`
 	Schema        *schema.Schema `json:"schema"`
 }
@@ -302,7 +302,7 @@ func getParameters(params openapi.Parameters) (result []param) {
 			Required:      p.Value.Required,
 			Deprecated:    p.Value.Deprecated,
 			Style:         p.Value.Style,
-			Exploded:      p.Value.IsExplode(),
+			Explode:       p.Value.IsExplode(),
 			AllowReserved: p.Value.AllowReserved,
 			Schema:        p.Value.Schema,
 		}

api/handler_http_test.go

@@ -119,7 +119,7 @@ func TestHandler_Http(t *testing.T) {
 				)
 			},
 			requestUrl:   "http://foo.api/api/services/http/foo",
-			responseBody: `{"name":"foo","servers":[{"url":"/","description":""}],"paths":[{"path":"/foo/{bar}","operations":[{"method":"get","deprecated":false,"parameters":[{"name":"bar","type":"path","required":true,"deprecated":false,"exploded":false,"allowReserved":false,"schema":{"type":"string"}}]}]}]`,
+			responseBody: `{"name":"foo","servers":[{"url":"/","description":""}],"paths":[{"path":"/foo/{bar}","operations":[{"method":"get","deprecated":false,"parameters":[{"name":"bar","type":"path","required":true,"deprecated":false,"explode":false,"allowReserved":false,"schema":{"type":"string"}}]}]}]`,
 		},
 		{
 			name: "get http service with requestBody",

docs/config.json

@@ -160,7 +160,7 @@
           "component": "examples",
           "hideNavigation": true,
           "hideInNavigation": true,
-          "canonical": "https://mokapi.io/docs/resources",
+          "canonical": "https://mokapi.io/docs/resources/tutorials",
           "title": "Explore Mokapi Resources: Tutorials, Examples, and Blog Articles",
           "description": "Explore Mokapi's resources including tutorials, examples, and blog articles. Learn to mock APIs, validate schemas, and streamline your development."
         },
@@ -182,7 +182,7 @@
           "component": "examples",
           "hideNavigation": true,
           "hideInNavigation": true,
-          "canonical": "https://mokapi.io/docs/resources",
+          "canonical": "https://mokapi.io/docs/resources/examples",
           "title": "Explore Mokapi Resources: Tutorials, Examples, and Blog Articles",
           "description": "Explore Mokapi's resources including tutorials, examples, and blog articles. Learn to mock APIs, validate schemas, and streamline your development."
         },
@@ -196,7 +196,7 @@
           "component": "examples",
           "hideNavigation": true,
           "hideInNavigation": true,
-          "canonical": "https://mokapi.io/docs/resources",
+          "canonical": "https://mokapi.io/docs/resources/blogs",
           "title": "Explore Mokapi Resources: Tutorials, Examples, and Blog Articles",
           "description": "Explore Mokapi's resources including tutorials, examples, and blog articles. Learn to mock APIs, validate schemas, and streamline your development."
         },

docs/guides/mail/overview.md

@@ -237,11 +237,12 @@ folders:
 
 The settings object defines global configuration options that influence server behavior.
 
-| Field Name        | Type    | Default | Description                                                                                                                                                                                        |
-|-------------------|---------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| maxRecipients     | integer | 0       | (Optional) Maximum number of recipients per email. Use 0 for unlimited.                                                                                                                            |
-| autoCreateMailbox | boolean | true    | (Optional) Allow create mailboxes at runtime.                                                                                                                                                      |
-| maxInboxMails     | integer | 100     | (Optional) Maximum number of messages kept in the INBOX folder. Oldest mails are removed when the limit is exceeded. Use 0 to disable the limit and store messages indefinitely (not recommended). |
+| Field Name            | Type    | Default | Description                                                                                                                                                                                        |
+|-----------------------|---------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| maxRecipients         | integer | 0       | (Optional) Maximum number of recipients per email. Use 0 for unlimited.                                                                                                                            |
+| autoCreateMailbox     | boolean | true    | (Optional) Allow create mailboxes at runtime.                                                                                                                                                      |
+| maxInboxMails         | integer | 100     | (Optional) Maximum number of messages kept in the INBOX folder. Oldest mails are removed when the limit is exceeded. Use 0 to disable the limit and store messages indefinitely (not recommended). |
+| AllowUnknownSenders   | boolean | true    | (Optional) If true, the server accepts any MAIL FROM: address, even if it’s not listed in the mailboxes: configuration.                                                                            |
 
 ##### Mailbox Object Example
 

docs/javascript-api/modules.md

@@ -10,9 +10,10 @@ Mokapi supports importing three types of modules:
 - **Built-in modules**: Provided by Mokapi for various functionalities.
 - **Local filesystem modules**: Custom scripts and Node.js packages.
 - **JSON & YAML modules**: Configuration files converted into JavaScript objects.
+- **Remote modules**: Hosted on a web server or CDN
 
 ``` box=tip
-Mokapi monitors all imported modules with `fsnotify`. If a module is modified, any dependent script is automatically reloaded.
+Mokapi monitors all imported modules with `fsnotify`. If a module is modified, any dependent script that contains a `default` export is automatically reloaded.
 ```
 
 ## Built-in Modules
@@ -26,7 +27,7 @@ import { fake } from 'mokapi/faker'
 
 ## Local Filesystem Modules
 
-You can import files using relative or absolute paths, and Mokapi supports Node.js modules.
+Import files using relative or absolute paths. Node.js resolution rules are supported.
 
 ```javascript
 import { someFunc } from './helpers.js'
@@ -36,7 +37,7 @@ import dateTime from 'date-time' // Requires: npm install date-time
 
 ## JSON & YAML Modules
 
-Mokapi allows importing JSON and YAML files, automatically converting them into JavaScript objects.
+JSON and YAML files can be imported and converted automatically to objects:
 
 ```javascript tab=Javascript
 import users from './users.json'
@@ -57,4 +58,15 @@ console.log(envs[0])
 - production
 ```
 
+## Remote Modules
+
+Modules can also be hosted remotely on public web servers, GitHub, or CDNs.
+
+```js
+import { helper } from 'https://example.com/mokapi-helpers.js'
+```
+
+- Mokapi uses its [HTTP provider](/docs/configuration/dynamic/http.md) to load remote modules
+- This allows dynamic updates without restarting Mokapi
+
 By leveraging these module types, you can create flexible, maintainable, and scalable Mokapi scripts.

docs/javascript-api/mokapi/cron.md

@@ -6,9 +6,10 @@ description: Schedules a new periodic job using cron expression.
 
 Schedules a new periodic job using cron expression. 
 
-``` box=info
-By default, the first execution happens immediately, check ScheduledEventArgs
-```
+### Behavior
+
+- By default, **cron jobs wait for the first scheduled tick** before executing.
+- To run the job immediately on creation, set `SkipImmediateFirstRun: false` in `args`.
 
 ## Parameters
 

docs/javascript-api/mokapi/eventhandler/scheduledeventargs.md

@@ -7,11 +7,11 @@ description: ScheduledEventArgs is an object used by every and cron function.
 ScheduledEventArgs is an object used by [every](/docs/javascript-api/mokapi/every.md) and
 [cron](/docs/javascript-api/mokapi/cron.md) function.
 
-| Name                  | Type    | Description                                                                                                                     |
-|-----------------------|---------|---------------------------------------------------------------------------------------------------------------------------------|
-| times                 | number  | Defines the number of times the scheduled function is executed.                                                                 |
-| skipImmediateFirstRun | boolean | Toggles behavior of first execution. If true job does not start immediately but rather wait until the first scheduled interval. |
-| tags                  | object  | Adds or overrides existing tags used in dashboard                                                                               |
+| Name                  | Type     | Default | Description                                                                                                                     |
+|-----------------------|----------|---------|---------------------------------------------------------------------------------------------------------------------------------|
+| times                 | number   | -1      | How many times the job should execute (-1 for unlimited).                                                                       |
+| skipImmediateFirstRun | boolean  |         | Toggles behavior of first execution. If true job does not start immediately but rather wait until the first scheduled interval. |
+| tags                  | object   | {}      | Optional tags for identifying the job.                                                                                          |
 
 ## Examples
 

docs/javascript-api/mokapi/every.md

@@ -8,15 +8,16 @@ Schedules a new periodic job with an interval. Interval string
 is a possibly signed sequence of decimal numbers, each with 
 optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m".
 
-``` box=info
-By default, the first execution happens immediately, check ScheduledEventArgs
-```
+### Behavior
+
+- By default, **`every` jobs run immediately**, then repeat according to the interval.
+- To skip the immediate run, set `SkipImmediateFirstRun: true` in `args`.
 
 | Parameter       | Type     | Description                                                                                                                      |
 |-----------------|----------|----------------------------------------------------------------------------------------------------------------------------------|
 | interval        | string   | Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".                                                                  |
 | handler         | function | The handler function to be executed every `interval`. By default, the first execution happens immediately.                       |
-| args (optional) | object   | [ScheduledEventArgs](/docs/javascript-api/mokapi/eventhandler/scheduledeventargs.md) object contains additional event arguments. | 
+| args (optional) | object   | [ScheduledEventArgs](/docs/javascript-api/mokapi/eventhandler/scheduledeventargs.md) object contains additional event arguments. |
 
 ## Example