@better-auth/core 1.5.0-beta.9 → 1.5.0

package/dist/types/context.d.mts

@@ -1,36 +1,55 @@
 import { BetterAuthDBSchema, ModelNames, SecondaryStorage } from "../db/type.mjs";
-import { Account } from "../db/schema/account.mjs";
+import { DBAdapter, Where } from "../db/adapter/index.mjs";
 import { Session } from "../db/schema/session.mjs";
 import { User } from "../db/schema/user.mjs";
 import { Verification } from "../db/schema/verification.mjs";
-import "../db/index.mjs";
-import { LiteralString } from "./helper.mjs";
-import { DBAdapter, Where } from "../db/adapter/index.mjs";
 import { createLogger } from "../env/logger.mjs";
-import { OAuthProvider } from "../oauth2/oauth-provider.mjs";
-import "../oauth2/index.mjs";
-import { BetterAuthCookie, BetterAuthCookies } from "./cookie.mjs";
+import { Awaitable, LiteralString } from "./helper.mjs";
 import { BetterAuthPlugin } from "./plugin.mjs";
 import { BetterAuthOptions, BetterAuthRateLimitOptions } from "./init-options.mjs";
+import { Account } from "../db/schema/account.mjs";
+import "../db/index.mjs";
+import { BetterAuthCookie, BetterAuthCookies } from "./cookie.mjs";
+import { SecretConfig } from "./secret.mjs";
+import { OAuthProvider } from "../oauth2/oauth-provider.mjs";
+import "../oauth2/index.mjs";
 import { CookieOptions, EndpointContext } from "better-call";
 
 //#region src/types/context.d.ts
-
+/**
+ * @internal
+ */
+type InferPluginID<O extends BetterAuthOptions> = O["plugins"] extends Array<infer P> ? P extends BetterAuthPlugin ? P["id"] : never : never;
+/**
+ * @internal
+ */
+type InferPluginOptions<O extends BetterAuthOptions, ID extends BetterAuthPluginRegistryIdentifier | LiteralString> = O["plugins"] extends Array<infer P> ? P extends BetterAuthPlugin ? P["id"] extends ID ? P extends {
+  options: infer O;
+} ? O : never : never : never : never;
 /**
  * Mutators are defined in each plugin
  *
  * @example
  * ```ts
+ * interface MyPluginOptions {
+ *   useFeature: boolean
+ * }
+ *
+ * const createMyPlugin = <Options extends MyPluginOptions>(options?: Options) => ({
+ *   id: 'my-plugin',
+ *   options,
+ * } satisfies BetterAuthPlugin);
+ *
  * declare module "@better-auth/core" {
- *  interface BetterAuthPluginRegistry<Auth, Context> {
- *    'jwt': {
- *      creator: typeof jwt
+ *  interface BetterAuthPluginRegistry<AuthOptions, Options> {
+ *    'my-plugin': {
+ *      creator: Options extends MyPluginOptions ? typeof createMyPlugin<Options>: typeof createMyPlugin
  *    }
  *  }
  * }
  * ```
  */
-interface BetterAuthPluginRegistry<Auth, Context> {}
+interface BetterAuthPluginRegistry<AuthOptions, Options> {}
 type BetterAuthPluginRegistryIdentifier = keyof BetterAuthPluginRegistry<unknown, unknown>;
 type GenericEndpointContext<Options extends BetterAuthOptions = BetterAuthOptions> = EndpointContext<string, any> & {
   context: AuthContext<Options>;
@@ -42,7 +61,9 @@ interface InternalAdapter<_Options extends BetterAuthOptions = BetterAuthOptions
   }>;
   createUser<T extends Record<string, any>>(user: Omit<User, "id" | "createdAt" | "updatedAt" | "emailVerified"> & Partial<User> & Record<string, any>): Promise<T & User>;
   createAccount<T extends Record<string, any>>(account: Omit<Account, "id" | "createdAt" | "updatedAt"> & Partial<Account> & T): Promise<T & Account>;
-  listSessions(userId: string): Promise<Session[]>;
+  listSessions(userId: string, options?: {
+    onlyActiveSessions?: boolean | undefined;
+  } | undefined): Promise<Session[]>;
   listUsers(limit?: number | undefined, offset?: number | undefined, sortBy?: {
     field: string;
     direction: "asc" | "desc";
@@ -54,7 +75,9 @@ interface InternalAdapter<_Options extends BetterAuthOptions = BetterAuthOptions
     session: Session & Record<string, any>;
     user: User & Record<string, any>;
   } | null>;
-  findSessions(sessionTokens: string[]): Promise<{
+  findSessions(sessionTokens: string[], options?: {
+    onlyActiveSessions?: boolean | undefined;
+  } | undefined): Promise<{
     session: Session;
     user: User;
   }[]>;
@@ -92,8 +115,10 @@ interface InternalAdapter<_Options extends BetterAuthOptions = BetterAuthOptions
 }
 type CreateCookieGetterFn = (cookieName: string, overrideAttributes?: Partial<CookieOptions> | undefined) => BetterAuthCookie;
 type CheckPasswordFn<Options extends BetterAuthOptions = BetterAuthOptions> = (userId: string, ctx: GenericEndpointContext<Options>) => Promise<boolean>;
-type PluginContext = {
-  getPlugin: <ID extends BetterAuthPluginRegistryIdentifier | LiteralString>(pluginId: ID) => (ID extends BetterAuthPluginRegistryIdentifier ? ReturnType<BetterAuthPluginRegistry<unknown, unknown>[ID]["creator"]> : BetterAuthPlugin) | null;
+type PluginContext<Options extends BetterAuthOptions> = {
+  getPlugin: <ID extends BetterAuthPluginRegistryIdentifier | LiteralString, PluginOptions extends InferPluginOptions<Options, ID>>(pluginId: ID) => (ID extends BetterAuthPluginRegistryIdentifier ? BetterAuthPluginRegistry<Options, PluginOptions>[ID] extends {
+    creator: infer C;
+  } ? C extends ((...args: any[]) => infer R) ? R : never : never : BetterAuthPlugin) | null;
   /**
    * Checks if a plugin is enabled by its ID.
    *
@@ -107,16 +132,21 @@ type PluginContext = {
    * }
    * ```
    */
-  hasPlugin: <ID extends BetterAuthPluginRegistryIdentifier | LiteralString>(pluginId: ID) => boolean;
+  hasPlugin: <ID extends BetterAuthPluginRegistryIdentifier | LiteralString>(pluginId: ID) => ID extends InferPluginID<Options> ? true : boolean;
 };
 type InfoContext = {
   appName: string;
   baseURL: string;
   version: string;
 };
-type AuthContext<Options extends BetterAuthOptions = BetterAuthOptions> = PluginContext & InfoContext & {
+type AuthContext<Options extends BetterAuthOptions = BetterAuthOptions> = PluginContext<Options> & InfoContext & {
   options: Options;
   trustedOrigins: string[];
+  /**
+   * Resolved list of trusted providers for account linking.
+   * Populated from "account.accountLinking.trustedProviders" (supports static array or async function).
+   */
+  trustedProviders: string[];
   /**
    * Verifies whether url is a trusted origin according to the "trustedOrigins" configuration
    * @param url The url to verify against the "trustedOrigins" configuration
@@ -172,6 +202,7 @@ type AuthContext<Options extends BetterAuthOptions = BetterAuthOptions> = Plugin
   internalAdapter: InternalAdapter<Options>;
   createAuthCookie: CreateCookieGetterFn;
   secret: string;
+  secretConfig: string | SecretConfig;
   sessionConfig: {
     updateAge: number;
     expiresIn: number;
@@ -233,7 +264,7 @@ type AuthContext<Options extends BetterAuthOptions = BetterAuthOptions> = Plugin
    * This is inferred from the `options.advanced?.backgroundTasks?.handler` option.
    * Defaults to a no-op that just runs the promise.
    */
-  runInBackground: (promise: Promise<void>) => void;
+  runInBackground: (promise: Promise<unknown>) => void;
   /**
    * Runs a task in the background if `runInBackground` is configured,
    * otherwise awaits the task directly.
@@ -242,7 +273,8 @@ type AuthContext<Options extends BetterAuthOptions = BetterAuthOptions> = Plugin
    * to avoid blocking the response when possible (for timing attack
    * mitigation), but still ensure the operation completes.
    */
-  runInBackgroundOrAwait: (promise: Promise<unknown> | Promise<void> | void | unknown) => Promise<unknown>;
+  runInBackgroundOrAwait: (promise: Promise<unknown> | void) => Awaitable<unknown>;
 };
 //#endregion
-export { AuthContext, BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, InfoContext, InternalAdapter, PluginContext };
+export { AuthContext, BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, InfoContext, InternalAdapter, PluginContext };
+//# sourceMappingURL=context.d.mts.map

package/dist/types/cookie.d.mts

@@ -12,4 +12,5 @@ type BetterAuthCookies = {
   dontRememberToken: BetterAuthCookie;
 };
 //#endregion
-export { BetterAuthCookie, BetterAuthCookies };
+export { BetterAuthCookie, BetterAuthCookies };
+//# sourceMappingURL=cookie.d.mts.map

package/dist/types/helper.d.mts

@@ -1,8 +1,11 @@
 //#region src/types/helper.d.ts
 type Primitive = string | number | symbol | bigint | boolean | null | undefined;
 type Awaitable<T> = T | Promise<T>;
+type AwaitableFunction<T> = T | (() => Awaitable<T>);
 type LiteralString = "" | (string & Record<never, never>);
 type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
 //#endregion
-export { Awaitable, LiteralString, LiteralUnion, Prettify, Primitive };
+export { Awaitable, AwaitableFunction, LiteralString, LiteralUnion, Prettify, Primitive, UnionToIntersection };
+//# sourceMappingURL=helper.d.mts.map

package/dist/types/index.d.mts

@@ -1,7 +1,8 @@
-import { Awaitable, LiteralString, LiteralUnion, Prettify, Primitive } from "./helper.mjs";
+import { Awaitable, AwaitableFunction, LiteralString, LiteralUnion, Prettify, Primitive, UnionToIntersection } from "./helper.mjs";
+import { BetterAuthPlugin, BetterAuthPluginErrorCodePart, HookEndpointContext } from "./plugin.mjs";
+import { BaseURLConfig, BetterAuthAdvancedOptions, BetterAuthDBOptions, BetterAuthOptions, BetterAuthRateLimitOptions, BetterAuthRateLimitRule, BetterAuthRateLimitStorage, DynamicBaseURLConfig, GenerateIdFn, StoreIdentifierOption } from "./init-options.mjs";
 import { BetterAuthCookie, BetterAuthCookies } from "./cookie.mjs";
-import { BetterAuthPlugin, HookEndpointContext } from "./plugin.mjs";
-import { BetterAuthAdvancedOptions, BetterAuthOptions, BetterAuthRateLimitOptions, BetterAuthRateLimitRule, BetterAuthRateLimitStorage, GenerateIdFn } from "./init-options.mjs";
+import { SecretConfig } from "./secret.mjs";
 import { AuthContext, BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, InfoContext, InternalAdapter, PluginContext } from "./context.mjs";
 import { BetterAuthClientOptions, BetterAuthClientPlugin, ClientAtomListener, ClientFetchOption, ClientStore } from "./plugin-client.mjs";
 import { StandardSchemaV1 as StandardSchemaV1$1 } from "@standard-schema/spec";