@spytecgps/nova-orm 1.4.241 → 1.4.243

package/dist/cache/LruQueryResultCache.d.ts

@@ -6,7 +6,15 @@ export interface LruQueryResultCacheConfig {
 }
 export declare class LruQueryResultCache implements QueryResultCache {
     private readonly cache;
+    private readonly maxSize;
     constructor(config?: LruQueryResultCacheConfig);
+    /**
+     * Emit `nova.cache.lru.size` and `nova.cache.lru.max` as observable gauges so
+     * dashboards can tell "is the LRU full?" directly instead of inferring from
+     * hit-rate decay. Filter by `ServiceName` to disambiguate when multiple
+     * DataSources share a process.
+     */
+    private registerSizeGauges;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     synchronize(): Promise<void>;

package/dist/cache/LruQueryResultCache.js

@@ -1 +1 @@
-"use strict";var e=require("lru-cache");exports.LruQueryResultCache=class LruQueryResultCache{cache;constructor(c={}){this.cache=new e.LRUCache({max:c.max??1e3,ttl:c.maxTtlMs})}async connect(){}async disconnect(){this.cache.clear()}async synchronize(){}async getFromCache(e){const c=this.keyFor(e);if(c)return this.cache.get(c)}async storeInCache(e){const c=this.keyFor(e);if(!c)return;const t={...e,time:e.time??Date.now()};this.cache.set(c,t)}isExpired(e){const c=e.time??0;return Date.now()-c>=e.duration}async remove(e){for(const c of e)this.cache.delete(c)}async clear(){this.cache.clear()}keyFor(e){return e.identifier??e.query}};
+"use strict";var e=require("@opentelemetry/api"),c=require("lru-cache");exports.LruQueryResultCache=class LruQueryResultCache{cache;maxSize;constructor(e={}){this.maxSize=e.max??1e3,this.cache=new c.LRUCache({max:this.maxSize,ttl:e.maxTtlMs}),this.registerSizeGauges()}registerSizeGauges(){const c=e.metrics.getMeter("@spytecgps/nova-orm");c.createObservableGauge("nova.cache.lru.size",{description:"Current entry count in the in-process LRU query result cache"}).addCallback((e=>{e.observe(this.cache.size)})),c.createObservableGauge("nova.cache.lru.max",{description:"Configured max entry count for the in-process LRU query result cache"}).addCallback((e=>{e.observe(this.maxSize)}))}async connect(){}async disconnect(){this.cache.clear()}async synchronize(){}async getFromCache(e){const c=this.keyFor(e);if(c)return this.cache.get(c)}async storeInCache(e){const c=this.keyFor(e);if(!c)return;const t={...e,time:e.time??Date.now()};this.cache.set(c,t)}isExpired(e){const c=e.time??0;return Date.now()-c>=e.duration}async remove(e){for(const c of e)this.cache.delete(c)}async clear(){this.cache.clear()}keyFor(e){return e.identifier??e.query}};

package/dist/cache/buildCache.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Build the TypeORM `cache:` config object from an explicit Redis config.
+ *
+ * Consumers own the env-var reading (so the wiring is visible in their config
+ * tree) and pass us a plain object. We translate it into the TypeORM-native
+ * shape, handling the standalone-vs-cluster fork plus the ElastiCache
+ * cluster-mode safety defaults (enableOfflineQueue:false, checkServerIdentity
+ * bypass for TLS — see project_elasticache_cluster_ioredis_tls).
+ */
+export type CacheMode = 'standalone' | 'cluster';
+/**
+ * `host` is `string | undefined` so consumers can populate this directly from
+ * env vars without a guarding ternary — when REDIS_HOST is unset in dev/test,
+ * `buildCache()` returns undefined and no cache is installed.
+ */
+export interface RedisConfig {
+    host: string | undefined;
+    port: number;
+    tls: boolean;
+    mode: CacheMode;
+}
+/**
+ * Matches the shape of TypeORM's `DataSourceOptions.cache`. Fields are typed
+ * loose (`any` / `unknown`) deliberately — TypeORM's own type is loose, and
+ * tightening here would force `as any` casts at every consumer's callsite when
+ * the result is spread into a `DeepPartial<DataSourceOptions>` config tree.
+ */
+export interface BuiltCacheConfig {
+    type?: 'ioredis';
+    options?: any;
+    client?: unknown;
+    ignoreErrors?: boolean;
+}
+/**
+ * Returns undefined when `config` is missing or has no host. Consumers can write:
+ *
+ *   redis: {
+ *     host: process.env.REDIS_HOST,            // string | undefined
+ *     port: Number(process.env.REDIS_PORT ?? '6379'),
+ *     tls:  process.env.REDIS_TLS === 'true',
+ *     mode: (process.env.REDIS_MODE ?? 'standalone') as Cache.CacheMode,
+ *   }
+ *   cache: Cache.buildCache(config.redis)
+ *
+ * No ternary, no cast. In dev/test where REDIS_HOST is unset the cache is
+ * simply not installed.
+ */
+export declare function buildCache(config: RedisConfig | undefined): BuiltCacheConfig | undefined;

package/dist/cache/buildCache.js

@@ -0,0 +1 @@
+"use strict";let r;exports.buildCache=function(e){if(!e?.host)return;const{host:t,port:o,tls:i,mode:s}=e;if("cluster"===s){const e=function(){if(void 0!==r)return r;try{r=require("ioredis")}catch{r=null}return r}();if(!e)throw new Error("buildCache: mode=cluster requires `ioredis` to be installed");return{client:new e.Cluster([{host:t,port:o}],{redisOptions:i?{tls:{checkServerIdentity:()=>{}}}:{},enableOfflineQueue:!1}),ignoreErrors:!0}}return{type:"ioredis",options:{host:t,port:o,tls:i?{}:void 0},ignoreErrors:!0}};

package/dist/cache/index.d.ts

@@ -1,3 +1,4 @@
 export { attachIoredisErrorHandler, RedisQueryResultCacheLike } from './attachIoredisErrorHandler';
+export { buildCache, BuiltCacheConfig, CacheMode, RedisConfig } from './buildCache';
 export { CacheKind, InstrumentedQueryResultCache, InstrumentedQueryResultCacheOptions, } from './InstrumentedQueryResultCache';
 export { LruQueryResultCache, LruQueryResultCacheConfig } from './LruQueryResultCache';

package/dist/cache/index.js

@@ -1 +1 @@
-"use strict";var e=require("./attachIoredisErrorHandler.js"),r=require("./InstrumentedQueryResultCache.js"),t=require("./LruQueryResultCache.js");exports.attachIoredisErrorHandler=e.attachIoredisErrorHandler,exports.InstrumentedQueryResultCache=r.InstrumentedQueryResultCache,exports.LruQueryResultCache=t.LruQueryResultCache;
+"use strict";var e=require("./attachIoredisErrorHandler.js"),r=require("./buildCache.js"),u=require("./InstrumentedQueryResultCache.js"),t=require("./LruQueryResultCache.js");exports.attachIoredisErrorHandler=e.attachIoredisErrorHandler,exports.buildCache=r.buildCache,exports.InstrumentedQueryResultCache=u.InstrumentedQueryResultCache,exports.LruQueryResultCache=t.LruQueryResultCache;

package/dist/migration/_virtual/_virtual_multi-entry.js

@@ -2,12 +2,12 @@
 
 var _1684483704434AddLowerCaseIndex = require('../1684483704434-addLowerCaseIndex.js');
 var _1684483705001UpdateSecurityUserViewsV1 = require('../1684483705001-updateSecurityUserViewsV1.js');
-var _1684483705002UpdateSecurityUserViewsV2 = require('../1684483705002-updateSecurityUserViewsV2.js');
 var _1746434400000AddQuickSearchFulltextIndexes = require('../1746434400000-addQuickSearchFulltextIndexes.js');
+var _1684483705002UpdateSecurityUserViewsV2 = require('../1684483705002-updateSecurityUserViewsV2.js');
 
 
 
 exports.addLowerCaseIndex1684483704434 = _1684483704434AddLowerCaseIndex.addLowerCaseIndex1684483704434;
 exports.updateSecurityUserViewsV11684483705001 = _1684483705001UpdateSecurityUserViewsV1.updateSecurityUserViewsV11684483705001;
-exports.updateSecurityUserViewsV21684483705002 = _1684483705002UpdateSecurityUserViewsV2.updateSecurityUserViewsV21684483705002;
 exports.addQuickSearchFulltextIndexes1746434400000 = _1746434400000AddQuickSearchFulltextIndexes.addQuickSearchFulltextIndexes1746434400000;
+exports.updateSecurityUserViewsV21684483705002 = _1684483705002UpdateSecurityUserViewsV2.updateSecurityUserViewsV21684483705002;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spytecgps/nova-orm",
-  "version": "1.4.241",
+  "version": "1.4.243",
   "description": "ORM with PlanetScale",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/schema.sql

@@ -1,6 +1,6 @@
--- nova-orm-schema-checksum: 6c149c8020575fbb21298a8ec3655fcd
+-- nova-orm-schema-checksum: 2cf05ba22d935b6ff23e793dd72eb97d
 -- Nova ORM Schema Dump
--- Generated at: 2026-05-24T13:19:09.208Z
+-- Generated at: 2026-05-25T05:05:23.896Z
 
 SET FOREIGN_KEY_CHECKS = 0;