@quadnix/octo 0.0.22 → 0.0.24

package/dist/decorators/resource.decorator.d.ts

@@ -1,14 +1,25 @@
+import { type Constructable, type ResourceSchema, type UnknownResource } from '../app.type.js';
 /**
- * A `@Resource` is a class decorator to be placed on top of a class that represents a resource.
- * - A resource must extend the {@link AResource} class.
+ * A `@Resource` is a class decorator and must be placed on top of a class representing a resource.
+ * - A resource must also extend the {@link AResource} class.
+ * - For type safety, the type of resource being decorated is passed to the decorator.
  *
  * @example
  * ```ts
- * @Resource()
- * export class MyResource extends AResource<MyResource> { ... }
+ * @Resource<MyResource>('@example', 'my-name', MyResourceSchema)
+ * export class MyResource extends AResource<MyResourceSchema, MyResource> { ... }
  * ```
+ *
  * @group Decorators
+ *
+ * @param packageName - The name of the package under which the resource is registered.
+ * Selecting a unique package name helps avoid collisions between same resource class names across different libraries.
+ * You will reuse the same package name throughout your library for different Octo components you create.
+ * @param resourceName - a string that uniquely represents the name of the resource.
+ * @param schema - The schema of the resource.
+ *
  * @returns The decorated class.
- * @see Definition of [Resources](http://localhost:3000/docs/fundamentals/resources).
+ *
+ * @see Definition of [Resources](/docs/fundamentals/resources).
  */
-export declare function Resource(): (constructor: any) => void;
+export declare function Resource<T extends UnknownResource>(packageName: string, resourceName: string, schema: Constructable<ResourceSchema<T>>): (constructor: any) => void;

package/dist/decorators/resource.decorator.js

@@ -1,29 +1,51 @@
-import { RegistrationErrorEvent } from '../events/error.event.js';
-import { EventService } from '../services/event/event.service.js';
-import { ResourceSerializationService } from '../services/serialization/resource/resource-serialization.service.js';
+import { NodeType } from '../app.type.js';
 import { Container } from '../functions/container/container.js';
+import { AResource } from '../resources/resource.abstract.js';
+import { ResourceSerializationService } from '../services/serialization/resource/resource-serialization.service.js';
+import { ValidationUtility } from '../utilities/validation/validation.utility.js';
 /**
- * A `@Resource` is a class decorator to be placed on top of a class that represents a resource.
- * - A resource must extend the {@link AResource} class.
+ * A `@Resource` is a class decorator and must be placed on top of a class representing a resource.
+ * - A resource must also extend the {@link AResource} class.
+ * - For type safety, the type of resource being decorated is passed to the decorator.
  *
  * @example
  * ```ts
- * @Resource()
- * export class MyResource extends AResource<MyResource> { ... }
+ * @Resource<MyResource>('@example', 'my-name', MyResourceSchema)
+ * export class MyResource extends AResource<MyResourceSchema, MyResource> { ... }
  * ```
+ *
  * @group Decorators
+ *
+ * @param packageName - The name of the package under which the resource is registered.
+ * Selecting a unique package name helps avoid collisions between same resource class names across different libraries.
+ * You will reuse the same package name throughout your library for different Octo components you create.
+ * @param resourceName - a string that uniquely represents the name of the resource.
+ * @param schema - The schema of the resource.
+ *
  * @returns The decorated class.
- * @see Definition of [Resources](http://localhost:3000/docs/fundamentals/resources).
+ *
+ * @see Definition of [Resources](/docs/fundamentals/resources).
  */
-export function Resource() {
+export function Resource(packageName, resourceName, schema) {
+    const container = Container.getInstance();
     return function (constructor) {
-        Container.get(ResourceSerializationService)
-            .then((resourceSerializationService) => {
-            resourceSerializationService.registerClass(constructor.name, constructor);
-        })
-            .catch((error) => {
-            EventService.getInstance().emit(new RegistrationErrorEvent(error));
+        if (!ValidationUtility.validateRegex(packageName, /^[@A-Za-z][\w-]+[A-Za-z]$/)) {
+            throw new Error(`Invalid package name: ${packageName}`);
+        }
+        if (!ValidationUtility.validateRegex(resourceName, /^[A-Za-z][\w-]+[A-Za-z]$/)) {
+            throw new Error(`Invalid resource name: ${resourceName}`);
+        }
+        if (!(constructor.prototype instanceof AResource)) {
+            throw new Error(`Class "${constructor.name}" must extend the AResource class!`);
+        }
+        constructor.NODE_NAME = resourceName;
+        constructor.NODE_PACKAGE = packageName;
+        constructor.NODE_SCHEMA = schema;
+        constructor.NODE_TYPE = NodeType.RESOURCE;
+        const promise = container.get(ResourceSerializationService).then((resourceSerializationService) => {
+            resourceSerializationService.registerClass(`${packageName}/${constructor.name}`, constructor);
         });
+        container.registerStartupUnhandledPromise(promise);
     };
 }
 //# sourceMappingURL=resource.decorator.js.map

package/dist/decorators/resource.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../src/decorators/resource.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,sEAAsE,CAAC;AACpH,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,UAAU,WAAgB;QAC/B,SAAS,CAAC,GAAG,CAAC,4BAA4B,CAAC;aACxC,IAAI,CAAC,CAAC,4BAA4B,EAAE,EAAE;YACrC,4BAA4B,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,YAAY,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../src/decorators/resource.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,QAAQ,EAA6C,MAAM,gBAAgB,CAAC;AACzG,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sEAAsE,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CACtB,WAAmB,EACnB,YAAoB,EACpB,MAAwC;IAExC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAE1C,OAAO,UAAU,WAAgB;QAC/B,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,WAAW,EAAE,2BAA2B,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,YAAY,EAAE,0BAA0B,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,YAAY,SAAS,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,UAAU,WAAW,CAAC,IAAI,oCAAoC,CAAC,CAAC;QAClF,CAAC;QAED,WAAW,CAAC,SAAS,GAAG,YAAY,CAAC;QACrC,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC;QACvC,WAAW,CAAC,WAAW,GAAG,MAAM,CAAC;QACjC,WAAW,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAE1C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,IAAI,CAAC,CAAC,4BAA4B,EAAE,EAAE;YAChG,4BAA4B,CAAC,aAAa,CAAC,GAAG,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;QAChG,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/validate.decorator.d.ts

@@ -1,9 +1,17 @@
-import type { ValidationType } from '../app.type.js';
+import type { ValidationType, ValidationTypeOptions } from '../app.type.js';
 type ValidationOptions<T> = {
+    destruct?: (value: any) => T[];
     options: {
-        [key in ValidationType]?: any;
+        [key in ValidationType]?: ValidationTypeOptions[key];
     };
-    destruct?: (value: any) => T[];
 };
-export declare function Validate<T>(validators: ValidationOptions<T> | ValidationOptions<T>[]): (target: any, propertyKey: string) => void;
+/**
+ * A `@Validate` is a property decorator to validate a property.
+ * It is typically used in {@link Schema} to validate schema properties.
+ *
+ * @group Decorators
+ *
+ * @see Techniques for [Validation](/docs/techniques/validation).
+ */
+export declare function Validate<T>(validators: ValidationOptions<T> | ValidationOptions<T>[], transform?: (value: any) => any): (target: any, propertyKey: string) => void;
 export {};

package/dist/decorators/validate.decorator.js

@@ -1,20 +1,42 @@
+import { ValidationTransactionError } from '../errors/index.js';
 import { ValidationService } from '../services/validation/validation.service.js';
-export function Validate(validators) {
+/**
+ * A `@Validate` is a property decorator to validate a property.
+ * It is typically used in {@link Schema} to validate schema properties.
+ *
+ * @group Decorators
+ *
+ * @see Techniques for [Validation](/docs/techniques/validation).
+ */
+export function Validate(validators, transform) {
     return function (target, propertyKey) {
         const symbol = Symbol();
         Object.defineProperty(target, propertyKey, {
+            enumerable: true,
             get: function () {
                 return this[symbol];
             },
             set: function (newValue) {
+                if (newValue === undefined) {
+                    this[symbol] = undefined;
+                    return;
+                }
+                if (transform) {
+                    newValue = transform(newValue);
+                }
                 if (!Array.isArray(validators)) {
                     validators = [validators];
                 }
+                const validationService = new ValidationService();
                 for (const validator of validators) {
                     for (const [type, constraint] of Object.entries(validator.options)) {
-                        ValidationService.getInstance().addSubject(type, constraint, target, propertyKey, newValue, validator.destruct);
+                        validationService.addSubject(type, constraint, target, propertyKey, newValue, validator.destruct);
                     }
                 }
+                const result = validationService.validate();
+                if (!result.pass) {
+                    throw new ValidationTransactionError('Validation error!', result);
+                }
                 this[symbol] = newValue;
             },
         });

package/dist/decorators/validate.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.decorator.js","sourceRoot":"","sources":["../../src/decorators/validate.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAOjF,MAAM,UAAU,QAAQ,CACtB,UAAyD;IAEzD,OAAO,UAAU,MAAW,EAAE,WAAmB;QAC/C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,GAAG,EAAE;gBACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;YACD,GAAG,EAAE,UAAU,QAAa;gBAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC/B,UAAU,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBACnE,iBAAiB,CAAC,WAAW,EAAE,CAAC,UAAU,CACxC,IAAsB,EACtB,UAAU,EACV,MAAM,EACN,WAAW,EACX,QAAQ,EACR,SAAS,CAAC,QAAQ,CACnB,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;YAC1B,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"validate.decorator.js","sourceRoot":"","sources":["../../src/decorators/validate.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAOjF;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,UAAyD,EACzD,SAA+B;IAE/B,OAAO,UAAU,MAAW,EAAE,WAAmB;QAC/C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QAExB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACzC,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE;gBACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;YACD,GAAG,EAAE,UAAU,QAAa;gBAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;oBACzB,OAAO;gBACT,CAAC;gBAED,IAAI,SAAS,EAAE,CAAC;oBACd,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACjC,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC/B,UAAU,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;gBAClD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBACnE,iBAAiB,CAAC,UAAU,CAC1B,IAAsB,EACtB,UAAU,EACV,MAAM,EACN,WAAW,EACX,QAAQ,EACR,SAAS,CAAC,QAAQ,CACnB,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC;gBAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACjB,MAAM,IAAI,0BAA0B,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;gBACpE,CAAC;gBAED,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;YAC1B,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/errors/container.error.d.ts

@@ -0,0 +1,20 @@
+import type { Constructable } from '../app.type.js';
+/**
+ * @group Errors/Container
+ */
+export declare class ContainerError extends Error {
+    readonly type: string;
+    constructor(message: string, type: Constructable<unknown> | string);
+}
+/**
+ * @group Errors/Container
+ */
+export declare class ContainerRegistrationError extends ContainerError {
+    constructor(message: string, type: Constructable<unknown> | string);
+}
+/**
+ * @group Errors/Container
+ */
+export declare class ContainerResolutionError extends ContainerError {
+    constructor(message: string, type: Constructable<unknown> | string);
+}

package/dist/errors/container.error.js

@@ -0,0 +1,29 @@
+/**
+ * @group Errors/Container
+ */
+export class ContainerError extends Error {
+    constructor(message, type) {
+        super(message);
+        this.type = typeof type === 'string' ? type : type.name;
+        Object.setPrototypeOf(this, ContainerError.prototype);
+    }
+}
+/**
+ * @group Errors/Container
+ */
+export class ContainerRegistrationError extends ContainerError {
+    constructor(message, type) {
+        super(message, type);
+        Object.setPrototypeOf(this, ContainerRegistrationError.prototype);
+    }
+}
+/**
+ * @group Errors/Container
+ */
+export class ContainerResolutionError extends ContainerError {
+    constructor(message, type) {
+        super(message, type);
+        Object.setPrototypeOf(this, ContainerResolutionError.prototype);
+    }
+}
+//# sourceMappingURL=container.error.js.map

package/dist/errors/container.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.error.js","sourceRoot":"","sources":["../../src/errors/container.error.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGvC,YAAY,OAAe,EAAE,IAAqC;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAExD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IAC5D,YAAY,OAAe,EAAE,IAAqC;QAChE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAErB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAC1D,YAAY,OAAe,EAAE,IAAqC;QAChE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAErB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,6 @@
+export * from './container.error.js';
+export * from './input.error.js';
+export * from './module.error.js';
+export * from './node.error.js';
+export * from './schema.error.js';
+export * from './transaction.error.js';

package/dist/errors/index.js

@@ -0,0 +1,7 @@
+export * from './container.error.js';
+export * from './input.error.js';
+export * from './module.error.js';
+export * from './node.error.js';
+export * from './schema.error.js';
+export * from './transaction.error.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/errors/input.error.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Parent error class for all input errors.
+ *
+ * @group Errors/Input
+ */
+export declare class InputError extends Error {
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     */
+    constructor(message: string);
+}
+/**
+ * Error class for input registration errors.
+ * This error is thrown when an input key cannot be registered,
+ * either because it has already been registered, or is not a valid input key,
+ * or is not a valid input value.
+ *
+ * @group Errors/Input
+ */
+export declare class InputRegistrationError extends InputError {
+    readonly inputKey: string;
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     * @param inputKey The input key for which the error occurred.
+     */
+    constructor(message: string, inputKey: string);
+}
+/**
+ * Error class for input resolution errors.
+ * This error is thrown when an input key cannot be resolved at runtime.
+ * Some common reasons include invalid values found during resolution,
+ * or invalid references used to resolve the input key.
+ *
+ * @group Errors/Input
+ */
+export declare class InputResolutionError extends InputError {
+    readonly inputKey: string;
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     * @param inputKey The input key for which the error occurred.
+     */
+    constructor(message: string, inputKey: string);
+}

package/dist/errors/input.error.js

@@ -0,0 +1,59 @@
+/**
+ * Parent error class for all input errors.
+ *
+ * @group Errors/Input
+ */
+export class InputError extends Error {
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     */
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, InputError.prototype);
+    }
+}
+/**
+ * Error class for input registration errors.
+ * This error is thrown when an input key cannot be registered,
+ * either because it has already been registered, or is not a valid input key,
+ * or is not a valid input value.
+ *
+ * @group Errors/Input
+ */
+export class InputRegistrationError extends InputError {
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     * @param inputKey The input key for which the error occurred.
+     */
+    constructor(message, inputKey) {
+        super(message);
+        this.inputKey = inputKey;
+        Object.setPrototypeOf(this, InputRegistrationError.prototype);
+    }
+}
+/**
+ * Error class for input resolution errors.
+ * This error is thrown when an input key cannot be resolved at runtime.
+ * Some common reasons include invalid values found during resolution,
+ * or invalid references used to resolve the input key.
+ *
+ * @group Errors/Input
+ */
+export class InputResolutionError extends InputError {
+    /**
+     * Creates a new instance.
+     *
+     * @param message The error message.
+     * @param inputKey The input key for which the error occurred.
+     */
+    constructor(message, inputKey) {
+        super(message);
+        this.inputKey = inputKey;
+        Object.setPrototypeOf(this, InputResolutionError.prototype);
+    }
+}
+//# sourceMappingURL=input.error.js.map

package/dist/errors/input.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.error.js","sourceRoot":"","sources":["../../src/errors/input.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC;;;;OAIG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAGpD;;;;;OAKG;IACH,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAGlD;;;;;OAKG;IACH,YAAY,OAAe,EAAE,QAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/errors/module.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @group Errors/Module
+ */
+export declare class ModuleError extends Error {
+    readonly module: string;
+    constructor(message: string, moduleName: string);
+}

package/dist/errors/module.error.js

@@ -0,0 +1,11 @@
+/**
+ * @group Errors/Module
+ */
+export class ModuleError extends Error {
+    constructor(message, moduleName) {
+        super(message);
+        this.module = moduleName;
+        Object.setPrototypeOf(this, ModuleError.prototype);
+    }
+}
+//# sourceMappingURL=module.error.js.map

package/dist/errors/module.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.error.js","sourceRoot":"","sources":["../../src/errors/module.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QAEzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/errors/node.error.d.ts

@@ -0,0 +1,63 @@
+import type { UnknownModel, UnknownNode, UnknownOverlay, UnknownResource } from '../app.type.js';
+import type { Dependency, IDependency } from '../functions/dependency/dependency.js';
+import type { Diff } from '../functions/diff/diff.js';
+import type { AResource } from '../resources/resource.abstract.js';
+/**
+ * @group Errors/Node
+ */
+export declare class DependencyError extends Error {
+    readonly dependency: IDependency;
+    constructor(message: string, dependency: Dependency);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class NodeUnsynthError extends Error {
+    readonly subject: string;
+    constructor(message: string, subject: string);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class NodeError extends Error {
+    readonly node: string;
+    constructor(message: string, node: typeof AResource | UnknownNode);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class ContextNodeError extends NodeError {
+    constructor(message: string, node: UnknownNode);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class ModelError extends NodeError {
+    constructor(message: string, model: UnknownModel);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class OverlayError extends NodeError {
+    constructor(message: string, overlay: UnknownOverlay);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class ResourceError extends NodeError {
+    constructor(message: string, resource: typeof AResource | UnknownResource);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class DiffInverseResourceError extends ResourceError {
+    readonly diff: ReturnType<Diff['toJSON']>;
+    constructor(message: string, resource: UnknownResource, diff: Diff);
+}
+/**
+ * @group Errors/Node
+ */
+export declare class RemoveResourceError extends ResourceError {
+    readonly childrenResources: string[];
+    constructor(message: string, resource: UnknownResource, childrenResources: UnknownResource[]);
+}

package/dist/errors/node.error.js

@@ -0,0 +1,87 @@
+/**
+ * @group Errors/Node
+ */
+export class DependencyError extends Error {
+    constructor(message, dependency) {
+        super(message);
+        this.dependency = dependency.synth();
+        Object.setPrototypeOf(this, DependencyError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class NodeUnsynthError extends Error {
+    constructor(message, subject) {
+        super(message);
+        this.subject = subject;
+        Object.setPrototypeOf(this, NodeUnsynthError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class NodeError extends Error {
+    constructor(message, node) {
+        super(message);
+        this.node = node.NODE_NAME || node.constructor.NODE_NAME;
+        Object.setPrototypeOf(this, NodeError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class ContextNodeError extends NodeError {
+    constructor(message, node) {
+        super(message, node);
+        Object.setPrototypeOf(this, ContextNodeError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class ModelError extends NodeError {
+    constructor(message, model) {
+        super(message, model);
+        Object.setPrototypeOf(this, ModelError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class OverlayError extends NodeError {
+    constructor(message, overlay) {
+        super(message, overlay);
+        Object.setPrototypeOf(this, OverlayError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class ResourceError extends NodeError {
+    constructor(message, resource) {
+        super(message, resource);
+        Object.setPrototypeOf(this, ResourceError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class DiffInverseResourceError extends ResourceError {
+    constructor(message, resource, diff) {
+        super(message, resource);
+        this.diff = diff.toJSON();
+        Object.setPrototypeOf(this, DiffInverseResourceError.prototype);
+    }
+}
+/**
+ * @group Errors/Node
+ */
+export class RemoveResourceError extends ResourceError {
+    constructor(message, resource, childrenResources) {
+        super(message, resource);
+        this.childrenResources = childrenResources.map((r) => r.constructor.NODE_NAME);
+        Object.setPrototypeOf(this, RemoveResourceError.prototype);
+    }
+}
+//# sourceMappingURL=node.error.js.map

package/dist/errors/node.error.js.map

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

package/dist/errors/schema.error.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @group Errors/Schema
+ */
+export declare class SchemaError extends Error {
+    readonly schemaClassName: string;
+    constructor(message: string, schemaClassName: string);
+}

package/dist/errors/schema.error.js

@@ -0,0 +1,11 @@
+/**
+ * @group Errors/Schema
+ */
+export class SchemaError extends Error {
+    constructor(message, schemaClassName) {
+        super(message);
+        this.schemaClassName = schemaClassName;
+        Object.setPrototypeOf(this, SchemaError.prototype);
+    }
+}
+//# sourceMappingURL=schema.error.js.map

package/dist/errors/schema.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.error.js","sourceRoot":"","sources":["../../src/errors/schema.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe,EAAE,eAAuB;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/errors/transaction.error.d.ts

@@ -0,0 +1,56 @@
+import type { IUnknownModelAction, UnknownResource } from '../app.type.js';
+import type { Diff } from '../functions/diff/diff.js';
+import type { ValidationService } from '../services/validation/validation.service.js';
+/**
+ * @group Errors/Transaction
+ */
+export declare class TransactionError extends Error {
+    constructor(message: string);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class DiffsOnDirtyResourcesTransactionError extends TransactionError {
+    readonly diffs: ReturnType<Diff['toJSON']>[];
+    readonly dirtyResources: UnknownResource[];
+    constructor(message: string, diffs: Diff[], dirtyResources: UnknownResource[]);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class InputNotFoundTransactionError extends TransactionError {
+    readonly action: string;
+    readonly diff: ReturnType<Diff['toJSON']>;
+    readonly key: string;
+    constructor(message: string, action: IUnknownModelAction, diff: Diff, key: string);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class NoMatchingActionFoundTransactionError extends TransactionError {
+    readonly diff: ReturnType<Diff['toJSON']>;
+    constructor(message: string, diff: Diff);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class ResourceActionExceptionTransactionError extends TransactionError {
+    readonly actionClassName: string;
+    readonly diff: ReturnType<Diff['toJSON']>;
+    constructor(message: string, originalError: Error, diff: Diff, actionClassName: string);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class ResourceActionTimeoutTransactionError extends TransactionError {
+    readonly actionClassName: string;
+    readonly diff: ReturnType<Diff['toJSON']>;
+    constructor(message: string, diff: Diff, actionClassName: string);
+}
+/**
+ * @group Errors/Transaction
+ */
+export declare class ValidationTransactionError extends TransactionError {
+    errors: ReturnType<ValidationService['validate']>;
+    constructor(message: string, errors: ReturnType<ValidationService['validate']>);
+}