Coject.Core.Controller 1.3.3

Copyright (c) 2024 Akwad Arabia

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of Akwad Arabia shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from Akwad Arabia.

Version 1.3.3

BaseController accepts Database:Provider directly, including provider-only configuration without Database:Type. Every request database context receives the configured provider. The public DatabaseType enum property remains available for existing compiled consumers; numeric-only settings remain compatible, and conflicting provider/type selections are rejected. Database packages remain at 1.0.5. Logging.AspNetCore 1.9.1 already permits this Controller patch release.

Version 1.3.2

This release corrects named Oracle procedure parameters in the existing core DAL methods, including the SMS log error filter, permission cursor, shared Security selectors, profile language, role-responsibility module filter, and template variable filters. Application result-table names are preserved. The affected methods reset and clear their parameters between calls and preserve database errors when outputs are unavailable.

Client registration no longer declares an unsupported client-ID output. Market registration uses the procedure's validity-date inputs without sending an unsupported plan-code parameter. AD deactivation no longer reads an output that its procedure does not return. These contracts were checked against the configured Security and Message Manager schema metadata; provision, update, and deactivation procedures were tested with a recording database provider, without executing business writes against the live database. Different database seed versions need their own compatibility check.

The package now depends on Coject.Core.Database 1.0.5. Applications using Oracle must also install Coject.Core.Database.Oracle 1.0.5 and retain their provider configuration. The Controller package remains provider-neutral. Security updates include MimeKit 4.18.1, System.Security.Cryptography.Xml 10.0.13, System.Security.Cryptography.Pkcs 10.0.13, and System.Drawing.Common 10.0.13.

The permission cursor is configured by UserDAL.GetUserMethod; application code can call it directly. Existing callers that predeclare METHOD_REF continue to work. Permission-loading errors must still prevent session creation.

Standard SelectAll actions default an omitted or null page to 1 and page_size to 25. Generated action signatures use int? page = null, int? page_size = null and pass page ?? 1, page_size ?? 25 to ExecuteSelectAllAsync. The shared runtime also treats zero as omitted for existing generated actions with non-nullable integer parameters. Positive values are preserved. Negative pagination values and query binding errors are rejected before the DAL executes. The original integer helper signature is retained for existing compiled applications.

Controller runtime compatibility seam

Version 1.3.0 adds an opt-in, product-neutral DI seam for generated consumers and the shared standard-operation runtime:

services.AddControllerRuntime(serviceProvider =>
    new BaseController(
        serviceProvider.GetRequiredService<IConfiguration>(),
        serviceProvider.GetRequiredService<ISecurityTokenProvider>(),
        serviceProvider.GetRequiredService<ApiContext>()));

The factory can select any existing constructor that matches the application's registrations.

The registration adds IControllerRuntime as a scoped service. Its BaseController property returns the exact instance created by the application-supplied factory, so existing helpers, compatibility fields, authentication/status/error behavior, and CoreModuleDB semantics remain in BaseController. The library does not choose among the existing 18 constructors, register a BaseController, expose raw credentials, or depend on Coject.Core.Logging.AspNetCore.

StandardOperationController<TEntity, TDal> and StandardAuditedOperationController<TEntity, TDal> now live in this package. They retain the generated CRUD/batch/read helper surface and accept the application-owned RESPONSE, CoreModel, CoreModuleDB, DAL factory, and Contracts logger at the composition boundary. The package references Coject.Core.Logging.Contracts only; it does not depend on the Core logging provider or on an application response assembly. The audited base is explicit opt-in and enables snapshot/mutation auditing; the ordinary base leaves those switches disabled.