CodeLogic.Common 4.5.2-preview.68

CodeLogic.Common

General-purpose utility toolkit for CodeLogic applications. A broad collection of stateless, thread-safe helpers covering security, ID/password generation, caching, compression, imaging, data (JSON), file handling, type conversion, cron parsing, date/time, strings, web, networking, and reflection.

Operations that can fail return CodeLogic.Core.Results.Result / Result<T> rather than throwing, so callers rarely need try/catch.

Install

dotnet add package CodeLogic.Common

Features

Quick Start

using CL.Common.Imaging;
using CL.Common.Security;

// Convert any image to WebP
using var input = File.OpenRead("photo.jpg");
var result = CLU_Imaging.ConvertImage(input, ImageFormat.Webp);
if (result.IsSuccess)
    await File.WriteAllBytesAsync("photo.webp", result.Value!.ToArray());

// Hash a string (lowercase hex)
string digest = Hashing.Sha256("my-secret-data");

Security

using CL.Common.Security;

// PBKDF2 password hashing (salt is embedded in the returned string)
string stored = Hashing.HashPassword("hunter2");
bool ok = Hashing.VerifyPassword("hunter2", stored);   // true

// AES-256-GCM authenticated encryption — tampering is detected on decrypt
string cipher = Encryption.EncryptAes("top secret", "passphrase");
string plain  = Encryption.DecryptAes(cipher, "passphrase");

Generators

using CL.Common.Generators;

string id   = IdGenerator.NanoId();              // e.g. "V1StGXR8_Z5jdHi6B-myT"
string sort = IdGenerator.Sortable();            // lexicographically sortable
string pw   = PasswordGenerator.GenerateStrong(20);
string pass = PasswordGenerator.GeneratePassphrase(wordCount: 4);  // "Apple-Bridge-..."
PasswordStrength strength = PasswordGenerator.CalculateStrength(pw);

Caching

using CL.Common.Caching;

ICache cache = new MemoryCache();                       // background eviction loop runs internally
await cache.SetAsync("user:1", userObj, TimeSpan.FromMinutes(5));
var cached = await cache.GetAsync<User>("user:1");      // null if missing/expired
await cache.RemoveByPrefixAsync("user:");

Compression

using CL.Common.Compression;

var packed = CompressionHelper.CompressLz4(payloadBytes);
if (packed.IsSuccess)
    byte[] original = CompressionHelper.DecompressLz4(packed.Value!).Value!;

// Text → Base64 (GZip)
string blob = CompressionHelper.CompressString("a lot of repeated text...").Value!;

JSON & Conversion

using CL.Common.Data;
using CL.Common.Conversion;

string json = JsonHelper.Serialize(new { name = "Ada" }).Value!;   // {"name":"Ada"}
var person  = JsonHelper.Deserialize<Person>(json);

var n = TypeConverter.ToInt("42");          // Result<int>
if (TypeConverter.TryConvert<double>("3.14", out var d)) { /* ... */ }

Cron, Date/Time & Strings

using CL.Common.Parser;
using CL.Common.Time;
using CL.Common.Strings;

var next = CronParser.GetNextOccurrence("0 */6 * * *");   // Result<DateTime> (UTC)
long unix = DateTimeHelper.ToUnixTimestamp(DateTime.UtcNow);
string rel = DateTimeHelper.ToRelativeString(DateTime.UtcNow.AddMinutes(-3)); // "3 minutes ago"

string slug = StringHelper.ToSlug("Hello, World!");       // "hello-world"
bool valid  = StringValidator.IsEmail("a@b.com");

Web & Networking

using CL.Common.Web;
using CL.Common.Networking;

string url = UrlHelper.AppendQuery("https://api.example.com/search",
    new() { ["q"] = "cats", ["page"] = "2" });

using var http = new HttpClient();
var data = await HttpClientHelper.GetJsonAsync<MyDto>(http, url);

var ping = await NetworkPing.PingAsync("example.com");    // Result<PingResult>
var ips  = await NetworkDns.LookupAsync("example.com");   // Result<string[]>

Documentation

• API Reference

Requirements

• CodeLogic 3.x or 4.x | .NET 10

License

MIT — see LICENSE