2.1.6

changelog.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2025-01-19 - 2.1.6 - fix(core)
+Updated dependencies and improved AsyncStore debugging and cleanup
+
+- Upgraded 'simple-async-context' dependency to version ^0.0.16 for consistency and improvements.
+- Added detailed debugging information in AsyncStore when DEBUG environment variable is set.
+- Enhanced cleanup process for deleted keys in AsyncStore.
+- Removed redundant dependencies from package.json and logcontext.plugins.ts.
+
+## 2025-01-19 - 2.1.5 - fix(dependencies)
+Update dependencies for improved compatibility
+
+- Updated @types/node to version ^22.10.7
+- Updated @types/shortid to version 2.2.0
+- Updated simple-async-context to version ^0.0.15
+
 ## 2025-01-19 - 2.1.4 - fix(documentation)
 Remove unnecessary conclusion section from the README for better clarity.
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartcontext",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "A module providing advanced asynchronous context management to enrich logs with context and manage scope effectively in Node.js applications.",
   "exports": {
     ".": "./dist_ts/index.js"
@@ -19,15 +19,11 @@
     "@git.zone/tsrun": "^1.2.39",
     "@git.zone/tstest": "^1.0.57",
     "@push.rocks/smartdelay": "^3.0.5",
-    "@push.rocks/tapbundle": "^5.0.4",
+    "@push.rocks/tapbundle": "^5.5.6",
-    "@types/node": "^18.11.18"
+    "@types/node": "^22.10.7"
   },
   "dependencies": {
-    "@push.rocks/lik": "^6.0.0",
+    "simple-async-context": "^0.0.16"
-    "@push.rocks/smartcls": "^1.0.9",
-    "@push.rocks/smartunique": "^3.0.3",
-    "@types/shortid": "0.0.29",
-    "simple-async-context": "^0.0.13"
   },
   "private": false,
   "browserslist": [

pnpm-lock.yaml

@@ -8,21 +8,9 @@ importers:
 
   .:
     dependencies:
-      '@push.rocks/lik':
-        specifier: ^6.0.0
-        version: 6.1.0
-      '@push.rocks/smartcls':
-        specifier: ^1.0.9
-        version: 1.0.14
-      '@push.rocks/smartunique':
-        specifier: ^3.0.3
-        version: 3.0.9
-      '@types/shortid':
-        specifier: 0.0.29
-        version: 0.0.29
       simple-async-context:
-        specifier: ^0.0.13
+        specifier: ^0.0.16
-        version: 0.0.13
+        version: 0.0.16
     devDependencies:
       '@git.zone/tsbuild':
         specifier: ^2.1.27
@@ -40,11 +28,11 @@ importers:
         specifier: ^3.0.5
         version: 3.0.5
       '@push.rocks/tapbundle':
-        specifier: ^5.0.4
+        specifier: ^5.5.6
-        version: 5.5.4(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
+        version: 5.5.6(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
       '@types/node':
-        specifier: ^18.11.18
+        specifier: ^22.10.7
-        version: 18.19.71
+        version: 22.10.7
 
 packages:
 
@@ -729,9 +717,6 @@ packages:
   '@push.rocks/smartcli@4.0.11':
     resolution: {integrity: sha512-KDWfUqWBoUZsOEtsDx36d6qc8GG7Zo5E+HHamYY68KVDO8BMu6jbBucoUUPDksczLEmbXKLmroBP1mn/xozQOA==}
 
-  '@push.rocks/smartcls@1.0.14':
-    resolution: {integrity: sha512-1Sew9ZVTS8mdaKMlOOKZ9uCcSa6QXAfT7yX8xgqF24bXZvyUcf0Lf0d6VvlAMiFJ3bA0H8AsmRFJ8F7HlKW1RA==}
-
   '@push.rocks/smartcrypto@2.0.4':
     resolution: {integrity: sha512-1+/5bsjyataf5uUkUNnnVXGRAt+gHVk1KDzozjTqgqJxHvQk1d9fVDohL6CxUhUucTPtu5VR5xNBiV8YCDuGyw==}
 
@@ -825,6 +810,9 @@ packages:
   '@push.rocks/smartpromise@4.1.0':
     resolution: {integrity: sha512-1E4QZx1bYFMEgbK1C9gb4CB3YRhfkvSeffc5CnT83n7NV4Qly/Sxe9G1Jn0sQBB5+sbFHwTlj/0al5+q4gXiDw==}
 
+  '@push.rocks/smartpromise@4.2.0':
+    resolution: {integrity: sha512-1Yb0u/Yu68D1GPuxPhfMe2MefffqqzK+WmtrCipQl75cBXyaiNiwwrRKaG47ZJquMS+BYxqC/P40cDVAWDvMfw==}
+
   '@push.rocks/smartpuppeteer@2.0.2':
     resolution: {integrity: sha512-EcYCT0PX++WjfHp7W5UYX3t8x5gSNpJMMUvhA7SHz8b2t76ItslNWxprRcF0CUQyN1fozbf5StZf7dwdGc/dIA==}
 
@@ -882,8 +870,8 @@ packages:
   '@push.rocks/smartyaml@2.0.5':
     resolution: {integrity: sha512-tBcf+HaOIfeEsTMwgUZDtZERCxXQyRsWO8Ar5DjBdiSRchbhVGZQEBzXswMS0W5ZoRenjgPK+4tPW3JQGRTfbg==}
 
-  '@push.rocks/tapbundle@5.5.4':
+  '@push.rocks/tapbundle@5.5.6':
-    resolution: {integrity: sha512-FDL9I95vRENAZmqyQ9/45I1aDaDqFm62rNZOaroqbYX86R7pK75YtwqA0AqQ+QYALX055xw02xlRND5tZmPByQ==}
+    resolution: {integrity: sha512-V6u+nZwt4fNccxbm3ztZgHr/QAj/uKhaaOUFgtaae0jzYdds4jNEI+mXLpfXuNMgm7Nx93Lk5XUxWKTI8drjNw==}
 
   '@push.rocks/taskbuffer@3.1.7':
     resolution: {integrity: sha512-QktGVJPucqQmW/QNGnscf4FAigT1H7JWKFGFdRuDEaOHKFh9qN+PXG3QY7DtZ4jfXdGLxPN4yAufDuPSAJYFnw==}
@@ -1422,8 +1410,8 @@ packages:
   '@types/node-forge@1.3.11':
     resolution: {integrity: sha512-FQx220y22OKNTqaByeBGqHWYz4cl94tpcxeFdvBo3wjG6XPBuZ0BNgNZRV5J5TFmmcsJ4IzsLkmGRiQbnYsBEQ==}
 
-  '@types/node@18.19.71':
+  '@types/node@22.10.7':
-    resolution: {integrity: sha512-evXpcgtZm8FY4jqBSN8+DmOTcVkkvTmAayeo4Wf3m1xAruyVGzGuDh/Fb/WWX2yLItUiho42ozyJjB0dw//Tkw==}
+    resolution: {integrity: sha512-V09KvXxFiutGp6B7XkpaDXlNadZxrzajcY50EuoLIpQ6WWYCSvf19lVIazzfIzQvhUN2HjX12spLojTnhuKlGg==}
 
   '@types/parse5@6.0.3':
     resolution: {integrity: sha512-SuT16Q1K51EAVPz1K29DJ/sXjhSQ0zjvsypYJ6tlwVsRV9jwW5Adq2ch8Dq8kDBCkYnELS7N7VNCSB5nC56t/g==}
@@ -1455,9 +1443,6 @@ packages:
   '@types/serve-static@1.15.7':
     resolution: {integrity: sha512-W8Ym+h8nhuRwaKPaDw34QUkwsGi6Rc4yYqvKFo5rm2FUEhCFbzVWrxXUxuKK8TASjWsysJY0nsmNCGhCOIsrOw==}
 
-  '@types/shortid@0.0.29':
-    resolution: {integrity: sha1-gJPuBBam4r8qpjOBCRFLP7/6Dps=}
-
   '@types/sinon-chai@3.2.12':
     resolution: {integrity: sha512-9y0Gflk3b0+NhQZ/oxGtaAJDvRywCa5sIyaVnounqLvmf93yBF4EgIRspePtkMs3Tr844nCclYMlcCNmLCvjuQ==}
 
@@ -3643,8 +3628,8 @@ packages:
     resolution: {integrity: sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==}
     engines: {node: '>=14'}
 
-  simple-async-context@0.0.13:
+  simple-async-context@0.0.16:
-    resolution: {integrity: sha512-dD45zmw9HBlSyWVQJ38VTP5RpuVED8zIiwHrouimeHxDIlNxt66j+iWHQIvbTrsd1SnWVRaLwbPvsVsy+rfjpw==}
+    resolution: {integrity: sha512-FbE32PwJcZQU+rta11BGI5K+bSwPf2FPnkMmOJVWUOz5qRMgwEqRRc2e85fhkRkYe3Pb9P/r5ELWjgaBGBsnDQ==}
 
   simple-swizzle@0.2.2:
     resolution: {integrity: sha1-pNprY1/8zMoz9w0Xy5JZLeleVXo=}
@@ -3922,8 +3907,8 @@ packages:
   unbzip2-stream@1.4.3:
     resolution: {integrity: sha512-mlExGW4w71ebDJviH16lQLtZS32VKqsSfk80GCfUlwT/4/hNRFsoscrF/c++9xinkMzECL1uL9DDwXqFWkruPg==}
 
-  undici-types@5.26.5:
+  undici-types@6.20.0:
-    resolution: {integrity: sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==}
+    resolution: {integrity: sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==}
 
   unified@11.0.5:
     resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}
@@ -5040,7 +5025,7 @@ snapshots:
       '@push.rocks/smartlog': 3.0.7
       '@push.rocks/smartpromise': 4.1.0
       '@push.rocks/smartshell': 3.2.2
-      '@push.rocks/tapbundle': 5.5.4(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
+      '@push.rocks/tapbundle': 5.5.6(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
       '@types/ws': 8.5.13
       figures: 6.1.0
       ws: 8.18.0
@@ -5086,7 +5071,7 @@ snapshots:
       '@jest/schemas': 29.6.3
       '@types/istanbul-lib-coverage': 2.0.6
       '@types/istanbul-reports': 3.0.4
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/yargs': 17.0.33
       chalk: 4.1.2
 
@@ -5335,11 +5320,9 @@ snapshots:
       '@push.rocks/smartrx': 3.0.7
       yargs-parser: 21.1.1
 
-  '@push.rocks/smartcls@1.0.14': {}
-
   '@push.rocks/smartcrypto@2.0.4':
     dependencies:
-      '@push.rocks/smartpromise': 4.1.0
+      '@push.rocks/smartpromise': 4.2.0
       '@types/node-forge': 1.3.11
       node-forge: 1.3.1
 
@@ -5349,7 +5332,7 @@ snapshots:
       '@push.rocks/smartdelay': 3.0.5
       '@push.rocks/smartlog': 3.0.7
       '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
-      '@push.rocks/smartpromise': 4.1.0
+      '@push.rocks/smartpromise': 4.2.0
       '@push.rocks/smartrx': 3.0.7
       '@push.rocks/smartstring': 4.0.15
       '@push.rocks/smarttime': 4.1.1
@@ -5386,7 +5369,7 @@ snapshots:
   '@push.rocks/smartexpect@1.4.0':
     dependencies:
       '@push.rocks/smartdelay': 3.0.5
-      '@push.rocks/smartpromise': 4.1.0
+      '@push.rocks/smartpromise': 4.2.0
       fast-deep-equal: 3.1.3
 
   '@push.rocks/smartfeed@1.0.11':
@@ -5511,7 +5494,7 @@ snapshots:
       '@push.rocks/mongodump': 1.0.8
       '@push.rocks/smartdata': 5.2.10(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
       '@push.rocks/smartpath': 5.0.18
-      '@push.rocks/smartpromise': 4.1.0
+      '@push.rocks/smartpromise': 4.2.0
       mongodb-memory-server: 8.16.1
     transitivePeerDependencies:
       - '@aws-sdk/credential-providers'
@@ -5593,6 +5576,8 @@ snapshots:
 
   '@push.rocks/smartpromise@4.1.0': {}
 
+  '@push.rocks/smartpromise@4.2.0': {}
+
   '@push.rocks/smartpuppeteer@2.0.2':
     dependencies:
       '@pushrocks/smartdelay': 2.0.13
@@ -5754,7 +5739,7 @@ snapshots:
       '@types/js-yaml': 3.12.10
       js-yaml: 3.14.1
 
-  '@push.rocks/tapbundle@5.5.4(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)':
+  '@push.rocks/tapbundle@5.5.6(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)':
     dependencies:
       '@open-wc/testing': 4.0.0
       '@push.rocks/consolecolor': 2.0.2
@@ -5767,7 +5752,7 @@ snapshots:
       '@push.rocks/smartjson': 5.0.20
       '@push.rocks/smartmongo': 2.0.10(@aws-sdk/credential-providers@3.731.1)(socks@2.8.3)
       '@push.rocks/smartpath': 5.0.18
-      '@push.rocks/smartpromise': 4.1.0
+      '@push.rocks/smartpromise': 4.2.0
       '@push.rocks/smartrequest': 2.0.23
       '@push.rocks/smarts3': 2.2.5
       '@push.rocks/smartshell': 3.2.2
@@ -6378,14 +6363,14 @@ snapshots:
 
   '@types/accepts@1.3.7':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/babel__code-frame@7.0.6': {}
 
   '@types/body-parser@1.19.5':
     dependencies:
       '@types/connect': 3.4.38
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/buffer-json@2.0.3': {}
 
@@ -6401,17 +6386,17 @@ snapshots:
 
   '@types/clean-css@4.2.11':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       source-map: 0.6.1
 
   '@types/co-body@6.1.3':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/qs': 6.9.18
 
   '@types/connect@3.4.38':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/content-disposition@0.5.8': {}
 
@@ -6424,11 +6409,11 @@ snapshots:
       '@types/connect': 3.4.38
       '@types/express': 5.0.0
       '@types/keygrip': 1.0.6
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/cors@2.8.17':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/debounce@1.2.4': {}
 
@@ -6442,14 +6427,14 @@ snapshots:
 
   '@types/express-serve-static-core@4.19.6':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/qs': 6.9.18
       '@types/range-parser': 1.2.7
       '@types/send': 0.17.4
 
   '@types/express-serve-static-core@5.0.5':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/qs': 6.9.18
       '@types/range-parser': 1.2.7
       '@types/send': 0.17.4
@@ -6474,30 +6459,30 @@ snapshots:
 
   '@types/from2@2.3.5':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/fs-extra@11.0.4':
     dependencies:
       '@types/jsonfile': 6.1.4
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/fs-extra@9.0.13':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/glob@7.2.0':
     dependencies:
       '@types/minimatch': 5.1.2
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/glob@8.1.0':
     dependencies:
       '@types/minimatch': 5.1.2
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/gunzip-maybe@1.4.2':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/hast@3.0.4':
     dependencies:
@@ -6531,7 +6516,7 @@ snapshots:
 
   '@types/jsonfile@6.1.4':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/keygrip@1.0.6': {}
 
@@ -6548,7 +6533,7 @@ snapshots:
       '@types/http-errors': 2.0.4
       '@types/keygrip': 1.0.6
       '@types/koa-compose': 3.2.8
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/mdast@4.0.4':
     dependencies:
@@ -6566,11 +6551,11 @@ snapshots:
 
   '@types/node-forge@1.3.11':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
-  '@types/node@18.19.71':
+  '@types/node@22.10.7':
     dependencies:
-      undici-types: 5.26.5
+      undici-types: 6.20.0
 
   '@types/parse5@6.0.3': {}
 
@@ -6586,23 +6571,21 @@ snapshots:
 
   '@types/s3rver@3.7.4':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/semver@7.5.8': {}
 
   '@types/send@0.17.4':
     dependencies:
       '@types/mime': 1.3.5
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/serve-static@1.15.7':
     dependencies:
       '@types/http-errors': 2.0.4
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/send': 0.17.4
 
-  '@types/shortid@0.0.29': {}
-
   '@types/sinon-chai@3.2.12':
     dependencies:
       '@types/chai': 5.0.1
@@ -6620,11 +6603,11 @@ snapshots:
 
   '@types/tar-stream@2.2.3':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/through2@2.0.41':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/triple-beam@1.3.5': {}
 
@@ -6648,7 +6631,7 @@ snapshots:
 
   '@types/whatwg-url@8.2.2':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       '@types/webidl-conversions': 7.0.3
 
   '@types/which@2.0.2': {}
@@ -6657,11 +6640,11 @@ snapshots:
 
   '@types/ws@7.4.7':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/ws@8.5.13':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
 
   '@types/yargs-parser@21.0.3': {}
 
@@ -6671,7 +6654,7 @@ snapshots:
 
   '@types/yauzl@2.10.3':
     dependencies:
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
     optional: true
 
   '@ungap/structured-clone@1.2.1': {}
@@ -7256,7 +7239,7 @@ snapshots:
     dependencies:
       '@types/cookie': 0.4.1
       '@types/cors': 2.8.17
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       accepts: 1.3.8
       base64id: 2.0.0
       cookie: 0.4.2
@@ -7977,7 +7960,7 @@ snapshots:
   jest-util@29.7.0:
     dependencies:
       '@jest/types': 29.6.3
-      '@types/node': 18.19.71
+      '@types/node': 22.10.7
       chalk: 4.1.2
       ci-info: 3.9.0
       graceful-fs: 4.2.11
@@ -9190,7 +9173,7 @@ snapshots:
 
   signal-exit@4.1.0: {}
 
-  simple-async-context@0.0.13: {}
+  simple-async-context@0.0.16: {}
 
   simple-swizzle@0.2.2:
     dependencies:
@@ -9493,7 +9476,7 @@ snapshots:
       buffer: 5.7.1
       through: 2.3.8
 
-  undici-types@5.26.5: {}
+  undici-types@6.20.0: {}
 
   unified@11.0.5:
     dependencies:

readme.md

@@ -2,6 +2,8 @@
 
 A module to enrich logs with context, featuring async log contexts and scope management.
 
+Special thanks to Ilias Bhallil for his awesome simple-async-context library.
+
 ## Install
 
 Make sure you have Node.js and npm installed, then run:

test/test.ts

@@ -2,6 +2,8 @@ import { tap, expect } from '@push.rocks/tapbundle';
 import { AsyncContext } from '../ts/logcontext.classes.asynccontext.js';
 import { AsyncStore } from '../ts/logcontext.classes.asyncstore.js';
 
+process.env.DEBUG = 'true';
+
 /**
  * This test file demonstrates how to use the AsyncContext and ensures
  * that runScoped() properly creates child AsyncStore contexts and merges parent data.
@@ -35,15 +37,28 @@ tap.test('should not contaminate the parent store with child-only data', async (
   expect(asyncContext.store.get('temporaryKey')).toBeUndefined();
 });
 
-tap.test('should allow adding data in multiple scopes independently', async () => {
+tap.test('should allow adding data in multiple scopes independently', async (toolsArg) => {
+  const done = toolsArg.cumulativeDefer();
+
   // add data in first scope
-  await asyncContext.runScoped(async () => {
+  asyncContext.runScoped(async () => {
-    asyncContext.store.add('childKey1', 'childValue1');
+    const subDone = done.subDefer();
-    expect(asyncContext.store.get('childKey1')).toEqual('childValue1');
+    asyncContext.store.add('childKey1', 'childValue1-v1');
+    await toolsArg.delayFor(2000);
+    expect(asyncContext.store.get('childKey1')).toEqual('childValue1-v1');
+    subDone.resolve();
+  });
+
+  asyncContext.runScoped(async () => {
+    const subDone = done.subDefer();
+    asyncContext.store.add('childKey1', 'childValue1-v2');
+    await toolsArg.delayFor(1000);
+    expect(asyncContext.store.get('childKey1')).toEqual('childValue1-v2');
+    subDone.resolve();
   });
 
   // add data in second scope
-  await asyncContext.runScoped(async () => {
+  asyncContext.runScoped(async () => {
     asyncContext.store.add('childKey2', 'childValue2');
     expect(asyncContext.store.get('childKey2')).toEqual('childValue2');
   });
@@ -51,23 +66,27 @@ tap.test('should allow adding data in multiple scopes independently', async () =
   // neither childKey1 nor childKey2 should exist in the parent store
   expect(asyncContext.store.get('childKey1')).toBeUndefined();
   expect(asyncContext.store.get('childKey2')).toBeUndefined();
+  await done.promise;
 });
 
-tap.test('should allow deleting data in a child store without removing it from the parent store', async () => {
+tap.test(
-  // ensure parent has some data
+  'should allow deleting data in a child store without removing it from the parent store',
-  asyncContext.store.add('deletableKey', 'iShouldStayInParent');
+  async (toolsArg) => {
+    // ensure parent has some data
+    asyncContext.store.add('deletableKey', 'iShouldStayInParent');
 
-  await asyncContext.runScoped(async () => {
+    await asyncContext.runScoped(async () => {
-    // child sees the parent's data
+      // child sees the parent's data
+      expect(asyncContext.store.get('deletableKey')).toEqual('iShouldStayInParent');
+      // attempt to delete it in the child
+      asyncContext.store.delete('deletableKey');
+      // child no longer sees it
+      expect(asyncContext.store.get('deletableKey')).toBeUndefined();
+      // but parent still has it
+    });
     expect(asyncContext.store.get('deletableKey')).toEqual('iShouldStayInParent');
-    // attempt to delete it in the child
+  }
-    asyncContext.store.delete('deletableKey');
+);
-    // child no longer sees it
-    expect(asyncContext.store.get('deletableKey')).toBeUndefined();
-    // but parent still has it
-  });
-  expect(asyncContext.store.get('deletableKey')).toEqual('iShouldStayInParent');
-});
 
 tap.test('should allow multiple child scopes to share the same parent store data', async () => {
   // add a key to the parent store

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartcontext',
-  version: '2.1.4',
+  version: '2.1.6',
   description: 'A module providing advanced asynchronous context management to enrich logs with context and manage scope effectively in Node.js applications.'
 }

ts/logcontext.classes.asynccontext.ts

@@ -11,8 +11,7 @@ export class AsyncContext {
     this._store = value;
   }
   public async runScoped(functionArg: () => Promise<void>) {
-    const childStore = new AsyncStore(this.store);
+    await this._context.run(new AsyncStore(this.store), async () => {
-    await this._context.run(childStore, async () => {
       await functionArg()
     });
   } 

ts/logcontext.classes.asyncstore.ts

@@ -1,50 +1,135 @@
 import * as plugins from './logcontext.plugins.js';
 
 export class AsyncStore {
+  private static idCounter = 0;
+  private id: number;
   private parentStore?: AsyncStore;
   private deletedKeys: string[] = [];
-  private dataObject: {[key: string]: any} = {};
+  private dataObject: { [key: string]: any } = {};
 
   constructor(parentStore?: AsyncStore) {
     this.parentStore = parentStore;
+    this.id = AsyncStore.idCounter++;
   }
 
+  /**
+   * Logs debug info if process.env.DEBUG is set.
+   */
+  private logDebug(functionName: string, before: Record<string, any>, after: Record<string, any>) {
+    if (process.env.DEBUG) {
+      console.log(`Store ID: ${this.id}`);
+      console.log(`Function: ${functionName}`);
+      console.log('--- Before ---');
+      console.log(before);
+      console.log('--- After ---');
+      console.log(after);
+      console.log('-----------------------');
+    }
+  }
+
+  /**
+   * Cleans up the deleted keys if they no longer exist in any parent store.
+   */
   private cleanUp() {
     for (const key of this.deletedKeys) {
       if (this.parentStore && this.parentStore.get(key)) {
-        // ok still valid
+        // Parent still has it, so keep in deletedKeys
       } else {
-        delete this.deletedKeys[key];
+        const index = this.deletedKeys.indexOf(key);
+        if (index !== -1) {
+          this.deletedKeys.splice(index, 1);
+        }
       }
     }
   }
 
+  /**
+   * Adds or updates a value under a specific key in this store.
+   */
   public add(keyArg: string, objectArg: any) {
+    // capture the before state
+    const before = { ...this.dataObject, deletedKeys: [...this.deletedKeys] };
+
     this.cleanUp();
+    // If this key was previously deleted, remove it from deletedKeys.
     if (this.deletedKeys.includes(keyArg)) {
       this.deletedKeys = this.deletedKeys.filter((key) => key !== keyArg);
     }
     this.dataObject[keyArg] = objectArg;
+
+    // capture the after state
+    const after = { ...this.dataObject, deletedKeys: [...this.deletedKeys] };
+    this.logDebug('add', before, after);
   }
 
+  /**
+   * Deletes a key from the current store.
+   * If a parent store has the key, we record it in `deletedKeys` so the child store "shadows" it.
+   */
   public delete(paramName: string) {
+    // capture the before state
+    const before = { ...this.dataObject, deletedKeys: [...this.deletedKeys] };
+
     this.cleanUp();
-    if (this.parentStore.get(paramName)) {
+    if (this.parentStore?.get(paramName)) {
+      // The parent store has this key; let's mark it as deleted in the child
       this.deletedKeys.push(paramName);
     }
     delete this.dataObject[paramName];
+
+    // capture the after state
+    const after = { ...this.dataObject, deletedKeys: [...this.deletedKeys] };
+    this.logDebug('delete', before, after);
   }
 
+  /**
+   * Gets the value of a key, checking this store first, then the parent store if necessary.
+   * Will log the store state before/after for debugging.
+   */
   public get(paramName: string) {
+    // capture the before state
+    const before = { ...this.dataObject, deletedKeys: [...this.deletedKeys] };
+
     this.cleanUp();
+    // figure out if paramName is deleted or present
+    let result: any;
     if (this.deletedKeys.includes(paramName)) {
-      return undefined;
+      result = undefined;
+    } else {
+      result = this.dataObject[paramName] ?? this.parentStore?.get(paramName);
     }
-    return this.dataObject[paramName] || this.parentStore?.get(paramName);
+
+    // capture the after state; we can also show the `result` in the log
+    const after = {
+      ...this.dataObject,
+      deletedKeys: [...this.deletedKeys],
+      retrievedKey: paramName,
+      result
+    };
+    this.logDebug('get', before, after);
+
+    return result;
   }
 
+  /**
+   * Returns all keys and values, merged with the parent store, but
+   * does NOT include keys that are "deleted" in the child.
+   * Child store should override parent if the same key exists in both.
+   */
   public getAll() {
     this.cleanUp();
-    return {...this.dataObject, ...(this.parentStore?.getAll() || {})};
+    // first, get parent's data as a shallow copy
+    const parentData = { ...(this.parentStore?.getAll() || {}) };
+
+    // remove keys from parent data that this child has deleted
+    for (const key of this.deletedKeys) {
+      delete parentData[key];
+    }
+
+    // child's data overrides parent data for any matching keys
+    return {
+      ...parentData,
+      ...this.dataObject
+    };
   }
 }

ts/logcontext.plugins.ts

@@ -1,9 +1,3 @@
-// pushrocks scope
-import * as lik from '@push.rocks/lik';
-import * as smartunique from '@push.rocks/smartunique';
-
-export { lik, smartunique };
-
 // third party scope
 import simpleAsyncContext from 'simple-async-context';