fix(tapbundle_serverside): allocate a free port when starting SmartStorage

changelog.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2026-05-08 - 3.6.5 - fix(tapbundle_serverside)
+allocate a free port when starting SmartStorage
+
+- Updates TapNodeTools.createSmartStorage() to resolve an available port starting from 3003 before launching SmartStorage
+- Avoids startup failures and port conflicts caused by always binding SmartStorage to the fixed port 3003
+
 ## 2026-05-08 - 3.6.4 - fix(tapbundle_serverside)
 use native fs promises to create the test files directory and write the downloaded alpine tarball
 

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/tstest',
-  version: '3.6.4',
+  version: '3.6.5',
   description: 'A powerful, modern test runner for TypeScript with multi-runtime support (Node.js, Deno, Bun, Chromium) and a batteries-included test framework.'
 }

ts_tapbundle_serverside/classes.tapnodetools.ts

@@ -93,8 +93,9 @@ export class TapNodeTools {
    */
   public async createSmartStorage() {
     const smartstorageMod = await import('@push.rocks/smartstorage');
+    const port = await this.findFreePort({ startPort: 3003 });
     const smartstorageInstance = await smartstorageMod.SmartStorage.createAndStart({
-      server: { port: 3003 },
+      server: { port },
       storage: { cleanSlate: true },
     });
     return smartstorageInstance;