@ikonintegration/ikapi 4.0.0-alpha8 → 5.0.0-alpha1

package/dist/src/Database/DatabaseManager.d.ts

@@ -0,0 +1,47 @@
+import { DynamoDatabase } from './integrations/dynamo/DynamoDatabase.js';
+import { KyselyDatabase } from './integrations/kysely/KyselyDatabase.js';
+import { PostgresDatabase } from './integrations/pgsql/PostgresDatabase.js';
+import type { DatabaseImplType, DatabaseType, DbConfig } from './types.js';
+/**
+ * Object containing different database implementations.
+ * @type {Object}
+ * @property {PostgresDatabase} pg - Postgres database implementation
+ * @property {KyselyDatabase<any>} kysely - Kysely database implementation
+ */
+export declare const DATABASES: {
+    pg: typeof PostgresDatabase;
+    kysely: typeof KyselyDatabase;
+    dynamo: typeof DynamoDatabase;
+};
+/**
+ * Manages the creation and storage of database instances.
+ */
+export declare class DatabaseManager {
+    /**
+     * Singleton instance of the DatabaseManager class.
+     * This instance is used to interact with the database.
+     */
+    static readonly INSTANCE: DatabaseManager;
+    /**
+     * A private property that holds a reference to the DATABASES constant.
+     * @type {typeof DATABASES}
+     */
+    private databases;
+    /**
+     * An object that stores instances of DatabaseImplType objects with keys of type string.
+     * @type {Object.<string, DatabaseImplType<any, any>>}
+     */
+    private instances;
+    /**
+     * Creates a database instance based on the provided configuration.
+     * @param {DbConfig<S>} config - The configuration object for the database.
+     * @returns {DatabaseImplType<S, DBSchema>} An instance of the database based on the configuration.
+     */
+    create<S extends DatabaseType, DBSchema>(config: DbConfig<S>): DatabaseImplType<S, DBSchema>;
+    /**
+     * Instantiates a database connection based on the provided configuration.
+     * @param {DbConfig<'pg'> | DbConfig<'kysely'>} config - The configuration object specifying the type of database.
+     * @returns {DatabaseImplType<S, DBSchema>} An instance of the specified database connection.
+     */
+    private instantiateDb;
+}

package/dist/src/Database/DatabaseManager.js

@@ -0,0 +1,60 @@
+import hash from 'object-hash';
+import { DynamoDatabase } from './integrations/dynamo/DynamoDatabase.js';
+import { KyselyDatabase } from './integrations/kysely/KyselyDatabase.js';
+import { PostgresDatabase } from './integrations/pgsql/PostgresDatabase.js';
+/**
+ * Object containing different database implementations.
+ * @type {Object}
+ * @property {PostgresDatabase} pg - Postgres database implementation
+ * @property {KyselyDatabase<any>} kysely - Kysely database implementation
+ */
+export const DATABASES = {
+    pg: PostgresDatabase,
+    kysely: KyselyDatabase,
+    dynamo: DynamoDatabase,
+};
+/**
+ * Manages the creation and storage of database instances.
+ */
+export class DatabaseManager {
+    constructor() {
+        /**
+         * A private property that holds a reference to the DATABASES constant.
+         * @type {typeof DATABASES}
+         */
+        this.databases = DATABASES;
+        /**
+         * An object that stores instances of DatabaseImplType objects with keys of type string.
+         * @type {Object.<string, DatabaseImplType<any, any>>}
+         */
+        this.instances = {};
+    }
+    /**
+     * Creates a database instance based on the provided configuration.
+     * @param {DbConfig<S>} config - The configuration object for the database.
+     * @returns {DatabaseImplType<S, DBSchema>} An instance of the database based on the configuration.
+     */
+    create(config) {
+        const configHash = hash(config);
+        if (this.instances[configHash]) {
+            return this.instances[configHash];
+        }
+        const instance = this.instantiateDb(config);
+        this.instances[configHash] = instance;
+        return instance;
+    }
+    /**
+     * Instantiates a database connection based on the provided configuration.
+     * @param {DbConfig<'pg'> | DbConfig<'kysely'>} config - The configuration object specifying the type of database.
+     * @returns {DatabaseImplType<S, DBSchema>} An instance of the specified database connection.
+     */
+    instantiateDb(config) {
+        return new this.databases[config.type](config);
+    }
+}
+/**
+ * Singleton instance of the DatabaseManager class.
+ * This instance is used to interact with the database.
+ */
+DatabaseManager.INSTANCE = new DatabaseManager();
+//# sourceMappingURL=DatabaseManager.js.map

package/dist/src/Database/DatabaseManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseManager.js","sourceRoot":"","sources":["../../../src/Database/DatabaseManager.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,aAAa,CAAA;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAG3E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,gBAAgB;IACpB,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,cAAc;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAA5B;QAME;;;WAGG;QACK,cAAS,GAAqB,SAAS,CAAA;QAC/C;;;WAGG;QACK,cAAS,GAAgD,EAAE,CAAA;IA6BrE,CAAC;IA3BC;;;;OAIG;IACI,MAAM,CACX,MAAmB;QAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;QAC/B,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAQ,CAAA;QAC1C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAc,MAAa,CAAC,CAAA;QAC/D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAA;QACrC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACK,aAAa,CACnB,MAAgE;QAEhE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAa,CAAQ,CAAA;IAC9D,CAAC;;AA1CD;;;GAGG;AACoB,wBAAQ,GAAG,IAAI,eAAe,EAAE,AAAxB,CAAwB"}

package/dist/src/Database/DatabaseTransaction.d.ts

@@ -0,0 +1,101 @@
+import { Database } from './Database.js';
+/**
+ * Abstract class representing a database transaction.
+ * Warning: These need to be arrow functions!
+ * @class DatabaseTransaction
+ */
+export declare abstract class DatabaseTransaction extends Function {
+    /**
+     * A boolean flag indicating whether a certain feature is open or closed.
+     * @type {boolean}
+     */
+    protected _isOpen: boolean;
+    /**
+     * A property representing a writer object.
+     * @type {any}
+     */
+    readonly writer: any;
+    /**
+     * A property representing a reader object.
+     * @type {any}
+     */
+    readonly reader: any;
+    /**
+     * A protected property representing a transaction.
+     * @type {any}
+     */
+    protected transaction: any;
+    /**
+     * A protected property representing a database of type Database<any>.
+     * This property is accessible within the class and its subclasses.
+     */
+    protected database: Database<any>;
+    /**
+     * Constructor for a class that interacts with a database using a writer and reader.
+     * @param {any} writer - The object responsible for writing to the database.
+     * @param {Database<any>} database - The database to interact with.
+     * @param {any} [reader] - The object responsible for reading from the database (optional).
+     * @returns None
+     */
+    protected constructor(writer: any, database: Database<any>, reader?: any);
+    /**
+     * Creates a proxy instance for the given subclass of DatabaseTransaction.
+     * The proxy handles method binding and transaction execution based on the subclass state.
+     * @param {T} subclass - The subclass of DatabaseTransaction to proxy.
+     * @returns A proxied instance of the subclass with method binding and transaction execution logic.
+     */
+    protected static proxyInstance<T extends DatabaseTransaction>(subclass: T): T;
+    /**
+     * Check if the object is open.
+     * @returns {boolean} - true if the object is open, false otherwise.
+     */
+    isOpen: () => boolean;
+    /**
+     * Begins a transaction asynchronously.
+     * @returns {Promise<void>} A Promise that resolves when the transaction has begun.
+     * @throws {Error} If the transaction is already open.
+     */
+    begin: () => Promise<void>;
+    /**
+     * Asynchronously commits the transaction.
+     * If the transaction is already closed, an error is thrown.
+     * @returns Promise<void>
+     * @throws Error if the transaction is already closed
+     */
+    commit: () => Promise<void>;
+    /**
+     * Rollback the transaction by reverting any changes made within the transaction.
+     * If the transaction is already closed, an error is thrown.
+     * @returns Promise<void>
+     * @throws Error if the transaction is already closed.
+     */
+    rollback: () => Promise<void>;
+    /**
+     * Closes the success modal, committing or rolling back changes based on the autoCommit setting.
+     * If the modal is open and autoCommit is enabled, it will commit the changes.
+     * If autoCommit is disabled, it will rollback the changes.
+     * @returns {Promise<void>} A promise that resolves once the commit or rollback operation is completed.
+     */
+    closeSuccess: () => Promise<void>;
+    /**
+     * Closes the failure by performing a rollback if the failure is currently open.
+     * @returns {Promise<void>} A promise that resolves once the rollback is completed.
+     */
+    closeFailure: () => Promise<void>;
+    /**
+     * Abstract method that should be implemented by subclasses to perform a commit operation.
+     * @returns A Promise that resolves when the commit operation is completed.
+     */
+    protected abstract doCommit: () => Promise<any>;
+    /**
+     * An abstract method that defines the rollback functionality.
+     * This method should be implemented by subclasses to perform the actual rollback operation.
+     * @returns A Promise that resolves when the rollback operation is completed.
+     */
+    protected abstract doRollback: () => Promise<any>;
+    /**
+     * Abstract method that defines the beginning of an asynchronous operation.
+     * @returns A Promise that resolves when the operation begins.
+     */
+    protected abstract doBegin: () => Promise<any>;
+}

package/dist/src/Database/DatabaseTransaction.js

@@ -0,0 +1,126 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Abstract class representing a database transaction.
+ * Warning: These need to be arrow functions!
+ * @class DatabaseTransaction
+ */
+export class DatabaseTransaction extends Function {
+    /**
+     * Constructor for a class that interacts with a database using a writer and reader.
+     * @param {any} writer - The object responsible for writing to the database.
+     * @param {Database<any>} database - The database to interact with.
+     * @param {any} [reader] - The object responsible for reading from the database (optional).
+     * @returns None
+     */
+    constructor(writer, database, reader) {
+        super('...args', 'return this.transaction(...args)');
+        /**
+         * Check if the object is open.
+         * @returns {boolean} - true if the object is open, false otherwise.
+         */
+        this.isOpen = () => {
+            return this._isOpen;
+        };
+        /**
+         * Begins a transaction asynchronously.
+         * @returns {Promise<void>} A Promise that resolves when the transaction has begun.
+         * @throws {Error} If the transaction is already open.
+         */
+        this.begin = () => __awaiter(this, void 0, void 0, function* () {
+            if (this._isOpen) {
+                throw new Error('Cannot begin, transaction is already opened!');
+            }
+            yield this.doBegin();
+            this._isOpen = true;
+        });
+        /**
+         * Asynchronously commits the transaction.
+         * If the transaction is already closed, an error is thrown.
+         * @returns Promise<void>
+         * @throws Error if the transaction is already closed
+         */
+        this.commit = () => __awaiter(this, void 0, void 0, function* () {
+            if (!this._isOpen) {
+                throw new Error('Cannot commit, transaction is already closed!');
+            }
+            yield this.doCommit();
+            this._isOpen = false;
+        });
+        /**
+         * Rollback the transaction by reverting any changes made within the transaction.
+         * If the transaction is already closed, an error is thrown.
+         * @returns Promise<void>
+         * @throws Error if the transaction is already closed.
+         */
+        this.rollback = () => __awaiter(this, void 0, void 0, function* () {
+            if (!this._isOpen) {
+                throw new Error('Cannot rollback, transaction is already closed!');
+            }
+            yield this.doRollback();
+            this._isOpen = false;
+        });
+        /**
+         * Closes the success modal, committing or rolling back changes based on the autoCommit setting.
+         * If the modal is open and autoCommit is enabled, it will commit the changes.
+         * If autoCommit is disabled, it will rollback the changes.
+         * @returns {Promise<void>} A promise that resolves once the commit or rollback operation is completed.
+         */
+        this.closeSuccess = () => __awaiter(this, void 0, void 0, function* () {
+            if (this._isOpen) {
+                if (this.database.config['autoCommit']) {
+                    yield this.doCommit();
+                }
+                else {
+                    yield this.doRollback();
+                }
+            }
+        });
+        /**
+         * Closes the failure by performing a rollback if the failure is currently open.
+         * @returns {Promise<void>} A promise that resolves once the rollback is completed.
+         */
+        this.closeFailure = () => __awaiter(this, void 0, void 0, function* () {
+            if (this._isOpen) {
+                yield this.doRollback();
+            }
+        });
+        this.writer = writer;
+        this.database = database;
+        this.reader = reader;
+    }
+    /**
+     * Creates a proxy instance for the given subclass of DatabaseTransaction.
+     * The proxy handles method binding and transaction execution based on the subclass state.
+     * @param {T} subclass - The subclass of DatabaseTransaction to proxy.
+     * @returns A proxied instance of the subclass with method binding and transaction execution logic.
+     */
+    static proxyInstance(subclass) {
+        const bind = (target, key) => typeof target[key] === 'function' ? target[key].bind(target) : target[key];
+        return new Proxy(subclass, {
+            get(target, p) {
+                if (target[p] !== undefined) {
+                    return bind(target, p);
+                }
+                else if (target._isOpen) {
+                    return bind(target.transaction, p);
+                }
+                return undefined;
+            },
+            apply(target, thisArg, argArray) {
+                if (target._isOpen) {
+                    return target.transaction(...argArray);
+                }
+                throw new Error('Transaction is closed!');
+            },
+        });
+    }
+}
+//# sourceMappingURL=DatabaseTransaction.js.map

package/dist/src/Database/DatabaseTransaction.js.map

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

package/dist/src/Database/index.d.ts

@@ -0,0 +1,10 @@
+import { Database } from './Database.js';
+import { DatabaseManager } from './DatabaseManager.js';
+import { DatabaseTransaction } from './DatabaseTransaction.js';
+import { DynamoDatabase } from './integrations/dynamo/DynamoDatabase.js';
+import { KyselyDatabase } from './integrations/kysely/KyselyDatabase.js';
+import { KyselyTransaction } from './integrations/kysely/KyselyTransaction.js';
+import { PostgresDatabase } from './integrations/pgsql/PostgresDatabase.js';
+import { PostgresTransaction } from './integrations/pgsql/PostgresTransaction.js';
+import { DbConfig } from './types.js';
+export { DatabaseTransaction, Database, DatabaseManager, DbConfig, PostgresTransaction, PostgresDatabase, KyselyTransaction, KyselyDatabase, DynamoDatabase, };

package/dist/src/Database/index.js

@@ -0,0 +1,15 @@
+import { Database } from './Database.js';
+import { DatabaseManager } from './DatabaseManager.js';
+import { DatabaseTransaction } from './DatabaseTransaction.js';
+import { DynamoDatabase } from './integrations/dynamo/DynamoDatabase.js';
+import { KyselyDatabase } from './integrations/kysely/KyselyDatabase.js';
+import { PostgresDatabase } from './integrations/pgsql/PostgresDatabase.js';
+export { 
+// Abstracts
+DatabaseTransaction, Database, 
+// 'Entrypoints'
+DatabaseManager, PostgresDatabase, KyselyDatabase, 
+// Dynamo
+// DynamoTransaction,
+DynamoDatabase, };
+//# sourceMappingURL=index.js.map

package/dist/src/Database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAA;AAI3E,OAAO;AACL,YAAY;AACZ,mBAAmB,EACnB,QAAQ;AACR,gBAAgB;AAChB,eAAe,EAIf,gBAAgB,EAGhB,cAAc;AACd,SAAS;AACT,qBAAqB;AACrB,cAAc,GACf,CAAA"}

package/dist/src/Database/integrations/dynamo/DynamoDatabase.d.ts

@@ -0,0 +1,35 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { Database } from '../../Database.js';
+import type { DbConfig } from '../../types.js';
+/**
+ * Represents a DynamoDB database connection that extends a generic Database class.
+ * @extends Database<any>
+ */
+export declare class DynamoDatabase extends Database<any> {
+    /**
+     * A private static property that holds an instance of the DynamoDBClient class.
+     * This property can be used to interact with DynamoDB services.
+     */
+    private static dynamoProvider;
+    /**
+     * A readonly property representing the DynamoDB client used to interact with DynamoDB.
+     */
+    readonly client: DynamoDBClient;
+    /**
+     * Constructor for creating a new instance of a class that interacts with a DynamoDB database.
+     * @param {DbConfig<'dynamo'>} config - The configuration object for DynamoDB.
+     * @returns None
+     */
+    constructor(config: DbConfig<'dynamo'>);
+    /**
+     * Override method to handle a transaction asynchronously.
+     * @returns A Promise that resolves to null.
+     */
+    transaction(): Promise<any>;
+    /**
+     * Creates a provider for DynamoDB based on the provided configuration.
+     * @param {DbConfig<'dynamo'>} config - The configuration object for DynamoDB.
+     * @returns A DynamoDB provider instance based on the provided configuration.
+     */
+    private providerFactory;
+}

package/dist/src/Database/integrations/dynamo/DynamoDatabase.js

@@ -0,0 +1,59 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Agent } from 'https';
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { NodeHttpHandler } from '@smithy/node-http-handler';
+import { Database } from '../../Database.js';
+/**
+ * Represents a DynamoDB database connection that extends a generic Database class.
+ * @extends Database<any>
+ */
+export class DynamoDatabase extends Database {
+    /**
+     * Constructor for creating a new instance of a class that interacts with a DynamoDB database.
+     * @param {DbConfig<'dynamo'>} config - The configuration object for DynamoDB.
+     * @returns None
+     */
+    constructor(config) {
+        super(config);
+        this.client = this.providerFactory(config);
+    }
+    /**
+     * Override method to handle a transaction asynchronously.
+     * @returns A Promise that resolves to null.
+     */
+    transaction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Promise.resolve(null);
+        });
+    }
+    /**
+     * Creates a provider for DynamoDB based on the provided configuration.
+     * @param {DbConfig<'dynamo'>} config - The configuration object for DynamoDB.
+     * @returns A DynamoDB provider instance based on the provided configuration.
+     */
+    providerFactory(config) {
+        return new DynamoDatabase.dynamoProvider({
+            region: config.region,
+            maxAttempts: config.maxAttempts || 3,
+            requestHandler: new NodeHttpHandler({
+                connectionTimeout: config.connectionTimeout || 60000,
+                socketTimeout: config.connectionTimeout || 60000,
+                httpsAgent: new Agent({ keepAlive: false, maxSockets: 50, rejectUnauthorized: true }),
+            }),
+        });
+    }
+}
+/**
+ * A private static property that holds an instance of the DynamoDBClient class.
+ * This property can be used to interact with DynamoDB services.
+ */
+DynamoDatabase.dynamoProvider = DynamoDBClient;
+//# sourceMappingURL=DynamoDatabase.js.map

package/dist/src/Database/integrations/dynamo/DynamoDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoDatabase.js","sourceRoot":"","sources":["../../../../../src/Database/integrations/dynamo/DynamoDatabase.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAa;IAW/C;;;;OAIG;IACH,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACmB,WAAW;;YAC/B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;KAAA;IAED;;;;OAIG;IACK,eAAe,CAAC,MAA0B;QAChD,OAAO,IAAI,cAAc,CAAC,cAAc,CAAC;YACvC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;YACpC,cAAc,EAAE,IAAI,eAAe,CAAC;gBAClC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,KAAK;gBACpD,aAAa,EAAE,MAAM,CAAC,iBAAiB,IAAI,KAAK;gBAChD,UAAU,EAAE,IAAI,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;aACtF,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;;AA3CD;;;GAGG;AACY,6BAAc,GAAG,cAAc,CAAA"}

package/dist/src/Database/integrations/kysely/KyselyDatabase.d.ts

@@ -0,0 +1,66 @@
+import { Kysely } from 'kysely';
+import { KyselyTransaction } from './KyselyTransaction.js';
+import { Database } from '../../Database.js';
+import type { DbConfig } from '../../types.js';
+/**
+ * Represents a database connection using the Kysely library with support for transactions.
+ * @template DBSchema - The schema type for the database.
+ */
+export declare class KyselyDatabase<DBSchema = never> extends Database<KyselyTransaction<DBSchema>> {
+    /**
+     * Represents a PostgreSQL provider for querying data using the PostgresDialect.
+     * @type {PostgresDialect}
+     */
+    private static kyselyPgProvider;
+    /**
+     * A public static property that provides access to the Kysely class.
+     * This property can be accessed without creating an instance of the class.
+     */
+    private static kyselyProvider;
+    /**
+     * A static property that represents a connection pool for PostgreSQL database connections.
+     * @type {Pool}
+     */
+    private static pgProvider;
+    /**
+     * Represents a PostgreSQL client using the PostgresDialect.
+     */
+    private readonly pgClient;
+    /**
+     * Represents a client for querying the database with the specified schema.
+     * @type {Kysely<DBSchema>} client - The client for querying the database.
+     */
+    readonly client: Kysely<DBSchema>;
+    /**
+     * Optional property representing the Postgres dialect for reading in a database client.
+     */
+    private readonly pgReadClient?;
+    /**
+     * Represents a client for reading from the database.
+     * @type {Kysely<DBSchema> | undefined} - The client for reading from the database.
+     */
+    readonly readClient?: Kysely<DBSchema>;
+    /**
+     * Constructor for creating a database connection using the provided configuration.
+     * @param {DbConfig<'kysely'>} config - The configuration object for the database connection.
+     * @returns None
+     */
+    constructor(config: DbConfig<'kysely'>);
+    /**
+     * Override method that starts a new transaction using the provided client and read client.
+     * @returns A Promise that resolves to a KyselyTransaction object for the specified database schema.
+     */
+    transaction(): Promise<KyselyTransaction<DBSchema>>;
+    /**
+     * Creates a database dialect based on the provided configuration.
+     * @param {DbBaseConfig} config - The configuration object for the database connection.
+     * @returns A database dialect instance based on the provided configuration.
+     */
+    private dialectFactory;
+    /**
+     * Creates a provider for interacting with a database using the specified Postgres dialect.
+     * @param {PostgresDialect} dialect - The Postgres dialect to use for the database connection.
+     * @returns A database provider for interacting with the database.
+     */
+    private providerFactory;
+}

package/dist/src/Database/integrations/kysely/KyselyDatabase.js

@@ -0,0 +1,86 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { CamelCasePlugin, Kysely, PostgresDialect } from 'kysely';
+import pg from 'pg';
+import { KyselyTransactionImpl } from './KyselyTransaction.js';
+import { Database } from '../../Database.js';
+/**
+ * Represents a database connection using the Kysely library with support for transactions.
+ * @template DBSchema - The schema type for the database.
+ */
+export class KyselyDatabase extends Database {
+    /**
+     * Constructor for creating a database connection using the provided configuration.
+     * @param {DbConfig<'kysely'>} config - The configuration object for the database connection.
+     * @returns None
+     */
+    constructor(config) {
+        super(config);
+        this.pgClient = this.dialectFactory(config);
+        this.client = this.providerFactory(this.pgClient);
+        if (config.readReplica) {
+            this.pgReadClient = this.dialectFactory(config.readReplica);
+            this.readClient = this.providerFactory(this.pgReadClient);
+        }
+    }
+    /**
+     * Override method that starts a new transaction using the provided client and read client.
+     * @returns A Promise that resolves to a KyselyTransaction object for the specified database schema.
+     */
+    transaction() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return KyselyTransactionImpl.newTransaction(this.client, this, this.readClient);
+        });
+    }
+    /**
+     * Creates a database dialect based on the provided configuration.
+     * @param {DbBaseConfig} config - The configuration object for the database connection.
+     * @returns A database dialect instance based on the provided configuration.
+     */
+    dialectFactory(config) {
+        return new KyselyDatabase.kyselyPgProvider({
+            pool: new KyselyDatabase.pgProvider({
+                host: config.host,
+                port: config.port,
+                user: config.username,
+                password: config.password,
+                database: config.database,
+                max: config.maxConnections,
+            }),
+        });
+    }
+    /**
+     * Creates a provider for interacting with a database using the specified Postgres dialect.
+     * @param {PostgresDialect} dialect - The Postgres dialect to use for the database connection.
+     * @returns A database provider for interacting with the database.
+     */
+    providerFactory(dialect) {
+        return new KyselyDatabase.kyselyProvider({
+            dialect,
+            plugins: [new CamelCasePlugin()],
+        });
+    }
+}
+/**
+ * Represents a PostgreSQL provider for querying data using the PostgresDialect.
+ * @type {PostgresDialect}
+ */
+KyselyDatabase.kyselyPgProvider = PostgresDialect;
+/**
+ * A public static property that provides access to the Kysely class.
+ * This property can be accessed without creating an instance of the class.
+ */
+KyselyDatabase.kyselyProvider = Kysely;
+/**
+ * A static property that represents a connection pool for PostgreSQL database connections.
+ * @type {Pool}
+ */
+KyselyDatabase.pgProvider = pg.Pool;
+//# sourceMappingURL=KyselyDatabase.js.map

package/dist/src/Database/integrations/kysely/KyselyDatabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KyselyDatabase.js","sourceRoot":"","sources":["../../../../../src/Database/integrations/kysely/KyselyDatabase.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AACjE,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,OAAO,EAAqB,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C;;;GAGG;AACH,MAAM,OAAO,cAAiC,SAAQ,QAAqC;IAmCzF;;;;OAIG;IACH,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;YAC3D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;IAED;;;OAGG;IACmB,WAAW;;YAC/B,OAAO,qBAAqB,CAAC,cAAc,CAAW,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAC3F,CAAC;KAAA;IAED;;;;OAIG;IACK,cAAc,CAAC,MAAoB;QACzC,OAAO,IAAI,cAAc,CAAC,gBAAgB,CAAC;YACzC,IAAI,EAAE,IAAI,cAAc,CAAC,UAAU,CAAC;gBAClC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,QAAQ;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,GAAG,EAAE,MAAM,CAAC,cAAc;aAC3B,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACK,eAAe,CAAC,OAAwB;QAC9C,OAAO,IAAI,cAAc,CAAC,cAAc,CAAW;YACjD,OAAO;YACP,OAAO,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;SACjC,CAAC,CAAA;IACJ,CAAC;;AArFD;;;GAGG;AACY,+BAAgB,GAAG,eAAe,CAAA;AACjD;;;GAGG;AACY,6BAAc,GAAG,MAAM,CAAA;AACtC;;;GAGG;AACY,yBAAU,GAAG,EAAE,CAAC,IAAI,CAAA"}