@spytecgps/nova-orm 1.4.242 → 1.4.243

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,4 +1,4 @@
 export { attachIoredisErrorHandler, RedisQueryResultCacheLike } from './attachIoredisErrorHandler';
-export { buildCacheFromEnv, BuiltCacheConfig, CacheFromEnvOptions, CacheMode, } from './buildCacheFromEnv';
+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("./buildCacheFromEnv.js"),u=require("./InstrumentedQueryResultCache.js"),t=require("./LruQueryResultCache.js");exports.attachIoredisErrorHandler=e.attachIoredisErrorHandler,exports.buildCacheFromEnv=r.buildCacheFromEnv,exports.InstrumentedQueryResultCache=u.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.242",
+  "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: bdf84e9724e3cf6c308f89f1c1871778
+-- nova-orm-schema-checksum: 2cf05ba22d935b6ff23e793dd72eb97d
 -- Nova ORM Schema Dump
--- Generated at: 2026-05-24T15:55:45.644Z
+-- Generated at: 2026-05-25T05:05:23.896Z
 
 SET FOREIGN_KEY_CHECKS = 0;
 

package/dist/cache/buildCacheFromEnv.d.ts

@@ -1,32 +0,0 @@
-/**
- * Build the TypeORM `cache:` config object from REDIS_* env vars so consumers
- * don't have to embed mode-switching logic in every service. SSM-driven
- * `/${stage}/cache/<name>/redis/{host,port,tls,mode}` keys map 1:1 to the env
- * vars and this helper returns the right TypeORM shape.
- *
- * Returns undefined if REDIS_HOST is absent, so it's safe to spread into a
- * DataSource config that may or may not have a cache configured.
- *
- * Supported modes:
- *   - "standalone" (default): uses TypeORM's built-in RedisQueryResultCache
- *     with the `ioredis` client type. One node, no cluster topology.
- *   - "cluster": custom client passed through TypeORM's `client` field; uses
- *     `ioredis` Cluster mode with the ElastiCache-cluster-mode safety
- *     defaults baked in (enableOfflineQueue:false, checkServerIdentity bypass
- *     for TLS — see project_elasticache_cluster_ioredis_tls).
- */
-export type CacheMode = 'standalone' | 'cluster';
-export interface CacheFromEnvOptions {
-    /** Env var name for host. Default: REDIS_HOST. Override to support multiple caches in one process. */
-    hostEnv?: string;
-    portEnv?: string;
-    tlsEnv?: string;
-    modeEnv?: string;
-}
-export interface BuiltCacheConfig {
-    type?: 'ioredis';
-    options?: Record<string, unknown>;
-    client?: unknown;
-    ignoreErrors?: boolean;
-}
-export declare function buildCacheFromEnv(options?: CacheFromEnvOptions): BuiltCacheConfig | undefined;

package/dist/cache/buildCacheFromEnv.js

@@ -1 +0,0 @@
-"use strict";let e;exports.buildCacheFromEnv=function(r={}){const t=r.hostEnv??"REDIS_HOST",n=r.portEnv??"REDIS_PORT",o=r.tlsEnv??"REDIS_TLS",s=r.modeEnv??"REDIS_MODE",i=process.env[t];if(!i)return;const u=Number(process.env[n]??"6379"),c="true"===process.env[o];if("cluster"===(process.env[s]??"standalone")){const r=function(){if(void 0!==e)return e;try{e=require("ioredis")}catch{e=null}return e}();if(!r)throw new Error("buildCacheFromEnv: REDIS_MODE=cluster requires `ioredis` to be installed");return{client:new r.Cluster([{host:i,port:u}],{redisOptions:c?{tls:{checkServerIdentity:()=>{}}}:{},enableOfflineQueue:!1}),ignoreErrors:!0}}return{type:"ioredis",options:{host:i,port:u,tls:c?{}:void 0},ignoreErrors:!0}};