---

---

DevCortex Development Tools - Feature Guide

This document provides an overview of the tools available in the DevCortex Development Tools extension for VS Code.

---

1. Generators

Generate Random UUID

• Description: Generates a new version 4 (random) UUID and copies it directly to your clipboard.
• How to use: Run the command from the DevCortex Tools menu. A notification will confirm that the UUID has been copied.
• Example Output: 123e4567-e89b-12d3-a456-426614174000

Start Mock API from Selection

• Description: Quickly starts a local mock API server based on a JSON structure you've selected in your editor. This is great for front-end development when the back-end is not ready yet.
• How to use:
  1. Create a JSON object in your editor that defines the API endpoints.
  2. Select the entire JSON text.
  3. Run the "Start Mock API from Selection" command.
  4. The extension will start a server and provide you with the local URL.
• Example JSON Structure:

{
    "/users": {
        "GET": {
            "response": [
                {
                    "userId": "uuid",
                    "fullName": "fullName",
                    "email": "email"
                }
            ]
        }
    },
    "/products/{id}": {
        "GET": {
            "response": {
                "productId": "number",
                "productName": "string",
                "price": 123.45
            }
        }
    }
}

---

2. Converters

Paste JSON as Code

• Description: Converts a JSON object from your clipboard into typed classes or structs for various programming languages.
• How to use:
  1. Copy a valid JSON object to your clipboard.
  2. Run the "Paste JSON as Code" command.
  3. Select the target language (e.g., C#, TypeScript, Go, Java).
  4. The generated code will be pasted into your active editor.

JSON to C# (Selection)

• Description: Converts the selected JSON text directly into C# classes.
• How to use:
  1. Select a valid JSON object in your editor.
  2. Run the "JSON to C# (Selection)" command.
  3. A new editor tab will open with the generated C# code.

---

3. Encoders / Decoders

Base64 Encoder / Decoder

• Description: Encodes the selected text to Base64 or decodes a Base64 string back to its original form.
• How to use: Select the text you want to process and run the command. Choose "Encode" or "Decode" from the options. The result will replace your selection.

URL Encoder / Decoder

• Description: Encodes or decodes text for safe use within a URL (percent-encoding).
• How to use: Select the text you want to process and run the command. Choose "Encode" or "Decode". The result will replace your selection.

JWT Decoder

• Description: Decodes a JSON Web Token (JWT) from your clipboard to inspect its header and payload.
• How to use: Copy a JWT to your clipboard and run the command. A new editor tab will open with the decoded JSON.

---

4. Hashing & Cryptography

Hash Generator

• Description: Generates a hash of the selected text using various algorithms.
• How to use: Select the text you want to hash, run the command, and choose the desired algorithm (MD5, SHA1, SHA256, SHA512). The hash is copied to your clipboard.

HMAC Generator

• Description: Generates a Hash-based Message Authentication Code (HMAC) for the selected text.
• How to use: Select the text, run the command, and provide a secret key when prompted. The HMAC-SHA256 signature will be copied to your clipboard.

Bcrypt

• Description: A tool for working with bcrypt hashes. You can either generate a new hash for a string or verify a string against an existing bcrypt hash.
• How to use:
  1. Generate: Run the command, choose "Generate", and enter the string to hash. The hash is copied to your clipboard.
  2. Verify: Run the command, choose "Verify", enter the plain text string, and then enter the bcrypt hash to compare against. A notification will show if they match.