@quark-fw/plugin-redis 0.1.2

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@quark-fw/plugin-redis",
+	"version": "0.1.2",
+	"main": "src/index.ts",
+	"types": "src/index.ts",
+	"type": "module",
+	"scripts": {
+		"dev": "tsx watch src/index.ts",
+		"build": "echo raw-src package, no build"
+	},
+	"files": [
+		"src"
+	],
+	"keywords": [
+		"quark"
+	],
+	"author": "",
+	"license": "ISC",
+	"description": "Redis (ioredis) plugin for the Quark framework (published as raw TS sources; consumers run tsx)",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@quark-fw/atom": "0.1.2",
+		"@quark-fw/plugin": "0.1.2",
+		"ioredis": "^5.9.3"
+	},
+	"peerDependencies": {
+		"@quark-fw/core": "0.1.2"
+	}
+}

package/src/global.d.ts

@@ -0,0 +1,16 @@
+import "@quark-fw/core/src/global.d.ts";
+import { Atom } from "@quark-fw/atom";
+import { Redis } from "ioredis";
+
+export type RedisConfig = {
+	url: string;
+};
+
+declare global {
+	interface Quark {
+		redis: {
+			config: Atom<RedisConfig>;
+			client: Atom<Redis>;
+		};
+	}
+}

package/src/index.ts

@@ -0,0 +1,43 @@
+import atom from "@quark-fw/atom";
+import { QuarkPlugin } from "@quark-fw/plugin";
+import { RedisConfig } from "@quark-fw/plugin-redis/src/global.js";
+import { Redis } from "ioredis";
+
+function createClient(config: RedisConfig) {
+	return new Redis(config.url, {
+		maxRetriesPerRequest: null,
+		family: 4,
+		// не подключаемся, пока клиент реально не используется
+		lazyConnect: true,
+		retryStrategy: (times) => Math.min(times * 200, 2000),
+	});
+}
+
+await quark.registerPlugin({
+	name: "redis",
+	extend(quark) {
+		// в проде адрес приходит из окружения (в Coolify — внутренний URL
+		// сервиса), локально работает дефолт
+		const config = atom<RedisConfig>("redis.config", {
+			url: process.env.REDIS_URL || "redis://127.0.0.1:6379",
+		});
+
+		const client = atom("redis.client", createClient(config.value));
+
+		// при смене конфига создаём новый клиент и закрываем старый
+		config.subscribe((cfg) => {
+			const old = client.value;
+			client.value = createClient(cfg);
+			void old.quit().catch(() => old.disconnect());
+		});
+
+		quark.redis = {
+			client,
+			config,
+		};
+	},
+	async onDestroy(quark) {
+		const client = quark.redis.client.value;
+		await client.quit().catch(() => client.disconnect());
+	},
+} satisfies QuarkPlugin);