@quadnix/octo 0.0.22 → 0.0.23

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

@@ -1,48 +1,67 @@
+import type { DiffMetadata } from '../functions/diff/diff-metadata.js';
 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.
- * :::
+ * @group Events
+ * @returns The Event instance.
+ */
+export declare class TransactionEvent<T> extends Event<T> {
+}
+/**
+ * This event is emitted when a model action in a transaction is done executing.
  *
- * @example
- * ```ts
- * const myEvent = new TransactionEvent('MyActionName');
- * EventService.getInstance().emit(myEvent);
- * ```
  * @group Events
  * @returns The Event instance.
  */
-export declare class TransactionEvent extends Event<string> {
+export declare class ModelActionTransactionEvent extends TransactionEvent<void> {
 }
 /**
- * This event is emitted when a model action is done executing.
+ * This event is emitted when transaction prepares a model diff.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export declare class ModelDiffsTransactionEvent extends TransactionEvent<DiffMetadata[][]> {
+}
+/**
+ * This event is emitted when transaction prepares a model transaction.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export declare class ModelTransactionTransactionEvent extends TransactionEvent<DiffMetadata[][]> {
+}
+/**
+ * This event is emitted when a resource action in a transaction 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 {
+export declare class ResourceActionCompletedTransactionEvent extends TransactionEvent<string> {
 }
 /**
- * This event is emitted when a resource action is done executing.
+ * This event is emitted when a resource action in a transaction begins executing.
  *
- * @example
- * ```ts
- * const myEvent = new ResourceActionTransactionEvent('MyActionName');
- * EventService.getInstance().emit(myEvent);
- * ```
  * @group Events
  * @returns The Event instance.
  */
-export declare class ResourceActionTransactionEvent extends TransactionEvent {
+export declare class ResourceActionInitiatedTransactionEvent extends TransactionEvent<string> {
+}
+/**
+ * This event is emitted when transaction prepares a resource diff.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export declare class ResourceDiffsTransactionEvent extends TransactionEvent<[DiffMetadata[][], DiffMetadata[][]]> {
+}
+/**
+ * This event is emitted when transaction prepares a resource transaction.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export declare class ResourceTransactionTransactionEvent extends TransactionEvent<[DiffMetadata[][], DiffMetadata[][]]> {
 }

package/dist/events/transaction.event.js

@@ -2,48 +2,66 @@ 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.
+ * This event is emitted when a model action in a transaction 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.
+ * This event is emitted when transaction prepares a model diff.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export class ModelDiffsTransactionEvent extends TransactionEvent {
+}
+/**
+ * This event is emitted when transaction prepares a model transaction.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export class ModelTransactionTransactionEvent extends TransactionEvent {
+}
+/**
+ * This event is emitted when a resource action in a transaction 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 {
+export class ResourceActionCompletedTransactionEvent extends TransactionEvent {
+}
+/**
+ * This event is emitted when a resource action in a transaction begins executing.
+ *
+ * @group Events
+ * @returns The Event instance.
+ */
+export class ResourceActionInitiatedTransactionEvent extends TransactionEvent {
+}
+/**
+ * This event is emitted when transaction prepares a resource diff.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export class ResourceDiffsTransactionEvent extends TransactionEvent {
+}
+/**
+ * This event is emitted when transaction prepares a resource transaction.
+
+ * @group Events
+ * @returns The Event instance.
+ */
+export class ResourceTransactionTransactionEvent 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;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"transaction.event.js","sourceRoot":"","sources":["../../src/events/transaction.event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,OAAO,gBAAoB,SAAQ,KAAQ;CAAG;AAEpD;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,gBAAsB;CAAG;AAE1E;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,gBAAkC;CAAG;AAErF;;;;;GAKG;AACH,MAAM,OAAO,gCAAiC,SAAQ,gBAAkC;CAAG;AAE3F;;;;;GAKG;AACH,MAAM,OAAO,uCAAwC,SAAQ,gBAAwB;CAAG;AAExF;;;;;GAKG;AACH,MAAM,OAAO,uCAAwC,SAAQ,gBAAwB;CAAG;AAExF;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,gBAAsD;CAAG;AAE5G;;;;;GAKG;AACH,MAAM,OAAO,mCAAoC,SAAQ,gBAAsD;CAAG"}

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

@@ -2,6 +2,13 @@ import type { Constructable } from '../../app.type.js';
 type Factory<T> = {
     create: (...args: unknown[]) => Promise<T>;
 };
+type FactoryValue<T> = Factory<T> | [Promise<Factory<T>>, (factory: Factory<T>) => void];
+type FactoryContainer<T> = {
+    factory: FactoryValue<T>;
+    metadata: {
+        [key: string]: string;
+    };
+};
 /**
  * The Container class is a box to hold all registered factories.
  *
@@ -12,42 +19,80 @@ type Factory<T> = {
  * It is an incredibly powerful tool to customize implementation.
  */
 export declare class Container {
-    private static FACTORY_TIMEOUT_IN_MS;
-    private static readonly factories;
+    private FACTORY_TIMEOUT_IN_MS;
+    private readonly factories;
+    private static instance;
+    private readonly startupUnhandledPromises;
+    private constructor();
+    copyFactories(): {
+        [key: string]: FactoryContainer<unknown>[];
+    };
     /**
-     * `Container.get()` allows to get an instance of a class using its factory.
+     * `container.get()` allows to get an instance of a class using its factory.
+     * If the factory is not yet registered, it places a blocking promise in the queue to wait for the registration.
      *
      * @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.
+     * - The `metadata` option identifies the factory.
      * @returns The instance of the class.
      */
-    static get<T>(type: Constructable<T> | string, options?: {
-        args?: unknown[];
+    get<T, F extends Factory<T> = never>(type: Constructable<T> | string, options?: {
+        args?: Parameters<F['create']>;
+        metadata?: {
+            [key: string]: string;
+        };
     }): Promise<T>;
+    static getInstance(): Container;
+    has<T>(type: Constructable<T> | string, options?: {
+        metadata?: {
+            [key: string]: string;
+        };
+    }): boolean;
     /**
      * `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.
+     * @param options Distinguishes between different factories of the same class.
+     * - The `metadata` attaches custom metadata to the factory.
      */
-    static registerFactory<T>(type: Constructable<T> | string, factory: Factory<T>): void;
+    registerFactory<T>(type: Constructable<T> | string, factory: Factory<T>, options?: {
+        metadata?: {
+            [key: string]: string;
+        };
+    }): void;
+    registerValue<T>(type: Constructable<T> | string, value: T, options?: {
+        metadata?: {
+            [key: string]: string;
+        };
+    }): void;
+    registerStartupUnhandledPromise<T>(promise: Promise<T>): void;
     /**
      * `Container.reset()` clears all registered factories and empties the container. This is mostly used in testing.
      */
-    static reset(): void;
+    reset(): void;
+    setFactories(factories: {
+        [key: string]: FactoryContainer<unknown>[];
+    }): 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;
+    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.
+     * @param options
      */
-    static unRegisterFactory<T>(type: Constructable<T> | string): void;
+    unRegisterFactory<T>(type: Constructable<T> | string, options?: {
+        metadata?: {
+            [key: string]: string;
+        };
+    }): void;
+    waitToResolveAllFactories(): Promise<void>;
 }
 export {};

package/dist/functions/container/container.js

@@ -1,3 +1,5 @@
+import { ContainerRegistrationError, ContainerResolutionError } from '../../errors/index.js';
+import { DiffUtility } from '../diff/diff.utility.js';
 /**
  * The Container class is a box to hold all registered factories.
  *
@@ -8,20 +10,42 @@
  * It is an incredibly powerful tool to customize implementation.
  */
 export class Container {
-    static { this.FACTORY_TIMEOUT_IN_MS = 5000; }
-    static { this.factories = {}; }
+    constructor() {
+        this.FACTORY_TIMEOUT_IN_MS = 3000;
+        this.factories = {};
+        this.startupUnhandledPromises = [];
+    }
+    copyFactories() {
+        const newFactoriesCopy = {};
+        for (const [type, factoryContainers] of Object.entries(this.factories)) {
+            newFactoriesCopy[type] = [];
+            for (const factoryContainer of factoryContainers) {
+                newFactoriesCopy[type].push({
+                    factory: factoryContainer.factory,
+                    metadata: { ...factoryContainer.metadata },
+                });
+            }
+        }
+        return newFactoriesCopy;
+    }
     /**
-     * `Container.get()` allows to get an instance of a class using its factory.
+     * `container.get()` allows to get an instance of a class using its factory.
+     * If the factory is not yet registered, it places a blocking promise in the queue to wait for the registration.
      *
      * @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.
+     * - The `metadata` option identifies the factory.
      * @returns The instance of the class.
      */
-    static async get(type, options) {
+    async get(type, options) {
         const args = options?.args || [];
+        const metadata = options?.metadata || {};
         const name = typeof type === 'string' ? type : type.name;
-        const factoryContainer = this.factories[name];
+        if (!(name in this.factories)) {
+            this.factories[name] = [];
+        }
+        const factoryContainer = this.factories[name].find((f) => DiffUtility.isObjectDeepEquals(f.metadata, metadata));
         if (factoryContainer?.factory) {
             if (!Array.isArray(factoryContainer.factory)) {
                 return factoryContainer.factory.create(...args);
@@ -31,13 +55,15 @@ export class Container {
                 return factory.create(...args);
             }
         }
-        const newFactoryContainer = {};
-        this.factories[name] = newFactoryContainer;
+        const newFactoryContainer = {
+            metadata,
+        };
+        this.factories[name].push(newFactoryContainer);
         let promiseResolver;
         let promiseTimeout;
         const promise = new Promise((resolve, reject) => {
             promiseTimeout = setTimeout(() => {
-                reject(new Error(`Timed out waiting for factory ${name} to resolve!`));
+                reject(new ContainerResolutionError('Timed out waiting for factory to resolve!', type));
             }, this.FACTORY_TIMEOUT_IN_MS);
             promiseResolver = resolve;
         });
@@ -48,37 +74,78 @@ export class Container {
         }
         return factory.create(...args);
     }
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new Container();
+        }
+        return this.instance;
+    }
+    has(type, options) {
+        const metadata = options?.metadata || {};
+        const name = typeof type === 'string' ? type : type.name;
+        if (!(name in this.factories)) {
+            return false;
+        }
+        return this.factories[name].some((f) => DiffUtility.isObjectDeepEquals(f.metadata, metadata));
+    }
     /**
      * `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.
+     * @param options Distinguishes between different factories of the same class.
+     * - The `metadata` attaches custom metadata to the factory.
      */
-    static registerFactory(type, factory) {
+    registerFactory(type, factory, options) {
+        const metadata = options?.metadata || {};
         const name = typeof type === 'string' ? type : type.name;
-        const factoryContainer = this.factories[name];
+        if (!(name in this.factories)) {
+            this.factories[name] = [];
+        }
+        const factoryContainer = this.factories[name].find((f) => DiffUtility.isObjectDeepEquals(f.metadata, metadata));
         if (factoryContainer?.factory) {
             // If factory is not a promise set by get() above, it has already been registered.
             if (!Array.isArray(factoryContainer.factory)) {
-                return;
+                throw new ContainerRegistrationError('Factory has already been registered!', type);
             }
+            factoryContainer.metadata = metadata;
             const resolve = factoryContainer.factory[1];
             resolve(factory);
             factoryContainer.factory = factory;
             return;
         }
-        else {
-            this.factories[name] = { factory };
-        }
+        this.factories[name].push({ factory, metadata });
+    }
+    registerValue(type, value, options) {
+        this.registerFactory(type, class {
+            static async create() {
+                return value;
+            }
+        }, options);
+    }
+    registerStartupUnhandledPromise(promise) {
+        this.startupUnhandledPromises.push(promise);
     }
     /**
      * `Container.reset()` clears all registered factories and empties the container. This is mostly used in testing.
      */
-    static reset() {
-        this.FACTORY_TIMEOUT_IN_MS = 5000;
+    reset() {
+        this.FACTORY_TIMEOUT_IN_MS = 3000;
         for (const name in this.factories) {
             delete this.factories[name];
         }
+        this.startupUnhandledPromises.splice(0, this.startupUnhandledPromises.length);
+    }
+    setFactories(factories) {
+        for (const [type, factoryContainers] of Object.entries(factories)) {
+            this.factories[type] = [];
+            for (const factoryContainer of factoryContainers) {
+                this.factories[type].push({
+                    factory: factoryContainer.factory,
+                    metadata: { ...factoryContainer.metadata },
+                });
+            }
+        }
     }
     /**
      * The Container, by default, will wait a maximum of 5 seconds for a factory to resolve and provide an instance.
@@ -86,17 +153,37 @@ export class Container {
      *
      * @param timeoutInMs The timeout in milliseconds.
      */
-    static setFactoryTimeout(timeoutInMs) {
+    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.
+     * @param options
      */
-    static unRegisterFactory(type) {
+    unRegisterFactory(type, options) {
         const name = typeof type === 'string' ? type : type.name;
-        delete this.factories[name];
+        if (!options) {
+            delete this.factories[name];
+            return;
+        }
+        const metadata = options?.metadata || {};
+        const index = this.factories[name]?.findIndex((f) => DiffUtility.isObjectDeepEquals(f.metadata, metadata));
+        if (index > -1) {
+            this.factories[name].splice(index, 1);
+        }
+    }
+    async waitToResolveAllFactories() {
+        const promiseToResolveAllFactories = [];
+        for (const name of Object.keys(this.factories)) {
+            for (const factoryContainer of this.factories[name]) {
+                if (factoryContainer?.factory && Array.isArray(factoryContainer.factory)) {
+                    promiseToResolveAllFactories.push(factoryContainer.factory[0]);
+                }
+            }
+        }
+        await Promise.all([...promiseToResolveAllFactories, ...this.startupUnhandledPromises]);
     }
 }
 //# sourceMappingURL=container.js.map

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

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

@@ -1,20 +1,18 @@
 import type { Constructable } from '../../app.type.js';
+import { Container } from './container.js';
 type FactoryMock<T> = {
+    metadata?: {
+        [key: string]: string;
+    };
     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.
  *
@@ -30,8 +28,8 @@ export interface IPackageMock {
  * Once tests are done executing, the `afterAll()` block cleans up the Container.
  */
 export declare class TestContainer {
-    private static packageMocks;
-    private static createTestFactory;
+    private static originalFactories;
+    private static bootstrap;
     /**
      * The `TestContainer.create()` method allows you to mock factories.
      *
@@ -39,25 +37,23 @@ export declare class TestContainer {
      * ```ts
      * beforeAll(async () => {
      *   await TestContainer.create({
-     *     importFrom: [OctoAwsCdkPackageMock],
      *     mocks: [
      *       { type: MyClass, value: jest.fn() },
-     *       { type: AnotherClass, value: new AnotherClass() },
+     *       { metadata: { key: 'value' }, 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 `metadata?: { [key: string]: string }` to identify the factory being mocked.
      *   - 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>;
+    static create(subjects: TestContainerSubjects, options?: TestContainerOptions): Promise<Container>;
     /**
      * The `TestContainer.reset()` method will completely destroy all factories from the Container.
      * Because the entire Container is destroyed, and not just the mocks,