@nestjs-redisx/testing 1.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NestJS RedisX Contributors
+
+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

@@ -0,0 +1,76 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/nestjs-redisx/nestjs-redisx/main/website/public/images/logo.png" alt="NestJS RedisX" />
+</p>
+
+# @nestjs-redisx/testing
+
+[![npm](https://img.shields.io/npm/v/@nestjs-redisx/testing)](https://www.npmjs.com/package/@nestjs-redisx/testing)
+[![npm downloads](https://img.shields.io/npm/dm/@nestjs-redisx/testing)](https://www.npmjs.com/package/@nestjs-redisx/testing)
+[![license](https://img.shields.io/npm/l/@nestjs-redisx/testing)](https://opensource.org/licenses/MIT)
+
+Testing utilities for NestJS RedisX: an **in-memory Redis driver** that runs the real cache, locks, rate-limit, and idempotency plugins — including their Lua scripts — with no Redis required. Fast, deterministic, isolated unit tests.
+
+## Installation
+
+```bash
+npm install -D @nestjs-redisx/testing
+```
+
+## Quick Example
+
+```typescript
+import { Test } from '@nestjs/testing';
+import { RedisTestingModule } from '@nestjs-redisx/testing';
+import { CachePlugin, CACHE_SERVICE, ICacheService } from '@nestjs-redisx/cache';
+
+const app = await Test.createTestingModule({
+  imports: [RedisTestingModule.forRoot({ plugins: [new CachePlugin()] })],
+}).compile();
+await app.init();
+
+const cache = app.get<ICacheService>(CACHE_SERVICE);
+
+let calls = 0;
+const loader = async () => (calls++, { id: 1 });
+await cache.getOrSet('user:1', loader, { ttl: 60 });
+await cache.getOrSet('user:1', loader, { ttl: 60 });
+// calls === 1 — real cache code, no Redis
+```
+
+Prefer to configure `RedisModule` directly? Import the package (to register the
+driver) and set `global.driver`:
+
+```typescript
+import '@nestjs-redisx/testing';
+import { RedisModule } from '@nestjs-redisx/core';
+
+RedisModule.forRoot({
+  clients: { type: 'single', host: 'localhost', port: 6379 }, // ignored
+  global: { driver: 'memory' },
+  plugins: [/* ... */],
+});
+```
+
+## Scope
+
+Supports the data structures and scripting used by the cache, locks, rate-limit,
+idempotency, and streams plugins: strings, hashes, sets, sorted sets, lists,
+streams (with consumer groups, PEL, `XACK`/`XCLAIM`/`XPENDING`), keys/TTL, and a
+bounded Lua interpreter. Single-node semantics only — no cluster cross-slot or
+Pub/Sub, and blocking reads return promptly rather than waiting.
+
+## Documentation
+
+Full documentation: [nestjs-redisx.dev/en/reference/testing/](https://nestjs-redisx.dev/en/reference/testing/)
+
+## Using with AI Assistants
+
+For better code generation with AI tools (Cursor, Claude Code, GitHub Copilot, etc.), point your agent to the full API reference:
+
+```
+https://nestjs-redisx.dev/llms-full.txt
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { RedisTestingModule, type RedisTestingModuleOptions, type RedisTestingModuleAsyncOptions } from './memory/api/redis-testing.module';
+export { registerMemoryDriver } from './memory/api/register-memory-driver';
+export { MemoryRedisAdapter } from './memory/infrastructure/adapters/memory-redis.adapter';
+export { MemoryStore } from './memory/domain/store/memory-store';
+export { LuaInterpreter } from './memory/domain/lua/lua-interpreter';
+export { CommandExecutor } from './memory/application/services/command-executor.service';
+export { MEMORY_DRIVER_TYPE } from './shared/constants';
+export { MemoryDriverError, LuaExecutionError, WrongTypeError } from './shared/errors';
+export type { IMemoryDriverOptions } from './shared/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,KAAK,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAC5I,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAG3F,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,wDAAwD,CAAC;AAGzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}