Skip to content

CHANGELOG.md

Latest commit

 

History

History
67 lines (38 loc) · 2.98 KB

CHANGELOG.md

File metadata and controls

67 lines (38 loc) · 2.98 KB

Changelog

All notable changes to the Maatify\SharedCommon module will be documented in this file.

The format is based on Keep a Changelog and this project follows Semantic Versioning (SemVer).

[1.0.2] - 2026-05-01

Added

  • Permission Mapping Contracts: Added neutral permission mapping contracts under Maatify\SharedCommon\Contracts\Security to allow independent modules to expose their route-to-permission requirements without depending on AdminKernel.

  • Permission Requirement Definition Value Object: Introduced PermissionRequirementDefinition as a framework-neutral value object for defining permission requirements using:

    • single permission
    • anyOf permission groups
    • allOf permission groups
    • compound anyOf + allOf requirements

  • Permission Map Provider Contract: Added PermissionMapProviderInterface to let modules provide permission maps in a consistent and type-safe way.

  • Module Permission Provider Discovery Contract: Added ProvidesPermissionMapsInterface to allow module/package-level classes to expose one or more permission map providers.

Changed

  • Permission Mapping Extensibility: Established SharedCommon as the only allowed shared dependency point for module-level permission definitions, keeping modules independent from AdminKernel while allowing the kernel/application layer to aggregate permission maps safely.

[1.0.1] - 2026-04-11

Added

  • Application Paths Utility: Introduced AppPaths in the Maatify\SharedCommon\Path namespace as a dedicated utility for resolving commonly used project paths, including root, public, public images, storage, config, and logs.

  • Nested Storage Path Resolver: Added storagePath(string $subfolder) to support consistent and reusable generation of subpaths within the storage directory.

Changed

  • Path Access Consistency: Standardized path resolution behind a dedicated utility class to provide clearer and more reusable access to common application directories.

[1.0.0] - 2026-03-11

Added

  • Bootstrap Layer: Introduced SharedCommonBindings in the Maatify\SharedCommon\Bootstrap namespace to provide a standardized way to register ClockInterface with the default SystemClock implementation in PHP-DI containers.

  • Standalone Package Preparation: Added a composer.json file to define maatify/shared-common as a standalone library, including PHP 8.2 requirements and PSR-4 autoloading configuration.

  • Comprehensive Documentation: Introduced full documentation for the module including:

    • README.md
    • HOW_TO_USE.md
    • CHANGELOG.md
    • a complete architecture and integration documentation book under docs/book/.

Changed

  • Module Packaging Preparation: Refactored the module structure and metadata to support extraction into an independent reusable package (maatify/shared-common) while keeping the current application behavior unchanged.

[Unreleased]

Future changes will be documented here.