@quadnix/octo 0.0.21 → 0.0.22

package/dist/functions/node/node.abstract.js

@@ -0,0 +1,275 @@
+import { Dependency } from '../dependency/dependency.js';
+import { DiffAction } from '../diff/diff.js';
+/**
+ * This is Octo's base class, and all other classes extend from it.
+ * It helps provide a common set of methods and properties that is core to Octo.
+ *
+ * Octo is built as a graph, and this base class can be considered as a generic node.
+ * Nodes can have children, and siblings, but only if connected via an edge, called {@link Dependency} here.
+ *
+ * From this base class, three more base classes are derived,
+ * - [Models](/docs/fundamentals/models)
+ * - [Resources](/docs/fundamentals/resources)
+ * - [Overlays](/docs/fundamentals/overlay-and-anchor)
+ *
+ * Each of these derived base classes, using the base methods of this class,
+ * define their own specific rules on how their graphs should be constructed.
+ */
+export class ANode {
+    constructor() {
+        /**
+         * A set of node dependencies with other nodes, represented using a {@link Dependency}.
+         */
+        this.dependencies = [];
+    }
+    addChild(onField, child, toField) {
+        const cIndex = child.dependencies.findIndex((d) => Object.is(d.to, this));
+        const pIndex = this.dependencies.findIndex((d) => Object.is(d.to, child));
+        if (cIndex !== -1 || pIndex !== -1) {
+            throw new Error('Dependency relationship already exists!');
+        }
+        const childToParentDependency = new Dependency(child, this);
+        childToParentDependency.addBehavior(toField, DiffAction.ADD, onField, DiffAction.ADD);
+        childToParentDependency.addBehavior(toField, DiffAction.ADD, onField, DiffAction.UPDATE);
+        childToParentDependency.addChildRelationship(toField, onField);
+        child.dependencies.push(childToParentDependency);
+        const parentToChildDependency = new Dependency(this, child);
+        parentToChildDependency.addBehavior(onField, DiffAction.DELETE, toField, DiffAction.DELETE);
+        parentToChildDependency.addParentRelationship(onField, toField);
+        this.dependencies.push(parentToChildDependency);
+        return { childToParentDependency, parentToChildDependency };
+    }
+    addFieldDependency(behaviors) {
+        const index = this.dependencies.findIndex((d) => Object.is(d.from, this) && Object.is(d.to, this));
+        const dependency = index > -1 ? this.dependencies[index] : new Dependency(this, this);
+        if (index === -1) {
+            this.dependencies.push(dependency);
+        }
+        for (const behavior of behaviors) {
+            if (!dependency.hasMatchingBehavior(behavior.onField, behavior.onAction, behavior.toField, behavior.forAction)) {
+                dependency.addBehavior(behavior.onField, behavior.onAction, behavior.toField, behavior.forAction);
+            }
+        }
+    }
+    addRelationship(to) {
+        const thisToThatDependency = new Dependency(this, to);
+        this.dependencies.push(thisToThatDependency);
+        const thatToThisDependency = new Dependency(to, this);
+        to.dependencies.push(thatToThisDependency);
+        return { thatToThisDependency, thisToThatDependency };
+    }
+    getAncestors() {
+        const members = [this];
+        const membersProcessed = [];
+        while (members.length > 0) {
+            const member = members.pop();
+            // Skip processing an already processed member.
+            if (membersProcessed.some((m) => m.getContext() === member.getContext())) {
+                continue;
+            }
+            for (const d of member.dependencies) {
+                // If in dependency I am not declared a parent, then d.to is either my parent or has a relationship to me.
+                // The behavior of that relationship should be that it must exist for me to exist.
+                if (!d.isParentRelationship() &&
+                    d.hasMatchingBehavior(undefined, DiffAction.ADD, undefined, DiffAction.ADD) &&
+                    !membersProcessed.some((m) => m.getContext() === d.to.getContext())) {
+                    members.push(d.to);
+                }
+            }
+            membersProcessed.push(member);
+        }
+        return membersProcessed;
+    }
+    getBoundaryMembers() {
+        const extenders = [this];
+        const members = [];
+        const parentOf = {};
+        const pushToExtenders = (nodes) => {
+            nodes.forEach((node) => {
+                if (!members.some((m) => m.getContext() === node.getContext())) {
+                    extenders.push(node);
+                }
+            });
+        };
+        while (extenders.length > 0) {
+            const node = extenders.pop();
+            const ancestors = node.getAncestors();
+            for (const ancestor of ancestors) {
+                // Skip processing an already processed ancestor.
+                if (members.some((m) => m.getContext() === ancestor.getContext())) {
+                    continue;
+                }
+                members.push(ancestor);
+                // Check for circular dependencies on ancestor.
+                for (const d of ancestor.dependencies) {
+                    let childContext;
+                    let parentContext;
+                    if (d.isParentRelationship()) {
+                        childContext = d.to.getContext();
+                        parentContext = d.from.getContext();
+                    }
+                    else if (d.isChildRelationship()) {
+                        childContext = d.from.getContext();
+                        parentContext = d.to.getContext();
+                    }
+                    else {
+                        // A relationship that is neither parent nor child, will not be reported in circular dependency!
+                        continue;
+                    }
+                    const seen = {};
+                    const toProcess = [parentContext];
+                    while (toProcess.length > 0) {
+                        const context = toProcess.pop();
+                        if (seen[context]) {
+                            throw new Error('Found circular dependencies!');
+                        }
+                        else {
+                            seen[context] = true;
+                        }
+                        toProcess.push(...(parentOf[context] || []));
+                    }
+                    if (!parentOf[childContext]) {
+                        parentOf[childContext] = [];
+                        parentOf[childContext].push(parentContext);
+                    }
+                    else if (!parentOf[childContext].some((p) => p === parentContext)) {
+                        parentOf[childContext].push(parentContext);
+                    }
+                }
+            }
+            const children = node.getChildren();
+            for (const name in children) {
+                pushToExtenders(children[name].map((d) => d.to));
+            }
+            const dependents = node.dependencies
+                .filter((d) => !d.isParentRelationship() && !d.isChildRelationship())
+                .map((d) => d.to);
+            pushToExtenders(dependents);
+        }
+        return members;
+    }
+    getChild(name, filters = []) {
+        const dependencies = this.getChildren(name)[name]?.filter((d) => filters.every((c) => d.to[c.key] === c.value));
+        if (!dependencies) {
+            return undefined;
+        }
+        if (dependencies.length > 1) {
+            throw new Error('More than one children found! Use getChildren() instead.');
+        }
+        return dependencies[0].to;
+    }
+    getChildren(name) {
+        return this.dependencies
+            .filter((d) => d.isParentRelationship() && (name ? d.to.NODE_NAME === name : true))
+            .reduce((accumulator, currentValue) => {
+            if (!(currentValue.to.NODE_NAME in accumulator)) {
+                accumulator[currentValue.to.NODE_NAME] = [];
+            }
+            accumulator[currentValue.to.NODE_NAME].push(currentValue);
+            return accumulator;
+        }, {});
+    }
+    getContext() {
+        if (!this.context) {
+            this.context = this.setContext();
+        }
+        return this.context;
+    }
+    getDependencies(to) {
+        const filters = [];
+        if (to) {
+            filters.push({ key: 'to', value: to.getContext() });
+        }
+        return this.dependencies.filter((d) => {
+            return filters.every((c) => {
+                if (c.key === 'to') {
+                    return d.to.getContext() === c.value;
+                }
+                else {
+                    return true;
+                }
+            });
+        });
+    }
+    getDependency(to, relationship) {
+        const index = this.getDependencyIndex(to, relationship);
+        return index > -1 ? this.dependencies[index] : undefined;
+    }
+    getDependencyIndex(to, relationship) {
+        return this.dependencies.findIndex((d) => d.from.getContext() === this.getContext() &&
+            d.to.getContext() === to.getContext() &&
+            d.getRelationship() !== undefined &&
+            d.getRelationship().type === relationship);
+    }
+    getParents(name) {
+        return this.dependencies
+            .filter((d) => d.isChildRelationship() && (name ? d.to.NODE_NAME === name : true))
+            .reduce((accumulator, currentValue) => {
+            if (!(currentValue.to.NODE_NAME in accumulator)) {
+                accumulator[currentValue.to.NODE_NAME] = [];
+            }
+            accumulator[currentValue.to.NODE_NAME].push(currentValue);
+            return accumulator;
+        }, {});
+    }
+    getSiblings(name) {
+        return this.dependencies
+            .filter((d) => !d.isChildRelationship() && !d.isParentRelationship() && (name ? d.to.NODE_NAME === name : true))
+            .reduce((accumulator, currentValue) => {
+            if (!(currentValue.to.NODE_NAME in accumulator)) {
+                accumulator[currentValue.to.NODE_NAME] = [];
+            }
+            accumulator[currentValue.to.NODE_NAME].push(currentValue);
+            return accumulator;
+        }, {});
+    }
+    hasAncestor(node) {
+        const nodeParts = node
+            .getContext()
+            .split(',')
+            .map((p) => p.split('='));
+        const ancestors = this.getAncestors();
+        return ancestors.some((a) => {
+            const ancestorParts = a
+                .getContext()
+                .split(',')
+                .reduce((map, p) => {
+                const parts = p.split('=');
+                map[parts[0]] = parts[1];
+                return map;
+            }, {});
+            return nodeParts.every((p) => ancestorParts[p[0]] === p[1]);
+        });
+    }
+    removeDependency(dependencyIndex) {
+        if (dependencyIndex > -1 && dependencyIndex < this.dependencies.length) {
+            this.dependencies.splice(dependencyIndex, 1);
+        }
+    }
+    removeRelationship(node) {
+        for (let i = this.dependencies.length - 1; i >= 0; i--) {
+            const dependency = this.dependencies[i];
+            if (dependency.to.getContext() === node.getContext()) {
+                this.dependencies.splice(i, 1);
+            }
+        }
+        for (let i = node.dependencies.length - 1; i >= 0; i--) {
+            const dependency = node.dependencies[i];
+            if (dependency.to.getContext() === this.getContext()) {
+                node.dependencies.splice(i, 1);
+            }
+        }
+    }
+    /**
+     * To create self given its serialized representation.
+     * - First argument is the serialized representation.
+     * - Second argument is the `deReferenceContext()` function to resolve other nodes self depends on.
+     */
+    static async unSynth(...args) {
+        if (args.length > 4) {
+            throw new Error('Too many args in unSynth()');
+        }
+        throw new Error('Method not implemented! Use derived class implementation');
+    }
+}
+//# sourceMappingURL=node.abstract.js.map

package/dist/functions/node/node.abstract.js.map

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

package/dist/functions/node/node.interface.d.ts

@@ -0,0 +1,176 @@
+import type { NodeType, UnknownNode } from '../../app.type.js';
+import type { Dependency, DependencyRelationship } from '../dependency/dependency.js';
+import type { Diff } from '../diff/diff.js';
+/**
+ * {@link ANode} interface.
+ */
+export interface INode<I, T> {
+    /**
+     * The unique name of the node.
+     * All nodes with same name are of the same category.
+     */
+    readonly NODE_NAME: string;
+    /**
+     * The type of the node.
+     */
+    readonly NODE_TYPE: NodeType;
+    /**
+     * To add another node as a child of self.
+     *
+     * @param onField The field in self on which the dependency is being defined.
+     * @param child The child node.
+     * @param toField The field in child on which the dependency is being defined.
+     * @returns
+     * - childToParentDependency: The dependency edge from child to self.
+     * - parentToChildDependency: The dependency edge from self to child.
+     * @throws {@link Error} Dependency relationship already exists!
+     */
+    addChild(onField: keyof T | string, child: UnknownNode, toField: string): {
+        childToParentDependency: Dependency;
+        parentToChildDependency: Dependency;
+    };
+    /**
+     * To add another node as a sibling of self.
+     *
+     * @param to The sibling node.
+     * @returns
+     * - thatToThisDependency: The dependency edge from sibling to self.
+     * - thisToThatDependency: The dependency edge from self to sibling.
+     */
+    addRelationship(to: UnknownNode): {
+        thatToThisDependency: Dependency;
+        thisToThatDependency: Dependency;
+    };
+    /**
+     * Compares and calculates the difference between the current version of self node, and the previous version.
+     * - Recursively compares self children too.
+     *
+     * @param previous The previous version of self.
+     */
+    diff(previous?: T): Promise<Diff[]>;
+    /**
+     * To compare properties of the current version of self node, vs. the previous version.
+     * It is a helper method to the `diff()` method.
+     * - This method is called by the {@link diff()} method.
+     *
+     * @param previous The previous version of self.
+     */
+    diffProperties(previous: T): Promise<Diff[]>;
+    /**
+     * To get all ancestors of self.
+     * - Includes parent nodes.
+     * - Might include sibling nodes,
+     * if the dependency behaviors dictate the sibling is necessary for self node to exist.
+     */
+    getAncestors(): UnknownNode[];
+    /**
+     * To get a boundary (sub graph) of self.
+     * A boundary is a group of nodes that must belong together.
+     * The boundary consists of all nodes associated with self,
+     * which includes parents, grand parents, children, grand children, and siblings.
+     */
+    getBoundaryMembers(): UnknownNode[];
+    /**
+     * To get a child of self that matches the given filters.
+     *
+     * @param name The {@link NODE_NAME} of the child.
+     * @param filters A set of filters, to be applied on children,
+     * where `key` is the property name and `value` is the value to filter by.
+     * @throws {@link Error} If more than one child is found.
+     */
+    getChild(name: string, filters: {
+        key: string;
+        value: any;
+    }[]): UnknownNode | undefined;
+    /**
+     * To get all children of self.
+     *
+     * @param name The {@link NODE_NAME} of the children.
+     * @returns All children as an object with the {@link NODE_NAME} as the key,
+     * and self's dependency to the child as the value.
+     */
+    getChildren(name?: string): {
+        [key: string]: Dependency[];
+    };
+    /**
+     * To get the context of self.
+     * A context is a string representation of self that uniquely identifies self in the graph.
+     */
+    getContext(): string;
+    /**
+     * To get all dependencies of self.
+     * - Can be filtered to just dependencies with a single node.
+     *
+     * @param to The other node. If present, will only return dependencies of self with this node.
+     */
+    getDependencies(to?: UnknownNode): Dependency[];
+    /**
+     * To get a dependency of self with another node.
+     *
+     * @param to The other node.
+     * @param relationship The relationship between self and the other node.
+     * @returns The dependency with the other node having the given relationship, or `undefined` if not found.
+     */
+    getDependency(to: UnknownNode, relationship: DependencyRelationship): Dependency | undefined;
+    /**
+     * To get the index of a dependency of self with another node.
+     *
+     * @param to The other node.
+     * @param relationship The relationship between self and the other node.
+     * @returns The index of the dependency with the other node having the given relationship, or `-1` if not found.
+     */
+    getDependencyIndex(to: UnknownNode, relationship: DependencyRelationship): number;
+    /**
+     * To get all parent of self.
+     *
+     * @param name The {@link NODE_NAME} of the parent.
+     * @returns All parents as an object with the {@link NODE_NAME} as the key,
+     * and self's dependency to the parent as the value.
+     */
+    getParents(name?: string): {
+        [key: string]: Dependency[];
+    };
+    /**
+     * To get all siblings of self.
+     *
+     * @param name The {@link NODE_NAME} of the sibling.
+     * @returns All siblings as an object with the {@link NODE_NAME} as the key,
+     * and self's dependency to the sibling as the value.
+     */
+    getSiblings(name?: string): {
+        [key: string]: Dependency[];
+    };
+    /**
+     * To check if given node is an ancestor of self.
+     *
+     * @param node The other node.
+     */
+    hasAncestor(node: UnknownNode): boolean;
+    /**
+     * To remove a dependency from self.
+     *
+     * @param dependencyIndex The index of the dependency to remove.
+     */
+    removeDependency(dependencyIndex: number): void;
+    /**
+     * To remove ALL dependencies from self for the given node.
+     *
+     * @param node The other node.
+     */
+    removeRelationship(node: UnknownNode): void;
+    /**
+     * To set the context of self.
+     * A context is a string representation of self that uniquely identifies self in the graph.
+     */
+    setContext(): string;
+    /**
+     * Generates a serializable representation of self.
+     */
+    synth(): I;
+}
+/**
+ * Node Reference encapsulates identification information of self.
+ */
+export interface INodeReference {
+    context: string;
+}

package/dist/functions/node/node.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node.interface.js.map

package/dist/functions/node/node.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.interface.js","sourceRoot":"","sources":["../../../src/functions/node/node.interface.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,26 +1,25 @@
 export { Action } from './decorators/action.decorator.js';
 export { Anchor } from './decorators/anchor.decorator.js';
-export { Container } from './decorators/container.js';
-export { EnableHook } from './decorators/enable-hook.decorator.js';
 export { Factory } from './decorators/factory.decorator.js';
 export { Model } from './decorators/model.decorator.js';
-export { Module } from './decorators/module.decorator.js';
+export { type IModuleOptions, Module } from './decorators/module.decorator.js';
 export { OnEvent } from './decorators/on-event.decorator.js';
 export { Overlay } from './decorators/overlay.decorator.js';
 export { Resource } from './decorators/resource.decorator.js';
-export { IPackageMock, TestContainer } from './decorators/test-container.js';
 export { Validate } from './decorators/validate.decorator.js';
-export { DependencyRelationship } from './functions/dependency/dependency.js';
+export * from './events/error.event.js';
+export * from './events/event.model.js';
+export * from './events/hook.event.js';
+export * from './events/module.event.js';
+export * from './events/registration.event.js';
+export * from './events/serialization.event.js';
+export * from './events/transaction.event.js';
+export { Container } from './functions/container/container.js';
+export { IPackageMock, TestContainer } from './functions/container/test-container.js';
+export { Dependency, DependencyRelationship, IDependency } from './functions/dependency/dependency.js';
 export { Diff, DiffAction } from './functions/diff/diff.js';
 export { DiffUtility } from './functions/diff/diff.utility.js';
 export { DiffMetadata } from './functions/diff/diff-metadata.js';
-export { ErrorEvent, RegistrationErrorEvent } from './events/error.event.js';
-export { Event } from './events/event.model.js';
-export { CommitHookCallbackDoneEvent, CommitHookEvent, HookEvent, ModelActionHookCallbackDoneEvent, ModelActionHookEvent, PostCommitHookCallbackDoneEvent, PostModelActionHookCallbackDoneEvent, PostResourceActionHookCallbackDoneEvent, PreCommitHookCallbackDoneEvent, PreModelActionHookCallbackDoneEvent, PreResourceActionHookCallbackDoneEvent, ResourceActionHookCallbackDoneEvent, ResourceActionHookEvent, } from './events/hook.event.js';
-export { ModuleEvent } from './events/module.event.js';
-export { AnchorRegistrationEvent, ModelActionRegistrationEvent, ModelRegistrationEvent, OverlayRegistrationEvent, RegistrationEvent, ResourceActionRegistrationEvent, ResourceRegistrationEvent, } from './events/registration.event.js';
-export { ModelDeserializedEvent, ModelSerializedEvent, ResourceDeserializedEvent, ResourceSerializedEvent, SerializationEvent, } from './events/serialization.event.js';
-export { ModelActionTransactionEvent, ResourceActionTransactionEvent, TransactionEvent, } from './events/transaction.event.js';
 export { type IApp } from './models/app/app.interface.js';
 export { App } from './models/app/app.model.js';
 export { type IDeployment } from './models/deployment/deployment.interface.js';

package/dist/index.js

@@ -1,26 +1,25 @@
 export { Action } from './decorators/action.decorator.js';
 export { Anchor } from './decorators/anchor.decorator.js';
-export { Container } from './decorators/container.js';
-export { EnableHook } from './decorators/enable-hook.decorator.js';
 export { Factory } from './decorators/factory.decorator.js';
 export { Model } from './decorators/model.decorator.js';
 export { Module } from './decorators/module.decorator.js';
 export { OnEvent } from './decorators/on-event.decorator.js';
 export { Overlay } from './decorators/overlay.decorator.js';
 export { Resource } from './decorators/resource.decorator.js';
-export { TestContainer } from './decorators/test-container.js';
 export { Validate } from './decorators/validate.decorator.js';
-export { DependencyRelationship } from './functions/dependency/dependency.js';
+export * from './events/error.event.js';
+export * from './events/event.model.js';
+export * from './events/hook.event.js';
+export * from './events/module.event.js';
+export * from './events/registration.event.js';
+export * from './events/serialization.event.js';
+export * from './events/transaction.event.js';
+export { Container } from './functions/container/container.js';
+export { TestContainer } from './functions/container/test-container.js';
+export { Dependency, DependencyRelationship } from './functions/dependency/dependency.js';
 export { Diff, DiffAction } from './functions/diff/diff.js';
 export { DiffUtility } from './functions/diff/diff.utility.js';
 export { DiffMetadata } from './functions/diff/diff-metadata.js';
-export { ErrorEvent, RegistrationErrorEvent } from './events/error.event.js';
-export { Event } from './events/event.model.js';
-export { CommitHookCallbackDoneEvent, CommitHookEvent, HookEvent, ModelActionHookCallbackDoneEvent, ModelActionHookEvent, PostCommitHookCallbackDoneEvent, PostModelActionHookCallbackDoneEvent, PostResourceActionHookCallbackDoneEvent, PreCommitHookCallbackDoneEvent, PreModelActionHookCallbackDoneEvent, PreResourceActionHookCallbackDoneEvent, ResourceActionHookCallbackDoneEvent, ResourceActionHookEvent, } from './events/hook.event.js';
-export { ModuleEvent } from './events/module.event.js';
-export { AnchorRegistrationEvent, ModelActionRegistrationEvent, ModelRegistrationEvent, OverlayRegistrationEvent, RegistrationEvent, ResourceActionRegistrationEvent, ResourceRegistrationEvent, } from './events/registration.event.js';
-export { ModelDeserializedEvent, ModelSerializedEvent, ResourceDeserializedEvent, ResourceSerializedEvent, SerializationEvent, } from './events/serialization.event.js';
-export { ModelActionTransactionEvent, ResourceActionTransactionEvent, TransactionEvent, } from './events/transaction.event.js';
 export { App } from './models/app/app.model.js';
 export { Deployment } from './models/deployment/deployment.model.js';
 export { Environment } from './models/environment/environment.model.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,EAAuB,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAgB,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAe,MAAM,sCAAsC,CAAC;AACvG,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAElE,OAAO,EAA4B,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAEzD,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAEjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAEvF,cAAc,eAAe,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/main.d.ts

@@ -1,6 +1,5 @@
 import { ActionInputs, Constructable, TransactionOptions, UnknownResource } from './app.type.js';
-import { Container } from './decorators/container.js';
-import { DiffMetadata } from './functions/diff/diff-metadata.js';
+import { Container } from './functions/container/container.js';
 import { App } from './models/app/app.model.js';
 import { IModule } from './modules/module.interface.js';
 import { AResource } from './resources/resource.abstract.js';
@@ -8,8 +7,8 @@ import { IStateProvider } from './services/state-management/state-provider.inter
 import { TransactionService } from './services/transaction/transaction.service.js';
 export declare class Octo {
     private readonly modelStateFileName;
-    private readonly resourceStateFileName;
-    private previousApp;
+    private readonly actualResourceStateFileName;
+    private readonly oldResourceStateFileName;
     private captureService;
     private inputService;
     private modelSerializationService;
@@ -19,21 +18,20 @@ export declare class Octo {
     private stateManagementService;
     private transactionService;
     private validationService;
-    beginTransaction(app: App, options?: TransactionOptions): Promise<ReturnType<TransactionService['beginTransaction']>>;
-    commitTransaction(app: App, modelTransaction: DiffMetadata[][]): Promise<void>;
+    beginTransaction(app: App, { enableResourceCapture, yieldModelDiffs, yieldModelTransaction, yieldResourceDiffs, yieldResourceTransaction, }?: TransactionOptions): ReturnType<TransactionService['beginTransaction']>;
+    private commitTransaction;
     compose(): Promise<void>;
     getAllResources(): UnknownResource[];
     getModuleOutput<T>(module: Constructable<IModule<T>> | string): T | undefined;
     initialize(stateProvider: IStateProvider, initializeInContainer?: {
         type: Parameters<typeof Container.get>[0];
-        options: Parameters<typeof Container.get>[1];
+        options?: Parameters<typeof Container.get>[1];
     }[], excludeInContainer?: {
         type: Parameters<typeof Container.unRegisterFactory>[0];
     }[]): Promise<void>;
     loadModules(modules: Constructable<IModule<any>>[]): void;
-    registerCapture<T extends AResource<T>>(resourceId: T['resourceId'], properties: Partial<T['properties']>, response: Partial<T['response']>): void;
+    registerCapture<T extends AResource<T>>(resourceId: T['resourceId'], response: Partial<T['response']>): void;
     registerInputs(inputs: ActionInputs): void;
-    private retrieveModelState;
     private retrieveResourceState;
     private saveModelState;
     private saveResourceState;