@zeltjs/kv 0.0.1 → 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 9wick / Kohei Kido
+
+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,32 @@
 # @zeltjs/kv
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+[![Documentation](https://img.shields.io/badge/docs-zeltjs.com-blue)](https://zeltjs.com)
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+Key-value store abstraction for Zelt applications.
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+**[Read the Documentation](https://zeltjs.com)**
 
-## Purpose
+## Installation
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@zeltjs/kv`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+```bash
+npm install @zeltjs/kv @zeltjs/core
+```
 
-## What is OIDC Trusted Publishing?
+## Usage
 
-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.
+```typescript
+import { MemoryKVAdaptor } from '@zeltjs/kv';
+import type { KVStore } from '@zeltjs/kv';
 
-## Setup Instructions
+const kv: KVStore = new MemoryKVAdaptor();
 
-To properly configure OIDC trusted publishing for this package:
+await kv.set('user:1', { name: 'Alice' });
+const user = await kv.get('user:1');
 
-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
+await kv.set('session:abc', { userId: '1' }, { ttl: 3600 });
+```
 
-## DO NOT USE THIS PACKAGE
+## Adaptors
 
-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**
+- `MemoryKVAdaptor` - In-memory store (for testing/development)
+- `@zeltjs/redis` - Redis-backed store

package/dist/adaptor-memory/index.d.ts

@@ -0,0 +1,2 @@
+import { t as MemoryKVAdaptor } from "../index-BlASVNzQ.js";
+export { MemoryKVAdaptor };

package/dist/adaptor-memory/index.js

@@ -0,0 +1,2 @@
+import { t as MemoryKVAdaptor } from "../adaptor-memory-BcPJjrIS.js";
+export { MemoryKVAdaptor };

package/dist/adaptor-memory-BcPJjrIS.js

@@ -0,0 +1,103 @@
+import { i as ZeltKVInvalidTtlError, n as serialize, r as joinPrefix, t as deserialize } from "./serialize-DwL5y2vb.js";
+import { Injectable, LifecycleManager, inject } from "@zeltjs/core";
+//#region src/adaptor-memory/memory-kv.adaptor.ts
+/** @throws {ZeltKVInvalidTtlError} */
+function validateTtl(ttlSec) {
+	if (ttlSec !== void 0 && ttlSec <= 0) throw new ZeltKVInvalidTtlError({ ttlSec });
+}
+function makeEntry(raw, ttlSec) {
+	return ttlSec !== void 0 ? {
+		raw,
+		expiresAt: Date.now() + ttlSec * 1e3
+	} : { raw };
+}
+var MemoryKVAdaptor = @Injectable() class {
+	constructor(lifecycle = inject(LifecycleManager)) {
+		this.data = /* @__PURE__ */ new Map();
+		this.gcInterval = setInterval(() => this.gc(), 6e4);
+		this.gcInterval.unref();
+		lifecycle.register(this);
+	}
+	gc() {
+		const now = Date.now();
+		for (const [key, entry] of this.data) if (entry.expiresAt !== void 0 && entry.expiresAt <= now) this.data.delete(key);
+	}
+	async startup() {}
+	async shutdown() {
+		clearInterval(this.gcInterval);
+	}
+	namespace(prefix) {
+		return new MemoryKVStore(this.data, prefix);
+	}
+};
+var MemoryKVStore = class MemoryKVStore {
+	constructor(data, prefix) {
+		this.data = data;
+		this.prefix = prefix;
+	}
+	k(key) {
+		return this.prefix + key;
+	}
+	current(key) {
+		const entry = this.data.get(this.k(key));
+		if (!entry) return void 0;
+		if (entry.expiresAt !== void 0 && entry.expiresAt <= Date.now()) {
+			this.data.delete(this.k(key));
+			return;
+		}
+		return entry;
+	}
+	async get(key) {
+		const entry = this.current(key);
+		return entry ? deserialize(entry.raw) : void 0;
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async set(key, value, opts) {
+		validateTtl(opts?.ttlSec);
+		const raw = serialize(value);
+		this.data.set(this.k(key), makeEntry(raw, opts?.ttlSec));
+	}
+	async del(key) {
+		this.data.delete(this.k(key));
+	}
+	async has(key) {
+		return this.current(key) !== void 0;
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async expire(key, ttlSec) {
+		validateTtl(ttlSec);
+		const entry = this.current(key);
+		if (!entry) return false;
+		entry.expiresAt = Date.now() + ttlSec * 1e3;
+		return true;
+	}
+	namespace(sub) {
+		return new MemoryKVStore(this.data, joinPrefix(this.prefix, sub));
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async incr(key, by = 1, opts) {
+		validateTtl(opts?.ttlSec);
+		const k = this.k(key);
+		const entry = this.current(key);
+		if (!entry) {
+			const raw = serialize(by);
+			this.data.set(k, makeEntry(raw, opts?.ttlSec));
+			return by;
+		}
+		const next = (deserialize(entry.raw) ?? 0) + by;
+		entry.raw = serialize(next);
+		return next;
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async setnx(key, value, opts) {
+		validateTtl(opts?.ttlSec);
+		if (this.current(key)) return false;
+		const raw = serialize(value);
+		this.data.set(this.k(key), makeEntry(raw, opts?.ttlSec));
+		return true;
+	}
+};
+//#endregion
+export { MemoryKVAdaptor as t };
+
+//# sourceMappingURL=adaptor-memory-BcPJjrIS.js.map

package/dist/adaptor-memory-BcPJjrIS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor-memory-BcPJjrIS.js","names":[],"sources":["../src/adaptor-memory/memory-kv.adaptor.ts"],"sourcesContent":["import type { Lifecycle } from '@zeltjs/core';\nimport { Injectable, inject, LifecycleManager } from '@zeltjs/core';\n\nimport { ZeltKVInvalidTtlError } from '../errors';\nimport { joinPrefix } from '../namespace';\nimport { deserialize, serialize } from '../serialize';\nimport type { AtomicKVAdaptor, AtomicKVStore, Defined, NonEmptyString, SetOptions } from '../types';\n\ntype Entry = {\n  raw: string;\n  /** epoch ms。undefined は永続 */\n  expiresAt?: number;\n};\n\n/** @throws {ZeltKVInvalidTtlError} */\nfunction validateTtl(ttlSec: number | undefined): void {\n  if (ttlSec !== undefined && ttlSec <= 0) throw new ZeltKVInvalidTtlError({ ttlSec });\n}\n\nfunction makeEntry(raw: string, ttlSec?: number): Entry {\n  return ttlSec !== undefined ? { raw, expiresAt: Date.now() + ttlSec * 1000 } : { raw };\n}\n\n@Injectable()\nexport class MemoryKVAdaptor implements AtomicKVAdaptor, Lifecycle {\n  private readonly data = new Map<string, Entry>();\n  private readonly gcInterval: ReturnType<typeof setInterval>;\n\n  constructor(lifecycle = inject(LifecycleManager)) {\n    this.gcInterval = setInterval(() => this.gc(), 60_000);\n    this.gcInterval.unref();\n    lifecycle.register(this);\n  }\n\n  private gc(): void {\n    const now = Date.now();\n    for (const [key, entry] of this.data) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now) {\n        this.data.delete(key);\n      }\n    }\n  }\n\n  async startup(): Promise<void> {}\n\n  async shutdown(): Promise<void> {\n    clearInterval(this.gcInterval);\n  }\n\n  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore {\n    return new MemoryKVStore(this.data, prefix);\n  }\n}\n\nclass MemoryKVStore implements AtomicKVStore {\n  constructor(\n    private readonly data: Map<string, Entry>,\n    private readonly prefix: string,\n  ) {}\n\n  private k(key: string): string {\n    return this.prefix + key;\n  }\n\n  private current(key: string): Entry | undefined {\n    const entry = this.data.get(this.k(key));\n    if (!entry) return undefined;\n    if (entry.expiresAt !== undefined && entry.expiresAt <= Date.now()) {\n      this.data.delete(this.k(key));\n      return undefined;\n    }\n    return entry;\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const entry = this.current(key);\n    return entry ? deserialize<T>(entry.raw) : undefined;\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async set<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<void> {\n    validateTtl(opts?.ttlSec);\n    const raw = serialize(value);\n    this.data.set(this.k(key), makeEntry(raw, opts?.ttlSec));\n  }\n\n  async del(key: string): Promise<void> {\n    this.data.delete(this.k(key));\n  }\n\n  async has(key: string): Promise<boolean> {\n    return this.current(key) !== undefined;\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async expire(key: string, ttlSec: number): Promise<boolean> {\n    validateTtl(ttlSec);\n    const entry = this.current(key);\n    if (!entry) return false;\n    entry.expiresAt = Date.now() + ttlSec * 1000;\n    return true;\n  }\n\n  namespace<const S extends string>(sub: NonEmptyString<S>): AtomicKVStore {\n    return new MemoryKVStore(this.data, joinPrefix(this.prefix, sub));\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async incr(key: string, by = 1, opts?: { ttlSec?: number }): Promise<number> {\n    validateTtl(opts?.ttlSec);\n    const k = this.k(key);\n    const entry = this.current(key);\n    if (!entry) {\n      const raw = serialize(by);\n      this.data.set(k, makeEntry(raw, opts?.ttlSec));\n      return by;\n    }\n    const next = (deserialize<number>(entry.raw) ?? 0) + by;\n    entry.raw = serialize(next);\n    return next;\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async setnx<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<boolean> {\n    validateTtl(opts?.ttlSec);\n    if (this.current(key)) return false;\n    const raw = serialize(value);\n    this.data.set(this.k(key), makeEntry(raw, opts?.ttlSec));\n    return true;\n  }\n}\n"],"mappings":"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"}

package/dist/adaptor-redis/index.d.ts

@@ -0,0 +1,12 @@
+import { n as AtomicKVStore, o as NonEmptyString, t as AtomicKVAdaptor } from "../types-PDNBLwuJ.js";
+import { RedisService } from "@zeltjs/redis";
+
+//#region src/adaptor-redis/redis-kv-adaptor.d.ts
+declare class RedisKVAdaptor implements AtomicKVAdaptor {
+  private readonly redis;
+  constructor(redis?: RedisService);
+  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore;
+}
+//#endregion
+export { RedisKVAdaptor };
+//# sourceMappingURL=index.d.ts.map

package/dist/adaptor-redis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/adaptor-redis/redis-kv-adaptor.ts"],"mappings":";;;;cAOa,cAAA,YAA0B,eAAA;EAAA,iBACR,KAAA;cAAA,KAAA,GAAK,YAAA;EAElC,SAAA,wBAAA,CAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,aAAA;AAAA"}

package/dist/adaptor-redis/index.js

@@ -0,0 +1,79 @@
+import { i as ZeltKVInvalidTtlError, n as serialize, r as joinPrefix, t as deserialize } from "../serialize-DwL5y2vb.js";
+import { inject } from "@zeltjs/core";
+import { RedisService } from "@zeltjs/redis";
+//#region src/adaptor-redis/lua-scripts.ts
+const INCR_WITH_TTL_LUA = `
+  if ARGV[2] ~= '' then
+    redis.call('SET', KEYS[1], 0, 'EX', ARGV[2], 'NX')
+  end
+  return redis.call('INCRBY', KEYS[1], ARGV[1])
+`;
+//#endregion
+//#region src/adaptor-redis/redis-kv-store.ts
+/** @throws {ZeltKVInvalidTtlError} */
+const validateTtl = (ttlSec) => {
+	if (ttlSec !== void 0 && ttlSec <= 0) throw new ZeltKVInvalidTtlError({ ttlSec });
+};
+const incrWithTtl = async (client, key, by, ttlSec) => {
+	const ttlArg = ttlSec !== void 0 ? String(ttlSec) : "";
+	return client.eval(INCR_WITH_TTL_LUA, 1, key, by, ttlArg);
+};
+var RedisKVStore = class RedisKVStore {
+	constructor(client, prefix) {
+		this.client = client;
+		this.prefix = prefix;
+	}
+	k(key) {
+		return this.prefix + key;
+	}
+	async get(key) {
+		const raw = await this.client.get(this.k(key));
+		return raw === null ? void 0 : deserialize(raw);
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async set(key, value, opts) {
+		validateTtl(opts?.ttlSec);
+		const json = serialize(value);
+		if (opts?.ttlSec !== void 0) await this.client.set(this.k(key), json, "EX", opts.ttlSec);
+		else await this.client.set(this.k(key), json);
+	}
+	async del(key) {
+		await this.client.del(this.k(key));
+	}
+	async has(key) {
+		return await this.client.exists(this.k(key)) === 1;
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async expire(key, ttlSec) {
+		validateTtl(ttlSec);
+		return await this.client.expire(this.k(key), ttlSec) === 1;
+	}
+	namespace(sub) {
+		return new RedisKVStore(this.client, joinPrefix(this.prefix, sub));
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async incr(key, by = 1, opts) {
+		validateTtl(opts?.ttlSec);
+		return incrWithTtl(this.client, this.k(key), by, opts?.ttlSec);
+	}
+	/** @throws {ZeltKVInvalidTtlError} */
+	async setnx(key, value, opts) {
+		validateTtl(opts?.ttlSec);
+		const json = serialize(value);
+		return (opts?.ttlSec !== void 0 ? await this.client.set(this.k(key), json, "EX", opts.ttlSec, "NX") : await this.client.set(this.k(key), json, "NX")) === "OK";
+	}
+};
+//#endregion
+//#region src/adaptor-redis/redis-kv-adaptor.ts
+var RedisKVAdaptor = class {
+	constructor(redis = inject(RedisService)) {
+		this.redis = redis;
+	}
+	namespace(prefix) {
+		return new RedisKVStore(this.redis.client, prefix);
+	}
+};
+//#endregion
+export { RedisKVAdaptor };
+
+//# sourceMappingURL=index.js.map

package/dist/adaptor-redis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/adaptor-redis/lua-scripts.ts","../../src/adaptor-redis/redis-kv-store.ts","../../src/adaptor-redis/redis-kv-adaptor.ts"],"sourcesContent":["export const INCR_WITH_TTL_LUA = `\n  if ARGV[2] ~= '' then\n    redis.call('SET', KEYS[1], 0, 'EX', ARGV[2], 'NX')\n  end\n  return redis.call('INCRBY', KEYS[1], ARGV[1])\n`;\n","import type Redis from 'ioredis';\nimport { ZeltKVInvalidTtlError } from '../errors';\nimport { joinPrefix } from '../namespace';\nimport { deserialize, serialize } from '../serialize';\nimport type { AtomicKVStore, Defined, NonEmptyString, SetOptions } from '../types';\n\nimport { INCR_WITH_TTL_LUA } from './lua-scripts';\n\n/** @throws {ZeltKVInvalidTtlError} */\nconst validateTtl = (ttlSec: number | undefined): void => {\n  if (ttlSec !== undefined && ttlSec <= 0) throw new ZeltKVInvalidTtlError({ ttlSec });\n};\n\nconst incrWithTtl = async (\n  client: Redis,\n  key: string,\n  by: number,\n  ttlSec: number | undefined,\n): Promise<number> => {\n  const ttlArg = ttlSec !== undefined ? String(ttlSec) : '';\n  return client.eval(INCR_WITH_TTL_LUA, 1, key, by, ttlArg) as Promise<number>;\n};\n\nexport class RedisKVStore implements AtomicKVStore {\n  constructor(\n    private readonly client: Redis,\n    private readonly prefix: string,\n  ) {}\n\n  private k(key: string): string {\n    return this.prefix + key;\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const raw = await this.client.get(this.k(key));\n    return raw === null ? undefined : deserialize<T>(raw);\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async set<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<void> {\n    validateTtl(opts?.ttlSec);\n    const json = serialize(value);\n    if (opts?.ttlSec !== undefined) {\n      await this.client.set(this.k(key), json, 'EX', opts.ttlSec);\n    } else {\n      await this.client.set(this.k(key), json);\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    await this.client.del(this.k(key));\n  }\n\n  async has(key: string): Promise<boolean> {\n    const n = await this.client.exists(this.k(key));\n    return n === 1;\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async expire(key: string, ttlSec: number): Promise<boolean> {\n    validateTtl(ttlSec);\n    const n = await this.client.expire(this.k(key), ttlSec);\n    return n === 1;\n  }\n\n  namespace<const S extends string>(sub: NonEmptyString<S>): AtomicKVStore {\n    return new RedisKVStore(this.client, joinPrefix(this.prefix, sub));\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async incr(key: string, by = 1, opts?: { ttlSec?: number }): Promise<number> {\n    validateTtl(opts?.ttlSec);\n    return incrWithTtl(this.client, this.k(key), by, opts?.ttlSec);\n  }\n\n  /** @throws {ZeltKVInvalidTtlError} */\n  async setnx<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<boolean> {\n    validateTtl(opts?.ttlSec);\n    const json = serialize(value);\n    const result =\n      opts?.ttlSec !== undefined\n        ? await this.client.set(this.k(key), json, 'EX', opts.ttlSec, 'NX')\n        : await this.client.set(this.k(key), json, 'NX');\n    return result === 'OK';\n  }\n}\n","import { inject } from '@zeltjs/core';\nimport { RedisService } from '@zeltjs/redis';\n\nimport type { AtomicKVAdaptor, AtomicKVStore, NonEmptyString } from '../types';\n\nimport { RedisKVStore } from './redis-kv-store';\n\nexport class RedisKVAdaptor implements AtomicKVAdaptor {\n  constructor(private readonly redis = inject(RedisService)) {}\n\n  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore {\n    return new RedisKVStore(this.redis.client, prefix);\n  }\n}\n"],"mappings":";;;;AAAA,MAAa,oBAAoB;;;;;;;;;ACSjC,MAAM,eAAe,WAAqC;AACxD,KAAI,WAAW,KAAA,KAAa,UAAU,EAAG,OAAM,IAAI,sBAAsB,EAAE,QAAQ,CAAC;;AAGtF,MAAM,cAAc,OAClB,QACA,KACA,IACA,WACoB;CACpB,MAAM,SAAS,WAAW,KAAA,IAAY,OAAO,OAAO,GAAG;AACvD,QAAO,OAAO,KAAK,mBAAmB,GAAG,KAAK,IAAI,OAAO;;AAG3D,IAAa,eAAb,MAAa,aAAsC;CACjD,YACE,QACA,QACA;AAFiB,OAAA,SAAA;AACA,OAAA,SAAA;;CAGnB,EAAU,KAAqB;AAC7B,SAAO,KAAK,SAAS;;CAGvB,MAAM,IAAO,KAAqC;EAChD,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,CAAC;AAC9C,SAAO,QAAQ,OAAO,KAAA,IAAY,YAAe,IAAI;;;CAIvD,MAAM,IAAuB,KAAa,OAAU,MAAkC;AACpF,cAAY,MAAM,OAAO;EACzB,MAAM,OAAO,UAAU,MAAM;AAC7B,MAAI,MAAM,WAAW,KAAA,EACnB,OAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,KAAK,OAAO;MAE3D,OAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK;;CAI5C,MAAM,IAAI,KAA4B;AACpC,QAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,CAAC;;CAGpC,MAAM,IAAI,KAA+B;AAEvC,SAAO,MADS,KAAK,OAAO,OAAO,KAAK,EAAE,IAAI,CAAC,KAClC;;;CAIf,MAAM,OAAO,KAAa,QAAkC;AAC1D,cAAY,OAAO;AAEnB,SAAO,MADS,KAAK,OAAO,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,KAC1C;;CAGf,UAAkC,KAAuC;AACvE,SAAO,IAAI,aAAa,KAAK,QAAQ,WAAW,KAAK,QAAQ,IAAI,CAAC;;;CAIpE,MAAM,KAAK,KAAa,KAAK,GAAG,MAA6C;AAC3E,cAAY,MAAM,OAAO;AACzB,SAAO,YAAY,KAAK,QAAQ,KAAK,EAAE,IAAI,EAAE,IAAI,MAAM,OAAO;;;CAIhE,MAAM,MAAyB,KAAa,OAAU,MAAqC;AACzF,cAAY,MAAM,OAAO;EACzB,MAAM,OAAO,UAAU,MAAM;AAK7B,UAHE,MAAM,WAAW,KAAA,IACb,MAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,KAAK,QAAQ,KAAK,GACjE,MAAM,KAAK,OAAO,IAAI,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,MAClC;;;;;AC5EtB,IAAa,iBAAb,MAAuD;CACrD,YAAY,QAAyB,OAAO,aAAa,EAAE;AAA9B,OAAA,QAAA;;CAE7B,UAAkC,QAA0C;AAC1E,SAAO,IAAI,aAAa,KAAK,MAAM,QAAQ,OAAO"}

package/dist/index-BlASVNzQ.d.ts

@@ -0,0 +1,16 @@
+import { n as AtomicKVStore, o as NonEmptyString, t as AtomicKVAdaptor } from "./types-PDNBLwuJ.js";
+import { Lifecycle, LifecycleManager } from "@zeltjs/core";
+
+//#region src/adaptor-memory/memory-kv.adaptor.d.ts
+declare class MemoryKVAdaptor implements AtomicKVAdaptor, Lifecycle {
+  private readonly data;
+  private readonly gcInterval;
+  constructor(lifecycle?: LifecycleManager);
+  private gc;
+  startup(): Promise<void>;
+  shutdown(): Promise<void>;
+  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore;
+}
+//#endregion
+export { MemoryKVAdaptor as t };
+//# sourceMappingURL=index-BlASVNzQ.d.ts.map

package/dist/index-BlASVNzQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BlASVNzQ.d.ts","names":[],"sources":["../src/adaptor-memory/memory-kv.adaptor.ts"],"mappings":";;;;cAwBa,eAAA,YAA2B,eAAA,EAAiB,SAAA;EAAA,iBACtC,IAAA;EAAA,iBACA,UAAA;cAEL,SAAA,GAAS,gBAAA;EAAA,QAMb,EAAA;EASF,OAAA,CAAA,GAAW,OAAA;EAEX,QAAA,CAAA,GAAY,OAAA;EAIlB,SAAA,wBAAA,CAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,aAAA;AAAA"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { a as KVStore, i as KVAdaptor, n as AtomicKVStore, o as NonEmptyString, r as Defined, s as SetOptions, t as AtomicKVAdaptor } from "./types-PDNBLwuJ.js";
+import { t as MemoryKVAdaptor } from "./index-BlASVNzQ.js";
+
+//#region src/errors.d.ts
+declare const ZeltKVInvalidTtlError: new (context: {
+  ttlSec: number;
+}, cause?: unknown) => Error & {
+  readonly name: string;
+  readonly context: {
+    ttlSec: number;
+  };
+};
+declare const isZeltKVInvalidTtlError: (err: unknown) => err is InstanceType<typeof ZeltKVInvalidTtlError>;
+//#endregion
+//#region src/namespace.d.ts
+declare const joinPrefix: (a: string, b: string) => string;
+//#endregion
+//#region src/serialize.d.ts
+declare const serialize: (value: Defined) => string;
+declare const deserialize: <T>(raw: string | null) => T | undefined;
+//#endregion
+export { type AtomicKVAdaptor, type AtomicKVStore, type Defined, type KVAdaptor, type KVStore, MemoryKVAdaptor as MemoryKV, MemoryKVAdaptor, MemoryKVAdaptor as MemoryKVService, type NonEmptyString, type SetOptions, ZeltKVInvalidTtlError, deserialize, isZeltKVInvalidTtlError, joinPrefix, serialize };
+//# 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/namespace.ts","../src/serialize.ts"],"mappings":";;;;cAEa,qBAAA,OAAqB,OAAA;;uBAGjC,KAAA;EAAA;;;;;cAEY,uBAAA,GACX,GAAA,cACC,GAAA,IAAO,YAAA,QAAoB,qBAAA;;;cCTjB,UAAA,GAAc,CAAA,UAAW,CAAA;;;cCEzB,SAAA,GAAa,KAAA,EAAO,OAAA;AAAA,cAIpB,WAAA,MAAkB,GAAA,oBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { a as isZeltKVInvalidTtlError, i as ZeltKVInvalidTtlError, n as serialize, r as joinPrefix, t as deserialize } from "./serialize-DwL5y2vb.js";
+import { t as MemoryKVAdaptor } from "./adaptor-memory-BcPJjrIS.js";
+export { MemoryKVAdaptor as MemoryKV, MemoryKVAdaptor, MemoryKVAdaptor as MemoryKVService, ZeltKVInvalidTtlError, deserialize, isZeltKVInvalidTtlError, joinPrefix, serialize };

package/dist/serialize-DwL5y2vb.js

@@ -0,0 +1,20 @@
+import { defineError } from "@zeltjs/core/internal-bridge/errors";
+//#region src/errors.ts
+const ZeltKVInvalidTtlError = defineError("ZeltKVInvalidTtlError", (ctx) => `ttlSec must be > 0, got ${ctx.ttlSec}`);
+const isZeltKVInvalidTtlError = (err) => {
+	return err instanceof ZeltKVInvalidTtlError;
+};
+//#endregion
+//#region src/namespace.ts
+const joinPrefix = (a, b) => a + b;
+//#endregion
+//#region src/serialize.ts
+const serialize = (value) => JSON.stringify(value);
+const deserialize = (raw) => {
+	if (raw === null) return void 0;
+	return JSON.parse(raw);
+};
+//#endregion
+export { isZeltKVInvalidTtlError as a, ZeltKVInvalidTtlError as i, serialize as n, joinPrefix as r, deserialize as t };
+
+//# sourceMappingURL=serialize-DwL5y2vb.js.map

package/dist/serialize-DwL5y2vb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-DwL5y2vb.js","names":[],"sources":["../src/errors.ts","../src/namespace.ts","../src/serialize.ts"],"sourcesContent":["import { defineError } from '@zeltjs/core/internal-bridge/errors';\n\nexport const ZeltKVInvalidTtlError = defineError(\n  'ZeltKVInvalidTtlError',\n  (ctx: { ttlSec: number }) => `ttlSec must be > 0, got ${ctx.ttlSec}`,\n);\n\nexport const isZeltKVInvalidTtlError = (\n  err: unknown,\n): err is InstanceType<typeof ZeltKVInvalidTtlError> => {\n  return err instanceof ZeltKVInvalidTtlError;\n};\n","export const joinPrefix = (a: string, b: string): string => a + b;\n","import type { Defined } from './types';\n\nexport const serialize = (value: Defined): string => JSON.stringify(value);\n\n// deserialize stays sync without Result because we control the input (always\n// a string we previously serialized via JSON.stringify, plus driver-controlled null sentinel).\nexport const deserialize = <T>(raw: string | null): T | undefined => {\n  if (raw === null) return undefined;\n  return JSON.parse(raw) as T;\n};\n"],"mappings":";;AAEA,MAAa,wBAAwB,YACnC,0BACC,QAA4B,2BAA2B,IAAI,SAC7D;AAED,MAAa,2BACX,QACsD;AACtD,QAAO,eAAe;;;;ACVxB,MAAa,cAAc,GAAW,MAAsB,IAAI;;;ACEhE,MAAa,aAAa,UAA2B,KAAK,UAAU,MAAM;AAI1E,MAAa,eAAkB,QAAsC;AACnE,KAAI,QAAQ,KAAM,QAAO,KAAA;AACzB,QAAO,KAAK,MAAM,IAAI"}

package/dist/types-PDNBLwuJ.d.ts

@@ -0,0 +1,52 @@
+//#region src/types.d.ts
+/** 空文字を型レベルで禁止 */
+type NonEmptyString<S extends string> = S extends '' ? never : S;
+/** undefined を除外した値型 */
+type Defined = {} | null;
+/** Top-level adaptor. namespace で view を取り出すまで data ops は不可。 */
+interface KVAdaptor {
+  namespace<const S extends string>(prefix: NonEmptyString<S>): KVStore;
+}
+/** atomic 操作対応の adaptor。namespace の戻り値が AtomicKVStore */
+interface AtomicKVAdaptor extends KVAdaptor {
+  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore;
+}
+/** namespaced view。実際の data ops はここ */
+interface KVStore {
+  get<T>(key: string): Promise<T | undefined>;
+  /**
+   * @throws {ZeltKVInvalidTtlError}
+   */
+  set<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<void>;
+  del(key: string): Promise<void>;
+  has(key: string): Promise<boolean>;
+  /**
+   * TTL 延長 (session touch / lock extend 用)。key 不在時は false。
+   * @throws {ZeltKVInvalidTtlError}
+   */
+  expire(key: string, ttlSec: number): Promise<boolean>;
+  /** 子 namespace。チェーン可能。 */
+  namespace<const S extends string>(prefix: NonEmptyString<S>): KVStore;
+}
+/** atomic 操作対応 view */
+interface AtomicKVStore extends KVStore {
+  /**
+   * atomic incr。最初の incr 時のみ TTL をセット。
+   * @throws {ZeltKVInvalidTtlError}
+   */
+  incr(key: string, by?: number, opts?: {
+    ttlSec?: number;
+  }): Promise<number>;
+  /**
+   * atomic set if not exists。set されたら true、既存なら false。
+   * @throws {ZeltKVInvalidTtlError}
+   */
+  setnx<T extends Defined>(key: string, value: T, opts?: SetOptions): Promise<boolean>;
+  namespace<const S extends string>(prefix: NonEmptyString<S>): AtomicKVStore;
+}
+type SetOptions = {
+  ttlSec?: number;
+};
+//#endregion
+export { KVStore as a, KVAdaptor as i, AtomicKVStore as n, NonEmptyString as o, Defined as r, SetOptions as s, AtomicKVAdaptor as t };
+//# sourceMappingURL=types-PDNBLwuJ.d.ts.map

package/dist/types-PDNBLwuJ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-PDNBLwuJ.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;KACY,cAAA,qBAAmC,CAAA,sBAAuB,CAAA;;KAI1D,OAAA;;UAGK,SAAA;EACf,SAAA,yBAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,OAAA;AAAA;;UAI/C,eAAA,SAAwB,SAAA;EACvC,SAAA,yBAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,aAAA;AAAA;;UAI/C,OAAA;EACf,GAAA,IAAO,GAAA,WAAc,OAAA,CAAQ,CAAA;EAXd;;;EAef,GAAA,WAAc,OAAA,EAAS,GAAA,UAAa,KAAA,EAAO,CAAA,EAAG,IAAA,GAAO,UAAA,GAAa,OAAA;EAClE,GAAA,CAAI,GAAA,WAAc,OAAA;EAClB,GAAA,CAAI,GAAA,WAAc,OAAA;EAhBmD;;;;EAqBrE,MAAA,CAAO,GAAA,UAAa,MAAA,WAAiB,OAAA;EArBoB;EAuBzD,SAAA,yBAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,OAAA;AAAA;;UAI/C,aAAA,SAAsB,OAAA;EAvBtB;;;;EA4Bf,IAAA,CAAK,GAAA,UAAa,EAAA,WAAa,IAAA;IAAS,MAAA;EAAA,IAAoB,OAAA;EA5BZ;;;;EAiChD,KAAA,WAAgB,OAAA,EAAS,GAAA,UAAa,KAAA,EAAO,CAAA,EAAG,IAAA,GAAO,UAAA,GAAa,OAAA;EACpE,SAAA,yBAAkC,MAAA,EAAQ,cAAA,CAAe,CAAA,IAAK,aAAA;AAAA;AAAA,KAGpD,UAAA;EACV,MAAA;AAAA"}

package/package.json

@@ -1,10 +1,55 @@
 {
   "name": "@zeltjs/kv",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @zeltjs/kv",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+  "version": "0.6.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeltjs/zelt.git",
+    "directory": "packages/kv"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adaptor-memory": {
+      "types": "./dist/adaptor-memory/index.d.ts",
+      "import": "./dist/adaptor-memory/index.js"
+    },
+    "./adaptor-redis": {
+      "types": "./dist/adaptor-redis/index.d.ts",
+      "import": "./dist/adaptor-redis/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "vitest": ">=4 <5",
+    "@zeltjs/redis": "0.6.0",
+    "@zeltjs/core": "0.6.0"
+  },
+  "peerDependenciesMeta": {
+    "@zeltjs/redis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "22.19.17",
+    "ioredis": "5.10.1",
+    "@zeltjs/core": "0.6.0",
+    "@zeltjs/redis": "0.6.0"
+  },
+  "volta": {
+    "extends": "../../package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -b"
+  }
+}