jwt-encde 0.0.0 → 1.1.0-pre.9

package/README.md

@@ -0,0 +1,62 @@
+# jwt-encde
+
+[![crates.io](https://img.shields.io/crates/v/jwt-encde?label=latest)](https://crates.io/crates/jwt-encde)
+[![Dependency Status](https://deps.rs/crate/jwt-encde/latest/status.svg)](https://deps.rs/crate/jwt-encde)
+[![Executable](https://github.com/nabbisen/jwt-encde/actions/workflows/release-executable.yaml/badge.svg)](https://github.com/nabbisen/jwt-encde/actions/workflows/release-executable.yaml)
+[![License](https://img.shields.io/github/license/nabbisen/jwt-encde)](https://github.com/nabbisen/jwt-encde/blob/main/LICENSE)
+
+GUI JWT encoder / decoder - Local, private, easy.
+
+![screenshot](./screenshot.png)
+
+## Description
+
+A lightweight, open-source GUI tool for JWT encoding and decoding, designed to support testing around authentication and authorization in app development.
+
+This app allows you to **inspect, analyze, and edit JWT payloads as JSON**, and easily convert test JSON data into JWTs for development and debugging purposes.    
+
+### Key features
+
+- Runs entirely **offline**, unlike online tools
+    - It strongly ensures **security and privacy**. No data ever leaves your machine.
+- Built with a **low-memory, high-performance architecture** 
+- Available as a **cross-platform binary** for Windows, macOS, and Linux
+
+#### Additional features included
+
+- Syntax highlighting for JSON to improve readability
+- Disabled states for unavailable actions to prevent accidental operations
+- A built-in helper tool for analyzing UNIX timestamps within JSON data
+
+#### Note: This app does **not** support JWT signing or token introspection
+
+In real-world systems, signing keys and token validation are typically managed by IDaaS. They should be verified through actual integration with the provider.
+
+## Usage options
+
+-  Install as npm pacakge
+    
+    ```sh
+    npm install -g jwt-encde
+    npx jwt-encde
+    ```
+    
+-  Install via Rust cargo
+    
+    ```sh
+    cargo install jwt-encde
+    jwt-encde
+    ```
+    
+- Download executable and just run it
+    - [Assets](https://github.com/nabbisen/jwt-encde/releases/latest) in GitHub Releases are avalilable
+
+## Open-source, with care
+
+This project is lovingly built and maintained by volunteers.
+We hope it helps streamline your work.
+Please understand that the project has its own direction — while we welcome feedback, it might not fit every edge case 🌱
+
+## Acknowledgements
+
+Depends on the crates of [arboard](https://crates.io/crates/arboard), [base64](https://crates.io/crates/base64), [hmac](https://crates.io/crates/hmac), [iced](https://crates.io/crates/iced), [json5](https://crates.io/crates/json5), [serde](https://crates.io/crates/serde), [serde_json](https://crates.io/crates/serde_json), [sha2](https://crates.io/crates/sha2), [webbrowser](https://crates.io/crates/webbrowser).

package/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const os = require("os")
+const { join } = require("path")
+const { spawn } = require("child_process")
+
+const binaryName = "jwt-encde"
+
+function binaryPath() {
+  const platform = os.platform()
+  let extension = ""
+  switch (platform) {
+    case "win32":
+      extension = ".exe"
+      break
+    default:
+  }
+
+  return join(__dirname, `${binaryName}${extension}`)
+}
+
+function spawnBinary(binaryPath) {
+  // passing command line arguments to the executable
+  const args = process.argv.slice(2)
+
+  const child = spawn(binaryPath, args, {
+    stdio: "inherit", // sharing std i/o with the parent brings memory efficiency
+  })
+
+  child.on("error", (err) => {
+    console.error(`failed to start: ${err.message}`)
+    process.exit(1)
+  })
+
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      console.error(`exit by signal: ${signal}`)
+      process.exit(1)
+    }
+    process.exit(code)
+  })
+}
+
+spawnBinary(binaryPath())

package/package.json

@@ -1,7 +1,42 @@
 {
   "name": "jwt-encde",
-  "version": "0.0.0",
+  "version": "1.1.0-pre.9",
   "description": "GUI JWT encoder / decoder - Local, private, easy.",
+  "author": "nabbisen<nabbisen@scqr.net>",
   "license": "Apache-2.0",
-  "author": "nabbisen<nabbisen@scqr.net>"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nabbisen/jwt-encde.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/nabbisen/jwt-encde/",
+  "bin": {
+    "jwt-encde": "./index.js"
+  },
+  "files": [
+    "postinstall.js"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "optionalDependencies": {
+    "@jwt-encde/bin-linux-x64-gnu": "1.1.0-pre.9",
+    "@jwt-encde/bin-darwin-arm64": "1.1.0-pre.9",
+    "@jwt-encde/bin-win32-x64-msvc": "1.1.0-pre.9"
+  },
+  "keywords": [
+    "jwt",
+    "json",
+    "auth",
+    "test",
+    "encryption",
+    "security",
+    "devtool",
+    "developer-tool",
+    "testing",
+    "simulate"
+  ]
 }

package/postinstall.js

@@ -0,0 +1,58 @@
+const fs = require("fs")
+const os = require("os")
+const path = require("path")
+
+const binaryName = "jwt-encde"
+const platformOrganization = "@jwt-encde"
+
+function srcDestBinaryPath() {
+    const platform = os.platform()
+
+    let platformPackage = null
+    let extension = ""
+
+    switch (platform) {
+        case "linux":
+            platformPackage = "bin-linux-x64-gnu"
+            break
+        case "darwin":
+            platformPackage = "bin-darwin-arm64"
+            break
+        case "win32":
+            platformPackage = "bin-win32-x64-msvc"
+            extension = ".exe"
+            break
+        default:
+            console.error(`Unsupported platform: ${platform}`)
+            process.exit(1)
+    }
+
+    const binDir = __dirname
+    const srcDir = path.join(binDir, "..", platformOrganization, platformPackage)
+    const srcBinary = path.join(srcDir, `${binaryName}${extension}`)
+    const destBinary = path.join(binDir, `${binaryName}${extension}`)
+
+    return [srcBinary, destBinary]
+}
+
+function linkOrCopy(src, dest) {
+    try {
+        if (fs.existsSync(dest)) {
+            fs.rmSync(dest, { force: true })
+        }
+
+        // Try symbolic link first
+        fs.symlinkSync(src, dest, "file")
+        fs.chmodSync(src, 0o755)
+        console.log(`linked ${src} --> ${dest}`)
+    } catch (e) {
+        // Fallback to file copy
+        console.warn(`symlink failed (${e.message}), falling back to copy.`)
+        fs.copyFileSync(src, dest)
+        fs.chmodSync(dest, 0o755)
+        console.log(`copied ${src} --> ${dest}`)
+    }
+}
+
+const [srcBinary, destBinary] = srcDestBinaryPath()
+linkOrCopy(srcBinary, destBinary)