@decaf-ts/for-typeorm 0.0.6

package/lib/esm/TypeORMDispatch.d.ts

@@ -0,0 +1,87 @@
+import { Dispatch, EventIds } from "@decaf-ts/core";
+import { OperationKeys } from "@decaf-ts/db-decorators";
+import { DataSourceOptions } from "typeorm/data-source/DataSourceOptions";
+/**
+ * @description Dispatcher for TypeORM-driven change events.
+ * @summary Subscribes a TypeORM DataSource with a custom EntitySubscriber to notify observers when records are created, updated, or deleted.
+ * @param {number} [timeout=5000] Timeout in milliseconds for initialization retries.
+ * @class TypeORMDispatch
+ * @example
+ * // Create a dispatcher for a TypeORM DataSource
+ * const dispatch = new TypeORMDispatch();
+ * await dispatch.observe(adapter, adapter.dataSource.options);
+ *
+ * // The dispatcher registers a TypeORMEventSubscriber and notifies observers when entities change.
+ * @mermaid
+ * classDiagram
+ *   class Dispatch {
+ *     +initialize()
+ *     +updateObservers()
+ *   }
+ *   class TypeORMDispatch {
+ *     -observerLastUpdate?: string
+ *     -attemptCounter: number
+ *     -timeout: number
+ *     +constructor(timeout)
+ *     #notificationHandler()
+ *     #initialize()
+ *   }
+ *   Dispatch <|-- TypeORMDispatch
+ */
+export declare class TypeORMDispatch extends Dispatch<DataSourceOptions> {
+    private timeout;
+    private observerLastUpdate?;
+    private attemptCounter;
+    constructor(timeout?: number);
+    /**
+     * @description Processes TypeORM notification events.
+     * @summary Handles change notifications (translated from TypeORM events) and notifies observers about record changes.
+     * @param {string} table The notification payload.
+     * @param {OperationKeys} operation The notification payload.
+     * @param {EventIds} ids The notification payload.
+     * @return {Promise<void>} A promise that resolves when all notifications have been processed.
+     * @mermaid
+     * sequenceDiagram
+     *   participant D as PostgreSQLDispatch
+     *   participant L as Logger
+     *   participant O as Observers
+     *   Note over D: Receive notification from PostgreSQL
+     *   D->>D: Parse notification payload
+     *   D->>D: Extract table, operation, and ids
+     *   D->>O: updateObservers(table, operation, ids)
+     *   D->>D: Update observerLastUpdate
+     *   D->>L: Log successful dispatch
+     */
+    protected notificationHandler(table: string, operation: OperationKeys, ids: EventIds): Promise<void>;
+    /**
+     * @description Initializes the dispatcher and subscribes to TypeORM notifications.
+     * @summary Registers the TypeORMEventSubscriber on the DataSource and logs the subscription lifecycle.
+     * @return {Promise<void>} A promise that resolves when the subscription is established.
+     * @mermaid
+     * sequenceDiagram
+     *   participant D as TypeORMDispatch
+     *   participant S as subscribeToTypeORM
+     *   participant DS as TypeORM DataSource
+     *   participant L as Logger
+     *   D->>S: Call subscribeToTypeORM
+     *   S->>S: Check adapter and native
+     *   alt No adapter or native
+     *     S-->>S: throw InternalError
+     *   end
+     *   S->>DS: initialize()
+     *   S->>DS: subscribers.push(TypeORMEventSubscriber)
+     *   alt Success
+     *     DS-->>S: Subscription established
+     *     S-->>D: Promise resolves
+     *     D->>L: Log successful subscription
+     *   else Error
+     *     DS-->>S: Error
+     *     S-->>D: Promise rejects
+     *   end
+     */
+    protected initialize(): Promise<void>;
+    /**
+     * Cleanup method to release resources when the dispatcher is no longer needed
+     */
+    cleanup(): void;
+}

package/lib/esm/TypeORMDispatch.js

@@ -0,0 +1,130 @@
+import { Dispatch } from "@decaf-ts/core";
+import { InternalError } from "@decaf-ts/db-decorators";
+import { TypeORMEventSubscriber } from "./TypeORMEventSubscriber.js";
+/**
+ * @description Dispatcher for TypeORM-driven change events.
+ * @summary Subscribes a TypeORM DataSource with a custom EntitySubscriber to notify observers when records are created, updated, or deleted.
+ * @param {number} [timeout=5000] Timeout in milliseconds for initialization retries.
+ * @class TypeORMDispatch
+ * @example
+ * // Create a dispatcher for a TypeORM DataSource
+ * const dispatch = new TypeORMDispatch();
+ * await dispatch.observe(adapter, adapter.dataSource.options);
+ *
+ * // The dispatcher registers a TypeORMEventSubscriber and notifies observers when entities change.
+ * @mermaid
+ * classDiagram
+ *   class Dispatch {
+ *     +initialize()
+ *     +updateObservers()
+ *   }
+ *   class TypeORMDispatch {
+ *     -observerLastUpdate?: string
+ *     -attemptCounter: number
+ *     -timeout: number
+ *     +constructor(timeout)
+ *     #notificationHandler()
+ *     #initialize()
+ *   }
+ *   Dispatch <|-- TypeORMDispatch
+ */
+export class TypeORMDispatch extends Dispatch {
+    constructor(timeout = 5000) {
+        super();
+        this.timeout = timeout;
+        this.attemptCounter = 0;
+    }
+    /**
+     * @description Processes TypeORM notification events.
+     * @summary Handles change notifications (translated from TypeORM events) and notifies observers about record changes.
+     * @param {string} table The notification payload.
+     * @param {OperationKeys} operation The notification payload.
+     * @param {EventIds} ids The notification payload.
+     * @return {Promise<void>} A promise that resolves when all notifications have been processed.
+     * @mermaid
+     * sequenceDiagram
+     *   participant D as PostgreSQLDispatch
+     *   participant L as Logger
+     *   participant O as Observers
+     *   Note over D: Receive notification from PostgreSQL
+     *   D->>D: Parse notification payload
+     *   D->>D: Extract table, operation, and ids
+     *   D->>O: updateObservers(table, operation, ids)
+     *   D->>D: Update observerLastUpdate
+     *   D->>L: Log successful dispatch
+     */
+    async notificationHandler(table, operation, ids) {
+        const log = this.log.for(this.notificationHandler);
+        try {
+            // Notify observers
+            await this.updateObservers(table, operation, ids);
+            this.observerLastUpdate = new Date().toISOString();
+            log.verbose(`Observer refresh dispatched by ${operation} for ${table}`);
+            log.debug(`pks: ${ids}`);
+        }
+        catch (e) {
+            log.error(`Failed to process notification: ${e}`);
+        }
+    }
+    /**
+     * @description Initializes the dispatcher and subscribes to TypeORM notifications.
+     * @summary Registers the TypeORMEventSubscriber on the DataSource and logs the subscription lifecycle.
+     * @return {Promise<void>} A promise that resolves when the subscription is established.
+     * @mermaid
+     * sequenceDiagram
+     *   participant D as TypeORMDispatch
+     *   participant S as subscribeToTypeORM
+     *   participant DS as TypeORM DataSource
+     *   participant L as Logger
+     *   D->>S: Call subscribeToTypeORM
+     *   S->>S: Check adapter and native
+     *   alt No adapter or native
+     *     S-->>S: throw InternalError
+     *   end
+     *   S->>DS: initialize()
+     *   S->>DS: subscribers.push(TypeORMEventSubscriber)
+     *   alt Success
+     *     DS-->>S: Subscription established
+     *     S-->>D: Promise resolves
+     *     D->>L: Log successful subscription
+     *   else Error
+     *     DS-->>S: Error
+     *     S-->>D: Promise rejects
+     *   end
+     */
+    async initialize() {
+        async function subscribeToTypeORM() {
+            if (!this.adapter || !this.native) {
+                throw new InternalError(`No adapter/native observed for dispatch`);
+            }
+            const adapter = this.adapter;
+            try {
+                if (!adapter.dataSource.isInitialized)
+                    await adapter.dataSource.initialize();
+                adapter.dataSource.subscribers.push(new TypeORMEventSubscriber(this.notificationHandler.bind(this)));
+            }
+            catch (e) {
+                throw new InternalError(e);
+            }
+        }
+        subscribeToTypeORM
+            .call(this)
+            .then(() => {
+            this.log.info(`Subscribed to TypeORM notifications`);
+        })
+            .catch((e) => {
+            throw new InternalError(`Failed to subscribe to TypeORM notifications: ${e}`);
+        });
+    }
+    /**
+     * Cleanup method to release resources when the dispatcher is no longer needed
+     */
+    cleanup() {
+        // if (this.adapter) {
+        //
+        //   const adapter = this.adapter as TypeORMAdapter;
+        //   await adapter.dataSource.destroy();
+        // }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVHlwZU9STURpc3BhdGNoLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL1R5cGVPUk1EaXNwYXRjaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFZLE1BQU0sZ0JBQWdCLENBQUM7QUFDcEQsT0FBTyxFQUFFLGFBQWEsRUFBaUIsTUFBTSx5QkFBeUIsQ0FBQztBQUd2RSxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsb0NBQWlDO0FBRWxFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQTBCRztBQUNILE1BQU0sT0FBTyxlQUFnQixTQUFRLFFBQTJCO0lBSTlELFlBQW9CLFVBQVUsSUFBSTtRQUNoQyxLQUFLLEVBQUUsQ0FBQztRQURVLFlBQU8sR0FBUCxPQUFPLENBQU87UUFGMUIsbUJBQWMsR0FBVyxDQUFDLENBQUM7SUFJbkMsQ0FBQztJQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FrQkc7SUFDTyxLQUFLLENBQUMsbUJBQW1CLENBQ2pDLEtBQWEsRUFDYixTQUF3QixFQUN4QixHQUFhO1FBRWIsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLG1CQUFtQixDQUFDLENBQUM7UUFDbkQsSUFBSSxDQUFDO1lBQ0gsbUJBQW1CO1lBQ25CLE1BQU0sSUFBSSxDQUFDLGVBQWUsQ0FBQyxLQUFLLEVBQUUsU0FBUyxFQUFFLEdBQUcsQ0FBQyxDQUFDO1lBQ2xELElBQUksQ0FBQyxrQkFBa0IsR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRSxDQUFDO1lBQ25ELEdBQUcsQ0FBQyxPQUFPLENBQUMsa0NBQWtDLFNBQVMsUUFBUSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQ3hFLEdBQUcsQ0FBQyxLQUFLLENBQUMsUUFBUSxHQUFHLEVBQUUsQ0FBQyxDQUFDO1FBQzNCLENBQUM7UUFBQyxPQUFPLENBQVUsRUFBRSxDQUFDO1lBQ3BCLEdBQUcsQ0FBQyxLQUFLLENBQUMsbUNBQW1DLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDcEQsQ0FBQztJQUNILENBQUM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztPQXlCRztJQUNnQixLQUFLLENBQUMsVUFBVTtRQUNqQyxLQUFLLFVBQVUsa0JBQWtCO1lBQy9CLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDO2dCQUNsQyxNQUFNLElBQUksYUFBYSxDQUFDLHlDQUF5QyxDQUFDLENBQUM7WUFDckUsQ0FBQztZQUVELE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxPQUF5QixDQUFDO1lBRS9DLElBQUksQ0FBQztnQkFDSCxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxhQUFhO29CQUNuQyxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsVUFBVSxFQUFFLENBQUM7Z0JBRXhDLE9BQU8sQ0FBQyxVQUFVLENBQUMsV0FBVyxDQUFDLElBQUksQ0FDakMsSUFBSSxzQkFBc0IsQ0FBQyxJQUFJLENBQUMsbUJBQW1CLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQ2hFLENBQUM7WUFDSixDQUFDO1lBQUMsT0FBTyxDQUFVLEVBQUUsQ0FBQztnQkFDcEIsTUFBTSxJQUFJLGFBQWEsQ0FBQyxDQUFVLENBQUMsQ0FBQztZQUN0QyxDQUFDO1FBQ0gsQ0FBQztRQUVELGtCQUFrQjthQUNmLElBQUksQ0FBQyxJQUFJLENBQUM7YUFDVixJQUFJLENBQUMsR0FBRyxFQUFFO1lBQ1QsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMscUNBQXFDLENBQUMsQ0FBQztRQUN2RCxDQUFDLENBQUM7YUFDRCxLQUFLLENBQUMsQ0FBQyxDQUFVLEVBQUUsRUFBRTtZQUNwQixNQUFNLElBQUksYUFBYSxDQUNyQixpREFBaUQsQ0FBQyxFQUFFLENBQ3JELENBQUM7UUFDSixDQUFDLENBQUMsQ0FBQztJQUNQLENBQUM7SUFFRDs7T0FFRztJQUNJLE9BQU87UUFDWixzQkFBc0I7UUFDdEIsRUFBRTtRQUNGLG9EQUFvRDtRQUNwRCx3Q0FBd0M7UUFDeEMsSUFBSTtJQUNOLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IERpc3BhdGNoLCBFdmVudElkcyB9IGZyb20gXCJAZGVjYWYtdHMvY29yZVwiO1xuaW1wb3J0IHsgSW50ZXJuYWxFcnJvciwgT3BlcmF0aW9uS2V5cyB9IGZyb20gXCJAZGVjYWYtdHMvZGItZGVjb3JhdG9yc1wiO1xuaW1wb3J0IHsgRGF0YVNvdXJjZU9wdGlvbnMgfSBmcm9tIFwidHlwZW9ybS9kYXRhLXNvdXJjZS9EYXRhU291cmNlT3B0aW9uc1wiO1xuaW1wb3J0IHsgVHlwZU9STUFkYXB0ZXIgfSBmcm9tIFwiLi9UeXBlT1JNQWRhcHRlclwiO1xuaW1wb3J0IHsgVHlwZU9STUV2ZW50U3Vic2NyaWJlciB9IGZyb20gXCIuL1R5cGVPUk1FdmVudFN1YnNjcmliZXJcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gRGlzcGF0Y2hlciBmb3IgVHlwZU9STS1kcml2ZW4gY2hhbmdlIGV2ZW50cy5cbiAqIEBzdW1tYXJ5IFN1YnNjcmliZXMgYSBUeXBlT1JNIERhdGFTb3VyY2Ugd2l0aCBhIGN1c3RvbSBFbnRpdHlTdWJzY3JpYmVyIHRvIG5vdGlmeSBvYnNlcnZlcnMgd2hlbiByZWNvcmRzIGFyZSBjcmVhdGVkLCB1cGRhdGVkLCBvciBkZWxldGVkLlxuICogQHBhcmFtIHtudW1iZXJ9IFt0aW1lb3V0PTUwMDBdIFRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzIGZvciBpbml0aWFsaXphdGlvbiByZXRyaWVzLlxuICogQGNsYXNzIFR5cGVPUk1EaXNwYXRjaFxuICogQGV4YW1wbGVcbiAqIC8vIENyZWF0ZSBhIGRpc3BhdGNoZXIgZm9yIGEgVHlwZU9STSBEYXRhU291cmNlXG4gKiBjb25zdCBkaXNwYXRjaCA9IG5ldyBUeXBlT1JNRGlzcGF0Y2goKTtcbiAqIGF3YWl0IGRpc3BhdGNoLm9ic2VydmUoYWRhcHRlciwgYWRhcHRlci5kYXRhU291cmNlLm9wdGlvbnMpO1xuICpcbiAqIC8vIFRoZSBkaXNwYXRjaGVyIHJlZ2lzdGVycyBhIFR5cGVPUk1FdmVudFN1YnNjcmliZXIgYW5kIG5vdGlmaWVzIG9ic2VydmVycyB3aGVuIGVudGl0aWVzIGNoYW5nZS5cbiAqIEBtZXJtYWlkXG4gKiBjbGFzc0RpYWdyYW1cbiAqICAgY2xhc3MgRGlzcGF0Y2gge1xuICogICAgICtpbml0aWFsaXplKClcbiAqICAgICArdXBkYXRlT2JzZXJ2ZXJzKClcbiAqICAgfVxuICogICBjbGFzcyBUeXBlT1JNRGlzcGF0Y2gge1xuICogICAgIC1vYnNlcnZlckxhc3RVcGRhdGU/OiBzdHJpbmdcbiAqICAgICAtYXR0ZW1wdENvdW50ZXI6IG51bWJlclxuICogICAgIC10aW1lb3V0OiBudW1iZXJcbiAqICAgICArY29uc3RydWN0b3IodGltZW91dClcbiAqICAgICAjbm90aWZpY2F0aW9uSGFuZGxlcigpXG4gKiAgICAgI2luaXRpYWxpemUoKVxuICogICB9XG4gKiAgIERpc3BhdGNoIDx8LS0gVHlwZU9STURpc3BhdGNoXG4gKi9cbmV4cG9ydCBjbGFzcyBUeXBlT1JNRGlzcGF0Y2ggZXh0ZW5kcyBEaXNwYXRjaDxEYXRhU291cmNlT3B0aW9ucz4ge1xuICBwcml2YXRlIG9ic2VydmVyTGFzdFVwZGF0ZT86IHN0cmluZztcbiAgcHJpdmF0ZSBhdHRlbXB0Q291bnRlcjogbnVtYmVyID0gMDtcblxuICBjb25zdHJ1Y3Rvcihwcml2YXRlIHRpbWVvdXQgPSA1MDAwKSB7XG4gICAgc3VwZXIoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gUHJvY2Vzc2VzIFR5cGVPUk0gbm90aWZpY2F0aW9uIGV2ZW50cy5cbiAgICogQHN1bW1hcnkgSGFuZGxlcyBjaGFuZ2Ugbm90aWZpY2F0aW9ucyAodHJhbnNsYXRlZCBmcm9tIFR5cGVPUk0gZXZlbnRzKSBhbmQgbm90aWZpZXMgb2JzZXJ2ZXJzIGFib3V0IHJlY29yZCBjaGFuZ2VzLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gdGFibGUgVGhlIG5vdGlmaWNhdGlvbiBwYXlsb2FkLlxuICAgKiBAcGFyYW0ge09wZXJhdGlvbktleXN9IG9wZXJhdGlvbiBUaGUgbm90aWZpY2F0aW9uIHBheWxvYWQuXG4gICAqIEBwYXJhbSB7RXZlbnRJZHN9IGlkcyBUaGUgbm90aWZpY2F0aW9uIHBheWxvYWQuXG4gICAqIEByZXR1cm4ge1Byb21pc2U8dm9pZD59IEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHdoZW4gYWxsIG5vdGlmaWNhdGlvbnMgaGF2ZSBiZWVuIHByb2Nlc3NlZC5cbiAgICogQG1lcm1haWRcbiAgICogc2VxdWVuY2VEaWFncmFtXG4gICAqICAgcGFydGljaXBhbnQgRCBhcyBQb3N0Z3JlU1FMRGlzcGF0Y2hcbiAgICogICBwYXJ0aWNpcGFudCBMIGFzIExvZ2dlclxuICAgKiAgIHBhcnRpY2lwYW50IE8gYXMgT2JzZXJ2ZXJzXG4gICAqICAgTm90ZSBvdmVyIEQ6IFJlY2VpdmUgbm90aWZpY2F0aW9uIGZyb20gUG9zdGdyZVNRTFxuICAgKiAgIEQtPj5EOiBQYXJzZSBub3RpZmljYXRpb24gcGF5bG9hZFxuICAgKiAgIEQtPj5EOiBFeHRyYWN0IHRhYmxlLCBvcGVyYXRpb24sIGFuZCBpZHNcbiAgICogICBELT4+TzogdXBkYXRlT2JzZXJ2ZXJzKHRhYmxlLCBvcGVyYXRpb24sIGlkcylcbiAgICogICBELT4+RDogVXBkYXRlIG9ic2VydmVyTGFzdFVwZGF0ZVxuICAgKiAgIEQtPj5MOiBMb2cgc3VjY2Vzc2Z1bCBkaXNwYXRjaFxuICAgKi9cbiAgcHJvdGVjdGVkIGFzeW5jIG5vdGlmaWNhdGlvbkhhbmRsZXIoXG4gICAgdGFibGU6IHN0cmluZyxcbiAgICBvcGVyYXRpb246IE9wZXJhdGlvbktleXMsXG4gICAgaWRzOiBFdmVudElkc1xuICApOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBjb25zdCBsb2cgPSB0aGlzLmxvZy5mb3IodGhpcy5ub3RpZmljYXRpb25IYW5kbGVyKTtcbiAgICB0cnkge1xuICAgICAgLy8gTm90aWZ5IG9ic2VydmVyc1xuICAgICAgYXdhaXQgdGhpcy51cGRhdGVPYnNlcnZlcnModGFibGUsIG9wZXJhdGlvbiwgaWRzKTtcbiAgICAgIHRoaXMub2JzZXJ2ZXJMYXN0VXBkYXRlID0gbmV3IERhdGUoKS50b0lTT1N0cmluZygpO1xuICAgICAgbG9nLnZlcmJvc2UoYE9ic2VydmVyIHJlZnJlc2ggZGlzcGF0Y2hlZCBieSAke29wZXJhdGlvbn0gZm9yICR7dGFibGV9YCk7XG4gICAgICBsb2cuZGVidWcoYHBrczogJHtpZHN9YCk7XG4gICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgbG9nLmVycm9yKGBGYWlsZWQgdG8gcHJvY2VzcyBub3RpZmljYXRpb246ICR7ZX1gKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEluaXRpYWxpemVzIHRoZSBkaXNwYXRjaGVyIGFuZCBzdWJzY3JpYmVzIHRvIFR5cGVPUk0gbm90aWZpY2F0aW9ucy5cbiAgICogQHN1bW1hcnkgUmVnaXN0ZXJzIHRoZSBUeXBlT1JNRXZlbnRTdWJzY3JpYmVyIG9uIHRoZSBEYXRhU291cmNlIGFuZCBsb2dzIHRoZSBzdWJzY3JpcHRpb24gbGlmZWN5Y2xlLlxuICAgKiBAcmV0dXJuIHtQcm9taXNlPHZvaWQ+fSBBIHByb21pc2UgdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBzdWJzY3JpcHRpb24gaXMgZXN0YWJsaXNoZWQuXG4gICAqIEBtZXJtYWlkXG4gICAqIHNlcXVlbmNlRGlhZ3JhbVxuICAgKiAgIHBhcnRpY2lwYW50IEQgYXMgVHlwZU9STURpc3BhdGNoXG4gICAqICAgcGFydGljaXBhbnQgUyBhcyBzdWJzY3JpYmVUb1R5cGVPUk1cbiAgICogICBwYXJ0aWNpcGFudCBEUyBhcyBUeXBlT1JNIERhdGFTb3VyY2VcbiAgICogICBwYXJ0aWNpcGFudCBMIGFzIExvZ2dlclxuICAgKiAgIEQtPj5TOiBDYWxsIHN1YnNjcmliZVRvVHlwZU9STVxuICAgKiAgIFMtPj5TOiBDaGVjayBhZGFwdGVyIGFuZCBuYXRpdmVcbiAgICogICBhbHQgTm8gYWRhcHRlciBvciBuYXRpdmVcbiAgICogICAgIFMtLT4+UzogdGhyb3cgSW50ZXJuYWxFcnJvclxuICAgKiAgIGVuZFxuICAgKiAgIFMtPj5EUzogaW5pdGlhbGl6ZSgpXG4gICAqICAgUy0+PkRTOiBzdWJzY3JpYmVycy5wdXNoKFR5cGVPUk1FdmVudFN1YnNjcmliZXIpXG4gICAqICAgYWx0IFN1Y2Nlc3NcbiAgICogICAgIERTLS0+PlM6IFN1YnNjcmlwdGlvbiBlc3RhYmxpc2hlZFxuICAgKiAgICAgUy0tPj5EOiBQcm9taXNlIHJlc29sdmVzXG4gICAqICAgICBELT4+TDogTG9nIHN1Y2Nlc3NmdWwgc3Vic2NyaXB0aW9uXG4gICAqICAgZWxzZSBFcnJvclxuICAgKiAgICAgRFMtLT4+UzogRXJyb3JcbiAgICogICAgIFMtLT4+RDogUHJvbWlzZSByZWplY3RzXG4gICAqICAgZW5kXG4gICAqL1xuICBwcm90ZWN0ZWQgb3ZlcnJpZGUgYXN5bmMgaW5pdGlhbGl6ZSgpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBhc3luYyBmdW5jdGlvbiBzdWJzY3JpYmVUb1R5cGVPUk0odGhpczogVHlwZU9STURpc3BhdGNoKTogUHJvbWlzZTx2b2lkPiB7XG4gICAgICBpZiAoIXRoaXMuYWRhcHRlciB8fCAhdGhpcy5uYXRpdmUpIHtcbiAgICAgICAgdGhyb3cgbmV3IEludGVybmFsRXJyb3IoYE5vIGFkYXB0ZXIvbmF0aXZlIG9ic2VydmVkIGZvciBkaXNwYXRjaGApO1xuICAgICAgfVxuXG4gICAgICBjb25zdCBhZGFwdGVyID0gdGhpcy5hZGFwdGVyIGFzIFR5cGVPUk1BZGFwdGVyO1xuXG4gICAgICB0cnkge1xuICAgICAgICBpZiAoIWFkYXB0ZXIuZGF0YVNvdXJjZS5pc0luaXRpYWxpemVkKVxuICAgICAgICAgIGF3YWl0IGFkYXB0ZXIuZGF0YVNvdXJjZS5pbml0aWFsaXplKCk7XG5cbiAgICAgICAgYWRhcHRlci5kYXRhU291cmNlLnN1YnNjcmliZXJzLnB1c2goXG4gICAgICAgICAgbmV3IFR5cGVPUk1FdmVudFN1YnNjcmliZXIodGhpcy5ub3RpZmljYXRpb25IYW5kbGVyLmJpbmQodGhpcykpXG4gICAgICAgICk7XG4gICAgICB9IGNhdGNoIChlOiB1bmtub3duKSB7XG4gICAgICAgIHRocm93IG5ldyBJbnRlcm5hbEVycm9yKGUgYXMgRXJyb3IpO1xuICAgICAgfVxuICAgIH1cblxuICAgIHN1YnNjcmliZVRvVHlwZU9STVxuICAgICAgLmNhbGwodGhpcylcbiAgICAgIC50aGVuKCgpID0+IHtcbiAgICAgICAgdGhpcy5sb2cuaW5mbyhgU3Vic2NyaWJlZCB0byBUeXBlT1JNIG5vdGlmaWNhdGlvbnNgKTtcbiAgICAgIH0pXG4gICAgICAuY2F0Y2goKGU6IHVua25vd24pID0+IHtcbiAgICAgICAgdGhyb3cgbmV3IEludGVybmFsRXJyb3IoXG4gICAgICAgICAgYEZhaWxlZCB0byBzdWJzY3JpYmUgdG8gVHlwZU9STSBub3RpZmljYXRpb25zOiAke2V9YFxuICAgICAgICApO1xuICAgICAgfSk7XG4gIH1cblxuICAvKipcbiAgICogQ2xlYW51cCBtZXRob2QgdG8gcmVsZWFzZSByZXNvdXJjZXMgd2hlbiB0aGUgZGlzcGF0Y2hlciBpcyBubyBsb25nZXIgbmVlZGVkXG4gICAqL1xuICBwdWJsaWMgY2xlYW51cCgpOiB2b2lkIHtcbiAgICAvLyBpZiAodGhpcy5hZGFwdGVyKSB7XG4gICAgLy9cbiAgICAvLyAgIGNvbnN0IGFkYXB0ZXIgPSB0aGlzLmFkYXB0ZXIgYXMgVHlwZU9STUFkYXB0ZXI7XG4gICAgLy8gICBhd2FpdCBhZGFwdGVyLmRhdGFTb3VyY2UuZGVzdHJveSgpO1xuICAgIC8vIH1cbiAgfVxufVxuIl19

package/lib/esm/TypeORMEventSubscriber.d.ts

@@ -0,0 +1,56 @@
+import { EntitySubscriberInterface, InsertEvent, RemoveEvent, UpdateEvent } from "typeorm";
+import { EventIds } from "@decaf-ts/core";
+import { OperationKeys } from "@decaf-ts/db-decorators";
+/**
+ * @description TypeORM event subscriber that forwards entity lifecycle events to the adapter.
+ * @summary Listens for insert, update, and remove events emitted by TypeORM and notifies the Decaf.ts adapter so that observers can be updated accordingly.
+ * @param {TypeORMAdapter} adapter The TypeORM adapter used to propagate events and look up metadata.
+ * @class
+ * @example
+ * // Registering the subscriber when creating a DataSource
+ * // dataSourceOptions.subscribers = [new TypeORMEventSubscriber(adapter)];
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant TypeORM
+ *   participant Subscriber as TypeORMEventSubscriber
+ *   participant Adapter as TypeORMAdapter
+ *   participant Observers
+ *
+ *   TypeORM->>Subscriber: afterInsert(entity)
+ *   Subscriber->>Adapter: updateObservers(table, CREATE, [id])
+ *   Adapter->>Observers: notify(table, CREATE, [id])
+ *
+ *   TypeORM->>Subscriber: afterUpdate(event)
+ *   Subscriber->>Adapter: updateObservers(table, UPDATE, [id])
+ *   Adapter->>Observers: notify(table, UPDATE, [id])
+ *
+ *   TypeORM->>Subscriber: afterRemove(event)
+ *   Subscriber->>Adapter: updateObservers(table, DELETE, [id])
+ *   Adapter->>Observers: notify(table, DELETE, [id])
+ */
+export declare class TypeORMEventSubscriber implements EntitySubscriberInterface {
+    protected readonly handler: (tableName: string, operation: OperationKeys, ids: EventIds) => void;
+    constructor(handler: (tableName: string, operation: OperationKeys, ids: EventIds) => void);
+    /**
+     * @description Handles post-insert events.
+     * @summary Notifies observers about a create operation for the inserted entity.
+     * @param {InsertEvent<any>} event The TypeORM insert event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterInsert(event: InsertEvent<any>): Promise<any> | void;
+    /**
+     * @description Handles post-remove events.
+     * @summary Notifies observers about a delete operation for the removed entity.
+     * @param {RemoveEvent<any>} event The TypeORM remove event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterRemove(event: RemoveEvent<any>): Promise<any> | void;
+    /**
+     * @description Handles post-update events.
+     * @summary Notifies observers about an update operation for the modified entity.
+     * @param {UpdateEvent<any>} event The TypeORM update event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterUpdate(event: UpdateEvent<any>): Promise<any> | void;
+}

package/lib/esm/TypeORMEventSubscriber.js

@@ -0,0 +1,93 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { EventSubscriber, } from "typeorm";
+import { Repository } from "@decaf-ts/core";
+import { InternalError, OperationKeys } from "@decaf-ts/db-decorators";
+import { Model } from "@decaf-ts/decorator-validation";
+/**
+ * @description TypeORM event subscriber that forwards entity lifecycle events to the adapter.
+ * @summary Listens for insert, update, and remove events emitted by TypeORM and notifies the Decaf.ts adapter so that observers can be updated accordingly.
+ * @param {TypeORMAdapter} adapter The TypeORM adapter used to propagate events and look up metadata.
+ * @class
+ * @example
+ * // Registering the subscriber when creating a DataSource
+ * // dataSourceOptions.subscribers = [new TypeORMEventSubscriber(adapter)];
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant TypeORM
+ *   participant Subscriber as TypeORMEventSubscriber
+ *   participant Adapter as TypeORMAdapter
+ *   participant Observers
+ *
+ *   TypeORM->>Subscriber: afterInsert(entity)
+ *   Subscriber->>Adapter: updateObservers(table, CREATE, [id])
+ *   Adapter->>Observers: notify(table, CREATE, [id])
+ *
+ *   TypeORM->>Subscriber: afterUpdate(event)
+ *   Subscriber->>Adapter: updateObservers(table, UPDATE, [id])
+ *   Adapter->>Observers: notify(table, UPDATE, [id])
+ *
+ *   TypeORM->>Subscriber: afterRemove(event)
+ *   Subscriber->>Adapter: updateObservers(table, DELETE, [id])
+ *   Adapter->>Observers: notify(table, DELETE, [id])
+ */
+let TypeORMEventSubscriber = class TypeORMEventSubscriber {
+    constructor(handler) {
+        this.handler = handler;
+    }
+    /**
+     * @description Handles post-insert events.
+     * @summary Notifies observers about a create operation for the inserted entity.
+     * @param {InsertEvent<any>} event The TypeORM insert event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterInsert(event) {
+        const constructor = Model.get(event.entity.constructor.name);
+        if (!constructor)
+            throw new InternalError(`No registered model found for ${event.entity.constructor.name}`);
+        const tableName = Repository.table(constructor);
+        this.handler(tableName, OperationKeys.CREATE, [event.entityId]);
+    }
+    /**
+     * @description Handles post-remove events.
+     * @summary Notifies observers about a delete operation for the removed entity.
+     * @param {RemoveEvent<any>} event The TypeORM remove event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterRemove(event) {
+        const constructor = Model.get(event.entity.constructor.name);
+        if (!constructor)
+            throw new InternalError(`No registered model found for ${event.entity.constructor.name}`);
+        const tableName = Repository.table(constructor);
+        this.handler(tableName, OperationKeys.DELETE, [event.entityId]);
+    }
+    /**
+     * @description Handles post-update events.
+     * @summary Notifies observers about an update operation for the modified entity.
+     * @param {UpdateEvent<any>} event The TypeORM update event.
+     * @return {Promise<any>|void} A promise when async or void otherwise.
+     */
+    afterUpdate(event) {
+        const constructor = Model.get(event.databaseEntity.constructor.name);
+        if (!constructor)
+            throw new InternalError(`No registered model found for ${event.databaseEntity.constructor.name}`);
+        const tableName = Repository.table(constructor);
+        return this.handler(tableName, OperationKeys.UPDATE, [
+            event.entity["id"],
+        ]);
+    }
+};
+TypeORMEventSubscriber = __decorate([
+    EventSubscriber(),
+    __metadata("design:paramtypes", [Function])
+], TypeORMEventSubscriber);
+export { TypeORMEventSubscriber };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVHlwZU9STUV2ZW50U3Vic2NyaWJlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9UeXBlT1JNRXZlbnRTdWJzY3JpYmVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLE9BQU8sRUFFTCxlQUFlLEdBSWhCLE1BQU0sU0FBUyxDQUFDO0FBQ2pCLE9BQU8sRUFBWSxVQUFVLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUN0RCxPQUFPLEVBQUUsYUFBYSxFQUFFLGFBQWEsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUV2RDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBMkJHO0FBRUksSUFBTSxzQkFBc0IsR0FBNUIsTUFBTSxzQkFBc0I7SUFDakMsWUFDcUIsT0FJVjtRQUpVLFlBQU8sR0FBUCxPQUFPLENBSWpCO0lBQ1IsQ0FBQztJQUVKOzs7OztPQUtHO0lBQ0gsV0FBVyxDQUFDLEtBQXVCO1FBQ2pDLE1BQU0sV0FBVyxHQUFHLEtBQUssQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDN0QsSUFBSSxDQUFDLFdBQVc7WUFDZCxNQUFNLElBQUksYUFBYSxDQUNyQixpQ0FBaUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxXQUFXLENBQUMsSUFBSSxFQUFFLENBQ2pFLENBQUM7UUFDSixNQUFNLFNBQVMsR0FBRyxVQUFVLENBQUMsS0FBSyxDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBRWhELElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLGFBQWEsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxLQUFLLENBQUMsUUFBZSxDQUFDLENBQUMsQ0FBQztJQUN6RSxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxXQUFXLENBQUMsS0FBdUI7UUFDakMsTUFBTSxXQUFXLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUM3RCxJQUFJLENBQUMsV0FBVztZQUNkLE1BQU0sSUFBSSxhQUFhLENBQ3JCLGlDQUFpQyxLQUFLLENBQUMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsQ0FDakUsQ0FBQztRQUNKLE1BQU0sU0FBUyxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDLENBQUM7UUFFaEQsSUFBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsYUFBYSxDQUFDLE1BQU0sRUFBRSxDQUFDLEtBQUssQ0FBQyxRQUFlLENBQUMsQ0FBQyxDQUFDO0lBQ3pFLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILFdBQVcsQ0FBQyxLQUF1QjtRQUNqQyxNQUFNLFdBQVcsR0FBRyxLQUFLLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ3JFLElBQUksQ0FBQyxXQUFXO1lBQ2QsTUFBTSxJQUFJLGFBQWEsQ0FDckIsaUNBQWlDLEtBQUssQ0FBQyxjQUFjLENBQUMsV0FBVyxDQUFDLElBQUksRUFBRSxDQUN6RSxDQUFDO1FBQ0osTUFBTSxTQUFTLEdBQUcsVUFBVSxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUVoRCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLGFBQWEsQ0FBQyxNQUFNLEVBQUU7WUFDbEQsS0FBSyxDQUFDLE1BQWMsQ0FBQyxJQUFJLENBQVE7U0FDbkMsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztDQUNGLENBQUE7QUE3RFksc0JBQXNCO0lBRGxDLGVBQWUsRUFBRTs7R0FDTCxzQkFBc0IsQ0E2RGxDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgRW50aXR5U3Vic2NyaWJlckludGVyZmFjZSxcbiAgRXZlbnRTdWJzY3JpYmVyLFxuICBJbnNlcnRFdmVudCxcbiAgUmVtb3ZlRXZlbnQsXG4gIFVwZGF0ZUV2ZW50LFxufSBmcm9tIFwidHlwZW9ybVwiO1xuaW1wb3J0IHsgRXZlbnRJZHMsIFJlcG9zaXRvcnkgfSBmcm9tIFwiQGRlY2FmLXRzL2NvcmVcIjtcbmltcG9ydCB7IEludGVybmFsRXJyb3IsIE9wZXJhdGlvbktleXMgfSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcbmltcG9ydCB7IE1vZGVsIH0gZnJvbSBcIkBkZWNhZi10cy9kZWNvcmF0b3ItdmFsaWRhdGlvblwiO1xuXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBUeXBlT1JNIGV2ZW50IHN1YnNjcmliZXIgdGhhdCBmb3J3YXJkcyBlbnRpdHkgbGlmZWN5Y2xlIGV2ZW50cyB0byB0aGUgYWRhcHRlci5cbiAqIEBzdW1tYXJ5IExpc3RlbnMgZm9yIGluc2VydCwgdXBkYXRlLCBhbmQgcmVtb3ZlIGV2ZW50cyBlbWl0dGVkIGJ5IFR5cGVPUk0gYW5kIG5vdGlmaWVzIHRoZSBEZWNhZi50cyBhZGFwdGVyIHNvIHRoYXQgb2JzZXJ2ZXJzIGNhbiBiZSB1cGRhdGVkIGFjY29yZGluZ2x5LlxuICogQHBhcmFtIHtUeXBlT1JNQWRhcHRlcn0gYWRhcHRlciBUaGUgVHlwZU9STSBhZGFwdGVyIHVzZWQgdG8gcHJvcGFnYXRlIGV2ZW50cyBhbmQgbG9vayB1cCBtZXRhZGF0YS5cbiAqIEBjbGFzc1xuICogQGV4YW1wbGVcbiAqIC8vIFJlZ2lzdGVyaW5nIHRoZSBzdWJzY3JpYmVyIHdoZW4gY3JlYXRpbmcgYSBEYXRhU291cmNlXG4gKiAvLyBkYXRhU291cmNlT3B0aW9ucy5zdWJzY3JpYmVycyA9IFtuZXcgVHlwZU9STUV2ZW50U3Vic2NyaWJlcihhZGFwdGVyKV07XG4gKlxuICogQG1lcm1haWRcbiAqIHNlcXVlbmNlRGlhZ3JhbVxuICogICBwYXJ0aWNpcGFudCBUeXBlT1JNXG4gKiAgIHBhcnRpY2lwYW50IFN1YnNjcmliZXIgYXMgVHlwZU9STUV2ZW50U3Vic2NyaWJlclxuICogICBwYXJ0aWNpcGFudCBBZGFwdGVyIGFzIFR5cGVPUk1BZGFwdGVyXG4gKiAgIHBhcnRpY2lwYW50IE9ic2VydmVyc1xuICpcbiAqICAgVHlwZU9STS0+PlN1YnNjcmliZXI6IGFmdGVySW5zZXJ0KGVudGl0eSlcbiAqICAgU3Vic2NyaWJlci0+PkFkYXB0ZXI6IHVwZGF0ZU9ic2VydmVycyh0YWJsZSwgQ1JFQVRFLCBbaWRdKVxuICogICBBZGFwdGVyLT4+T2JzZXJ2ZXJzOiBub3RpZnkodGFibGUsIENSRUFURSwgW2lkXSlcbiAqXG4gKiAgIFR5cGVPUk0tPj5TdWJzY3JpYmVyOiBhZnRlclVwZGF0ZShldmVudClcbiAqICAgU3Vic2NyaWJlci0+PkFkYXB0ZXI6IHVwZGF0ZU9ic2VydmVycyh0YWJsZSwgVVBEQVRFLCBbaWRdKVxuICogICBBZGFwdGVyLT4+T2JzZXJ2ZXJzOiBub3RpZnkodGFibGUsIFVQREFURSwgW2lkXSlcbiAqXG4gKiAgIFR5cGVPUk0tPj5TdWJzY3JpYmVyOiBhZnRlclJlbW92ZShldmVudClcbiAqICAgU3Vic2NyaWJlci0+PkFkYXB0ZXI6IHVwZGF0ZU9ic2VydmVycyh0YWJsZSwgREVMRVRFLCBbaWRdKVxuICogICBBZGFwdGVyLT4+T2JzZXJ2ZXJzOiBub3RpZnkodGFibGUsIERFTEVURSwgW2lkXSlcbiAqL1xuQEV2ZW50U3Vic2NyaWJlcigpXG5leHBvcnQgY2xhc3MgVHlwZU9STUV2ZW50U3Vic2NyaWJlciBpbXBsZW1lbnRzIEVudGl0eVN1YnNjcmliZXJJbnRlcmZhY2Uge1xuICBjb25zdHJ1Y3RvcihcbiAgICBwcm90ZWN0ZWQgcmVhZG9ubHkgaGFuZGxlcjogKFxuICAgICAgdGFibGVOYW1lOiBzdHJpbmcsXG4gICAgICBvcGVyYXRpb246IE9wZXJhdGlvbktleXMsXG4gICAgICBpZHM6IEV2ZW50SWRzXG4gICAgKSA9PiB2b2lkXG4gICkge31cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEhhbmRsZXMgcG9zdC1pbnNlcnQgZXZlbnRzLlxuICAgKiBAc3VtbWFyeSBOb3RpZmllcyBvYnNlcnZlcnMgYWJvdXQgYSBjcmVhdGUgb3BlcmF0aW9uIGZvciB0aGUgaW5zZXJ0ZWQgZW50aXR5LlxuICAgKiBAcGFyYW0ge0luc2VydEV2ZW50PGFueT59IGV2ZW50IFRoZSBUeXBlT1JNIGluc2VydCBldmVudC5cbiAgICogQHJldHVybiB7UHJvbWlzZTxhbnk+fHZvaWR9IEEgcHJvbWlzZSB3aGVuIGFzeW5jIG9yIHZvaWQgb3RoZXJ3aXNlLlxuICAgKi9cbiAgYWZ0ZXJJbnNlcnQoZXZlbnQ6IEluc2VydEV2ZW50PGFueT4pOiBQcm9taXNlPGFueT4gfCB2b2lkIHtcbiAgICBjb25zdCBjb25zdHJ1Y3RvciA9IE1vZGVsLmdldChldmVudC5lbnRpdHkuY29uc3RydWN0b3IubmFtZSk7XG4gICAgaWYgKCFjb25zdHJ1Y3RvcilcbiAgICAgIHRocm93IG5ldyBJbnRlcm5hbEVycm9yKFxuICAgICAgICBgTm8gcmVnaXN0ZXJlZCBtb2RlbCBmb3VuZCBmb3IgJHtldmVudC5lbnRpdHkuY29uc3RydWN0b3IubmFtZX1gXG4gICAgICApO1xuICAgIGNvbnN0IHRhYmxlTmFtZSA9IFJlcG9zaXRvcnkudGFibGUoY29uc3RydWN0b3IpO1xuXG4gICAgdGhpcy5oYW5kbGVyKHRhYmxlTmFtZSwgT3BlcmF0aW9uS2V5cy5DUkVBVEUsIFtldmVudC5lbnRpdHlJZCBhcyBhbnldKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gSGFuZGxlcyBwb3N0LXJlbW92ZSBldmVudHMuXG4gICAqIEBzdW1tYXJ5IE5vdGlmaWVzIG9ic2VydmVycyBhYm91dCBhIGRlbGV0ZSBvcGVyYXRpb24gZm9yIHRoZSByZW1vdmVkIGVudGl0eS5cbiAgICogQHBhcmFtIHtSZW1vdmVFdmVudDxhbnk+fSBldmVudCBUaGUgVHlwZU9STSByZW1vdmUgZXZlbnQuXG4gICAqIEByZXR1cm4ge1Byb21pc2U8YW55Pnx2b2lkfSBBIHByb21pc2Ugd2hlbiBhc3luYyBvciB2b2lkIG90aGVyd2lzZS5cbiAgICovXG4gIGFmdGVyUmVtb3ZlKGV2ZW50OiBSZW1vdmVFdmVudDxhbnk+KTogUHJvbWlzZTxhbnk+IHwgdm9pZCB7XG4gICAgY29uc3QgY29uc3RydWN0b3IgPSBNb2RlbC5nZXQoZXZlbnQuZW50aXR5LmNvbnN0cnVjdG9yLm5hbWUpO1xuICAgIGlmICghY29uc3RydWN0b3IpXG4gICAgICB0aHJvdyBuZXcgSW50ZXJuYWxFcnJvcihcbiAgICAgICAgYE5vIHJlZ2lzdGVyZWQgbW9kZWwgZm91bmQgZm9yICR7ZXZlbnQuZW50aXR5LmNvbnN0cnVjdG9yLm5hbWV9YFxuICAgICAgKTtcbiAgICBjb25zdCB0YWJsZU5hbWUgPSBSZXBvc2l0b3J5LnRhYmxlKGNvbnN0cnVjdG9yKTtcblxuICAgIHRoaXMuaGFuZGxlcih0YWJsZU5hbWUsIE9wZXJhdGlvbktleXMuREVMRVRFLCBbZXZlbnQuZW50aXR5SWQgYXMgYW55XSk7XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIEhhbmRsZXMgcG9zdC11cGRhdGUgZXZlbnRzLlxuICAgKiBAc3VtbWFyeSBOb3RpZmllcyBvYnNlcnZlcnMgYWJvdXQgYW4gdXBkYXRlIG9wZXJhdGlvbiBmb3IgdGhlIG1vZGlmaWVkIGVudGl0eS5cbiAgICogQHBhcmFtIHtVcGRhdGVFdmVudDxhbnk+fSBldmVudCBUaGUgVHlwZU9STSB1cGRhdGUgZXZlbnQuXG4gICAqIEByZXR1cm4ge1Byb21pc2U8YW55Pnx2b2lkfSBBIHByb21pc2Ugd2hlbiBhc3luYyBvciB2b2lkIG90aGVyd2lzZS5cbiAgICovXG4gIGFmdGVyVXBkYXRlKGV2ZW50OiBVcGRhdGVFdmVudDxhbnk+KTogUHJvbWlzZTxhbnk+IHwgdm9pZCB7XG4gICAgY29uc3QgY29uc3RydWN0b3IgPSBNb2RlbC5nZXQoZXZlbnQuZGF0YWJhc2VFbnRpdHkuY29uc3RydWN0b3IubmFtZSk7XG4gICAgaWYgKCFjb25zdHJ1Y3RvcilcbiAgICAgIHRocm93IG5ldyBJbnRlcm5hbEVycm9yKFxuICAgICAgICBgTm8gcmVnaXN0ZXJlZCBtb2RlbCBmb3VuZCBmb3IgJHtldmVudC5kYXRhYmFzZUVudGl0eS5jb25zdHJ1Y3Rvci5uYW1lfWBcbiAgICAgICk7XG4gICAgY29uc3QgdGFibGVOYW1lID0gUmVwb3NpdG9yeS50YWJsZShjb25zdHJ1Y3Rvcik7XG5cbiAgICByZXR1cm4gdGhpcy5oYW5kbGVyKHRhYmxlTmFtZSwgT3BlcmF0aW9uS2V5cy5VUERBVEUsIFtcbiAgICAgIChldmVudC5lbnRpdHkgYXMgYW55KVtcImlkXCJdIGFzIGFueSxcbiAgICBdKTtcbiAgfVxufVxuIl19

package/lib/esm/TypeORMRepository.d.ts

@@ -0,0 +1,125 @@
+import { type Constructor, Model } from "@decaf-ts/decorator-validation";
+import { Repository } from "@decaf-ts/core";
+import { Context } from "@decaf-ts/db-decorators";
+import { TypeORMFlags, TypeORMQuery } from "./types";
+import { TypeORMAdapter } from "./TypeORMAdapter";
+/**
+ * @description Repository implementation backed by TypeORM.
+ * @summary Provides CRUD operations for a given Model using the {@link TypeORMAdapter}, including bulk operations and query builder access while preserving Decaf.ts repository semantics.
+ * @template M Type extending Model that this repository will manage.
+ * @param {TypeORMAdapter} adapter The adapter used to execute persistence operations.
+ * @param {Constructor<M>} model The Model constructor associated with this repository.
+ * @param {...any[]} args Optional arguments forwarded to the base Repository.
+ * @class TypeORMRepository
+ * @example
+ * // Creating a repository
+ * const repo = new TypeORMRepository<User>(adapter, User);
+ * const created = await repo.create(new User({ name: "Alice" }));
+ * const read = await repo.read(created.id);
+ *
+ * // Bulk create
+ * await repo.createAll([new User({ name: "A" }), new User({ name: "B" })]);
+ *
+ * // Using the query builder
+ * const qb = repo.queryBuilder();
+ * const rows = await qb.where("name = :name", { name: "Alice" }).getMany();
+ *
+ * @mermaid
+ * sequenceDiagram
+ *   participant App
+ *   participant Repo as TypeORMRepository
+ *   participant Adapter as TypeORMAdapter
+ *   participant DB as TypeORM/DataSource
+ *
+ *   App->>Repo: create(model)
+ *   Repo->>Adapter: prepare(model, pk)
+ *   Adapter-->>Repo: { record, id, transient }
+ *   Repo->>Adapter: create(table, id, model, ...args)
+ *   Adapter->>DB: INSERT ...
+ *   DB-->>Adapter: row
+ *   Adapter-->>Repo: row
+ *   Repo->>Adapter: revert(row, clazz, pk, id)
+ *   Adapter-->>Repo: model
+ *   Repo-->>App: model
+ */
+export declare class TypeORMRepository<M extends Model> extends Repository<M, TypeORMQuery<M, any>, TypeORMAdapter, TypeORMFlags, Context<TypeORMFlags>> {
+    constructor(adapter: TypeORMAdapter, model: Constructor<M>, ...args: any[]);
+    /**
+     * @description Creates a TypeORM query builder for the repository entity.
+     * @summary Returns a SelectQueryBuilder bound to this repository's entity for advanced querying.
+     * @return {import("typeorm").SelectQueryBuilder<any>} A TypeORM SelectQueryBuilder instance.
+     */
+    queryBuilder(): import("typeorm").SelectQueryBuilder<import("typeorm").ObjectLiteral>;
+    /**
+     * @description Creates and persists a model instance.
+     * @summary Prepares the model, delegates insertion to the adapter, and rehydrates the persisted state back into a Model instance.
+     * @param {M} model The model to create.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M>} The created model instance.
+     */
+    create(model: M, ...args: any[]): Promise<M>;
+    /**
+     * @description Reads a model from the database by ID.
+     * @summary Retrieves a model instance from the database using its primary key.
+     * @param {string|number|bigint} id - The primary key of the model to read.
+     * @param {...any[]} args - Additional arguments.
+     * @return {Promise<M>} The retrieved model instance.
+     */
+    read(id: string | number | bigint, ...args: any[]): Promise<M>;
+    /**
+     * @description Updates and persists a model instance.
+     * @summary Prepares the model, delegates update to the adapter, and rehydrates the persisted state back into a Model instance.
+     * @param {M} model The model to update.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M>} The updated model instance.
+     */
+    update(model: M, ...args: any[]): Promise<M>;
+    /**
+     * @description Deletes a model from the database by ID.
+     * @summary Removes a model instance from the database using its primary key.
+     * @param {string|number|bigint} id - The primary key of the model to delete.
+     * @param {...any[]} args - Additional arguments.
+     * @return {Promise<M>} The deleted model instance.
+     */
+    delete(id: string | number | bigint, ...args: any[]): Promise<M>;
+    /**
+     * @description Validates and prepares models for bulk creation.
+     * @summary Applies decorator-based validations and returns transformed models with context args for createAll.
+     * @param {M[]} models The models to be created.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<[M[], ...any[]]>} The prepared models and forwarded args tuple.
+     */
+    protected createAllPrefix(models: M[], ...args: any[]): Promise<any[]>;
+    /**
+     * @description Creates multiple models at once.
+     * @summary Prepares, persists, and rehydrates a batch of models.
+     * @param {M[]} models The models to create.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M[]>} The created models.
+     */
+    createAll(models: M[], ...args: any[]): Promise<M[]>;
+    /**
+     * @description Reads multiple models by their primary keys.
+     * @summary Retrieves a list of models corresponding to the provided keys.
+     * @param {(string[]|number[])} keys The primary keys to read.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M[]>} The retrieved models.
+     */
+    readAll(keys: string[] | number[], ...args: any[]): Promise<M[]>;
+    /**
+     * @description Updates multiple models at once.
+     * @summary Persists a batch of model updates and returns their rehydrated instances.
+     * @param {M[]} models The models to update.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M[]>} The updated models.
+     */
+    updateAll(models: M[], ...args: any[]): Promise<M[]>;
+    /**
+     * @description Deletes multiple models at once.
+     * @summary Removes a list of models by their primary keys and returns their last persisted states.
+     * @param {(string[]|number[])} keys The primary keys to delete.
+     * @param {...any[]} args Optional arguments/context.
+     * @return {Promise<M[]>} The deleted models.
+     */
+    deleteAll(keys: string[] | number[], ...args: any[]): Promise<M[]>;
+}