svidentity

A dead simple Svelte-based identity provider with callback support that’s easy to integrate with.

---

Features

• Simple Integration: Built with simplicity in mind, making it easy to integrate with your existing projects.
• Svelte-Powered: Lightweight and fast frontend using Svelte.
• Callback Support: Seamlessly handle authentication callbacks for a smooth user experience.
• Customizable: Easily adapt the provider to fit your specific authentication requirements.

---

Getting Started

Prerequisites

Before setting up svidentity, ensure you have the following installed:

• Node.js (v16+ recommended)
• npm or pnpm

Installation

1. Clone the repository:

   git clone https://github.com/owenrummage/svidentity.git
   cd svidentity
   

2. Install dependencies:

   npm install
   # or
   pnpm install
   

3. Start the development server:

   npm run dev
   

   By default, the application will be available at http://localhost:5173.

---

Configuration

Environment Variables

Create a .env file in the root directory to configure your environment. The following variables are supported:

• DATABASE_URL: Your database URL for data storage

Customization

To customize svidentity, modify the Svelte components located in the src/routes directory. Key files include:

• src/routes/login/+page.svelte: The login page.
• src/routes/reigster/+page.svelte: Displays user information.

---

How to use

The usage is very simple, all you need are three files.

// src/lib/auth.ts
import { redirect } from '@sveltejs/kit';

const AUTH_SERVER = 'http://localhost:5173';
const APP_DOMAIN = 'http://localhost:5174';

export async function getUser(sessionToken: string | undefined) {
	console.log(sessionToken);
	if (sessionToken) {
		try {
			// Call the API to get user information
			const response = await fetch(`${AUTH_SERVER}/api/me`, {
				headers: {
					Cookie: `session_id=${sessionToken}`
				}
			});

			// If the response is not OK, redirect to AUTH_URL
			if (!response.ok) {
				throw new Error(`Fetch error: ` + response.status);
			}

			// Parse and return the user data
			const user = await response.json();
			return {
				user
			};
		} catch (error) {
			// On any error, redirect to the AUTH_URL
			throw error;
		}
	} else {
		redirect(302, `${AUTH_SERVER}/login?redirect=${APP_DOMAIN}/callback`);
	}
}

// src/hooks.server.ts
import { getUser } from '$lib/auth';
import type { Handle } from '@sveltejs/kit';

export const handle: Handle = async ({ event, resolve }) => {
	let data = await getUser(event.cookies.get('session_id'));

	event.locals.user = data.user;
	const response = await resolve(event);
	return response;
};

// src/routes/+layout.server.ts
import { getUser } from '$lib/auth';
import type { LayoutServerLoad } from './$types';

export const load: LayoutServerLoad = async ({ locals }) => {
	// Access the user data set in hooks.server.ts
	const user = locals.user;

	return {
		user
	};
};

With these three items you can auto-autnticate every single page. Please keep in mind this requires authentication across the entire app, and this might need to be changed for your implementation. You can use an easy per-page or per-folder way using the code below in the +layout.server.ts file

// src/routes/+layout.server.ts
import { getUser } from '$lib/auth';
import type { LayoutServerLoad } from './$types';

export const load: LayoutServerLoad = async ({ locals, cookies }) => {
	// Access the user data set in hooks.server.ts
	const data = await getUser(cookies.get('session_id'));

	return {
		user: data.user
	};
};

---

Contributing

Contributions are welcome! If you’d like to contribute to svidentity, please follow these steps:

1. Fork the repository.

2. Create a new branch:

   git checkout -b feature/your-feature-name
   

3. Make your changes and commit them:

   git commit -m "Add your feature description"
   

4. Push to your branch:

   git push origin feature/your-feature-name
   

5. Open a pull request.

---

License

This project is licensed under the MIT License. See the LICENSE file for more information.

---

Contact

For questions or support, please contact Owen Rummage via GitHub Issues.

---

Acknowledgments

Special thanks to the Svelte community for their tools and resources.