@unikvs/redis.node 0.0.0 → 0.0.13

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026-present, tai-kun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,45 +1,3 @@
 # @unikvs/redis.node
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@unikvs/redis.node`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+[Document](https://tai-kun.github.io/unikvs/)

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+import { ErrorBase, ErrorOptions, IStorage, InvalidUsageErrorBase, KeyNotFoundError, KeyNotFoundErrorArgs, KeyNotFoundErrorMeta } from "@unikvs/core";
+import { ClusterNode, ClusterOptions, RedisOptions } from "ioredis";
+//#region ../src/errors.d.ts
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+ */
+export declare class ClusterNotSupportedError extends InvalidUsageErrorBase<undefined> {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+   */
+  constructor(options?: ErrorOptions);
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+type InvalidCloseTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#invalid-close-timeout-actual)
+   */
+  readonly actual: unknown;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+type InvalidCloseTimeoutErrorArgs = ErrorOptions & InvalidCloseTimeoutErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+export declare class InvalidCloseTimeoutError extends ErrorBase<InvalidCloseTimeoutErrorMeta> {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+   */
+  constructor(args: InvalidCloseTimeoutErrorArgs);
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+type ConnectTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#connect-timeout-timeoutms)
+   */
+  readonly timeoutMs: number;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+type ConnectTimeoutErrorArgs = ErrorOptions & ConnectTimeoutErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+export declare class ConnectTimeoutError extends ErrorBase<ConnectTimeoutErrorMeta> {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+   */
+  constructor(args: ConnectTimeoutErrorArgs);
+}
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+type CloseTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#close-timeout-timeoutms)
+   */
+  readonly timeoutMs: number;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+type CloseTimeoutErrorArgs = ErrorOptions & CloseTimeoutErrorMeta;
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+export declare class CloseTimeoutError extends ErrorBase<CloseTimeoutErrorMeta> {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+   */
+  constructor(args: CloseTimeoutErrorArgs);
+}
+//#endregion
+//#region ../src/redis.d.ts
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec)
+ */
+type RedisClusterSpec = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-nodes)
+   */
+  readonly nodes: readonly ClusterNode[];
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-options)
+   */
+  readonly options?: ClusterOptions | undefined;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions)
+ */
+type RedisStorageOptions = Omit<RedisOptions, "keyPrefix" | "lazyConnect"> & {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-keyprefix)
+   */
+  readonly keyPrefix?: string | undefined;
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-cluster)
+   */
+  readonly cluster?: RedisClusterSpec | undefined;
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-closetimeout)
+   */
+  readonly closeTimeout?: number | undefined;
+};
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+ */
+declare class Redis implements IStorage {
+  #private;
+  readonly name: string;
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+   */
+  constructor(url?: string, options?: RedisStorageOptions);
+  get isOpen(): boolean;
+  open(_c: IStorage.OpenContext): Promise<void>;
+  close(_c: IStorage.CloseContext): Promise<void>;
+  write(c: IStorage.WriteContext, data: Uint8Array<ArrayBuffer>): Promise<void>;
+  read(c: IStorage.ReadContext): Promise<Uint8Array<ArrayBuffer>>;
+  exists(c: IStorage.ExistsContext): Promise<boolean>;
+  delete(c: IStorage.DeleteContext): Promise<void>;
+  clear(c: IStorage.ClearContext): Promise<void>;
+  getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array<ArrayBuffer>>;
+  getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array<ArrayBuffer>>;
+}
+//#endregion
+export { type CloseTimeoutErrorArgs, type CloseTimeoutErrorMeta, type ConnectTimeoutErrorArgs, type ConnectTimeoutErrorMeta, type InvalidCloseTimeoutErrorArgs, type InvalidCloseTimeoutErrorMeta, KeyNotFoundError, type KeyNotFoundErrorArgs, type KeyNotFoundErrorMeta, Redis, type RedisClusterSpec, type RedisStorageOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/errors.ts","../src/redis.ts"],"mappings":";;;;;;qBAQa,iCAAiC;;;;EAQ5C,YAAmB,UAAU;;;;;KAiBnB;;;;WAID;;;;;KAMC,+BAA+B,eAAe;;;;qBAK7C,iCAAiC,UAAU;;;;EAQtD,YAAmB,MAAM;;;;;KAsBf;;;;WAID;;;;;KAMC,0BAA0B,eAAe;;;;qBAKxC,4BAA4B,UAAU;;;;EAQjD,YAAmB,MAAM;;;;;KAqBf;;;;WAID;;;;;KAMC,wBAAwB,eAAe;;;;qBAKtC,0BAA0B,UAAU;;;;EAQ/C,YAAmB,MAAM;;;;;;;KC7Hf;;;;WAID,gBAAgB;;;;WAKhB,UAAU;;;;;KAMT,sBAAsB,KAAK;;;;WAI5B;;;;WAKA,UAAU;;;;WAKV;;;;;cAYU,iBAAiB;;WAepB;;;;EAKhB,YAAmB,cAAc,UAAS;MA4B/B;EAgBX,KAAkB,IAAI,SAAS,cAAc;EA+D7C,MAAmB,IAAI,SAAS,eAAe;EAkD/C,MAAmB,GAAG,SAAS,cAAc,MAAM,WAAW,eAAe;EAQ7E,KAAkB,GAAG,SAAS,cAAc,QAAQ,WAAW;EAc/D,OAAoB,GAAG,SAAS,gBAAgB;EAQhD,OAAoB,GAAG,SAAS,gBAAgB;EAQhD,MAAmB,GAAG,SAAS,eAAe;EAU9C,YAAmB,GAAG,SAAS,qBAAqB,eAAe,WAAW;EA0E9E,YAAmB,GAAG,SAAS,qBAAqB,eAAe,WAAW"}

package/dist/index.js

@@ -0,0 +1,309 @@
+import { ErrorBase, InvalidUsageErrorBase, KeyNotFoundError, KeyNotFoundError as KeyNotFoundError$1, setErrorMessage } from "@unikvs/core";
+import { randomUUID } from "node:crypto";
+import { Redis as Redis$1 } from "ioredis";
+//#region ../src/errors.ts
+var _ClusterNotSupportedError;
+var _InvalidCloseTimeoutError;
+var _ConnectTimeoutError;
+var _CloseTimeoutError;
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+*/
+var ClusterNotSupportedError = class extends InvalidUsageErrorBase {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+	*/
+	constructor(options) {
+		super("Redis storage v1 supports standalone mode only: the `cluster` option is not supported.", options);
+	}
+};
+_ClusterNotSupportedError = ClusterNotSupportedError;
+_ClusterNotSupportedError.prototype.name = "RedisClusterNotSupportedError";
+setErrorMessage(ClusterNotSupportedError, "Redis ストレージ v1 は standalone モードのみに対応します。`cluster` オプションはサポートされていません。", "ja");
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+*/
+var InvalidCloseTimeoutError = class extends ErrorBase {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+	*/
+	constructor(args) {
+		const { actual, ...options } = args;
+		super({ actual }, ({ actual: messageActual }) => `\`closeTimeout\` must be a finite positive number (ms), but got ${String(messageActual)}.`, options);
+	}
+};
+_InvalidCloseTimeoutError = InvalidCloseTimeoutError;
+_InvalidCloseTimeoutError.prototype.name = "RedisInvalidCloseTimeoutError";
+setErrorMessage(InvalidCloseTimeoutError, ({ actual }) => `\`closeTimeout\` は有限の正数 (ミリ秒) でなければなりません。受け取った値: ${String(actual)}`, "ja");
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+*/
+var ConnectTimeoutError = class extends ErrorBase {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+	*/
+	constructor(args) {
+		const { timeoutMs, ...options } = args;
+		super({ timeoutMs }, ({ timeoutMs: messageTimeoutMs }) => `Timed out connecting to Redis after ${messageTimeoutMs}ms`, options);
+	}
+};
+_ConnectTimeoutError = ConnectTimeoutError;
+_ConnectTimeoutError.prototype.name = "RedisConnectTimeoutError";
+setErrorMessage(ConnectTimeoutError, ({ timeoutMs }) => `Redis への接続が ${timeoutMs}ms でタイムアウトしました`, "ja");
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+*/
+var CloseTimeoutError = class extends ErrorBase {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+	*/
+	constructor(args) {
+		const { timeoutMs, ...options } = args;
+		super({ timeoutMs }, ({ timeoutMs: messageTimeoutMs }) => `Timed out closing Redis after ${messageTimeoutMs}ms`, options);
+	}
+};
+_CloseTimeoutError = CloseTimeoutError;
+_CloseTimeoutError.prototype.name = "RedisCloseTimeoutError";
+setErrorMessage(CloseTimeoutError, ({ timeoutMs }) => `Redis からの切断処理が ${timeoutMs}ms でタイムアウトしました`, "ja");
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/checkPrivateRedeclaration.js
+function _checkPrivateRedeclaration(e, t) {
+	if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object");
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateMethodInitSpec.js
+function _classPrivateMethodInitSpec(e, a) {
+	_checkPrivateRedeclaration(e, a), a.add(e);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldInitSpec.js
+function _classPrivateFieldInitSpec(e, t, a) {
+	_checkPrivateRedeclaration(e, t), t.set(e, a);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/assertClassBrand.js
+function _assertClassBrand(e, t, n) {
+	if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n;
+	throw new TypeError("Private element is not present on this object");
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldSet2.js
+function _classPrivateFieldSet2(s, a, r) {
+	return s.set(_assertClassBrand(s, a), r), r;
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/classPrivateFieldGet2.js
+function _classPrivateFieldGet2(s, a) {
+	return s.get(_assertClassBrand(s, a));
+}
+//#endregion
+//#region ../src/redis.ts
+const SCAN_COUNT = 1e3;
+const DEFAULT_CONNECT_TIMEOUT_MS = 5e3;
+const DEFAULT_CLOSE_TIMEOUT_MS = 5e3;
+var _con = /* @__PURE__ */ new WeakMap();
+var _url = /* @__PURE__ */ new WeakMap();
+var _options = /* @__PURE__ */ new WeakMap();
+var _closeTimeout = /* @__PURE__ */ new WeakMap();
+var _keyPrefix = /* @__PURE__ */ new WeakMap();
+var _Redis_brand = /* @__PURE__ */ new WeakSet();
+/**
+* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+*/
+var Redis = class {
+	/**
+	* [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+	*/
+	constructor(url, options = {}) {
+		_classPrivateMethodInitSpec(this, _Redis_brand);
+		_classPrivateFieldInitSpec(this, _con, void 0);
+		_classPrivateFieldInitSpec(this, _url, void 0);
+		_classPrivateFieldInitSpec(this, _options, void 0);
+		_classPrivateFieldInitSpec(this, _closeTimeout, void 0);
+		_classPrivateFieldInitSpec(this, _keyPrefix, void 0);
+		const { cluster, keyPrefix = "unikvs:", closeTimeout = DEFAULT_CLOSE_TIMEOUT_MS, ...redisOptions } = options;
+		if (cluster !== void 0) throw new ClusterNotSupportedError();
+		if (typeof closeTimeout !== "number" || !Number.isFinite(closeTimeout) || closeTimeout <= 0) throw new InvalidCloseTimeoutError({ actual: closeTimeout });
+		this.name = "Redis";
+		_classPrivateFieldSet2(_con, this, null);
+		_classPrivateFieldSet2(_url, this, url);
+		_classPrivateFieldSet2(_options, this, redisOptions);
+		_classPrivateFieldSet2(_closeTimeout, this, closeTimeout);
+		_classPrivateFieldSet2(_keyPrefix, this, keyPrefix);
+	}
+	get isOpen() {
+		return _classPrivateFieldGet2(_con, this) !== null;
+	}
+	async open(_c) {
+		if (_classPrivateFieldGet2(_con, this)) await this.close(_c);
+		const explicitUrl = _classPrivateFieldGet2(_url, this) === void 0 || _classPrivateFieldGet2(_url, this) === "" ? void 0 : _classPrivateFieldGet2(_url, this);
+		const redisUrl = process.env["REDIS_URL"] === void 0 || process.env["REDIS_URL"] === "" ? void 0 : process.env["REDIS_URL"];
+		const valkeyUrl = process.env["VALKEY_URL"] === void 0 || process.env["VALKEY_URL"] === "" ? void 0 : process.env["VALKEY_URL"];
+		const url = explicitUrl ?? redisUrl ?? valkeyUrl;
+		const connectTimeout = _classPrivateFieldGet2(_options, this).connectTimeout ?? DEFAULT_CONNECT_TIMEOUT_MS;
+		const options = {
+			..._classPrivateFieldGet2(_options, this),
+			lazyConnect: true,
+			connectTimeout
+		};
+		const raw = url === void 0 ? new Redis$1(options) : new Redis$1(url, options);
+		raw.on("error", () => {});
+		let timer;
+		try {
+			await Promise.race([raw.connect(), new Promise((_, reject) => {
+				timer = setTimeout(() => {
+					reject(new ConnectTimeoutError({ timeoutMs: connectTimeout }));
+				}, connectTimeout);
+			})]);
+		} catch (ex) {
+			raw.disconnect();
+			throw ex;
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+		_classPrivateFieldSet2(_con, this, { client: raw });
+	}
+	async close(_c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		_classPrivateFieldSet2(_con, this, null);
+		const closeTimeout = _classPrivateFieldGet2(_closeTimeout, this);
+		let timer;
+		try {
+			await Promise.race([client.quit(), new Promise((_, reject) => {
+				timer = setTimeout(() => {
+					reject(new CloseTimeoutError({ timeoutMs: closeTimeout }));
+				}, closeTimeout);
+			})]);
+		} catch {
+			client.disconnect();
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	}
+	async write(c, data) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		await client.set(_assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key), Buffer.from(data));
+	}
+	async read(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		const data = await client.getBuffer(_assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key));
+		if (data === null) throw new KeyNotFoundError$1({ key: c.key });
+		return new Uint8Array(data);
+	}
+	async exists(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		return await client.exists(_assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key)) > 0;
+	}
+	async delete(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		await client.del(_assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key));
+	}
+	async clear(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		const pattern = `${_classPrivateFieldGet2(_keyPrefix, this)}*`;
+		await _assertClassBrand(_Redis_brand, this, _clearPattern).call(this, client, pattern, c.signal);
+	}
+	getWritable(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		const dest = _assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key);
+		const tmp = `${dest}.${randomUUID()}.tmp`;
+		let finished = false;
+		const removeAbortListener = () => {
+			c.signal.removeEventListener("abort", onAbort);
+		};
+		const discardTemporary = async () => {
+			try {
+				await client.del(tmp);
+			} catch {}
+		};
+		const finish = async () => {
+			if (finished) return;
+			finished = true;
+			removeAbortListener();
+			await discardTemporary();
+		};
+		const onAbort = () => {
+			finish();
+		};
+		c.signal.addEventListener("abort", onAbort, { once: true });
+		return new WritableStream({
+			async abort() {
+				await finish();
+			},
+			async close() {
+				c.signal.throwIfAborted();
+				try {
+					await client.rename(tmp, dest);
+				} catch (ex) {
+					await finish();
+					throw ex;
+				}
+				finished = true;
+				removeAbortListener();
+			},
+			async start() {
+				try {
+					c.signal.throwIfAborted();
+					await client.set(tmp, "");
+				} catch (ex) {
+					await finish();
+					throw ex;
+				}
+			},
+			async write(chunk) {
+				c.signal.throwIfAborted();
+				try {
+					await client.append(tmp, Buffer.from(chunk));
+				} catch (ex) {
+					await finish();
+					throw ex;
+				}
+			}
+		});
+	}
+	getReadable(c) {
+		const { client } = _assertClassBrand(_Redis_brand, this, _getConnection).call(this);
+		c.signal.throwIfAborted();
+		const dest = _assertClassBrand(_Redis_brand, this, _toKey).call(this, c.key);
+		let sent = false;
+		return new ReadableStream({ async pull(controller) {
+			if (sent) {
+				controller.close();
+				return;
+			}
+			sent = true;
+			c.signal.throwIfAborted();
+			const data = await client.getBuffer(dest);
+			if (data === null) throw new KeyNotFoundError$1({ key: c.key });
+			controller.enqueue(new Uint8Array(data));
+			controller.close();
+		} });
+	}
+};
+function _getConnection() {
+	const con = _classPrivateFieldGet2(_con, this);
+	if (con === null) throw new TypeError("Redis is not open. Call open() first.");
+	return con;
+}
+function _toKey(key) {
+	return `${_classPrivateFieldGet2(_keyPrefix, this)}${key}`;
+}
+async function _clearPattern(client, pattern, signal) {
+	let cursor = "0";
+	do {
+		signal.throwIfAborted();
+		const [nextCursor, keys] = await client.scan(cursor, "MATCH", pattern, "COUNT", SCAN_COUNT);
+		if (keys.length > 0) await client.del(...keys);
+		cursor = nextCursor;
+	} while (cursor !== "0");
+}
+//#endregion
+export { CloseTimeoutError, ClusterNotSupportedError, ConnectTimeoutError, InvalidCloseTimeoutError, KeyNotFoundError, Redis };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Ioredis","KeyNotFoundError"],"sources":["../src/errors.ts","../src/redis.ts"],"sourcesContent":["import { type ErrorOptions, ErrorBase, setErrorMessage, InvalidUsageErrorBase } from \"@unikvs/core\";\n\nexport type { KeyNotFoundErrorArgs, KeyNotFoundErrorMeta } from \"@unikvs/core\";\nexport { KeyNotFoundError } from \"@unikvs/core\";\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)\n */\nexport class ClusterNotSupportedError extends InvalidUsageErrorBase<undefined> {\n  static {\n    this.prototype.name = \"RedisClusterNotSupportedError\";\n  }\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)\n   */\n  public constructor(options?: ErrorOptions) {\n    super(\n      \"Redis storage v1 supports standalone mode only: the `cluster` option is not supported.\",\n      options,\n    );\n  }\n}\n\nsetErrorMessage(\n  ClusterNotSupportedError,\n  \"Redis ストレージ v1 は standalone モードのみに対応します。`cluster` オプションはサポートされていません。\",\n  \"ja\",\n);\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)\n */\nexport type InvalidCloseTimeoutErrorMeta = {\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#invalid-close-timeout-actual)\n   */\n  readonly actual: unknown;\n};\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)\n */\nexport type InvalidCloseTimeoutErrorArgs = ErrorOptions & InvalidCloseTimeoutErrorMeta;\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)\n */\nexport class InvalidCloseTimeoutError extends ErrorBase<InvalidCloseTimeoutErrorMeta> {\n  static {\n    this.prototype.name = \"RedisInvalidCloseTimeoutError\";\n  }\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)\n   */\n  public constructor(args: InvalidCloseTimeoutErrorArgs) {\n    const { actual, ...options } = args;\n    const meta: InvalidCloseTimeoutErrorMeta = { actual };\n    super(\n      meta,\n      ({ actual: messageActual }) =>\n        `\\`closeTimeout\\` must be a finite positive number (ms), but got ${String(messageActual)}.`,\n      options,\n    );\n  }\n}\n\nsetErrorMessage(\n  InvalidCloseTimeoutError,\n  ({ actual }) =>\n    `\\`closeTimeout\\` は有限の正数 (ミリ秒) でなければなりません。受け取った値: ${String(actual)}`,\n  \"ja\",\n);\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)\n */\nexport type ConnectTimeoutErrorMeta = {\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#connect-timeout-timeoutms)\n   */\n  readonly timeoutMs: number;\n};\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)\n */\nexport type ConnectTimeoutErrorArgs = ErrorOptions & ConnectTimeoutErrorMeta;\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)\n */\nexport class ConnectTimeoutError extends ErrorBase<ConnectTimeoutErrorMeta> {\n  static {\n    this.prototype.name = \"RedisConnectTimeoutError\";\n  }\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)\n   */\n  public constructor(args: ConnectTimeoutErrorArgs) {\n    const { timeoutMs, ...options } = args;\n    const meta: ConnectTimeoutErrorMeta = { timeoutMs };\n    super(\n      meta,\n      ({ timeoutMs: messageTimeoutMs }) =>\n        `Timed out connecting to Redis after ${messageTimeoutMs}ms`,\n      options,\n    );\n  }\n}\n\nsetErrorMessage(\n  ConnectTimeoutError,\n  ({ timeoutMs }) => `Redis への接続が ${timeoutMs}ms でタイムアウトしました`,\n  \"ja\",\n);\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)\n */\nexport type CloseTimeoutErrorMeta = {\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#close-timeout-timeoutms)\n   */\n  readonly timeoutMs: number;\n};\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)\n */\nexport type CloseTimeoutErrorArgs = ErrorOptions & CloseTimeoutErrorMeta;\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)\n */\nexport class CloseTimeoutError extends ErrorBase<CloseTimeoutErrorMeta> {\n  static {\n    this.prototype.name = \"RedisCloseTimeoutError\";\n  }\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)\n   */\n  public constructor(args: CloseTimeoutErrorArgs) {\n    const { timeoutMs, ...options } = args;\n    const meta: CloseTimeoutErrorMeta = { timeoutMs };\n    super(\n      meta,\n      ({ timeoutMs: messageTimeoutMs }) => `Timed out closing Redis after ${messageTimeoutMs}ms`,\n      options,\n    );\n  }\n}\n\nsetErrorMessage(\n  CloseTimeoutError,\n  ({ timeoutMs }) => `Redis からの切断処理が ${timeoutMs}ms でタイムアウトしました`,\n  \"ja\",\n);\n","import { randomUUID } from \"node:crypto\";\n\nimport { type IStorage, KeyNotFoundError } from \"@unikvs/core\";\nimport {\n  type ClusterNode,\n  type RedisOptions,\n  type ClusterOptions,\n  Redis as Ioredis,\n} from \"ioredis\";\n\nimport {\n  CloseTimeoutError,\n  ConnectTimeoutError,\n  ClusterNotSupportedError,\n  InvalidCloseTimeoutError,\n} from \"./errors.js\";\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec)\n */\nexport type RedisClusterSpec = {\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-nodes)\n   */\n  readonly nodes: readonly ClusterNode[];\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-options)\n   */\n  readonly options?: ClusterOptions | undefined;\n};\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions)\n */\nexport type RedisStorageOptions = Omit<RedisOptions, \"keyPrefix\" | \"lazyConnect\"> & {\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-keyprefix)\n   */\n  readonly keyPrefix?: string | undefined;\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-cluster)\n   */\n  readonly cluster?: RedisClusterSpec | undefined;\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-closetimeout)\n   */\n  readonly closeTimeout?: number | undefined;\n};\n\nconst SCAN_COUNT = 1000;\nconst DEFAULT_CONNECT_TIMEOUT_MS = 5000;\nconst DEFAULT_CLOSE_TIMEOUT_MS = 5000;\n\ntype Connection = { readonly client: Ioredis };\n\n/**\n * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)\n */\nexport default class Redis implements IStorage {\n  #con: Connection | null;\n\n  readonly #url: string | undefined;\n\n  // `closeTimeout` は本パッケージ固有の拡張です。\n  // `this.#options` には含めず、別フィールドで保管します。\n  // `this.#options` は `new Ioredis` にそのまま spread できる透過バッグです。\n  readonly #options: Omit<RedisStorageOptions, \"keyPrefix\" | \"cluster\" | \"closeTimeout\">;\n\n  // `ioredis` の `disconnectTimeout` (ソケット切断待機) とは別物です。\n  readonly #closeTimeout: number;\n\n  readonly #keyPrefix: string;\n\n  public readonly name: string;\n\n  /**\n   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)\n   */\n  public constructor(url?: string, options: RedisStorageOptions = {}) {\n    const {\n      cluster,\n      keyPrefix = \"unikvs:\",\n      closeTimeout = DEFAULT_CLOSE_TIMEOUT_MS,\n      ...redisOptions\n    } = options;\n\n    // v1 は standalone のみに対応します。\n    // `cluster` を指定したときは、`closeTimeout` 検証より先に拒否します。\n    if (cluster !== undefined) {\n      throw new ClusterNotSupportedError();\n    }\n\n    // `undefined` は既定値 5000ms になるため対象外とします。\n    // 明示値が有限の正数でない場合のみ拒否します。\n    if (typeof closeTimeout !== \"number\" || !Number.isFinite(closeTimeout) || closeTimeout <= 0) {\n      throw new InvalidCloseTimeoutError({ actual: closeTimeout });\n    }\n\n    this.name = \"Redis\";\n    this.#con = null;\n    this.#url = url;\n    this.#options = redisOptions;\n    this.#closeTimeout = closeTimeout;\n    this.#keyPrefix = keyPrefix;\n  }\n\n  public get isOpen(): boolean {\n    return this.#con !== null;\n  }\n\n  // 開いている接続を返します。\n  // 未オープン時は `TypeError` を投げます。\n  #getConnection(): Connection {\n    const con = this.#con;\n\n    if (con === null) {\n      throw new TypeError(\"Redis is not open. Call open() first.\");\n    }\n\n    return con;\n  }\n\n  public async open(_c: IStorage.OpenContext): Promise<void> {\n    // 並行 `open` 同士および `open` 接続待ち中の `close` の同時呼び出しは禁止 (事前条件) です。\n    // 呼び出し側で直列化してください。\n    // 並行 `close` 同士は一方が `TypeError` reject する形で直列化されます。\n    if (this.#con) {\n      await this.close(_c as unknown as IStorage.CloseContext);\n    }\n\n    // 空文字の `url`・環境変数は未指定として扱います (本パッケージ仕様)。\n    // `url` は `redis://` / `rediss://` 形式での指定を要求します。\n    // 実行時の形式検証は行いません (bare 形式は非サポート・動作未保証)。\n    const explicitUrl = this.#url === undefined || this.#url === \"\" ? undefined : this.#url;\n    const redisUrl =\n      process.env[\"REDIS_URL\"] === undefined || process.env[\"REDIS_URL\"] === \"\"\n        ? undefined\n        : process.env[\"REDIS_URL\"];\n    const valkeyUrl =\n      process.env[\"VALKEY_URL\"] === undefined || process.env[\"VALKEY_URL\"] === \"\"\n        ? undefined\n        : process.env[\"VALKEY_URL\"];\n    const url = explicitUrl ?? redisUrl ?? valkeyUrl;\n    const connectTimeout = this.#options.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT_MS;\n\n    // `ioredis` v6 のコンストラクタ型は `replyMapping` に明示 `undefined` を許しません。\n    // `exactOptionalPropertyTypes` 下では spread のまま渡せないため型表明を付けます。\n    // 実行時の値は変わらず、`replyMapping` を含む透過は保たれます。\n    type ConnectOptions = RedisOptions & { replyMapping?: \"legacy\" };\n\n    const options = {\n      ...this.#options,\n      lazyConnect: true,\n      connectTimeout,\n    } as ConnectOptions;\n    const raw = url === undefined ? new Ioredis(options) : new Ioredis(url, options);\n\n    // `ioredis` は接続失敗・再試行時に `error` イベントを emit します。\n    // unhandled `error` によるクラッシュを抑止するため no-op リスナを付けます。\n    // 可観測性は v1 では提供しません。\n    raw.on(\"error\", () => {});\n\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    try {\n      await Promise.race([\n        raw.connect(),\n        new Promise<never>((_, reject) => {\n          timer = setTimeout(() => {\n            reject(new ConnectTimeoutError({ timeoutMs: connectTimeout }));\n          }, connectTimeout);\n        }),\n      ]);\n    } catch (ex) {\n      raw.disconnect();\n      throw ex;\n    } finally {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    }\n\n    this.#con = { client: raw };\n  }\n\n  public async close(_c: IStorage.CloseContext): Promise<void> {\n    // 未 `open`・二重 `close` は `TypeError` で reject されます。\n    // 必ず `await` し、結果を浮かせないでください。\n    const { client } = this.#getConnection();\n\n    // 先行 null 化により、並行 `close` 同士は二重 `quit` になりません。\n    this.#con = null;\n\n    const closeTimeout = this.#closeTimeout;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    try {\n      await Promise.race([\n        client.quit(),\n        new Promise<never>((_, reject) => {\n          timer = setTimeout(() => {\n            reject(new CloseTimeoutError({ timeoutMs: closeTimeout }));\n          }, closeTimeout);\n        }),\n      ]);\n    } catch {\n      // `quit()` の失敗全般 (タイムアウト含む) は `disconnect()` で掃除して正常復帰します。\n      client.disconnect();\n    } finally {\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n    }\n  }\n\n  #toKey(key: string): string {\n    return `${this.#keyPrefix}${key}`;\n  }\n\n  async #clearPattern(client: Ioredis, pattern: string, signal: AbortSignal): Promise<void> {\n    let cursor = \"0\";\n\n    do {\n      signal.throwIfAborted();\n\n      const [nextCursor, keys] = await client.scan(cursor, \"MATCH\", pattern, \"COUNT\", SCAN_COUNT);\n\n      if (keys.length > 0) {\n        await client.del(...keys);\n      }\n\n      cursor = nextCursor;\n    } while (cursor !== \"0\");\n  }\n\n  public async write(c: IStorage.WriteContext, data: Uint8Array<ArrayBuffer>): Promise<void> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    await client.set(this.#toKey(c.key), Buffer.from(data));\n  }\n\n  public async read(c: IStorage.ReadContext): Promise<Uint8Array<ArrayBuffer>> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    const data = await client.getBuffer(this.#toKey(c.key));\n\n    if (data === null) {\n      throw new KeyNotFoundError({ key: c.key });\n    }\n\n    return new Uint8Array(data);\n  }\n\n  public async exists(c: IStorage.ExistsContext): Promise<boolean> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    return (await client.exists(this.#toKey(c.key))) > 0;\n  }\n\n  public async delete(c: IStorage.DeleteContext): Promise<void> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    await client.del(this.#toKey(c.key));\n  }\n\n  public async clear(c: IStorage.ClearContext): Promise<void> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    // prefix が空文字の場合は MATCH \"*\" となり、選択中のデータベースの全キーが対象になります。\n    const pattern = `${this.#keyPrefix}*`;\n    await this.#clearPattern(client, pattern, c.signal);\n  }\n\n  public getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array<ArrayBuffer>> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    const dest = this.#toKey(c.key);\n    // 一意なサフィックスにより、同一キーへの並行書き込みでも一時キーが衝突しません。\n    const tmp = `${dest}.${randomUUID()}.tmp`;\n\n    // 中断と失敗のどちらからでも後始末が走るため、完了処理は一度だけ行います。\n    let finished = false;\n    const removeAbortListener = (): void => {\n      c.signal.removeEventListener(\"abort\", onAbort);\n    };\n    const discardTemporary = async (): Promise<void> => {\n      try {\n        await client.del(tmp);\n      } catch {\n        // 後始末としての削除のため、失敗しても無視します。\n      }\n    };\n    const finish = async (): Promise<void> => {\n      if (finished) {\n        return;\n      }\n\n      finished = true;\n      removeAbortListener();\n      await discardTemporary();\n    };\n    const onAbort = (): void => {\n      void finish();\n    };\n    c.signal.addEventListener(\"abort\", onAbort, { once: true });\n\n    return new WritableStream<Uint8Array<ArrayBuffer>>({\n      async abort() {\n        await finish();\n      },\n      async close() {\n        c.signal.throwIfAborted();\n        try {\n          // 全チャンクの追記が完了した時点で初めて最終キーへ置き換えます (swap-on-close)。\n          await client.rename(tmp, dest);\n        } catch (ex) {\n          await finish();\n          throw ex;\n        }\n        // rename 後は一時キーが存在しないため、完了済みとして中断時の削除を行いません。\n        finished = true;\n        removeAbortListener();\n      },\n      async start() {\n        try {\n          c.signal.throwIfAborted();\n          // 0 バイトの書き込みでも close 時の RENAME が成功するよう、空の文字列で一時キーを作ります。\n          await client.set(tmp, \"\");\n        } catch (ex) {\n          await finish();\n          throw ex;\n        }\n      },\n      async write(chunk) {\n        c.signal.throwIfAborted();\n        try {\n          await client.append(tmp, Buffer.from(chunk));\n        } catch (ex) {\n          await finish();\n          throw ex;\n        }\n      },\n    });\n  }\n\n  public getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array<ArrayBuffer>> {\n    const { client } = this.#getConnection();\n\n    c.signal.throwIfAborted();\n\n    const dest = this.#toKey(c.key);\n    let sent = false;\n\n    // Redis の GET は値を一括で返すため、取得したバイト列を単一のチャンクとして送出します。\n    return new ReadableStream<Uint8Array<ArrayBuffer>>({\n      async pull(controller) {\n        if (sent) {\n          controller.close();\n\n          return;\n        }\n\n        sent = true;\n        c.signal.throwIfAborted();\n\n        const data = await client.getBuffer(dest);\n\n        if (data === null) {\n          throw new KeyNotFoundError({ key: c.key });\n        }\n\n        controller.enqueue(new Uint8Array(data));\n        controller.close();\n      },\n    });\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,10 +1,43 @@
 {
   "name": "@unikvs/redis.node",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @unikvs/redis.node",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+  "version": "0.0.13",
+  "description": "Storage plugin that stores byte arrays in Redis on Node.js.",
+  "homepage": "https://tai-kun.github.io/unikvs/",
+  "license": "MIT",
+  "repository": {
+    "url": "https://github.com/tai-kun/unikvs",
+    "directory": "packages/redis.node"
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@unikvs/core": "0.0.13",
+    "ioredis": "^6.0.0"
+  },
+  "devDependencies": {
+    "@unikvs/testing": "0.0.0",
+    "@vitest/coverage-v8": "5.0.5",
+    "valibot": "1.5.0",
+    "vite-plus": "1.3.0"
+  },
+  "peerDependencies": {
+    "@logtape/logtape": "^2.0.0"
+  },
+  "readme": "README.md",
+  "scripts": {
+    "build": "vp -C .config pack"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,161 @@
+import { type ErrorOptions, ErrorBase, setErrorMessage, InvalidUsageErrorBase } from "@unikvs/core";
+
+export type { KeyNotFoundErrorArgs, KeyNotFoundErrorMeta } from "@unikvs/core";
+export { KeyNotFoundError } from "@unikvs/core";
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+ */
+export class ClusterNotSupportedError extends InvalidUsageErrorBase<undefined> {
+  static {
+    this.prototype.name = "RedisClusterNotSupportedError";
+  }
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-cluster-not-supported)
+   */
+  public constructor(options?: ErrorOptions) {
+    super(
+      "Redis storage v1 supports standalone mode only: the `cluster` option is not supported.",
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  ClusterNotSupportedError,
+  "Redis ストレージ v1 は standalone モードのみに対応します。`cluster` オプションはサポートされていません。",
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+export type InvalidCloseTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#invalid-close-timeout-actual)
+   */
+  readonly actual: unknown;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+export type InvalidCloseTimeoutErrorArgs = ErrorOptions & InvalidCloseTimeoutErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+ */
+export class InvalidCloseTimeoutError extends ErrorBase<InvalidCloseTimeoutErrorMeta> {
+  static {
+    this.prototype.name = "RedisInvalidCloseTimeoutError";
+  }
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-invalid-close-timeout)
+   */
+  public constructor(args: InvalidCloseTimeoutErrorArgs) {
+    const { actual, ...options } = args;
+    const meta: InvalidCloseTimeoutErrorMeta = { actual };
+    super(
+      meta,
+      ({ actual: messageActual }) =>
+        `\`closeTimeout\` must be a finite positive number (ms), but got ${String(messageActual)}.`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  InvalidCloseTimeoutError,
+  ({ actual }) =>
+    `\`closeTimeout\` は有限の正数 (ミリ秒) でなければなりません。受け取った値: ${String(actual)}`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+export type ConnectTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#connect-timeout-timeoutms)
+   */
+  readonly timeoutMs: number;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+export type ConnectTimeoutErrorArgs = ErrorOptions & ConnectTimeoutErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+ */
+export class ConnectTimeoutError extends ErrorBase<ConnectTimeoutErrorMeta> {
+  static {
+    this.prototype.name = "RedisConnectTimeoutError";
+  }
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-connect-timeout)
+   */
+  public constructor(args: ConnectTimeoutErrorArgs) {
+    const { timeoutMs, ...options } = args;
+    const meta: ConnectTimeoutErrorMeta = { timeoutMs };
+    super(
+      meta,
+      ({ timeoutMs: messageTimeoutMs }) =>
+        `Timed out connecting to Redis after ${messageTimeoutMs}ms`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  ConnectTimeoutError,
+  ({ timeoutMs }) => `Redis への接続が ${timeoutMs}ms でタイムアウトしました`,
+  "ja",
+);
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+export type CloseTimeoutErrorMeta = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#close-timeout-timeoutms)
+   */
+  readonly timeoutMs: number;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+export type CloseTimeoutErrorArgs = ErrorOptions & CloseTimeoutErrorMeta;
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+ */
+export class CloseTimeoutError extends ErrorBase<CloseTimeoutErrorMeta> {
+  static {
+    this.prototype.name = "RedisCloseTimeoutError";
+  }
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#error-close-timeout)
+   */
+  public constructor(args: CloseTimeoutErrorArgs) {
+    const { timeoutMs, ...options } = args;
+    const meta: CloseTimeoutErrorMeta = { timeoutMs };
+    super(
+      meta,
+      ({ timeoutMs: messageTimeoutMs }) => `Timed out closing Redis after ${messageTimeoutMs}ms`,
+      options,
+    );
+  }
+}
+
+setErrorMessage(
+  CloseTimeoutError,
+  ({ timeoutMs }) => `Redis からの切断処理が ${timeoutMs}ms でタイムアウトしました`,
+  "ja",
+);

package/src/index.ts

@@ -0,0 +1,19 @@
+export type {
+  KeyNotFoundErrorArgs,
+  KeyNotFoundErrorMeta,
+  CloseTimeoutErrorArgs,
+  CloseTimeoutErrorMeta,
+  ConnectTimeoutErrorArgs,
+  ConnectTimeoutErrorMeta,
+  InvalidCloseTimeoutErrorArgs,
+  InvalidCloseTimeoutErrorMeta,
+} from "./errors.js";
+export {
+  KeyNotFoundError,
+  CloseTimeoutError,
+  ConnectTimeoutError,
+  ClusterNotSupportedError,
+  InvalidCloseTimeoutError,
+} from "./errors.js";
+export type * from "./redis.js";
+export { default as Redis } from "./redis.js";

package/src/redis.ts

@@ -0,0 +1,392 @@
+import { randomUUID } from "node:crypto";
+
+import { type IStorage, KeyNotFoundError } from "@unikvs/core";
+import {
+  type ClusterNode,
+  type RedisOptions,
+  type ClusterOptions,
+  Redis as Ioredis,
+} from "ioredis";
+
+import {
+  CloseTimeoutError,
+  ConnectTimeoutError,
+  ClusterNotSupportedError,
+  InvalidCloseTimeoutError,
+} from "./errors.js";
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec)
+ */
+export type RedisClusterSpec = {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-nodes)
+   */
+  readonly nodes: readonly ClusterNode[];
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisclusterspec-options)
+   */
+  readonly options?: ClusterOptions | undefined;
+};
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions)
+ */
+export type RedisStorageOptions = Omit<RedisOptions, "keyPrefix" | "lazyConnect"> & {
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-keyprefix)
+   */
+  readonly keyPrefix?: string | undefined;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-cluster)
+   */
+  readonly cluster?: RedisClusterSpec | undefined;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redisstorageoptions-closetimeout)
+   */
+  readonly closeTimeout?: number | undefined;
+};
+
+const SCAN_COUNT = 1000;
+const DEFAULT_CONNECT_TIMEOUT_MS = 5000;
+const DEFAULT_CLOSE_TIMEOUT_MS = 5000;
+
+type Connection = { readonly client: Ioredis };
+
+/**
+ * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+ */
+export default class Redis implements IStorage {
+  #con: Connection | null;
+
+  readonly #url: string | undefined;
+
+  // `closeTimeout` は本パッケージ固有の拡張です。
+  // `this.#options` には含めず、別フィールドで保管します。
+  // `this.#options` は `new Ioredis` にそのまま spread できる透過バッグです。
+  readonly #options: Omit<RedisStorageOptions, "keyPrefix" | "cluster" | "closeTimeout">;
+
+  // `ioredis` の `disconnectTimeout` (ソケット切断待機) とは別物です。
+  readonly #closeTimeout: number;
+
+  readonly #keyPrefix: string;
+
+  public readonly name: string;
+
+  /**
+   * [API Reference](https://tai-kun.github.io/unikvs/packages/redis-node#redis)
+   */
+  public constructor(url?: string, options: RedisStorageOptions = {}) {
+    const {
+      cluster,
+      keyPrefix = "unikvs:",
+      closeTimeout = DEFAULT_CLOSE_TIMEOUT_MS,
+      ...redisOptions
+    } = options;
+
+    // v1 は standalone のみに対応します。
+    // `cluster` を指定したときは、`closeTimeout` 検証より先に拒否します。
+    if (cluster !== undefined) {
+      throw new ClusterNotSupportedError();
+    }
+
+    // `undefined` は既定値 5000ms になるため対象外とします。
+    // 明示値が有限の正数でない場合のみ拒否します。
+    if (typeof closeTimeout !== "number" || !Number.isFinite(closeTimeout) || closeTimeout <= 0) {
+      throw new InvalidCloseTimeoutError({ actual: closeTimeout });
+    }
+
+    this.name = "Redis";
+    this.#con = null;
+    this.#url = url;
+    this.#options = redisOptions;
+    this.#closeTimeout = closeTimeout;
+    this.#keyPrefix = keyPrefix;
+  }
+
+  public get isOpen(): boolean {
+    return this.#con !== null;
+  }
+
+  // 開いている接続を返します。
+  // 未オープン時は `TypeError` を投げます。
+  #getConnection(): Connection {
+    const con = this.#con;
+
+    if (con === null) {
+      throw new TypeError("Redis is not open. Call open() first.");
+    }
+
+    return con;
+  }
+
+  public async open(_c: IStorage.OpenContext): Promise<void> {
+    // 並行 `open` 同士および `open` 接続待ち中の `close` の同時呼び出しは禁止 (事前条件) です。
+    // 呼び出し側で直列化してください。
+    // 並行 `close` 同士は一方が `TypeError` reject する形で直列化されます。
+    if (this.#con) {
+      await this.close(_c as unknown as IStorage.CloseContext);
+    }
+
+    // 空文字の `url`・環境変数は未指定として扱います (本パッケージ仕様)。
+    // `url` は `redis://` / `rediss://` 形式での指定を要求します。
+    // 実行時の形式検証は行いません (bare 形式は非サポート・動作未保証)。
+    const explicitUrl = this.#url === undefined || this.#url === "" ? undefined : this.#url;
+    const redisUrl =
+      process.env["REDIS_URL"] === undefined || process.env["REDIS_URL"] === ""
+        ? undefined
+        : process.env["REDIS_URL"];
+    const valkeyUrl =
+      process.env["VALKEY_URL"] === undefined || process.env["VALKEY_URL"] === ""
+        ? undefined
+        : process.env["VALKEY_URL"];
+    const url = explicitUrl ?? redisUrl ?? valkeyUrl;
+    const connectTimeout = this.#options.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT_MS;
+
+    // `ioredis` v6 のコンストラクタ型は `replyMapping` に明示 `undefined` を許しません。
+    // `exactOptionalPropertyTypes` 下では spread のまま渡せないため型表明を付けます。
+    // 実行時の値は変わらず、`replyMapping` を含む透過は保たれます。
+    type ConnectOptions = RedisOptions & { replyMapping?: "legacy" };
+
+    const options = {
+      ...this.#options,
+      lazyConnect: true,
+      connectTimeout,
+    } as ConnectOptions;
+    const raw = url === undefined ? new Ioredis(options) : new Ioredis(url, options);
+
+    // `ioredis` は接続失敗・再試行時に `error` イベントを emit します。
+    // unhandled `error` によるクラッシュを抑止するため no-op リスナを付けます。
+    // 可観測性は v1 では提供しません。
+    raw.on("error", () => {});
+
+    let timer: ReturnType<typeof setTimeout> | undefined;
+
+    try {
+      await Promise.race([
+        raw.connect(),
+        new Promise<never>((_, reject) => {
+          timer = setTimeout(() => {
+            reject(new ConnectTimeoutError({ timeoutMs: connectTimeout }));
+          }, connectTimeout);
+        }),
+      ]);
+    } catch (ex) {
+      raw.disconnect();
+      throw ex;
+    } finally {
+      if (timer !== undefined) {
+        clearTimeout(timer);
+      }
+    }
+
+    this.#con = { client: raw };
+  }
+
+  public async close(_c: IStorage.CloseContext): Promise<void> {
+    // 未 `open`・二重 `close` は `TypeError` で reject されます。
+    // 必ず `await` し、結果を浮かせないでください。
+    const { client } = this.#getConnection();
+
+    // 先行 null 化により、並行 `close` 同士は二重 `quit` になりません。
+    this.#con = null;
+
+    const closeTimeout = this.#closeTimeout;
+    let timer: ReturnType<typeof setTimeout> | undefined;
+
+    try {
+      await Promise.race([
+        client.quit(),
+        new Promise<never>((_, reject) => {
+          timer = setTimeout(() => {
+            reject(new CloseTimeoutError({ timeoutMs: closeTimeout }));
+          }, closeTimeout);
+        }),
+      ]);
+    } catch {
+      // `quit()` の失敗全般 (タイムアウト含む) は `disconnect()` で掃除して正常復帰します。
+      client.disconnect();
+    } finally {
+      if (timer !== undefined) {
+        clearTimeout(timer);
+      }
+    }
+  }
+
+  #toKey(key: string): string {
+    return `${this.#keyPrefix}${key}`;
+  }
+
+  async #clearPattern(client: Ioredis, pattern: string, signal: AbortSignal): Promise<void> {
+    let cursor = "0";
+
+    do {
+      signal.throwIfAborted();
+
+      const [nextCursor, keys] = await client.scan(cursor, "MATCH", pattern, "COUNT", SCAN_COUNT);
+
+      if (keys.length > 0) {
+        await client.del(...keys);
+      }
+
+      cursor = nextCursor;
+    } while (cursor !== "0");
+  }
+
+  public async write(c: IStorage.WriteContext, data: Uint8Array<ArrayBuffer>): Promise<void> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    await client.set(this.#toKey(c.key), Buffer.from(data));
+  }
+
+  public async read(c: IStorage.ReadContext): Promise<Uint8Array<ArrayBuffer>> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    const data = await client.getBuffer(this.#toKey(c.key));
+
+    if (data === null) {
+      throw new KeyNotFoundError({ key: c.key });
+    }
+
+    return new Uint8Array(data);
+  }
+
+  public async exists(c: IStorage.ExistsContext): Promise<boolean> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    return (await client.exists(this.#toKey(c.key))) > 0;
+  }
+
+  public async delete(c: IStorage.DeleteContext): Promise<void> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    await client.del(this.#toKey(c.key));
+  }
+
+  public async clear(c: IStorage.ClearContext): Promise<void> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    // prefix が空文字の場合は MATCH "*" となり、選択中のデータベースの全キーが対象になります。
+    const pattern = `${this.#keyPrefix}*`;
+    await this.#clearPattern(client, pattern, c.signal);
+  }
+
+  public getWritable(c: IStorage.GetWritableContext): WritableStream<Uint8Array<ArrayBuffer>> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    const dest = this.#toKey(c.key);
+    // 一意なサフィックスにより、同一キーへの並行書き込みでも一時キーが衝突しません。
+    const tmp = `${dest}.${randomUUID()}.tmp`;
+
+    // 中断と失敗のどちらからでも後始末が走るため、完了処理は一度だけ行います。
+    let finished = false;
+    const removeAbortListener = (): void => {
+      c.signal.removeEventListener("abort", onAbort);
+    };
+    const discardTemporary = async (): Promise<void> => {
+      try {
+        await client.del(tmp);
+      } catch {
+        // 後始末としての削除のため、失敗しても無視します。
+      }
+    };
+    const finish = async (): Promise<void> => {
+      if (finished) {
+        return;
+      }
+
+      finished = true;
+      removeAbortListener();
+      await discardTemporary();
+    };
+    const onAbort = (): void => {
+      void finish();
+    };
+    c.signal.addEventListener("abort", onAbort, { once: true });
+
+    return new WritableStream<Uint8Array<ArrayBuffer>>({
+      async abort() {
+        await finish();
+      },
+      async close() {
+        c.signal.throwIfAborted();
+        try {
+          // 全チャンクの追記が完了した時点で初めて最終キーへ置き換えます (swap-on-close)。
+          await client.rename(tmp, dest);
+        } catch (ex) {
+          await finish();
+          throw ex;
+        }
+        // rename 後は一時キーが存在しないため、完了済みとして中断時の削除を行いません。
+        finished = true;
+        removeAbortListener();
+      },
+      async start() {
+        try {
+          c.signal.throwIfAborted();
+          // 0 バイトの書き込みでも close 時の RENAME が成功するよう、空の文字列で一時キーを作ります。
+          await client.set(tmp, "");
+        } catch (ex) {
+          await finish();
+          throw ex;
+        }
+      },
+      async write(chunk) {
+        c.signal.throwIfAborted();
+        try {
+          await client.append(tmp, Buffer.from(chunk));
+        } catch (ex) {
+          await finish();
+          throw ex;
+        }
+      },
+    });
+  }
+
+  public getReadable(c: IStorage.GetReadableContext): ReadableStream<Uint8Array<ArrayBuffer>> {
+    const { client } = this.#getConnection();
+
+    c.signal.throwIfAborted();
+
+    const dest = this.#toKey(c.key);
+    let sent = false;
+
+    // Redis の GET は値を一括で返すため、取得したバイト列を単一のチャンクとして送出します。
+    return new ReadableStream<Uint8Array<ArrayBuffer>>({
+      async pull(controller) {
+        if (sent) {
+          controller.close();
+
+          return;
+        }
+
+        sent = true;
+        c.signal.throwIfAborted();
+
+        const data = await client.getBuffer(dest);
+
+        if (data === null) {
+          throw new KeyNotFoundError({ key: c.key });
+        }
+
+        controller.enqueue(new Uint8Array(data));
+        controller.close();
+      },
+    });
+  }
+}