feat: Experimental plugin support [v0.50.0] (#909)

* feat: initial plugin experiments

* feat(plugins): moving plugins into experimental

* feat(plugins): add global config override

* chore: update web-js version to published canary

* added support for export and init to plugins

* prevent caching to allow working with symlinks

* add fallback for route handlers

* improve typing, pass corect data and fix overrides not working

* chore: remove unused plugin loading and cleanup

* feat: add isRecipeInitialized method and enhance public config handling

* feat(multifactorauth): add getSecondaryFactors to multifactor recipe method and enhance error handling for plugin version mismatches and duplicates

* chore: revert changes with plugin config

* feat: add translations support

* feat: enhance public config handling with normalized app info and improve types

* webauthn fixes

* merge and build fixes

* refactor: remove appInfo from pluginConfig when overriding config

* feat: translation function to support key replacements

* feat: add WebAuthn credential management methods

* chore: test fixes

* fix: better version checking for plugins

* build fixes

* chore: err message fix

* refactor: unify SuperTokensPlugin type with web-js version for consistency

* chore: revert plugin type changes

* feat:  renamed `registerCredential` to `createCredential` and added `registerCredentialWithUser` method for user-specific credential registration

* chore: build updates

* fix: added missing exports

* improv: Add the ability to customize the footer for the captcha plugin

* fix: update build files

* refactor: revert noop change

* refactor: consistency fix

* chore: update web-js version

---------

Co-authored-by: Mihaly Lengyel <mihaly@lengyel.tech>
Co-authored-by: Victor Bojica <victor@niftylearning.io>
Co-authored-by: Bogdan Carpusor <bogdan@niftylearning.io>

Author: 4 people

.github/workflows/auth-react-test-1.yml

@@ -33,9 +33,9 @@ jobs:
             - uses: supertokens/actions/get-versions-from-repo@main
               id: node-versions
               with:
-                repo: supertokens-node
-                github-token: ${{ secrets.GITHUB_TOKEN }}
-                fdi-versions: ${{ steps.versions.outputs.fdiVersions }}
+                  repo: supertokens-node
+                  github-token: ${{ secrets.GITHUB_TOKEN }}
+                  fdi-versions: ${{ steps.versions.outputs.fdiVersions }}
 
     setup-auth-react:
         runs-on: ubuntu-latest
@@ -59,8 +59,8 @@ jobs:
         steps:
             - id: repo-versions
               run: |
-                nodeVersion=$( echo '${{ needs.define-versions.outputs.nodeFdiVersionMap }}' | jq -r '.["${{ matrix.fdi-version }}"]' )
-                echo "nodeVersion=${nodeVersion}" >> $GITHUB_OUTPUT
+                  nodeVersion=$( echo '${{ needs.define-versions.outputs.nodeFdiVersionMap }}' | jq -r '.["${{ matrix.fdi-version }}"]' )
+                  echo "nodeVersion=${nodeVersion}" >> $GITHUB_OUTPUT
 
             # We will use this in the test run to get the core version
             - uses: actions/checkout@v4

.github/workflows/auth-react-test-2.yml

@@ -80,17 +80,17 @@ jobs:
             - uses: supertokens/actions/get-versions-from-repo@main
               id: core-versions
               with:
-                repo: supertokens-core
-                github-token: ${{ secrets.GITHUB_TOKEN }}
-                cdi-versions: ${{ steps.node-cdi-versions.outputs.cdiVersions }}
+                  repo: supertokens-core
+                  github-token: ${{ secrets.GITHUB_TOKEN }}
+                  cdi-versions: ${{ steps.node-cdi-versions.outputs.cdiVersions }}
 
             - name: Get core version from latest Node CDI version
               id: core-version
               run: |
-                lastNodeCdiVersion=$(echo '${{ steps.node-cdi-versions.outputs.cdiVersions }}' | jq -r '.[-1]') | sed -e 's/"/\\"/g'
-                coreVersion=$(echo '${{ steps.core-versions.outputs.cdiVersions }}' | jq -r ".[$lastNodeCdiVersion]")
+                  lastNodeCdiVersion=$(echo '${{ steps.node-cdi-versions.outputs.cdiVersions }}' | jq -r '.[-1]') | sed -e 's/"/\\"/g'
+                  coreVersion=$(echo '${{ steps.core-versions.outputs.cdiVersions }}' | jq -r ".[$lastNodeCdiVersion]")
 
-                echo "coreVersion=${coreVersion}" >> $GITHUB_OUTPUT
+                  echo "coreVersion=${coreVersion}" >> $GITHUB_OUTPUT
 
             - name: Start core
               run: docker compose up --wait

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 -   Add WebAuthn credential management methods: `listCredentials`, `removeCredential`
 -   Added `createAndRegisterCredentialWithUser` method that creates and registers a credential with a user
 -   Adds dev/release GHA pipelines
+-   Adds experimental support for plugins
 
 ### Breaking changes