SDK

Svelte SDK

@authon/svelte — Svelte-Stores und Komponenten für Authon-Authentifizierung. Funktioniert mit SvelteKit.

Installation

bash

npm install @authon/svelte @authon/js

Initialisierung

Rufen Sie initAuthon() in Ihrem Root-Layout auf, um den Svelte-Kontext für den gesamten Komponentenbaum einzurichten.

+layout.svelte

<script lang="ts">
  import { initAuthon } from "@authon/svelte";

  // Call in your root layout — sets Svelte context for the component tree
  const authon = initAuthon(import.meta.env.VITE_AUTHON_KEY);
</script>

<slot />

Reaktive Stores

Verwenden Sie getAuthon() in jeder untergeordneten Komponente, um auf die von initAuthon() eingerichteten reaktiven Stores zuzugreifen.

+page.svelte

<script lang="ts">
  import { getAuthon } from "@authon/svelte";

  // Destructure reactive stores from context
  const { user, isSignedIn, isLoading, signOut, openSignIn } = getAuthon();
</script>

{#if $isLoading}
  <p>Loading...</p>
{:else if $isSignedIn}
  <p>Welcome, {$user?.displayName}!</p>
  <button on:click={signOut}>Sign out</button>
{:else}
  <button on:click={openSignIn}>Sign in</button>
{/if}

Store API-Referenz

typescript

import { getAuthon } from "@authon/svelte";

const {
  user,        // Readable<AuthonUser | null>
  isSignedIn,  // Readable<boolean>
  isLoading,   // Readable<boolean>
  signOut,     // () => Promise<void>
  openSignIn,  // () => Promise<void>
  openSignUp,  // () => Promise<void>
  getToken,    // () => string | null
  client,      // Authon — raw JS client instance
} = getAuthon();

Eingebettete Komponenten

SignIn.svelte und SignUp.svelte rendern das Authon-Modal inline. Importieren Sie sie direkt aus dem .svelte-Dateipfad.

+page.svelte

<script lang="ts">
  import SignIn from "@authon/svelte/SignIn.svelte";
</script>

<!-- Props: publishableKey (required), apiUrl, theme, locale -->
<!-- Event: on:signIn → { user: AuthonUser } -->
<SignIn
  publishableKey={import.meta.env.VITE_AUTHON_KEY}
  theme="auto"
  on:signIn={(e) => console.log("Signed in:", e.detail.user)}
/>

+page.svelte

<script lang="ts">
  import SignUp from "@authon/svelte/SignUp.svelte";
</script>

<!-- Props: publishableKey (required), apiUrl, theme, locale -->
<!-- Event: on:signUp → { user: AuthonUser } -->
<SignUp
  publishableKey={import.meta.env.VITE_AUTHON_KEY}
  theme="dark"
  on:signUp={(e) => console.log("Signed up:", e.detail.user)}
/>

Social-Schaltflächen

Rendern Sie OAuth-Anbieter-Schaltflächen in jedes Container-Element mit renderSocialButtons().

+page.svelte

<script lang="ts">
  import { getAuthon, renderSocialButtons } from "@authon/svelte";
  import { onMount } from "svelte";

  const { client } = getAuthon();
  let container: HTMLElement;

  onMount(() => {
    return renderSocialButtons({
      client,
      container,
      compact: true,
      onSuccess: () => (window.location.href = "/dashboard"),
      onError: (err) => console.error(err),
    });
  });
</script>

<div bind:this={container}></div>

Eigenständiger Store

Verwenden Sie createAuthonStore() direkt, wenn Sie einen Authon-Store außerhalb eines Svelte-Komponentenkontexts benötigen.

src/lib/authon.ts

import { createAuthonStore } from "@authon/svelte";

// Use outside of Svelte component context (e.g. in a plain .ts module)
export const authon = createAuthonStore(import.meta.env.VITE_AUTHON_KEY);