arkormx 2.0.0 → 2.0.2

package/README.md

@@ -3,9 +3,10 @@
 [![NPM Downloads](https://img.shields.io/npm/dt/arkormx.svg)](https://www.npmjs.com/package/arkormx)
 [![npm version](https://img.shields.io/npm/v/arkormx.svg)](https://www.npmjs.com/package/arkormx)
 [![License](https://img.shields.io/npm/l/arkormx.svg)](https://github.com/arkstack-hq/arkormx/blob/main/LICENSE)
+[![codecov](https://codecov.io/gh/arkstack-hq/arkormx/graph/badge.svg?token=ls1VVoFkYh)](https://codecov.io/gh/arkstack-hq/arkormx)
 [![CI](https://github.com/arkstack-hq/arkormx/actions/workflows/ci.yml/badge.svg)](https://github.com/arkstack-hq/arkormx/actions/workflows/ci.yml)
 [![Deploy Documentation](https://github.com/arkstack-hq/arkormx/actions/workflows/deploy-docs.yml/badge.svg)](https://github.com/arkstack-hq/arkormx/actions/workflows/deploy-docs.yml)
-[![codecov](https://codecov.io/gh/arkstack-hq/arkormx/graph/badge.svg?token=ls1VVoFkYh)](https://codecov.io/gh/arkstack-hq/arkormx)
+[![Publish to NPM](https://github.com/arkstack-hq/arkormx/actions/workflows/publish.yml/badge.svg)](https://github.com/arkstack-hq/arkormx/actions/workflows/publish.yml)
 
 Arkormˣ is a framework-agnostic ORM designed to run anywhere Node.js runs. It brings a familiar model layer and fluent query builder on top of adapter-backed execution, with Prisma compatibility available as an optional 2.x compatibility path.
 

package/dist/index.cjs

@@ -3073,9 +3073,42 @@ var KyselyDatabaseAdapter = class KyselyDatabaseAdapter {
 		if (value instanceof Date) return `'${value.toISOString().replace(/'/g, "''")}'`;
 		return `'${String(value).replace(/'/g, "''")}'`;
 	}
+	interpolateRawSql(sourceSql, bindings = []) {
+		if (bindings.length === 0) return sourceSql;
+		let bindingIndex = 0;
+		return sourceSql.replace(/\?/g, () => {
+			const value = bindings[bindingIndex];
+			bindingIndex += 1;
+			return this.quoteLiteral(value);
+		});
+	}
 	async executeRawStatement(statement, executor = this.db) {
 		await kysely.sql.raw(statement).execute(executor);
 	}
+	async rawQuery(spec) {
+		const statement = this.interpolateRawSql(spec.sql, spec.bindings);
+		try {
+			return (await kysely.sql.raw(statement).execute(this.db)).rows ?? [];
+		} catch (error) {
+			throw new QueryExecutionException("Raw query execution failed for the Kysely adapter.", {
+				code: "QUERY_EXECUTION_FAILED",
+				operation: "adapter.rawQuery",
+				delegate: "raw",
+				inspection: this.tryInspectRawQuery(statement),
+				meta: { sql: statement },
+				cause: error
+			});
+		}
+	}
+	tryInspectRawQuery(statement) {
+		return {
+			adapter: "kysely",
+			operation: "select",
+			target: "raw",
+			sql: statement,
+			parameters: []
+		};
+	}
 	resolveSchemaColumnName(columnName, columns = []) {
 		return columns.find((column) => column.name === columnName)?.map ?? columnName;
 	}
@@ -6411,45 +6444,6 @@ const defineFactory = (model, definition) => {
 	return new InlineFactory(model, definition);
 };
 
-//#endregion
-//#region src/helpers/runtime-compatibility.ts
-const isObjectLike = (value) => {
-	return Boolean(value) && typeof value === "object";
-};
-const isCompatibilityClient = (value) => {
-	return Boolean(value) && typeof value === "object";
-};
-const getCompatibilitySources = (preferredClient) => {
-	const activeTransactionClient = getActiveTransactionClient();
-	const runtimeClient = getRuntimeClient();
-	return activeTransactionClient ? [
-		activeTransactionClient,
-		preferredClient,
-		runtimeClient
-	] : [preferredClient, runtimeClient];
-};
-const getRuntimeCompatibilityAdapter = (preferredClient) => {
-	const client = getCompatibilitySources(preferredClient).find((source) => isCompatibilityClient(source));
-	if (!client) return void 0;
-	return createPrismaCompatibilityAdapter(client);
-};
-const resolveRuntimeCompatibilityQuerySchema = (candidates, preferredClient) => {
-	return getCompatibilitySources(preferredClient).flatMap((source) => {
-		if (!isObjectLike(source)) return [];
-		return candidates.map((candidate) => source[candidate]);
-	}).find((candidate) => isQuerySchemaLike(candidate));
-};
-const resolveRuntimeCompatibilityQuerySchemaOrThrow = (key, candidates, modelName, preferredClient) => {
-	const resolved = resolveRuntimeCompatibilityQuerySchema(candidates, preferredClient);
-	if (!resolved) throw new MissingDelegateException(`Database delegate [${key}] is not configured.`, {
-		operation: "getDelegate",
-		model: modelName,
-		delegate: key,
-		meta: { candidates }
-	});
-	return resolved;
-};
-
 //#endregion
 //#region src/URLDriver.ts
 /**
@@ -9044,6 +9038,45 @@ var QueryBuilder = class QueryBuilder {
 	}
 };
 
+//#endregion
+//#region src/helpers/runtime-compatibility.ts
+const isObjectLike = (value) => {
+	return Boolean(value) && typeof value === "object";
+};
+const isCompatibilityClient = (value) => {
+	return Boolean(value) && typeof value === "object";
+};
+const getCompatibilitySources = (preferredClient) => {
+	const activeTransactionClient = getActiveTransactionClient();
+	const runtimeClient = getRuntimeClient();
+	return activeTransactionClient ? [
+		activeTransactionClient,
+		preferredClient,
+		runtimeClient
+	] : [preferredClient, runtimeClient];
+};
+const getRuntimeCompatibilityAdapter = (preferredClient) => {
+	const client = getCompatibilitySources(preferredClient).find((source) => isCompatibilityClient(source));
+	if (!client) return void 0;
+	return createPrismaCompatibilityAdapter(client);
+};
+const resolveRuntimeCompatibilityQuerySchema = (candidates, preferredClient) => {
+	return getCompatibilitySources(preferredClient).flatMap((source) => {
+		if (!isObjectLike(source)) return [];
+		return candidates.map((candidate) => source[candidate]);
+	}).find((candidate) => isQuerySchemaLike(candidate));
+};
+const resolveRuntimeCompatibilityQuerySchemaOrThrow = (key, candidates, modelName, preferredClient) => {
+	const resolved = resolveRuntimeCompatibilityQuerySchema(candidates, preferredClient);
+	if (!resolved) throw new MissingDelegateException(`Database delegate [${key}] is not configured.`, {
+		operation: "getDelegate",
+		model: modelName,
+		delegate: key,
+		meta: { candidates }
+	});
+	return resolved;
+};
+
 //#endregion
 //#region src/DB.ts
 const defaultSoftDeleteConfig = {
@@ -9074,6 +9107,25 @@ var DB = class DB {
 	table(table, options = {}) {
 		return DB.createTableModel(table, options, this.getAdapter()).query();
 	}
+	static async raw(sql, bindings = []) {
+		return await new DB().raw(sql, bindings);
+	}
+	async raw(sql, bindings = []) {
+		const adapter = this.getAdapter();
+		if (!adapter) throw new ArkormException("Raw queries require a configured database adapter.", {
+			code: "ADAPTER_NOT_CONFIGURED",
+			operation: "db.raw"
+		});
+		if (!adapter.rawQuery) throw new UnsupportedAdapterFeatureException("Raw queries are not supported by the current adapter.", {
+			operation: "db.raw",
+			meta: { feature: "rawQuery" }
+		});
+		const rows = await adapter.rawQuery({
+			sql,
+			bindings
+		});
+		return ArkormCollection.make(rows);
+	}
 	static async transaction(callback, context) {
 		return await new DB().transaction(callback, context);
 	}