startx 0.0.1 → 0.1.1

package/packages/@repo/db/src/schema/common.ts

@@ -1,49 +1,45 @@
-import { pgTable, uuid, varchar, timestamp, pgEnum, text } from "drizzle-orm/pg-core";
-
-// Helper function to generate current timestamp
-
-export const userRoleEnum = pgEnum("user_role", ["user", "admin", "superuser"]);
-
-export const usersTable = pgTable("users", {
-	id: uuid("id").primaryKey().defaultRandom(),
-	email: varchar("email", { length: 255 }).notNull().unique(),
-	fullName: varchar("full_name", { length: 255 }).default("Guest").notNull(),
-	password: varchar("password", { length: 255 }).default("foresight").notNull(),
-	countries: varchar("countries", { length: 255 }).array().notNull().default([]),
-	verifiedAt: timestamp("verified_at"),
-	pwdUpdatedAt: timestamp("pwd_updated_at"),
-	deletedAt: timestamp("deleted_at"),
-	createdAt: timestamp("created_at").defaultNow(),
-	lastLoginAt: timestamp("last_login_at").defaultNow(),
-	updatedAt: timestamp("updated_at")
-		.defaultNow()
-		.$onUpdate(() => new Date()),
-});
-
-export const filesTable = pgTable("files", {
-	id: uuid("id").primaryKey().defaultRandom(),
-	fileName: varchar("file_name", { length: 255 }).notNull(),
-	url: text("url").notNull(),
-	mimetype: text("mimetype").notNull(),
-	preview: text("preview"),
-	createdAt: timestamp("created_at").defaultNow(),
-	updatedAt: timestamp("updated_at")
-		.defaultNow()
-		.$onUpdate(() => new Date()),
-});
-
-export const otps = pgTable("otp", {
-	id: uuid("id").primaryKey().defaultRandom(),
-	email: varchar("email", { length: 255 }).notNull().unique(),
-	phone: varchar("phone", { length: 50 }),
-	status: varchar("status", { enum: ["pending", "verified"] })
-		.notNull()
-		.default("pending"),
-	otp: varchar("otp", { length: 255 }).notNull(),
-	createdAt: timestamp("created_at").defaultNow(),
-	updatedAt: timestamp("updated_at")
-		.defaultNow()
-		.$onUpdate(() => new Date()),
-});
-
-// ----------------------------------------------------------------------------
+import { pgEnum, pgTable, text, timestamp, uuid, varchar } from "drizzle-orm/pg-core";
+
+export const userRoleEnum = pgEnum("user_role", ["user", "admin", "superuser"]);
+
+export const usersTable = pgTable("users", {
+	id: uuid("id").primaryKey().defaultRandom(),
+	email: varchar("email", { length: 255 }).notNull().unique(),
+	fullName: varchar("full_name", { length: 255 }).default("Guest").notNull(),
+	password: varchar("password", { length: 255 }).default("foresight").notNull(),
+	countries: varchar("countries", { length: 255 }).array().notNull().default([]),
+	verifiedAt: timestamp("verified_at"),
+	pwdUpdatedAt: timestamp("pwd_updated_at"),
+	deletedAt: timestamp("deleted_at"),
+	createdAt: timestamp("created_at").defaultNow(),
+	lastLoginAt: timestamp("last_login_at").defaultNow(),
+	updatedAt: timestamp("updated_at")
+		.defaultNow()
+		.$onUpdate(() => new Date()),
+});
+
+export const filesTable = pgTable("files", {
+	id: uuid("id").primaryKey().defaultRandom(),
+	fileName: varchar("file_name", { length: 255 }).notNull(),
+	url: text("url").notNull(),
+	mimetype: text("mimetype").notNull(),
+	preview: text("preview"),
+	createdAt: timestamp("created_at").defaultNow(),
+	updatedAt: timestamp("updated_at")
+		.defaultNow()
+		.$onUpdate(() => new Date()),
+});
+
+export const otps = pgTable("otp", {
+	id: uuid("id").primaryKey().defaultRandom(),
+	email: varchar("email", { length: 255 }).notNull().unique(),
+	phone: varchar("phone", { length: 50 }),
+	status: varchar("status", { enum: ["pending", "verified"] })
+		.notNull()
+		.default("pending"),
+	otp: varchar("otp", { length: 255 }).notNull(),
+	createdAt: timestamp("created_at").defaultNow(),
+	updatedAt: timestamp("updated_at")
+		.defaultNow()
+		.$onUpdate(() => new Date()),
+});

package/packages/@repo/env/eslint.config.ts

@@ -0,0 +1,4 @@
+import { baseConfig } from "eslint-config/base";
+import { extend } from "eslint-config/extend";
+
+export default extend(baseConfig);

package/packages/@repo/env/package.json

@@ -0,0 +1,39 @@
+{
+	"name": "@repo/env",
+	"version": "0.0.0",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"clean": "rimraf dist .turbo",
+		"watch:dev": "pnpm watch",
+		"typecheck": "tsc --noEmit",
+		"format": "biome format --write .",
+		"format:check": "biome ci .",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"watch": "tsc -p tsconfig.build.json --watch"
+	},
+	"exports": "./src/index.ts",
+	"types": "./src/index.ts",
+
+	"devDependencies": {
+		"eslint-config": "workspace:*",
+		"typescript-config": "workspace:*",
+		"vitest": "catalog:",
+		"vitest-config": "workspace:*"
+	},
+	"dependencies": {
+		"dotenv": "catalog:"
+	},
+	"startx": {
+		"tags": [
+			"node"
+		],
+		"requiredDeps": [
+			"@repo/env"
+		],
+		"requiredDevDeps": [
+			"typescript-config"
+		]
+	}
+}

package/packages/@repo/env/src/default-env.ts

@@ -0,0 +1,12 @@
+import z from "zod";
+
+import { defineEnv } from "./define-env.js";
+
+export const ENV = defineEnv({
+	NODE_ENV: z.enum(["development", "production", "test", "staging"]).default("production"),
+	CLIENT_URL: z.string().optional().default("http://localhost:5000"),
+	SERVER_URL: z.string().optional().default("http://localhost:3000"),
+	CORS_URL: z.string().optional().default("http://localhost:3000"),
+	PORT: z.string().optional().default("3000"),
+	LOG_LEVEL: z.enum(["error", "warn", "info", "http", "debug"]).default("debug"),
+});

package/packages/@repo/env/src/define-env.ts

@@ -0,0 +1,70 @@
+import type { ZodTypeAny } from "zod";
+import { ZodError, z } from "zod";
+
+import { loadDotenv } from "./utils.js";
+
+loadDotenv();
+
+type SpecEntry =
+	| ZodTypeAny
+	| {
+			schema: ZodTypeAny;
+			default?: unknown;
+			env?: string;
+			description?: string;
+	  };
+
+type Spec = Record<string, SpecEntry>;
+
+type InferSpec<S extends Spec> = {
+	[K in keyof S]: S[K] extends ZodTypeAny
+		? z.infer<S[K]>
+		: S[K] extends { schema: ZodTypeAny }
+			? z.infer<S[K]["schema"]>
+			: never;
+};
+
+function isZod(v: SpecEntry): v is ZodTypeAny {
+	return typeof v === "object" && v !== null && "parse" in v;
+}
+
+const tempEnv = new Map<string, string>();
+
+export function defineEnv<S extends Spec>(spec: S): InferSpec<S> {
+	const rawEnv: Record<string, unknown> = {};
+	const zodShape: Record<string, ZodTypeAny> = {};
+
+	for (const key of Object.keys(spec) as Array<keyof S>) {
+		const entry = spec[key];
+
+		const normalized = isZod(entry)
+			? { schema: entry, default: undefined, env: key as string }
+			: {
+					schema: entry.schema,
+					default: entry.default,
+					env: entry.env ?? (key as string),
+				};
+
+		if (process.env[normalized.env]) {
+			tempEnv.set(normalized.env, process.env[normalized.env] ?? "");
+			delete process.env[normalized.env];
+		}
+		const raw = tempEnv.get(normalized.env);
+
+		rawEnv[key as string] = raw === undefined ? normalized.default : raw;
+
+		zodShape[key as string] = normalized.schema;
+	}
+
+	try {
+		const result = z.object(zodShape).parse(rawEnv);
+		return result as InferSpec<S>;
+	} catch (err: unknown) {
+		if (err instanceof ZodError) {
+			const messages = err.issues.map(e => `${e.path.join(".")}: ${e.message}`);
+
+			throw new Error(`Invalid environment variables:\n  ❌ ${messages.join("\n  ❌ ")}`);
+		}
+		throw err;
+	}
+}

package/packages/@repo/env/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./default-env.js";
+export { defineEnv } from "./define-env.js";

package/packages/@repo/env/src/utils.ts

@@ -0,0 +1,52 @@
+process.env.DOTENV_CONFIG_QUIET = "true";
+
+import { config } from "dotenv";
+import path from "path";
+import { fileURLToPath } from "url";
+
+/**
+ * Resolve a stable project root:
+ * - prefer explicit PROJECT_ROOT env var if set (handy for CI)
+ * - else, base on this file's location (safe in ESM)
+ * - fallback to process.cwd()
+ */
+export function projectRoot() {
+	if (process.env.PROJECT_ROOT) return path.resolve(process.env.PROJECT_ROOT);
+	try {
+		const __filename = fileURLToPath(import.meta.url);
+		const thisDir = path.dirname(__filename);
+		return path.resolve(thisDir, "../../../../");
+	} catch (error) {
+		console.error({ error });
+		return process.cwd();
+	}
+}
+
+/**
+ * Load .env files with a clear precedence:
+ * - test: .env.test (and optional .env.test.local)
+ * - otherwise: .env -> .env.local (local should override .env)
+ *
+ * Behavior: load base first, then local override with override: true so local wins.
+ */
+export function loadDotenv(opts?: { root?: string }) {
+	const root = opts?.root ?? projectRoot();
+
+	if (process.env.NODE_ENV === "test") {
+		config({ path: path.join(root, ".env.test") });
+		// optional: if you want local test overrides
+		config({ path: path.join(root, ".env.test.local"), override: true });
+		return;
+	}
+
+	// production/dev flow
+	config({ path: path.join(process.cwd(), ".env") }); // prod
+	// dev env
+	config({ path: path.join(root, ".env") });
+	// .env.local should override the base (for dev machine secrets)
+	config({ path: path.join(root, ".env.local"), override: true });
+	// also load .env.${NODE_ENV}.local if you want per-env local overrides:
+	if (process.env.NODE_ENV) {
+		config({ path: path.join(root, `.env.${process.env.NODE_ENV}.local`), override: true });
+	}
+}

package/packages/@repo/env/tsconfig.json

@@ -0,0 +1,7 @@
+{
+	"extends": "typescript-config/tsconfig.node.json",
+	"compilerOptions": {
+		"baseUrl": "./src"
+	},
+	"include": ["src/**/*.ts"]
+}

package/packages/@repo/lib/eslint.config.ts

@@ -0,0 +1,4 @@
+import { baseConfig } from "eslint-config/base";
+import { extend } from "eslint-config/extend";
+
+export default extend(baseConfig);

package/packages/@repo/lib/package.json

@@ -1,6 +1,7 @@
 {
 	"name": "@repo/lib",
 	"version": "0.0.0",
+	"type": "module",
 	"private": true,
 	"scripts": {
 		"clean": "rimraf dist .turbo",
@@ -12,46 +13,45 @@
 		"lint:fix": "eslint . --fix",
 		"watch": "tsc -p tsconfig.build.json --watch"
 	},
-	"files": [
-		"dist/**/*"
-	],
-	"exports": "./src/index.ts",
+	"exports": {
+		".": "./src/index.ts",
+		"./*": "./src/*/index.ts"
+	},
 	"devDependencies": {
-		"@repo/email": "workspace:*",
-		"@repo/redis": "workspace:*",
-		"@types/eslint": "^8.56.5",
-		"@types/express": "^5.0.0",
-		"@types/node": "^20.16.5",
 		"@types/jsonwebtoken": "^9.0.7",
 		"@types/nodemailer": "^6.4.16",
 		"eslint-config": "workspace:*",
-		"tsc-alias": "^1.8.10",
 		"typescript-config": "workspace:*",
-		"vitest": "catalog:",
-		"vitest-config": "workspace:*",
-		"vitest-mock-extended": "^3.1.0",
-		"vine": "link:@types/vinejs/vine"
+		"vine": "link:@types/vinejs/vine",
+		"vitest-config": "workspace:*"
 	},
 	"dependencies": {
-		"@aws-sdk/client-s3": "^3.693.0",
-		"@repo/db": "workspace:^",
-		"@types/express-fileupload": "^1.5.1",
-		"@vinejs/vine": "^4.3.0",
-		"@repo/email": "workspace:*",
-		"axios": "^1.7.7",
-		"bcryptjs": "^3.0.2",
-		"country-state-city": "^3.2.1",
-		"dayjs": "^1.11.13",
-		"dayjs-plugin-utc": "^0.1.2",
-		"dotenv": "^16.6.1",
-		"drizzle-orm": "^0.36.0",
-		"express": "^4.21.1",
-		"express-fileupload": "^1.5.1",
-		"firebase-admin": "^13.0.2",
-		"fs.promises.exists": "^1.1.4",
-		"jsonwebtoken": "^9.0.2",
-		"nodemailer": "^6.9.16",
-		"winston": "^3.16.0",
-		"winston-daily-rotate-file": "^5.0.0"
+		"@repo/redis": "workspace:*",
+		"@aws-sdk/client-s3": "catalog:",
+		"@repo/mail": "workspace:*",
+		"@repo/logger": "workspace:*",
+		"@repo/env": "workspace:*",
+		"@types/express": "catalog:",
+		"@types/express-fileupload": "catalog:",
+		"bcryptjs": "catalog:",
+		"firebase-admin": "catalog:",
+		"jsonwebtoken": "catalog:",
+		"nodemailer": "catalog:",
+		"yaml": "^2.8.2"
+	},
+	"startx": {
+		"tags": [
+			"node",
+			"backend"
+		],
+		"requiredDeps": [
+			"@repo/env",
+			"@repo/logger",
+			"@repo/mail",
+			"@repo/redis"
+		],
+		"requiredDevDeps": [
+			"typescript-config"
+		]
 	}
 }

package/packages/@repo/lib/src/bucket-module/file-storage.ts

@@ -1,49 +1,50 @@
-import type { UploadedFile } from "express-fileupload";
-import fs from "fs";
-import path from "path";
-
-import { logger } from "../logger-module/logger";
-import { Random } from "../utils";
-
-export class FileBasedBucket {
-	static async upload(file: UploadedFile, subpath?: string) {
-		const fileName = Random.generateString(4, "hex") + path.extname(file.name);
-		const filePath = path.join(process.cwd(), "storage", subpath ?? "", fileName);
-		await FileBasedBucket.createDirectoryIfNotExists(`storage/${subpath ?? ""}`);
-		await file.mv(filePath);
-		const publicUrl = FileBasedBucket.getPublicUrl(`${subpath ?? ""}/${fileName}`);
-		return publicUrl;
-	}
-	static deleteFile(url: string) {
-		const filePath = FileBasedBucket.getPath(url);
-		try {
-			fs.unlinkSync(filePath);
-		} catch (error) {
-			logger.error("Error deleting file:", error);
-		}
-	}
-
-	static getPath(url: string) {
-		const path = url.replace(`${process.env.SERVER_URL}/files/`, `${process.cwd()}/storage/`);
-		return path;
-	}
-
-	static getPublicUrl(key: string) {
-		return path.join(process.env.SERVER_URL, "/files", key);
-	}
-
-	static async createDirectoryIfNotExists(path: string) {
-		return await new Promise<boolean>((resolve, reject) => {
-			if (fs.existsSync(path)) {
-				resolve(true);
-			} else {
-				fs.mkdir(path, { recursive: true }, (err) => {
-					if (err) {
-						reject(err);
-					}
-					resolve(true);
-				});
-			}
-		});
-	}
-}
+import { ENV } from "@repo/env";
+import { logger } from "@repo/logger";
+import type { UploadedFile } from "express-fileupload";
+import fs from "fs";
+import path from "path";
+
+import { Random } from "../utils.js";
+
+export class FileBasedBucket {
+	static async upload(file: UploadedFile, subpath?: string) {
+		const fileName = Random.generateString(4, "hex") + path.extname(file.name);
+		const filePath = path.join(process.cwd(), "storage", subpath ?? "", fileName);
+		await FileBasedBucket.createDirectoryIfNotExists(`storage/${subpath ?? ""}`);
+		await file.mv(filePath);
+		const publicUrl = FileBasedBucket.getPublicUrl(`${subpath ?? ""}/${fileName}`);
+		return publicUrl;
+	}
+	static deleteFile(url: string) {
+		const filePath = FileBasedBucket.getPath(url);
+		try {
+			fs.unlinkSync(filePath);
+		} catch (error) {
+			logger.error("Error deleting file:", error);
+		}
+	}
+
+	static getPath(url: string) {
+		const path = url.replace(`${ENV.SERVER_URL}/files/`, `${process.cwd()}/storage/`);
+		return path;
+	}
+
+	static getPublicUrl(key: string) {
+		return path.join(ENV.SERVER_URL, "/files", key);
+	}
+
+	static async createDirectoryIfNotExists(path: string) {
+		return await new Promise<boolean>((resolve, reject) => {
+			if (fs.existsSync(path)) {
+				resolve(true);
+			} else {
+				fs.mkdir(path, { recursive: true }, err => {
+					if (err) {
+						reject(err);
+					}
+					resolve(true);
+				});
+			}
+		});
+	}
+}

package/packages/@repo/lib/src/bucket-module/index.ts

@@ -0,0 +1,3 @@
+export * from "./file-storage.js";
+export * from "./s3-storage.js";
+export * from "./utils.js";