feat: adds afterConstruct overload method

Author: JasonTheAdams

src/Models/Model.php

@@ -59,6 +59,18 @@ final public function __construct( array $attributes = [] ) {
 		$this->fill( array_merge( static::getPropertyDefaults(), $attributes ) );
 
 		$this->syncOriginal();
+
+		$this->afterConstruct();
+	}
+
+	/**
+	 * This method is meant to be overridden by the model to perform actions after the model is constructed.
+	 *
+	 * @since 2.0.0
+	 */
+	protected function afterConstruct() {
+		// This method is meant to be overridden by the model to perform actions after the model is constructed.
+		return;
 	}
 
 	/**

tests/_support/Helper/MockModelWithAfterConstruct.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace StellarWP\Models\Tests;
+
+use StellarWP\Models\Model;
+
+class MockModelWithAfterConstruct extends Model {
+	protected static $properties = [
+		'id' => 'int',
+		'name' => 'string',
+	];
+
+	public bool $afterConstructCalled = false;
+	public array $constructedAttributes = [];
+
+	protected function afterConstruct() {
+		$this->afterConstructCalled = true;
+		$this->constructedAttributes = $this->toArray();
+	}
+}

tests/wpunit/ModelTest.php

@@ -4,6 +4,7 @@
 
 use StellarWP\Models\Tests\ModelsTestCase;
 use StellarWP\Models\Tests\MockModel;
+use StellarWP\Models\Tests\MockModelWithAfterConstruct;
 use StellarWP\Models\Tests\MockModelWithRelationship;
 
 /**
@@ -331,6 +332,18 @@ public function testFromDataShouldThrowExceptionForNonPrimitiveTypes(): void {
 		] );
 	}
 
+	/**
+	 * @since 2.0.0
+	 *
+	 * @return void
+	 */
+	public function testOnConstructedIsCalledDuringConstruction() {
+		$model = new MockModelWithAfterConstruct( [ 'id' => 1, 'name' => 'Test' ] );
+
+		$this->assertTrue( $model->afterConstructCalled );
+		$this->assertEquals( [ 'id' => 1, 'name' => 'Test' ], $model->constructedAttributes );
+	}
+
 	/**
 	 * @since 1.0.0
 	 *