layercache 1.2.0 → 1.2.2

package/dist/cli.js

@@ -1,7 +1,11 @@
 #!/usr/bin/env node
 import {
   RedisTagIndex
-} from "./chunk-BWM4MU2X.js";
+} from "./chunk-IXCMHVHP.js";
+import {
+  isStoredValueEnvelope,
+  resolveStoredValue
+} from "./chunk-ZMDB5KOK.js";
 
 // src/cli.ts
 import Redis from "ioredis";
@@ -65,6 +69,31 @@ async function main(argv = process.argv.slice(2)) {
 `);
       return;
     }
+    if (args.command === "inspect") {
+      if (!args.key) {
+        throw new Error("inspect requires --key <key>.");
+      }
+      const payload = await redis.getBuffer(args.key);
+      const ttl = await redis.ttl(args.key);
+      const decoded = decodeInspectablePayload(payload);
+      process.stdout.write(
+        `${JSON.stringify(
+          {
+            key: args.key,
+            exists: payload !== null,
+            ttlSeconds: ttl >= 0 ? ttl : null,
+            sizeBytes: payload?.byteLength ?? 0,
+            isEnvelope: isStoredValueEnvelope(decoded),
+            state: payload === null ? null : resolveStoredValue(decoded).state,
+            preview: summarizeInspectableValue(decoded)
+          },
+          null,
+          2
+        )}
+`
+      );
+      return;
+    }
     printUsage();
     process.exitCode = 1;
   } catch (error) {
@@ -105,6 +134,9 @@ function parseArgs(argv) {
     } else if (token === "--tag") {
       parsed.tag = value;
       index += 1;
+    } else if (token === "--key") {
+      parsed.key = value;
+      index += 1;
     } else if (token === "--tag-index-prefix") {
       parsed.tagIndexPrefix = value;
       index += 1;
@@ -131,9 +163,32 @@ async function scanKeys(redis, pattern) {
 }
 function printUsage() {
   process.stdout.write(
-    "Usage:\n  layercache stats --redis <url> [--pattern <glob>]\n  layercache keys --redis <url> [--pattern <glob>]\n  layercache invalidate --redis <url> [--pattern <glob> | --tag <tag>] [--tag-index-prefix <prefix>]\n\nOptions:\n  --redis <url>               Redis connection URL (e.g. redis://localhost:6379)\n  --pattern <glob>            Glob pattern to filter keys (default: *)\n  --tag <tag>                 Invalidate by tag name\n  --tag-index-prefix <prefix> Redis key prefix for tag index (default: layercache:tag-index)\n"
+    "Usage:\n  layercache stats --redis <url> [--pattern <glob>]\n  layercache keys --redis <url> [--pattern <glob>]\n  layercache inspect --redis <url> --key <key>\n  layercache invalidate --redis <url> [--pattern <glob> | --tag <tag>] [--tag-index-prefix <prefix>]\n\nOptions:\n  --redis <url>               Redis connection URL (e.g. redis://localhost:6379)\n  --pattern <glob>            Glob pattern to filter keys (default: *)\n  --key <key>                 Exact cache key to inspect\n  --tag <tag>                 Invalidate by tag name\n  --tag-index-prefix <prefix> Redis key prefix for tag index (default: layercache:tag-index)\n"
   );
 }
+function decodeInspectablePayload(payload) {
+  if (payload === null) {
+    return null;
+  }
+  const text = payload.toString("utf8");
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text.length > 256 ? `${text.slice(0, 256)}...` : text;
+  }
+}
+function summarizeInspectableValue(value) {
+  if (isStoredValueEnvelope(value)) {
+    return {
+      kind: value.kind,
+      value: value.value,
+      freshUntil: value.freshUntil,
+      staleUntil: value.staleUntil,
+      errorUntil: value.errorUntil
+    };
+  }
+  return value;
+}
 if (process.argv[1]?.includes("cli.")) {
   void main();
 }