 |
VOOZH | about |
|
VOOZH | about |
dotnet add package TAF.Infra.Contract --version 1.11.5
NuGet\Install-Package TAF.Infra.Contract -Version 1.11.5
<PackageReference Include="TAF.Infra.Contract" Version="1.11.5" />
<PackageVersion Include="TAF.Infra.Contract" Version="1.11.5" />Directory.Packages.props
<PackageReference Include="TAF.Infra.Contract" />Project file
paket add TAF.Infra.Contract --version 1.11.5
#r "nuget: TAF.Infra.Contract, 1.11.5"
#:package TAF.Infra.Contract@1.11.5
#addin nuget:?package=TAF.Infra.Contract&version=1.11.5Install as a Cake Addin
#tool nuget:?package=TAF.Infra.Contract&version=1.11.5Install as a Cake Tool
A comprehensive contract library that provides common models, interfaces, and data structures for the TAF Infrastructure ecosystem. This package contains shared DTOs, enums, base classes, and contract definitions that ensure consistency across all TAF microservices and applications.
dotnet add package TAF.Infra.Contract
Add the package to your project:
dotnet add package TAF.Infra.Contract
using TAF.Infra.Contract.Models;
using TAF.Infra.Contract.Enums;
// Use shared DTOs
public class UserService
{
public async Task<UserDto> GetUserAsync(Guid userId)
{
// Implementation using common contract models
return new UserDto
{
Id = userId,
Status = UserStatus.Active
};
}
}
using TAF.Infra.Contract.Interfaces;
// Implement standardized interfaces
public class ProductRepository : IRepository<Product>
{
public async Task<Product> GetByIdAsync(Guid id)
{
// Implementation
}
public async Task<IEnumerable<Product>> GetAllAsync()
{
// Implementation
}
}
using TAF.Infra.Contract.Base;
// Extend from common base classes
public class Product : BaseEntity
{
public string Name { get; set; }
public decimal Price { get; set; }
// BaseEntity provides: Id, CreatedAt, UpdatedAt, etc.
}
// Always inherit from base classes when appropriate
public class OrderDto : BaseDto
{
public string OrderNumber { get; set; }
public OrderStatus Status { get; set; }
public List<OrderItemDto> Items { get; set; }
}
// Use common interfaces for consistency
public class OrderService : IOrderService
{
public async Task<ApiResponse<OrderDto>> CreateOrderAsync(CreateOrderRequest request)
{
// Standardized response format
return new ApiResponse<OrderDto>
{
Success = true,
Data = createdOrder,
Message = "Order created successfully"
};
}
}
// Use shared enums for consistency across services
public class Order : BaseEntity
{
public OrderStatus Status { get; set; } = OrderStatus.Pending;
public PaymentStatus PaymentStatus { get; set; } = PaymentStatus.Unpaid;
}
// Follow naming conventions
public class ProductDto : BaseDto
{
public string Name { get; set; }
public string Description { get; set; }
public decimal Price { get; set; }
public ProductCategory Category { get; set; }
}
// Extend base interfaces when needed
public interface IProductService : IService<Product>
{
Task<IEnumerable<Product>> GetByCategoryAsync(ProductCategory category);
Task<bool> UpdatePriceAsync(Guid productId, decimal newPrice);
}
The contract library provides:
// Easy to mock standardized interfaces
var mockRepository = new Mock<IRepository<Product>>();
mockRepository.Setup(r => r.GetByIdAsync(It.IsAny<Guid>()))
.ReturnsAsync(new Product { Name = "Test Product" });
This package follows semantic versioning:
When adding new contracts:
This project is licensed under the MIT License.
If you encounter any issues, please file them in the GitHub Issues section.
Built with โค๏ธ for consistent microservices architecture
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 net8.0 is compatible. net8.0-android net8.0-android was computed. net8.0-browser net8.0-browser was computed. net8.0-ios net8.0-ios was computed. net8.0-maccatalyst net8.0-maccatalyst was computed. net8.0-macos net8.0-macos was computed. net8.0-tvos net8.0-tvos was computed. net8.0-windows net8.0-windows was computed. net9.0 net9.0 was computed. net9.0-android net9.0-android was computed. net9.0-browser net9.0-browser was computed. net9.0-ios net9.0-ios was computed. net9.0-maccatalyst net9.0-maccatalyst was computed. net9.0-macos net9.0-macos was computed. net9.0-tvos net9.0-tvos was computed. net9.0-windows net9.0-windows was computed. net10.0 net10.0 was computed. net10.0-android net10.0-android was computed. net10.0-browser net10.0-browser was computed. net10.0-ios net10.0-ios was computed. net10.0-maccatalyst net10.0-maccatalyst was computed. net10.0-macos net10.0-macos was computed. net10.0-tvos net10.0-tvos was computed. net10.0-windows net10.0-windows was computed. |
Showing the top 5 NuGet packages that depend on TAF.Infra.Contract:
| Package | Downloads |
|---|---|
|
TAF.MetaData.SDK
Professional HTTP-based SDK for TAF Metadata Service. v10.0.0: Clean release - no caching dependencies. Features Clean Architecture, SOLID principles, explicit BusContext parameter support, comprehensive error handling, screen management, batch relations support, and GUID-based lookups. |
|
|
TAF.Infra.MassTransit
A comprehensive abstraction layer over MediatR and MassTransit that provides unified Command, Query, and Event handling patterns with support for both local (in-process) and distributed (message broker) execution. Features include CQRS pattern implementation, context-aware messaging, multi-tenant support, automatic handler registration, and support for multiple message brokers (RabbitMQ, Azure Service Bus, Amazon SQS). |
|
|
TAF.CRUD.SDK
Official SDK for consuming TAF.CRUD microservice. v6.0.9: Fixes DatabaseClient.ExecuteAsync deserialization mismatch โ client was expecting List<List<Dictionary>> but API returns the flattened single-result-set shape List<Dictionary>. SP/function calls returning at least one row (including void-returning PG functions that produce a synthetic NULL row) now deserialize correctly. v6.0.8: JsonDefaults no longer attaches JsonStringEnumConverter โ SDK requests serialize enums in their default integer form so the CRUD API (which has no string-enum converter) can deserialize them. Fixes 400 BadRequest on UPDATE/DELETE calls that carry a WhereClause filter. |
|
|
TAF.Infra.QueryHook
A common interface library for QueryHook functionality that provides a standardized contract for performing configured actions. Enables consistent implementation of query hook patterns across different services and applications with configurable action execution. |
|
|
TAF.Infra.WorkflowAction
Workflow Action abstractions, models, attributes, and helpers for TAF platform. Provides IWorkflowAction interface, ActionContext, ActionDefinition, ActionResult, and validation helpers for building workflow actions and transition hooks. ActionContext now includes OldRecordData โ a pre-update snapshot of the record that fired the trigger, enabling custom actions to compare old vs new field values on Edit events. |
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.11.5 | 479 | 5/19/2026 |
| 1.11.4 | 392 | 5/4/2026 |
| 1.11.3 | 571 | 4/15/2026 |
| 1.11.2 | 222 | 3/27/2026 |
| 1.11.1 | 111 | 3/27/2026 |
| 1.11.0 | 155 | 3/19/2026 |
| 1.10.15 | 247 | 3/10/2026 |
| 1.10.14 | 108 | 3/7/2026 |
| 1.10.13 | 118 | 3/5/2026 |
| 1.10.12 | 117 | 3/5/2026 |
| 1.10.11 | 204 | 3/5/2026 |
| 1.10.10 | 440 | 2/10/2026 |
| 1.10.9 | 130 | 1/31/2026 |
| 1.10.8 | 961 | 1/21/2026 |
| 1.10.6 | 187 | 1/13/2026 |
| 1.10.5 | 1,361 | 12/17/2025 |
| 1.10.4 | 578 | 12/10/2025 |
| 1.10.3 | 502 | 12/9/2025 |
| 1.10.2 | 695 | 12/5/2025 |
| 1.10.0 | 281 | 11/27/2025 |
v1.11.5: Added MessageBrokerException
- Added Exceptions/MessageBrokerException.cs for RabbitMQ/broker unreachable errors
- Consumed by TAF.Infra.MassTransit (throw) and TAF.Infra.ErrorHandling (catch โ 503)
- No breaking changes - additive only
v1.11.4: Stabilized default Id on Filter and SortCriteria
- Filter.Id and SortCriteria.Id no longer initialize to Guid.NewGuid() by default
- Default is now Guid.Empty so identical filter/sort definitions serialize to identical JSON
- Fixes metadata diff false-positive where every AppObject containing LookUpDetails appeared as Updated, because filter Ids drifted on every UpsertVersionAsync rebuild
- No breaking changes โ nothing in CRUD or metadata reads the Id semantically; existing stored JSON keeps its original Id on deserialize
v1.11.3: Added DataAccessSet enum
- Added Enums/DataAccessSet.cs with NONE=1, OWN=2, TEAM=3, ALL=4
- Defines permission scope levels for TABD_AppObjectAccess rows
- Used by Metadata Service when seeding default role permissions on AppObject registration
- No breaking changes - additive only
v1.11.1: Added CascadeDelete property to ChildRelationship
- Added CascadeDelete boolean property (default: false) to control soft-delete cascade behavior
- false: Block soft-delete if children exist (prevents orphaned records)
- true: Cascade soft-delete to children (if child supports soft-delete)
- Enables per-relationship cascade control for SoftDeleteCascadeHook in taf_crud
- No breaking changes - additive only
v1.11.0: Added StatusTransitionResponse DTOs for blueprint status operations
- Added DTOs/StatusTransitionResponse.cs โ Shared response model for status transitions (replaces GetNextAvailableStatusResponse in Blueprint.SDK)
- Added AvailableTransition class โ Individual transition with optional hook data (replaces ToStatusResponse in Blueprint.SDK)
- Hook properties use object? to avoid circular dependency with TAF.Infra.WorkflowAction
- Enables CRUD SDK to expose status operations without Blueprint.SDK dependency
- No breaking changes - additive only
v1.10.14: Removed ObjectID_Tosave property from Field
- Removed unused ObjectID_Tosave property from field model
- Added User field type constant (25) to FieldTypeConstants
- No breaking changes for consumers not using ObjectID_Tosave
v1.10.13: Added CustomScriptType enum
- Added Enums/CustomScriptType.cs with QueryHook=1, WorkflowAction=2, CustomValidator=7, TransitionStart=11
- Enables consistent custom script type definitions across TAF microservices
- No breaking changes - additive only
v1.10.9: Added Space filtering flags and XML documentation for AppObject
- Added IsSpaceAgnostic flag - Excludes generic/polymorphic child tables (Comments, Attachments, Activities) from Space filtering
- Added IsSpaceRoot flag - Marks AppObjects as Space roots for LookupPathFinder filtering
- Added XML documentation comments for feature flags: EnableTracking, AllowSearchable, AllowSharing, AllowVersioning, IsSupportBluePrint, AllowSoftDelete, IsCacheEnable, IsSupportLayout, IsDeprecated, EnableComment
- No breaking changes - additive only
v1.10.8: Patch version release
- Minor updates and improvements
- No breaking changes
v1.10.7: Patch version release
- Minor updates and improvements
- No breaking changes
v1.10.6: Patch version release
- Minor updates and improvements
- No breaking changes
v1.10.5: Patch version release
- Minor updates and improvements
- No breaking changes
v1.10.4: Moved Error functions to ErrorHandling
- Removed Error functions from Error.cs and moved to ErrorHandling
v1.10.3: Maintenance release with latest changes from dev branch
- Synchronized with latest infrastructure updates
- No breaking changes - maintenance release
v1.10.2: Added comprehensive metadata models for AppObject and Field definitions
- Added Models/Metadata/AppObjectDefinition.cs - Full-featured base class with all infrastructure properties
- Added Models/Metadata/FieldDefinition.cs - Complete field metadata with validation, constraints, and relationships
- Added Models/Metadata/RecordInfo.cs - Audit metadata for record tracking
- Added Models/Metadata/ChildRelationship.cs - Parent-child relationship definitions
- Supporting classes: FieldTypeInfo, LookupDefinition, FieldConfiguration, Filter, SelectQueryDefinition, WhereClause
- Enables consistent metadata structure across CRUD and other microservices
- No breaking changes - additive only (existing AppObject class unchanged)
v1.10.1: Added AppObject metadata model
- Added Models/Metadata/AppObject.cs - New model for representing application objects in metadata
- Extends metadata capabilities for application object management
- No breaking changes - additive only
v1.10.0: Added CorrelationId to OperationResult
- Added CorrelationId property to both OperationResult and OperationResult<T>
- Enables request tracing across microservices
- Used for matching async responses to original requests
- Consistent response format for unified endpoint pattern (200 OK / 202 Accepted)
v1.9.2: Added bulk insert enum support
- Added new enum for bulk insert operations
- Enables standardized bulk insert patterns across TAF services
- No breaking changes - additive only
v1.9.1: Same as v1.9.2 (use v1.9.2 for latest features)
v1.9.0: Same as v1.8.0
v1.8.0: Removed redundant IsFailure property (republish)
- BREAKING CHANGE: Removed IsFailure computed property from OperationResult
- Use !IsSuccess instead of IsFailure for checking failure state
- Simplifies API surface and reduces property count
- Updated internal Error property getter to use !IsSuccess
- Updated ErrorForSerialization getter to use !IsSuccess
- Fresh build to ensure all consumers get updated version
v1.7.0: Same as v1.8.0 (use v1.8.0 instead)
v1.6.0: Added centralized OperationResult and Error classes
- Added Results/OperationResult.cs - Generic and non-generic versions for consistent API responses
- Added Results/Error.cs - Immutable error object with factory methods (Validation, NotFound, etc.)
- Includes ExecutionTimeMs, Logs, Metadata tracking for all operations
- Includes AffectedRecords, TotalRecords properties (nullable, for CRUD operations)
- Cleaned up implementation - removed unused functional methods (Match, Map, Bind)
- JSON deserialization support with parameterless constructor and mutable properties
- Shared across all TAF microservices for unified error handling and response structure
- No breaking changes - additive only (new namespace: TAF.Infra.Contract.Results)
v1.5.1: ConnectionConfig property alignment with legacy database
- Renamed ConnectionConfig.Database โ DBName to match legacy tabmd_connections JSON structure
- Renamed ConnectionConfig.Username โ UserName to match legacy tabmd_connections JSON structure
- Changed ConnectionConfig.Port type from int โ string to match legacy tabmd_connections JSON structure
- Ensures proper deserialization of existing connection configuration data
- No breaking changes for new implementations - backward compatible with old database JSON
v1.5.0: Added generic connection models
- Added Models/Connection.cs - Generic connection model aligned with tabmd_connections schema
- Added Models/ConnectionConfig.cs - Configuration structure for connection details
- Added Constants/ConnectorTypeConstants.cs - Guid constants for SQL Server and PostgreSQL
- Connection model includes TabCompatible field and uses nullable types per database schema
- Enables consistent connection management across Metadata and CRUD microservices
- No breaking changes - additive only
v1.4.0: Added shared caching interface
- Added Caching folder with ICacheService interface for cache abstraction
- Enables consistent caching pattern across all TAF microservices
- No breaking changes - additive only
v1.3.0: Added Filter and FilterCriteria contracts
- Added DTOs folder with Filter and FilterCriteria classes for shared filtering across microservices
- Added Enums folder with ConjunctionClause, FilterType, FilterValueType, RelationalOperator
- FilterCriteria now available as shared contract across all TAF services
- Breaking change: Upgrade TAF.Infra.QueryHook to use FilterCriteria in HookContext.WhereClause