@quadnix/octo 0.0.20 → 0.0.22

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

@@ -1,7 +1,48 @@
 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.
+ * :::
+ *
+ * @example
+ * ```ts
+ * const myEvent = new TransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export declare class TransactionEvent extends Event<string> {
 }
+/**
+ * This event is emitted when a model action is done executing.
+ *
+ * @example
+ * ```ts
+ * const myEvent = new ModelActionTransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export declare class ModelActionTransactionEvent extends TransactionEvent {
 }
+/**
+ * This event is emitted when a resource action is done executing.
+ *
+ * @example
+ * ```ts
+ * const myEvent = new ResourceActionTransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export declare class ResourceActionTransactionEvent extends TransactionEvent {
 }

package/dist/events/transaction.event.js

@@ -1,8 +1,49 @@
 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.
+ * :::
+ *
+ * @example
+ * ```ts
+ * const myEvent = new TransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export class TransactionEvent extends Event {
 }
+/**
+ * This event is emitted when a model action is done executing.
+ *
+ * @example
+ * ```ts
+ * const myEvent = new ModelActionTransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export class ModelActionTransactionEvent extends TransactionEvent {
 }
+/**
+ * This event is emitted when a resource action is done executing.
+ *
+ * @example
+ * ```ts
+ * const myEvent = new ResourceActionTransactionEvent('MyActionName');
+ * EventService.getInstance().emit(myEvent);
+ * ```
+ * @group Events
+ * @returns The Event instance.
+ */
 export class ResourceActionTransactionEvent extends TransactionEvent {
 }
 //# sourceMappingURL=transaction.event.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction.event.js","sourceRoot":"","sources":["../../src/events/transaction.event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,OAAO,gBAAiB,SAAQ,KAAa;CAAG;AAEtD,MAAM,OAAO,2BAA4B,SAAQ,gBAAgB;CAAG;AAEpE,MAAM,OAAO,8BAA+B,SAAQ,gBAAgB;CAAG"}
+{"version":3,"file":"transaction.event.js","sourceRoot":"","sources":["../../src/events/transaction.event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAa;CAAG;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAA4B,SAAQ,gBAAgB;CAAG;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,8BAA+B,SAAQ,gBAAgB;CAAG"}

package/dist/functions/container/container.d.ts

@@ -0,0 +1,53 @@
+import type { Constructable } from '../../app.type.js';
+type Factory<T> = {
+    create: (...args: unknown[]) => Promise<T>;
+};
+/**
+ * The Container class is a box to hold all registered factories.
+ *
+ * In Octo, we minimize the use of the `new` keyword and get instance of a class using its factory.
+ * The factory has full control over how the instance is created.
+ *
+ * By using the Container and Factory concepts, it is possible to override internal class definitions at runtime.
+ * It is an incredibly powerful tool to customize implementation.
+ */
+export declare class Container {
+    private static FACTORY_TIMEOUT_IN_MS;
+    private static readonly factories;
+    /**
+     * `Container.get()` allows to get an instance of a class using its factory.
+     *
+     * @param type The type or name of the class to get.
+     * @param options Allows selection of a specific factory to use to get the instance.
+     * - The `args` option supplies arguments to the factory.
+     * @returns The instance of the class.
+     */
+    static get<T>(type: Constructable<T> | string, options?: {
+        args?: unknown[];
+    }): Promise<T>;
+    /**
+     * `Container.registerFactory()` allows to register a factory for a class.
+     *
+     * @param type The type or name of the class for which the factory is registered.
+     * @param factory The factory class being registered.
+     */
+    static registerFactory<T>(type: Constructable<T> | string, factory: Factory<T>): void;
+    /**
+     * `Container.reset()` clears all registered factories and empties the container. This is mostly used in testing.
+     */
+    static reset(): void;
+    /**
+     * The Container, by default, will wait a maximum of 5 seconds for a factory to resolve and provide an instance.
+     * This method allows to change that timeout.
+     *
+     * @param timeoutInMs The timeout in milliseconds.
+     */
+    static setFactoryTimeout(timeoutInMs: number): void;
+    /**
+     * `Container.unRegisterFactory()` will unregister all factories of a class.
+     *
+     * @param type The type or name of the class for which all factory is unregistered.
+     */
+    static unRegisterFactory<T>(type: Constructable<T> | string): void;
+}
+export {};

package/dist/functions/container/container.js

@@ -0,0 +1,102 @@
+/**
+ * The Container class is a box to hold all registered factories.
+ *
+ * In Octo, we minimize the use of the `new` keyword and get instance of a class using its factory.
+ * The factory has full control over how the instance is created.
+ *
+ * By using the Container and Factory concepts, it is possible to override internal class definitions at runtime.
+ * It is an incredibly powerful tool to customize implementation.
+ */
+export class Container {
+    static { this.FACTORY_TIMEOUT_IN_MS = 5000; }
+    static { this.factories = {}; }
+    /**
+     * `Container.get()` allows to get an instance of a class using its factory.
+     *
+     * @param type The type or name of the class to get.
+     * @param options Allows selection of a specific factory to use to get the instance.
+     * - The `args` option supplies arguments to the factory.
+     * @returns The instance of the class.
+     */
+    static async get(type, options) {
+        const args = options?.args || [];
+        const name = typeof type === 'string' ? type : type.name;
+        const factoryContainer = this.factories[name];
+        if (factoryContainer?.factory) {
+            if (!Array.isArray(factoryContainer.factory)) {
+                return factoryContainer.factory.create(...args);
+            }
+            else {
+                const factory = await factoryContainer.factory[0];
+                return factory.create(...args);
+            }
+        }
+        const newFactoryContainer = {};
+        this.factories[name] = newFactoryContainer;
+        let promiseResolver;
+        let promiseTimeout;
+        const promise = new Promise((resolve, reject) => {
+            promiseTimeout = setTimeout(() => {
+                reject(new Error(`Timed out waiting for factory ${name} to resolve!`));
+            }, this.FACTORY_TIMEOUT_IN_MS);
+            promiseResolver = resolve;
+        });
+        newFactoryContainer.factory = [promise, promiseResolver];
+        const factory = await promise;
+        if (promiseTimeout) {
+            clearTimeout(promiseTimeout);
+        }
+        return factory.create(...args);
+    }
+    /**
+     * `Container.registerFactory()` allows to register a factory for a class.
+     *
+     * @param type The type or name of the class for which the factory is registered.
+     * @param factory The factory class being registered.
+     */
+    static registerFactory(type, factory) {
+        const name = typeof type === 'string' ? type : type.name;
+        const factoryContainer = this.factories[name];
+        if (factoryContainer?.factory) {
+            // If factory is not a promise set by get() above, it has already been registered.
+            if (!Array.isArray(factoryContainer.factory)) {
+                return;
+            }
+            const resolve = factoryContainer.factory[1];
+            resolve(factory);
+            factoryContainer.factory = factory;
+            return;
+        }
+        else {
+            this.factories[name] = { factory };
+        }
+    }
+    /**
+     * `Container.reset()` clears all registered factories and empties the container. This is mostly used in testing.
+     */
+    static reset() {
+        this.FACTORY_TIMEOUT_IN_MS = 5000;
+        for (const name in this.factories) {
+            delete this.factories[name];
+        }
+    }
+    /**
+     * The Container, by default, will wait a maximum of 5 seconds for a factory to resolve and provide an instance.
+     * This method allows to change that timeout.
+     *
+     * @param timeoutInMs The timeout in milliseconds.
+     */
+    static setFactoryTimeout(timeoutInMs) {
+        this.FACTORY_TIMEOUT_IN_MS = timeoutInMs;
+    }
+    /**
+     * `Container.unRegisterFactory()` will unregister all factories of a class.
+     *
+     * @param type The type or name of the class for which all factory is unregistered.
+     */
+    static unRegisterFactory(type) {
+        const name = typeof type === 'string' ? type : type.name;
+        delete this.factories[name];
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/functions/container/container.js.map

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

package/dist/functions/container/test-container.d.ts

@@ -0,0 +1,75 @@
+import type { Constructable } from '../../app.type.js';
+type FactoryMock<T> = {
+    type: Constructable<T> | string;
+    value: T;
+};
+type TestContainerSubjects = {
+    importFrom?: Constructable<IPackageMock>[];
+    mocks?: FactoryMock<unknown>[];
+};
+type TestContainerOptions = {
+    factoryTimeoutInMs?: number;
+};
+export interface IPackageMock {
+    destroy: () => Promise<void>;
+    getMocks: () => FactoryMock<unknown>[];
+    init(): Promise<void>;
+}
+/**
+ * The TestContainer class is an isolated {@link Container} for tests.
+ *
+ * :::info Info
+ * A test framework like Jest, supports parallel test executions in different cores of the machine.
+ * Each test is a single test file, whose `it()` blocks are executed serially.
+ * :::
+ *
+ * TestContainer is created with testing framework's parallel execution in mind.
+ * A TestContainer should be created in the `beforeAll()` block of your test,
+ * which modifies the Container for the duration of the test.
+ * This TestContainer does not affect other tests in parallel since they are on a separate machine core.
+ * Once tests are done executing, the `afterAll()` block cleans up the Container.
+ */
+export declare class TestContainer {
+    private static packageMocks;
+    private static createTestFactory;
+    /**
+     * The `TestContainer.create()` method allows you to mock factories.
+     *
+     * @example
+     * ```ts
+     * beforeAll(async () => {
+     *   await TestContainer.create({
+     *     importFrom: [OctoAwsCdkPackageMock],
+     *     mocks: [
+     *       { type: MyClass, value: jest.fn() },
+     *       { type: AnotherClass, value: new AnotherClass() },
+     *     ],
+     *   }, { factoryTimeoutInMs: 500 });
+     * });
+     *
+     * ```
+     * @param subjects The subjects being mocked.
+     * - `importFrom` is an array of {@link IPackageMock} classes, to import custom mocks,
+     * such as from octo-aws-cdk package - [OctoAwsCdkPackageMock](/api/octo-aws-cdk/class/OctoAwsCdkPackageMock).
+     * - `mocks` is an array of objects, to override the default factories.
+     *   - Use `type: Constructable<T> | string` to identify the class being mocked.
+     *   - Use `value: T` to provide the mocked value.
+     * @param options Options to configure TestContainer.
+     * - `factoryTimeoutInMs?: number` is to override the default container timeout.
+     */
+    static create(subjects: TestContainerSubjects, options?: TestContainerOptions): Promise<void>;
+    /**
+     * The `TestContainer.reset()` method will completely destroy all factories from the Container.
+     * Because the entire Container is destroyed, and not just the mocks,
+     * it must always be called in your `afterAll()` block.
+     *
+     * @example
+     * ```ts
+     * afterAll(async () => {
+     *   await TestContainer.reset();
+     * });
+     * ```
+     */
+    static reset(): Promise<void>;
+}
+export {};

package/dist/functions/container/test-container.js

@@ -0,0 +1,97 @@
+import { Container } from './container.js';
+/**
+ * The TestContainer class is an isolated {@link Container} for tests.
+ *
+ * :::info Info
+ * A test framework like Jest, supports parallel test executions in different cores of the machine.
+ * Each test is a single test file, whose `it()` blocks are executed serially.
+ * :::
+ *
+ * TestContainer is created with testing framework's parallel execution in mind.
+ * A TestContainer should be created in the `beforeAll()` block of your test,
+ * which modifies the Container for the duration of the test.
+ * This TestContainer does not affect other tests in parallel since they are on a separate machine core.
+ * Once tests are done executing, the `afterAll()` block cleans up the Container.
+ */
+export class TestContainer {
+    static { this.packageMocks = []; }
+    static createTestFactory(mock) {
+        return class {
+            static { this.mock = mock; }
+            static async create() {
+                return this.mock.value;
+            }
+        };
+    }
+    /**
+     * The `TestContainer.create()` method allows you to mock factories.
+     *
+     * @example
+     * ```ts
+     * beforeAll(async () => {
+     *   await TestContainer.create({
+     *     importFrom: [OctoAwsCdkPackageMock],
+     *     mocks: [
+     *       { type: MyClass, value: jest.fn() },
+     *       { type: AnotherClass, value: new AnotherClass() },
+     *     ],
+     *   }, { factoryTimeoutInMs: 500 });
+     * });
+     *
+     * ```
+     * @param subjects The subjects being mocked.
+     * - `importFrom` is an array of {@link IPackageMock} classes, to import custom mocks,
+     * such as from octo-aws-cdk package - [OctoAwsCdkPackageMock](/api/octo-aws-cdk/class/OctoAwsCdkPackageMock).
+     * - `mocks` is an array of objects, to override the default factories.
+     *   - Use `type: Constructable<T> | string` to identify the class being mocked.
+     *   - Use `value: T` to provide the mocked value.
+     * @param options Options to configure TestContainer.
+     * - `factoryTimeoutInMs?: number` is to override the default container timeout.
+     */
+    static async create(subjects, options) {
+        const oldFactories = { ...Container['factories'] };
+        Container.reset();
+        if (options?.factoryTimeoutInMs) {
+            Container.setFactoryTimeout(options.factoryTimeoutInMs);
+        }
+        const importedMocks = [];
+        for (const mockClass of subjects.importFrom || []) {
+            const mock = new mockClass();
+            await mock.init();
+            importedMocks.push(...mock.getMocks());
+            this.packageMocks.push(mock);
+        }
+        subjects.mocks = [...importedMocks, ...(subjects.mocks || [])];
+        for (const mock of subjects.mocks) {
+            const mockClassName = typeof mock.type === 'string' ? mock.type : mock.type.name;
+            if (!oldFactories[mockClassName]) {
+                oldFactories[mockClassName] = { factory: this.createTestFactory(mock) };
+            }
+            else {
+                oldFactories[mockClassName].factory = this.createTestFactory(mock);
+            }
+        }
+        for (const name in oldFactories) {
+            Container.registerFactory(name, oldFactories[name].factory);
+        }
+    }
+    /**
+     * The `TestContainer.reset()` method will completely destroy all factories from the Container.
+     * Because the entire Container is destroyed, and not just the mocks,
+     * it must always be called in your `afterAll()` block.
+     *
+     * @example
+     * ```ts
+     * afterAll(async () => {
+     *   await TestContainer.reset();
+     * });
+     * ```
+     */
+    static async reset() {
+        for (const mock of this.packageMocks) {
+            await mock.destroy();
+        }
+        Container.reset();
+    }
+}
+//# sourceMappingURL=test-container.js.map

package/dist/functions/container/test-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-container.js","sourceRoot":"","sources":["../../../src/functions/container/test-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAuB3C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAa;aACT,iBAAY,GAAmB,EAAE,CAAC;IAEzC,MAAM,CAAC,iBAAiB,CAAI,IAAoB;QACtD,OAAO;qBACE,SAAI,GAAmB,IAAI,CAAC;YAEnC,MAAM,CAAC,KAAK,CAAC,MAAM;gBACjB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACzB,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAA+B,EAAE,OAA8B;QACjF,MAAM,YAAY,GAAG,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QACnD,SAAS,CAAC,KAAK,EAAE,CAAC;QAElB,IAAI,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAChC,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,aAAa,GAA2B,EAAE,CAAC;QACjD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAElB,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,QAAQ,CAAC,KAAK,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAE/D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,aAAa,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACjF,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjC,YAAY,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,OAA2B,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK;QAChB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC"}

package/dist/functions/dependency/dependency.d.ts

@@ -1,5 +1,5 @@
-import type { UnknownModel } from '../../app.type.js';
-import { type DiffAction } from '../diff/diff.js';
+import type { UnknownNode } from '../../app.type.js';
+import type { DiffAction } from '../diff/diff.js';
 declare class DependencyBehavior {
     forAction: DiffAction;
     onAction: DiffAction;
@@ -28,10 +28,10 @@ export interface IDependency {
 }
 export declare class Dependency {
     private readonly behaviors;
-    readonly from: UnknownModel;
+    readonly from: UnknownNode;
     private relationship;
-    readonly to: UnknownModel;
-    constructor(from: UnknownModel, to: UnknownModel);
+    readonly to: UnknownNode;
+    constructor(from: UnknownNode, to: UnknownNode);
     private getBehaviorIndex;
     addBehavior(onField: string, onAction: DiffAction, toField: string, forAction: DiffAction): void;
     addChildRelationship(onField: string, toField: string): void;
@@ -47,6 +47,6 @@ export declare class Dependency {
     } | undefined;
     removeBehavior(onField: string, onAction: DiffAction, toField: string, forAction: DiffAction): void;
     synth(): IDependency;
-    static unSynth(from: UnknownModel, to: UnknownModel, dependency: IDependency): Dependency;
+    static unSynth(from: UnknownNode, to: UnknownNode, dependency: IDependency): Dependency;
 }
 export {};

package/dist/functions/dependency/dependency.js

@@ -1,8 +1,4 @@
 class DependencyBehavior {
-    forAction;
-    onAction;
-    onField;
-    toField;
     constructor(onField, onAction, toField, forAction) {
         this.onField = onField;
         this.onAction = onAction;
@@ -16,11 +12,8 @@ export var DependencyRelationship;
     DependencyRelationship["PARENT"] = "parent";
 })(DependencyRelationship || (DependencyRelationship = {}));
 export class Dependency {
-    behaviors = [];
-    from;
-    relationship;
-    to;
     constructor(from, to) {
+        this.behaviors = [];
         this.from = from;
         this.to = to;
     }

package/dist/functions/dependency/dependency.js.map

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

package/dist/functions/diff/diff-metadata.d.ts

@@ -1,4 +1,4 @@
-import type { ActionInputs, ActionOutputs, UnknownModel, UnknownResource } from '../../app.type.js';
+import type { ActionInputs, ActionOutputs, UnknownNode } from '../../app.type.js';
 import type { IModelAction } from '../../models/model-action.interface.js';
 import type { IResourceAction } from '../../resources/resource-action.interface.js';
 import type { Diff, DiffAction } from './diff.js';
@@ -9,11 +9,14 @@ export declare class DiffMetadata {
     readonly diff: Diff;
     readonly action: DiffAction;
     readonly field: string;
-    readonly model: UnknownModel | UnknownResource;
+    readonly node: UnknownNode;
     readonly value: unknown;
     readonly inputs: ActionInputs;
     readonly outputs: ActionOutputs;
     constructor(diff: Diff, actions: IModelAction[] | IResourceAction[]);
+    /**
+     * Overrides JSON.serialize() to output a more succinct model of diff-metadata.
+     */
     toJSON(): ReturnType<Diff['toJSON']>;
     updateInputs(inputs: ActionInputs): void;
     updateOutputs(outputs: ActionOutputs): void;

package/dist/functions/diff/diff-metadata.js

@@ -1,15 +1,7 @@
 export class DiffMetadata {
-    actions;
-    applied;
-    applyOrder;
-    diff;
-    action;
-    field;
-    model;
-    value;
-    inputs = {};
-    outputs = {};
     constructor(diff, actions) {
+        this.inputs = {};
+        this.outputs = {};
         if (!actions?.length) {
             throw new Error('No matching action given for diff!');
         }
@@ -19,9 +11,12 @@ export class DiffMetadata {
         this.diff = diff;
         this.action = diff.action;
         this.field = diff.field;
-        this.model = diff.model;
+        this.node = diff.node;
         this.value = diff.value;
     }
+    /**
+     * Overrides JSON.serialize() to output a more succinct model of diff-metadata.
+     */
     toJSON() {
         return this.diff.toJSON();
     }

package/dist/functions/diff/diff-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff-metadata.js","sourceRoot":"","sources":["../../../src/functions/diff/diff-metadata.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACd,OAAO,CAAqC;IACrD,OAAO,CAAU;IACjB,UAAU,CAAS;IAEV,IAAI,CAAO;IACX,MAAM,CAAa;IACnB,KAAK,CAAS;IACd,KAAK,CAAiC;IACtC,KAAK,CAAU;IAEf,MAAM,GAAiB,EAAE,CAAC;IAC1B,OAAO,GAAkB,EAAE,CAAC;IAErC,YAAY,IAAU,EAAE,OAA2C;QACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAErB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAKD,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAoB;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,OAAsB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"diff-metadata.js","sourceRoot":"","sources":["../../../src/functions/diff/diff-metadata.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IAcvB,YAAY,IAAU,EAAE,OAA2C;QAH1D,WAAM,GAAiB,EAAE,CAAC;QAC1B,YAAO,GAAkB,EAAE,CAAC;QAGnC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAErB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAoB;QAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,OAAsB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/functions/diff/diff.d.ts

@@ -1,4 +1,4 @@
-import type { UnknownModel } from '../../app.type.js';
+import type { UnknownNode } from '../../app.type.js';
 export declare enum DiffAction {
     ADD = "add",
     DELETE = "delete",
@@ -8,8 +8,11 @@ export declare enum DiffAction {
 export declare class Diff {
     readonly action: DiffAction;
     readonly field: string;
-    readonly model: UnknownModel;
+    readonly node: UnknownNode;
     readonly value: unknown;
-    constructor(model: Diff['model'], action: Diff['action'], field: Diff['field'], value: Diff['value']);
+    constructor(node: Diff['node'], action: Diff['action'], field: Diff['field'], value: Diff['value']);
+    /**
+     * Overrides JSON.serialize() to output a more succinct representation of diff.
+     */
     toJSON(): object;
 }

package/dist/functions/diff/diff.js

@@ -1,5 +1,5 @@
-import { AModel } from '../../models/model.abstract.js';
 import { AAnchor } from '../../overlays/anchor.abstract.js';
+import { ANode } from '../node/node.abstract.js';
 export var DiffAction;
 (function (DiffAction) {
     DiffAction["ADD"] = "add";
@@ -8,23 +8,18 @@ export var DiffAction;
     DiffAction["UPDATE"] = "update";
 })(DiffAction || (DiffAction = {}));
 export class Diff {
-    action;
-    field;
-    model;
-    value;
-    constructor(model, action, field, value) {
-        this.model = model;
+    constructor(node, action, field, value) {
+        this.node = node;
         this.action = action;
         this.field = field;
         this.value = value;
     }
+    /**
+     * Overrides JSON.serialize() to output a more succinct representation of diff.
+     */
     toJSON() {
-        let model = this.model;
-        if (model instanceof AModel) {
-            model = model.getContext();
-        }
         let value = this.value;
-        if (value instanceof AModel) {
+        if (value instanceof ANode) {
             value = value.getContext();
         }
         else if (value instanceof AAnchor) {
@@ -33,7 +28,7 @@ export class Diff {
         return {
             action: this.action,
             field: this.field,
-            model,
+            node: this.node.getContext(),
             value,
         };
     }

package/dist/functions/diff/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/functions/diff/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAE5D,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;AACnB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,OAAO,IAAI;IACN,MAAM,CAAa;IAEnB,KAAK,CAAS;IAEd,KAAK,CAAe;IAEpB,KAAK,CAAU;IAExB,YAAY,KAAoB,EAAE,MAAsB,EAAE,KAAoB,EAAE,KAAoB;QAClG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAKD,MAAM;QACJ,IAAI,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC;QAChC,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YAC5B,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;YAC5B,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;YACpC,KAAK,GAAG,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;YACL,KAAK;SACN,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/functions/diff/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;AACnB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,OAAO,IAAI;IASf,YAAY,IAAkB,EAAE,MAAsB,EAAE,KAAoB,EAAE,KAAoB;QAChG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;YACpC,KAAK,GAAG,YAAY,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvC,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YAC5B,KAAK;SACN,CAAC;IACJ,CAAC;CACF"}