@env-hopper/backend-core 2.0.1-alpha.2 → 2.0.1-alpha.4

package/dist/index.js

@@ -13,6 +13,8 @@ import { stepCountIs, streamText, tool } from "ai";
 import multer from "multer";
 import { readFileSync, readdirSync } from "node:fs";
 import { extname, join } from "node:path";
+import express, { Router } from "express";
+import * as trpcExpress from "@trpc/server/adapters/express";
 
 //#region src/db/client.ts
 let prismaClient = null;
@@ -25,6 +27,13 @@ function getDbClient() {
 	return prismaClient;
 }
 /**
+* Sets the internal Prisma client instance.
+* Used by middleware to bridge with existing getDbClient() usage.
+*/
+function setDbClient(client) {
+	prismaClient = client;
+}
+/**
 * Connects to the database.
 * Call this before performing database operations.
 */
@@ -1802,5 +1811,370 @@ async function syncScreenshotsFromDirectory(prisma, screenshotsDir) {
 }
 
 //#endregion
-export { DEFAULT_ADMIN_SYSTEM_PROMPT, TABLE_SYNC_MAGAZINE, connectDb, createAdminChatHandler, createAppCatalogAdminRouter, createAuth, createAuthRouter, createDatabaseTools, createEhTrpcContext, createPrismaDatabaseClient, createScreenshotRouter, createTrpcRouter, disconnectDb, getAdminGroupsFromEnv, getAssetByName, getAuthPluginsFromEnv, getAuthProvidersFromEnv, getDbClient, getUserGroups, isAdmin, isMemberOfAllGroups, isMemberOfAnyGroup, registerAssetRestController, registerAuthRoutes, registerIconRestController, registerScreenshotRestController, requireAdmin, requireGroups, staticControllerContract, syncAppCatalog, syncAssets, tableSyncPrisma, tool, upsertIcon, upsertIcons, validateAuthConfig };
+//#region src/middleware/database.ts
+/**
+* Formats a database connection URL from structured config.
+*/
+function formatConnectionUrl(config) {
+	if ("url" in config) return config.url;
+	const { host, port, database, username, password, schema = "public" } = config;
+	return `postgresql://${username}:${encodeURIComponent(password)}@${host}:${port}/${database}?schema=${schema}`;
+}
+/**
+* Internal database manager used by the middleware.
+* Handles connection URL formatting and lifecycle.
+*/
+var EhDatabaseManager = class {
+	constructor(config) {
+		this.client = null;
+		this.config = config;
+	}
+	/**
+	* Get or create the Prisma client instance.
+	* Uses lazy initialization for flexibility.
+	*/
+	getClient() {
+		if (!this.client) {
+			this.client = new PrismaClient({
+				datasourceUrl: formatConnectionUrl(this.config),
+				log: process.env.NODE_ENV === "development" ? ["warn", "error"] : ["warn", "error"]
+			});
+			setDbClient(this.client);
+		}
+		return this.client;
+	}
+	async connect() {
+		await this.getClient().$connect();
+	}
+	async disconnect() {
+		if (this.client) {
+			await this.client.$disconnect();
+			this.client = null;
+		}
+	}
+};
+
+//#endregion
+//#region src/middleware/backendResolver.ts
+/**
+* Type guard to check if an object implements EhBackendCompanySpecificBackend.
+*/
+function isBackendInstance(obj) {
+	return typeof obj === "object" && obj !== null && typeof obj.getBootstrapData === "function" && typeof obj.getAvailabilityMatrix === "function" && typeof obj.getNameMigrations === "function" && typeof obj.getResourceJumps === "function" && typeof obj.getResourceJumpsExtended === "function";
+}
+/**
+* Normalizes different backend provider types into a consistent async factory function.
+* Supports:
+* - Direct object implementing EhBackendCompanySpecificBackend
+* - Sync factory function that returns the backend
+* - Async factory function that returns the backend
+*/
+function createBackendResolver(provider) {
+	if (isBackendInstance(provider)) return async () => provider;
+	if (typeof provider === "function") return async () => {
+		const result = provider();
+		return result instanceof Promise ? result : result;
+	};
+	throw new Error("Invalid backend provider: must be an object implementing EhBackendCompanySpecificBackend or a factory function");
+}
+
+//#endregion
+//#region src/modules/appCatalogAdmin/catalogBackupController.ts
+/**
+* Export the complete app catalog as JSON
+* Includes all fields from DbAppForCatalog
+*/
+async function exportCatalog(_req, res) {
+	try {
+		const apps = await getDbClient().dbAppForCatalog.findMany({ orderBy: { slug: "asc" } });
+		res.json({
+			version: "1.0",
+			exportDate: (/* @__PURE__ */ new Date()).toISOString(),
+			apps
+		});
+	} catch (error) {
+		console.error("Error exporting catalog:", error);
+		res.status(500).json({ error: "Failed to export catalog" });
+	}
+}
+/**
+* Import/restore the complete app catalog from JSON
+* Overwrites existing data
+*/
+async function importCatalog(req, res) {
+	try {
+		const prisma = getDbClient();
+		const { apps } = req.body;
+		if (!Array.isArray(apps)) {
+			res.status(400).json({ error: "Invalid data format: apps must be an array" });
+			return;
+		}
+		await prisma.$transaction(async (tx) => {
+			await tx.dbAppForCatalog.deleteMany({});
+			for (const app of apps) {
+				const { id, createdAt, updatedAt,...appData } = app;
+				await tx.dbAppForCatalog.create({ data: appData });
+			}
+		});
+		res.json({
+			success: true,
+			imported: apps.length
+		});
+	} catch (error) {
+		console.error("Error importing catalog:", error);
+		res.status(500).json({ error: "Failed to import catalog" });
+	}
+}
+/**
+* Export an asset (icon or screenshot) by name
+*/
+async function exportAsset(req, res) {
+	try {
+		const { name } = req.params;
+		const asset = await getDbClient().dbAsset.findUnique({ where: { name } });
+		if (!asset) {
+			res.status(404).json({ error: "Asset not found" });
+			return;
+		}
+		res.set("Content-Type", asset.mimeType);
+		res.set("Content-Disposition", `attachment; filename="${name}"`);
+		res.send(Buffer.from(asset.content));
+	} catch (error) {
+		console.error("Error exporting asset:", error);
+		res.status(500).json({ error: "Failed to export asset" });
+	}
+}
+/**
+* List all assets with metadata
+*/
+async function listAssets(_req, res) {
+	try {
+		const assets = await getDbClient().dbAsset.findMany({
+			select: {
+				id: true,
+				name: true,
+				assetType: true,
+				mimeType: true,
+				fileSize: true,
+				width: true,
+				height: true,
+				checksum: true
+			},
+			orderBy: { name: "asc" }
+		});
+		res.json({ assets });
+	} catch (error) {
+		console.error("Error listing assets:", error);
+		res.status(500).json({ error: "Failed to list assets" });
+	}
+}
+/**
+* Import an asset (icon or screenshot)
+*/
+async function importAsset(req, res) {
+	try {
+		const file = req.file;
+		const { name, assetType, mimeType, width, height } = req.body;
+		if (!file) {
+			res.status(400).json({ error: "No file uploaded" });
+			return;
+		}
+		const prisma = getDbClient();
+		const checksum = (await import("node:crypto")).createHash("sha256").update(file.buffer).digest("hex");
+		const content = new Uint8Array(file.buffer);
+		await prisma.dbAsset.upsert({
+			where: { name },
+			update: {
+				content,
+				checksum,
+				mimeType: mimeType || file.mimetype,
+				fileSize: file.size,
+				width: width ? parseInt(width) : null,
+				height: height ? parseInt(height) : null,
+				assetType: assetType || "icon"
+			},
+			create: {
+				name,
+				content,
+				checksum,
+				mimeType: mimeType || file.mimetype,
+				fileSize: file.size,
+				width: width ? parseInt(width) : null,
+				height: height ? parseInt(height) : null,
+				assetType: assetType || "icon"
+			}
+		});
+		res.json({
+			success: true,
+			name,
+			size: file.size
+		});
+	} catch (error) {
+		console.error("Error importing asset:", error);
+		res.status(500).json({ error: "Failed to import asset" });
+	}
+}
+
+//#endregion
+//#region src/middleware/featureRegistry.ts
+const FEATURES = [
+	{
+		name: "auth",
+		defaultEnabled: true,
+		register: (router$1, options, ctx) => {
+			const basePath = options.basePath;
+			router$1.get(`${basePath}/auth/session`, async (req, res) => {
+				try {
+					const session = await ctx.auth.api.getSession({ headers: req.headers });
+					if (session) res.json(session);
+					else res.status(401).json({ error: "Not authenticated" });
+				} catch (error) {
+					console.error("[Auth Session Error]", error);
+					res.status(500).json({ error: "Internal server error" });
+				}
+			});
+			const authHandler = toNodeHandler(ctx.auth);
+			router$1.all(`${basePath}/auth/{*any}`, authHandler);
+		}
+	},
+	{
+		name: "icons",
+		defaultEnabled: true,
+		register: (router$1, options) => {
+			registerIconRestController(router$1, { basePath: `${options.basePath}/icons` });
+		}
+	},
+	{
+		name: "assets",
+		defaultEnabled: true,
+		register: (router$1, options) => {
+			registerAssetRestController(router$1, { basePath: `${options.basePath}/assets` });
+		}
+	},
+	{
+		name: "screenshots",
+		defaultEnabled: true,
+		register: (router$1, options) => {
+			registerScreenshotRestController(router$1, { basePath: `${options.basePath}/screenshots` });
+		}
+	},
+	{
+		name: "adminChat",
+		defaultEnabled: false,
+		register: (router$1, options) => {
+			if (options.adminChat) router$1.post(`${options.basePath}/admin/chat`, createAdminChatHandler(options.adminChat));
+		}
+	},
+	{
+		name: "legacyIconEndpoint",
+		defaultEnabled: false,
+		register: (router$1) => {
+			router$1.get("/static/icon/:icon", async (req, res) => {
+				const { icon } = req.params;
+				if (!icon || !/^[a-z0-9-]+$/i.test(icon)) {
+					res.status(400).send("Invalid icon name");
+					return;
+				}
+				try {
+					const dbIcon = await getAssetByName(icon);
+					if (!dbIcon) {
+						res.status(404).send("Icon not found");
+						return;
+					}
+					res.setHeader("Content-Type", dbIcon.mimeType);
+					res.setHeader("Cache-Control", "public, max-age=86400");
+					res.send(dbIcon.content);
+				} catch (error) {
+					console.error("Error fetching icon:", error);
+					res.status(404).send("Icon not found");
+				}
+			});
+		}
+	},
+	{
+		name: "catalogBackup",
+		defaultEnabled: true,
+		register: (router$1, options) => {
+			const basePath = options.basePath;
+			const upload$2 = multer({ storage: multer.memoryStorage() });
+			router$1.get(`${basePath}/catalog/backup/export`, exportCatalog);
+			router$1.post(`${basePath}/catalog/backup/import`, importCatalog);
+			router$1.get(`${basePath}/catalog/backup/assets`, listAssets);
+			router$1.get(`${basePath}/catalog/backup/assets/:name`, exportAsset);
+			router$1.post(`${basePath}/catalog/backup/assets`, upload$2.single("file"), importAsset);
+		}
+	}
+];
+/**
+* Registers all enabled features on the router.
+*/
+function registerFeatures(router$1, options, context) {
+	const toggles = options.features || {};
+	for (const feature of FEATURES) {
+		const isEnabled = toggles[feature.name] ?? feature.defaultEnabled;
+		if (feature.name === "adminChat" && !options.adminChat) continue;
+		if (isEnabled) feature.register(router$1, options, context);
+	}
+}
+
+//#endregion
+//#region src/middleware/createEhMiddleware.ts
+async function createEhMiddleware(options) {
+	var _normalizedOptions$fe, _options$hooks;
+	const basePath = options.basePath ?? "/api";
+	const normalizedOptions = {
+		...options,
+		basePath
+	};
+	const dbManager = new EhDatabaseManager(options.database);
+	dbManager.getClient();
+	const auth = createAuth({
+		appName: options.auth.appName,
+		baseURL: options.auth.baseURL,
+		secret: options.auth.secret,
+		providers: options.auth.providers,
+		plugins: options.auth.plugins,
+		sessionExpiresIn: options.auth.sessionExpiresIn,
+		sessionUpdateAge: options.auth.sessionUpdateAge
+	});
+	const trpcRouter = createTrpcRouter(auth);
+	const resolveBackend = createBackendResolver(options.backend);
+	const createContext = async () => {
+		return createEhTrpcContext({ companySpecificBackend: await resolveBackend() });
+	};
+	const router$1 = Router();
+	router$1.use(express.json());
+	const middlewareContext = {
+		auth,
+		trpcRouter,
+		createContext
+	};
+	if (((_normalizedOptions$fe = normalizedOptions.features) === null || _normalizedOptions$fe === void 0 ? void 0 : _normalizedOptions$fe.trpc) !== false) router$1.use(`${basePath}/trpc`, trpcExpress.createExpressMiddleware({
+		router: trpcRouter,
+		createContext
+	}));
+	registerFeatures(router$1, normalizedOptions, middlewareContext);
+	if ((_options$hooks = options.hooks) === null || _options$hooks === void 0 ? void 0 : _options$hooks.onRoutesRegistered) await options.hooks.onRoutesRegistered(router$1);
+	return {
+		router: router$1,
+		auth,
+		trpcRouter,
+		async connect() {
+			var _options$hooks2;
+			await dbManager.connect();
+			if ((_options$hooks2 = options.hooks) === null || _options$hooks2 === void 0 ? void 0 : _options$hooks2.onDatabaseConnected) await options.hooks.onDatabaseConnected();
+		},
+		async disconnect() {
+			var _options$hooks3;
+			if ((_options$hooks3 = options.hooks) === null || _options$hooks3 === void 0 ? void 0 : _options$hooks3.onDatabaseDisconnecting) await options.hooks.onDatabaseDisconnecting();
+			await dbManager.disconnect();
+		},
+		addRoutes(callback) {
+			callback(router$1);
+		}
+	};
+}
+
+//#endregion
+export { DEFAULT_ADMIN_SYSTEM_PROMPT, EhDatabaseManager, TABLE_SYNC_MAGAZINE, connectDb, createAdminChatHandler, createAppCatalogAdminRouter, createAuth, createAuthRouter, createDatabaseTools, createEhMiddleware, createEhTrpcContext, createPrismaDatabaseClient, createScreenshotRouter, createTrpcRouter, disconnectDb, getAdminGroupsFromEnv, getAssetByName, getAuthPluginsFromEnv, getAuthProvidersFromEnv, getDbClient, getUserGroups, isAdmin, isMemberOfAllGroups, isMemberOfAnyGroup, registerAssetRestController, registerAuthRoutes, registerIconRestController, registerScreenshotRestController, requireAdmin, requireGroups, setDbClient, staticControllerContract, syncAppCatalog, syncAssets, tableSyncPrisma, tool, upsertIcon, upsertIcons, validateAuthConfig };
 //# sourceMappingURL=index.js.map