@c15t/backend 0.0.1-rc.10

package/src/db/adapters/kysely-adapter/dialect.ts

@@ -0,0 +1,192 @@
+import {
+	type Dialect,
+	Kysely,
+	MssqlDialect,
+	MysqlDialect,
+	PostgresDialect,
+	SqliteDialect,
+} from 'kysely';
+import type { C15TOptions } from '~/types';
+import type {
+	Database,
+	DatabaseConfiguration,
+	DialectConfig,
+	KyselyDatabaseType,
+	KyselyInstanceConfig,
+} from './types';
+
+/**
+ * Determines the database type from a database configuration
+ *
+ * This function analyzes a database configuration object to determine
+ * which type of database it represents (SQLite, MySQL, PostgreSQL, MSSQL).
+ * It handles different configuration formats including direct dialect instances,
+ * connection pools, and raw database connections.
+ *
+ * @internal This function is used internally by the createKyselyAdapter function
+ * @param db - The database configuration to analyze
+ * @returns The detected database type or null if unable to determine
+ */
+function getDatabaseType(
+	db: DatabaseConfiguration | undefined
+): KyselyDatabaseType | null {
+	if (!db) {
+		return null;
+	}
+	if ('dialect' in db) {
+		return getDatabaseType(db.dialect as Dialect);
+	}
+	if ('createDriver' in db) {
+		if (db instanceof SqliteDialect) {
+			return 'sqlite';
+		}
+		if (db instanceof MysqlDialect) {
+			return 'mysql';
+		}
+		if (db instanceof PostgresDialect) {
+			return 'postgres';
+		}
+		if (db instanceof MssqlDialect) {
+			return 'mssql';
+		}
+	}
+	if ('aggregate' in db) {
+		return 'sqlite';
+	}
+
+	if ('getConnection' in db) {
+		return 'mysql';
+	}
+	if ('connect' in db) {
+		return 'postgres';
+	}
+
+	return null;
+}
+
+/**
+ * Creates a Kysely adapter from the provided configuration
+ *
+ * This function analyzes the database configuration in C15TOptions and creates
+ * an appropriate Kysely instance with the correct dialect. It handles several
+ * different configuration formats including:
+ * - Direct Kysely instances
+ * - Dialect configurations
+ * - Raw database connections (SQLite, MySQL, PostgreSQL)
+ * - Kysely dialect instances
+ *
+ * @param config - The C15T configuration options containing database settings
+ * @returns An object containing the initialized Kysely instance and database type
+ *
+ * @example
+ * ```typescript
+ * // Using with a pre-configured Kysely instance
+ * import { Kysely, PostgresDialect } from 'kysely';
+ * import { Pool } from 'pg';
+ * import { c15tInstance } from '@c15t/backend';
+ *
+ * // Create a Postgres connection pool
+ * const pool = new Pool({
+ *   host: 'localhost',
+ *   database: 'consent_db',
+ *   user: 'postgres',
+ *   password: 'password'
+ * });
+ *
+ * // Create Kysely instance
+ * const db = new Kysely({
+ *   dialect: new PostgresDialect({ pool })
+ * });
+ *
+ * // Use in c15t configuration
+ * const c15t = c15tInstance({
+ *   secret: process.env.SECRET_KEY,
+ *   database: { db, type: 'postgres' } // Pre-configured Kysely instance
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using with a direct connection pool
+ * import { Pool } from 'pg';
+ * import { c15tInstance } from '@c15t/backend';
+ *
+ * // Create a Postgres connection pool
+ * const pool = new Pool({
+ *   host: 'localhost',
+ *   database: 'consent_db',
+ *   user: 'postgres',
+ *   password: 'password'
+ * });
+ *
+ * // Pass the pool directly to c15t
+ * const c15t = c15tInstance({
+ *   secret: process.env.SECRET_KEY,
+ *   database: pool // The adapter will detect it's a Postgres pool
+ * });
+ * ```
+ *
+ * @throws {Error} Will throw an error if the database configuration is invalid or if a connection cannot be established
+ */
+export const createKyselyAdapter = async (
+	config: C15TOptions
+): Promise<{
+	kysely: Kysely<Database> | null;
+	databaseType: KyselyDatabaseType | null;
+}> => {
+	const db = config.database;
+
+	if (!db) {
+		return {
+			kysely: null,
+			databaseType: null,
+		};
+	}
+
+	if ('db' in db) {
+		const kyselyConfig = db as KyselyInstanceConfig;
+		return {
+			kysely: kyselyConfig.db,
+			databaseType: kyselyConfig.type,
+		};
+	}
+
+	if ('dialect' in db) {
+		const dialectConfig = db as DialectConfig;
+		return {
+			kysely: new Kysely({ dialect: dialectConfig.dialect }),
+			databaseType: dialectConfig.type,
+		};
+	}
+
+	let dialect: Dialect | undefined;
+
+	const databaseType = getDatabaseType(db);
+
+	if ('createDriver' in db) {
+		dialect = db;
+	}
+
+	if ('aggregate' in db) {
+		dialect = new SqliteDialect({
+			database: db,
+		});
+	}
+
+	if ('getConnection' in db) {
+		dialect = new MysqlDialect({
+			pool: db,
+		});
+	}
+
+	if ('connect' in db) {
+		dialect = new PostgresDialect({
+			pool: db,
+		});
+	}
+
+	return {
+		kysely: dialect ? new Kysely({ dialect }) : null,
+		databaseType,
+	};
+};

package/src/db/adapters/kysely-adapter/index.ts

@@ -0,0 +1,3 @@
+export * from './dialect';
+export * from './types';
+export * from './kysely-adapter';