graphile-cache 3.11.1 → 3.12.0

package/esm/graphile-cache.js

@@ -21,16 +21,19 @@ export const cacheEvents = new CacheEventEmitter();
  * Get cache configuration from environment variables
  *
  * Supports:
- * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 15)
+ * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 50)
  * - GRAPHILE_CACHE_TTL_MS: TTL in milliseconds
  *   - Production default: ONE_YEAR
  *   - Development default: FIVE_MINUTES_MS
+ *
+ * NOTE: This value should be <= PG_CACHE_MAX (also default: 50) so that
+ * every cached PostGraphile instance has a live pool backing it.
  */
 export function getCacheConfig() {
     const isDevelopment = process.env.NODE_ENV === 'development';
     const max = process.env.GRAPHILE_CACHE_MAX
         ? parseInt(process.env.GRAPHILE_CACHE_MAX, 10)
-        : 15;
+        : 50;
     const ttl = process.env.GRAPHILE_CACHE_TTL_MS
         ? parseInt(process.env.GRAPHILE_CACHE_TTL_MS, 10)
         : isDevelopment

package/esm/index.js

@@ -10,3 +10,5 @@ CacheEventEmitter, cacheEvents, getCacheConfig, getCacheStats,
 clearMatchingEntries } from './graphile-cache';
 // Factory for creating PostGraphile v5 instances
 export { createGraphileInstance } from './create-instance';
+// Generic module config cache for plugin lookups
+export { ModuleConfigCache } from './module-config-cache';

package/esm/module-config-cache.js

@@ -0,0 +1,47 @@
+/**
+ * ModuleConfigCache — generic LRU cache for module config lookups
+ *
+ * Provides a bounded, TTL-based cache for runtime config discovery
+ * (billing config, agent discovery, inference log info, etc.).
+ *
+ * Wraps lru-cache with:
+ * - LRU eviction (bounded memory)
+ * - TTL-based expiry
+ * - Named logging for debugging
+ * - clear() hook for future LISTEN/NOTIFY invalidation
+ */
+import { LRUCache } from 'lru-cache';
+import { Logger } from '@pgpmjs/logger';
+export class ModuleConfigCache {
+    cache;
+    log;
+    name;
+    constructor(opts) {
+        this.name = opts.name;
+        this.log = new Logger(`cache:${opts.name}`);
+        this.cache = new LRUCache({
+            max: opts.max ?? 100,
+            ttl: opts.ttlMs ?? 60_000,
+            updateAgeOnGet: true,
+        });
+    }
+    get(key) {
+        return this.cache.get(key);
+    }
+    set(key, value) {
+        this.cache.set(key, value);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.log.debug(`Clearing all entries (size=${this.cache.size})`);
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+}

package/graphile-cache.d.ts

@@ -25,10 +25,13 @@ export interface CacheConfig {
  * Get cache configuration from environment variables
  *
  * Supports:
- * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 15)
+ * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 50)
  * - GRAPHILE_CACHE_TTL_MS: TTL in milliseconds
  *   - Production default: ONE_YEAR
  *   - Development default: FIVE_MINUTES_MS
+ *
+ * NOTE: This value should be <= PG_CACHE_MAX (also default: 50) so that
+ * every cached PostGraphile instance has a live pool backing it.
  */
 export declare function getCacheConfig(): CacheConfig;
 /**

package/graphile-cache.js

@@ -28,16 +28,19 @@ exports.cacheEvents = new CacheEventEmitter();
  * Get cache configuration from environment variables
  *
  * Supports:
- * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 15)
+ * - GRAPHILE_CACHE_MAX: Maximum number of entries (default: 50)
  * - GRAPHILE_CACHE_TTL_MS: TTL in milliseconds
  *   - Production default: ONE_YEAR
  *   - Development default: FIVE_MINUTES_MS
+ *
+ * NOTE: This value should be <= PG_CACHE_MAX (also default: 50) so that
+ * every cached PostGraphile instance has a live pool backing it.
  */
 function getCacheConfig() {
     const isDevelopment = process.env.NODE_ENV === 'development';
     const max = process.env.GRAPHILE_CACHE_MAX
         ? parseInt(process.env.GRAPHILE_CACHE_MAX, 10)
-        : 15;
+        : 50;
     const ttl = process.env.GRAPHILE_CACHE_TTL_MS
         ? parseInt(process.env.GRAPHILE_CACHE_TTL_MS, 10)
         : isDevelopment

package/index.d.ts

@@ -1,2 +1,3 @@
 export { graphileCache, GraphileCacheEntry, closeAllCaches, ONE_HOUR_MS, FIVE_MINUTES_MS, EvictionReason, CacheEventEmitter, CacheEvictionEvent, cacheEvents, CacheConfig, getCacheConfig, CacheStats, getCacheStats, clearMatchingEntries } from './graphile-cache';
 export { createGraphileInstance } from './create-instance';
+export { ModuleConfigCache, ModuleConfigCacheOptions } from './module-config-cache';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createGraphileInstance = exports.clearMatchingEntries = exports.getCacheStats = exports.getCacheConfig = exports.cacheEvents = exports.CacheEventEmitter = exports.FIVE_MINUTES_MS = exports.ONE_HOUR_MS = exports.closeAllCaches = exports.graphileCache = void 0;
+exports.ModuleConfigCache = exports.createGraphileInstance = exports.clearMatchingEntries = exports.getCacheStats = exports.getCacheConfig = exports.cacheEvents = exports.CacheEventEmitter = exports.FIVE_MINUTES_MS = exports.ONE_HOUR_MS = exports.closeAllCaches = exports.graphileCache = void 0;
 // Main exports from graphile-cache package
 var graphile_cache_1 = require("./graphile-cache");
 // Cache instance and entry type
@@ -19,3 +19,6 @@ Object.defineProperty(exports, "clearMatchingEntries", { enumerable: true, get:
 // Factory for creating PostGraphile v5 instances
 var create_instance_1 = require("./create-instance");
 Object.defineProperty(exports, "createGraphileInstance", { enumerable: true, get: function () { return create_instance_1.createGraphileInstance; } });
+// Generic module config cache for plugin lookups
+var module_config_cache_1 = require("./module-config-cache");
+Object.defineProperty(exports, "ModuleConfigCache", { enumerable: true, get: function () { return module_config_cache_1.ModuleConfigCache; } });

package/module-config-cache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ModuleConfigCache — generic LRU cache for module config lookups
+ *
+ * Provides a bounded, TTL-based cache for runtime config discovery
+ * (billing config, agent discovery, inference log info, etc.).
+ *
+ * Wraps lru-cache with:
+ * - LRU eviction (bounded memory)
+ * - TTL-based expiry
+ * - Named logging for debugging
+ * - clear() hook for future LISTEN/NOTIFY invalidation
+ */
+export interface ModuleConfigCacheOptions {
+    /** Cache name (used in log prefix) */
+    name: string;
+    /** Max entries before LRU eviction (default: 100) */
+    max?: number;
+    /** TTL in milliseconds (default: 60_000) */
+    ttlMs?: number;
+}
+export declare class ModuleConfigCache<T> {
+    private cache;
+    private log;
+    readonly name: string;
+    constructor(opts: ModuleConfigCacheOptions);
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    has(key: string): boolean;
+}

package/module-config-cache.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * ModuleConfigCache — generic LRU cache for module config lookups
+ *
+ * Provides a bounded, TTL-based cache for runtime config discovery
+ * (billing config, agent discovery, inference log info, etc.).
+ *
+ * Wraps lru-cache with:
+ * - LRU eviction (bounded memory)
+ * - TTL-based expiry
+ * - Named logging for debugging
+ * - clear() hook for future LISTEN/NOTIFY invalidation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModuleConfigCache = void 0;
+const lru_cache_1 = require("lru-cache");
+const logger_1 = require("@pgpmjs/logger");
+class ModuleConfigCache {
+    cache;
+    log;
+    name;
+    constructor(opts) {
+        this.name = opts.name;
+        this.log = new logger_1.Logger(`cache:${opts.name}`);
+        this.cache = new lru_cache_1.LRUCache({
+            max: opts.max ?? 100,
+            ttl: opts.ttlMs ?? 60_000,
+            updateAgeOnGet: true,
+        });
+    }
+    get(key) {
+        return this.cache.get(key);
+    }
+    set(key, value) {
+        this.cache.set(key, value);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.log.debug(`Clearing all entries (size=${this.cache.size})`);
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+}
+exports.ModuleConfigCache = ModuleConfigCache;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphile-cache",
-  "version": "3.11.1",
+  "version": "3.12.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "PostGraphile v5 LRU cache with automatic pool cleanup integration",
   "main": "index.js",
@@ -32,10 +32,10 @@
     "@pgpmjs/logger": "^2.11.0",
     "express": "^5.2.1",
     "grafserv": "1.0.0",
-    "graphile-realtime-subscriptions": "^0.7.0",
+    "graphile-realtime-subscriptions": "^0.7.1",
     "lru-cache": "^11.2.7",
-    "pg-cache": "^3.10.0",
-    "postgraphile": "5.0.0"
+    "pg-cache": "^3.11.0",
+    "postgraphile": "5.0.3"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",
@@ -52,5 +52,5 @@
     "constructive",
     "v5"
   ],
-  "gitHead": "f368992ff2e66fb639e4a5efee163e311f838ce1"
+  "gitHead": "c0d04574f7719d92e67becb58d60791ae978c5f5"
 }