feat(PrePost): filter with execution scope

Add the possibility to only execute PrePost decorator during the reading
or writing phase or both.

src/decorators/prepost.ts

@@ -49,7 +49,7 @@
  */
 import { ClassMetaDescriptor, type PropertyMetaDescriptor, createClassMetaDescriptor, createPropertyMetaDescriptor, recursiveGet } from './common'
 import { relationExistsOrThrow } from '../error'
-import { type ClassAndPropertyDecoratorType, type ClassAndPropertyDecoratorContext } from '../types'
+import { ExecutionScope, type ClassAndPropertyDecoratorType, type ClassAndPropertyDecoratorContext } from '../types'
 import { type Cursor, type BinaryCursorEndianness, BinaryCursor } from '../cursor'
 import Meta from '../metadatas'
 
@@ -73,11 +73,17 @@ export interface PrePostOptions {
    * Removes the decorator from metadata after its function is executed.
    */
   once: boolean
+  /**
+   * Specifies whether the prepost function should be executed during
+   * the read phase, the write phase, or both.
+   */
+  scope: ExecutionScope
 }
 
 export const PrePostOptionsDefault = {
   primitiveCheck: true,
   once: false,
+  scope: ExecutionScope.OnBoth,
 }
 
 /**
@@ -632,8 +638,10 @@ export function Endian<This> (endianness: BinaryCursorEndianness | ((instance: T
  *
  * @category Advanced Use
  */
-export function usePrePost<This> (prepost: Array<PrePost<This>> | Array<PrePostClass<This>>, targetInstance: This, cursor: Cursor): void {
+export function usePrePost<This> (prepost: Array<PrePost<This>> | Array<PrePostClass<This>>, targetInstance: This, cursor: Cursor, scope = ExecutionScope.OnBoth): void {
   prepost.forEach((x) => {
-    x.func(targetInstance, cursor)
+    if ((x.options.scope & scope) > 0) {
+      x.func(targetInstance, cursor)
+    }
   })
 }

src/reader.ts

@@ -14,7 +14,7 @@ import {
   isUnknownProperty,
   type PropertyType,
 } from './decorators/primitive'
-import { EOF, type InstantiableObject } from './types'
+import { EOF, ExecutionScope, type InstantiableObject } from './types'
 import { useController, type ControllerReader } from './decorators/controller'
 import { useTransformer } from './decorators/transformer'
 import { useValidators } from './decorators/validator'
@@ -100,10 +100,10 @@ export function binread<Target> (content: Cursor, ObjectDefinition: Instantiable
     return useBitField(bitfields, instance, content)
   }
 
-  usePrePost(Meta.getClassPre(metadata), instance, content)
+  usePrePost(Meta.getClassPre(metadata), instance, content, ExecutionScope.OnRead)
 
   Meta.getFields<Target>(metadata).forEach((field) => {
-    usePrePost(Meta.getPre(metadata, field.propertyName), instance, content)
+    usePrePost(Meta.getPre(metadata, field.propertyName), instance, content, ExecutionScope.OnRead)
 
     // TODO [Cursor] Pass the field name information to add to the namespace
     const finalRelationField = isUnknownProperty(field) ? useConditions(Meta.getConditions(field.metadata, field.propertyName), instance) : field
@@ -128,10 +128,10 @@ export function binread<Target> (content: Cursor, ObjectDefinition: Instantiable
 
       instance[field.propertyName] = transformedValue
     }
-    usePrePost(Meta.getPost(metadata, field.propertyName), instance, content)
+    usePrePost(Meta.getPost(metadata, field.propertyName), instance, content, ExecutionScope.OnRead)
   })
 
-  usePrePost(Meta.getClassPost(metadata), instance, content)
+  usePrePost(Meta.getClassPost(metadata), instance, content, ExecutionScope.OnRead)
 
   return instance
 }

src/writer.ts

@@ -64,8 +64,10 @@ export function binwrite<Target> (cursor: BinaryWriter, ObjectDefinition: Instan
     return cursor
   }
 
+  usePrePost(Meta.getClassPre(metadata), instance, cursor, ExecutionScope.OnWrite)
+
   Meta.getFields<Target>(metadata).forEach((field) => {
-    usePrePost(Meta.getPre(metadata, field.propertyName), instance, cursor)
+    usePrePost(Meta.getPre(metadata, field.propertyName), instance, cursor, ExecutionScope.OnWrite)
 
     const finalRelationField = isUnknownProperty(field) ? useConditions(Meta.getConditions(field.metadata, field.propertyName), instance) : field
     if (finalRelationField !== undefined) {
@@ -80,9 +82,11 @@ export function binwrite<Target> (cursor: BinaryWriter, ObjectDefinition: Instan
       // NullString should add back the \0
       // targetType sin
     }
-    usePrePost(Meta.getPost(metadata, field.propertyName), instance, cursor)
+    usePrePost(Meta.getPost(metadata, field.propertyName), instance, cursor, ExecutionScope.OnWrite)
   })
 
+  usePrePost(Meta.getClassPost(metadata), instance, cursor, ExecutionScope.OnWrite)
+
   return cursor
 }