svelte-firekit 0.0.4 → 0.0.6

package/README.md

@@ -2,6 +2,11 @@
 
 Firekit is a powerful Firebase toolkit for SvelteKit applications, providing a comprehensive set of utilities, stores, and components for Firebase integration.
 
+<h2>🚧 Under Development 🚧</h2>
+
+<p>
+Please note that this library is still under development. Although it's functional and can be used, some features might be incomplete or subject to changes.
+</p>
 ## Features
 
 - 🔥 **Firebase Integration** - Seamless Firebase setup and configuration

package/dist/auth/sign-up.svelte

@@ -2,7 +2,7 @@
     import SignInWithGoogle from "../components/auth/google-sign-in.svelte";
     import SignUpForm from "../components/auth/sign-up-form.svelte";
     import Button from "../components/ui/button/button.svelte";
-    import * as Card from "../components/ui/card";
+    import * as Card from "../components/ui/card/index.js";
     let { title = "Sign up" }: { title: string } = $props();
 </script>
 

package/dist/components/auth/user-button/settings-dialog.svelte

@@ -0,0 +1,95 @@
+<script lang="ts">
+	import * as Breadcrumb from "../../ui/breadcrumb/index.js";
+	import { Button } from "../../ui/button/index.js";
+	import * as Dialog from "../../ui/dialog/index.js";
+	import * as Sidebar from "../../ui/sidebar/index.js";
+
+	import Lock from "lucide-svelte/icons/lock";
+
+	import { firekitUser } from "../../../firebase/auth/user.svelte.js";
+	import { User2 } from "lucide-svelte";
+
+	const data = {
+		nav: [
+			{ name: "Profile", icon: User2 },
+			{ name: "Security", icon: Lock },
+		],
+	};
+
+	let open = $state(false);
+</script>
+
+<Dialog.Root bind:open>
+	<Dialog.Trigger>
+		{#snippet child({ props })}
+			<Button size="sm" {...props}>Profile</Button>
+		{/snippet}
+	</Dialog.Trigger>
+	<Dialog.Content
+		class="overflow-hidden p-0 md:max-h-[500px] md:max-w-[700px] lg:max-w-[800px]"
+	>
+		<Dialog.Title class="sr-only">Settings</Dialog.Title>
+		<Dialog.Description class="sr-only"
+			>Customize your settings here.</Dialog.Description
+		>
+		<Sidebar.Provider class="items-start">
+			<Sidebar.Root collapsible="none" class="hidden md:flex">
+				<Sidebar.Content>
+					<Sidebar.Group>
+						<Sidebar.GroupContent>
+							<Sidebar.Menu>
+								{#each data.nav as item (item.name)}
+									<Sidebar.MenuItem>
+										<Sidebar.MenuButton
+											isActive={item.name ===
+												"Messages & media"}
+										>
+											{#snippet child({ props })}
+												<a href="##" {...props}>
+													<item.icon />
+													<span>{item.name}</span>
+												</a>
+											{/snippet}
+										</Sidebar.MenuButton>
+									</Sidebar.MenuItem>
+								{/each}
+							</Sidebar.Menu>
+						</Sidebar.GroupContent>
+					</Sidebar.Group>
+				</Sidebar.Content>
+			</Sidebar.Root>
+			<main class="flex h-[480px] flex-1 flex-col overflow-hidden">
+				<header
+					class="flex h-16 shrink-0 items-center gap-2 transition-[width,height] ease-linear group-has-[[data-collapsible=icon]]/sidebar-wrapper:h-12"
+				>
+					<div class="flex items-center gap-2 px-4">
+						<Breadcrumb.Root>
+							<Breadcrumb.List>
+								<Breadcrumb.Item class="hidden md:block">
+									<Breadcrumb.Link href="#"
+										>Settings</Breadcrumb.Link
+									>
+								</Breadcrumb.Item>
+								<Breadcrumb.Separator class="hidden md:block" />
+								<Breadcrumb.Item>
+									<Breadcrumb.Page
+										>Messages & media</Breadcrumb.Page
+									>
+								</Breadcrumb.Item>
+							</Breadcrumb.List>
+						</Breadcrumb.Root>
+					</div>
+				</header>
+				<div
+					class="flex flex-1 flex-col gap-4 overflow-y-auto p-4 pt-0"
+				>
+					{#each Array.from({ length: 10 }) as _, i (i)}
+						<div
+							class="bg-muted/50 aspect-video max-w-3xl rounded-xl"
+						></div>
+					{/each}
+				</div>
+			</main>
+		</Sidebar.Provider>
+	</Dialog.Content>
+</Dialog.Root>

package/dist/components/auth/user-button/settings-dialog.svelte.d.ts

@@ -0,0 +1,2 @@
+declare const SettingsDialog: import("svelte").Component<Record<string, never>, {}, "">;
+export default SettingsDialog;

package/dist/components/auth/{user-button.svelte → user-button/user-button.svelte}

@@ -1,14 +1,15 @@
 <script lang="ts">
-    import * as DropdownMenu from "../ui/dropdown-menu/index.js";
-    import * as Avatar from "../ui/avatar/index.js";
-    import { getInitials } from "../../utils.js";
-    import type { NavItem } from "../../types/nav.js";
+    import * as DropdownMenu from "../../ui/dropdown-menu/index.js";
+    import * as Avatar from "../../ui/avatar/index.js";
+    import { getInitials } from "../../../utils.js";
+    import type { NavItem } from "../../../types/nav.js";
     let { nav }: { nav?: NavItem[] } = $props();
-    import * as AlertDialog from "../ui/alert-dialog/index.js";
-    import Button from "../ui/button/button.svelte";
-    import { firekitUser } from "../../firebase/auth/user.svelte.js";
-    import { firekitAuth } from "../../firebase/auth/auth.js";
+    import * as AlertDialog from "../../ui/alert-dialog/index.js";
+    import Button from "../../ui/button/button.svelte";
+    import { firekitUser } from "../../../firebase/auth/user.svelte.js";
+    import { firekitAuth } from "../../../firebase/auth/auth.js";
     import { LogOut } from "lucide-svelte";
+    import SettingsDialog from "./settings-dialog.svelte";
     let isOpen = $state(false);
 
     async function handleLogout() {
@@ -53,7 +54,9 @@
                 </DropdownMenu.GroupHeading>
                 <DropdownMenu.Separator />
                 <DropdownMenu.Item onclick={() => (isOpen = true)}>
-                    Profile
+                    {#snippet child({ props })}
+                        <SettingsDialog child({ props }) />
+                    {/snippet}
                 </DropdownMenu.Item>
                 {#if nav}
                     {#each nav as { href, label }}

package/dist/components/auth/{user-button.svelte.d.ts → user-button/user-button.svelte.d.ts}

@@ -1,4 +1,4 @@
-import type { NavItem } from "../../types/nav.js";
+import type { NavItem } from "../../../types/nav.js";
 declare const UserButton: import("svelte").Component<{
     nav?: NavItem[];
 }, {}, "">;

package/dist/components/nav/nav.js

@@ -1,5 +1,5 @@
 export const nav = {
-    versions: ["0.0.3",],
+    versions: ["0.0.3"],
     navMain: [
         {
             title: "Getting Started",
@@ -20,7 +20,7 @@ export const nav = {
                 {
                     title: "Configuration",
                     url: "/docs/configuration",
-                }
+                },
             ],
         },
         {
@@ -29,12 +29,12 @@ export const nav = {
             items: [
                 {
                     title: "Firebase Config",
-                    url: "/docs/firebase/config",
+                    url: "/docs/config",
                 },
                 {
                     title: "Firebase Service",
-                    url: "/docs/firebase/service",
-                }
+                    url: "/docs/service",
+                },
             ],
         },
         {
@@ -43,44 +43,44 @@ export const nav = {
             items: [
                 {
                     title: "FirekitUser",
-                    url: "/docs/auth/firekit-user",
+                    url: "/docs/firekit-user",
                 },
                 {
                     title: "FirekitAuth",
-                    url: "/docs/auth/firekit-auth",
+                    url: "/docs/firekit-auth",
                 },
                 {
                     title: "AuthGuard",
-                    url: "/docs/auth/auth-guard",
+                    url: "/docs/firekit-auth-guard",
                 },
                 {
                     title: "Sign In Page",
-                    url: "/docs/auth/sign-in-page",
+                    url: "/docs/sign-in-page",
                 },
                 {
                     title: "Sign Up Page",
-                    url: "/docs/auth/sign-up-page",
+                    url: "/docs/sign-up-page",
                 },
                 {
                     title: "Reset Password Page",
-                    url: "/docs/auth/reset-password-page",
+                    url: "/docs/reset-password-page",
                 },
                 {
                     title: "Sign In Form",
-                    url: "/docs/auth/sign-in-form",
+                    url: "/docs/sign-in-form",
                 },
                 {
                     title: "Sign Up Form",
-                    url: "/docs/auth/sign-up-form",
+                    url: "/docs/sign-up-form",
                 },
                 {
                     title: "Reset Password Form",
-                    url: "/docs/auth/reset-password-form",
+                    url: "/docs/reset-password-form",
                 },
                 {
                     title: "User Button",
-                    url: "/docs/auth/user-button",
-                }
+                    url: "/docs/user-button",
+                },
             ],
         },
         {
@@ -89,19 +89,19 @@ export const nav = {
             items: [
                 {
                     title: "FirekitDoc",
-                    url: "/docs/firestore/firekit-doc",
+                    url: "/docs/firekit-doc",
                 },
                 {
                     title: "FirekitAwaitableDoc",
-                    url: "/docs/firestore/awaitable-doc",
+                    url: "/docs/awaitable-doc",
                 },
                 {
                     title: "FirekitCollection",
-                    url: "/docs/firestore/firekit-collection",
+                    url: "/docs/firekit-collection",
                 },
                 {
                     title: "Document Mutations",
-                    url: "/docs/firestore/document-mutations",
+                    url: "/docs/document-mutations",
                 },
                 {
                     title: "Collection Component",
@@ -110,7 +110,7 @@ export const nav = {
                 {
                     title: "Doc Component",
                     url: "/docs/firestore/doc-component",
-                }
+                },
             ],
         },
         {
@@ -119,20 +119,20 @@ export const nav = {
             items: [
                 {
                     title: "Download URL",
-                    url: "/docs/storage/download-url",
+                    url: "/docs/download-url",
                 },
                 {
                     title: "Storage List",
-                    url: "/docs/storage/storage-list",
+                    url: "/docs/storage-list",
                 },
                 {
                     title: "Upload Task",
-                    url: "/docs/storage/upload-task",
+                    url: "/docs/upload-task",
                 },
                 {
                     title: "Upload Component",
-                    url: "/docs/storage/upload-component",
-                }
+                    url: "/docs/upload-component",
+                },
             ],
         },
         {
@@ -150,7 +150,7 @@ export const nav = {
                 {
                     title: "Performance Optimization",
                     url: "/docs/advanced/performance-optimization",
-                }
+                },
             ],
         },
     ],

package/dist/components/ui/breadcrumb/breadcrumb-ellipsis.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import DotsHorizontal from "svelte-radix/DotsHorizontal.svelte";
+	import Ellipsis from "lucide-svelte/icons/ellipsis";
 	import type { WithElementRef, WithoutChildren } from "bits-ui";
 	import type { HTMLAttributes } from "svelte/elements";
 	import { cn } from "../../../utils.js";
@@ -18,6 +18,6 @@
 	class={cn("flex size-9 items-center justify-center", className)}
 	{...restProps}
 >
-	<DotsHorizontal class="size-4 outline-none" tabindex={-1} />
+	<Ellipsis class="size-4" />
 	<span class="sr-only">More</span>
 </span>

package/dist/components/ui/breadcrumb/breadcrumb-separator.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-	import ChevronRight from "svelte-radix/ChevronRight.svelte";
+	import ChevronRight from "lucide-svelte/icons/chevron-right";
 	import type { WithElementRef } from "bits-ui";
 	import type { HTMLLiAttributes } from "svelte/elements";
 	import { cn } from "../../../utils.js";

package/dist/components/ui/dialog/dialog-content.svelte

@@ -0,0 +1,36 @@
+<script lang="ts">
+	import { Dialog as DialogPrimitive, type WithoutChildrenOrChild } from "bits-ui";
+	import X from "lucide-svelte/icons/x";
+	import type { Snippet } from "svelte";
+	import * as Dialog from "./index.js";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithoutChildrenOrChild<DialogPrimitive.ContentProps> & {
+		children: Snippet;
+	} = $props();
+</script>
+
+<Dialog.Portal>
+	<Dialog.Overlay />
+	<DialogPrimitive.Content
+		bind:ref
+		class={cn(
+			"bg-background data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] fixed left-[50%] top-[50%] z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border p-6 shadow-lg duration-200 sm:rounded-lg",
+			className
+		)}
+		{...restProps}
+	>
+		{@render children?.()}
+		<DialogPrimitive.Close
+			class="ring-offset-background focus:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground absolute right-4 top-4 rounded-sm opacity-70 transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:pointer-events-none"
+		>
+			<X class="size-4" />
+			<span class="sr-only">Close</span>
+		</DialogPrimitive.Close>
+	</DialogPrimitive.Content>
+</Dialog.Portal>

package/dist/components/ui/dialog/dialog-content.svelte.d.ts

@@ -0,0 +1,6 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+import type { Snippet } from "svelte";
+declare const DialogContent: import("svelte").Component<Omit<Omit<DialogPrimitive.ContentProps, "child">, "children"> & {
+    children: Snippet;
+}, {}, "ref">;
+export default DialogContent;

package/dist/components/ui/dialog/dialog-description.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+	import { Dialog as DialogPrimitive } from "bits-ui";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		...restProps
+	}: DialogPrimitive.DescriptionProps = $props();
+</script>
+
+<DialogPrimitive.Description
+	bind:ref
+	class={cn("text-muted-foreground text-sm", className)}
+	{...restProps}
+/>

package/dist/components/ui/dialog/dialog-description.svelte.d.ts

@@ -0,0 +1,3 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+declare const DialogDescription: import("svelte").Component<DialogPrimitive.DescriptionProps, {}, "ref">;
+export default DialogDescription;

package/dist/components/ui/dialog/dialog-footer.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+	import type { WithElementRef } from "bits-ui";
+	import type { HTMLAttributes } from "svelte/elements";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	class={cn("flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2", className)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/dist/components/ui/dialog/dialog-footer.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { WithElementRef } from "bits-ui";
+import type { HTMLAttributes } from "svelte/elements";
+declare const DialogFooter: import("svelte").Component<WithElementRef<HTMLAttributes<HTMLDivElement>>, {}, "ref">;
+export default DialogFooter;

package/dist/components/ui/dialog/dialog-header.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+	import type { HTMLAttributes } from "svelte/elements";
+	import type { WithElementRef } from "bits-ui";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		children,
+		...restProps
+	}: WithElementRef<HTMLAttributes<HTMLDivElement>> = $props();
+</script>
+
+<div
+	bind:this={ref}
+	class={cn("flex flex-col space-y-1.5 text-center sm:text-left", className)}
+	{...restProps}
+>
+	{@render children?.()}
+</div>

package/dist/components/ui/dialog/dialog-header.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { HTMLAttributes } from "svelte/elements";
+import type { WithElementRef } from "bits-ui";
+declare const DialogHeader: import("svelte").Component<WithElementRef<HTMLAttributes<HTMLDivElement>>, {}, "ref">;
+export default DialogHeader;

package/dist/components/ui/dialog/dialog-overlay.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+	import { Dialog as DialogPrimitive } from "bits-ui";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		...restProps
+	}: DialogPrimitive.OverlayProps = $props();
+</script>
+
+<DialogPrimitive.Overlay
+	bind:ref
+	class={cn(
+		"data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0  fixed inset-0 z-50 bg-black/80",
+		className
+	)}
+	{...restProps}
+/>

package/dist/components/ui/dialog/dialog-overlay.svelte.d.ts

@@ -0,0 +1,3 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+declare const DialogOverlay: import("svelte").Component<DialogPrimitive.OverlayProps, {}, "ref">;
+export default DialogOverlay;

package/dist/components/ui/dialog/dialog-title.svelte

@@ -0,0 +1,16 @@
+<script lang="ts">
+	import { Dialog as DialogPrimitive } from "bits-ui";
+	import { cn } from "../../../utils.js";
+
+	let {
+		ref = $bindable(null),
+		class: className,
+		...restProps
+	}: DialogPrimitive.TitleProps = $props();
+</script>
+
+<DialogPrimitive.Title
+	bind:ref
+	class={cn("text-lg font-semibold leading-none tracking-tight", className)}
+	{...restProps}
+/>

package/dist/components/ui/dialog/dialog-title.svelte.d.ts

@@ -0,0 +1,3 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+declare const DialogTitle: import("svelte").Component<DialogPrimitive.TitleProps, {}, "ref">;
+export default DialogTitle;

package/dist/components/ui/dialog/index.d.ts

@@ -0,0 +1,12 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+import Title from "./dialog-title.svelte";
+import Footer from "./dialog-footer.svelte";
+import Header from "./dialog-header.svelte";
+import Overlay from "./dialog-overlay.svelte";
+import Content from "./dialog-content.svelte";
+import Description from "./dialog-description.svelte";
+declare const Root: typeof DialogPrimitive.Root;
+declare const Trigger: typeof DialogPrimitive.Trigger;
+declare const Close: typeof DialogPrimitive.Close;
+declare const Portal: typeof DialogPrimitive.Portal;
+export { Root, Title, Portal, Footer, Header, Trigger, Overlay, Content, Description, Close, Root as Dialog, Title as DialogTitle, Portal as DialogPortal, Footer as DialogFooter, Header as DialogHeader, Trigger as DialogTrigger, Overlay as DialogOverlay, Content as DialogContent, Description as DialogDescription, Close as DialogClose, };

package/dist/components/ui/dialog/index.js

@@ -0,0 +1,14 @@
+import { Dialog as DialogPrimitive } from "bits-ui";
+import Title from "./dialog-title.svelte";
+import Footer from "./dialog-footer.svelte";
+import Header from "./dialog-header.svelte";
+import Overlay from "./dialog-overlay.svelte";
+import Content from "./dialog-content.svelte";
+import Description from "./dialog-description.svelte";
+const Root = DialogPrimitive.Root;
+const Trigger = DialogPrimitive.Trigger;
+const Close = DialogPrimitive.Close;
+const Portal = DialogPrimitive.Portal;
+export { Root, Title, Portal, Footer, Header, Trigger, Overlay, Content, Description, Close, 
+//
+Root as Dialog, Title as DialogTitle, Portal as DialogPortal, Footer as DialogFooter, Header as DialogHeader, Trigger as DialogTrigger, Overlay as DialogOverlay, Content as DialogContent, Description as DialogDescription, Close as DialogClose, };

package/dist/components/ui/sheet/sheet-content.svelte

@@ -21,7 +21,7 @@
 
 <script lang="ts">
 	import { Dialog as SheetPrimitive, type WithoutChildrenOrChild } from "bits-ui";
-	import Cross2 from "svelte-radix/Cross2.svelte";
+	import X from "lucide-svelte/icons/x";
 	import type { Snippet } from "svelte";
 	import SheetOverlay from "./sheet-overlay.svelte";
 	import { cn } from "../../../utils.js";
@@ -45,7 +45,7 @@
 		<SheetPrimitive.Close
 			class="ring-offset-background focus:ring-ring data-[state=open]:bg-secondary absolute right-4 top-4 rounded-sm opacity-70 transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-offset-2 disabled:pointer-events-none"
 		>
-			<Cross2 class="size-4" />
+			<X class="size-4" />
 			<span class="sr-only">Close</span>
 		</SheetPrimitive.Close>
 	</SheetPrimitive.Content>

package/dist/firebase/auth/auth-guard.svelte.d.ts

@@ -1,23 +1,29 @@
 import type { DocumentData } from "firebase/firestore";
 import { firekitUser } from "./user.svelte.js";
-type GuardConfig = {
+interface GuardConfig {
     authRequired?: boolean;
     redirectTo?: string;
     requiredClaims?: string[];
     requiredData?: (data: DocumentData | null) => boolean;
     allowIf?: (user: typeof firekitUser) => boolean;
-};
+    redirectParams?: Record<string, string>;
+}
 export declare class FirekitAuthGuard {
     private static instance;
     private _loading;
     private _error;
+    private _lastValidationTime;
+    private readonly VALIDATION_THROTTLE;
     private constructor();
     static getInstance(): FirekitAuthGuard;
-    validateAuth({ authRequired, redirectTo, requiredClaims, requiredData, allowIf }?: GuardConfig): Promise<boolean | undefined>;
-    requireAuth(redirectTo?: string): Promise<boolean | undefined>;
-    requireNoAuth(redirectTo?: string): Promise<boolean | undefined>;
-    requireClaims(claims: string[], redirectTo?: string): Promise<boolean | undefined>;
-    requireData(validator: (data: DocumentData | null) => boolean, redirectTo?: string): Promise<boolean | undefined>;
+    private shouldThrottleValidation;
+    private handleRedirect;
+    private validateClaims;
+    validateAuth({ authRequired, redirectTo, requiredClaims, requiredData, allowIf, redirectParams }?: GuardConfig): Promise<boolean>;
+    requireAuth(redirectTo?: string, redirectParams?: Record<string, string>): Promise<boolean>;
+    requireNoAuth(redirectTo?: string, redirectParams?: Record<string, string>): Promise<boolean>;
+    requireClaims(claims: string[], redirectTo?: string, redirectParams?: Record<string, string>): Promise<boolean>;
+    requireData(validator: (data: DocumentData | null) => boolean, redirectTo?: string, redirectParams?: Record<string, string>): Promise<boolean>;
     get loading(): boolean;
     get error(): Error | null;
 }

package/dist/firebase/auth/auth-guard.svelte.js

@@ -5,6 +5,8 @@ export class FirekitAuthGuard {
     static instance;
     _loading = $state(true);
     _error = $state(null);
+    _lastValidationTime = 0;
+    VALIDATION_THROTTLE = 1000; // 1 second
     constructor() { }
     static getInstance() {
         if (!FirekitAuthGuard.instance) {
@@ -12,62 +14,83 @@ export class FirekitAuthGuard {
         }
         return FirekitAuthGuard.instance;
     }
-    async validateAuth({ authRequired = true, redirectTo = '/login', requiredClaims = [], requiredData, allowIf } = {}) {
+    shouldThrottleValidation() {
+        const now = Date.now();
+        if (now - this._lastValidationTime < this.VALIDATION_THROTTLE) {
+            return true;
+        }
+        this._lastValidationTime = now;
+        return false;
+    }
+    async handleRedirect(redirectTo, params) {
+        const url = new URL(redirectTo, window.location.origin);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                url.searchParams.append(key, value);
+            });
+        }
+        await goto(url.toString());
+    }
+    async validateClaims(requiredClaims, userClaims) {
+        if (!requiredClaims.length)
+            return true;
+        if (!userClaims)
+            return false;
+        return requiredClaims.every(claim => userClaims[claim]);
+    }
+    async validateAuth({ authRequired = true, redirectTo = '/login', requiredClaims = [], requiredData, allowIf, redirectParams } = {}) {
         if (!browser)
-            return;
+            return true;
+        if (this.shouldThrottleValidation())
+            return true;
         try {
             this._loading = true;
             this._error = null;
-            // Wait for auth state to be determined
-            // if (firekitUser.loading) {
-            //     await new Promise((resolve) => setTimeout(resolve, 100));
-            // }
             const isAuthenticated = firekitUser.isLoggedIn;
-            // Handle authentication requirement
             if (authRequired && !isAuthenticated) {
-                await goto(redirectTo);
+                await this.handleRedirect(redirectTo, {
+                    ...redirectParams,
+                    returnTo: window.location.pathname
+                });
                 return false;
             }
-            // Handle custom conditions if provided
             if (allowIf && !allowIf(firekitUser)) {
-                await goto(redirectTo);
+                await this.handleRedirect(redirectTo, redirectParams);
                 return false;
             }
-            // Handle required claims if any
             if (requiredClaims.length > 0) {
                 const userClaims = await firekitUser.user?.getIdTokenResult();
-                const hasClaims = requiredClaims.every((claim) => userClaims?.claims[claim]);
+                const hasClaims = await this.validateClaims(requiredClaims, userClaims?.claims);
                 if (!hasClaims) {
-                    await goto(redirectTo);
+                    await this.handleRedirect(redirectTo, redirectParams);
                     return false;
                 }
             }
-            // Handle required data validation if provided
             if (requiredData && !requiredData(firekitUser.data)) {
-                await goto(redirectTo);
+                await this.handleRedirect(redirectTo, redirectParams);
                 return false;
             }
             return true;
         }
         catch (error) {
-            this._error = error;
+            this._error = error instanceof Error ? error : new Error(String(error));
             return false;
         }
         finally {
             this._loading = false;
         }
     }
-    async requireAuth(redirectTo = '/login') {
-        return this.validateAuth({ authRequired: true, redirectTo });
+    async requireAuth(redirectTo = '/login', redirectParams) {
+        return this.validateAuth({ authRequired: true, redirectTo, redirectParams });
     }
-    async requireNoAuth(redirectTo = '/dashboard') {
-        return this.validateAuth({ authRequired: false, redirectTo });
+    async requireNoAuth(redirectTo = '/dashboard', redirectParams) {
+        return this.validateAuth({ authRequired: false, redirectTo, redirectParams });
     }
-    async requireClaims(claims, redirectTo = '/login') {
-        return this.validateAuth({ requiredClaims: claims, redirectTo });
+    async requireClaims(claims, redirectTo = '/login', redirectParams) {
+        return this.validateAuth({ requiredClaims: claims, redirectTo, redirectParams });
     }
-    async requireData(validator, redirectTo = '/login') {
-        return this.validateAuth({ requiredData: validator, redirectTo });
+    async requireData(validator, redirectTo = '/login', redirectParams) {
+        return this.validateAuth({ requiredData: validator, redirectTo, redirectParams });
     }
     get loading() {
         return this._loading;

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { default as ResetPassWordPage } from './auth/reset-password.svelte';
 export { default as ResetPassWordForm } from './components/auth/reset-password-form.svelte';
 export { default as SignInForm } from './components/auth/sign-in-form.svelte';
 export { default as SignUpForm } from './components/auth/sign-up-form.svelte';
-export { default as UserButton } from './components/auth/user-button.svelte';
+export { default as UserButton } from './components/auth/user-button/user-button.svelte';
 export { default as Collection } from './components/firestore/collection.svelte';
 export { default as Doc } from './components/firestore/doc.svelte';
 export { default as Upload } from './components/storage/upload.svelte';

package/dist/index.js

@@ -21,7 +21,7 @@ export { default as ResetPassWordPage } from './auth/reset-password.svelte';
 export { default as ResetPassWordForm } from './components/auth/reset-password-form.svelte';
 export { default as SignInForm } from './components/auth/sign-in-form.svelte';
 export { default as SignUpForm } from './components/auth/sign-up-form.svelte';
-export { default as UserButton } from './components/auth/user-button.svelte';
+export { default as UserButton } from './components/auth/user-button/user-button.svelte';
 // firestore components
 export { default as Collection } from './components/firestore/collection.svelte';
 export { default as Doc } from './components/firestore/doc.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "svelte-firekit",
-	"version": "0.0.4",
+	"version": "0.0.6",
 	"license": "MIT",
 	"scripts": {
 		"dev": "vite dev",
@@ -53,7 +53,7 @@
 		"@sveltejs/vite-plugin-svelte": "^4.0.0",
 		"@tailwindcss/typography": "^0.5.15",
 		"autoprefixer": "^10.4.20",
-		"bits-ui": "^1.0.0-next.52",
+		"bits-ui": "^1.0.0-next.60",
 		"clsx": "^2.1.1",
 		"formsnap": "^2.0.0-next.1",
 		"lucide-svelte": "^0.456.0",