first commit

types/config/auth.ts

@@ -0,0 +1,32 @@
+type JWTConfig = {
+	secret: string;
+	expiration: string | number;
+	issuer: string;
+	algorithm: string;
+};
+
+interface CookieOptions {
+	secure?: boolean;
+	httpOnly?: boolean;
+	sameSite?: "Strict" | "Lax" | "None";
+	path?: string;
+	domain?: string;
+}
+
+interface UserSession {
+	id: string;
+	username: string;
+	email: string;
+	isVerified: boolean;
+	displayName: string | null;
+	createdAt: string; // ISO date string
+	updatedAt?: string; // ISO date string, optional
+	iat?: number; // issued at (added by JWT libs)
+	exp?: number; // expiration (added by JWT libs)
+}
+
+interface SessionData extends UserSession {
+	userAgent: string;
+}
+
+export type { JWTConfig, CookieOptions, UserSession, SessionData };

types/config/database.ts

@@ -0,0 +1,25 @@
+type CassandraConfig = {
+	host: string;
+	port: number;
+	keyspace: string;
+	username: string;
+	password: string;
+	datacenter: string;
+	contactPoints: string[];
+	authEnabled: boolean;
+};
+
+type SqlMigration = {
+	id: string;
+	name: string;
+	upSql: string;
+	downSql?: string | undefined;
+};
+
+type ConnectionOptions = {
+	withKeyspace?: boolean;
+	timeout?: number;
+	logging?: boolean;
+};
+
+export type { CassandraConfig, SqlMigration, ConnectionOptions };

types/config/environment.ts

@@ -0,0 +1,7 @@
+type Environment = {
+	port: number;
+	host: string;
+	development: boolean;
+};
+
+export type { Environment };

types/config/index.ts

@@ -0,0 +1,3 @@
+export * from "./environment";
+export * from "./database";
+export * from "./auth";

types/index.ts

@@ -0,0 +1,3 @@
+export * from "./server";
+export * from "./config";
+export * from "./lib";

types/lib/index.ts

@@ -0,0 +1 @@
+export * from "./validation";

types/lib/validation.ts

@@ -0,0 +1,13 @@
+type genericValidation = {
+	length: { min: number; max: number };
+	regex: RegExp;
+};
+
+type validationResult = {
+	valid: boolean;
+	error?: string;
+	username?: string;
+	name?: string;
+};
+
+export type { genericValidation, validationResult };

types/server/index.ts

@@ -0,0 +1,3 @@
+export * from "./server";
+export * from "./routes";
+export * from "./requests";

types/server/requests/index.ts

@@ -0,0 +1 @@
+export * from "./user";

types/server/requests/user/base.ts

@@ -0,0 +1,28 @@
+interface BaseResponse {
+	code: number;
+	success: boolean;
+	error?: string;
+	message?: string;
+}
+
+interface UserResponse {
+	id: string;
+	username: string;
+	email: string;
+	isVerified: boolean;
+	createdAt: string;
+	displayName: string | null;
+}
+
+interface UserRow {
+	id: string;
+	username: string;
+	display_name: string | null;
+	email: string;
+	password: string;
+	is_verified: boolean;
+	created_at: Date;
+	updated_at: Date;
+}
+
+export type { BaseResponse, UserResponse, UserRow };

types/server/requests/user/index.ts

@@ -0,0 +1,6 @@
+export * from "./base";
+export * from "./responses";
+export * from "./register";
+export * from "./login";
+
+export * from "./update";

types/server/requests/user/login.ts

@@ -0,0 +1,12 @@
+import type { BaseResponse, UserResponse } from "./base";
+
+interface LoginRequest {
+	identifier: string; // Username or email
+	password: string;
+}
+
+interface LoginResponse extends BaseResponse {
+	user?: UserResponse;
+}
+
+export type { LoginRequest, LoginResponse };

types/server/requests/user/password.ts

@@ -0,0 +1,7 @@
+interface UpdatePasswordRequest {
+	currentPassword: string;
+	newPassword: string;
+	logoutAllSessions?: boolean; // defaults to false
+}
+
+export type { UpdatePasswordRequest };

types/server/requests/user/register.ts

@@ -0,0 +1,14 @@
+import type { BaseResponse, UserResponse } from "./base";
+
+interface RegisterRequest {
+	username: string;
+	displayName: string | null;
+	email: string;
+	password: string;
+}
+
+interface RegisterResponse extends BaseResponse {
+	user?: UserResponse;
+}
+
+export type { RegisterRequest, RegisterResponse };

types/server/requests/user/responses.ts

@@ -0,0 +1,7 @@
+import type { BaseResponse, UserResponse } from "./base";
+
+interface UserInfoResponse extends BaseResponse {
+	user?: UserResponse;
+}
+
+export type { UserInfoResponse };

types/server/requests/user/update/index.ts

@@ -0,0 +1,2 @@
+export * from "./info";
+export * from "./password";

types/server/requests/user/update/info.ts

@@ -0,0 +1,13 @@
+import type { BaseResponse, UserResponse } from "../base";
+
+interface UpdateInfoRequest {
+	username?: string;
+	displayName?: string | null;
+	email?: string;
+}
+
+interface UpdateInfoResponse extends BaseResponse {
+	user?: UserResponse;
+}
+
+export type { UpdateInfoRequest, UpdateInfoResponse };

types/server/requests/user/update/password.ts

@@ -0,0 +1,14 @@
+import type { BaseResponse, UserResponse } from "../base";
+
+interface UpdatePasswordRequest {
+	currentPassword: string;
+	newPassword: string;
+	logoutAllSessions?: boolean; // defaults to false
+}
+
+interface UpdatePasswordResponse extends BaseResponse {
+	user?: UserResponse;
+	loggedOutSessions?: number;
+}
+
+export type { UpdatePasswordRequest, UpdatePasswordResponse };

types/server/routes.ts

@@ -0,0 +1,20 @@
+import type { Server } from "bun";
+import type { ExtendedRequest } from "./server";
+
+type RouteDef = {
+	method: string | string[];
+	accepts: string | null | string[];
+	returns: string;
+	needsBody?: "multipart" | "json";
+};
+
+type RouteModule = {
+	handler: (
+		request: Request | ExtendedRequest,
+		requestBody: unknown,
+		server: Server,
+	) => Promise<Response> | Response;
+	routeDef: RouteDef;
+};
+
+export type { RouteDef, RouteModule };

types/server/server.ts

@@ -0,0 +1,10 @@
+type Query = Record<string, string>;
+type Params = Record<string, string>;
+
+interface ExtendedRequest extends Request {
+	startPerf: number;
+	query: Query;
+	params: Params;
+}
+
+export type { ExtendedRequest, Query, Params };