refactor progress

2026-02-17 12:22:36 +00:00
parent cb31608523
commit d5abd1a7e4
8257 changed files with 1190207 additions and 761040 deletions
--- a/packages/kv_client/src/IKVProvider.tsx
+++ b/packages/kv_client/src/IKVProvider.tsx
@@ -0,0 +1,105 @@
+/*
+ * Copyright (C) 2026 Fluxer Contributors
+ *
+ * This file is part of Fluxer.
+ *
+ * Fluxer is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Fluxer is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+export interface IKVPipeline {
+	get(key: string): this;
+	set(key: string, value: string): this;
+	setex(key: string, ttlSeconds: number, value: string): this;
+	del(key: string): this;
+	expire(key: string, ttlSeconds: number): this;
+	sadd(key: string, ...members: Array<string>): this;
+	srem(key: string, ...members: Array<string>): this;
+	zadd(key: string, score: number, value: string): this;
+	zrem(key: string, ...members: Array<string>): this;
+	mset(...args: Array<string>): this;
+	exec(): Promise<Array<[Error | null, unknown]>>;
+}
+
+export interface IKVSubscription {
+	connect(): Promise<void>;
+	on(event: 'message', callback: (channel: string, message: string) => void): void;
+	on(event: 'error', callback: (error: Error) => void): void;
+	subscribe(...channels: Array<string>): Promise<void>;
+	unsubscribe(...channels: Array<string>): Promise<void>;
+	quit(): Promise<void>;
+	disconnect(): Promise<void>;
+	removeAllListeners(event?: 'message' | 'error'): void;
+}
+
+export interface IKVProvider {
+	get(key: string): Promise<string | null>;
+	set(key: string, value: string, ...args: Array<string | number>): Promise<string | null>;
+	setex(key: string, ttlSeconds: number, value: string): Promise<void>;
+	setnx(key: string, value: string, ttlSeconds?: number): Promise<boolean>;
+	mget(...keys: Array<string>): Promise<Array<string | null>>;
+	mset(...args: Array<string>): Promise<void>;
+	del(...keys: Array<string>): Promise<number>;
+	exists(key: string): Promise<number>;
+	expire(key: string, ttlSeconds: number): Promise<number>;
+	ttl(key: string): Promise<number>;
+	incr(key: string): Promise<number>;
+	getex(key: string, ttlSeconds: number): Promise<string | null>;
+	getdel(key: string): Promise<string | null>;
+
+	sadd(key: string, ...members: Array<string>): Promise<number>;
+	srem(key: string, ...members: Array<string>): Promise<number>;
+	smembers(key: string): Promise<Array<string>>;
+	sismember(key: string, member: string): Promise<number>;
+	scard(key: string): Promise<number>;
+	spop(key: string, count?: number): Promise<Array<string>>;
+
+	zadd(key: string, ...scoreMembers: Array<number | string>): Promise<number>;
+	zrem(key: string, ...members: Array<string>): Promise<number>;
+	zcard(key: string): Promise<number>;
+	zrangebyscore(
+		key: string,
+		min: string | number,
+		max: string | number,
+		...args: Array<string | number>
+	): Promise<Array<string>>;
+
+	rpush(key: string, ...values: Array<string>): Promise<number>;
+	lpop(key: string, count?: number): Promise<Array<string>>;
+	llen(key: string): Promise<number>;
+
+	hset(key: string, field: string, value: string): Promise<number>;
+	hdel(key: string, ...fields: Array<string>): Promise<number>;
+	hget(key: string, field: string): Promise<string | null>;
+	hgetall(key: string): Promise<Record<string, string>>;
+
+	publish(channel: string, message: string): Promise<number>;
+	duplicate(): IKVSubscription;
+
+	releaseLock(key: string, token: string): Promise<boolean>;
+	renewSnowflakeNode(key: string, instanceId: string, ttlSeconds: number): Promise<boolean>;
+	tryConsumeTokens(
+		key: string,
+		requested: number,
+		maxTokens: number,
+		refillRate: number,
+		refillIntervalMs: number,
+	): Promise<number>;
+	scheduleBulkDeletion(queueKey: string, secondaryKey: string, score: number, value: string): Promise<void>;
+	removeBulkDeletion(queueKey: string, secondaryKey: string): Promise<boolean>;
+	scan(pattern: string, count: number): Promise<Array<string>>;
+
+	pipeline(): IKVPipeline;
+	multi(): IKVPipeline;
+	health(): Promise<boolean>;
+}