@better-auth-ui/core 1.6.8 → 1.6.10

package/src/plugins/api-key/api-key-plugin.ts

@@ -10,11 +10,32 @@ export type ApiKeyPluginOptions = {
    * @remarks `ApiKeyLocalization`
    */
   localization?: Partial<ApiKeyLocalization>
+  /**
+   * Enable organization-owned API keys.
+   *
+   * When `true`, the plugin contributes an organization-scoped API keys card
+   * to `<OrganizationSettings />`, and list/create/delete operations made on
+   * behalf of an organization send `configId: "organization"`.
+   *
+   * Requires a matching server-side `apiKey` config entry with
+   * `configId: "organization"` and `references: "organization"`:
+   *
+   * ```ts
+   * apiKey([
+   *   { configId: "default", references: "user" },
+   *   { configId: "organization", references: "organization" }
+   * ])
+   * ```
+   *
+   * @default false
+   */
+  organization?: boolean
 }
 
 export const apiKeyPlugin = createAuthPlugin(
   "apiKey",
   (options: ApiKeyPluginOptions = {}) => ({
-    localization: { ...apiKeyLocalization, ...options.localization }
+    localization: { ...apiKeyLocalization, ...options.localization },
+    organization: options.organization ?? false
   })
 )

package/src/plugins/api-key/api-key-query-keys.ts

@@ -0,0 +1,13 @@
+import { authQueryKeys } from "../../lib/auth-query-keys"
+
+/** Query key factory for API key queries, scoped per user. */
+export const apiKeyQueryKeys = {
+  all: (userId: string | undefined) =>
+    [...authQueryKeys.user(userId), "apiKey"] as const,
+
+  lists: (userId: string | undefined) =>
+    [...apiKeyQueryKeys.all(userId), "list"] as const,
+
+  list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+    [...apiKeyQueryKeys.lists(userId), query ?? null] as const
+} as const

package/src/plugins/delete-user/delete-user-localization.ts

@@ -1,9 +1,9 @@
 export const deleteUserLocalization = {
-  /** @remarks `"Delete user"` */
-  deleteUser: "Delete user",
+  /** @remarks `"Delete account"` */
+  deleteAccount: "Delete account",
 
   /** @remarks `"Permanently remove your account and all associated data. This cannot be undone."` */
-  deleteUserDescription:
+  deleteAccountDescription:
     "Permanently remove your account and all associated data. This cannot be undone.",
 
   /** @remarks `"Check your email to confirm account deletion."` */

package/src/plugins/delete-user/delete-user-mutation-keys.ts

@@ -0,0 +1,7 @@
+/**
+ * Mutation keys contributed by the delete-user plugin.
+ */
+export const deleteUserMutationKeys = {
+  /** Key for `deleteUser`. */
+  deleteUser: ["auth", "deleteUser"] as const
+} as const

package/src/plugins/multi-session/multi-session-mutation-keys.ts

@@ -0,0 +1,11 @@
+/**
+ * Mutation keys contributed by the multi-session plugin.
+ */
+export const multiSessionMutationKeys = {
+  /** Root key for every multi-session mutation. */
+  all: ["auth", "multiSession"] as const,
+  /** Key for `multiSession.revoke`. */
+  revoke: ["auth", "multiSession", "revoke"] as const,
+  /** Key for `multiSession.setActive`. */
+  setActive: ["auth", "multiSession", "setActive"] as const
+} as const

package/src/plugins/multi-session/multi-session-query-keys.ts

@@ -0,0 +1,13 @@
+import { authQueryKeys } from "../../lib/auth-query-keys"
+
+/** Query key factory for multi-session queries, scoped per user. */
+export const multiSessionQueryKeys = {
+  all: (userId: string | undefined) =>
+    [...authQueryKeys.user(userId), "multiSession"] as const,
+
+  lists: (userId: string | undefined) =>
+    [...multiSessionQueryKeys.all(userId), "list"] as const,
+
+  list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+    [...multiSessionQueryKeys.lists(userId), query ?? null] as const
+} as const

package/src/plugins/organization/organization-localization.ts

@@ -0,0 +1,123 @@
+export const organizationLocalization = {
+  /** @remarks `"Accept"` */
+  accept: "Accept",
+  /** @remarks `"Accepted"` */
+  accepted: "Accepted",
+  /** @remarks `"Actions"` */
+  actions: "Actions",
+  /** @remarks `"Admin"` */
+  admin: "Admin",
+  /** @remarks `"All"` */
+  all: "All",
+  /** @remarks `"Canceled"` */
+  canceled: "Canceled",
+  /** @remarks `"Cancel invitation"` */
+  cancelInvitation: "Cancel invitation",
+  /** @remarks `"Change logo"` */
+  changeLogo: "Change logo",
+  /** @remarks `"Change role"` */
+  changeMemberRole: "Change role",
+  /** @remarks `"Clear"` */
+  clear: "Clear",
+  /** @remarks `"Create organization"` */
+  createOrganization: "Create organization",
+  /** @remarks `"Delete logo"` */
+  deleteLogo: "Delete logo",
+  /** @remarks `"Delete organization"` */
+  deleteOrganization: "Delete organization",
+  /** @remarks `"Permanently delete this organization and all of its data. All members will lose access and this cannot be undone."` */
+  deleteOrganizationDescription:
+    "Permanently delete this organization and all of its data. All members will lose access and this cannot be undone.",
+  /** @remarks `"Invitations"` */
+  invitations: "Invitations",
+  /** @remarks `"Invited at"` */
+  invitedAt: "Invited at",
+  /** @remarks `"Invite member"` */
+  inviteMember: "Invite member",
+  /** @remarks `"Member invited successfully"` */
+  inviteMemberSuccess: "Member invited successfully",
+  /** @remarks `"We'll email them a link to join this organization. Choose the role they'll have once they accept."` */
+  inviteMemberDescription:
+    "We'll email them a link to join this organization. Choose the role they'll have once they accept.",
+  /** @remarks `"You left the organization"` */
+  leftOrganization: "You left the organization",
+  /** @remarks `"Leave organization"` */
+  leaveOrganization: "Leave organization",
+  /** @remarks `"Leave this organization and lose access to its data and resources. You'll need a new invitation to rejoin."` */
+  leaveOrganizationDescription:
+    "Leave this organization and lose access to its data and resources. You'll need a new invitation to rejoin.",
+  /** @remarks `"Logo"` */
+  logo: "Logo",
+  /** @remarks `"Logo updated successfully"` */
+  logoChangedSuccess: "Logo updated successfully",
+  /** @remarks `"Logo removed successfully"` */
+  logoDeletedSuccess: "Logo removed successfully",
+  /** @remarks `"Manage"` */
+  manage: "Manage",
+  /** @remarks `"Member"` */
+  member: "Member",
+  /** @remarks `"Member removed"` */
+  memberRemoved: "Member removed",
+  /** @remarks `"Member role updated"` */
+  memberRoleUpdated: "Member role updated",
+  /** @remarks `"Members"` */
+  members: "Members",
+  /** @remarks `"People"` */
+  people: "People",
+  /** @remarks `"Name"` */
+  name: "Name",
+  /** @remarks `"Enter the organization name"` */
+  namePlaceholder: "Enter the organization name",
+  /** @remarks `"No invitations"` */
+  noInvitations: "No invitations",
+  /** @remarks `"No organizations"` */
+  noOrganizations: "No organizations",
+  /** @remarks `"Organization"` */
+  organization: "Organization",
+  /** @remarks `"Organization deleted"` */
+  organizationDeleted: "Organization deleted",
+  /** @remarks `"Invite a teammate to collaborate in this organization."` */
+  organizationInvitationsEmptyDescription:
+    "Invite a teammate to collaborate in this organization.",
+  /** @remarks `"Organizations"` */
+  organizations: "Organizations",
+  /** @remarks `"Create an organization to collaborate with others and manage shared access."` */
+  organizationsDescription:
+    "Create an organization to collaborate with others and manage shared access.",
+  /** @remarks `"Organization profile"` */
+  organizationProfile: "Organization profile",
+  /** @remarks `"Organization updated successfully"` */
+  organizationUpdatedSuccess: "Organization updated successfully",
+  /** @remarks `"Owner"` */
+  owner: "Owner",
+  /** @remarks `"Pending"` */
+  pending: "Pending",
+  /** @remarks `"Personal account"` */
+  personalAccount: "Personal account",
+  /** @remarks `"Rejected"` */
+  rejected: "Rejected",
+  /** @remarks `"Reject invitation"` */
+  rejectInvitation: "Reject invitation",
+  /** @remarks `"Remove member"` */
+  removeMember: "Remove member",
+  /** @remarks `"Are you sure you want to remove this member from the organization? They will lose access immediately."` */
+  removeMemberWarning:
+    "Are you sure you want to remove this member from the organization? They will lose access immediately.",
+  /** @remarks `"Role"` */
+  role: "Role",
+  /** @remarks `"Search..."` */
+  search: "Search...",
+  /** @remarks `"Slug"` */
+  slug: "Slug",
+  /** @remarks `"organization-slug"` */
+  slugPlaceholder: "organization-slug",
+  /** @remarks `"Status"` */
+  status: "Status",
+  /** @remarks `"Upload logo"` */
+  uploadLogo: "Upload logo",
+  /** @remarks `"Invitations to join an organization will show up here."` */
+  userInvitationsEmptyDescription:
+    "Invitations to join an organization will show up here."
+}
+
+export type OrganizationLocalization = typeof organizationLocalization

package/src/plugins/organization/organization-mutation-keys.ts

@@ -0,0 +1,52 @@
+/**
+ * Hierarchical mutation key factory for organization-related mutations.
+ *
+ * Mutation keys are mostly used for `useIsMutating` and global
+ * `MutationCache` observers (e.g. toast handling), so the keys are static
+ * tuples rather than parameterised factories. Each grouping exposes an
+ * `all` prefix so consumers can match a whole feature at once:
+ *
+ * ```ts
+ * useIsMutating({ mutationKey: organizationMutationKeys.all })
+ * ```
+ */
+export const organizationMutationKeys = {
+  /** Root key for every organization mutation. */
+  all: ["auth", "organization"] as const,
+
+  /** Key for `organization.create`. */
+  create: ["auth", "organization", "create"] as const,
+
+  /** Key for `organization.delete`. */
+  delete: ["auth", "organization", "delete"] as const,
+
+  /** Key for `organization.update`. */
+  update: ["auth", "organization", "update"] as const,
+
+  /** Key for `organization.setActive`. */
+  setActive: ["auth", "organization", "setActive"] as const,
+
+  /** Key for `organization.inviteMember`. */
+  inviteMember: ["auth", "organization", "inviteMember"] as const,
+
+  /** Key for `organization.removeMember`. */
+  removeMember: ["auth", "organization", "removeMember"] as const,
+
+  /** Key for `organization.leave`. */
+  leave: ["auth", "organization", "leave"] as const,
+
+  /** Key for `organization.updateMemberRole`. */
+  updateMemberRole: ["auth", "organization", "updateMemberRole"] as const,
+
+  /** Key for `organization.acceptInvitation`. */
+  acceptInvitation: ["auth", "organization", "acceptInvitation"] as const,
+
+  /** Key for `organization.cancelInvitation`. */
+  cancelInvitation: ["auth", "organization", "cancelInvitation"] as const,
+
+  /** Key for `organization.rejectInvitation` (invitee declines). */
+  rejectInvitation: ["auth", "organization", "rejectInvitation"] as const,
+
+  /** Key for `organization.checkSlug`. */
+  checkSlug: ["auth", "organization", "checkSlug"] as const
+} as const

package/src/plugins/organization/organization-plugin.ts

@@ -0,0 +1,112 @@
+import { defaultAuthConfig } from "../../config"
+import type { AvatarConfig } from "../../config/avatar-config"
+import { createAuthPlugin } from "../../lib/create-auth-plugin"
+import {
+  type OrganizationLocalization,
+  organizationLocalization
+} from "./organization-localization"
+import type { OrganizationViewPaths } from "./organization-view-paths"
+
+declare module "../../lib/view-paths" {
+  /** Widens `SettingsViewPaths` by adding the `"organizations"` path when this plugin is imported. */
+  interface SettingsViewPaths {
+    /** @default "organizations" */
+    organizations?: string
+  }
+}
+
+declare module "../../lib/auth-plugin" {
+  interface AuthPluginViewPaths {
+    organization?: Partial<OrganizationViewPaths>
+  }
+}
+
+export type OrganizationPluginOptions = {
+  /**
+   * Whether to call `organization.checkSlug` when entering an organization slug.
+   * @default true
+   */
+  checkSlug?: boolean
+  /**
+   * Override the plugin's default localization strings.
+   * @remarks `OrganizationLocalization`
+   */
+  localization?: Partial<OrganizationLocalization>
+  /**
+   * Override URL segments contributed by this plugin.
+   *
+   * - `settings.organizations` — segment for the organizations settings view (default `"organizations"`).
+   * - `organization.settings` — segment for the `/organization/...` profile and danger zone tab (default `"settings"`).
+   * - `organization.people` — segment for the `/organization/...` members and invitations tab (default `"people"`).
+   */
+  viewPaths?: {
+    settings?: {
+      /** @default "organizations" */
+      organizations?: string
+    }
+    organization?: Partial<OrganizationViewPaths>
+  }
+  /**
+   * Organization logo upload, optimization, and deletion configuration.
+   * Same shape as {@link AvatarConfig} used for user avatars (`AuthConfig.avatar`).
+   * @remarks `AvatarConfig`
+   * @default { enabled: true, resize: resizeAvatar, size: 256, extension: "png" }
+   */
+  logo?: Partial<AvatarConfig>
+  /**
+   * Map of role keys to display labels. When omitted, defaults to localized
+   * labels for `owner`, `admin`, and `member` (from `localization.owner`
+   * etc.) plus {@link OrganizationPluginOptions.additionalRoles}. When set,
+   * replaces that default map entirely; use {@link OrganizationPluginOptions.additionalRoles}
+   * to add more labels on top. Looked up at render time via `roles?.[role]`.
+   * @remarks `Record<string, string>`
+   */
+  roles?: Record<string, string>
+  /**
+   * Extra role labels merged after the effective role map (either
+   * {@link OrganizationPluginOptions.roles} when provided, or the localized
+   * defaults). Use this for custom server roles without redefining built-in
+   * labels.
+   * @remarks `Record<string, string>`
+   */
+  additionalRoles?: Record<string, string>
+  slug?: string | null
+}
+
+export const organizationPlugin = createAuthPlugin(
+  "organization",
+  (options: OrganizationPluginOptions = {}) => {
+    const localization = {
+      ...organizationLocalization,
+      ...options.localization
+    }
+
+    return {
+      slug: options.slug,
+      checkSlug: options.checkSlug ?? true,
+      localization,
+      logo: {
+        ...defaultAuthConfig.avatar,
+        ...options.logo
+      },
+      roles: {
+        ...(options.roles ?? {
+          owner: localization.owner,
+          admin: localization.admin,
+          member: localization.member
+        }),
+        ...options.additionalRoles
+      },
+      viewPaths: {
+        settings: {
+          organizations:
+            options.viewPaths?.settings?.organizations ?? "organizations"
+        },
+        organization: {
+          settings: options.viewPaths?.organization?.settings ?? "settings",
+          people: options.viewPaths?.organization?.people ?? "people"
+        }
+      }
+    }
+  }
+)

package/src/plugins/organization/organization-query-keys.ts

@@ -0,0 +1,86 @@
+import { authQueryKeys } from "../../lib/auth-query-keys"
+
+/** Query key factory for organization queries, scoped per user. */
+export const organizationQueryKeys = {
+  all: (userId: string | undefined) =>
+    [...authQueryKeys.user(userId), "organization"] as const,
+
+  lists: (userId: string | undefined) =>
+    [...organizationQueryKeys.all(userId), "list"] as const,
+
+  list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+    [...organizationQueryKeys.lists(userId), query ?? null] as const,
+
+  fullDetails: (userId: string | undefined) =>
+    [...organizationQueryKeys.all(userId), "fullDetails"] as const,
+  fullDetail: <TQuery = undefined>(
+    userId: string | undefined,
+    query?: TQuery
+  ) => [...organizationQueryKeys.fullDetails(userId), query ?? null] as const,
+
+  /**
+   * Prefix for every active-organization cache entry (used for invalidation
+   * across slug-partitioned variants).
+   */
+  activeOrganizations: (userId: string | undefined) =>
+    [...organizationQueryKeys.all(userId), "active"] as const,
+  /**
+   * Cache entry for the currently active organization. Holds a {@link
+   * ListOrganization}-shaped value — distinct from `fullDetail`, which
+   * carries members and invitations — so `setActive`'s optimistic update
+   * (which can only produce a list-shaped org) doesn't corrupt the full
+   * cache.
+   */
+  activeOrganization: <TQuery = undefined>(
+    userId: string | undefined,
+    query?: TQuery
+  ) =>
+    [
+      ...organizationQueryKeys.activeOrganizations(userId),
+      query ?? null
+    ] as const,
+
+  members: {
+    all: (userId: string | undefined) =>
+      [...organizationQueryKeys.all(userId), "members"] as const,
+    lists: (userId: string | undefined) =>
+      [...organizationQueryKeys.members.all(userId), "list"] as const,
+    list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+      [...organizationQueryKeys.members.lists(userId), query ?? null] as const
+  },
+
+  invitations: {
+    all: (userId: string | undefined) =>
+      [...organizationQueryKeys.all(userId), "invitations"] as const,
+    lists: (userId: string | undefined) =>
+      [...organizationQueryKeys.invitations.all(userId), "list"] as const,
+    list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+      [
+        ...organizationQueryKeys.invitations.lists(userId),
+        query ?? null
+      ] as const
+  },
+
+  userInvitations: {
+    all: (userId: string | undefined) =>
+      [...organizationQueryKeys.all(userId), "userInvitations"] as const,
+    lists: (userId: string | undefined) =>
+      [...organizationQueryKeys.userInvitations.all(userId), "list"] as const,
+    list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+      [
+        ...organizationQueryKeys.userInvitations.lists(userId),
+        query ?? null
+      ] as const
+  },
+
+  permissions: {
+    all: (userId: string | undefined) =>
+      [...organizationQueryKeys.all(userId), "permissions"] as const,
+    has: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+      [
+        ...organizationQueryKeys.permissions.all(userId),
+        "has",
+        query ?? null
+      ] as const
+  }
+} as const

package/src/plugins/organization/organization-view-paths.ts

@@ -0,0 +1,20 @@
+/**
+ * Path segments under `/organization/...` contributed by `organizationPlugin`.
+ *
+ * Read at runtime via `useAuthPlugin(organizationPlugin).viewPaths.organization`.
+ */
+export interface OrganizationViewPaths {
+  /**
+   * Path segment for organization profile and danger zone
+   * @default "settings"
+   */
+  settings: string
+  /**
+   * Path segment for members and invitations
+   * @default "people"
+   */
+  people: string
+}
+
+/** Valid organization management tab / route key. */
+export type OrganizationView = keyof OrganizationViewPaths

package/src/plugins/passkey/passkey-query-keys.ts

@@ -0,0 +1,13 @@
+import { authQueryKeys } from "../../lib/auth-query-keys"
+
+/** Query key factory for passkey queries, scoped per user. */
+export const passkeyQueryKeys = {
+  all: (userId: string | undefined) =>
+    [...authQueryKeys.user(userId), "passkey"] as const,
+
+  lists: (userId: string | undefined) =>
+    [...passkeyQueryKeys.all(userId), "list"] as const,
+
+  list: <TQuery = undefined>(userId: string | undefined, query?: TQuery) =>
+    [...passkeyQueryKeys.lists(userId), query ?? null] as const
+} as const

package/src/plugins/username/username-mutation-keys.ts

@@ -0,0 +1,17 @@
+/**
+ * Mutation keys contributed by the username plugin.
+ *
+ * `signIn` is kept under the shared `["auth", "signIn", ...]` namespace so
+ * consumers can match the whole sign-in surface with
+ * `useIsMutating({ mutationKey: ["auth", "signIn"] })`.
+ */
+export const usernameMutationKeys = {
+  /** Key for `signIn.username`. */
+  signIn: ["auth", "signIn", "username"] as const,
+  /**
+   * Key for `isUsernameAvailable`. This is technically a read, but it's
+   * exposed via better-auth's mutation surface and lives under the mutation
+   * factories for parity with other username flows.
+   */
+  isUsernameAvailable: ["auth", "isUsernameAvailable"] as const
+} as const

package/src/plugins.ts

@@ -0,0 +1,28 @@
+export * from "./plugins/api-key/api-key-localization"
+export * from "./plugins/api-key/api-key-mutation-keys"
+export * from "./plugins/api-key/api-key-plugin"
+export * from "./plugins/api-key/api-key-query-keys"
+export * from "./plugins/delete-user/delete-user-localization"
+export * from "./plugins/delete-user/delete-user-mutation-keys"
+export * from "./plugins/delete-user/delete-user-plugin"
+export * from "./plugins/magic-link/magic-link-localization"
+export * from "./plugins/magic-link/magic-link-mutation-keys"
+export * from "./plugins/magic-link/magic-link-plugin"
+export * from "./plugins/multi-session/multi-session-localization"
+export * from "./plugins/multi-session/multi-session-mutation-keys"
+export * from "./plugins/multi-session/multi-session-plugin"
+export * from "./plugins/multi-session/multi-session-query-keys"
+export * from "./plugins/organization/organization-localization"
+export * from "./plugins/organization/organization-mutation-keys"
+export * from "./plugins/organization/organization-plugin"
+export * from "./plugins/organization/organization-query-keys"
+export * from "./plugins/organization/organization-view-paths"
+export * from "./plugins/passkey/passkey-localization"
+export * from "./plugins/passkey/passkey-mutation-keys"
+export * from "./plugins/passkey/passkey-plugin"
+export * from "./plugins/passkey/passkey-query-keys"
+export * from "./plugins/theme/theme-localization"
+export * from "./plugins/theme/theme-plugin"
+export * from "./plugins/username/username-localization"
+export * from "./plugins/username/username-mutation-keys"
+export * from "./plugins/username/username-plugin"

package/dist/config/additional-fields-config.js

@@ -1,27 +0,0 @@
-//#region src/config/additional-fields-config.ts
-function e(e, t) {
-	if (e.type === "boolean") return t === "on" || t === "true";
-	if (t != null) {
-		if (t === "") return null;
-		if (e.type === "number") {
-			let e = Number(t);
-			return Number.isNaN(e) ? void 0 : e;
-		}
-		if (e.type === "date") {
-			let e = new Date(t);
-			return Number.isNaN(e.getTime()) ? void 0 : e;
-		}
-		return t;
-	}
-}
-function t(e) {
-	if (e.inputType) return e.inputType;
-	switch (e.type) {
-		case "number": return "number";
-		case "boolean": return "switch";
-		case "date": return "date";
-		default: return "input";
-	}
-}
-//#endregion
-export { e as parseAdditionalFieldValue, t as resolveInputType };

package/dist/config/auth-config.js

@@ -1,32 +0,0 @@
-import { basePaths as e } from "../lib/base-paths.js";
-import { localization as t } from "../lib/localization.js";
-import { resizeAvatar as n } from "../lib/utils.js";
-import { viewPaths as r } from "../lib/view-paths.js";
-//#region src/config/auth-config.ts
-var i = {
-	avatar: {
-		enabled: !0,
-		resize: n,
-		size: 256,
-		extension: "png"
-	},
-	basePaths: e,
-	baseURL: "",
-	emailAndPassword: {
-		enabled: !0,
-		forgotPassword: !0,
-		name: !0,
-		rememberMe: !1,
-		minPasswordLength: 8,
-		maxPasswordLength: 128
-	},
-	plugins: [],
-	redirectTo: "/",
-	viewPaths: r,
-	localization: t,
-	navigate: ({ to: e, replace: t }) => {
-		t ? window.location.replace(e) : window.location.href = e;
-	}
-};
-//#endregion
-export { i as defaultAuthConfig };