@quark-fw/plugin 0.0.1

package/dist/global.d.ts

@@ -0,0 +1 @@
+import "@quark-fw/core/src/global.js";

package/dist/http.d.ts

@@ -0,0 +1,5 @@
+import { type RequestHandler } from "express";
+export declare const preRouter: import("express-serve-static-core").Router;
+export declare const httpRouter: import("express-serve-static-core").Router;
+export declare function registerHttpPreMiddleware(handler: RequestHandler): void;
+export declare function registerHttpMiddleware(path: string, handler: RequestHandler): void;

package/dist/http.js

@@ -0,0 +1,16 @@
+import { Router } from "express";
+// Живой реестр HTTP-middleware: плагины регистрируют маршруты в любой
+// момент (до или после старта сервера) — react-плагин монтирует роутеры
+// один раз, а express позволяет дописывать в них маршруты после mount.
+// Импортировать ТОЛЬКО этот модуль (не index плагина) — он без side-эффектов.
+// preRouter монтируется ПЕРЕД httpRouter: сюда идут сквозные middleware
+// (сессии, passport), которые обязаны отработать до обработчиков вроде
+// /api/trpc — независимо от порядка импорта плагинов.
+export const preRouter = Router();
+export const httpRouter = Router();
+export function registerHttpPreMiddleware(handler) {
+    preRouter.use(handler);
+}
+export function registerHttpMiddleware(path, handler) {
+    httpRouter.use(path, handler);
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { Atom } from "@quark-fw/atom";
+export interface QuarkPlugin {
+    name: string;
+    dependsOn?: string[];
+    atoms?: Record<string, Atom<unknown>>;
+    events?: Partial<Events>;
+    extend?(quark: Quark): void;
+    onInit?(quark: Quark): void | Promise<void>;
+    onReady?(quark: Quark): void | Promise<void>;
+    onDestroy?(quark: Quark): void | Promise<void>;
+    onEvent?: {
+        [K in keyof Events]?: (...args: Events[K]) => void;
+    };
+}

package/dist/index.js

@@ -0,0 +1 @@
+export {};

package/dist/loadPlugins.d.ts

@@ -0,0 +1,2 @@
+import type { QuarkPlugin } from "./index.js";
+export declare function loadPlugins(quark: Quark, plugins: QuarkPlugin[]): Promise<void>;

package/dist/loadPlugins.js

@@ -0,0 +1,42 @@
+export async function loadPlugins(quark, plugins) {
+    const loaded = new Set();
+    async function load(plugin) {
+        if (loaded.has(plugin.name))
+            return;
+        // загружаем зависимости
+        if (plugin.dependsOn) {
+            for (const dep of plugin.dependsOn) {
+                const found = plugins.find((p) => p.name === dep);
+                if (!found)
+                    throw new Error(`Plugin ${plugin.name} depends on missing plugin ${dep}`);
+                await load(found);
+            }
+        }
+        // Добавляем атомы: имена известны только в рантайме, объявлены они в
+        // аугментации Quark — статически связать нельзя.
+        if (plugin.atoms) {
+            const target = quark;
+            for (const [key, atom] of Object.entries(plugin.atoms)) {
+                target[key] = atom;
+            }
+        }
+        // расширяем quark
+        plugin.extend?.(quark);
+        // подписки на события
+        if (plugin.onEvent) {
+            for (const [event, handler] of Object.entries(plugin.onEvent)) {
+                // имя события — строка из объекта плагина
+                quark.ee.value.on(event, handler);
+            }
+        }
+        // lifecycle
+        await plugin.onInit?.(quark);
+        loaded.add(plugin.name);
+    }
+    for (const plugin of plugins) {
+        await load(plugin);
+    }
+    for (const plugin of plugins) {
+        await plugin.onReady?.(quark);
+    }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@quark-fw/plugin",
+	"version": "0.0.1",
+	"description": "Plugin contract and loader for the Quark framework",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./package.json": "./package.json",
+		"./src/*": "./dist/*",
+		"./*": "./dist/*"
+	},
+	"files": ["dist"],
+	"scripts": {
+		"dev": "tsx watch src/index.ts",
+		"build": "tsc -p tsconfig.build.json && node ../../scripts/postbuild.mjs"
+	},
+	"keywords": ["quark"],
+	"author": "",
+	"license": "ISC",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@quark-fw/atom": "0.0.1"
+	},
+	"peerDependencies": {
+		"express": "^5.0.0"
+	},
+	"peerDependenciesMeta": {
+		"express": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@types/express": "^5.0.6"
+	}
+}