Agency8.MyTokens 0.0.3

Agency8.MyTokens

A .NET 9 library for managing and replacing tokens (key-value pairs) in your applications with database persistence, caching support, and optional Blazor UI components.

Overview

Agency8.MyTokens provides a flexible token management system that allows you to store, retrieve, and replace tokens throughout your application. It's particularly useful for managing dynamic configuration values, template placeholders, or any key-value data that needs to be centrally managed and easily replaceable.

Features

• Token Management: Create, read, update, and delete token key-value pairs
• Database Persistence: Store tokens in SQL Server or SQLite using Entity Framework Core
• Caching Support: Built-in caching with options for in-memory or distributed caching
• Blazor UI Components: Optional pre-built Blazor components for token management (Agency8.MyTokens.BlazorComponents)
• Token Replacement Helpers: Utility methods for replacing tokens in strings and templates
• Repository Pattern: Clean architecture with ITokenRepository interface
• Configurable Behavior: Customize not-found placeholders and cache types
• License Management: Built-in licensing support for commercial use

Installation

For Blazor UI components:

Quick Start

1. Configure Services

In your Program.cs or Startup.cs:

2. Using the Token Repository

Inject ITokenRepository into your services or controllers:

3. Token Replacement

Use the built-in helpers to replace tokens in your content:

4. Blazor Components (Optional)

Add the MyTokensManager component to your Blazor page:

Configuration Options

MyTokensAddOptions

• ConnectionString: Database connection string (required)
• DatabaseType: DatabaseType.SqlServer or DatabaseType.Sqlite

MyTokensUsingOptions

• NotFoundPlaceholder: Template for missing tokens (default: "[⚠️Token Not Found : {key}⚠️]")
• MyTokensCacheType: CacheType.InMemory or CacheType.Distributed

Token Entity

Repository Methods

• GetAllAsync(): Retrieve all tokens
• GetByIdAsync(Guid id): Get a specific token by ID
• CreateAsync(Token token): Create a new token
• UpdateAsync(Token token): Update an existing token
• DeleteAsync(Guid id): Delete a token
• RefreshTokenCacheAsync(): Manually refresh the token cache

Caching

MyTokens includes built-in caching to optimize performance:

• In-Memory Cache: Fast, process-local caching (default)
• Distributed Cache: For multi-instance deployments (Redis, SQL Server, etc.)

The cache automatically updates when tokens are created, updated, or deleted through the repository.

Database Support

• SQL Server: Full support with automatic table creation
• SQLite: Full support for lightweight deployments

The database table is automatically created on first use.

License

This product includes licensing functionality. For commercial use, please contact Agency8 for licensing information.

Product Name: TokenReplacR

Requirements

• .NET 9.0 or later
• Entity Framework Core 9.0
• Supported databases: SQL Server or SQLite

Contributing

Contributions are welcome! Please follow the coding standards defined in the project.

Support

For issues, feature requests, or questions, please visit the project repository or contact Agency8.

Agency8.MyTokens - Simplify your token management and replacement needs.