AllPay Tools

Accelerate AllPay system development with intelligent code generation snippets and utilities for TypeScript/Next.js and C#.

AllPay Tools is a VS Code extension that turbocharges your development workflow with pre-configured snippets and commands for building AllPay-compliant applications. Perfect for teams developing full-stack TypeScript/Next.js services and ASP.NET Core backends.

✨ Features

🎯 Smart Commands

• Escape Code Snippet Body — Instantly convert multi-line code into escaped VS Code snippet format. Perfect for creating reusable snippet templates from existing code.

• SOPS (age) encrypt / decrypt — share secrets with the team via SOPS. Requires sops and age on PATH.

  • AllPay Tools: Get SOPS Public Key — copies your age public key (creates ~/.config/sops/age/keys.txt if missing; override with allpayTools.sops.keyFile). Send it to a teammate.
  • Right-click .sops.yaml → Add Public Key (name + key) → adds a recipient, optionally re-keys existing *.enc.* files so the new member can decrypt.
  • Right-click *.json / *.yaml / *.yml / .env* → Encrypt → a.json ⇒ a.enc.json, .env.dev ⇒ .env.dev.enc (uses the nearest .sops.yaml; if none is found it falls back to the default one from allpayTools.sops.defaultConfig, default ~/.config/sops/.sops.yaml, created with your key on first use).
  • SOPS: Add Public Key to Default .sops.yaml — adds a recipient to that default config.
  • SOPS: Encrypt All / SOPS: Decrypt All — recursive over the open folders; only files that already have an .enc twin (xxx.json ⇄ xxx.enc.json). Encrypt All skips unchanged files.
  • Right-click *.enc.json / *.enc.yaml / *.enc.yml / *.env.enc → Decrypt → writes the plain file back.

📝 TypeScript/Next.js Snippets

Type allpay-crud-service or allpay-crud-slice in .ts or .tsx files:

Key Features:

• ✅ Type-safe TypeScript types for requests/responses
• ✅ Search, create, read, update, delete operations
• ✅ Built-in pagination and sorting support
• ✅ Async thunks for Redux operations

🔧 C# Snippets

Type allpay-crud-service or allpay-crud-controller in .cs files:

Key Features:

• ✅ EF Core LINQ queries with filtering and sorting
• ✅ RESTful endpoints (GET, POST, PUT, DELETE)
• ✅ Namespace configuration support
• ✅ Authorization and validation ready

Configuration

Settings

Configure the extension via VS Code settings:

• allpayTools.sops.defaultConfig (string, default: ~/.config/sops/.sops.yaml) — default .sops.yaml when a target has none
• allpayTools.rootNameSpace (string, default: "AllPay")
  • Sets the C# namespace prefix for generated code
  • Example: Setting to "MyCompany.AllPay" generates MyCompany.AllPay.Service namespace

Usage

Using Commands

1. Create a new file or open an existing code file
2. Select the code you want to escape/convert
3. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
4. Search for and select "AllPay Tools: Escape Code Snippet Body"
5. The escaped code appears in a new editor tab, ready to paste into snippet definitions

Using Snippets

1. Open a TypeScript/TSX file (for Next.js snippets) or C# file (for C# snippets)
2. Start typing the snippet prefix:
   • allpay-crud-service — CRUD service template
   • allpay-crud-slice — Redux state management template
   • allpay-crud-controller — Controller endpoints template
3. Press Tab to expand the snippet
4. Fill in the placeholder values (use Tab to navigate between placeholders):
   • ${1:Entity} — Entity/model name (e.g., "User", "Product")
   • ${2:entity} — Lowercase entity name for file/variable names
   • ${3:entities} — Plural form for API endpoints
   • Other numbered placeholders for type hints and property names

Quick Start

1. Install: Search for "AllPay Tools" in VS Code Extensions
2. Configure (optional): Set your C# namespace in VS Code settings
3. Use Snippets: Type allpay- in a TypeScript or C# file to see available snippets
4. Speed Up: Generate consistent, production-ready boilerplate code in seconds

Requirements

• VS Code 1.109.0 or later
• Node.js 16.x or later (for development)

💡 Tips & Best Practices

• Reuse Patterns: Use the Escape Code Snippet command to convert your best code into reusable snippets
• Customize Namespace: Update allpayTools.rootNameSpace setting to match your organization
• Team Consistency: All snippets follow AllPay conventions for seamless team collaboration
• Type Safety: Leverage TypeScript types for better IDE support and fewer runtime errors

📋 What's Included

• ✨ 2 TypeScript/Next.js snippets (API Service, Redux Slice)
• 🔧 2 C# snippets (CRUD Service, Controller)
• ⚡ 1 smart command (Escape Code Snippet Body)
• 🎯 Fully customizable C# namespace support

Getting Help

If you encounter any issues or have feature requests, please check the project repository for support channels.

Version

0.0.1

📄 License

Released under the MIT License (see the LICENSE file in the package).