@gkucmierz/dport 1.0.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,36 @@
+name: npm-publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ${{ github.server_url == 'https://github.com' && 'ubuntu-latest' || 'self-hosted' }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+      
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Publish to NPM Registry
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+
+      - name: Setup Gitea Registry
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://gitea.7u.pl/api/packages/gkucmierz/npm/'
+
+      - name: Publish to Gitea Registry
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.LOCAL_PACKAGE_REGISTRY }}

package/README.md

@@ -0,0 +1,23 @@
+# @gkucmierz/dport
+
+Deterministic local port generator based on your project name. 
+Replaces chaotic local development port assignments (`localhost:3000`, `8080`) with stable, predictable ports calculated mathematically. Maximize local PWA and Service Worker isolation effortlessly.
+
+## Installation
+```bash
+npm install -g @gkucmierz/dport
+```
+
+## Usage
+Calculate deterministic port from `package.json` in the current directory:
+```bash
+dport calc
+```
+Pass a custom name directly:
+```bash
+dport calc talk-app-backend
+```
+Automatically fix all familiar dev ports in your `scripts` tag inside `package.json`:
+```bash
+dport fix
+```

package/bin/dport.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { getDeterministicPort } from '../index.js';
+
+const args = process.argv.slice(2);
+const command = args.find(a => !a.startsWith('-')) || 'calc';
+const hasFixFlag = args.includes('--fix');
+
+if (command === 'help') {
+  console.log(`
+Usage: dport <command> [options]
+
+Commands:
+  calc [name]    Calculate deterministic port. (Default if no command provided)
+  fix [name]     Alias for 'calc --fix'.
+
+Options:
+  --fix          Find common development ports in package.json scripts
+                 and auto-replace them with the deterministic port.
+`);
+  process.exit(0);
+}
+
+if (command === 'calc' || command === 'show' || command === 'fix') {
+  let name = args.find(a => !a.startsWith('-') && a !== command);
+  let pkgPath, pkg;
+  
+  if (!name || hasFixFlag || command === 'fix') {
+    try {
+      pkgPath = path.resolve(process.cwd(), 'package.json');
+      const pkgContext = fs.readFileSync(pkgPath, 'utf8');
+      pkg = JSON.parse(pkgContext);
+      if (!name) name = pkg.name;
+    } catch(e) {
+      console.error('Error: Could not read package.json in current directory.');
+      if (hasFixFlag || command === 'fix') process.exit(1);
+    }
+  }
+  
+  if (!name) {
+     console.error('Error: No project name could be determined.');
+     process.exit(1);
+  }
+
+  const port = getDeterministicPort(name);
+  console.log(`\n📦 Project: ${name}`);
+  console.log(`🎯 Deterministic Port: ${port}\n`);
+
+  if ((hasFixFlag || command === 'fix') && pkg && pkg.scripts) {
+      let modified = false;
+      const commonPorts = ['3000', '8080', '5173', '8000', '4000', '3001', '8081', '4200'];
+      
+      for (const [key, script] of Object.entries(pkg.scripts)) {
+          let newScript = script;
+          commonPorts.forEach(cp => {
+               newScript = newScript.replace(new RegExp(`\\b${cp}\\b`, 'g'), port.toString());
+          });
+          if (newScript !== script) {
+               pkg.scripts[key] = newScript;
+               modified = true;
+               console.log(`✅ Updated script '${key}': ${newScript}`);
+          }
+      }
+      
+      if (modified) {
+          fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+          console.log(`\n💾 Successfully saved package.json with new port ${port}!`);
+      } else {
+          console.log(`ℹ️  No common ports (${commonPorts.join(', ')}) found to replace in package.json scripts.`);
+      }
+  }
+  
+  process.exit(0);
+}
+
+console.error(`Unknown command: \${command}`);
+process.exit(1);

package/index.js

@@ -0,0 +1,15 @@
+import crypto from 'crypto';
+
+export function getDeterministicPort(name, options = {}) {
+  const maxPorts = 65535;
+  const systemPorts = 1024;
+  const availablePorts = maxPorts - systemPorts;
+  
+  const hash = crypto.createHash('sha256').update(name).digest('hex');
+  const hashInt = BigInt('0x' + hash);
+  const port = Number((hashInt % BigInt(availablePorts)) + BigInt(systemPorts));
+  
+  const offset = options.offset || 0;
+  
+  return port + offset;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@gkucmierz/dport",
+  "version": "1.0.0",
+  "description": "Deterministic local port generator based on project name",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "dport": "./bin/dport.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "port",
+    "deterministic",
+    "dev",
+    "cli"
+  ],
+  "author": "gkucmierz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitea.7u.pl/gkucmierz/dports.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}
+