@quadnix/octo 0.0.22 → 0.0.24

package/dist/events/registration.event.js

@@ -6,32 +6,18 @@ import { Event } from './event.model.js';
 /**
  * The RegistrationEvent class is the superclass for all events in relation to class registration.
  *
- * :::warning Warning
- * It is not a good practice to create an event from this class directly,
- * but should rather create one from one of the subclasses.
- * This promotes a more accurate classification of events.
- * :::
+ * @group Events/Registration
  *
- * @example
- * ```ts
- * const myEvent = new RegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
 export class RegistrationEvent extends Event {
 }
 /**
- * This event is emitted when a class with `@Anchor()` decorator is registered.
+ * This event is emitted when a class with `@Anchor('my-package')` decorator is registered.
  * It emits the name of the class.
  *
- * @example
- * ```ts
- * const myEvent = new AnchorRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Registration
+ *
  * @returns The Event instance.
  */
 export class AnchorRegistrationEvent extends RegistrationEvent {
@@ -40,22 +26,17 @@ export class AnchorRegistrationEvent extends RegistrationEvent {
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
             if (args[1].prototype instanceof AAnchor) {
-                const event = new AnchorRegistrationEvent(args[1].name);
-                eventService.emit(event);
+                eventService.emit(new AnchorRegistrationEvent(args[0]));
             }
         };
     }
 }
 /**
- * This event is emitted when a class with `@Action(ModelType.MODEL)` decorator is registered.
- * It emits the name of the class.
+ * This event is emitted when a class with `@Action(ModelClass)` decorator is registered.
+ * It emits the name of the model class and the name of the action.
+ *
+ * @group Events/Registration
  *
- * @example
- * ```ts
- * const myEvent = new ModelActionRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
 export class ModelActionRegistrationEvent extends RegistrationEvent {
@@ -63,23 +44,18 @@ export class ModelActionRegistrationEvent extends RegistrationEvent {
         const originalMethod = descriptor.value;
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
-            for (const action of args[0]) {
-                const event = new ModelActionRegistrationEvent(action.ACTION_NAME);
-                eventService.emit(event);
+            for (const action of args[1]) {
+                eventService.emit(new ModelActionRegistrationEvent(`${args[0].name}:${action.constructor.name}`));
             }
         };
     }
 }
 /**
- * This event is emitted when a class with `@Model()` decorator is registered.
+ * This event is emitted when a class with `@Model('my-package')` decorator is registered.
  * It emits the name of the class.
  *
- * @example
- * ```ts
- * const myEvent = new ModelRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Registration
+ *
  * @returns The Event instance.
  */
 export class ModelRegistrationEvent extends RegistrationEvent {
@@ -88,22 +64,17 @@ export class ModelRegistrationEvent extends RegistrationEvent {
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
             if (args[1].prototype instanceof AModel) {
-                const event = new ModelRegistrationEvent(args[1].name);
-                eventService.emit(event);
+                eventService.emit(new ModelRegistrationEvent(args[0]));
             }
         };
     }
 }
 /**
- * This event is emitted when a class with `@Overlay()` decorator is registered.
+ * This event is emitted when a class with `@Overlay('my-package')` decorator is registered.
  * It emits the name of the class.
  *
- * @example
- * ```ts
- * const myEvent = new OverlayRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Registration
+ *
  * @returns The Event instance.
  */
 export class OverlayRegistrationEvent extends RegistrationEvent {
@@ -112,23 +83,17 @@ export class OverlayRegistrationEvent extends RegistrationEvent {
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
             if (args[1].prototype instanceof AOverlay) {
-                const event = new OverlayRegistrationEvent(args[1].name);
-                eventService.emit(event);
+                eventService.emit(new OverlayRegistrationEvent(args[0]));
             }
         };
     }
 }
 /**
- * This event is emitted when a class with `@Action(ModelType.RESOURCE)` or `@Action(ModelType.SHARED_RESOURCE)`
- * decorator is registered.
- * It emits the name of the class.
+ * This event is emitted when a class with `@Action(ResourceClass)` decorator is registered.
+ * It emits the name of the resource class and the name of the action.
+ *
+ * @group Events/Registration
  *
- * @example
- * ```ts
- * const myEvent = new ResourceActionRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
 export class ResourceActionRegistrationEvent extends RegistrationEvent {
@@ -136,23 +101,18 @@ export class ResourceActionRegistrationEvent extends RegistrationEvent {
         const originalMethod = descriptor.value;
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
-            for (const action of args[0]) {
-                const event = new ResourceActionRegistrationEvent(action.ACTION_NAME);
-                eventService.emit(event);
+            for (const action of args[1]) {
+                eventService.emit(new ResourceActionRegistrationEvent(`${args[0].name}:${action.constructor.name}`));
             }
         };
     }
 }
 /**
- * This event is emitted when a class with `@Resource()` decorator is registered.
+ * This event is emitted when a class with `@Resource('my-package')` decorator is registered.
  * It emits the name of the class.
  *
- * @example
- * ```ts
- * const myEvent = new ResourceRegistrationEvent('MyClass');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Registration
+ *
  * @returns The Event instance.
  */
 export class ResourceRegistrationEvent extends RegistrationEvent {
@@ -161,8 +121,7 @@ export class ResourceRegistrationEvent extends RegistrationEvent {
         descriptor.value = function (...args) {
             originalMethod.apply(this, args);
             if (args[1].prototype instanceof AResource) {
-                const event = new ResourceRegistrationEvent(args[1].name);
-                eventService.emit(event);
+                eventService.emit(new ResourceRegistrationEvent(args[0]));
             }
         };
     }

package/dist/events/registration.event.js.map

@@ -1 +1 @@
-{"version":3,"file":"registration.event.js","sourceRoot":"","sources":["../../src/events/registration.event.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registration.event.js","sourceRoot":"","sources":["../../src/events/registration.event.ts"],"names":[],"mappings":"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"}

package/dist/events/serialization.event.d.ts

@@ -1,72 +1,65 @@
+import type { ModelSerializedOutput, ResourceSerializedOutput } from '../app.type.js';
+import type { EventService } from '../services/event/event.service.js';
 import { Event } from './event.model.js';
 /**
  * The SerializationEvent class is the superclass for all events in relation to serialization and deserialization.
  *
- * :::warning Warning
- * It is not a good practice to create an event from this class directly,
- * but should rather create one from one of the subclasses.
- * This promotes a more accurate classification of events.
- * :::
+ * @group Events/Serialization
  *
- * @example
- * ```ts
- * const myEvent = new SerializationEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export declare class SerializationEvent extends Event<void> {
+export declare class SerializationEvent<T> extends Event<T> {
 }
 /**
  * This event is emitted when models are deserialized from serialized output.
  *
- * @example
- * ```ts
- * const myEvent = new ModelDeserializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
-export declare class ModelDeserializedEvent extends SerializationEvent {
+export declare class ModelDeserializedEvent extends SerializationEvent<ModelSerializedOutput> {
+    static registrar(eventService: EventService, descriptor: PropertyDescriptor): void;
 }
 /**
  * This event is emitted when models are serialized to an output.
  *
- * @example
- * ```ts
- * const myEvent = new ModelSerializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
-export declare class ModelSerializedEvent extends SerializationEvent {
+export declare class ModelSerializedEvent extends SerializationEvent<ModelSerializedOutput> {
+    static registrar(eventService: EventService, descriptor: PropertyDescriptor): void;
 }
 /**
  * This event is emitted when resources are deserialized from serialized output.
  *
- * @example
- * ```ts
- * const myEvent = new ResourceDeserializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
+ * @returns The Event instance.
+ */
+export declare class ResourceDeserializedEvent extends SerializationEvent<{
+    actual: ResourceSerializedOutput;
+    old: ResourceSerializedOutput;
+}> {
+    static registrar(eventService: EventService, descriptor: PropertyDescriptor): void;
+}
+/**
+ * This event is emitted when actual resources are serialized to an output.
+ *
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
-export declare class ResourceDeserializedEvent extends SerializationEvent {
+export declare class ActualResourceSerializedEvent extends SerializationEvent<ResourceSerializedOutput> {
+    static registrar(eventService: EventService, descriptor: PropertyDescriptor): void;
 }
 /**
- * This event is emitted when resources are serialized to an output.
+ * This event is emitted when new resources are serialized to an output.
+ *
+ * @group Events/Serialization
  *
- * @example
- * ```ts
- * const myEvent = new ResourceSerializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export declare class ResourceSerializedEvent extends SerializationEvent {
+export declare class NewResourceSerializedEvent extends SerializationEvent<ResourceSerializedOutput> {
+    static registrar(eventService: EventService, descriptor: PropertyDescriptor): void;
 }

package/dist/events/serialization.event.js

@@ -2,18 +2,8 @@ import { Event } from './event.model.js';
 /**
  * The SerializationEvent class is the superclass for all events in relation to serialization and deserialization.
  *
- * :::warning Warning
- * It is not a good practice to create an event from this class directly,
- * but should rather create one from one of the subclasses.
- * This promotes a more accurate classification of events.
- * :::
+ * @group Events/Serialization
  *
- * @example
- * ```ts
- * const myEvent = new SerializationEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
 export class SerializationEvent extends Event {
@@ -21,53 +11,85 @@ export class SerializationEvent extends Event {
 /**
  * This event is emitted when models are deserialized from serialized output.
  *
- * @example
- * ```ts
- * const myEvent = new ModelDeserializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
 export class ModelDeserializedEvent extends SerializationEvent {
+    static registrar(eventService, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await originalMethod.apply(this, args);
+            eventService.emit(new ModelDeserializedEvent(undefined, args[0]));
+            return result;
+        };
+    }
 }
 /**
  * This event is emitted when models are serialized to an output.
  *
- * @example
- * ```ts
- * const myEvent = new ModelSerializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
 export class ModelSerializedEvent extends SerializationEvent {
+    static registrar(eventService, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await originalMethod.apply(this, args);
+            eventService.emit(new ModelSerializedEvent(undefined, result));
+            return result;
+        };
+    }
 }
 /**
  * This event is emitted when resources are deserialized from serialized output.
  *
- * @example
- * ```ts
- * const myEvent = new ResourceDeserializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
+ * @group Events/Serialization
+ *
  * @returns The Event instance.
  */
 export class ResourceDeserializedEvent extends SerializationEvent {
+    static registrar(eventService, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            await originalMethod.apply(this, args);
+            eventService.emit(new ResourceDeserializedEvent(undefined, { actual: args[0], old: args[1] }));
+        };
+    }
+}
+/**
+ * This event is emitted when actual resources are serialized to an output.
+ *
+ * @group Events/Serialization
+ *
+ * @returns The Event instance.
+ */
+export class ActualResourceSerializedEvent extends SerializationEvent {
+    static registrar(eventService, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await originalMethod.apply(this, args);
+            eventService.emit(new ActualResourceSerializedEvent(undefined, result));
+            return result;
+        };
+    }
 }
 /**
- * This event is emitted when resources are serialized to an output.
+ * This event is emitted when new resources are serialized to an output.
+ *
+ * @group Events/Serialization
  *
- * @example
- * ```ts
- * const myEvent = new ResourceSerializedEvent();
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export class ResourceSerializedEvent extends SerializationEvent {
+export class NewResourceSerializedEvent extends SerializationEvent {
+    static registrar(eventService, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const result = await originalMethod.apply(this, args);
+            eventService.emit(new NewResourceSerializedEvent(undefined, result));
+            return result;
+        };
+    }
 }
 //# sourceMappingURL=serialization.event.js.map

package/dist/events/serialization.event.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.event.js","sourceRoot":"","sources":["../../src/events/serialization.event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAW;CAAG;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;CAAG;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;CAAG;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;CAAG;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAwB,SAAQ,kBAAkB;CAAG"}
+{"version":3,"file":"serialization.event.js","sourceRoot":"","sources":["../../src/events/serialization.event.ts"],"names":[],"mappings":"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"}

package/dist/events/transaction.event.d.ts

@@ -1,48 +1,91 @@
+import type { DiffMetadata } from '../functions/diff/diff-metadata.js';
 import { Event } from './event.model.js';
 /**
  * The TransactionEvent class is the superclass for all events in relation to transactions.
  * A transaction processes actions generated from model and resource diffs.
- * Thus, the events are usually in relation with these actions.
  *
- * :::warning Warning
- * It is not a good practice to create an event from this class directly,
- * but should rather create one from one of the subclasses.
- * This promotes a more accurate classification of events.
- * :::
+ * @group Events/Transaction
  *
- * @example
- * ```ts
- * const myEvent = new TransactionEvent('MyActionName');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export declare class TransactionEvent extends Event<string> {
+export declare class TransactionEvent<T> extends Event<T> {
 }
 /**
- * This event is emitted when a model action is done executing.
+ * This event is emitted when a model action in a transaction is done executing.
+ *
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ModelActionTransactionEvent extends TransactionEvent<void> {
+}
+/**
+ * This event is emitted when transaction prepares a model diff.
+
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ModelDiffsTransactionEvent extends TransactionEvent<DiffMetadata[][]> {
+}
+/**
+ * This event is emitted when transaction prepares a model transaction.
+
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ModelTransactionTransactionEvent extends TransactionEvent<DiffMetadata[][]> {
+}
+/**
+ * This event is emitted when a resource action in a transaction is done executing.
+ *
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ResourceActionCompletedTransactionEvent extends TransactionEvent<DiffMetadata> {
+}
+/**
+ * This event is emitted when a resource action in a transaction begins executing.
+ *
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ResourceActionInitiatedTransactionEvent extends TransactionEvent<DiffMetadata> {
+}
+/**
+ * This event is emitted when a resource action in a transaction is done executing.
+ * It emits a summary of the action.
+ *
+ * @group Events/Transaction
+ *
+ * @returns The Event instance.
+ */
+export declare class ResourceActionSummaryTransactionEvent extends TransactionEvent<{
+    diff: DiffMetadata;
+    values: {
+        current: unknown;
+        previous: unknown;
+    };
+}> {
+}
+/**
+ * This event is emitted when transaction prepares a resource diff.
+
+ * @group Events/Transaction
  *
- * @example
- * ```ts
- * const myEvent = new ModelActionTransactionEvent('MyActionName');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export declare class ModelActionTransactionEvent extends TransactionEvent {
+export declare class ResourceDiffsTransactionEvent extends TransactionEvent<[DiffMetadata[][], DiffMetadata[][]]> {
 }
 /**
- * This event is emitted when a resource action is done executing.
+ * This event is emitted when transaction prepares a resource transaction.
+
+ * @group Events/Transaction
  *
- * @example
- * ```ts
- * const myEvent = new ResourceActionTransactionEvent('MyActionName');
- * EventService.getInstance().emit(myEvent);
- * ```
- * @group Events
  * @returns The Event instance.
  */
-export declare class ResourceActionTransactionEvent extends TransactionEvent {
+export declare class ResourceTransactionTransactionEvent extends TransactionEvent<[DiffMetadata[][], DiffMetadata[][]]> {
 }