IBeam.Utilities
2.8.0
See the version list below for details.
dotnet add package IBeam.Utilities --version 2.8.0
NuGet\Install-Package IBeam.Utilities -Version 2.8.0
<PackageReference Include="IBeam.Utilities" Version="2.8.0" />
<PackageVersion Include="IBeam.Utilities" Version="2.8.0" />
<PackageReference Include="IBeam.Utilities" />
paket add IBeam.Utilities --version 2.8.0
#r "nuget: IBeam.Utilities, 2.8.0"
#:package IBeam.Utilities@2.8.0
#addin nuget:?package=IBeam.Utilities&version=2.8.0
#tool nuget:?package=IBeam.Utilities&version=2.8.0
IBeam.Utilities
IBeam.Utilities contains shared primitives used across the IBeam framework.
dotnet add package IBeam.Utilities
When To Use This
- You need IBeam's common exception middleware and error helpers.
- You need shared audit-event primitives.
- You want reusable cache wrappers or token helpers used by IBeam packages.
- You are building an IBeam package and need framework-level utility types.
What This Package Contains
| Area | Type(s) | Purpose |
|---|---|---|
| Exceptions | ExceptionMiddleware and related types/options |
Provides consistent exception handling behavior for ASP.NET Core hosts. |
| Auditing primitives | AuditEvent, AuditAction, AuditEventBuilder |
Shared audit-event structures used by higher-level packages. |
| Caching | DataCache, NamespacedMemoryCache |
Small wrappers for shared cache behavior. |
| Settings | BaseAppSettings, IBaseAppSettings |
Common application setting shape. |
| Tokens | TokenGenerator |
Utility token generation. |
| Validation/roles | Validations, Role |
Small shared helper models. |
Architecture Fit
Utilities should stay small and cross-cutting. Domain rules belong in services, transport behavior belongs in API packages, and persistence belongs in repositories.
Code Example
app.UseMiddleware<ExceptionMiddleware>();
Utility types should usually support higher-level packages rather than becoming a dumping ground for domain behavior.
Data Storage
This package does not create tables, repositories, containers, or buckets.
Service Operations, Auditing, And Permissions
This package contains shared primitives but does not own service-operation authorization or audit persistence. Use IBeam.Services and IBeam.Services.Logging for those runtime patterns.
Extended Docs And Agent Guidance
- AI prompt:
.agent/prompt.md - Root implementation guide:
../.agent/implementation-guide.md - Service logging and audit:
../docs/service-logging-and-audit.md - Service operation permissions:
../docs/service-operation-permissions.md
Agents should only add utilities here when multiple packages genuinely share the need.
Version Notes
- Targets
net10.0. - Package version is assigned by the repository release workflow.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- IBeam.Repositories (>= 2.8.0)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages (4)
Showing the top 4 NuGet packages that depend on IBeam.Utilities:
| Package | Downloads |
|---|---|
|
IBeam.Services
Root services package that aggregates abstractions and core service implementations. |
|
|
IBeam.Api
Lightweight API helper library with base controllers, error handling, and DI/config wiring. |
|
|
IBeam.Repositories.AzureTables
IBeam modular framework components for .NET APIs and services. |
|
|
IBeam.Repositories.OrmLite
IBeam modular framework components for .NET APIs and services. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.9.1 | 132 | 7/23/2026 |
| 2.9.0 | 207 | 7/21/2026 |
| 2.8.2 | 201 | 7/21/2026 |
| 2.8.1 | 202 | 7/21/2026 |
| 2.8.0 | 214 | 7/21/2026 |
| 2.7.0 | 227 | 7/21/2026 |
| 2.6.0 | 257 | 7/20/2026 |
| 2.5.0 | 253 | 7/17/2026 |
| 2.4.2 | 192 | 7/16/2026 |
| 2.4.1 | 190 | 7/14/2026 |
| 2.4.0 | 188 | 6/24/2026 |
| 2.3.0 | 183 | 6/24/2026 |
| 2.2.0 | 198 | 6/23/2026 |
| 2.1.0 | 190 | 6/23/2026 |
| 2.0.68 | 188 | 6/23/2026 |
| 2.0.66 | 183 | 6/22/2026 |
| 2.0.65 | 189 | 6/22/2026 |
| 2.0.64 | 248 | 6/17/2026 |
| 2.0.63 | 190 | 6/16/2026 |
| 2.0.62 | 189 | 6/16/2026 |