@lalternative/auth 0.8.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-Dmjo9lEL.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-Dmjo9lEL.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-Dmjo9lEL.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-CfZAFUdJ.js';
+export { C as ClaimOutcome, i as isInvitationFailure } from './invitation-D0TAHCHq.js';
 
 /**
  * Returns a useSession hook bound to the given auth client.
@@ -81,6 +81,13 @@ interface AuthSubmitProps {
     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.
@@ -92,9 +99,9 @@ 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, className, }: 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, submitClassName, fieldClassName, 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;
@@ -102,7 +109,7 @@ declare namespace LoginForm {
     };
 }
 
-declare function RegisterForm({ onSuccess, loginUrl, legal, socialCallbackUrl, socialProviders, labels, submitClassName, fieldClassName, 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;
@@ -121,7 +128,7 @@ interface SocialButtonsProps {
 }
 declare function SocialButtons({ providers, onSelect, disabled, separator, labels, }: SocialButtonsProps): react.JSX.Element | null;
 
-declare function VerifyEmailForm({ email, onSuccess, loginUrl, labels, submitClassName, fieldClassName, 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;
@@ -129,7 +136,7 @@ declare namespace VerifyEmailForm {
     };
 }
 
-declare function ForgotPasswordForm({ onSuccess, loginUrl, labels, submitClassName, fieldClassName, 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;
@@ -137,7 +144,7 @@ declare namespace ForgotPasswordForm {
     };
 }
 
-declare function ResetPasswordForm({ email, onSuccess, loginUrl, labels, submitClassName, fieldClassName, 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;
@@ -185,4 +192,66 @@ declare function AuthLayout({ logo, panel, title, subtitle, titleClassName, chil
  */
 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 };