@quadnix/octo 0.0.22 → 0.0.24

package/dist/app.type.d.ts

@@ -1,34 +1,164 @@
 import type { IDependency } from './functions/dependency/dependency.js';
 import type { ANode } from './functions/node/node.abstract.js';
-import type { IAnchor } from './overlays/anchor.interface.js';
-import type { AOverlay } from './overlays/overlay.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 { IModel, IModelReference } from './models/model.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';
+import type { BaseResourceSchema } from './resources/resource.schema.js';
+import type { ValidationUtility } from './utilities/validation/validation.utility.js';
+/**
+ * @group Types
+ */
+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;
+}
+/**
+ * @group Types
+ */
+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;
+}
+/**
+ * @group Types
+ */
+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']>;
+    };
+}
+/**
+ * @internal
+ */
 export declare enum NodeType {
     MODEL = "model",
     OVERLAY = "overlay",
-    RESOURCE = "resource",
-    SHARED_RESOURCE = "shared-resource"
+    RESOURCE = "resource"
 }
+/**
+ * @internal
+ */
 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;
+/**
+ * @internal
+ */
+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];
 };
+/**
+ * @group Types
+ */
+export declare function hasNodeName(node: UnknownNode, nodeName: string): boolean;
+/**
+ * @group Types
+ */
+export declare function stub<T>(value: string): T;
+/**
+ * @internal
+ */
+export type ActionInputs = EnhancedModuleSchema<UnknownModule>;
+/**
+ * @group Types
+ */
 export type ActionOutputs = {
     [key: string]: UnknownResource;
 };
+/**
+ * @internal
+ */
+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];
+/**
+ * @group Types
+ */
+export type DiffValueTypePropertyUpdate = {
+    key: string;
+    value: unknown;
+};
+/**
+ * @group Types
+ */
+export type DiffValueTypeTagUpdate = {
+    add: {
+        [key: string]: string;
+    };
+    delete: string[];
+    update: {
+        [key: string]: string;
+    };
+};
+/**
+ * @internal
+ */
+export type ObjectKeyValue<T> = {
+    [K in keyof T]: {
+        key: K;
+        value: T[K];
+    };
+}[keyof T];
+/**
+ * @group Types
+ */
 export type Constructable<T> = new (...args: any[]) => T;
+/**
+ * @group Types
+ */
 export type ModelSerializedOutput = {
-    anchors: (IAnchor & {
+    anchors: (AnchorSchema<UnknownAnchor> & {
         className: string;
+        location: IModelReference & {
+            type: NodeType;
+        };
     })[];
     dependencies: IDependency[];
     models: {
@@ -39,27 +169,24 @@ export type ModelSerializedOutput = {
     };
     overlays: {
         className: string;
-        overlay: IOverlay;
+        overlay: OverlaySchema<UnknownOverlay>;
     }[];
 };
-export type ModifyInterface<T, R> = Omit<T, keyof R> & R;
+/**
+ * @group Types
+ */
 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;
         };
     };
 };
+/**
+ * @internal
+ */
 export type TransactionOptions = {
     enableResourceCapture?: boolean;
     yieldModelDiffs?: boolean;
@@ -67,9 +194,91 @@ export type TransactionOptions = {
     yieldResourceDiffs?: boolean;
     yieldResourceTransaction?: boolean;
 };
-export type IUnknownModel = IModel<unknown, unknown>;
-export type UnknownModel = AModel<unknown, unknown>;
+/**
+ * @internal
+ */
+export type ModifyInterface<T, R> = Omit<T, keyof R> & R;
+/**
+ * @group Types
+ */
+export type AnchorSchema<T> = T extends AAnchor<infer S, any> ? S : never;
+/**
+ * @group Types
+ */
+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>;
+};
+/**
+ * @internal
+ */
+export type ModelSchema<T> = T extends AModel<infer S, any> ? S : never;
+/**
+ * @internal
+ */
+export type ModuleOutput<M> = M extends AModule<any, infer T> ? T : never;
+/**
+ * @group Types
+ */
+export type ModuleSchema<T> = T extends AModule<infer S, any> ? S : never;
+/**
+ * @group Types
+ */
+export type ModuleSchemaInputs<T> = {
+    [K in ClassRequiredProperties<ModuleSchema<T>>]: ModuleSchema<T>[K];
+} & {
+    [K in ClassOptionalProperties<ModuleSchema<T>>]?: ModuleSchema<T>[K];
+};
+/**
+ * @internal
+ */
+export type NodeSchema<T> = T extends ANode<infer S, any> ? S : never;
+/**
+ * @group Types
+ */
+export type OverlaySchema<T> = T extends AOverlay<infer S, any> ? S : never;
+/**
+ * @group Types
+ */
+export type ResourceSchema<T> = T extends AResource<infer S, any> ? S : never;
+/**
+ * @internal
+ */
+export type IUnknownModel = IModel<unknown, any>;
+/**
+ * @internal
+ */
+export type IUnknownModelAction = IModelAction<any>;
+/**
+ * @internal
+ */
+export type IUnknownResourceAction = IResourceAction<any>;
+/**
+ * @internal
+ */
+export type UnknownAnchor = AAnchor<BaseAnchorSchema, UnknownModel>;
+/**
+ * @internal
+ */
+export type UnknownModel = AModel<unknown, any>;
+/**
+ * @internal
+ */
+export type UnknownModule = AModule<unknown, any>;
+/**
+ * @internal
+ */
 export type UnknownNode = ANode<unknown, unknown>;
-export type UnknownOverlay = AOverlay<unknown>;
-export type UnknownResource = AResource<unknown>;
-export type UnknownSharedResource = ASharedResource<unknown>;
+/**
+ * @internal
+ */
+export type UnknownOverlay = AOverlay<BaseOverlaySchema, any>;
+/**
+ * @internal
+ */
+export type UnknownResource = AResource<any, any>;

package/dist/app.type.js

@@ -1,14 +1,105 @@
+/* Classes */
+/**
+ * @group Types
+ */
+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();
+    }
+}
+/**
+ * @group Types
+ */
+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();
+    }
+}
+/**
+ * @group Types
+ */
+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 */
+/**
+ * @internal
+ */
 export var NodeType;
 (function (NodeType) {
     NodeType["MODEL"] = "model";
     NodeType["OVERLAY"] = "overlay";
     NodeType["RESOURCE"] = "resource";
-    NodeType["SHARED_RESOURCE"] = "shared-resource";
 })(NodeType || (NodeType = {}));
+/**
+ * @internal
+ */
 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 */
+/**
+ * @group Types
+ */
+export function hasNodeName(node, nodeName) {
+    return node.constructor.NODE_NAME === nodeName;
+}
+/**
+ * @group Types
+ */
+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":"AAWA,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,+CAAmC,CAAA;AACrC,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;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 { NodeType } 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 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.
- * - A NodeType.SHARED_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: NodeType): (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 { NodeType } 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 '../functions/container/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 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.
- * - A NodeType.SHARED_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 NodeType.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 NodeType.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 NodeType.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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,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,qCAAqC,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM,CAAC,IAAc;IACnC,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,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;oBACpB,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,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;oBACtB,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,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;oBACvB,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 { ModelSerializationService } from '../services/serialization/model/model-serialization.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 { 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,qCAAqC,CAAC;AAEhE;;;;;;;;;;;;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.d.ts

@@ -7,10 +7,15 @@ type Hook = 'CommitHook';
  * @EnableHook('CommitHook')
  * async commitTransaction(): Promise<void> { ... }
  * ```
+ *
  * @group Decorators
+ *
  * @internal
+ *
  * @param hook The only values supported are `CommitHook`.
+ *
  * @returns The decorated method.
+ *
  * @see Definition of [Hooks](/docs/fundamentals/modules#hooks).
  */
 export declare function EnableHook(hook: Hook): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;