layercache 1.0.0 → 1.0.2

package/dist/cli.cjs

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cli.ts
+var cli_exports = {};
+__export(cli_exports, {
+  main: () => main
+});
+module.exports = __toCommonJS(cli_exports);
+var import_ioredis = __toESM(require("ioredis"), 1);
+
+// src/invalidation/PatternMatcher.ts
+var PatternMatcher = class {
+  static matches(pattern, value) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`^${escaped.replace(/\*/g, ".*").replace(/\?/g, ".")}$`);
+    return regex.test(value);
+  }
+};
+
+// src/invalidation/RedisTagIndex.ts
+var RedisTagIndex = class {
+  client;
+  prefix;
+  scanCount;
+  constructor(options) {
+    this.client = options.client;
+    this.prefix = options.prefix ?? "layercache:tag-index";
+    this.scanCount = options.scanCount ?? 100;
+  }
+  async touch(key) {
+    await this.client.sadd(this.knownKeysKey(), key);
+  }
+  async track(key, tags) {
+    const keyTagsKey = this.keyTagsKey(key);
+    const existingTags = await this.client.smembers(keyTagsKey);
+    const pipeline = this.client.pipeline();
+    pipeline.sadd(this.knownKeysKey(), key);
+    for (const tag of existingTags) {
+      pipeline.srem(this.tagKeysKey(tag), key);
+    }
+    pipeline.del(keyTagsKey);
+    if (tags.length > 0) {
+      pipeline.sadd(keyTagsKey, ...tags);
+      for (const tag of new Set(tags)) {
+        pipeline.sadd(this.tagKeysKey(tag), key);
+      }
+    }
+    await pipeline.exec();
+  }
+  async remove(key) {
+    const keyTagsKey = this.keyTagsKey(key);
+    const existingTags = await this.client.smembers(keyTagsKey);
+    const pipeline = this.client.pipeline();
+    pipeline.srem(this.knownKeysKey(), key);
+    pipeline.del(keyTagsKey);
+    for (const tag of existingTags) {
+      pipeline.srem(this.tagKeysKey(tag), key);
+    }
+    await pipeline.exec();
+  }
+  async keysForTag(tag) {
+    return this.client.smembers(this.tagKeysKey(tag));
+  }
+  async matchPattern(pattern) {
+    const matches = [];
+    let cursor = "0";
+    do {
+      const [nextCursor, keys] = await this.client.sscan(
+        this.knownKeysKey(),
+        cursor,
+        "MATCH",
+        pattern,
+        "COUNT",
+        this.scanCount
+      );
+      cursor = nextCursor;
+      matches.push(...keys.filter((key) => PatternMatcher.matches(pattern, key)));
+    } while (cursor !== "0");
+    return matches;
+  }
+  async clear() {
+    const indexKeys = await this.scanIndexKeys();
+    if (indexKeys.length === 0) {
+      return;
+    }
+    await this.client.del(...indexKeys);
+  }
+  async scanIndexKeys() {
+    const matches = [];
+    let cursor = "0";
+    const pattern = `${this.prefix}:*`;
+    do {
+      const [nextCursor, keys] = await this.client.scan(cursor, "MATCH", pattern, "COUNT", this.scanCount);
+      cursor = nextCursor;
+      matches.push(...keys);
+    } while (cursor !== "0");
+    return matches;
+  }
+  knownKeysKey() {
+    return `${this.prefix}:keys`;
+  }
+  keyTagsKey(key) {
+    return `${this.prefix}:key:${encodeURIComponent(key)}`;
+  }
+  tagKeysKey(tag) {
+    return `${this.prefix}:tag:${encodeURIComponent(tag)}`;
+  }
+};
+
+// src/cli.ts
+async function main(argv = process.argv.slice(2)) {
+  const args = parseArgs(argv);
+  if (!args.command || !args.redisUrl) {
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+  const redis = new import_ioredis.default(args.redisUrl);
+  try {
+    if (args.command === "stats") {
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      process.stdout.write(`${JSON.stringify({ totalKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+`);
+      return;
+    }
+    if (args.command === "keys") {
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      process.stdout.write(`${keys.join("\n")}
+`);
+      return;
+    }
+    if (args.command === "invalidate") {
+      if (args.tag) {
+        const tagIndex = new RedisTagIndex({ client: redis, prefix: args.tagIndexPrefix ?? "layercache:tag-index" });
+        const keys2 = await tagIndex.keysForTag(args.tag);
+        if (keys2.length > 0) {
+          await redis.del(...keys2);
+        }
+        process.stdout.write(`${JSON.stringify({ deletedKeys: keys2.length, tag: args.tag }, null, 2)}
+`);
+        return;
+      }
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      if (keys.length > 0) {
+        await redis.del(...keys);
+      }
+      process.stdout.write(`${JSON.stringify({ deletedKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+`);
+      return;
+    }
+    printUsage();
+    process.exitCode = 1;
+  } finally {
+    redis.disconnect();
+  }
+}
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+  const parsed = { command };
+  for (let index = 0; index < rest.length; index += 1) {
+    const token = rest[index];
+    const value = rest[index + 1];
+    if (token === "--redis") {
+      parsed.redisUrl = value;
+      index += 1;
+    } else if (token === "--pattern") {
+      parsed.pattern = value;
+      index += 1;
+    } else if (token === "--tag") {
+      parsed.tag = value;
+      index += 1;
+    } else if (token === "--tag-index-prefix") {
+      parsed.tagIndexPrefix = value;
+      index += 1;
+    }
+  }
+  return parsed;
+}
+async function scanKeys(redis, pattern) {
+  const keys = [];
+  let cursor = "0";
+  do {
+    const [nextCursor, batch] = await redis.scan(cursor, "MATCH", pattern, "COUNT", 100);
+    cursor = nextCursor;
+    keys.push(...batch);
+  } while (cursor !== "0");
+  return keys;
+}
+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"
+  );
+}
+if (process.argv[1]?.includes("cli.")) {
+  void main();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  main
+});

package/dist/cli.d.cts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(argv?: string[]): Promise<void>;
+
+export { main };

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+declare function main(argv?: string[]): Promise<void>;
+
+export { main };

package/dist/cli.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import {
+  RedisTagIndex
+} from "./chunk-IILH5XTS.js";
+
+// src/cli.ts
+import Redis from "ioredis";
+async function main(argv = process.argv.slice(2)) {
+  const args = parseArgs(argv);
+  if (!args.command || !args.redisUrl) {
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+  const redis = new Redis(args.redisUrl);
+  try {
+    if (args.command === "stats") {
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      process.stdout.write(`${JSON.stringify({ totalKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+`);
+      return;
+    }
+    if (args.command === "keys") {
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      process.stdout.write(`${keys.join("\n")}
+`);
+      return;
+    }
+    if (args.command === "invalidate") {
+      if (args.tag) {
+        const tagIndex = new RedisTagIndex({ client: redis, prefix: args.tagIndexPrefix ?? "layercache:tag-index" });
+        const keys2 = await tagIndex.keysForTag(args.tag);
+        if (keys2.length > 0) {
+          await redis.del(...keys2);
+        }
+        process.stdout.write(`${JSON.stringify({ deletedKeys: keys2.length, tag: args.tag }, null, 2)}
+`);
+        return;
+      }
+      const keys = await scanKeys(redis, args.pattern ?? "*");
+      if (keys.length > 0) {
+        await redis.del(...keys);
+      }
+      process.stdout.write(`${JSON.stringify({ deletedKeys: keys.length, pattern: args.pattern ?? "*" }, null, 2)}
+`);
+      return;
+    }
+    printUsage();
+    process.exitCode = 1;
+  } finally {
+    redis.disconnect();
+  }
+}
+function parseArgs(argv) {
+  const [command, ...rest] = argv;
+  const parsed = { command };
+  for (let index = 0; index < rest.length; index += 1) {
+    const token = rest[index];
+    const value = rest[index + 1];
+    if (token === "--redis") {
+      parsed.redisUrl = value;
+      index += 1;
+    } else if (token === "--pattern") {
+      parsed.pattern = value;
+      index += 1;
+    } else if (token === "--tag") {
+      parsed.tag = value;
+      index += 1;
+    } else if (token === "--tag-index-prefix") {
+      parsed.tagIndexPrefix = value;
+      index += 1;
+    }
+  }
+  return parsed;
+}
+async function scanKeys(redis, pattern) {
+  const keys = [];
+  let cursor = "0";
+  do {
+    const [nextCursor, batch] = await redis.scan(cursor, "MATCH", pattern, "COUNT", 100);
+    cursor = nextCursor;
+    keys.push(...batch);
+  } while (cursor !== "0");
+  return keys;
+}
+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"
+  );
+}
+if (process.argv[1]?.includes("cli.")) {
+  void main();
+}
+export {
+  main
+};