feat: initial release of @asgardeo/javascript, @asgardeo/browser, @asgardeo/react, @asgardeo/node & @asgardeo/nextjs

.changeset/big-parrots-sleep.md

@@ -0,0 +1,9 @@
+---
+'@asgardeo/javascript': patch
+'@asgardeo/browser': patch
+'@asgardeo/nextjs': patch
+'@asgardeo/node': patch
+'@asgardeo/react': minor
+---
+
+Initial release with basic redirection capabilities and components.

.changeset/config.json

@@ -1,15 +1,24 @@
 {
-  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
-  "changelog": ["@changesets/changelog-github", { "repo": "asgardeo/web-ui-sdks" }],
+  "$schema": "https://unpkg.com/@changesets/config@2.2.0/schema.json",
+  "access": "restricted",
+  "baseBranch": "main",
+  "changelog": [
+    "@changesets/changelog-github",
+    {
+      "repo": "asgardeo/javascript"
+    }
+  ],
   "commit": false,
   "fixed": [],
+  "ignore": [],
   "linked": [],
-  "access": "restricted",
-  "baseBranch": "main",
   "privatePackages": {
-    "version": true,
-    "tag": true
+    "version": false,
+    "tag": false
+  },
+  "root": {
+    "packageDir": "."
   },
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}
+  "tagFormat": "@<scope>/<package>@${version}",
+  "updateInternalDependencies": "patch"
+}

.eslintrc.js → .eslintrc.cjs

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com).
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
  *
  * WSO2 LLC. licenses this file to you under the Apache License,
  * Version 2.0 (the "License"); you may not use this file except

.github/workflows/pr-builder.yml

@@ -118,6 +118,10 @@ jobs:
       - name: 🧩 Install Dependencies
         id: install-dependencies
         run: pnpm install
+
+      - name: 🏗️ Build
+        id: build
+        run: pnpm build
 
       - name: ☄️ Check Type Errors
         run: pnpm nx affected --target=typecheck --parallel=3 --base=${{ env.NX_BASE }} --head=${{ env.NX_HEAD }}
@@ -166,6 +170,10 @@ jobs:
       - name: 🧩 Install Dependencies
         id: install-dependencies
         run: pnpm install
+
+      - name: 🏗️ Build
+        id: build
+        run: pnpm build
 
       - name: 🃏 Run Jest & Collect Coverage
         id: run-jest-test-and-coverage

.gitignore

@@ -1,9 +1,9 @@
-# See http://help.github.com/ignore-files/ for more about ignoring files.
+# See https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files for more about ignoring files.
 
 # compiled output
 dist
 tmp
-/out-tsc
+out-tsc
 
 # dependencies
 node_modules
@@ -38,5 +38,9 @@ testem.log
 .DS_Store
 Thumbs.db
 
-# Nx
 .nx/cache
+.nx/workspace-data
+
+# Environment files
+*.env
+.env*

.prettierignore

@@ -4,3 +4,5 @@
 /build
 /node_modules
 /coverage
+/.nx/cache
+/.nx/workspace-data

.vscode/settings.json

@@ -17,5 +17,6 @@
         "css",
         "scss"
     ],
-    "typescript.tsdk": "node_modules/typescript/lib"
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "editor.formatOnSave": true
 }

README.md

@@ -3,16 +3,15 @@
     src="https://github.com/asgardeo/web-ui-sdks/assets/25959096/ae77b70c-6570-40b1-a723-719abd0f7d02" alt="Asgardeo Logo" height="40" width="auto"
   >
   <h1 align="center">
-    Web SDKs
+    Asgardeo JavaScript SDKs
   </h1>
 </p>
 <p align="center" style="font-size: 1.2rem;">
-  Web SDKs for building customizable UIs for <a href="https://wso2.com/asgardeo">Asgardeo</a> & <a href="https://wso2.com/identity-server/">WSO2 Identity Server</a>
+  JavaScript SDKs for building applications with <a href="https://wso2.com/asgardeo">Asgardeo</a>
 </p>
 
 <div align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
-  <!-- <a href="https://github.com/asgardeo/web-ui-sdks/actions/workflows/build.yml"><img src="https://github.com/asgardeo/web-ui-sdks/actions/workflows/build.yml/badge.svg" alt="🐳 Build"></a> -->
   <a href="https://github.com/asgardeo/web-ui-sdks/actions/workflows/release.yml"><img src="https://github.com/asgardeo/web-ui-sdks/actions/workflows/release.yml/badge.svg" alt="🚀 Release"></a>
 
   <br>
@@ -21,7 +20,7 @@
 
 <br>
 
-This repository contains the source code of the different Web SDKs that can be used to build customizable UIs for Asgardeo and WSO2 Identity Server. If you have any questions, please reach out to us through one of the following channels:
+This repository contains the source code of JavaScript SDKs that can be used to build applications integrated with Asgardeo. If you have any questions, please reach out to us through one of the following channels:
 
 [![Stackoverflow](https://img.shields.io/badge/Ask%20for%20help%20on-Stackoverflow-orange)](https://stackoverflow.com/questions/tagged/wso2is)
 [![Join the chat at https://discord.gg/wso2](https://img.shields.io/badge/Join%20us%20on-Discord-%23e01563.svg)](https://discord.gg/wso2)
@@ -31,16 +30,21 @@ This repository contains the source code of the different Web SDKs that can be u
 
 | Package | Description |
 | --- | --- |
-| [![@asgardeo/js](https://img.shields.io/npm/v/@asgardeo/js?color=%234B32C3&label=%40asgardeo%2Fjs&logo=javascript)](./packages/core/) | Framework-agnostic JavaScript Core SDK |
-| [![@asgardeo/react](https://img.shields.io/npm/v/@asgardeo/react?color=%23F7B93E&label=%40asgardeo%2Freact&logo=react)](./packages/react/) | React SDK for building customizable UIs for React applications |
+| [![@asgardeo/javascript](https://img.shields.io/npm/v/@asgardeo/javascript?color=%234B32C3&label=%40asgardeo%2Fjavascript&logo=javascript)](./packages/javascript/) | Framework-agnostic JavaScript Core SDK |
+| [![@asgardeo/browser](https://img.shields.io/npm/v/@asgardeo/browser?color=%234B32C3&label=%40asgardeo%2Fbrowser&logo=firefox)](./packages/browser/) | Browser-based JavaScript SDK |
+| [![@asgardeo/nextjs](https://img.shields.io/npm/v/@asgardeo/nextjs?color=%23000000&label=%40asgardeo%2Fnext&logo=next.js)](./packages/next/) | Next.js SDK for building applications with Asgardeo |
+| [![@asgardeo/node](https://img.shields.io/npm/v/@asgardeo/node?color=%23339933&label=%40asgardeo%2Fnode&logo=node.js)](./packages/node/) | Node.js SDK for server-side integration |
+| [![@asgardeo/nuxt](https://img.shields.io/npm/v/@asgardeo/nuxt?color=%2300DC82&label=%40asgardeo%2Fnuxt&logo=nuxt)](./packages/nuxt/) | Nuxt.js SDK for building applications with Asgardeo |
+| [![@asgardeo/react](https://img.shields.io/npm/v/@asgardeo/react?color=%2361DAFB&label=%40asgardeo%2Freact&logo=react)](./packages/react/) | React SDK for building applications with Asgardeo |
+| [![@asgardeo/vue](https://img.shields.io/npm/v/@asgardeo/vue?color=%234FC08D&label=%40asgardeo%2Fvue&logo=vue.js)](./packages/vue/) | Vue.js SDK for building applications with Asgardeo |
 
 ## Contribute
-Please read [Contributing Guide](CONTRIBUTING.md) for details on how to contribute to Asgardeo web UI SDKs. Refer to [General Contribution Guidelines](http://wso2.github.io/) for details on our code of conduct, and the process for submitting pull requests to us.
+Please read [Contributing Guide](CONTRIBUTING.md) for details on how to contribute to Asgardeo JavaScript SDKs. Refer to [General Contribution Guidelines](http://wso2.github.io/) for details on our code of conduct, and the process for submitting pull requests to us.
 
 ### Reporting issues
 We encourage you to report issues, improvements, and feature requests creating [Github Issues](https://github.com/asgardeo/web-ui-sdks/issues).
 
-**Important**: Please be advised that security issues MUST be reported to <a href="mailto:security@wso2.com">security@wso2com</a>, not as GitHub issues, in order to reach the proper audience. We strongly advise following the WSO2 Security Vulnerability Reporting Guidelines when reporting the security issues.
+**Important**: Please be advised that security issues MUST be reported to <a href="mailto:security@wso2.com">security@wso2.com</a>, not as GitHub issues, in order to reach the proper audience. We strongly advise following the WSO2 Security Vulnerability Reporting Guidelines when reporting the security issues.
 
 ## License
 This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.

nx.json

@@ -1,4 +1,26 @@
 {
-  "extends": "nx/presets/npm.json",
-  "$schema": "./node_modules/nx/schemas/nx-schema.json"
-}
+  "$schema": "./node_modules/nx/schemas/nx-schema.json",
+  "namedInputs": {
+    "default": [
+      "{projectRoot}/**/*",
+      "sharedGlobals"
+    ],
+    "production": [
+      "default"
+    ],
+    "sharedGlobals": []
+  },
+  "targetDefaults": {
+    "build": {
+      "dependsOn": [
+        "^build"
+      ]
+    },
+    "typecheck": {
+      "dependsOn": [
+        "^build"
+      ]
+    }
+  },
+  "plugins": []
+}

package.json

@@ -1,52 +1,42 @@
 {
   "private": true,
-  "name": "@asgardeo/web-ui-sdks",
-  "version": "0.1.0",
-  "description": "Web SDKs for building customizable login UIs for Asgardeo & WSO2 Identity Server.",
+  "name": "@asgardeo/javascript-workspace",
+  "version": "0.0.0",
+  "description": "Workspace to hold the Asgardeo JavaScript SDKs.",
   "author": "WSO2",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/asgardeo/web-ui-sdks#readme",
+  "homepage": "https://github.com/asgardeo/javascript#readme",
   "bugs": {
-    "url": "https://github.com/asgardeo/web-ui-sdks/issues"
+    "url": "https://github.com/asgardeo/javascript/issues"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/asgardeo/web-ui-sdks"
+    "url": "https://github.com/asgardeo/javascript"
   },
   "keywords": [
     "asgardeo",
-    "web-sdks",
-    "api-based-auth"
+    "javascript",
+    "workspace"
   ],
   "scripts": {
-    "build": "nx run-many --target=build --parallel --projects=@asgardeo/js,@asgardeo/react",
-    "changeset": "changeset",
-    "lint": "nx run-many --target=lint --parallel",
+    "build": "nx run-many --target=build --all",
+    "fix:lint": "nx run-many --target=fix:lint --all --parallel",
+    "lint": "nx run-many --target=lint --all --parallel",
     "publish:packages": "changeset publish",
-    "test": "nx run-many --target=test --parallel",
-    "typecheck": "nx run-many --target=typecheck --parallel",
+    "test": "nx run-many --target=test --all --parallel",
     "version:packages": "changeset version && pnpm install --lockfile-only"
   },
   "devDependencies": {
-    "@changesets/changelog-github": "^0.5.0",
-    "@changesets/cli": "^2.27.3",
+    "@changesets/changelog-github": "^0.5.1",
+    "@changesets/cli": "^2.29.4",
     "@wso2/eslint-plugin": "catalog:",
     "@wso2/prettier-config": "catalog:",
-    "eslint": "catalog:",
-    "nx": "18.2.4",
-    "prettier": "^3.2.5",
-    "typescript": "5.1.6"
-  },
-  "workspaces": [
-    "packages/*",
-    "recipes/*"
-  ],
-  "engines": {
-    "node": ">=18",
-    "pnpm": ">=9"
+    "eslint": "8.57.0",
+    "nx": "20.8.1",
+    "prettier": "^2.6.2",
+    "typescript": "~5.7.2"
   },
   "publishConfig": {
     "access": "restricted"
-  },
-  "packageManager": "pnpm@10.8.0+sha512.0e82714d1b5b43c74610193cb20734897c1d00de89d0e18420aebc5977fa13d780a9cb05734624e81ebd81cc876cd464794850641c48b9544326b5622ca29971"
-}
+  }
+}

packages/core/package.json → packages/__legacy__/core/package.json

@@ -1,5 +1,6 @@
 {
-  "name": "@asgardeo/js",
+  "private": true,
+  "name": "@asgardeo/js-legacy",
   "version": "0.1.3",
   "description": "Framework agnostic JS for Asgardeo or Identity Server",
   "main": "dist/esm/index.js",
@@ -43,15 +44,15 @@
     "@types/node": "^20.12.7",
     "@wso2/eslint-plugin": "catalog:",
     "@wso2/prettier-config": "catalog:",
-    "eslint": "catalog:",
+    "eslint": "8.57.0",
     "prettier": "^3.2.5",
     "rollup": "^4.17.2",
     "rollup-plugin-dts": "^6.1.0",
     "tslib": "^2.6.2",
     "typescript": "5.1.6"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "restricted"
   },
   "dependencies": {
     "@asgardeo/auth-js": "^5.0.1",

packages/core/src/api/sign-out.ts → packages/__legacy__/core/src/api/sign-out.ts

@@ -51,7 +51,7 @@ const signOut = async (): Promise<void> => {
   try {
     formBody.append('id_token_hint', await authClient.getIDToken());
     formBody.append('client_id', (await authClient.getDataLayer().getConfigData()).clientID);
-    formBody.append('response_mode', ResponseMode.direct);
+    formBody.append('response_mode', ResponseMode.Direct);
   } catch (error) {
     throw new AsgardeoUIException('JS_UI_CORE-SIGNOUT-SO-IV', 'Failed to build the body of the signout request.');
   }

packages/core/src/auth-client.ts → packages/__legacy__/core/src/auth-client.ts

@@ -16,7 +16,7 @@
  * under the License.
  */
 
-import {AsgardeoAuthClient, Store, CryptoUtils, ResponseMode} from '@asgardeo/auth-js';
+import {AsgardeoAuthClient, Store, Crypto, ResponseMode} from '@asgardeo/auth-js';
 import {UIAuthClient, UIAuthConfig} from './models/auth-config';
 import {BrandingPreferenceTypes} from './models/branding-api-response';
 
@@ -38,10 +38,10 @@ export class AuthClient {
    *
    * @param {UIAuthConfig} authClientConfig - The configuration for the `UIAuthClient`.
    * @param {Store} store - The store for the `UIAuthClient`.
-   * @param {CryptoUtils} cryptoUtils - The crypto utilities for the `UIAuthClient`.
+   * @param {Crypto} cryptoUtils - The crypto utilities for the `UIAuthClient`.
    * @returns {UIAuthClient} The singleton instance of `UIAuthClient`.
    */
-  static getInstance(authClientConfig?: UIAuthConfig, store?: Store, cryptoUtils?: CryptoUtils): UIAuthClient {
+  static getInstance(authClientConfig?: UIAuthConfig, store?: Store, cryptoUtils?: Crypto): UIAuthClient {
     if (!AuthClient.instance) {
       const DEFAULT_NAME: string = 'carbon.super';
 
@@ -50,7 +50,7 @@ export class AuthClient {
         enableConsoleBranding: authClientConfig?.enableConsoleBranding ?? true,
         enableConsoleTextBranding: authClientConfig?.enableConsoleTextBranding ?? true,
         name: authClientConfig?.name ?? DEFAULT_NAME,
-        responseMode: ResponseMode.direct,
+        responseMode: ResponseMode.Direct,
         type: authClientConfig?.type ?? BrandingPreferenceTypes.Org,
       };
 
@@ -63,4 +63,4 @@ export class AuthClient {
 }
 
 /* Interfaces, classes and enums required from the auth-js package */
-export {CryptoUtils, JWKInterface, Store, AsgardeoAuthClient, TokenResponse, ResponseMode} from '@asgardeo/auth-js';
+export {Crypto, JWKInterface, Store, AsgardeoAuthClient, TokenResponse, ResponseMode} from '@asgardeo/auth-js';

packages/__legacy__/react/.editorconfig

@@ -0,0 +1 @@
+../../.editorconfig

packages/__legacy__/react/.eslintignore

@@ -0,0 +1,2 @@
+/dist
+/node_modules

packages/__legacy__/react/.eslintrc.cjs

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+const path = require('path');
+
+module.exports = {
+  extends: [
+    'plugin:@wso2/typescript',
+    'plugin:@wso2/react',
+    'plugin:@wso2/strict',
+    'plugin:@wso2/internal',
+    'plugin:@wso2/prettier',
+    'plugin:@wso2/jest',
+    'plugin:react/jsx-runtime',
+  ],
+  parserOptions: {
+    project: [path.resolve(__dirname, 'tsconfig.lib.json'), path.resolve(__dirname, 'tsconfig.eslint.json')],
+  },
+  plugins: ['@wso2'],
+  rules: {
+    // In `SignIn.tsx` we are using non dot notation to access the object properties.
+    // TODO: Refactor the code to use dot notation.
+    '@typescript-eslint/dot-notation': 'off',
+    // We are throwing custom exceptions in the codebase.
+    // Hence, turning this off to avoid linting errors. (https://eslint.org/docs/latest/rules/no-throw-literal#known-limitations)
+    '@typescript-eslint/no-throw-literal': 'off',
+    // TODO: Fix this and enable.
+    // Occurred while linting /packages/react/src/utils/crypto-utils.ts:33
+    // Rule: "@typescript-eslint/no-useless-constructor"
+    '@typescript-eslint/no-useless-constructor': 'off',
+    'class-methods-use-this': 'off',
+  },
+};