fix(core): Update CI workflows and dependencies; apply small bugfixes and formatting improvements

.gitea/workflows/default_nottags.yaml

@@ -6,8 +6,8 @@ on:
       - '**'
 
 env:
-  IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
-  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
+  IMAGE: code.foss.global/host.today/ht-docker-node:npmci
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@/${{gitea.repository}}.git
   NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
   NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
   NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
@@ -26,7 +26,7 @@ jobs:
       - name: Install pnpm and npmci
         run: |
           pnpm install -g pnpm
-          pnpm install -g @shipzone/npmci
+          pnpm install -g @ship.zone/npmci
 
       - name: Run npm prepare
         run: npmci npm prepare

.gitea/workflows/default_tags.yaml

@@ -6,8 +6,8 @@ on:
       - '*'
 
 env:
-  IMAGE: registry.gitlab.com/hosttoday/ht-docker-node:npmci
-  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@gitea.lossless.digital/${{gitea.repository}}.git
+  IMAGE: code.foss.global/host.today/ht-docker-node:npmci
+  NPMCI_COMPUTED_REPOURL: https://${{gitea.repository_owner}}:${{secrets.GITEA_TOKEN}}@/${{gitea.repository}}.git
   NPMCI_TOKEN_NPM: ${{secrets.NPMCI_TOKEN_NPM}}
   NPMCI_TOKEN_NPM2: ${{secrets.NPMCI_TOKEN_NPM2}}
   NPMCI_GIT_GITHUBTOKEN: ${{secrets.NPMCI_GIT_GITHUBTOKEN}}
@@ -26,7 +26,7 @@ jobs:
       - name: Prepare
         run: |
           pnpm install -g pnpm
-          pnpm install -g @shipzone/npmci
+          pnpm install -g @ship.zone/npmci
           npmci npm prepare
 
       - name: Audit production dependencies
@@ -54,7 +54,7 @@ jobs:
       - name: Prepare
         run: |
           pnpm install -g pnpm
-          pnpm install -g @shipzone/npmci
+          pnpm install -g @ship.zone/npmci
           npmci npm prepare
 
       - name: Test stable
@@ -82,7 +82,7 @@ jobs:
       - name: Prepare
         run: |
           pnpm install -g pnpm
-          pnpm install -g @shipzone/npmci
+          pnpm install -g @ship.zone/npmci
           npmci npm prepare
 
       - name: Release
@@ -104,7 +104,7 @@ jobs:
       - name: Prepare
         run: |
           pnpm install -g pnpm
-          pnpm install -g @shipzone/npmci
+          pnpm install -g @ship.zone/npmci
           npmci npm prepare
 
       - name: Code quality

.gitignore

@@ -3,7 +3,6 @@
 # artifacts
 coverage/
 public/
-pages/
 
 # installs
 node_modules/
@@ -17,4 +16,8 @@ node_modules/
 dist/
 dist_*/
 
-# custom
+# AI
+.claude/
+.serena/
+
+#------# custom

changelog.md

@@ -1,12 +1,27 @@
 # Changelog
 
+## 2025-08-28 - 3.1.2 - fix(core)
+Update CI workflows and dependencies; apply small bugfixes and formatting improvements
+
+- Update Gitea workflow image URL and computed repo URL to internal registry and simplified repo path
+- Switch npmci install target from @shipzone/npmci to @ship.zone/npmci in CI scripts
+- Bump devDependencies and dependencies to newer versions (tsbuild, tstest, tapbundle, lik, smartbucket, smartfile, smartpath, smartpromise, taskbuffer, tsclass, etc.)
+- Add package metadata: homepage anchor, packageManager, bugs URL and pnpm overrides block
+- Fix TypeScript formatting and signatures (consistent trailing commas, multiline parameter lists, path join argument formatting)
+- Fix file system and S3 manager calls to ensure consistent path handling and argument formatting (improved encoding/consistency in disk and S3 managers)
+- Correct test file syntax (object commas) to avoid runtime/parse issues
+- Update .gitignore to add AI tool folders and reorganize custom section
+- Add pnpm-workspace.yaml with onlyBuiltDependencies entry
+
 ## 2024-11-26 - 3.1.1 - fix(core)
+
 Fix S3 cache manager methods for better path encoding consistency
 
 - Corrected path parameter usage in S3 manager methods to ensure encoding and consistency.
 - Updated package.json Git dependencies for scoped packages.
 
 ## 2024-11-24 - 3.1.0 - feat(core)
+
 Enhanced caching solution with optional configurations and improved documentation.
 
 - Improved package description and keywords for better discoverability.
@@ -15,6 +30,7 @@ Enhanced caching solution with optional configurations and improved documentatio
 - Enhanced README with detailed usage instructions and examples.
 
 ## 2024-05-29 to 2024-02-14 - 3.0.8
+
 Minor configuration updates and documentation changes.
 
 - Updated project description.
@@ -22,54 +38,65 @@ Minor configuration updates and documentation changes.
 - Adjustments to npmextra.json regarding githost.
 
 ## 2024-02-14 - 3.0.7
+
 Core enhancements and bug fixes.
 
 - Fixed updates in the core module to improve stability.
 
 ## 2024-02-14 - 3.0.6
+
 Core maintenance and updates.
 
 - Implemented minor fixes in the core module.
 
 ## 2023-07-21 - 3.0.5
+
 Addressed core module adjustments.
 
 - Patched core module to rectify issues.
 
 ## 2023-07-20 - 3.0.4
+
 Further improvements to core functionality.
 
 - Additional fixes applied to the core component.
 
 ## 2023-07-11 to 2023-07-10 - 3.0.3
+
 Organizational and structural changes.
 
 - Transitioned to a new organizational scheme.
 
 ## 2023-01-09 - 3.0.2
+
 Core module corrections.
 
 - Resolved various issues within the core module.
 
 ## 2022-06-09 - 3.0.1
+
 Continuous enhancements in core functionality.
 
 - Continued bug fixes for core module efficiency.
 
 ## 2022-04-04 to 2022-04-02 - 3.0.0
+
 Major release with significant updates.
 
 ## 2022-03-22 - 2.0.0
+
 Significant breaking changes in core tech stack.
 
 - BREAKING CHANGE: Transitioned core module to ECMAScript Modules (ESM).
 
 ## 2021-05-10 - 1.0.9
+
 Caching improvements and optimization.
 
 - Enhanced caching by properly respecting TTL across all cache levels.
 
 ## 2020-02-15 to 2020-02-05 - 1.0.6 to 1.0.1
+
 Initial series of core module fixes and updates.
 
 - Persistent efforts to stabilize and improve core functionalities.

npmextra.json

@@ -32,4 +32,4 @@
   "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"
   }
-}
+}

package.json

@@ -15,26 +15,26 @@
     "localPublish": "gitzone commit && pnpm run build && pnpm publish && pnpm publish --access public --registry=\"https://registry.npmjs.org\""
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.1.66",
+    "@git.zone/tsbuild": "^2.6.7",
     "@git.zone/tsrun": "^1.2.44",
-    "@git.zone/tstest": "^1.0.77",
-    "@push.rocks/tapbundle": "^5.5.3",
-    "@types/node": "^22.9.3"
+    "@git.zone/tstest": "^2.3.5",
+    "@push.rocks/tapbundle": "^6.0.3",
+    "@types/node": "^24.3.0"
   },
   "dependencies": {
-    "@push.rocks/lik": "^6.1.0",
-    "@push.rocks/smartbucket": "^3.3.3",
-    "@push.rocks/smartcache": "^1.0.13",
-    "@push.rocks/smartenv": "^5.0.12",
+    "@push.rocks/lik": "^6.2.2",
+    "@push.rocks/smartbucket": "^3.3.10",
+    "@push.rocks/smartcache": "^1.0.17",
+    "@push.rocks/smartenv": "^5.0.13",
     "@push.rocks/smartexit": "^1.0.23",
-    "@push.rocks/smartfile": "^11.0.21",
+    "@push.rocks/smartfile": "^11.2.7",
     "@push.rocks/smartjson": "^5.0.20",
-    "@push.rocks/smartpath": "^5.0.18",
-    "@push.rocks/smartpromise": "^4.0.4",
+    "@push.rocks/smartpath": "^6.0.0",
+    "@push.rocks/smartpromise": "^4.2.3",
     "@push.rocks/smartstring": "^4.0.15",
     "@push.rocks/smartunique": "^3.0.9",
-    "@push.rocks/taskbuffer": "^3.1.7",
-    "@tsclass/tsclass": "^4.1.2"
+    "@push.rocks/taskbuffer": "^3.1.10",
+    "@tsclass/tsclass": "^9.2.0"
   },
   "files": [
     "ts/**/*",
@@ -65,9 +65,16 @@
     "Node.js",
     "TypeScript"
   ],
-  "homepage": "https://code.foss.global/push.rocks/levelcache",
+  "homepage": "https://code.foss.global/push.rocks/levelcache#readme",
   "repository": {
     "type": "git",
     "url": "https://code.foss.global/push.rocks/levelcache.git"
+  },
+  "packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748",
+  "bugs": {
+    "url": "https://code.foss.global/push.rocks/levelcache/issues"
+  },
+  "pnpm": {
+    "overrides": {}
   }
 }

pnpm-workspace.yaml

@@ -0,0 +1,4 @@
+onlyBuiltDependencies:
+  - esbuild
+  - mongodb-memory-server
+  - puppeteer

readme.md

@@ -1,13 +1,17 @@
 # @push.rocks/levelcache
+
 A cache that utilizes memory, disk, and S3 for data storage and backup.
 
 ## Install
+
 To install `@push.rocks/levelcache`, you can use npm or yarn:
 
 ```bash
 npm install @push.rocks/levelcache --save
 ```
+
 or
+
 ```bash
 yarn add @push.rocks/levelcache
 ```
@@ -43,7 +47,7 @@ const myCache = new LevelCache({
   s3Config: {
     accessKeyId: 'yourAccessKeyId', // AWS S3 access key
     secretAccessKey: 'yourSecretAccessKey', // Corresponding secret key
-    region: 'us-west-2' // AWS region, e.g., 'us-west-2'
+    region: 'us-west-2', // AWS region, e.g., 'us-west-2'
   },
   s3BucketName: 'myBucketName', // Designated name for S3 bucket
   immutableCache: false, // Whether stored cache entries should remain unaltered
@@ -155,7 +159,7 @@ With intelligent routing and management embedded, `LevelCache` ensures optimal t
 
 ## 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. 
+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.
 

test/test.ts

@@ -18,7 +18,7 @@ tap.test('should cache a value', async () => {
       contents: Buffer.from('heythere'),
       ttl: 10000,
       typeInfo: 'string',
-    })
+    }),
   );
   const result = await testLevelCache.retrieveCacheEntryByKey('mykey');
   expect(result.contents.toString()).toEqual('heythere');
@@ -31,7 +31,7 @@ tap.test('should respect ttl', async (tools) => {
       contents: Buffer.from('heythere'),
       ttl: 1000,
       typeInfo: 'string',
-    })
+    }),
   );
   const result = await testLevelCache.retrieveCacheEntryByKey('mykey');
   expect(result.contents.toString()).toEqual('heythere');

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/levelcache',
-  version: '3.1.1',
+  version: '3.1.2',
   description: 'A versatile caching solution offering multi-level storage utilizing memory, disk, and Amazon S3 for efficient data management and backup.'
 }

ts/levelcache.abstract.classes.cache.ts

@@ -8,7 +8,10 @@ export abstract class AbstractCache {
   /**
    * store a Blob
    */
-  public abstract storeCacheEntryByKey(keyArg: string, valueArg: CacheEntry): Promise<void>;
+  public abstract storeCacheEntryByKey(
+    keyArg: string,
+    valueArg: CacheEntry,
+  ): Promise<void>;
 
   /**
    * retrieve cache entry

ts/levelcache.classes.cache.diskmanager.ts

@@ -1,7 +1,10 @@
 import * as plugins from './levelcache.plugins.js';
 import * as paths from './levelcache.paths.js';
 import { AbstractCache } from './levelcache.abstract.classes.cache.js';
-import { type ILevelCacheConstructorOptions, LevelCache } from './levelcache.classes.levelcache.js';
+import {
+  type ILevelCacheConstructorOptions,
+  LevelCache,
+} from './levelcache.classes.levelcache.js';
 import { CacheEntry } from './levelcache.classes.cacheentry.js';
 
 /**
@@ -26,10 +29,13 @@ export class CacheDiskManager extends AbstractCache {
     if (this.levelCacheRef.options.diskStoragePath) {
       this.fsPath = plugins.path.join(
         this.levelCacheRef.options.diskStoragePath,
-        this.levelCacheRef.options.cacheId
+        this.levelCacheRef.options.cacheId,
       );
     } else {
-      this.fsPath = plugins.path.join(paths.nogitDir, this.levelCacheRef.options.cacheId);
+      this.fsPath = plugins.path.join(
+        paths.nogitDir,
+        this.levelCacheRef.options.cacheId,
+      );
     }
     if (this.status === 'active') {
       plugins.smartfile.fs.ensureDirSync(this.fsPath);
@@ -39,7 +45,7 @@ export class CacheDiskManager extends AbstractCache {
 
   public async retrieveCacheEntryByKey(keyArg: string): Promise<CacheEntry> {
     const fileString = await plugins.smartfile.fs.toStringSync(
-      plugins.path.join(this.fsPath, encodeURIComponent(keyArg))
+      plugins.path.join(this.fsPath, encodeURIComponent(keyArg)),
     );
     return CacheEntry.fromStorageJsonString(fileString);
   }
@@ -47,16 +53,20 @@ export class CacheDiskManager extends AbstractCache {
   public async storeCacheEntryByKey(keyArg: string, cacheEntryArg: CacheEntry) {
     await plugins.smartfile.memory.toFs(
       cacheEntryArg.foldToJson(),
-      plugins.path.join(this.fsPath, encodeURIComponent(keyArg))
+      plugins.path.join(this.fsPath, encodeURIComponent(keyArg)),
     );
   }
 
   public async checkKeyPresence(keyArg: string): Promise<boolean> {
-    return plugins.smartfile.fs.isFile(plugins.path.join(this.fsPath, encodeURIComponent(keyArg)));
+    return plugins.smartfile.fs.isFile(
+      plugins.path.join(this.fsPath, encodeURIComponent(keyArg)),
+    );
   }
 
   public async deleteCacheEntryByKey(keyArg: string) {
-    await plugins.smartfile.fs.remove(plugins.path.join(this.fsPath, encodeURIComponent(keyArg)));
+    await plugins.smartfile.fs.remove(
+      plugins.path.join(this.fsPath, encodeURIComponent(keyArg)),
+    );
   }
 
   public async cleanOutdated() {}

ts/levelcache.classes.cache.memorymanager.ts

@@ -1,7 +1,10 @@
 import * as plugins from './levelcache.plugins.js';
 import { AbstractCache } from './levelcache.abstract.classes.cache.js';
 import { CacheEntry } from './levelcache.classes.cacheentry.js';
-import { type ILevelCacheConstructorOptions, LevelCache } from './levelcache.classes.levelcache.js';
+import {
+  type ILevelCacheConstructorOptions,
+  LevelCache,
+} from './levelcache.classes.levelcache.js';
 
 export class CacheMemoryManager extends AbstractCache {
   private levelCacheRef: LevelCache;
@@ -22,7 +25,10 @@ export class CacheMemoryManager extends AbstractCache {
     this.readyDeferred.resolve();
   }
 
-  public async storeCacheEntryByKey(keyArg: string, cacheEntryArg: CacheEntry): Promise<void> {
+  public async storeCacheEntryByKey(
+    keyArg: string,
+    cacheEntryArg: CacheEntry,
+  ): Promise<void> {
     this.fastMap.addToMap(keyArg, cacheEntryArg, { force: true });
   }
 

ts/levelcache.classes.cache.s3manager.ts

@@ -24,15 +24,21 @@ export class CacheS3Manager extends AbstractCache {
 
   public async init() {
     if (this.levelCacheRef.options.s3Config) {
-      this.smartbucket = new plugins.smartbucket.SmartBucket(this.levelCacheRef.options.s3Config);
+      this.smartbucket = new plugins.smartbucket.SmartBucket(
+        this.levelCacheRef.options.s3Config,
+      );
       this.s3CacheBucket = await this.smartbucket.getBucketByName('');
       this.s3CacheDir = await (
         await this.s3CacheBucket.getBaseDirectory()
       ).getSubDirectoryByName(this.levelCacheRef.options.cacheId);
       if (this.levelCacheRef.options.maxS3StorageInMB) {
-        console.log(`cache level S3 activated with ${this.levelCacheRef.options.maxS3StorageInMB}`);
+        console.log(
+          `cache level S3 activated with ${this.levelCacheRef.options.maxS3StorageInMB}`,
+        );
       } else {
-        console.log(`s3 cache started without limit. Automatically applying timebox of 1 month`);
+        console.log(
+          `s3 cache started without limit. Automatically applying timebox of 1 month`,
+        );
       }
       this.status = 'active';
     } else {
@@ -42,9 +48,11 @@ export class CacheS3Manager extends AbstractCache {
   }
 
   public async retrieveCacheEntryByKey(keyArg: string): Promise<CacheEntry> {
-    const jsonFileString = (await this.s3CacheDir.fastGet({
-      path: encodeURIComponent(keyArg),
-    })).toString();
+    const jsonFileString = (
+      await this.s3CacheDir.fastGet({
+        path: encodeURIComponent(keyArg),
+      })
+    ).toString();
     const cacheEntry = CacheEntry.fromStorageJsonString(jsonFileString);
     return cacheEntry;
   }
@@ -52,7 +60,7 @@ export class CacheS3Manager extends AbstractCache {
   public async storeCacheEntryByKey(keyArg: string, cacheEntryArg: CacheEntry) {
     await this.s3CacheDir.fastPut({
       path: encodeURIComponent(keyArg),
-      contents: cacheEntryArg.toStorageJsonString()
+      contents: cacheEntryArg.toStorageJsonString(),
     });
   }
 

ts/levelcache.classes.cacherouter.ts

@@ -14,12 +14,18 @@ export class CacheRouter {
   /**
    * gets the relevant cache to perform a store action on
    */
-  async getCacheForStoreAction(keyArg: string, cacheEntry: CacheEntry): Promise<AbstractCache> {
+  async getCacheForStoreAction(
+    keyArg: string,
+    cacheEntry: CacheEntry,
+  ): Promise<AbstractCache> {
     let returnCache: AbstractCache;
     const mbToBytesMultiplier = 1000 * 1000;
-    const maxMemoryBytes = this.levelCacheRef.options.maxMemoryStorageInMB * mbToBytesMultiplier;
-    const maxDiskBytes = this.levelCacheRef.options.maxDiskStorageInMB * mbToBytesMultiplier;
-    const maxS3Bytes = this.levelCacheRef.options.maxS3StorageInMB * mbToBytesMultiplier;
+    const maxMemoryBytes =
+      this.levelCacheRef.options.maxMemoryStorageInMB * mbToBytesMultiplier;
+    const maxDiskBytes =
+      this.levelCacheRef.options.maxDiskStorageInMB * mbToBytesMultiplier;
+    const maxS3Bytes =
+      this.levelCacheRef.options.maxS3StorageInMB * mbToBytesMultiplier;
 
     switch (true) {
       case cacheEntry.contents.byteLength <= maxMemoryBytes &&

ts/levelcache.classes.levelcache.ts

@@ -64,9 +64,15 @@ export class LevelCache extends AbstractCache {
   }
 
   // store things
-  public async storeCacheEntryByKey(keyArg: string, cacheEntryArg: CacheEntry): Promise<void> {
+  public async storeCacheEntryByKey(
+    keyArg: string,
+    cacheEntryArg: CacheEntry,
+  ): Promise<void> {
     cacheEntryArg.key = keyArg;
-    const targetCache = await this.cacheRouter.getCacheForStoreAction(keyArg, cacheEntryArg);
+    const targetCache = await this.cacheRouter.getCacheForStoreAction(
+      keyArg,
+      cacheEntryArg,
+    );
     cacheEntryArg.createdAt = Date.now();
     await targetCache.storeCacheEntryByKey(keyArg, cacheEntryArg);
   }
@@ -76,7 +82,8 @@ export class LevelCache extends AbstractCache {
    * retrieve cache entry
    */
   public async retrieveCacheEntryByKey(keyArg: string): Promise<CacheEntry> {
-    const targetCache = await this.cacheRouter.getCacheForRetrieveAction(keyArg);
+    const targetCache =
+      await this.cacheRouter.getCacheForRetrieveAction(keyArg);
     if (targetCache) {
       const cacheEntry = await targetCache.retrieveCacheEntryByKey(keyArg);
       if (cacheEntry.createdAt + cacheEntry.ttl < Date.now()) {

ts/levelcache.paths.ts

@@ -2,6 +2,6 @@ import * as plugins from './levelcache.plugins.js';
 
 export const packageDir = plugins.path.join(
   plugins.smartpath.get.dirnameFromImportMetaUrl(import.meta.url),
-  '../'
+  '../',
 );
 export const nogitDir = plugins.path.join(packageDir, '.nogit/');

ts/levelcache.plugins.ts

@@ -31,6 +31,4 @@ export {
 // @tsclass scope
 import * as tsclass from '@tsclass/tsclass';
 
-export {
-  tsclass,
-};
+export { tsclass };

tsconfig.json

@@ -6,9 +6,9 @@
     "module": "NodeNext",
     "moduleResolution": "NodeNext",
     "esModuleInterop": true,
-    "verbatimModuleSyntax": true
+    "verbatimModuleSyntax": true,
+    "baseUrl": ".",
+    "paths": {}
   },
-  "exclude": [
-    "dist_*/**/*.d.ts"
-  ]
+  "exclude": ["dist_*/**/*.d.ts"]
 }