@mulverse/mulguard-core 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,70 @@
+
+---
+
+**Mulverse M.U.V GENERAL PUBLIC LICENSE**
+
+**Version 1.0**
+
+**Copyright (C) [2022] Mulverse Inc.**
+
+**1. Definitions**
+
+1.1 **"Software"** refers to the Mulverse software distributed under this license, including all associated files, documentation, and any updates or modifications.
+
+1.2 **"You"** means the individual or entity who receives or uses the Software.
+
+1.3 **"Distribution"** refers to any form of sharing or redistribution of the Software, including copies or derivative works.
+
+**2. Permissions**
+
+2.1 **Use**: You are granted the right to use the Software for any purpose.
+
+2.2 **Copy and Distribution**: You may distribute copies of the Software, either in its original form or as modified, provided that all copies include the same license terms.
+
+2.3 **Modification**: You may modify the Software and distribute the modified versions, provided that the modified Software is also licensed under this Mulverse M.U.V General Public License and that you include a prominent notice stating the changes made.
+
+**3. Copyleft**
+
+3.1 **Source Code**: If you distribute the Software or any derivative works, you must either include the source code or make it available in a manner specified by this license.
+
+3.2 **License Continuity**: All copies and derivative works of the Software must be distributed under the terms of this Mulverse M.U.V General Public License. You must include a copy of this license with all distributions.
+
+**4. Conditions**
+
+4.1 **Attribution**: You must provide appropriate credit to Mulverse Inc., including a notice that the Software is licensed under the Mulverse M.U.V General Public License.
+
+4.2 **No Warranty**: The Software is provided "as is," without any warranty of any kind. Mulverse Inc. disclaims all warranties and conditions, including but not limited to implied warranties of merchantability and fitness for a particular purpose.
+
+4.3 **No Additional Restrictions**: You may not impose any additional restrictions on the rights granted by this license. This includes, but is not limited to, additional licenses or agreements.
+
+**5. Termination**
+
+5.1 **Automatic Termination**: If you breach any of the terms of this license, your rights under this license will be terminated automatically.
+
+5.2 **Reinstatement**: You may be reinstated if you cure the breach and notify Mulverse Inc. of the cure within 30 days of the termination.
+
+**6. Patent Grant**
+
+6.1 **Patent License**: You grant to Mulverse Inc. a non-exclusive, royalty-free license to any patents you may hold that are necessary to use the Software.
+
+**7. Indemnity**
+
+7.1 **Indemnification**: You agree to indemnify and hold Mulverse Inc. harmless from any claims, damages, or liabilities arising from your use or distribution of the Software.
+
+**8. Governing Law**
+
+8.1 **Jurisdiction**: This license shall be governed by and construed in accordance with the laws of [Your Jurisdiction].
+
+**9. Miscellaneous**
+
+9.1 **Severability**: If any provision of this license is held to be invalid or unenforceable, the remaining provisions will remain in effect.
+
+9.2 **Entire Agreement**: This license constitutes the entire agreement between you and Mulverse Inc. regarding the Software and supersedes all prior agreements and understandings.
+
+**10. Contact**
+
+10.1 **Inquiries**: For any questions or concerns regarding this license, please contact Mulverse Inc. at [Contact Information].
+
+**End of License**
+
+---

package/adapters/server-actions-helpers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Helper functions for Server Actions Adapter
+ *
+ * This module provides utilities to convert server actions into adapter format
+ * and handle server action responses.
+ */
+import type { Adapter, ServerActionsAdapter } from "../adapters.js";
+/**
+ * Creates an Adapter from Server Actions Adapter.
+ * This function wraps server actions to match the Adapter interface.
+ *
+ * @param serverActions - The server actions adapter configuration
+ * @returns An Adapter instance that uses the provided server actions
+ *
+ * @example
+ * ```ts
+ * const adapter = createServerActionsAdapter({
+ *   getUser: async (id) => {
+ *     const user = await getProfileApiV1AuthMeGet()
+ *     return transformToAdapterUser(user)
+ *   },
+ * })
+ * ```
+ */
+export declare function createServerActionsAdapter(serverActions: ServerActionsAdapter): Adapter;
+/**
+ * Checks if a Server Actions Adapter has all required methods for a specific feature.
+ *
+ * @param serverActions - The server actions adapter to check
+ * @param requiredMethods - Array of method names that are required
+ * @returns True if all required methods are present, false otherwise
+ */
+export declare function hasRequiredServerActions(serverActions: ServerActionsAdapter, requiredMethods: (keyof ServerActionsAdapter)[]): boolean;
+//# sourceMappingURL=server-actions-helpers.d.ts.map

package/adapters/server-actions-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-actions-helpers.d.ts","sourceRoot":"","sources":["../src/adapters/server-actions-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAGnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,oBAAoB,GAClC,OAAO,CAiFT;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,oBAAoB,EACnC,eAAe,EAAE,CAAC,MAAM,oBAAoB,CAAC,EAAE,GAC9C,OAAO,CAET"}

package/adapters/server-actions-helpers.js

@@ -0,0 +1,95 @@
+/**
+ * Helper functions for Server Actions Adapter
+ *
+ * This module provides utilities to convert server actions into adapter format
+ * and handle server action responses.
+ */
+/**
+ * Creates an Adapter from Server Actions Adapter.
+ * This function wraps server actions to match the Adapter interface.
+ *
+ * @param serverActions - The server actions adapter configuration
+ * @returns An Adapter instance that uses the provided server actions
+ *
+ * @example
+ * ```ts
+ * const adapter = createServerActionsAdapter({
+ *   getUser: async (id) => {
+ *     const user = await getProfileApiV1AuthMeGet()
+ *     return transformToAdapterUser(user)
+ *   },
+ * })
+ * ```
+ */
+export function createServerActionsAdapter(serverActions) {
+    const adapter = {};
+    // Map all server action methods to adapter methods
+    if (serverActions.createUser) {
+        adapter.createUser = serverActions.createUser;
+    }
+    if (serverActions.getUser) {
+        adapter.getUser = serverActions.getUser;
+    }
+    if (serverActions.getUserByEmail) {
+        adapter.getUserByEmail = serverActions.getUserByEmail;
+    }
+    if (serverActions.getUserByAccount) {
+        adapter.getUserByAccount = serverActions.getUserByAccount;
+    }
+    if (serverActions.updateUser) {
+        adapter.updateUser = serverActions.updateUser;
+    }
+    if (serverActions.deleteUser) {
+        adapter.deleteUser = serverActions.deleteUser;
+    }
+    if (serverActions.linkAccount) {
+        adapter.linkAccount = serverActions.linkAccount;
+    }
+    if (serverActions.unlinkAccount) {
+        adapter.unlinkAccount = serverActions.unlinkAccount;
+    }
+    if (serverActions.createSession) {
+        adapter.createSession = serverActions.createSession;
+    }
+    if (serverActions.getSessionAndUser) {
+        adapter.getSessionAndUser = serverActions.getSessionAndUser;
+    }
+    if (serverActions.updateSession) {
+        adapter.updateSession = serverActions.updateSession;
+    }
+    if (serverActions.deleteSession) {
+        adapter.deleteSession = serverActions.deleteSession;
+    }
+    if (serverActions.createVerificationToken) {
+        adapter.createVerificationToken = serverActions.createVerificationToken;
+    }
+    if (serverActions.useVerificationToken) {
+        adapter.useVerificationToken = serverActions.useVerificationToken;
+    }
+    if (serverActions.getAccount) {
+        adapter.getAccount = serverActions.getAccount;
+    }
+    if (serverActions.getAuthenticator) {
+        adapter.getAuthenticator = serverActions.getAuthenticator;
+    }
+    if (serverActions.createAuthenticator) {
+        adapter.createAuthenticator = serverActions.createAuthenticator;
+    }
+    if (serverActions.listAuthenticatorsByUserId) {
+        adapter.listAuthenticatorsByUserId = serverActions.listAuthenticatorsByUserId;
+    }
+    if (serverActions.updateAuthenticatorCounter) {
+        adapter.updateAuthenticatorCounter = serverActions.updateAuthenticatorCounter;
+    }
+    return adapter;
+}
+/**
+ * Checks if a Server Actions Adapter has all required methods for a specific feature.
+ *
+ * @param serverActions - The server actions adapter to check
+ * @param requiredMethods - Array of method names that are required
+ * @returns True if all required methods are present, false otherwise
+ */
+export function hasRequiredServerActions(serverActions, requiredMethods) {
+    return requiredMethods.every((method) => method in serverActions && serverActions[method] !== undefined);
+}

package/package.json

@@ -1,118 +1,119 @@
-{
-  "name": "@mulverse/mulguard-core",
-  "version": "1.0.0",
-  "description": "Authentication for the Web with Backend-First Architecture.",
-  "keywords": [
-    "authentication",
-    "mulguard",
-    "backend-first",
-    "frontend-first",
-    "mulverse",
-    "jwt",
-    "oauth",
-    "oidc",
-    "passwordless",
-    "standard",
-    "vanilla",
-    "webapi"
-  ],
-  "homepage": "https://mulverse.com/packages/mulguard-core",
-  "repository": "https://github.com/mulverse/mulverse.git",
-  "author": "Mohamed Alhabob <info@mulverse.com>",
-  "contributors": [
-    "Mohamed Alhabob <info@mulverse.com>"
-  ],
-  "type": "module",
-  "types": "./index.d.ts",
-  "files": [
-    "*.js",
-    "*.d.ts*",
-    "lib",
-    "providers",
-    "src"
-  ],
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./index.js",
-      "default": "./index.js"
-    },
-    "./adapters": {
-      "types": "./adapters.d.ts",
-      "import": "./adapters.js",
-      "default": "./adapters.js"
-    },
-    "./errors": {
-      "types": "./errors.d.ts",
-      "import": "./errors.js",
-      "default": "./errors.js"
-    },
-    "./jwt": {
-      "types": "./jwt.d.ts",
-      "import": "./jwt.js",
-      "default": "./jwt.js"
-    },
-    "./providers": {
-      "types": "./providers/index.d.ts"
-    },
-    "./providers/*": {
-      "types": "./providers/*.d.ts",
-      "import": "./providers/*.js",
-      "default": "./providers/*.js"
-    },
-    "./types": {
-      "types": "./types.d.ts"
-    }
-  },
-  "license": "ISC",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "dependencies": {
-    "@panva/hkdf": "^1.2.1",
-    "jose": "^6.0.6",
-    "oauth4webapi": "^3.3.0",
-    "preact": "10.24.3",
-    "preact-render-to-string": "6.5.11"
-  },
-  "peerDependencies": {
-    "@simplewebauthn/browser": "^9.0.1",
-    "@simplewebauthn/server": "^9.0.2",
-    "nodemailer": "^7.0.7"
-  },
-  "peerDependenciesMeta": {
-    "@simplewebauthn/browser": {
-      "optional": true
-    },
-    "@simplewebauthn/server": {
-      "optional": true
-    },
-    "nodemailer": {
-      "optional": true
-    }
-  },
-  "scripts": {
-    "build": "pnpm css && pnpm providers && node ../../node_modules/.pnpm/typescript@5.2.2/node_modules/typescript/bin/tsc",
-    "clean": "node -e \"const fs = require('fs'); ['*.js', '*.d.ts*', 'lib', 'providers'].forEach(p => { try { if (fs.existsSync(p)) fs.rmSync(p, {recursive: true, force: true}); } catch(e) {} });\"",
-    "css": "node scripts/generate-css",
-    "dev": "pnpm css && pnpm providers && tsc -w",
-    "test": "vitest run -c ../utils/vitest.config.ts",
-    "test:watch": "vitest -c ../utils/vitest.config.ts",
-    "providers": "node scripts/generate-providers"
-  },
-  "devDependencies": {
-    "@simplewebauthn/browser": "9.0.1",
-    "@simplewebauthn/server": "9.0.3",
-    "@simplewebauthn/types": "^9.0.1",
-    "@types/node": "18.11.10",
-    "@types/nodemailer": "6.4.6",
-    "@types/react": "18.0.37",
-    "autoprefixer": "10.4.13",
-    "postcss": "8.4.19",
-    "postcss-nesting": "^12.1.5",
-    "typedoc": "^0.25.12",
-    "typedoc-plugin-markdown": "4.0.0-next.53",
-    "typescript": "5.3.3"
-  }
-}
+{
+  "name": "@mulverse/mulguard-core",
+  "version": "1.0.2",
+  "description": "Authentication for the Web with Backend-First Architecture.",
+  "keywords": [
+    "authentication",
+    "mulguard",
+    "backend-first",
+    "frontend-first",
+    "mulverse",
+    "jwt",
+    "oauth",
+    "oidc",
+    "passwordless",
+    "standard",
+    "vanilla",
+    "webapi"
+  ],
+  "homepage": "https://mulverse.com/packages/mulguard-core",
+  "repository": "https://github.com/mulverse/mulverse.git",
+  "author": "Mohamed Alhabob <info@mulverse.com>",
+  "contributors": [
+    "Mohamed Alhabob <info@mulverse.com>"
+  ],
+  "type": "module",
+  "types": "./index.d.ts",
+  "files": [
+    "*.js",
+    "*.d.ts*",
+    "adapters",
+    "lib",
+    "providers",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./adapters": {
+      "types": "./adapters.d.ts",
+      "import": "./adapters.js",
+      "default": "./adapters.js"
+    },
+    "./errors": {
+      "types": "./errors.d.ts",
+      "import": "./errors.js",
+      "default": "./errors.js"
+    },
+    "./jwt": {
+      "types": "./jwt.d.ts",
+      "import": "./jwt.js",
+      "default": "./jwt.js"
+    },
+    "./providers": {
+      "types": "./providers/index.d.ts"
+    },
+    "./providers/*": {
+      "types": "./providers/*.d.ts",
+      "import": "./providers/*.js",
+      "default": "./providers/*.js"
+    },
+    "./types": {
+      "types": "./types.d.ts"
+    }
+  },
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@panva/hkdf": "^1.2.1",
+    "jose": "^6.0.6",
+    "oauth4webapi": "^3.3.0",
+    "preact": "10.24.3",
+    "preact-render-to-string": "6.5.11"
+  },
+  "peerDependencies": {
+    "@simplewebauthn/browser": "^9.0.1",
+    "@simplewebauthn/server": "^9.0.2",
+    "nodemailer": "^7.0.7"
+  },
+  "peerDependenciesMeta": {
+    "@simplewebauthn/browser": {
+      "optional": true
+    },
+    "@simplewebauthn/server": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@simplewebauthn/browser": "9.0.1",
+    "@simplewebauthn/server": "9.0.3",
+    "@simplewebauthn/types": "^9.0.1",
+    "@types/node": "18.11.10",
+    "@types/nodemailer": "6.4.6",
+    "@types/react": "18.0.37",
+    "autoprefixer": "10.4.13",
+    "postcss": "8.4.19",
+    "postcss-nesting": "^12.1.5",
+    "typedoc": "^0.25.12",
+    "typedoc-plugin-markdown": "4.0.0-next.53",
+    "typescript": "5.3.3"
+  },
+  "scripts": {
+    "build": "pnpm css && pnpm providers && node ../../node_modules/.pnpm/typescript@5.2.2/node_modules/typescript/bin/tsc",
+    "clean": "node -e \"const fs = require('fs'); ['*.js', '*.d.ts*', 'lib', 'providers'].forEach(p => { try { if (fs.existsSync(p)) fs.rmSync(p, {recursive: true, force: true}); } catch(e) {} });\"",
+    "css": "node scripts/generate-css",
+    "dev": "pnpm css && pnpm providers && tsc -w",
+    "test": "vitest run -c ../utils/vitest.config.ts",
+    "test:watch": "vitest -c ../utils/vitest.config.ts",
+    "providers": "node scripts/generate-providers"
+  }
+}