1.0.17

fix(package): Update dependency scopes/versions, fix imports and scripts, add pnpm workspace, remove GitLab CI
update description
2025-08-26 19:42:20 +00:00 · 2025-08-26 19:42:20 +00:00 · 2024-05-29 14:11:59 +02:00 · 2024-04-14 17:23:41 +02:00 · 2024-04-01 21:34:01 +02:00 · 2024-04-01 19:57:45 +02:00
21 changed files with 9086 additions and 1146 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,20 @@
 .nogit/
-node_modules/
+
+# artifacts
 coverage/
 public/
 pages/
+
+# installs
+node_modules/
+
+# caches
 .yarn/
+.cache/
+.rpt2_cache
+
+# builds
+dist/
+dist_*/
+
+# custom
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -1,141 +0,0 @@
-# gitzone standard
-image: hosttoday/ht-docker-node:npmci
-
-cache:
-  paths:
-  - .npmci_cache/
-  key: "$CI_BUILD_STAGE"
-
-stages:
- security
- test
- release
- metadata
-
-# ====================
-# security stage
-# ====================
-mirror:
-  stage: security
-  script:
-  - npmci git mirror
-  tags:
-  - docker
-  - notpriv
-
-snyk:
-  stage: security
-  script:
-    - npmci command npm install -g snyk
-    - npmci command npm install --ignore-scripts
-    - npmci command snyk test
-  tags:
-  - docker
-  - notpriv
-
-# ====================
-# test stage
-# ====================
-testLEGACY:
-  stage: test
-  script:
-  - npmci node install legacy
-  - npmci npm install
-  - npmci npm test
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-  - docker
-  - notpriv
-  allow_failure: true
-
-testLTS:
-  stage: test
-  script:
-  - npmci node install lts
-  - npmci npm install
-  - npmci npm test
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-  - docker
-  - notpriv
-    
-testSTABLE:
-  stage: test
-  script:
-  - npmci node install stable
-  - npmci npm install
-  - npmci npm test
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-  - docker
-  - notpriv
-
-release:
-  stage: release
-  script:
-  - npmci node install stable
-  - npmci npm publish
-  only:
-  - tags
-  tags:
-  - docker
-  - notpriv
-
-# ====================
-# metadata stage
-# ====================
-codequality:
-  stage: metadata
-  image: docker:stable
-  allow_failure: true
-  services:
-    - docker:stable-dind
-  script:
-    - export SP_VERSION=$(echo "$CI_SERVER_VERSION" | sed 's/^\([0-9]*\)\.\([0-9]*\).*/\1-\2-stable/')
-    - docker run
-        --env SOURCE_CODE="$PWD"
-        --volume "$PWD":/code
-        --volume /var/run/docker.sock:/var/run/docker.sock
-        "registry.gitlab.com/gitlab-org/security-products/codequality:$SP_VERSION" /code
-  artifacts:
-    paths: [codeclimate.json]
-  tags:
-  - docker
-  - priv
-
-trigger:
-  stage: metadata
-  script:
-  - npmci trigger
-  only:
-  - tags
-  tags:
-  - docker
-  - notpriv
-
-pages:
-  image: hosttoday/ht-docker-node:npmci
-  stage: metadata
-  script:
-    - npmci command npm install -g npmpage
-    - npmci command npmpage
-  tags:
-    - docker
-    - notpriv
-  only:
-    - tags
-  artifacts:
-    expire_in: 1 week
-    paths:
-    - public
-  allow_failure: true
-
-windowsCompatibility:
-  image: stefanscherer/node-windows:10-build-tools
-  stage: metadata
-  script:
-  - npm install & npm test
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-  - windows
-  allow_failure: true
--- a/.serena/project.yml
+++ b/.serena/project.yml
@@ -0,0 +1,68 @@
+# language of the project (csharp, python, rust, java, typescript, go, cpp, or ruby)
+#  * For C, use cpp
+#  * For JavaScript, use typescript
+# Special requirements:
+#  * csharp: Requires the presence of a .sln file in the project folder.
+language: typescript
+
+# whether to use the project's gitignore file to ignore files
+# Added on 2025-04-07
+ignore_all_files_in_gitignore: true
+# list of additional paths to ignore
+# same syntax as gitignore, so you can use * and **
+# Was previously called `ignored_dirs`, please update your config if you are using that.
+# Added (renamed) on 2025-04-07
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+
+# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+project_name: "smartcache"
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "npm test",
+      "name": "Run npm test",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -0,0 +1,26 @@
+{
+  "json.schemas": [
+    {
+      "fileMatch": ["/npmextra.json"],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "npmci": {
+            "type": "object",
+            "description": "settings for npmci"
+          },
+          "gitzone": {
+            "type": "object",
+            "description": "settings for gitzone",
+            "properties": {
+              "projectType": {
+                "type": "string",
+                "enum": ["website", "element", "service", "npm", "wcc"]
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}
--- a/changelog.md
+++ b/changelog.md
@@ -0,0 +1,94 @@
+# Changelog
+
+## 2025-08-26 - 1.0.17 - fix(package)
+Update dependency scopes/versions, fix imports and scripts, add pnpm workspace, remove GitLab CI
+
+- Normalized package scopes to include dot notation (e.g. @push.rocks/*) and updated internal import paths in TypeScript files
+- Updated runtime dependencies: @push.rocks/smartdelay -> ^3.0.5, @push.rocks/smartpromise -> ^4.2.3 (other @push.rocks/* deps kept/validated)
+- Switched dev tooling packages to @git.zone/* namespace and bumped @git.zone/tstest version
+- Adjusted npm scripts: more verbose test command and changed build target to use tsfolders
+- Added pnpm-workspace.yaml and packageManager entry in package.json
+- Removed .gitlab-ci.yml CI configuration
+
+## 2024-05-29 - 1.0.16 - chore
+Project metadata and TypeScript configuration updates.
+
+- Update package description.
+- Update tsconfig for TypeScript configuration.
+- Update npmextra.json (githost) entries.
+- Switch to new organization scheme (org restructuring).
+
+## 2023-01-08 - 1.0.15 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2022-06-26 - 1.0.14 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2021-04-21 - 1.0.13 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2020-02-03 - 1.0.12 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2019-10-23 - 1.0.11 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2018-12-02 - 1.0.10 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2018-12-02 - 1.0.9 - test
+Test updates.
+
+- Update and improve tests.
+
+## 2018-09-07 - 1.0.8 - fix(core)
+Core fixes and maintenance.
+
+- Apply core updates and fixes.
+
+## 2018-08-21 - 1.0.7 - fix
+Remove obsolete logging.
+
+- Remove obsolete console.log statements.
+
+## 2018-08-19 - 1.0.6 - ci
+Continuous integration cleanup.
+
+- Remove obsolete build dependencies from CI/build configuration.
+
+## 2018-08-19 - 1.0.5 - dependencies
+Dependency updates.
+
+- Update project dependencies.
+
+## 2018-07-13 - 1.0.4 - package
+Package metadata fixes.
+
+- Fix package name in metadata.
+
+## 2018-07-12 - 1.0.3 - meta
+Tag-only release.
+
+- No code changes recorded for this tag (tagging/release bookkeeping only).
+
+## 2018-07-12 - 1.0.2 - package
+Project setup.
+
+- Fix project/package setup issues.
+
+## 2018-07-12 - 1.0.1 - init
+Initial release.
+
+- Initial project release and base setup.
--- a/npmextra.json
+++ b/npmextra.json
@@ -2,5 +2,31 @@
  "npmci": {
    "npmGlobalTools": [],
    "npmAccessLevel": "public"
+  },
+  "gitzone": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "push.rocks",
+      "gitrepo": "smartcache",
+      "description": "A module for caching asynchronous function results with smart time and hash-based invalidation strategies.",
+      "npmPackagename": "@push.rocks/smartcache",
+      "license": "MIT",
+      "keywords": [
+        "caching",
+        "asynchronous",
+        "time-based invalidation",
+        "hash-based identification",
+        "smart caching",
+        "node.js",
+        "performance optimization",
+        "typescript",
+        "delay handling",
+        "error management"
+      ]
+    }
+  },
+  "tsdoc": {
+    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
  }
 }
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,944 +0,0 @@
-{
-  "name": "@pushrocks/smartcache",
-  "version": "1.0.9",
-  "lockfileVersion": 1,
-  "requires": true,
-  "dependencies": {
-    "@airbnb/node-memwatch": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/@airbnb/node-memwatch/-/node-memwatch-1.0.2.tgz",
-      "integrity": "sha512-2R+MEEMSTUdKwQ6NFWkyA/UNoSjL1tMldZqJbZpgXSwNMBzlNlkUWEXKu9RqTTMkDqJRfGJ2VDs8gPlPK2APDQ==",
-      "dev": true,
-      "requires": {
-        "bindings": "^1.3.0",
-        "nan": "^2.9.2"
-      }
-    },
-    "@gitzone/tsbuild": {
-      "version": "2.0.22",
-      "resolved": "https://registry.npmjs.org/@gitzone/tsbuild/-/tsbuild-2.0.22.tgz",
-      "integrity": "sha512-H0rqGVUKXWgxXhkY62kF92WpbS9GSJW27jQXaoyMsQptTQN4HIYKHWZMdO4egkk0/gDmKnBjk8MXg5Rx6efItA==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/smartfile": "^6.0.6",
-        "@pushrocks/smartlog": "^2.0.1",
-        "@pushrocks/smartpath": "^4.0.1",
-        "@pushrocks/smartpromise": "^2.0.5",
-        "typescript": "^3.0.1"
-      },
-      "dependencies": {
-        "typescript": {
-          "version": "3.0.1",
-          "resolved": "https://registry.npmjs.org/typescript/-/typescript-3.0.1.tgz",
-          "integrity": "sha512-zQIMOmC+372pC/CCVLqnQ0zSBiY7HHodU7mpQdjiZddek4GMj31I3dUJ7gAs9o65X7mnRma6OokOkc6f9jjfBg==",
-          "dev": true
-        }
-      }
-    },
-    "@gitzone/tsrun": {
-      "version": "1.1.12",
-      "resolved": "https://registry.npmjs.org/@gitzone/tsrun/-/tsrun-1.1.12.tgz",
-      "integrity": "sha512-DOxqOg+evoxhgbzhzH4u6LaPF+6bpMsnBVl1QQaHzKPGBlNjaIY4yJ0RsGnWMgX1hlNLvbgHtl0Ky4A2MDvyrg==",
-      "dev": true,
-      "requires": {
-        "@gitzone/tsbuild": "^2.0.22",
-        "@pushrocks/smartfile": "^6.0.6",
-        "ts-node": "^7.0.0",
-        "typescript": "^3.0.1"
-      }
-    },
-    "@gitzone/tstest": {
-      "version": "1.0.15",
-      "resolved": "https://registry.npmjs.org/@gitzone/tstest/-/tstest-1.0.15.tgz",
-      "integrity": "sha512-+t5fvYK4a0JkwwH0Fokh5aOxVzrax5OjDUL4zmhBk7KFmXt7fdvcqsSNaEp9iyqC52dLiDybdAXqHYZypXTIYw==",
-      "dev": true,
-      "requires": {
-        "@gitzone/tsrun": "^1.1.12",
-        "@pushrocks/consolecolor": "^2.0.1",
-        "@pushrocks/smartfile": "^6.0.6",
-        "@pushrocks/smartlog": "^2.0.1",
-        "@pushrocks/smartpromise": "^2.0.5",
-        "@pushrocks/smartshell": "^2.0.6",
-        "@types/figures": "^2.0.0",
-        "figures": "^2.0.0"
-      },
-      "dependencies": {
-        "@gitzone/tsrun": {
-          "version": "1.1.12",
-          "resolved": "https://registry.npmjs.org/@gitzone/tsrun/-/tsrun-1.1.12.tgz",
-          "integrity": "sha512-DOxqOg+evoxhgbzhzH4u6LaPF+6bpMsnBVl1QQaHzKPGBlNjaIY4yJ0RsGnWMgX1hlNLvbgHtl0Ky4A2MDvyrg==",
-          "dev": true,
-          "requires": {
-            "@gitzone/tsbuild": "^2.0.22",
-            "@pushrocks/smartfile": "^6.0.6",
-            "ts-node": "^7.0.0",
-            "typescript": "^3.0.1"
-          }
-        },
-        "typescript": {
-          "version": "3.0.1",
-          "resolved": "https://registry.npmjs.org/typescript/-/typescript-3.0.1.tgz",
-          "integrity": "sha512-zQIMOmC+372pC/CCVLqnQ0zSBiY7HHodU7mpQdjiZddek4GMj31I3dUJ7gAs9o65X7mnRma6OokOkc6f9jjfBg==",
-          "dev": true
-        }
-      }
-    },
-    "@pushrocks/consolecolor": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/@pushrocks/consolecolor/-/consolecolor-2.0.1.tgz",
-      "integrity": "sha512-iOFCHVeFZ2OywbdwSxVI4/wokkcLrXVdHLgvMmkNhJ220eeLgjNZWx3EJo3vNW3zq5ybCSCUIq0878djBxrWpw==",
-      "dev": true,
-      "requires": {
-        "ansi-256-colors": "^1.1.0"
-      }
-    },
-    "@pushrocks/early": {
-      "version": "3.0.3",
-      "resolved": "https://registry.npmjs.org/@pushrocks/early/-/early-3.0.3.tgz",
-      "integrity": "sha512-71/nwxTpqdp1glmHz4YaGusNl/XOOcPelAxC9RA6rpS/6280QyY2u4yx+mRdMrCzn7ruLYF5awbkS8llNZ94Pg==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/consolecolor": "^2.0.1",
-        "@pushrocks/smartpromise": "^2.0.5"
-      }
-    },
-    "@pushrocks/smartdelay": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartdelay/-/smartdelay-2.0.2.tgz",
-      "integrity": "sha512-4xf6tMKwZcxBynKgXrM4SQKgeASfRvx43LUmR5DkStp26ZHAsarCXUdKJS6y8QIPygEOTOCP8we97JAcCzBuMg==",
-      "requires": {
-        "@pushrocks/smartpromise": "^2.0.5"
-      }
-    },
-    "@pushrocks/smarterror": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smarterror/-/smarterror-2.0.1.tgz",
-      "integrity": "sha512-3OrF5me+/sy5VgwR/tfCqs7qhb0Ywzgn8tTThRUZnCGas0aindISzMiW7cIro3RlFykmtPmdTztC9Ostu2ioeA==",
-      "requires": {
-        "clean-stack": "^1.3.0",
-        "make-error-cause": "^2.2.0"
-      }
-    },
-    "@pushrocks/smartfile": {
-      "version": "6.0.7",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartfile/-/smartfile-6.0.7.tgz",
-      "integrity": "sha512-mh7JkW9/59GczaUdEJajafoc9HNjs75rblBVO20k1N8yxs/ZsfgVPniEqC6eCvCpBNiM/EzU1hgqgj/mYpXU1g==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/smartpath": "^4.0.1",
-        "@pushrocks/smartpromise": "^2.0.5",
-        "@pushrocks/smartrequest": "^1.1.14",
-        "@types/fs-extra": "^5.0.4",
-        "@types/vinyl": "^2.0.2",
-        "fs-extra": "^7.0.0",
-        "glob": "^7.1.2",
-        "js-yaml": "^3.10.0",
-        "vinyl-file": "^3.0.0"
-      },
-      "dependencies": {
-        "@types/fs-extra": {
-          "version": "5.0.4",
-          "resolved": "https://registry.npmjs.org/@types/fs-extra/-/fs-extra-5.0.4.tgz",
-          "integrity": "sha512-DsknoBvD8s+RFfSGjmERJ7ZOP1HI0UZRA3FSI+Zakhrc/Gy26YQsLI+m5V5DHxroHRJqCDLKJp7Hixn8zyaF7g==",
-          "dev": true,
-          "requires": {
-            "@types/node": "*"
-          }
-        },
-        "fs-extra": {
-          "version": "7.0.0",
-          "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.0.tgz",
-          "integrity": "sha512-EglNDLRpmaTWiD/qraZn6HREAEAHJcJOmxNEYwq6xeMKnVMAy3GUcFB+wXt2C6k4CNvB/mP1y/U3dzvKKj5OtQ==",
-          "dev": true,
-          "requires": {
-            "graceful-fs": "^4.1.2",
-            "jsonfile": "^4.0.0",
-            "universalify": "^0.1.0"
-          }
-        }
-      }
-    },
-    "@pushrocks/smarthash": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smarthash/-/smarthash-2.0.0.tgz",
-      "integrity": "sha512-+nxpmemy7Tn5tTRlJKR68HJzFDLVMJQSM/GRzb7wgYPVkjs+zeME4oTV6pn8x3//qFio8C3RdrvsQ1iz+xO/jw==",
-      "requires": {
-        "@pushrocks/smartpromise": "^2.0.5",
-        "@types/through2": "^2.0.33",
-        "through2": "^2.0.3"
-      },
-      "dependencies": {
-        "@types/through2": {
-          "version": "2.0.33",
-          "resolved": "https://registry.npmjs.org/@types/through2/-/through2-2.0.33.tgz",
-          "integrity": "sha1-H/LoihAN+1sUDnu5h5HxGUQA0TE=",
-          "requires": {
-            "@types/node": "*"
-          }
-        }
-      }
-    },
-    "@pushrocks/smartlog": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartlog/-/smartlog-2.0.1.tgz",
-      "integrity": "sha512-GtsDTGIUF3VuWPyF8FV5dF31ZCEIcaJ56ZlvJsWxjnyJq57X25mk5/K0QAaRE9IIeHg6fORcukFomb5C+AOQrg==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/smartlog-interfaces": "^1.0.9"
-      }
-    },
-    "@pushrocks/smartlog-interfaces": {
-      "version": "1.0.9",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartlog-interfaces/-/smartlog-interfaces-1.0.9.tgz",
-      "integrity": "sha512-0qwpomrRN0kFjmhR9m1iHYXoISoNuXtRP0Wr+JtkYyURLwKHMaW8Xoznf8MzXJptRfqufJi3Fxh5HodpPrIZUA==",
-      "dev": true
-    },
-    "@pushrocks/smartpath": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartpath/-/smartpath-4.0.1.tgz",
-      "integrity": "sha512-MaI0+uLQPCr2V3WGnbdgb0pWa9xkWyrP4qYcbsHIjeismGLbn9s3jmP/HIXU8LkgzRgaVb+BJxmZJHOwl32DyA==",
-      "dev": true
-    },
-    "@pushrocks/smartpromise": {
-      "version": "2.0.5",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartpromise/-/smartpromise-2.0.5.tgz",
-      "integrity": "sha512-9j/chLtIiNkR0MDw7Mpxg9slxAVvAQwUZuiaPYX5KpHdKxQaHLI1VZ8IN0vPhwlfgNO4i4vGXV0wB8BvSDj03g=="
-    },
-    "@pushrocks/smartrequest": {
-      "version": "1.1.14",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartrequest/-/smartrequest-1.1.14.tgz",
-      "integrity": "sha512-+sDQB4Mxvpn8BIMPUQ7TPSCKUVMln3tHC4rp4pmfEHmBQK+g1XwtNr59aMA9kEoBDMt7li1hu+1cs+SNsWt6Gw==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/smartpromise": "^2.0.5",
-        "@types/form-data": "^2.2.1",
-        "form-data": "^2.3.2"
-      }
-    },
-    "@pushrocks/smartshell": {
-      "version": "2.0.6",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smartshell/-/smartshell-2.0.6.tgz",
-      "integrity": "sha512-D48KB3DDqLfMjOXGEutqJi+v3Z4RcWacu5BJXxUwrecvd6oetbKobfmNGxeHSQPmNGb7U3ISfKwV6c5T5EZkJg==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/smartpromise": "^2.0.5",
-        "@types/which": "^1.3.1",
-        "which": "^1.3.1"
-      }
-    },
-    "@pushrocks/smarttime": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/@pushrocks/smarttime/-/smarttime-2.0.2.tgz",
-      "integrity": "sha512-/gA3CRfzJldUohjxgkMj0+Stl1GNTveHoo4+Yx7sPbpvBu9uMn7hg0JlXUaZi5SxFmRTaQIPIw38ZxjG17awjg==",
-      "requires": {
-        "@pushrocks/smartpromise": "^2.0.5",
-        "moment": "^2.21.0"
-      }
-    },
-    "@pushrocks/tapbundle": {
-      "version": "3.0.7",
-      "resolved": "https://registry.npmjs.org/@pushrocks/tapbundle/-/tapbundle-3.0.7.tgz",
-      "integrity": "sha512-ZI4fhXPy8XMfiy/QofP0ZDuFdv3cErm+FP/+AXaNKdgCCx01MXNTYSUdER1GPUXW3ZbiXdurkLJlxlhIzD1ZJw==",
-      "dev": true,
-      "requires": {
-        "@pushrocks/early": "^3.0.3",
-        "@pushrocks/smartdelay": "^2.0.2",
-        "@pushrocks/smartpromise": "^2.0.5",
-        "leakage": "^0.4.0",
-        "smartchai": "^2.0.1"
-      }
-    },
-    "@types/chai": {
-      "version": "4.1.4",
-      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.1.4.tgz",
-      "integrity": "sha512-h6+VEw2Vr3ORiFCyyJmcho2zALnUq9cvdB/IO8Xs9itrJVCenC7o26A6+m7D0ihTTr65eS259H5/Ghl/VjYs6g==",
-      "dev": true
-    },
-    "@types/chai-as-promised": {
-      "version": "7.1.0",
-      "resolved": "https://registry.npmjs.org/@types/chai-as-promised/-/chai-as-promised-7.1.0.tgz",
-      "integrity": "sha512-MFiW54UOSt+f2bRw8J7LgQeIvE/9b4oGvwU7XW30S9QGAiHGnU/fmiOprsyMkdmH2rl8xSPc0/yrQw8juXU6bQ==",
-      "dev": true,
-      "requires": {
-        "@types/chai": "*"
-      }
-    },
-    "@types/chai-string": {
-      "version": "1.4.1",
-      "resolved": "https://registry.npmjs.org/@types/chai-string/-/chai-string-1.4.1.tgz",
-      "integrity": "sha512-aRNMs6TKgjgPlCHwDfq/YNy5VtRR2hJ4AUWByddrT0TRVVD8eX4MiHW6/iHvmQHRlVuuPZcwnTUE7b4yFt7bEA==",
-      "dev": true,
-      "requires": {
-        "@types/chai": "*"
-      }
-    },
-    "@types/figures": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/@types/figures/-/figures-2.0.0.tgz",
-      "integrity": "sha512-mcRgJ+ncKuNI+Dwac7omO18B8C8u+YBS+AU/oyLhEyjAnT3cUUThhHgZpbiIvu5ZqSvdD30BXtrqg9nxc3OKMg==",
-      "dev": true
-    },
-    "@types/form-data": {
-      "version": "2.2.1",
-      "resolved": "https://registry.npmjs.org/@types/form-data/-/form-data-2.2.1.tgz",
-      "integrity": "sha512-JAMFhOaHIciYVh8fb5/83nmuO/AHwmto+Hq7a9y8FzLDcC1KCU344XDOMEmahnrTFlHjgh4L0WJFczNIX2GxnQ==",
-      "dev": true,
-      "requires": {
-        "@types/node": "*"
-      }
-    },
-    "@types/node": {
-      "version": "10.9.4",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-10.9.4.tgz",
-      "integrity": "sha512-fCHV45gS+m3hH17zgkgADUSi2RR1Vht6wOZ0jyHP8rjiQra9f+mIcgwPQHllmDocYOstIEbKlxbFDYlgrTPYqw=="
-    },
-    "@types/vinyl": {
-      "version": "2.0.2",
-      "resolved": "https://registry.npmjs.org/@types/vinyl/-/vinyl-2.0.2.tgz",
-      "integrity": "sha512-2iYpNuOl98SrLPBZfEN9Mh2JCJ2EI9HU35SfgBEb51DcmaHkhp8cKMblYeBqMQiwXMgAD3W60DbQ4i/UdLiXhw==",
-      "dev": true,
-      "requires": {
-        "@types/node": "*"
-      }
-    },
-    "@types/which": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/@types/which/-/which-1.3.1.tgz",
-      "integrity": "sha512-ZrJDWpvg75LTGX4XwuneY9s6bF3OeZcGTpoGh3zDV9ytzcHMFsRrMIaLBRJZQMBoGyKs6unBQfVdrLZiYfb1zQ==",
-      "dev": true
-    },
-    "ansi-256-colors": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/ansi-256-colors/-/ansi-256-colors-1.1.0.tgz",
-      "integrity": "sha1-kQ3lDvzHwJ49gvL4er1rcAwYgYo=",
-      "dev": true
-    },
-    "argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
-      "dev": true,
-      "requires": {
-        "sprintf-js": "~1.0.2"
-      }
-    },
-    "arrify": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/arrify/-/arrify-1.0.1.tgz",
-      "integrity": "sha1-iYUI2iIm84DfkEcoRWhJwVAaSw0=",
-      "dev": true
-    },
-    "assertion-error": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz",
-      "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==",
-      "dev": true
-    },
-    "asynckit": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
-      "integrity": "sha1-x57Zf380y48robyXkLzDZkdLS3k=",
-      "dev": true
-    },
-    "balanced-match": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.0.tgz",
-      "integrity": "sha1-ibTRmasr7kneFk6gK4nORi1xt2c=",
-      "dev": true
-    },
-    "bindings": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.3.0.tgz",
-      "integrity": "sha512-DpLh5EzMR2kzvX1KIlVC0VkC3iZtHKTgdtZ0a3pglBZdaQFjt5S9g9xd1lE+YvXyfd6mtCeRnrUfOLYiTMlNSw==",
-      "dev": true
-    },
-    "brace-expansion": {
-      "version": "1.1.11",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
-      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
-      "dev": true,
-      "requires": {
-        "balanced-match": "^1.0.0",
-        "concat-map": "0.0.1"
-      }
-    },
-    "buffer-from": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.0.tgz",
-      "integrity": "sha512-c5mRlguI/Pe2dSZmpER62rSCu0ryKmWddzRYsuXc50U2/g8jMOulc31VZMa4mYx31U5xsmSOpDCgH88Vl9cDGQ==",
-      "dev": true
-    },
-    "chai": {
-      "version": "4.1.2",
-      "resolved": "https://registry.npmjs.org/chai/-/chai-4.1.2.tgz",
-      "integrity": "sha1-D2RYS6ZC8PKs4oBiefTwbKI61zw=",
-      "dev": true,
-      "requires": {
-        "assertion-error": "^1.0.1",
-        "check-error": "^1.0.1",
-        "deep-eql": "^3.0.0",
-        "get-func-name": "^2.0.0",
-        "pathval": "^1.0.0",
-        "type-detect": "^4.0.0"
-      }
-    },
-    "chai-as-promised": {
-      "version": "7.1.1",
-      "resolved": "https://registry.npmjs.org/chai-as-promised/-/chai-as-promised-7.1.1.tgz",
-      "integrity": "sha512-azL6xMoi+uxu6z4rhWQ1jbdUhOMhis2PvscD/xjLqNMkv3BPPp2JyyuTHOrf9BOosGpNQ11v6BKv/g57RXbiaA==",
-      "dev": true,
-      "requires": {
-        "check-error": "^1.0.2"
-      }
-    },
-    "chai-string": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/chai-string/-/chai-string-1.5.0.tgz",
-      "integrity": "sha512-sydDC3S3pNAQMYwJrs6dQX0oBQ6KfIPuOZ78n7rocW0eJJlsHPh2t3kwW7xfwYA/1Bf6/arGtSUo16rxR2JFlw==",
-      "dev": true
-    },
-    "check-error": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.2.tgz",
-      "integrity": "sha1-V00xLt2Iu13YkS6Sht1sCu1KrII=",
-      "dev": true
-    },
-    "clean-stack": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-1.3.0.tgz",
-      "integrity": "sha1-noIVAa6XmYbEax1m0tQy2y/UrjE="
-    },
-    "clone": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/clone/-/clone-2.1.1.tgz",
-      "integrity": "sha1-0hfR6WERjjrJpLi7oyhVU79kfNs=",
-      "dev": true
-    },
-    "clone-buffer": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/clone-buffer/-/clone-buffer-1.0.0.tgz",
-      "integrity": "sha1-4+JbIHrE5wGvch4staFnksrD3Fg=",
-      "dev": true
-    },
-    "clone-stats": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/clone-stats/-/clone-stats-1.0.0.tgz",
-      "integrity": "sha1-s3gt/4u1R04Yuba/D9/ngvh3doA=",
-      "dev": true
-    },
-    "cloneable-readable": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/cloneable-readable/-/cloneable-readable-1.1.2.tgz",
-      "integrity": "sha512-Bq6+4t+lbM8vhTs/Bef5c5AdEMtapp/iFb6+s4/Hh9MVTt8OLKH7ZOOZSCT+Ys7hsHvqv0GuMPJ1lnQJVHvxpg==",
-      "dev": true,
-      "requires": {
-        "inherits": "^2.0.1",
-        "process-nextick-args": "^2.0.0",
-        "readable-stream": "^2.3.5"
-      }
-    },
-    "combined-stream": {
-      "version": "1.0.6",
-      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.6.tgz",
-      "integrity": "sha1-cj599ugBrFYTETp+RFqbactjKBg=",
-      "dev": true,
-      "requires": {
-        "delayed-stream": "~1.0.0"
-      }
-    },
-    "concat-map": {
-      "version": "0.0.1",
-      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
-      "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=",
-      "dev": true
-    },
-    "core-util-is": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz",
-      "integrity": "sha1-tf1UIgqivFq1eqtxQMlAdUUDwac="
-    },
-    "deep-eql": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-3.0.1.tgz",
-      "integrity": "sha512-+QeIQyN5ZuO+3Uk5DYh6/1eKO0m0YmJFGNmFHGACpf1ClL1nmlV/p4gNgbl2pJGxgXb4faqo6UE+M5ACEMyVcw==",
-      "dev": true,
-      "requires": {
-        "type-detect": "^4.0.0"
-      }
-    },
-    "delayed-stream": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
-      "integrity": "sha1-3zrhmayt+31ECqrgsp4icrJOxhk=",
-      "dev": true
-    },
-    "diff": {
-      "version": "3.5.0",
-      "resolved": "https://registry.npmjs.org/diff/-/diff-3.5.0.tgz",
-      "integrity": "sha512-A46qtFgd+g7pDZinpnwiRJtxbC1hpgf0uzP3iG89scHk0AUC7A1TGxf5OiiOUv/JMZR8GOt8hL900hV0bOy5xA==",
-      "dev": true
-    },
-    "es6-error": {
-      "version": "4.1.1",
-      "resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",
-      "integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",
-      "dev": true
-    },
-    "escape-string-regexp": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
-      "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=",
-      "dev": true
-    },
-    "esprima": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.0.tgz",
-      "integrity": "sha512-oftTcaMu/EGrEIu904mWteKIv8vMuOgGYo7EhVJJN00R/EED9DCua/xxHRdYnKtcECzVg7xOWhflvJMnqcFZjw==",
-      "dev": true
-    },
-    "figures": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/figures/-/figures-2.0.0.tgz",
-      "integrity": "sha1-OrGi0qYsi/tDGgyUy3l6L84nyWI=",
-      "dev": true,
-      "requires": {
-        "escape-string-regexp": "^1.0.5"
-      }
-    },
-    "first-chunk-stream": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/first-chunk-stream/-/first-chunk-stream-2.0.0.tgz",
-      "integrity": "sha1-G97NuOCDwGZLkZRVgVd6Q6nzHXA=",
-      "dev": true,
-      "requires": {
-        "readable-stream": "^2.0.2"
-      }
-    },
-    "form-data": {
-      "version": "2.3.2",
-      "resolved": "https://registry.npmjs.org/form-data/-/form-data-2.3.2.tgz",
-      "integrity": "sha1-SXBJi+YEwgwAXU9cI67NIda0kJk=",
-      "dev": true,
-      "requires": {
-        "asynckit": "^0.4.0",
-        "combined-stream": "1.0.6",
-        "mime-types": "^2.1.12"
-      }
-    },
-    "fs.realpath": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
-      "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=",
-      "dev": true
-    },
-    "get-func-name": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.0.tgz",
-      "integrity": "sha1-6td0q+5y4gQJQzoGY2YCPdaIekE=",
-      "dev": true
-    },
-    "glob": {
-      "version": "7.1.2",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
-      "integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
-      "dev": true,
-      "requires": {
-        "fs.realpath": "^1.0.0",
-        "inflight": "^1.0.4",
-        "inherits": "2",
-        "minimatch": "^3.0.4",
-        "once": "^1.3.0",
-        "path-is-absolute": "^1.0.0"
-      }
-    },
-    "graceful-fs": {
-      "version": "4.1.11",
-      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.1.11.tgz",
-      "integrity": "sha1-Dovf5NHduIVNZOBOp8AOKgJuVlg=",
-      "dev": true
-    },
-    "inflight": {
-      "version": "1.0.6",
-      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
-      "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=",
-      "dev": true,
-      "requires": {
-        "once": "^1.3.0",
-        "wrappy": "1"
-      }
-    },
-    "inherits": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
-      "integrity": "sha1-Yzwsg+PaQqUC9SRmAiSA9CCCYd4="
-    },
-    "is-utf8": {
-      "version": "0.2.1",
-      "resolved": "https://registry.npmjs.org/is-utf8/-/is-utf8-0.2.1.tgz",
-      "integrity": "sha1-Sw2hRCEE0bM2NA6AeX6GXPOffXI=",
-      "dev": true
-    },
-    "isarray": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-      "integrity": "sha1-u5NdSFgsuhaMBoNJV6VKPgcSTxE="
-    },
-    "isexe": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
-      "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=",
-      "dev": true
-    },
-    "js-yaml": {
-      "version": "3.12.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.12.0.tgz",
-      "integrity": "sha512-PIt2cnwmPfL4hKNwqeiuz4bKfnzHTBv6HyVgjahA6mPLwPDzjDWrplJBMjHUFxku/N3FlmrbyPclad+I+4mJ3A==",
-      "dev": true,
-      "requires": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
-      }
-    },
-    "jsonfile": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
-      "integrity": "sha1-h3Gq4HmbZAdrdmQPygWPnBDjPss=",
-      "dev": true,
-      "requires": {
-        "graceful-fs": "^4.1.6"
-      }
-    },
-    "leakage": {
-      "version": "0.4.0",
-      "resolved": "https://registry.npmjs.org/leakage/-/leakage-0.4.0.tgz",
-      "integrity": "sha512-x7gYK5n5dPkHDZWJ2Kh8Ag1hZNzUh+HtXn8Bv1aDdN6o6ONPCJ8sOfFq+kxcULJFp3lXaCjXb3iXOLmQRbBLwA==",
-      "dev": true,
-      "requires": {
-        "@airbnb/node-memwatch": "^1.0.2",
-        "es6-error": "^4.0.2",
-        "left-pad": "^1.1.3",
-        "minimist": "^1.2.0",
-        "pretty-bytes": "^4.0.2"
-      }
-    },
-    "left-pad": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/left-pad/-/left-pad-1.3.0.tgz",
-      "integrity": "sha512-XI5MPzVNApjAyhQzphX8BkmKsKUxD4LdyK24iZeQGinBN9yTQT3bFlCBy/aVx2HrNcqQGsdot8ghrjyrvMCoEA==",
-      "dev": true
-    },
-    "make-error": {
-      "version": "1.3.4",
-      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.4.tgz",
-      "integrity": "sha512-0Dab5btKVPhibSalc9QGXb559ED7G7iLjFXBaj9Wq8O3vorueR5K5jaE3hkG6ZQINyhA/JgG6Qk4qdFQjsYV6g=="
-    },
-    "make-error-cause": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/make-error-cause/-/make-error-cause-2.2.0.tgz",
-      "integrity": "sha512-qPkj0ajfb7j8dSevKEmVE+Pc5x7OlFy9aQN6ryYNSCn+6METm45Pz5TfuB6uiYyYTyI1UYmnsfMjytQwb6Q5zw==",
-      "requires": {
-        "make-error": "^1.3.4"
-      }
-    },
-    "mime-db": {
-      "version": "1.35.0",
-      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.35.0.tgz",
-      "integrity": "sha512-JWT/IcCTsB0Io3AhWUMjRqucrHSPsSf2xKLaRldJVULioggvkJvggZ3VXNNSRkCddE6D+BUI4HEIZIA2OjwIvg==",
-      "dev": true
-    },
-    "mime-types": {
-      "version": "2.1.19",
-      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.19.tgz",
-      "integrity": "sha512-P1tKYHVSZ6uFo26mtnve4HQFE3koh1UWVkp8YUC+ESBHe945xWSoXuHHiGarDqcEZ+whpCDnlNw5LON0kLo+sw==",
-      "dev": true,
-      "requires": {
-        "mime-db": "~1.35.0"
-      }
-    },
-    "minimatch": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
-      "integrity": "sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==",
-      "dev": true,
-      "requires": {
-        "brace-expansion": "^1.1.7"
-      }
-    },
-    "minimist": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.0.tgz",
-      "integrity": "sha1-o1AIsg9BOD7sH7kU9M1d95omQoQ=",
-      "dev": true
-    },
-    "mkdirp": {
-      "version": "0.5.1",
-      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.1.tgz",
-      "integrity": "sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=",
-      "dev": true,
-      "requires": {
-        "minimist": "0.0.8"
-      },
-      "dependencies": {
-        "minimist": {
-          "version": "0.0.8",
-          "resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
-          "integrity": "sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=",
-          "dev": true
-        }
-      }
-    },
-    "moment": {
-      "version": "2.22.2",
-      "resolved": "https://registry.npmjs.org/moment/-/moment-2.22.2.tgz",
-      "integrity": "sha1-PCV/mDn8DpP/UxSWMiOeuQeD/2Y="
-    },
-    "nan": {
-      "version": "2.11.0",
-      "resolved": "https://registry.npmjs.org/nan/-/nan-2.11.0.tgz",
-      "integrity": "sha512-F4miItu2rGnV2ySkXOQoA8FKz/SR2Q2sWP0sbTxNxz/tuokeC8WxOhPMcwi0qIyGtVn/rrSeLbvVkznqCdwYnw==",
-      "dev": true
-    },
-    "once": {
-      "version": "1.4.0",
-      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
-      "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=",
-      "dev": true,
-      "requires": {
-        "wrappy": "1"
-      }
-    },
-    "path-is-absolute": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
-      "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=",
-      "dev": true
-    },
-    "pathval": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.0.tgz",
-      "integrity": "sha1-uULm1L3mUwBe9rcTYd74cn0GReA=",
-      "dev": true
-    },
-    "pify": {
-      "version": "2.3.0",
-      "resolved": "https://registry.npmjs.org/pify/-/pify-2.3.0.tgz",
-      "integrity": "sha1-7RQaasBDqEnqWISY59yosVMw6Qw=",
-      "dev": true
-    },
-    "pretty-bytes": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/pretty-bytes/-/pretty-bytes-4.0.2.tgz",
-      "integrity": "sha1-sr+C5zUNZcbDOqlaqlpPYyf2HNk=",
-      "dev": true
-    },
-    "process-nextick-args": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.0.tgz",
-      "integrity": "sha512-MtEC1TqN0EU5nephaJ4rAtThHtC86dNN9qCuEhtshvpVBkAW5ZO7BASN9REnF9eoXGcRub+pFuKEpOHE+HbEMw=="
-    },
-    "readable-stream": {
-      "version": "2.3.6",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.6.tgz",
-      "integrity": "sha512-tQtKA9WIAhBF3+VLAseyMqZeBjW0AHJoxOtYqSUZNJxauErmLbVm2FW1y+J/YA9dUrAC39ITejlZWhVIwawkKw==",
-      "requires": {
-        "core-util-is": "~1.0.0",
-        "inherits": "~2.0.3",
-        "isarray": "~1.0.0",
-        "process-nextick-args": "~2.0.0",
-        "safe-buffer": "~5.1.1",
-        "string_decoder": "~1.1.1",
-        "util-deprecate": "~1.0.1"
-      }
-    },
-    "remove-trailing-separator": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/remove-trailing-separator/-/remove-trailing-separator-1.1.0.tgz",
-      "integrity": "sha1-wkvOKig62tW8P1jg1IJJuSN52O8=",
-      "dev": true
-    },
-    "replace-ext": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/replace-ext/-/replace-ext-1.0.0.tgz",
-      "integrity": "sha1-3mMSg3P8v3w8z6TeWkgMRaZ5WOs=",
-      "dev": true
-    },
-    "safe-buffer": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
-      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g=="
-    },
-    "smartchai": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/smartchai/-/smartchai-2.0.1.tgz",
-      "integrity": "sha512-9M+R56OhAHXScxgr2vzQqxGx0XMS0QXriNZuP7hjlbVbo2FUT+l60iEzbwPt9Ga+5u2cEEjSSoZEQVqlROaddA==",
-      "dev": true,
-      "requires": {
-        "@types/chai": "^4.1.2",
-        "@types/chai-as-promised": "^7.1.0",
-        "@types/chai-string": "^1.4.0",
-        "chai": "^4.1.2",
-        "chai-as-promised": "^7.1.1",
-        "chai-string": "^1.4.0"
-      }
-    },
-    "source-map": {
-      "version": "0.6.1",
-      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
-      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
-      "dev": true
-    },
-    "source-map-support": {
-      "version": "0.5.6",
-      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.6.tgz",
-      "integrity": "sha512-N4KXEz7jcKqPf2b2vZF11lQIz9W5ZMuUcIOGj243lduidkf2fjkVKJS9vNxVWn3u/uxX38AcE8U9nnH9FPcq+g==",
-      "dev": true,
-      "requires": {
-        "buffer-from": "^1.0.0",
-        "source-map": "^0.6.0"
-      }
-    },
-    "sprintf-js": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
-      "integrity": "sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw=",
-      "dev": true
-    },
-    "string_decoder": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
-      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
-      "requires": {
-        "safe-buffer": "~5.1.0"
-      }
-    },
-    "strip-bom": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-2.0.0.tgz",
-      "integrity": "sha1-YhmoVhZSBJHzV4i9vxRHqZx+aw4=",
-      "dev": true,
-      "requires": {
-        "is-utf8": "^0.2.0"
-      }
-    },
-    "strip-bom-buf": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom-buf/-/strip-bom-buf-1.0.0.tgz",
-      "integrity": "sha1-HLRar1dTD0yvhsf3UXnSyaUd1XI=",
-      "dev": true,
-      "requires": {
-        "is-utf8": "^0.2.1"
-      }
-    },
-    "strip-bom-stream": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/strip-bom-stream/-/strip-bom-stream-2.0.0.tgz",
-      "integrity": "sha1-+H217yYT9paKpUWr/h7HKLaoKco=",
-      "dev": true,
-      "requires": {
-        "first-chunk-stream": "^2.0.0",
-        "strip-bom": "^2.0.0"
-      }
-    },
-    "through2": {
-      "version": "2.0.3",
-      "resolved": "https://registry.npmjs.org/through2/-/through2-2.0.3.tgz",
-      "integrity": "sha1-AARWmzfHx0ujnEPzzteNGtlBQL4=",
-      "requires": {
-        "readable-stream": "^2.1.5",
-        "xtend": "~4.0.1"
-      }
-    },
-    "ts-node": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-7.0.0.tgz",
-      "integrity": "sha512-klJsfswHP0FuOLsvBZ/zzCfUvakOSSxds78mVeK7I+qP76YWtxf16hEZsp3U+b0kIo82R5UatGFeblYMqabb2Q==",
-      "dev": true,
-      "requires": {
-        "arrify": "^1.0.0",
-        "buffer-from": "^1.1.0",
-        "diff": "^3.1.0",
-        "make-error": "^1.1.1",
-        "minimist": "^1.2.0",
-        "mkdirp": "^0.5.1",
-        "source-map-support": "^0.5.6",
-        "yn": "^2.0.0"
-      }
-    },
-    "type-detect": {
-      "version": "4.0.8",
-      "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.0.8.tgz",
-      "integrity": "sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==",
-      "dev": true
-    },
-    "typescript": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-3.0.1.tgz",
-      "integrity": "sha512-zQIMOmC+372pC/CCVLqnQ0zSBiY7HHodU7mpQdjiZddek4GMj31I3dUJ7gAs9o65X7mnRma6OokOkc6f9jjfBg==",
-      "dev": true
-    },
-    "universalify": {
-      "version": "0.1.2",
-      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
-      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
-      "dev": true
-    },
-    "util-deprecate": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
-      "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8="
-    },
-    "vinyl": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/vinyl/-/vinyl-2.2.0.tgz",
-      "integrity": "sha512-MBH+yP0kC/GQ5GwBqrTPTzEfiiLjta7hTtvQtbxBgTeSXsmKQRQecjibMbxIXzVT3Y9KJK+drOz1/k+vsu8Nkg==",
-      "dev": true,
-      "requires": {
-        "clone": "^2.1.1",
-        "clone-buffer": "^1.0.0",
-        "clone-stats": "^1.0.0",
-        "cloneable-readable": "^1.0.0",
-        "remove-trailing-separator": "^1.0.1",
-        "replace-ext": "^1.0.0"
-      }
-    },
-    "vinyl-file": {
-      "version": "3.0.0",
-      "resolved": "https://registry.npmjs.org/vinyl-file/-/vinyl-file-3.0.0.tgz",
-      "integrity": "sha1-sQTZ5ECf+jJfqt1SBkLQo7SIs2U=",
-      "dev": true,
-      "requires": {
-        "graceful-fs": "^4.1.2",
-        "pify": "^2.3.0",
-        "strip-bom-buf": "^1.0.0",
-        "strip-bom-stream": "^2.0.0",
-        "vinyl": "^2.0.1"
-      }
-    },
-    "which": {
-      "version": "1.3.1",
-      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
-      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
-      "dev": true,
-      "requires": {
-        "isexe": "^2.0.0"
-      }
-    },
-    "wrappy": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
-      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=",
-      "dev": true
-    },
-    "xtend": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.1.tgz",
-      "integrity": "sha1-pcbVMr5lbiPbgg77lDofBJmNY68="
-    },
-    "yn": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/yn/-/yn-2.0.0.tgz",
-      "integrity": "sha1-5a2ryKz0CPY4X8dklWhMiOavaJo=",
-      "dev": true
-    }
-  }
-}
--- a/package.json
+++ b/package.json
@@ -1,28 +1,62 @@
 {
-  "name": "@pushrocks/smartcache",
-  "version": "1.0.9",
+  "name": "@push.rocks/smartcache",
+  "version": "1.0.17",
  "private": false,
-  "description": "cache things in smart ways",
-  "main": "dist/index.js",
-  "typings": "dist/index.d.ts",
+  "description": "A module for caching asynchronous function results with smart time and hash-based invalidation strategies.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
  "author": "Lossless GmbH",
  "license": "MIT",
  "scripts": {
-    "test": "(tstest test/)",
-    "build": "(tsbuild)"
+    "test": "(tstest test/ --verbose --logfile --timeout 60)",
+    "build": "(tsbuild tsfolders)",
+    "buildDocs": "tsdoc"
  },
  "devDependencies": {
-    "@gitzone/tsbuild": "^2.0.22",
-    "@gitzone/tsrun": "^1.1.12",
-    "@gitzone/tstest": "^1.0.15",
-    "@pushrocks/tapbundle": "^3.0.7",
-    "@types/node": "^10.9.4"
+    "@git.zone/tsbuild": "^2.1.63",
+    "@git.zone/tsrun": "^1.2.37",
+    "@git.zone/tstest": "^2.3.5",
+    "@types/node": "^18.0.0"
  },
  "dependencies": {
-    "@pushrocks/smartdelay": "^2.0.2",
-    "@pushrocks/smarterror": "^2.0.1",
-    "@pushrocks/smarthash": "^2.0.0",
-    "@pushrocks/smartpromise": "^2.0.5",
-    "@pushrocks/smarttime": "^2.0.2"
-  }
+    "@push.rocks/smartdelay": "^3.0.5",
+    "@push.rocks/smarterror": "^2.0.1",
+    "@push.rocks/smarthash": "^3.0.1",
+    "@push.rocks/smartpromise": "^4.2.3",
+    "@push.rocks/smarttime": "^4.0.1"
+  },
+  "files": [
+    "ts/**/*",
+    "ts_web/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "assets/**/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "type": "module",
+  "keywords": [
+    "caching",
+    "asynchronous",
+    "time-based invalidation",
+    "hash-based identification",
+    "smart caching",
+    "node.js",
+    "performance optimization",
+    "typescript",
+    "delay handling",
+    "error management"
+  ],
+  "homepage": "https://code.foss.global/push.rocks/smartcache",
+  "repository": {
+    "type": "git",
+    "url": "https://code.foss.global/push.rocks/smartcache.git"
+  },
+  "packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748"
 }
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -0,0 +1,4 @@
+onlyBuiltDependencies:
+  - esbuild
+  - mongodb-memory-server
+  - puppeteer
--- a/readme.hints.md
+++ b/readme.hints.md
@@ -0,0 +1 @@
+ 
--- a/readme.md
+++ b/readme.md
@@ -0,0 +1,335 @@
+# @push.rocks/smartcache 🚀
+**Smart time-based caching for async functions** - Because waiting is overrated!
+
+## 🌟 What is SmartCache?
+
+`@push.rocks/smartcache` is a powerful TypeScript caching library that intelligently caches the results of asynchronous functions. It automatically detects identical function calls based on the call stack, preventing redundant computations and dramatically improving performance. Perfect for expensive API calls, complex calculations, or any async operation you don't want to repeat unnecessarily!
+
+### ✨ Key Features
+
+- 🎯 **Automatic cache identification** - Uses smart hashing to detect identical function calls
+- ⏱️ **Time-based expiration** - Set custom cache durations for each cached operation
+- 🔄 **Concurrent request handling** - Multiple simultaneous requests for the same data only trigger one actual call
+- 🎭 **Zero configuration** - Works out of the box with sensible defaults
+- 📦 **Lightweight** - Minimal dependencies, maximum performance
+- 🔒 **Type-safe** - Full TypeScript support with proper typing
+
+## 📦 Installation
+
+Get started in seconds:
+
+```bash
+# Using npm
+npm install @push.rocks/smartcache --save
+
+# Using pnpm (recommended)
+pnpm add @push.rocks/smartcache
+
+# Using yarn
+yarn add @push.rocks/smartcache
+```
+
+## 🎮 Quick Start
+
+```typescript
+import { SmartCache } from '@push.rocks/smartcache';
+
+// Create a cache instance
+const cache = new SmartCache();
+
+// Your expensive async function
+async function fetchUserData(userId: string) {
+  console.log(`Fetching user ${userId} from API...`);
+  const response = await fetch(`/api/users/${userId}`);
+  return response.json();
+}
+
+// Wrap it with caching - subsequent calls within 5 seconds return cached result
+async function getCachedUserData(userId: string) {
+  return cache.cacheReturn(
+    () => fetchUserData(userId),
+    5000 // Cache for 5 seconds
+  );
+}
+
+// First call - hits the API
+const user1 = await getCachedUserData('123'); // Logs: "Fetching user 123 from API..."
+
+// Second call within 5 seconds - returns cached result instantly!
+const user2 = await getCachedUserData('123'); // No log, returns cached data
+```
+
+## 🚀 Advanced Usage
+
+### Automatic Call Stack Detection
+
+SmartCache uses intelligent call stack analysis to automatically identify unique function calls. This means you don't need to manually specify cache keys!
+
+```typescript
+const cache = new SmartCache();
+
+// These will be automatically cached separately based on their call location
+async function getData() {
+  // First location in code
+  const result1 = await cache.cacheReturn(async () => {
+    return await fetch('/api/data1').then(r => r.json());
+  }, 10000);
+
+  // Second location in code - different cache entry!
+  const result2 = await cache.cacheReturn(async () => {
+    return await fetch('/api/data2').then(r => r.json());
+  }, 10000);
+  
+  return { result1, result2 };
+}
+```
+
+### Concurrent Request Handling
+
+SmartCache brilliantly handles concurrent requests - if multiple requests come in for the same cached operation before the first one completes, they all wait for and share the same result:
+
+```typescript
+const cache = new SmartCache();
+
+async function expensiveOperation() {
+  console.log('Starting expensive operation...');
+  await new Promise(resolve => setTimeout(resolve, 2000));
+  return { data: 'valuable result' };
+}
+
+// Fire off 5 concurrent requests
+const promises = Array(5).fill(null).map(() => 
+  cache.cacheReturn(expensiveOperation, 60000)
+);
+
+// Only ONE "Starting expensive operation..." log appears!
+// All 5 requests get the same result
+const results = await Promise.all(promises);
+```
+
+### Dynamic Cache Durations
+
+Adjust cache duration based on your data's characteristics:
+
+```typescript
+const cache = new SmartCache();
+
+async function getDataWithVariableCache(dataType: string) {
+  // Critical data - short cache
+  if (dataType === 'critical') {
+    return cache.cacheReturn(fetchCriticalData, 1000); // 1 second
+  }
+  
+  // Static data - long cache
+  if (dataType === 'static') {
+    return cache.cacheReturn(fetchStaticData, 3600000); // 1 hour
+  }
+  
+  // Default - moderate cache
+  return cache.cacheReturn(fetchNormalData, 60000); // 1 minute
+}
+```
+
+### Cache Different Function Results
+
+Each function call location gets its own cache entry:
+
+```typescript
+const cache = new SmartCache();
+
+class DataService {
+  async getUserPosts(userId: string) {
+    // Cached separately from getUserProfile
+    return cache.cacheReturn(
+      async () => {
+        const response = await fetch(`/api/users/${userId}/posts`);
+        return response.json();
+      },
+      30000 // Cache for 30 seconds
+    );
+  }
+  
+  async getUserProfile(userId: string) {
+    // Different cache entry than getUserPosts
+    return cache.cacheReturn(
+      async () => {
+        const response = await fetch(`/api/users/${userId}/profile`);
+        return response.json();
+      },
+      60000 // Cache for 60 seconds
+    );
+  }
+}
+```
+
+## 🎯 Real-World Examples
+
+### API Rate Limiting Helper
+
+Prevent hitting rate limits by caching API responses:
+
+```typescript
+const cache = new SmartCache();
+
+class GitHubService {
+  async getRepoInfo(owner: string, repo: string) {
+    return cache.cacheReturn(
+      async () => {
+        const response = await fetch(
+          `https://api.github.com/repos/${owner}/${repo}`,
+          { headers: { 'Authorization': `token ${process.env.GITHUB_TOKEN}` } }
+        );
+        return response.json();
+      },
+      300000 // Cache for 5 minutes - respect API limits
+    );
+  }
+}
+```
+
+### Database Query Optimization
+
+Cache expensive database queries:
+
+```typescript
+const cache = new SmartCache();
+
+class DatabaseService {
+  async getTopProducts(category: string) {
+    return cache.cacheReturn(
+      async () => {
+        // Expensive aggregation query
+        const products = await db.products.aggregate([
+          { $match: { category } },
+          { $group: { _id: '$productId', totalSales: { $sum: '$sales' } } },
+          { $sort: { totalSales: -1 } },
+          { $limit: 10 }
+        ]);
+        return products;
+      },
+      120000 // Cache for 2 minutes - data doesn't change often
+    );
+  }
+}
+```
+
+### Computed Values Cache
+
+Cache expensive computations:
+
+```typescript
+const cache = new SmartCache();
+
+class AnalyticsService {
+  async calculateMetrics(data: number[]) {
+    return cache.cacheReturn(
+      async () => {
+        console.log('Running expensive calculation...');
+        // Simulate expensive computation
+        const result = {
+          mean: data.reduce((a, b) => a + b, 0) / data.length,
+          median: this.calculateMedian(data),
+          standardDeviation: this.calculateStdDev(data),
+          percentiles: this.calculatePercentiles(data)
+        };
+        return result;
+      },
+      600000 // Cache for 10 minutes
+    );
+  }
+  
+  private calculateMedian(data: number[]) { /* ... */ }
+  private calculateStdDev(data: number[]) { /* ... */ }
+  private calculatePercentiles(data: number[]) { /* ... */ }
+}
+```
+
+## 📊 Performance Benefits
+
+SmartCache can dramatically improve your application's performance:
+
+- 🚀 **Reduce API calls** by up to 90% for frequently accessed data
+- ⚡ **Instant responses** for cached data (sub-millisecond)
+- 📉 **Lower server costs** by reducing redundant computations
+- 🛡️ **Protect against thundering herd** problems
+- 🔄 **Automatic cleanup** - expired cache entries are removed automatically
+
+## 🏗️ Architecture & How It Works
+
+SmartCache uses a sophisticated approach to caching:
+
+1. **Call Stack Hashing**: When you call `cacheReturn`, SmartCache captures the call stack and generates a SHA-256 hash
+2. **Cache Lookup**: It checks if a valid cached result exists for this hash
+3. **Concurrent Protection**: If a request is in-flight, new requests wait for the same result
+4. **Automatic Expiration**: Each cache entry has a timer that automatically removes it when expired
+5. **Memory Efficient**: Only stores what's actively being used, expired entries are cleaned up
+
+## 💡 Best Practices
+
+### ✅ Do's
+
+- **Cache expensive operations** - API calls, database queries, complex calculations
+- **Use appropriate durations** - Match cache time to your data's update frequency
+- **Cache at the right level** - Cache complete results, not partial data
+- **Monitor memory usage** - Be mindful when caching large objects
+
+### ❌ Don'ts
+
+- **Don't cache user-specific sensitive data** without careful consideration
+- **Don't use excessive cache durations** for frequently changing data
+- **Don't cache massive objects** that could cause memory issues
+- **Don't rely on cache** for critical data consistency
+
+## 🎓 Pro Tips
+
+1. **Layer your caching**: Use SmartCache alongside CDN and database caching for maximum effect
+2. **Cache warming**: Pre-populate cache with frequently accessed data on startup
+3. **Metrics tracking**: Monitor cache hit rates to optimize cache durations
+4. **Error handling**: Always handle potential errors in cached functions
+
+```typescript
+const cache = new SmartCache();
+
+// Good - with error handling
+async function getResilientData() {
+  return cache.cacheReturn(
+    async () => {
+      try {
+        const response = await fetch('/api/data');
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        return response.json();
+      } catch (error) {
+        console.error('Failed to fetch data:', error);
+        // Return fallback or rethrow based on your needs
+        throw error;
+      }
+    },
+    30000
+  );
+}
+```
+
+## 🤝 Support & Community
+
+- 🐛 **Found a bug?** [Open an issue](https://code.foss.global/push.rocks/smartcache/issues)
+- 💡 **Have a feature request?** [Start a discussion](https://code.foss.global/push.rocks/smartcache/issues)
+- 📖 **Need help?** Check our [comprehensive documentation](https://code.foss.global/push.rocks/smartcache)
+
+## License and Legal Information
+
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
+
+### Company Information
+
+Task Venture Capital GmbH  
+Registered at District court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
--- a/test/test.ts
+++ b/test/test.ts
@@ -1,51 +1,54 @@
-import { expect, tap } from "@pushrocks/tapbundle";
-import * as smartcache from "../ts/index";
-import * as smartdelay from "@pushrocks/smartdelay";
+import { expect, tap } from '@git.zone/tstest/tapbundle';
+import * as smartcache from '../ts/index.js';

 let smartcacheInstance: smartcache.SmartCache;

-tap.test("should create a valid instance of SmartCache", async () => {
+tap.test('should create a valid instance of SmartCache', async () => {
  smartcacheInstance = new smartcache.SmartCache();
-  expect(smartcacheInstance).to.be.instanceof(smartcache.SmartCache);
+  expect(smartcacheInstance).toBeInstanceOf(smartcache.SmartCache);
 });

-tap.test("try to get async responses", async () => {
+tap.test('try to get async responses', async (toolsArg) => {
+  let response1Counter = 0;
  const getResponse = async () => {
    const response = await smartcacheInstance
      .cacheReturn(async () => {
-        console.log("function ran");
-        return "hello";
+        console.log('function 1 ran');
+        response1Counter++;
+        return 'hello';
      }, 1000)
-      .catch(err => {
+      .catch((err) => {
        console.log(err);
      });
-    console.log("response is:");
+    console.log('response is:');
    console.log(response);
  };

+  let response2Counter = 0;
  const getResponse2 = async () => {
    const response = await smartcacheInstance
      .cacheReturn(async () => {
-        console.log("function 2 ran");
-        return "hello";
+        console.log('function 2 ran');
+        response2Counter++;
+        return 'hello there!';
      }, 1000)
-      .catch(err => {
+      .catch((err) => {
        console.log(err);
      });
-    console.log("response is:");
+    console.log('response is:');
    console.log(response);
  };

-  getResponse();
-  getResponse();
-  getResponse2();
-  getResponse2();
-  smartdelay.delayFor(1000).then(() => {
-    getResponse();
-    // getResponse2();
-  });
+  await getResponse();
+  await getResponse();
+  await getResponse2();
+  await getResponse2();
+  await toolsArg.delayFor(500);
+  await getResponse();
+  await toolsArg.delayFor(2000);
+  await getResponse2();
 });

 tap.start({
-  throwOnError: true
+  throwOnError: true,
 });
--- a/ts/00_commitinfo_data.ts
+++ b/ts/00_commitinfo_data.ts
@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@push.rocks/smartcache',
+  version: '1.0.17',
+  description: 'A module for caching asynchronous function results with smart time and hash-based invalidation strategies.'
+}
--- a/ts/index.ts
+++ b/ts/index.ts
@@ -1 +1 @@
-export * from './smartcache.classes.smartcache';
+export * from './smartcache.classes.smartcache.js';
--- a/ts/smartcache.classes.cachemanager.ts
+++ b/ts/smartcache.classes.cachemanager.ts
@@ -1,5 +1,5 @@
-import * as plugins from './smartcache.plugins';
-import { SmartError } from '@pushrocks/smarterror';
+import * as plugins from './smartcache.plugins.js';
+import { SmartError } from '@push.rocks/smarterror';

 export interface ICacheMap {
  [key: string]: {
@@ -12,7 +12,7 @@ export interface ICacheMap {
 export class CacheManager {
  private _cacheMap: ICacheMap = {};

-  cacheExists(identifierArg): boolean {
+  cacheExists(identifierArg: string): boolean {
    if (this._cacheMap[identifierArg]) {
      return true;
    }
@@ -36,7 +36,7 @@ export class CacheManager {
    this._cacheMap[identifierArg] = {
      timer: new plugins.smarttime.Timer(validForArg),
      cachedDeferred: new plugins.smartpromise.Deferred(),
-      cachedObject: null
+      cachedObject: null,
    };
    this._cacheMap[identifierArg].timer.start();
    this._cacheMap[identifierArg].timer.completed.then(() => {
--- a/ts/smartcache.classes.smartcache.ts
+++ b/ts/smartcache.classes.smartcache.ts
@@ -1,12 +1,14 @@
-import * as plugins from './smartcache.plugins';
-import { CacheManager } from './smartcache.classes.cachemanager';
+import * as plugins from './smartcache.plugins.js';
+import { CacheManager } from './smartcache.classes.cachemanager.js';

 export class SmartCache {
  private _cacheManager = new CacheManager();

  async cacheReturn(asyncCachedFuncArg: () => Promise<any>, cacheDuration: number = 5000) {
-    let callStack: string = new plugins.smarterror.SmartError('').cleanFullStack;
-    let callHash = plugins.smarthash.sha256FromStringSync(callStack);
+    const callStack: string = new plugins.smarterror.SmartError(
+      'Cache Creation Point'
+    ).cleanFullStack.split('\n')[2];
+    const callHash = plugins.smarthash.sha256FromStringSync(callStack);

    // console.log(callHash);
    if (
@@ -17,7 +19,7 @@ export class SmartCache {
      return this._cacheManager.getCache(callHash).cachedObject;
    } else {
      this._cacheManager.announceCache(callHash, cacheDuration);
-      let newCachedObject = await asyncCachedFuncArg();
+      const newCachedObject = await asyncCachedFuncArg();
      this._cacheManager.setCache(callHash, newCachedObject, cacheDuration);
      return newCachedObject;
    }
--- a/ts/smartcache.plugins.ts
+++ b/ts/smartcache.plugins.ts
@@ -1,7 +1,7 @@
-import * as smartdelay from '@pushrocks/smartdelay';
-import * as smarterror from '@pushrocks/smarterror';
-import * as smartpromise from '@pushrocks/smartpromise';
-import * as smarttime from '@pushrocks/smarttime';
-import * as smarthash from '@pushrocks/smarthash';
+import * as smartdelay from '@push.rocks/smartdelay';
+import * as smarterror from '@push.rocks/smarterror';
+import * as smartpromise from '@push.rocks/smartpromise';
+import * as smarttime from '@push.rocks/smarttime';
+import * as smarthash from '@push.rocks/smarthash';

 export { smarterror, smartdelay, smartpromise, smarttime, smarthash };
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false,
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true
+  },
+  "exclude": [
+    "dist_*/**/*.d.ts"
+  ]
+}
--- a/tslint.json
+++ b/tslint.json
@@ -1,3 +0,0 @@
-{
-    "extends": "tslint-config-standard"
-}
Author	SHA1	Message	Date
Juergen Kunz	0657770c5d	1.0.17	2025-08-26 19:42:20 +00:00
Juergen Kunz	a698d6cd35	fix(package): Update dependency scopes/versions, fix imports and scripts, add pnpm workspace, remove GitLab CI	2025-08-26 19:42:20 +00:00
Philipp Kunz	428f159ff7	update description	2024-05-29 14:11:59 +02:00
Philipp Kunz	abfa1e1c70	update tsconfig	2024-04-14 17:23:41 +02:00
Philipp Kunz	57c2e33a6c	update npmextra.json: githost	2024-04-01 21:34:01 +02:00
Philipp Kunz	b0fa7931a8	update npmextra.json: githost	2024-04-01 19:57:45 +02:00
Philipp Kunz	53d9f8bce1	update npmextra.json: githost	2024-03-30 21:46:42 +01:00
Philipp Kunz	6e7205d788	switch to new org scheme	2023-07-11 00:17:21 +02:00
Philipp Kunz	c57d76376d	switch to new org scheme	2023-07-10 02:42:23 +02:00
Philipp Kunz	b6c4ef568a	1.0.16	2023-01-08 09:18:41 +01:00
Philipp Kunz	c7682e4cc5	fix(core): update	2023-01-08 09:18:41 +01:00
Philipp Kunz	677b07a176	1.0.15	2022-06-26 20:36:23 +02:00
Philipp Kunz	0e11d0e760	fix(core): update	2022-06-26 20:36:22 +02:00
Phil Kunz	1f80df6ec2	1.0.14	2021-04-21 19:52:53 +00:00
Phil Kunz	05997ef1cf	fix(core): update	2021-04-21 19:52:53 +00:00
Phil Kunz	dc5a93b3a2	1.0.13	2020-02-03 20:08:58 +00:00
Phil Kunz	51c1759961	fix(core): update	2020-02-03 20:08:57 +00:00
Phil Kunz	b5667be823	1.0.12	2019-10-23 19:21:28 +02:00
Phil Kunz	f147d48655	fix(core): update	2019-10-23 19:21:27 +02:00
Phil Kunz	9eec43044d	1.0.11	2018-12-02 15:39:52 +01:00
Phil Kunz	4df1274094	fix(core): update	2018-12-02 15:39:52 +01:00
Phil Kunz	1edda548a1	1.0.10	2018-12-02 15:34:05 +01:00
Phil Kunz	c94b5e0009	fix(tests): update	2018-12-02 15:34:05 +01:00