@bett3r-dev/pv3 1.0.0 → 2.5.1

package/build/adapters/cache/memory/index.test.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+// TV1-2061: the in-memory cache schedules one `setTimeout` per TTL key. Before the fix those
+// timers were never `unref()`'d and `remove()`/`flushAll()` dropped the key WITHOUT clearing the
+// timer, so consumed keys orphaned a live timer past the adapter's own `stop()`. In-band on a
+// 2-core CI runner ~45 of these accumulated and hung jest for 48 min ("did not exit"). These tests
+// prove no timer survives `remove()` / `flushAll()` / `stop()` / overwrite, and that the timer is
+// unref()'d so a lone pending TTL never keeps the event loop alive.
+describe('MemoryCache TTL timer cleanup (TV1-2061)', () => {
+    beforeEach(() => jest.useFakeTimers());
+    afterEach(() => jest.useRealTimers());
+    it('remove() clears the pending expiration timer for that key', async () => {
+        // Given a key written with a TTL — one timer is scheduled
+        const cache = (0, index_1.MemoryCache)();
+        await cache.set('approval-token', { ok: true }, 300);
+        expect(jest.getTimerCount()).toBe(1);
+        // When the key is removed
+        await cache.remove('approval-token');
+        // Then its timer is cleared — nothing survives to keep the loop alive
+        expect(jest.getTimerCount()).toBe(0);
+    });
+    it('flushAll() clears every pending expiration timer', async () => {
+        // Given several TTL keys
+        const cache = (0, index_1.MemoryCache)();
+        await cache.set('a', { a: 1 }, 300);
+        await cache.set('egress-breaker:x', { b: 2 }, 3600);
+        expect(jest.getTimerCount()).toBe(2);
+        // When the cache is flushed
+        await cache.flushAll();
+        // Then all timers are cleared (the pre-fix flushAll never touched `expirations` at all)
+        expect(jest.getTimerCount()).toBe(0);
+    });
+    it('stop() clears every pending expiration timer', async () => {
+        // Given TTL keys still pending at shutdown
+        const cache = (0, index_1.MemoryCache)();
+        await cache.set('a', { a: 1 }, 300);
+        await cache.set('b', { b: 2 }, 168 * 3600);
+        expect(jest.getTimerCount()).toBe(2);
+        // When the adapter stops
+        await cache.stop();
+        // Then no timer is left scheduled
+        expect(jest.getTimerCount()).toBe(0);
+    });
+    it('re-setting a key\'s expiration does not orphan the prior timer', async () => {
+        // Given a key with a TTL
+        const cache = (0, index_1.MemoryCache)();
+        await cache.set('k', { v: 1 }, 300);
+        // When the same key is written again with a new TTL
+        await cache.set('k', { v: 2 }, 300);
+        // Then only ONE timer exists — the prior handle was cleared, not leaked
+        expect(jest.getTimerCount()).toBe(1);
+        await cache.stop();
+        expect(jest.getTimerCount()).toBe(0);
+    });
+    it('memoize().invalidate() clears the memoized entry\'s timer', async () => {
+        // Given a memoized fn with a TTL that has been called once (scheduling one timer)
+        const cache = (0, index_1.MemoryCache)();
+        const memoized = cache.memoize(async (x) => x + 1, 300);
+        await memoized(1);
+        expect(jest.getTimerCount()).toBe(1);
+        // When the memoized entry is invalidated
+        await memoized.invalidate(1);
+        // Then its timer is cleared
+        expect(jest.getTimerCount()).toBe(0);
+    });
+});
+describe('MemoryCache unref()s TTL timers (TV1-2061)', () => {
+    it('unref()s the scheduled timer so a lone pending TTL does not keep the event loop alive', async () => {
+        // Given a spy that observes .unref() on every real timer the adapter schedules
+        const cache = (0, index_1.MemoryCache)();
+        const unrefCalls = [];
+        const realSetTimeout = global.setTimeout;
+        const spy = jest
+            .spyOn(global, 'setTimeout')
+            .mockImplementation(((...args) => {
+            const handle = realSetTimeout(...args);
+            const realUnref = handle.unref.bind(handle);
+            handle.unref = () => {
+                unrefCalls.push(handle);
+                return realUnref();
+            };
+            return handle;
+        }));
+        try {
+            // When a TTL key is written
+            await cache.set('token', { ok: true }, 300);
+            // Then the adapter unref()'d the scheduled timer
+            expect(unrefCalls).toHaveLength(1);
+        }
+        finally {
+            spy.mockRestore();
+            // Clean up the real timer so this real-timer test leaves nothing behind
+            await cache.stop();
+        }
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/adapters/cache/memory/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../src/adapters/cache/memory/index.test.ts"],"names":[],"mappings":"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"}

package/build/adapters/configuration/dotEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dotEnv.d.ts","sourceRoot":"","sources":["../../../src/adapters/configuration/dotEnv.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAiB7D,eAAO,MAAM,MAAM,gBAAiB,MAAM,mBAAoB,OAAO,MAAM,EAAE,GAAG,CAAC,YAAY,OAAO,MAAM,EAAE,GAAG,CAAC,KAAM,OAAO,MAAM,EAAE,GAAG,CAAC,KAAI,oBAc5I,CAAC"}
+{"version":3,"file":"dotEnv.d.ts","sourceRoot":"","sources":["../../../src/adapters/configuration/dotEnv.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAiB7D,eAAO,MAAM,MAAM,gBAAiB,MAAM,aAAa,CAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAI,oBAc5I,CAAC"}

package/build/adapters/configuration/dotEnv.js.map

@@ -1 +1 @@
-{"version":3,"file":"dotEnv.js","sourceRoot":"","sources":["../../../src/adapters/configuration/dotEnv.ts"],"names":[],"mappings":";;;AAAA,iCAAuC;AAGvC,MAAM,mBAAmB,GAAG,CAAE,GAAwB,EAAwB,EAAE;IAC9E,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,CAAC,IAAI,CAAE,GAAG,CAAE,CAAC,OAAO,CAAC,CAAE,GAAG,EAAG,EAAE;QACnC,IAAK,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE;YAC9D,MAAM,KAAK,GAAG,mBAAmB,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7C,IAAK,MAAM,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC,MAAM,GAAG,CAAC,EAAG;gBACrC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;aACrB;SACF;aAAM,IAAK,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,WAAW,EAAG;YAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;SACxB;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEK,MAAM,MAAM,GAAG,CAAE,WAAkB,EAAE,SAA6F,EAAyB,EAAE;IAClK,OAAO,CAAE,QAAQ,CAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,KAAK,EAA0B,MAAc,EAAoB,EAAE;QACrF,MAAM,SAAS,GAAG,SAAS,CAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAE,CAAC;QACnD,OAAO,IAAA,sBAAc,EAAE,MAAM,EAAE,mBAAmB,CAAE,SAAS,CAAE,CAAW,CAAC;IAC7E,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,KAAK,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QAClB,IAAI,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,MAAM,UAcjB"}
+{"version":3,"file":"dotEnv.js","sourceRoot":"","sources":["../../../src/adapters/configuration/dotEnv.ts"],"names":[],"mappings":";;;AAAA,iCAAuC;AAGvC,MAAM,mBAAmB,GAAG,CAAE,GAAwB,EAAwB,EAAE;IAC9E,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,CAAC,IAAI,CAAE,GAAG,CAAE,CAAC,OAAO,CAAC,CAAE,GAAG,EAAG,EAAE;QACnC,IAAK,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,mBAAmB,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7C,IAAK,MAAM,CAAC,IAAI,CAAE,KAAK,CAAE,CAAC,MAAM,GAAG,CAAC,EAAG,CAAC;gBACtC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;aAAM,IAAK,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,WAAW,EAAG,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEK,MAAM,MAAM,GAAG,CAAE,WAAkB,EAAE,SAA6F,EAAyB,EAAE;IAClK,OAAO,CAAE,QAAQ,CAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,KAAK,EAA0B,MAAc,EAAoB,EAAE;QACrF,MAAM,SAAS,GAAG,SAAS,CAAE,OAAO,CAAC,GAAG,EAAE,MAAM,CAAE,CAAC;QACnD,OAAO,IAAA,sBAAc,EAAE,MAAM,EAAE,mBAAmB,CAAE,SAAS,CAAE,CAAW,CAAC;IAC7E,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,KAAK,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QAClB,IAAI,EAAE,KAAK,IAAE,EAAE,GAAC,CAAC;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,MAAM,GAAN,MAAM,CAcjB"}

package/build/adapters/database/memory/index.d.ts

@@ -1,3 +1,7 @@
 import { DatabaseAdapter } from '@bett3r-dev/pv3-types';
-export declare const MemoryDb: () => DatabaseAdapter;
+export type MemoryDbType = {
+    _db: Record<string, any>;
+    connectionId: string;
+};
+export declare const MemoryDb: () => DatabaseAdapter<MemoryDbType>;
 //# sourceMappingURL=index.d.ts.map

package/build/adapters/database/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/database/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAuG,eAAe,EAAuD,MAAM,uBAAuB,CAAC;AAMlN,eAAO,MAAM,QAAQ,QAAO,eA+Q3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/database/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAiM,eAAe,EAA4E,MAAM,uBAAuB,CAAC;AAMjU,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzB,YAAY,EAAC,MAAM,CAAA;CACpB,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,eAAe,CAAC,YAAY,CAmlBvD,CAAC"}