resplite 1.2.14 → 1.2.16

package/README.md

@@ -63,14 +63,14 @@ const srv = await createRESPlite({
   port: 6380,
   db: './data.db',
   hooks: {
-    onUnknownCommand({ command, argsCount, clientAddress }) {
-      log.warn({ command, argsCount, clientAddress }, 'unsupported command');
+    onUnknownCommand({ command, argv, clientAddress }) {
+      log.warn({ command, argv, clientAddress }, 'unsupported command');
     },
-    onCommandError({ command, error, clientAddress }) {
-      log.warn({ command, error, clientAddress }, 'command error');
+    onCommandError({ command, argv, error, clientAddress }) {
+      log.warn({ command, argv, error, clientAddress }, 'command error');
     },
     onSocketError({ error, clientAddress }) {
-      log.error({ err: error, clientAddress }, 'connection error');
+      log.error({ error, clientAddress }, 'connection error');
     },
   },
 });
@@ -78,8 +78,8 @@ const srv = await createRESPlite({
 
 Available hooks:
 
-- `onUnknownCommand`: client sent a command not implemented by RESPLite, such as `SUBSCRIBE` or `PUBLISH`.
-- `onCommandError`: a command failed because of wrong type, invalid args, or a handler error.
+- `onUnknownCommand`: client sent a command not implemented by RESPLite, such as `SUBSCRIBE` or `PUBLISH`. Payload includes `argv` (full command line as strings, e.g. `['CLIENT','LIST']`) so you can log exactly what was sent.
+- `onCommandError`: a command failed because of wrong type, invalid args, or a handler error. Payload includes `argv` for the full command line.
 - `onSocketError`: the connection socket emitted an error, for example `ECONNRESET`.
 
 If you want a tiny in-process smoke test that starts RESPLite and connects with the `redis` client in the same script, see [Minimal embedded example](#minimal-embedded-example) below.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resplite",
-  "version": "1.2.14",
+  "version": "1.2.16",
   "description": "A RESP2 server with practical Redis compatibility, backed by SQLite",
   "type": "module",
   "main": "src/index.js",

package/src/commands/registry.js

@@ -158,11 +158,13 @@ export function dispatch(engine, argv, context) {
   }
   const cmd = (Buffer.isBuffer(argv[0]) ? argv[0].toString('utf8') : String(argv[0])).toUpperCase();
   const args = argv.slice(1);
+  const argvStrings = argv.map((b) => (Buffer.isBuffer(b) ? b.toString('utf8') : String(b)));
   const handler = HANDLERS.get(cmd);
   if (!handler) {
     context?.onUnknownCommand?.({
       command: cmd,
       argsCount: args.length,
+      argv: argvStrings ?? [cmd],
       clientAddress: context.clientAddress ?? '',
       connectionId: context.connectionId ?? 0,
     });
@@ -175,6 +177,7 @@ export function dispatch(engine, argv, context) {
       context?.onCommandError?.({
         command: cmd,
         error: result.error,
+        argv: argvStrings ?? [cmd],
         clientAddress: context.clientAddress ?? '',
         connectionId: context.connectionId ?? 0,
       });
@@ -188,6 +191,7 @@ export function dispatch(engine, argv, context) {
     context?.onCommandError?.({
       command: cmd,
       error: errorMsg,
+      argv: argvStrings ?? [cmd],
       clientAddress: context.clientAddress ?? '',
       connectionId: context.connectionId ?? 0,
     });

package/src/embed.js

@@ -21,8 +21,8 @@ export { handleConnection, createEngine, openDb };
  * All hooks are optional. Called with plain objects; do not mutate.
  *
  * @typedef {object} RESPliteHooks
- * @property {(payload: { command: string, argsCount: number, clientAddress: string, connectionId: number }) => void} [onUnknownCommand] Invoked when the client sends a command not implemented by RESPLite.
- * @property {(payload: { command: string, error: string, clientAddress: string, connectionId: number }) => void} [onCommandError] Invoked when a command handler throws or returns an error (e.g. WRONGTYPE, invalid args).
+ * @property {(payload: { command: string, argsCount: number, argv: string[], clientAddress: string, connectionId: number }) => void} [onUnknownCommand] Invoked when the client sends a command not implemented by RESPLite. `argv` is the full command line as strings (e.g. `['CLIENT','LIST']`) for logging.
+ * @property {(payload: { command: string, error: string, argv: string[], clientAddress: string, connectionId: number }) => void} [onCommandError] Invoked when a command handler throws or returns an error (e.g. WRONGTYPE, invalid args). `argv` is the full command line as strings for logging.
  * @property {(payload: { error: Error, clientAddress: string, connectionId: number }) => void} [onSocketError] Invoked when a connection socket emits an error (e.g. ECONNRESET).
  */