@lalternative/auth 0.7.0 → 0.9.0

package/dist/client.d.ts

@@ -1,15 +1,20 @@
-import * as better_auth_react from 'better-auth/react';
-import { P as PlatformAuthClientConfig } from './types-SieiPwdd.js';
+import { createAuthClient } from 'better-auth/react';
+import { d as AuthClientSurface, P as PlatformAuthClientConfig } from './types-8GKMVW7c.js';
 import 'better-auth';
 
+/**
+ * A Better Auth React client carrying the platform plugins.
+ *
+ * The concrete inferred type cannot be named in a published .d.ts (TS2742 — it
+ * reaches into zod's internals), so the surface the auth screens call is
+ * declared by hand in AuthClientSurface and intersected with the rest of the
+ * client. Keep it in sync with the plugins enabled below.
+ */
+type PlatformAuthClient = AuthClientSurface & Omit<ReturnType<typeof createAuthClient>, keyof AuthClientSurface>;
 /**
  * Creates a Better Auth client for React usage.
- * Provides useSession() hook and other React-integrated methods.
+ * Provides useSession() and the email-OTP / admin plugin methods.
  */
-declare function createPlatformAuthClient(config?: PlatformAuthClientConfig): better_auth_react.ReactAuthClient<{
-    baseURL: string;
-    plugins: any[];
-}>;
-type PlatformAuthClient = ReturnType<typeof createPlatformAuthClient>;
+declare function createPlatformAuthClient(config?: PlatformAuthClientConfig): PlatformAuthClient;
 
 export { type PlatformAuthClient, createPlatformAuthClient };

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { createAuthClient } from \"better-auth/react\"\nimport { emailOTPClient, adminClient } from \"better-auth/client/plugins\"\nimport type { PlatformAuthClientConfig } from \"./types\"\n\n/**\n * Creates a Better Auth client for React usage.\n * Provides useSession() hook and other React-integrated methods.\n */\nexport function createPlatformAuthClient(config?: PlatformAuthClientConfig) {\n  return createAuthClient({\n    baseURL:\n      config?.baseURL ??\n      (typeof window !== \"undefined\"\n        ? window.location.origin\n        : \"http://localhost:3000\"),\n    plugins: [emailOTPClient(), adminClient(), ...(config?.plugins ?? [])],\n  })\n}\n\nexport type PlatformAuthClient = ReturnType<typeof createPlatformAuthClient>\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,gBAAgB,mBAAmB;AAOrC,SAAS,yBAAyB,QAAmC;AAC1E,SAAO,iBAAiB;AAAA,IACtB,SACE,QAAQ,YACP,OAAO,WAAW,cACf,OAAO,SAAS,SAChB;AAAA,IACN,SAAS,CAAC,eAAe,GAAG,YAAY,GAAG,GAAI,QAAQ,WAAW,CAAC,CAAE;AAAA,EACvE,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { createAuthClient } from \"better-auth/react\"\nimport { emailOTPClient, adminClient } from \"better-auth/client/plugins\"\nimport type { AuthClientSurface, PlatformAuthClientConfig } from \"./types\"\n\n/**\n * A Better Auth React client carrying the platform plugins.\n *\n * The concrete inferred type cannot be named in a published .d.ts (TS2742 — it\n * reaches into zod's internals), so the surface the auth screens call is\n * declared by hand in AuthClientSurface and intersected with the rest of the\n * client. Keep it in sync with the plugins enabled below.\n */\nexport type PlatformAuthClient = AuthClientSurface &\n  Omit<ReturnType<typeof createAuthClient>, keyof AuthClientSurface>\n\n/**\n * Creates a Better Auth client for React usage.\n * Provides useSession() and the email-OTP / admin plugin methods.\n */\nexport function createPlatformAuthClient(\n  config?: PlatformAuthClientConfig,\n): PlatformAuthClient {\n  return createAuthClient({\n    baseURL:\n      config?.baseURL ??\n      (typeof window !== \"undefined\"\n        ? window.location.origin\n        : \"http://localhost:3000\"),\n    plugins: [emailOTPClient(), adminClient(), ...(config?.plugins ?? [])],\n  }) as unknown as PlatformAuthClient\n}\n"],"mappings":";AAAA,SAAS,wBAAwB;AACjC,SAAS,gBAAgB,mBAAmB;AAkBrC,SAAS,yBACd,QACoB;AACpB,SAAO,iBAAiB;AAAA,IACtB,SACE,QAAQ,YACP,OAAO,WAAW,cACf,OAAO,SAAS,SAChB;AAAA,IACN,SAAS,CAAC,eAAe,GAAG,YAAY,GAAG,GAAI,QAAQ,WAAW,CAAC,CAAE;AAAA,EACvE,CAAC;AACH;","names":[]}

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { L as LoginFormProps, R as RegisterFormProps, V as VerifyEmailFormProps, F as ForgotPasswordFormProps, a as ResetPasswordFormProps, A as AuthLayoutProps, I as InvitationNoticeProps } from './types-SieiPwdd.js';
-export { b as InvitationFailure, c as LoginFormLabels, P as PlatformAuthClientConfig, d as PlatformAuthConfig, e as PlatformAuthMailer, f as PlatformAuthMailerArgs, g as PlatformAuthMailerType, h as PlatformSession, i as PlatformSessionData, j as PlatformUser, k as RegisterFormLabels } from './types-SieiPwdd.js';
+import { L as LoginFormProps, R as RegisterFormProps, V as VerifyEmailFormProps, F as ForgotPasswordFormProps, a as ResetPasswordFormProps, A as AuthLayoutProps, I as InvitationNoticeProps, b as LinkComponent } from './types-8GKMVW7c.js';
+export { c as AuthClientResult, d as AuthClientSurface, e as AuthInviteProps, f as AuthNavProps, g as AuthThemeProps, h as InvitationFailure, i as LoginFormLabels, P as PlatformAuthClientConfig, j as PlatformAuthConfig, k as PlatformAuthMailer, l as PlatformAuthMailerArgs, m as PlatformAuthMailerType, n as PlatformSession, o as PlatformSessionData, p as PlatformUser, q as RegisterFormLabels } from './types-8GKMVW7c.js';
 import * as better_auth_react from 'better-auth/react';
 import * as better_auth from 'better-auth';
 import { PlatformAuthClient } from './client.js';
 import * as react from 'react';
 import { InputHTMLAttributes, ReactNode } from 'react';
-export { C as ClaimOutcome, i as isInvitationFailure } from './invitation-BUqM_BF8.js';
+export { C as ClaimOutcome, i as isInvitationFailure } from './invitation-D0TAHCHq.js';
 
 /**
  * Returns a useSession hook bound to the given auth client.
@@ -54,6 +54,8 @@ interface AuthFieldProps extends NativeProps {
     /** Persistent helper text under the field, tied to it for screen readers */
     description?: string;
     invalid?: boolean;
+    /** Replaces the default border and background utilities */
+    fieldClassName?: string;
 }
 /**
  * A single credential field.
@@ -70,13 +72,22 @@ interface AuthFieldProps extends NativeProps {
  * corners exactly, and the border darkens at the same time — the border is what
  * survives forced-colors mode, where the ring is dropped.
  */
-declare function AuthField({ label, hint, description, invalid, ...props }: AuthFieldProps): react.JSX.Element;
+declare function AuthField({ label, hint, description, invalid, fieldClassName, ...props }: AuthFieldProps): react.JSX.Element;
 
 interface AuthSubmitProps {
     pending?: boolean;
     disabled?: boolean;
     pendingLabel: string;
     children: ReactNode;
+    /** Replaces the default `bg-primary text-primary-foreground hover:bg-primary/90` */
+    className?: string;
+    /**
+     * Adds the step that detaches the action from the fields above it. The
+     * inputs sit on a tighter rhythm so they read as one block to fill in; the
+     * button is what you do once that block is done, and an even gap would put
+     * it on the same footing as another field.
+     */
+    spacedAbove?: boolean;
 }
 /**
  * The primary action of an auth screen.
@@ -88,11 +99,23 @@ interface AuthSubmitProps {
  * The press feedback is a 1px translate rather than a scale — scaling a
  * full-width button visibly blurs its text mid-transform.
  */
-declare function AuthSubmit({ pending, disabled, pendingLabel, children, }: AuthSubmitProps): react.JSX.Element;
+declare function AuthSubmit({ pending, disabled, pendingLabel, children, className, spacedAbove, }: AuthSubmitProps): react.JSX.Element;
 
-declare function LoginForm({ onSuccess, registerUrl, forgotPasswordUrl, socialCallbackUrl, socialProviders, coreTokenUrl, labels, titleClassName, error: externalError, authClient, }: LoginFormProps): react.JSX.Element;
+declare function LoginForm({ onSuccess, registerUrl, forgotPasswordUrl, socialCallbackUrl, socialProviders, coreTokenUrl, labels, submitClassName, fieldClassName, error: externalError, linkComponent, invite, authClient, }: LoginFormProps): react.JSX.Element;
+declare namespace LoginForm {
+    var defaults: {
+        title: string;
+        subtitle: string;
+    };
+}
 
-declare function RegisterForm({ onSuccess, loginUrl, legal, socialCallbackUrl, socialProviders, labels, titleClassName, error: externalError, authClient, }: RegisterFormProps): react.JSX.Element;
+declare function RegisterForm({ onSuccess, loginUrl, legal, socialCallbackUrl, socialProviders, labels, submitClassName, fieldClassName, error: externalError, linkComponent, invite, authClient, }: RegisterFormProps): react.JSX.Element;
+declare namespace RegisterForm {
+    var defaults: {
+        title: string;
+        subtitle: string;
+    };
+}
 
 interface SocialButtonsProps {
     providers: Array<"google" | "github">;
@@ -105,16 +128,38 @@ interface SocialButtonsProps {
 }
 declare function SocialButtons({ providers, onSelect, disabled, separator, labels, }: SocialButtonsProps): react.JSX.Element | null;
 
-declare function VerifyEmailForm({ email, onSuccess, loginUrl, labels, titleClassName, authClient, }: VerifyEmailFormProps): react.JSX.Element;
+declare function VerifyEmailForm({ email, onSuccess, loginUrl, labels, submitClassName, fieldClassName, linkComponent, authClient, }: VerifyEmailFormProps): react.JSX.Element;
+declare namespace VerifyEmailForm {
+    var defaults: {
+        title: string;
+        subtitle: string;
+    };
+}
 
-declare function ForgotPasswordForm({ onSuccess, loginUrl, labels, titleClassName, authClient, }: ForgotPasswordFormProps): react.JSX.Element;
+declare function ForgotPasswordForm({ onSuccess, loginUrl, labels, submitClassName, fieldClassName, linkComponent, authClient, }: ForgotPasswordFormProps): react.JSX.Element;
+declare namespace ForgotPasswordForm {
+    var defaults: {
+        title: string;
+        subtitle: string;
+    };
+}
 
-declare function ResetPasswordForm({ email, onSuccess, loginUrl, labels, titleClassName, authClient, }: ResetPasswordFormProps): react.JSX.Element;
+declare function ResetPasswordForm({ email, onSuccess, loginUrl, labels, submitClassName, fieldClassName, linkComponent, authClient, }: ResetPasswordFormProps): react.JSX.Element;
+declare namespace ResetPasswordForm {
+    var defaults: {
+        title: string;
+        subtitle: string;
+    };
+}
 
 /**
- * The frame every auth screen sits in. It owns the ground, the card and the
- * app's own marks (logo, illustration, legal footer); the form it wraps owns
- * its title and its fields.
+ * The frame every auth screen sits in. It owns the ground, the heading and the
+ * app's own marks (logo, illustration, legal footer); the card holds only the
+ * fields and their actions.
+ *
+ * The heading sits ABOVE the card rather than inside it: the card is then
+ * exactly the thing you fill in, and the mark reads as the app's rather than
+ * as the form's first row.
  *
  * Mobile and desktop are two layouts, not one scaled down. On a phone the form
  * IS the page: no card, no border, edge-to-edge padding, top-aligned so the
@@ -122,16 +167,16 @@ declare function ResetPasswordForm({ email, onSuccess, loginUrl, labels, titleCl
  * centering. From sm up it becomes a bounded card on a tinted ground — a
  * full-width form on a 1440px display is unreadable.
  *
- * With a `panel` the card splits in two from md up, the form on the left and
- * the illustration on the right. The panel is dropped below that width rather
- * than stacked: a decorative half-screen above a form costs a full swipe
- * before the first field. Without a `panel` the card stays the single 420px
- * column it has always been.
+ * A `panel` is an app-supplied illustration and nothing else: without one the
+ * card stays a single column rather than inventing decoration to fill a half
+ * it has no content for. When given, it takes the LEFT half from md up and is
+ * dropped below that width — a decorative half-screen above a form costs a
+ * full swipe before the first field.
  *
  * min-h-dvh rather than min-h-screen: on mobile browsers 100vh includes the
  * retracting URL bar, so a screen-height container overflows by its height.
  */
-declare function AuthLayout({ logo, panel, children, footer, }: AuthLayoutProps): react.JSX.Element;
+declare function AuthLayout({ logo, panel, title, subtitle, titleClassName, children, footer, }: AuthLayoutProps): react.JSX.Element;
 
 /**
  * What an invitee sees when their link does not work.
@@ -147,4 +192,66 @@ declare function AuthLayout({ logo, panel, children, footer, }: AuthLayoutProps)
  */
 declare function InvitationNotice({ reason, supportEmail, title, action, }: InvitationNoticeProps): react.JSX.Element;
 
-export { AuthField, type AuthFieldProps, AuthLayout, AuthLayoutProps, AuthSubmit, ForgotPasswordForm, ForgotPasswordFormProps, InvitationNotice, InvitationNoticeProps, LoginForm, LoginFormProps, RegisterForm, RegisterFormProps, ResetPasswordForm, ResetPasswordFormProps, SocialButtons, VerifyEmailForm, VerifyEmailFormProps, useLogout, useSession };
+declare function normalizeInviteToken(value: unknown): string | undefined;
+/**
+ * Appends the invitation to a link between auth screens.
+ *
+ * An invitee who lands on /register and clicks through to /login must keep the
+ * offer: the token lives only in the URL, so a plain href to the sibling screen
+ * silently drops it and the account is created on the default tier.
+ */
+declare function withInviteToken(href: string, token?: string): string;
+
+type OAuthErrorLabels = {
+    accountNotLinked: string;
+    socialCancelled: string;
+    socialFailed: string;
+};
+/**
+ * Turns Better Auth's machine-readable OAuth failure code into something an
+ * invitee can act on.
+ *
+ * `account_not_linked` is the one worth naming: createPlatformAuth disables
+ * account linking on purpose, so "Continue with Google" on an address already
+ * registered with a password is REFUSED. Better Auth's default error route
+ * bounces the browser back with nothing shown, so without this the button
+ * simply looks broken.
+ */
+declare function oauthErrorMessage(code: string | null | undefined, labels: OAuthErrorLabels): string;
+/**
+ * Reads the failure Better Auth redirected back with.
+ *
+ * A social sign-in leaves the app entirely, so component state does not survive
+ * it: the only carrier left when the browser returns is the `?error=` Better
+ * Auth appends to the errorCallbackURL. Read from the address bar rather than
+ * from a typed route search, because the auth routes deliberately declare no
+ * search schema — adding one would make `search` required on every navigate to
+ * them across the app.
+ */
+declare function initialOAuthError(labels: OAuthErrorLabels, param?: string): string | undefined;
+/**
+ * Drops the failure from the address bar once it has been shown.
+ *
+ * Without this the message comes back on every reload, and outlives the retry
+ * that succeeded. replaceState rather than a router navigate: these screens
+ * have no typed search to navigate against, and the entry being rewritten is
+ * the one the OAuth provider pushed, not one the person chose.
+ */
+declare function clearOAuthError(param?: string): void;
+
+interface AuthLinkProps {
+    to: string;
+    as?: LinkComponent;
+    className?: string;
+    children: ReactNode;
+}
+/**
+ * A link between auth screens.
+ *
+ * Falls back to an anchor, which is right for an app without a router and wrong
+ * for every app with one: the full page load it triggers restarts the app and
+ * loses whatever the URL was carrying.
+ */
+declare function AuthLink({ to, as: Link, className, children }: AuthLinkProps): react.JSX.Element;
+
+export { AuthField, type AuthFieldProps, AuthLayout, AuthLayoutProps, AuthLink, AuthSubmit, ForgotPasswordForm, ForgotPasswordFormProps, InvitationNotice, InvitationNoticeProps, LinkComponent, LoginForm, LoginFormProps, type OAuthErrorLabels, RegisterForm, RegisterFormProps, ResetPasswordForm, ResetPasswordFormProps, SocialButtons, VerifyEmailForm, VerifyEmailFormProps, clearOAuthError, initialOAuthError, normalizeInviteToken, oauthErrorMessage, useLogout, useSession, withInviteToken };