@quadnix/octo 0.0.21 → 0.0.23

package/dist/app.type.d.ts

@@ -1,32 +1,112 @@
 import type { IDependency } from './functions/dependency/dependency.js';
-import type { IAnchor } from './overlays/anchor.interface.js';
-import type { AOverlay } from './overlays/overlay.abstract.js';
+import type { ANode } from './functions/node/node.abstract.js';
+import type { IModelAction } from './models/model-action.interface.js';
 import type { AModel } from './models/model.abstract.js';
 import type { IModel } from './models/model.interface.js';
-import type { IOverlay } from './overlays/overlay.interface.js';
+import type { AModule } from './modules/module.abstract.js';
+import type { AAnchor } from './overlays/anchor.abstract.js';
+import type { BaseAnchorSchema } from './overlays/anchor.schema.js';
+import type { AOverlay } from './overlays/overlay.abstract.js';
+import type { BaseOverlaySchema } from './overlays/overlay.schema.js';
+import type { IResourceAction } from './resources/resource-action.interface.js';
 import type { AResource } from './resources/resource.abstract.js';
-import type { IResource } from './resources/resource.interface.js';
-import type { ASharedResource } from './resources/shared-resource.abstract.js';
-export declare enum ModelType {
+import type { BaseResourceSchema } from './resources/resource.schema.js';
+import type { ValidationUtility } from './utilities/validation/validation.utility.js';
+export declare class MatchingAnchor<S extends BaseAnchorSchema> {
+    private readonly actual;
+    private readonly schemaTranslator?;
+    constructor(actual: AAnchor<S, any>, schemaTranslator?: ((synth: any) => S) | undefined);
+    hasSchemaTranslator(): boolean;
+    getActual(): AAnchor<Omit<S, 'properties'> & {
+        properties: Record<never, never>;
+    }, any>;
+    getSchemaInstance(): S;
+}
+export declare class MatchingModel<S extends object> {
+    private readonly actual;
+    private readonly schemaTranslator?;
+    constructor(actual: AModel<S, any>, schemaTranslator?: ((synth: any) => S) | undefined);
+    hasSchemaTranslator(): boolean;
+    getActual(): AModel<Record<never, never>, any>;
+    getSchemaInstance(): S;
+}
+export declare class MatchingResource<S extends BaseResourceSchema> {
+    private readonly actual;
+    readonly schemaTranslator?: ((synth: BaseResourceSchema) => S) | undefined;
+    constructor(actual: AResource<S, any>, schemaTranslator?: ((synth: BaseResourceSchema) => S) | undefined);
+    addChild(...args: Parameters<AResource<BaseResourceSchema, any>['addChild']>): ReturnType<AResource<BaseResourceSchema, any>['addChild']>;
+    hasSchemaTranslator(): boolean;
+    getActual(): AResource<Omit<S, 'properties' | 'response' | 'tags'> & {
+        properties: Record<never, never>;
+    } & {
+        response: Record<never, never>;
+    } & {
+        tags: Record<never, never>;
+    }, any>;
+    getSchemaInstance(): S;
+    getSchemaInstanceInResourceAction(): Omit<S, 'response'> & {
+        response: Required<S['response']>;
+    };
+}
+export declare enum NodeType {
     MODEL = "model",
     OVERLAY = "overlay",
-    RESOURCE = "resource",
-    SHARED_RESOURCE = "shared-resource"
+    RESOURCE = "resource"
 }
 export declare enum ValidationType {
+    CUSTOM = "custom",
+    IS_MODEL = "isModel",
+    IS_OVERLAY = "isOverlay",
+    IS_RESOURCE = "isResource",
+    IS_SCHEMA = "isSchema",
     MAX_LENGTH = "maxLength",
     MIN_LENGTH = "minLength",
     REGEX = "regex"
 }
-export type ActionInputs = {
-    [key: string]: string | UnknownResource;
+export type ValidationTypeOptions = {
+    [ValidationType.CUSTOM]: Parameters<typeof ValidationUtility.validateCustom>[1];
+    [ValidationType.IS_MODEL]: Parameters<typeof ValidationUtility.validateIsModel>[1];
+    [ValidationType.IS_OVERLAY]: Parameters<typeof ValidationUtility.validateIsOverlay>[1];
+    [ValidationType.IS_RESOURCE]: Parameters<typeof ValidationUtility.validateIsResource>[1];
+    [ValidationType.IS_SCHEMA]: Parameters<typeof ValidationUtility.validateIsSchema>[1];
+    [ValidationType.MAX_LENGTH]: Parameters<typeof ValidationUtility.validateMaxLength>[1];
+    [ValidationType.MIN_LENGTH]: Parameters<typeof ValidationUtility.validateMinLength>[1];
+    [ValidationType.REGEX]: Parameters<typeof ValidationUtility.validateRegex>[1];
 };
+export declare function hasNodeName(node: UnknownNode, nodeName: string): boolean;
+export declare function stub<T>(value: string): T;
+export type ActionInputs = EnhancedModuleSchema<UnknownModule>;
 export type ActionOutputs = {
     [key: string]: UnknownResource;
 };
+export type ClassRequiredProperties<T> = {
+    [K in keyof T]: undefined extends T[K] ? never : K;
+}[keyof T];
+export type ClassOptionalProperties<T> = {
+    [K in keyof T]: undefined extends T[K] ? K : never;
+}[keyof T];
+export type DiffValueTypePropertyUpdate = {
+    key: string;
+    value: unknown;
+};
+export type DiffValueTypeTagUpdate = {
+    add: {
+        [key: string]: string;
+    };
+    delete: string[];
+    update: {
+        [key: string]: string;
+    };
+};
+export type ObjectKeyValue<T> = {
+    [K in keyof T]: {
+        key: K;
+        value: T[K];
+    };
+}[keyof T];
 export type Constructable<T> = new (...args: any[]) => T;
 export type ModelSerializedOutput = {
-    anchors: (IAnchor & {
+    anchors: (AnchorSchema<UnknownAnchor> & {
         className: string;
     })[];
     dependencies: IDependency[];
@@ -38,24 +118,15 @@ export type ModelSerializedOutput = {
     };
     overlays: {
         className: string;
-        overlay: IOverlay;
+        overlay: OverlaySchema<UnknownOverlay>;
     }[];
 };
-export type ModifyInterface<T, R> = Omit<T, keyof R> & R;
 export type ResourceSerializedOutput = {
     dependencies: IDependency[];
     resources: {
         [p: string]: {
             className: string;
-            context: string;
-            resource: IResource;
-        };
-    };
-    sharedResources: {
-        [p: string]: {
-            className: string;
-            context: string;
-            resource: IResource;
+            resource: BaseResourceSchema;
         };
     };
 };
@@ -66,8 +137,34 @@ export type TransactionOptions = {
     yieldResourceDiffs?: boolean;
     yieldResourceTransaction?: boolean;
 };
-export type IUnknownModel = IModel<unknown, unknown>;
-export type UnknownModel = AModel<unknown, unknown>;
-export type UnknownOverlay = AOverlay<unknown>;
-export type UnknownResource = AResource<unknown>;
-export type UnknownSharedResource = ASharedResource<unknown>;
+export type ModifyInterface<T, R> = Omit<T, keyof R> & R;
+export type AnchorSchema<T> = T extends AAnchor<infer S, any> ? S : never;
+export type EnhancedModuleSchema<T extends UnknownModule> = {
+    inputs: {
+        [K in keyof ModuleSchemaInputs<T>]: ModuleSchema<T>[K];
+    };
+    metadata: Awaited<ReturnType<T['registerMetadata']>>;
+    models: Record<string, UnknownModel>;
+    overlays: Record<string, UnknownOverlay>;
+    resources: Record<string, UnknownResource>;
+};
+export type ModelSchema<T> = T extends AModel<infer S, any> ? S : never;
+export type ModuleOutput<M> = M extends AModule<any, infer T> ? T : never;
+export type ModuleSchema<T> = T extends AModule<infer S, any> ? S : never;
+export type ModuleSchemaInputs<T> = {
+    [K in ClassRequiredProperties<ModuleSchema<T>>]: ModuleSchema<T>[K];
+} & {
+    [K in ClassOptionalProperties<ModuleSchema<T>>]?: ModuleSchema<T>[K];
+};
+export type NodeSchema<T> = T extends ANode<infer S, any> ? S : never;
+export type OverlaySchema<T> = T extends AOverlay<infer S, any> ? S : never;
+export type ResourceSchema<T> = T extends AResource<infer S, any> ? S : never;
+export type IUnknownModel = IModel<unknown, any>;
+export type IUnknownModelAction = IModelAction<any>;
+export type IUnknownResourceAction = IResourceAction<any>;
+export type UnknownAnchor = AAnchor<BaseAnchorSchema, UnknownModel>;
+export type UnknownModel = AModel<unknown, any>;
+export type UnknownModule = AModule<unknown, any>;
+export type UnknownNode = ANode<unknown, unknown>;
+export type UnknownOverlay = AOverlay<BaseOverlaySchema, any>;
+export type UnknownResource = AResource<any, any>;

package/dist/app.type.js

@@ -1,14 +1,84 @@
-export var ModelType;
-(function (ModelType) {
-    ModelType["MODEL"] = "model";
-    ModelType["OVERLAY"] = "overlay";
-    ModelType["RESOURCE"] = "resource";
-    ModelType["SHARED_RESOURCE"] = "shared-resource";
-})(ModelType || (ModelType = {}));
+/* Classes */
+export class MatchingAnchor {
+    constructor(actual, schemaTranslator) {
+        this.actual = actual;
+        this.schemaTranslator = schemaTranslator;
+    }
+    hasSchemaTranslator() {
+        return !!this.schemaTranslator;
+    }
+    getActual() {
+        return this.actual;
+    }
+    getSchemaInstance() {
+        return this.hasSchemaTranslator() ? this.schemaTranslator(this.actual.synth()) : this.actual.synth();
+    }
+}
+export class MatchingModel {
+    constructor(actual, schemaTranslator) {
+        this.actual = actual;
+        this.schemaTranslator = schemaTranslator;
+    }
+    hasSchemaTranslator() {
+        return !!this.schemaTranslator;
+    }
+    getActual() {
+        return this.actual;
+    }
+    getSchemaInstance() {
+        return this.hasSchemaTranslator() ? this.schemaTranslator(this.actual.synth()) : this.actual.synth();
+    }
+}
+export class MatchingResource {
+    constructor(actual, schemaTranslator) {
+        this.actual = actual;
+        this.schemaTranslator = schemaTranslator;
+    }
+    addChild(...args) {
+        const results = this.actual.addChild(...args);
+        if (!(args[1].parents[args[1].parents.length - 1] instanceof MatchingResource) &&
+            args[1].parents[args[1].parents.length - 1].resourceId === this.getActual().resourceId) {
+            args[1].parents.pop();
+            args[1].parents.push(this);
+        }
+        return results;
+    }
+    hasSchemaTranslator() {
+        return !!this.schemaTranslator;
+    }
+    getActual() {
+        return this.actual;
+    }
+    getSchemaInstance() {
+        return this.hasSchemaTranslator() ? this.schemaTranslator(this.actual.synth()) : this.actual.synth();
+    }
+    getSchemaInstanceInResourceAction() {
+        return this.getSchemaInstance();
+    }
+}
+/* Enumerations */
+export var NodeType;
+(function (NodeType) {
+    NodeType["MODEL"] = "model";
+    NodeType["OVERLAY"] = "overlay";
+    NodeType["RESOURCE"] = "resource";
+})(NodeType || (NodeType = {}));
 export var ValidationType;
 (function (ValidationType) {
+    ValidationType["CUSTOM"] = "custom";
+    ValidationType["IS_MODEL"] = "isModel";
+    ValidationType["IS_OVERLAY"] = "isOverlay";
+    ValidationType["IS_RESOURCE"] = "isResource";
+    ValidationType["IS_SCHEMA"] = "isSchema";
     ValidationType["MAX_LENGTH"] = "maxLength";
     ValidationType["MIN_LENGTH"] = "minLength";
     ValidationType["REGEX"] = "regex";
 })(ValidationType || (ValidationType = {}));
+/* Functions */
+export function hasNodeName(node, nodeName) {
+    return node.constructor.NODE_NAME === nodeName;
+}
+export function stub(value) {
+    return value;
+}
 //# sourceMappingURL=app.type.js.map

package/dist/app.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.type.js","sourceRoot":"","sources":["../src/app.type.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;IACrB,gDAAmC,CAAA;AACrC,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAED,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,0CAAwB,CAAA;IACxB,0CAAwB,CAAA;IACxB,iCAAe,CAAA;AACjB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB"}
+{"version":3,"file":"app.type.js","sourceRoot":"","sources":["../src/app.type.ts"],"names":[],"mappings":"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"}

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

@@ -1,19 +1,18 @@
-import { ModelType } from '../app.type.js';
+import type { Constructable, UnknownNode } from '../app.type.js';
 /**
  * An `@Action` is a class decorator to be placed on top of a class that represents an action of one of ModelType.
- * - A ModelType.MODEL action must implement the {@link IModelAction} interface.
- * - A ModelType.OVERLAY action must implement the {@link IModelAction} interface.
- * - A ModelType.RESOURCE action must implement the {@link IResourceAction} interface.
- * - A ModelType.SHARED_RESOURCE action must implement the {@link IResourceAction} interface.
+ * - A NodeType.MODEL action must implement the {@link IModelAction} interface.
+ * - A NodeType.OVERLAY action must implement the {@link IModelAction} interface.
+ * - A NodeType.RESOURCE action must implement the {@link IResourceAction} interface.
  *
  * @example
  * ```ts
- * @Action(ModelType.MODEL)
+ * @Action(MyModelClass)
  * export class MyModelAction implements IModelAction { ... }
  * ```
  * @group Decorators
- * @param type The type of Model being decorated.
+ * @param forNode The class of node for which this action is being declared.
  * @returns The decorated class.
  * @see Definition of [Actions](/docs/fundamentals/actions).
  */
-export declare function Action(type: ModelType): (constructor: any) => void;
+export declare function Action<T extends UnknownNode>(forNode: Constructable<T>): (constructor: any) => void;

package/dist/decorators/action.decorator.js

@@ -1,64 +1,65 @@
-import { ModelType } from '../app.type.js';
-import { RegistrationErrorEvent } from '../events/error.event.js';
+import { Container } from '../functions/container/container.js';
 import { ModelActionHook } from '../functions/hook/model-action.hook.js';
 import { ResourceActionHook } from '../functions/hook/resource-action.hook.js';
-import { EventService } from '../services/event/event.service.js';
+import { AModel } from '../models/model.abstract.js';
+import { AOverlay } from '../overlays/overlay.abstract.js';
+import { AResource } from '../resources/resource.abstract.js';
 import { TransactionService } from '../services/transaction/transaction.service.js';
-import { Container } from './container.js';
+function isModel(nodeClass) {
+    return nodeClass.prototype instanceof AModel;
+}
+function isOverlay(nodeClass) {
+    return nodeClass.prototype instanceof AOverlay;
+}
+function isResource(nodeClass) {
+    return nodeClass.prototype instanceof AResource;
+}
 /**
  * An `@Action` is a class decorator to be placed on top of a class that represents an action of one of ModelType.
- * - A ModelType.MODEL action must implement the {@link IModelAction} interface.
- * - A ModelType.OVERLAY action must implement the {@link IModelAction} interface.
- * - A ModelType.RESOURCE action must implement the {@link IResourceAction} interface.
- * - A ModelType.SHARED_RESOURCE action must implement the {@link IResourceAction} interface.
+ * - A NodeType.MODEL action must implement the {@link IModelAction} interface.
+ * - A NodeType.OVERLAY action must implement the {@link IModelAction} interface.
+ * - A NodeType.RESOURCE action must implement the {@link IResourceAction} interface.
  *
  * @example
  * ```ts
- * @Action(ModelType.MODEL)
+ * @Action(MyModelClass)
  * export class MyModelAction implements IModelAction { ... }
  * ```
  * @group Decorators
- * @param type The type of Model being decorated.
+ * @param forNode The class of node for which this action is being declared.
  * @returns The decorated class.
  * @see Definition of [Actions](/docs/fundamentals/actions).
  */
-export function Action(type) {
+export function Action(forNode) {
+    const container = Container.getInstance();
     return function (constructor) {
-        Container.get(TransactionService)
-            .then(async (transactionService) => {
-            switch (type) {
-                case ModelType.MODEL: {
-                    // Register model action.
-                    const modelAction = await Container.get(constructor.name);
-                    transactionService.registerModelActions([modelAction]);
-                    // Wrap model action with hooks.
-                    ModelActionHook.getInstance().registrar(modelAction);
-                    break;
-                }
-                case ModelType.OVERLAY: {
-                    // Register overlay action.
-                    const modelAction = await Container.get(constructor.name);
-                    transactionService.registerOverlayActions([modelAction]);
-                    // Wrap overlay action with hooks.
-                    ModelActionHook.getInstance().registrar(modelAction);
-                    break;
-                }
-                case ModelType.RESOURCE: {
-                    // Register resource action.
-                    const resourceAction = await Container.get(constructor.name);
-                    transactionService.registerResourceActions([resourceAction]);
-                    // Wrap resource action with hooks.
-                    ResourceActionHook.getInstance().registrar(resourceAction);
-                    break;
-                }
-                default: {
-                    throw new Error('ModelType not recognized in @Action decorator!');
-                }
+        const promise = container.get(TransactionService).then(async (transactionService) => {
+            if (isModel(forNode) && !isOverlay(forNode)) {
+                // Register model action.
+                const modelAction = await container.get(constructor.name);
+                transactionService.registerModelActions(forNode, [modelAction]);
+                // Wrap model action with hooks.
+                ModelActionHook.getInstance().registrar(modelAction);
+            }
+            else if (isOverlay(forNode)) {
+                // Register overlay action.
+                const modelAction = await container.get(constructor.name);
+                transactionService.registerOverlayActions(forNode, [modelAction]);
+                // Wrap overlay action with hooks.
+                ModelActionHook.getInstance().registrar(modelAction);
+            }
+            else if (isResource(forNode)) {
+                // Register resource action.
+                const resourceAction = await container.get(constructor.name);
+                transactionService.registerResourceActions(forNode, [resourceAction]);
+                // Wrap resource action with hooks.
+                ResourceActionHook.getInstance().registrar(resourceAction);
+            }
+            else {
+                throw new Error(`Class "${forNode.name}" is not recognized in @Action decorator!`);
             }
-        })
-            .catch((error) => {
-            EventService.getInstance().emit(new RegistrationErrorEvent(error));
         });
+        container.registerStartupUnhandledPromise(promise);
     };
 }
 //# sourceMappingURL=action.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"action.decorator.js","sourceRoot":"","sources":["../../src/decorators/action.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,IAAe;IACpC,OAAO,UAAU,WAAgB;QAC/B,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC;aAC9B,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE;YACjC,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;oBACrB,yBAAyB;oBACzB,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,GAAG,CAAe,WAAW,CAAC,IAAI,CAAC,CAAC;oBACxE,kBAAkB,CAAC,oBAAoB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;oBAEvD,gCAAgC;oBAChC,eAAe,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;oBACrD,MAAM;gBACR,CAAC;gBACD,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;oBACvB,2BAA2B;oBAC3B,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,GAAG,CAAe,WAAW,CAAC,IAAI,CAAC,CAAC;oBACxE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;oBAEzD,kCAAkC;oBAClC,eAAe,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;oBACrD,MAAM;gBACR,CAAC;gBACD,KAAK,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACxB,4BAA4B;oBAC5B,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,GAAG,CAAkB,WAAW,CAAC,IAAI,CAAC,CAAC;oBAC9E,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;oBAE7D,mCAAmC;oBACnC,kBAAkB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;oBAC3D,MAAM;gBACR,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC;oBACR,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,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":"action.decorator.js","sourceRoot":"","sources":["../../src/decorators/action.decorator.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEpF,SAAS,OAAO,CAAC,SAAqC;IACpD,OAAO,SAAS,CAAC,SAAS,YAAY,MAAM,CAAC;AAC/C,CAAC;AAED,SAAS,SAAS,CAAC,SAAqC;IACtD,OAAO,SAAS,CAAC,SAAS,YAAY,QAAQ,CAAC;AACjD,CAAC;AAED,SAAS,UAAU,CAAC,SAAqC;IACvD,OAAO,SAAS,CAAC,SAAS,YAAY,SAAS,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM,CAAwB,OAAyB;IACrE,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAE1C,OAAO,UAAU,WAAgB;QAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE;YAClF,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5C,yBAAyB;gBACzB,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,GAAG,CAAsB,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC/E,kBAAkB,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;gBAEhE,gCAAgC;gBAChC,eAAe,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9B,2BAA2B;gBAC3B,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,GAAG,CAAsB,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC/E,kBAAkB,CAAC,sBAAsB,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;gBAElE,kCAAkC;gBAClC,eAAe,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACvD,CAAC;iBAAM,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,4BAA4B;gBAC5B,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,GAAG,CAAyB,WAAW,CAAC,IAAI,CAAC,CAAC;gBACrF,kBAAkB,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;gBAEtE,mCAAmC;gBACnC,kBAAkB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,CAAC,IAAI,2CAA2C,CAAC,CAAC;YACrF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -4,11 +4,11 @@
  *
  * @example
  * ```ts
- * @Anchor()
+ * @Anchor('my-package')
  * export class MyAnchor extends AAnchor { ... }
  * ```
  * @group Decorators
  * @returns The decorated class.
  * @see Definition of [Anchors](/docs/fundamentals/overlay-and-anchor).
  */
-export declare function Anchor(): (constructor: any) => void;
+export declare function Anchor(packageName: string): (constructor: any) => void;

package/dist/decorators/anchor.decorator.js

@@ -1,29 +1,34 @@
-import { RegistrationErrorEvent } from '../events/error.event.js';
-import { EventService } from '../services/event/event.service.js';
+import { Container } from '../functions/container/container.js';
+import { AAnchor } from '../overlays/anchor.abstract.js';
 import { ModelSerializationService } from '../services/serialization/model/model-serialization.service.js';
-import { Container } from './container.js';
+import { ValidationUtility } from '../utilities/validation/validation.utility.js';
 /**
  * An `@Anchor` is a class decorator to be placed on top of a class that represents an anchor.
  * - An anchor must extend the {@link AAnchor} class.
  *
  * @example
  * ```ts
- * @Anchor()
+ * @Anchor('my-package')
  * export class MyAnchor extends AAnchor { ... }
  * ```
  * @group Decorators
  * @returns The decorated class.
  * @see Definition of [Anchors](/docs/fundamentals/overlay-and-anchor).
  */
-export function Anchor() {
+export function Anchor(packageName) {
+    const container = Container.getInstance();
     return function (constructor) {
-        Container.get(ModelSerializationService)
-            .then((modelSerializationService) => {
-            modelSerializationService.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 (!(constructor.prototype instanceof AAnchor)) {
+            throw new Error(`Class "${constructor.name}" must extend the AAnchor class!`);
+        }
+        constructor.NODE_PACKAGE = packageName;
+        const promise = container.get(ModelSerializationService).then((modelSerializationService) => {
+            modelSerializationService.registerClass(`${packageName}/${constructor.name}`, constructor);
         });
+        container.registerStartupUnhandledPromise(promise);
     };
 }
 //# sourceMappingURL=anchor.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"anchor.decorator.js","sourceRoot":"","sources":["../../src/decorators/anchor.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,UAAU,WAAgB;QAC/B,SAAS,CAAC,GAAG,CAAC,yBAAyB,CAAC;aACrC,IAAI,CAAC,CAAC,yBAAyB,EAAE,EAAE;YAClC,yBAAyB,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACzE,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":"anchor.decorator.js","sourceRoot":"","sources":["../../src/decorators/anchor.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gEAAgE,CAAC;AAC3G,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAElF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAC,WAAmB;IACxC,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,CAAC,WAAW,CAAC,SAAS,YAAY,OAAO,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,UAAU,WAAW,CAAC,IAAI,kCAAkC,CAAC,CAAC;QAChF,CAAC;QAED,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC;QAEvC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,yBAAyB,EAAE,EAAE;YAC1F,yBAAyB,CAAC,aAAa,CAAC,GAAG,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/enable-hook.decorator.js

@@ -14,13 +14,13 @@ import { CommitHook } from '../functions/hook/commit.hook.js';
  * @see Definition of [Hooks](/docs/fundamentals/modules#hooks).
  */
 export function EnableHook(hook) {
-    return function (target, propertyKey, descriptor) {
+    return function (_target, _propertyKey, descriptor) {
         switch (hook) {
             case 'CommitHook':
                 CommitHook.getInstance().registrar(descriptor);
                 break;
             default:
-                throw new Error('Invalid hook!');
+                throw new Error(`Invalid hook "${hook}"!`);
         }
     };
 }

package/dist/decorators/enable-hook.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"enable-hook.decorator.js","sourceRoot":"","sources":["../../src/decorators/enable-hook.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAI9D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC/E,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,YAAY;gBACf,UAAU,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBAC/C,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"enable-hook.decorator.js","sourceRoot":"","sources":["../../src/decorators/enable-hook.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAI9D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,UAAU,OAAY,EAAE,YAAoB,EAAE,UAA8B;QACjF,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,YAAY;gBACf,UAAU,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBAC/C,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/event-source.decorator.d.ts

@@ -1,5 +1,5 @@
 import type { Constructable } from '../app.type.js';
-import type { Event } from '../events/event.model.js';
+import type { Event } from '../events/index.js';
 /**
  * An `@EventSource` is a method decorator to enable automatic event emission.
  * The `registrar()` method of the Event class is used to decorate the method to auto-emit events.

package/dist/decorators/event-source.decorator.js

@@ -1,3 +1,4 @@
+import { Container } from '../functions/container/container.js';
 import { EventService } from '../services/event/event.service.js';
 /**
  * An `@EventSource` is a method decorator to enable automatic event emission.
@@ -15,8 +16,12 @@ import { EventService } from '../services/event/event.service.js';
  * @returns The decorated method.
  */
 export function EventSource(ofType) {
-    return function (target, propertyKey, descriptor) {
-        ofType.registrar(EventService.getInstance(), descriptor);
+    const container = Container.getInstance();
+    return function (_target, _propertyKey, descriptor) {
+        const promise = container.get(EventService).then((eventService) => {
+            ofType.registrar(eventService, descriptor);
+        });
+        container.registerStartupUnhandledPromise(promise);
     };
 }
 //# sourceMappingURL=event-source.decorator.js.map

package/dist/decorators/event-source.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-source.decorator.js","sourceRoot":"","sources":["../../src/decorators/event-source.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqC;IAErC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC9E,MAAc,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"event-source.decorator.js","sourceRoot":"","sources":["../../src/decorators/event-source.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqC;IAErC,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAE1C,OAAO,UAAU,OAAY,EAAE,YAAoB,EAAE,UAA8B;QACjF,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;YAC/D,MAAc,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -12,7 +12,7 @@ import type { Constructable } from '../app.type.js';
  * // Factory definition.
  * @Factory<MyService>(MyService, { metadata: { key: 'value' } })
  * export class MyServiceFactory {
- *   static async create(arg1, arg2, ...): Promise<MyService> { ... }>
+ *   static async create(arg1, arg2, ...): Promise<MyService> { ... }
  * }
  *
  * // Get instance using default factory.
@@ -27,6 +27,37 @@ import type { Constructable } from '../app.type.js';
  * @group Decorators
  * @param type The type of class that the factory creates.
  * @param options Allows registering multiple factories for the same class that differ by metadata.
+ * @remarks
+ * If the factory is dependent on other factories, it should not block creation of its instance.
+ * ```ts
+ * // Correct, since creation of instance is not blocked.
+ * // In this case, when multiple code paths are trying to get Container.get(MyService) at the same time,
+ * // each of them will `await` for OtherService to get resolved,
+ * // and the first to resolve will be able to create the instance, that the rest will re-use.
+ * export class MyServiceFactory {
+ *   private static instance: MyService;
+ *   static async create(): Promise<MyService> {
+ *     const otherInstance = await Container.get(OtherService);
+ *     if (!this.instance) {
+ *       this.instance = new MyService(otherInstance);
+ *     }
+ *   }
+ * }
+ * ```
+ * ```ts
+ * // Wrong, since creation of instance is blocked.
+ * // In this case, when multiple code paths are trying to get Container.get(MyService) at the same time,
+ * // each of them will get a new instance since during `await` there is race condition.
+ * export class MyServiceFactory {
+ *   private static instance: MyService;
+ *   static async create(): Promise<MyService> {
+ *     if (!this.instance) {
+ *       const otherInstance = await Container.get(OtherService);
+ *       this.instance = new MyService(otherInstance);
+ *     }
+ *   }
+ * }
+ * ```
  * @returns The decorated class.
  */
 export declare function Factory<T>(type: Constructable<T> | string, options?: {