docs: exclude inherits, update deps (#12628)

* docs: exclude inherits

* docs: fix build

* docs: fix build

* docs: fix build

* docs: fix build

* fix: less verbose

* fix clean command

* fix

Author: ThangHuuVu

.gitignore

@@ -32,6 +32,7 @@ packages/next-auth/providers
 # copied from @auth/core
 packages/frameworks-*/**/providers
 packages/*/*.js
+!packages/*/typedoc.config.js
 packages/*/*.d.ts
 packages/*/*.d.ts.map
 packages/*/lib

docs/package.json

@@ -49,8 +49,9 @@
     "postcss": "^8.4.47",
     "shiki": "^1.22.0",
     "tailwindcss": "^3.4.13",
-    "typedoc": "^0.25.13",
-    "typedoc-plugin-markdown": "4.0.0-next.54",
-    "typedoc-plugin-mdn-links": "^3.3.2"
+    "typedoc": "^0.27.6",
+    "typedoc-plugin-markdown": "4.4.1",
+    "typedoc-plugin-mdn-links": "4.0.11",
+    "typedoc-plugin-no-inherit": "^1.5.0"
   }
 }

docs/typedoc-nextauth.cjs renamed to docs/typedoc-nextauth.js

@@ -1,15 +1,15 @@
 // @ts-check
 
-const { MarkdownPageEvent } = require("typedoc-plugin-markdown")
-const path = require("path")
-const fs = require("fs")
+import { MarkdownPageEvent } from "typedoc-plugin-markdown"
+import path from "path"
+import fs from "fs"
 
 /**
  * Local plugin to tweak TypeDoc output for nextra docs
  *
  *  @param {import("typedoc-plugin-markdown").MarkdownApplication} app
  */
-module.exports.load = (app) => {
+export function load(app) {
   injectNextraCalloutImport(app)
   parseOutput(app)
   writeMetaJsFiles(app)

docs/typedoc.config.cjs

@@ -24,15 +24,17 @@ module.exports = {
   tsconfig: "./tsconfig.json",
   plugin: [
     "typedoc-plugin-markdown",
-    require.resolve("./typedoc-nextauth.cjs"),
+    require.resolve("./typedoc-nextauth.js"),
     "typedoc-plugin-mdn-links",
+    "typedoc-plugin-no-inherit",
   ],
   disableSources: true,
   excludeNotDocumented: true,
   excludeExternals: true,
   excludeInternal: true,
   excludePrivate: true,
   excludeProtected: true,
+  excludeReferences: true,
   cleanOutputDir: false,
   gitRevision: "main",
   githubPages: false,

packages/adapter-kysely/src/index.ts

@@ -2,19 +2,18 @@
  * <div style={{display: "flex", justifyContent: "space-between", alignItems: "center", padding: 16}}>
  *  <p>Official <a href="https://kysely.dev/">Kysely</a> adapter for Auth.js / NextAuth.js.</p>
  *  <a href="https://kysely.dev/">
- *   <img style={{display: "block"}} src="/img/adapters/kysely.svg" width="38" />
+ *   <img style={{display: "block"}} src="https://authjs.dev/img/adapters/kysely.svg" width="30" />
  *  </a>
  * </div>
  *
  * ## Installation
  *
  * ```bash npm2yarn
- * npm install kysely @auth/kysely-adapter
+ * npm install @auth/kysely-adapter kysely
  * ```
  *
  * @module @auth/kysely-adapter
  */
-
 import { Kysely, SqliteAdapter } from "kysely"
 
 import {
@@ -205,6 +204,7 @@ export function KyselyAdapter(db: Kysely<Database>): Adapter {
  * requires. When used with `kysely-codegen`, the `Codegen` type can be passed as
  * the second generic argument. The generated types will be used, and
  * `KyselyAuth` will only verify that the correct fields exist.
+ * @noInheritDoc
  */
 export class KyselyAuth<DB extends T, T = Database> extends Kysely<DB> {}
 

packages/adapter-mongodb/src/index.ts

@@ -52,7 +52,7 @@ export interface MongoDBAdapterOptions {
   databaseName?: string
   /**
    * Callback function for managing the closing of the MongoDB client.
-   * This could be useful when `client` is provided as a function returning MongoClient | Promise<MongoClient>.
+   * This could be useful when `client` is provided as a function returning MongoClient.
    * It allows for more customized management of database connections,
    * addressing persistence, container reuse, and connection closure issues.
    */
@@ -115,7 +115,7 @@ export function MongoDBAdapter(
    * - A promise that resolves to a connected `MongoClient` (not recommended).
    * - A function, to handle more complex and custom connection strategies.
    *
-   * Using a function that returns `MongoClient | Promise<MongoClient>`, combined with `options.onClose`, can be useful when you want a more advanced and customized connection strategy to address challenges related to persistence, container reuse, and connection closure.
+   * Using a function combined with `options.onClose`, can be useful when you want a more advanced and customized connection strategy to address challenges related to persistence, container reuse, and connection closure.
    */
   client:
     | MongoClient

packages/adapter-prisma/package.json

@@ -37,7 +37,7 @@
     "access": "public"
   },
   "scripts": {
-    "clean": "rm ./prisma/dev.db* || echo 'File deleted' && rm -rf *.js *.d.ts*",
+    "clean": "rm ./prisma/dev.db* || echo 'File deleted' && rm -rf index.js *.d.ts*",
     "init:default": "prisma migrate dev --name init --skip-seed",
     "init:custom": "prisma migrate dev --name init-custom --schema ./prisma/custom.prisma",
     "test:default": "pnpm init:default && vitest run -c ../utils/vitest.config.ts",

packages/adapter-prisma/typedoc.config.cjs

@@ -0,0 +1,8 @@
+export default {
+  entryPoints: ["src/index.ts"],
+  entryPointStrategy: "expand",
+  tsconfig: "./tsconfig.json",
+  entryModule: "@auth/prisma-adapter",
+  includeVersion: true,
+  readme: 'none',
+};