rust-node-cache 0.1.0

package/binding.js

@@ -0,0 +1,315 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'rust-node-cache.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.android-arm64.node')
+          } else {
+            nativeBinding = require('rust-node-cache-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'rust-node-cache.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('rust-node-cache-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rust-node-cache.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('rust-node-cache-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'rust-node-cache.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('rust-node-cache-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rust-node-cache.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('rust-node-cache-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'rust-node-cache.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rust-node-cache.darwin-universal.node')
+      } else {
+        nativeBinding = require('rust-node-cache-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'rust-node-cache.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.darwin-x64.node')
+          } else {
+            nativeBinding = require('rust-node-cache-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'rust-node-cache.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.darwin-arm64.node')
+          } else {
+            nativeBinding = require('rust-node-cache-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'rust-node-cache.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./rust-node-cache.freebsd-x64.node')
+      } else {
+        nativeBinding = require('rust-node-cache-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'rust-node-cache.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./rust-node-cache.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('rust-node-cache-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'rust-node-cache.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./rust-node-cache.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('rust-node-cache-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { Cache } = nativeBinding
+
+module.exports.Cache = Cache

package/dist/express.d.mts

@@ -0,0 +1,34 @@
+import { Request, Response, NextFunction } from 'express';
+import { Cache } from './index.mjs';
+
+/**
+ * Integração com Express: cache de respostas JSON.
+ *
+ * Uso:
+ *   import { Cache } from "rust-node-cache";
+ *   import { cacheMiddleware } from "rust-node-cache/express";
+ *
+ *   const cache = new Cache();
+ *   app.get("/users/:id", cacheMiddleware({ cache, ttlSeconds: 60 }), handler);
+ *
+ * O middleware intercepta `res.json`: num HIT responde direto do cache; num
+ * MISS deixa o handler rodar e guarda o corpo da resposta (apenas em 2xx).
+ */
+
+interface CacheMiddlewareOptions {
+    /** Instância de cache a usar. */
+    cache: Cache;
+    /** TTL aplicado às respostas guardadas (em segundos). */
+    ttlSeconds?: number;
+    /** Métodos HTTP elegíveis para cache. Padrão: `["GET"]`. */
+    methods?: string[];
+    /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */
+    keyGenerator?: (req: Request) => string;
+}
+/**
+ * Cria um middleware Express que cacheia respostas JSON. Adiciona o cabeçalho
+ * `X-Cache: HIT|MISS` para facilitar a observabilidade.
+ */
+declare function cacheMiddleware(options: CacheMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+export { type CacheMiddlewareOptions, cacheMiddleware };

package/dist/express.d.ts

@@ -0,0 +1,34 @@
+import { Request, Response, NextFunction } from 'express';
+import { Cache } from './index.js';
+
+/**
+ * Integração com Express: cache de respostas JSON.
+ *
+ * Uso:
+ *   import { Cache } from "rust-node-cache";
+ *   import { cacheMiddleware } from "rust-node-cache/express";
+ *
+ *   const cache = new Cache();
+ *   app.get("/users/:id", cacheMiddleware({ cache, ttlSeconds: 60 }), handler);
+ *
+ * O middleware intercepta `res.json`: num HIT responde direto do cache; num
+ * MISS deixa o handler rodar e guarda o corpo da resposta (apenas em 2xx).
+ */
+
+interface CacheMiddlewareOptions {
+    /** Instância de cache a usar. */
+    cache: Cache;
+    /** TTL aplicado às respostas guardadas (em segundos). */
+    ttlSeconds?: number;
+    /** Métodos HTTP elegíveis para cache. Padrão: `["GET"]`. */
+    methods?: string[];
+    /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */
+    keyGenerator?: (req: Request) => string;
+}
+/**
+ * Cria um middleware Express que cacheia respostas JSON. Adiciona o cabeçalho
+ * `X-Cache: HIT|MISS` para facilitar a observabilidade.
+ */
+declare function cacheMiddleware(options: CacheMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+
+export { type CacheMiddlewareOptions, cacheMiddleware };

package/dist/express.js

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// js/express.ts
+var express_exports = {};
+__export(express_exports, {
+  cacheMiddleware: () => cacheMiddleware
+});
+module.exports = __toCommonJS(express_exports);
+function cacheMiddleware(options) {
+  const { cache } = options;
+  const ttlSeconds = options.ttlSeconds;
+  const methods = options.methods ?? ["GET"];
+  const keyGenerator = options.keyGenerator ?? ((req) => `${req.method}:${req.originalUrl}`);
+  return function rustNodeCache(req, res, next) {
+    if (!methods.includes(req.method)) {
+      next();
+      return;
+    }
+    const key = keyGenerator(req);
+    const cached = cache.get(key);
+    if (cached !== null) {
+      res.setHeader("X-Cache", "HIT");
+      res.json(cached);
+      return;
+    }
+    res.setHeader("X-Cache", "MISS");
+    const originalJson = res.json.bind(res);
+    res.json = (body) => {
+      if (res.statusCode >= 200 && res.statusCode < 300) {
+        cache.set(key, body, ttlSeconds ? { ttlSeconds } : void 0);
+      }
+      return originalJson(body);
+    };
+    next();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cacheMiddleware
+});
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../js/express.ts"],"sourcesContent":["/**\n * Integração com Express: cache de respostas JSON.\n *\n * Uso:\n *   import { Cache } from \"rust-node-cache\";\n *   import { cacheMiddleware } from \"rust-node-cache/express\";\n *\n *   const cache = new Cache();\n *   app.get(\"/users/:id\", cacheMiddleware({ cache, ttlSeconds: 60 }), handler);\n *\n * O middleware intercepta `res.json`: num HIT responde direto do cache; num\n * MISS deixa o handler rodar e guarda o corpo da resposta (apenas em 2xx).\n */\n\nimport type { Request, Response, NextFunction } from \"express\";\nimport type { Cache } from \"./index\";\n\nexport interface CacheMiddlewareOptions {\n  /** Instância de cache a usar. */\n  cache: Cache;\n  /** TTL aplicado às respostas guardadas (em segundos). */\n  ttlSeconds?: number;\n  /** Métodos HTTP elegíveis para cache. Padrão: `[\"GET\"]`. */\n  methods?: string[];\n  /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */\n  keyGenerator?: (req: Request) => string;\n}\n\n/**\n * Cria um middleware Express que cacheia respostas JSON. Adiciona o cabeçalho\n * `X-Cache: HIT|MISS` para facilitar a observabilidade.\n */\nexport function cacheMiddleware(options: CacheMiddlewareOptions) {\n  const { cache } = options;\n  const ttlSeconds = options.ttlSeconds;\n  const methods = options.methods ?? [\"GET\"];\n  const keyGenerator =\n    options.keyGenerator ?? ((req: Request) => `${req.method}:${req.originalUrl}`);\n\n  return function rustNodeCache(\n    req: Request,\n    res: Response,\n    next: NextFunction,\n  ): void {\n    if (!methods.includes(req.method)) {\n      next();\n      return;\n    }\n\n    const key = keyGenerator(req);\n    const cached = cache.get(key);\n    if (cached !== null) {\n      res.setHeader(\"X-Cache\", \"HIT\");\n      res.json(cached);\n      return;\n    }\n\n    res.setHeader(\"X-Cache\", \"MISS\");\n    const originalJson = res.json.bind(res);\n    res.json = (body: unknown): Response => {\n      // Só guardamos respostas bem-sucedidas (2xx).\n      if (res.statusCode >= 200 && res.statusCode < 300) {\n        cache.set(key, body, ttlSeconds ? { ttlSeconds } : undefined);\n      }\n      return originalJson(body);\n    };\n\n    next();\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCO,SAAS,gBAAgB,SAAiC;AAC/D,QAAM,EAAE,MAAM,IAAI;AAClB,QAAM,aAAa,QAAQ;AAC3B,QAAM,UAAU,QAAQ,WAAW,CAAC,KAAK;AACzC,QAAM,eACJ,QAAQ,iBAAiB,CAAC,QAAiB,GAAG,IAAI,MAAM,IAAI,IAAI,WAAW;AAE7E,SAAO,SAAS,cACd,KACA,KACA,MACM;AACN,QAAI,CAAC,QAAQ,SAAS,IAAI,MAAM,GAAG;AACjC,WAAK;AACL;AAAA,IACF;AAEA,UAAM,MAAM,aAAa,GAAG;AAC5B,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,WAAW,MAAM;AACnB,UAAI,UAAU,WAAW,KAAK;AAC9B,UAAI,KAAK,MAAM;AACf;AAAA,IACF;AAEA,QAAI,UAAU,WAAW,MAAM;AAC/B,UAAM,eAAe,IAAI,KAAK,KAAK,GAAG;AACtC,QAAI,OAAO,CAAC,SAA4B;AAEtC,UAAI,IAAI,cAAc,OAAO,IAAI,aAAa,KAAK;AACjD,cAAM,IAAI,KAAK,MAAM,aAAa,EAAE,WAAW,IAAI,MAAS;AAAA,MAC9D;AACA,aAAO,aAAa,IAAI;AAAA,IAC1B;AAEA,SAAK;AAAA,EACP;AACF;","names":[]}

package/dist/express.mjs

@@ -0,0 +1,33 @@
+// js/express.ts
+function cacheMiddleware(options) {
+  const { cache } = options;
+  const ttlSeconds = options.ttlSeconds;
+  const methods = options.methods ?? ["GET"];
+  const keyGenerator = options.keyGenerator ?? ((req) => `${req.method}:${req.originalUrl}`);
+  return function rustNodeCache(req, res, next) {
+    if (!methods.includes(req.method)) {
+      next();
+      return;
+    }
+    const key = keyGenerator(req);
+    const cached = cache.get(key);
+    if (cached !== null) {
+      res.setHeader("X-Cache", "HIT");
+      res.json(cached);
+      return;
+    }
+    res.setHeader("X-Cache", "MISS");
+    const originalJson = res.json.bind(res);
+    res.json = (body) => {
+      if (res.statusCode >= 200 && res.statusCode < 300) {
+        cache.set(key, body, ttlSeconds ? { ttlSeconds } : void 0);
+      }
+      return originalJson(body);
+    };
+    next();
+  };
+}
+export {
+  cacheMiddleware
+};
+//# sourceMappingURL=express.mjs.map

package/dist/express.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../js/express.ts"],"sourcesContent":["/**\n * Integração com Express: cache de respostas JSON.\n *\n * Uso:\n *   import { Cache } from \"rust-node-cache\";\n *   import { cacheMiddleware } from \"rust-node-cache/express\";\n *\n *   const cache = new Cache();\n *   app.get(\"/users/:id\", cacheMiddleware({ cache, ttlSeconds: 60 }), handler);\n *\n * O middleware intercepta `res.json`: num HIT responde direto do cache; num\n * MISS deixa o handler rodar e guarda o corpo da resposta (apenas em 2xx).\n */\n\nimport type { Request, Response, NextFunction } from \"express\";\nimport type { Cache } from \"./index\";\n\nexport interface CacheMiddlewareOptions {\n  /** Instância de cache a usar. */\n  cache: Cache;\n  /** TTL aplicado às respostas guardadas (em segundos). */\n  ttlSeconds?: number;\n  /** Métodos HTTP elegíveis para cache. Padrão: `[\"GET\"]`. */\n  methods?: string[];\n  /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */\n  keyGenerator?: (req: Request) => string;\n}\n\n/**\n * Cria um middleware Express que cacheia respostas JSON. Adiciona o cabeçalho\n * `X-Cache: HIT|MISS` para facilitar a observabilidade.\n */\nexport function cacheMiddleware(options: CacheMiddlewareOptions) {\n  const { cache } = options;\n  const ttlSeconds = options.ttlSeconds;\n  const methods = options.methods ?? [\"GET\"];\n  const keyGenerator =\n    options.keyGenerator ?? ((req: Request) => `${req.method}:${req.originalUrl}`);\n\n  return function rustNodeCache(\n    req: Request,\n    res: Response,\n    next: NextFunction,\n  ): void {\n    if (!methods.includes(req.method)) {\n      next();\n      return;\n    }\n\n    const key = keyGenerator(req);\n    const cached = cache.get(key);\n    if (cached !== null) {\n      res.setHeader(\"X-Cache\", \"HIT\");\n      res.json(cached);\n      return;\n    }\n\n    res.setHeader(\"X-Cache\", \"MISS\");\n    const originalJson = res.json.bind(res);\n    res.json = (body: unknown): Response => {\n      // Só guardamos respostas bem-sucedidas (2xx).\n      if (res.statusCode >= 200 && res.statusCode < 300) {\n        cache.set(key, body, ttlSeconds ? { ttlSeconds } : undefined);\n      }\n      return originalJson(body);\n    };\n\n    next();\n  };\n}\n"],"mappings":";AAgCO,SAAS,gBAAgB,SAAiC;AAC/D,QAAM,EAAE,MAAM,IAAI;AAClB,QAAM,aAAa,QAAQ;AAC3B,QAAM,UAAU,QAAQ,WAAW,CAAC,KAAK;AACzC,QAAM,eACJ,QAAQ,iBAAiB,CAAC,QAAiB,GAAG,IAAI,MAAM,IAAI,IAAI,WAAW;AAE7E,SAAO,SAAS,cACd,KACA,KACA,MACM;AACN,QAAI,CAAC,QAAQ,SAAS,IAAI,MAAM,GAAG;AACjC,WAAK;AACL;AAAA,IACF;AAEA,UAAM,MAAM,aAAa,GAAG;AAC5B,UAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,QAAI,WAAW,MAAM;AACnB,UAAI,UAAU,WAAW,KAAK;AAC9B,UAAI,KAAK,MAAM;AACf;AAAA,IACF;AAEA,QAAI,UAAU,WAAW,MAAM;AAC/B,UAAM,eAAe,IAAI,KAAK,KAAK,GAAG;AACtC,QAAI,OAAO,CAAC,SAA4B;AAEtC,UAAI,IAAI,cAAc,OAAO,IAAI,aAAa,KAAK;AACjD,cAAM,IAAI,KAAK,MAAM,aAAa,EAAE,WAAW,IAAI,MAAS;AAAA,MAC9D;AACA,aAAO,aAAa,IAAI;AAAA,IAC1B;AAEA,SAAK;AAAA,EACP;AACF;","names":[]}

package/dist/fastify.d.mts

@@ -0,0 +1,33 @@
+import { FastifyRequest, FastifyInstance } from 'fastify';
+import { Cache } from './index.mjs';
+
+/**
+ * Integração com Fastify: cache de respostas JSON via plugin.
+ *
+ * Uso:
+ *   import { Cache } from "rust-node-cache";
+ *   import { cachePlugin } from "rust-node-cache/fastify";
+ *
+ *   const cache = new Cache();
+ *   fastify.register(cachePlugin, { cache, ttlSeconds: 60 });
+ *
+ * Fluxo: o hook `onRequest` checa o cache e, num HIT, responde imediatamente
+ * (curto-circuito). Num MISS, o hook `onSend` guarda o payload serializado.
+ */
+
+interface CachePluginOptions {
+    /** Instância de cache a usar. */
+    cache: Cache;
+    /** TTL aplicado às respostas guardadas (em segundos). */
+    ttlSeconds?: number;
+    /** Métodos HTTP elegíveis para cache. Padrão: `["GET"]`. */
+    methods?: string[];
+    /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */
+    keyGenerator?: (req: FastifyRequest) => string;
+}
+/**
+ * Plugin Fastify que cacheia respostas JSON. Use com `fastify.register`.
+ */
+declare function cachePlugin(fastify: FastifyInstance, options: CachePluginOptions): Promise<void>;
+
+export { type CachePluginOptions, cachePlugin };

package/dist/fastify.d.ts

@@ -0,0 +1,33 @@
+import { FastifyRequest, FastifyInstance } from 'fastify';
+import { Cache } from './index.js';
+
+/**
+ * Integração com Fastify: cache de respostas JSON via plugin.
+ *
+ * Uso:
+ *   import { Cache } from "rust-node-cache";
+ *   import { cachePlugin } from "rust-node-cache/fastify";
+ *
+ *   const cache = new Cache();
+ *   fastify.register(cachePlugin, { cache, ttlSeconds: 60 });
+ *
+ * Fluxo: o hook `onRequest` checa o cache e, num HIT, responde imediatamente
+ * (curto-circuito). Num MISS, o hook `onSend` guarda o payload serializado.
+ */
+
+interface CachePluginOptions {
+    /** Instância de cache a usar. */
+    cache: Cache;
+    /** TTL aplicado às respostas guardadas (em segundos). */
+    ttlSeconds?: number;
+    /** Métodos HTTP elegíveis para cache. Padrão: `["GET"]`. */
+    methods?: string[];
+    /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */
+    keyGenerator?: (req: FastifyRequest) => string;
+}
+/**
+ * Plugin Fastify que cacheia respostas JSON. Use com `fastify.register`.
+ */
+declare function cachePlugin(fastify: FastifyInstance, options: CachePluginOptions): Promise<void>;
+
+export { type CachePluginOptions, cachePlugin };

package/dist/fastify.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// js/fastify.ts
+var fastify_exports = {};
+__export(fastify_exports, {
+  cachePlugin: () => cachePlugin
+});
+module.exports = __toCommonJS(fastify_exports);
+var CACHE_KEY = /* @__PURE__ */ Symbol("rustNodeCacheKey");
+async function cachePlugin(fastify, options) {
+  const { cache } = options;
+  const ttlSeconds = options.ttlSeconds;
+  const methods = options.methods ?? ["GET"];
+  const keyGenerator = options.keyGenerator ?? ((req) => `${req.method}:${req.url}`);
+  fastify.addHook(
+    "onRequest",
+    (request, reply, done) => {
+      if (!methods.includes(request.method)) {
+        done();
+        return;
+      }
+      const key = keyGenerator(request);
+      const cached = cache.get(key);
+      if (cached !== null) {
+        reply.header("X-Cache", "HIT");
+        reply.send(cached);
+        return;
+      }
+      reply.header("X-Cache", "MISS");
+      request[CACHE_KEY] = key;
+      done();
+    }
+  );
+  fastify.addHook(
+    "onSend",
+    (request, reply, payload, done) => {
+      const key = request[CACHE_KEY];
+      if (key && typeof payload === "string" && reply.statusCode >= 200 && reply.statusCode < 300) {
+        try {
+          cache.set(
+            key,
+            JSON.parse(payload),
+            ttlSeconds ? { ttlSeconds } : void 0
+          );
+        } catch {
+        }
+      }
+      done(null, payload);
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cachePlugin
+});
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../js/fastify.ts"],"sourcesContent":["/**\n * Integração com Fastify: cache de respostas JSON via plugin.\n *\n * Uso:\n *   import { Cache } from \"rust-node-cache\";\n *   import { cachePlugin } from \"rust-node-cache/fastify\";\n *\n *   const cache = new Cache();\n *   fastify.register(cachePlugin, { cache, ttlSeconds: 60 });\n *\n * Fluxo: o hook `onRequest` checa o cache e, num HIT, responde imediatamente\n * (curto-circuito). Num MISS, o hook `onSend` guarda o payload serializado.\n */\n\nimport type {\n  FastifyInstance,\n  FastifyReply,\n  FastifyRequest,\n} from \"fastify\";\nimport type { Cache } from \"./index\";\n\nexport interface CachePluginOptions {\n  /** Instância de cache a usar. */\n  cache: Cache;\n  /** TTL aplicado às respostas guardadas (em segundos). */\n  ttlSeconds?: number;\n  /** Métodos HTTP elegíveis para cache. Padrão: `[\"GET\"]`. */\n  methods?: string[];\n  /** Gera a chave de cache a partir da requisição. Padrão: `METHOD:url`. */\n  keyGenerator?: (req: FastifyRequest) => string;\n}\n\n// Guardamos a chave calculada na própria request entre os hooks.\nconst CACHE_KEY = Symbol(\"rustNodeCacheKey\");\n\n/**\n * Plugin Fastify que cacheia respostas JSON. Use com `fastify.register`.\n */\nexport async function cachePlugin(\n  fastify: FastifyInstance,\n  options: CachePluginOptions,\n): Promise<void> {\n  const { cache } = options;\n  const ttlSeconds = options.ttlSeconds;\n  const methods = options.methods ?? [\"GET\"];\n  const keyGenerator =\n    options.keyGenerator ?? ((req: FastifyRequest) => `${req.method}:${req.url}`);\n\n  fastify.addHook(\n    \"onRequest\",\n    (request: FastifyRequest, reply: FastifyReply, done: () => void) => {\n      if (!methods.includes(request.method)) {\n        done();\n        return;\n      }\n\n      const key = keyGenerator(request);\n      const cached = cache.get(key);\n      if (cached !== null) {\n        reply.header(\"X-Cache\", \"HIT\");\n        reply.send(cached);\n        return; // não chama done(): a resposta já foi enviada.\n      }\n\n      reply.header(\"X-Cache\", \"MISS\");\n      (request as unknown as Record<symbol, string>)[CACHE_KEY] = key;\n      done();\n    },\n  );\n\n  fastify.addHook(\n    \"onSend\",\n    (\n      request: FastifyRequest,\n      reply: FastifyReply,\n      payload: unknown,\n      done: (err: Error | null, value?: unknown) => void,\n    ) => {\n      const key = (request as unknown as Record<symbol, string | undefined>)[\n        CACHE_KEY\n      ];\n      if (\n        key &&\n        typeof payload === \"string\" &&\n        reply.statusCode >= 200 &&\n        reply.statusCode < 300\n      ) {\n        try {\n          cache.set(\n            key,\n            JSON.parse(payload),\n            ttlSeconds ? { ttlSeconds } : undefined,\n          );\n        } catch {\n          // payload não-JSON: simplesmente não cacheia.\n        }\n      }\n      done(null, payload);\n    },\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiCA,IAAM,YAAY,uBAAO,kBAAkB;AAK3C,eAAsB,YACpB,SACA,SACe;AACf,QAAM,EAAE,MAAM,IAAI;AAClB,QAAM,aAAa,QAAQ;AAC3B,QAAM,UAAU,QAAQ,WAAW,CAAC,KAAK;AACzC,QAAM,eACJ,QAAQ,iBAAiB,CAAC,QAAwB,GAAG,IAAI,MAAM,IAAI,IAAI,GAAG;AAE5E,UAAQ;AAAA,IACN;AAAA,IACA,CAAC,SAAyB,OAAqB,SAAqB;AAClE,UAAI,CAAC,QAAQ,SAAS,QAAQ,MAAM,GAAG;AACrC,aAAK;AACL;AAAA,MACF;AAEA,YAAM,MAAM,aAAa,OAAO;AAChC,YAAM,SAAS,MAAM,IAAI,GAAG;AAC5B,UAAI,WAAW,MAAM;AACnB,cAAM,OAAO,WAAW,KAAK;AAC7B,cAAM,KAAK,MAAM;AACjB;AAAA,MACF;AAEA,YAAM,OAAO,WAAW,MAAM;AAC9B,MAAC,QAA8C,SAAS,IAAI;AAC5D,WAAK;AAAA,IACP;AAAA,EACF;AAEA,UAAQ;AAAA,IACN;AAAA,IACA,CACE,SACA,OACA,SACA,SACG;AACH,YAAM,MAAO,QACX,SACF;AACA,UACE,OACA,OAAO,YAAY,YACnB,MAAM,cAAc,OACpB,MAAM,aAAa,KACnB;AACA,YAAI;AACF,gBAAM;AAAA,YACJ;AAAA,YACA,KAAK,MAAM,OAAO;AAAA,YAClB,aAAa,EAAE,WAAW,IAAI;AAAA,UAChC;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AACA,WAAK,MAAM,OAAO;AAAA,IACpB;AAAA,EACF;AACF;","names":[]}