Skip to main content

API Endpoints

Location: routes/api/ (inside your module repo)

API endpoints handle requests, call repositories, and return JSON. The base path is /api/<ModuleId>.

Standard CRUD Endpoint (+server.ts)​

import { json, error } from '@sveltejs/kit';
import type { RequestHandler } from './$types';
import { z } from 'zod';
import { MyRepository } from '$lib/repositories/external_modules/MoLOS-Example/my-repository';
import { db } from '$lib/server/db';

const repo = new MyRepository(db);
const CreateItemSchema = z.object({
	title: z.string().min(1, 'Title is required')
});

export const GET: RequestHandler = async ({ locals }) => {
	const userId = locals.user?.id;
	if (!userId) throw error(401, 'Unauthorized');
	
	const items = await repo.getByUserId(userId);
	return json(items);
};

export const POST: RequestHandler = async ({ locals, request }) => {
	const userId = locals.user?.id;
	if (!userId) throw error(401, 'Unauthorized');

	const data = CreateItemSchema.parse(await request.json());
	const newItem = await repo.create({ ...data, userId });
	return json(newItem, { status: 201 });
};

Key Patterns​

  • Authentication: Always verify the user via locals.user?.id.
  • Validation: Validate payloads with zod.
  • Error Handling: Use consistent HTTP error codes.
  • Separation of Concerns: Keep API logic thin; push logic into repositories.