arkormx 2.0.0 → 2.0.2

package/dist/index.mjs

@@ -3044,9 +3044,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 sql.raw(statement).execute(executor);
 	}
+	async rawQuery(spec) {
+		const statement = this.interpolateRawSql(spec.sql, spec.bindings);
+		try {
+			return (await 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;
 	}
@@ -6382,45 +6415,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
 /**
@@ -9015,6 +9009,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 = {
@@ -9045,6 +9078,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);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",
@@ -52,7 +52,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.10.6",
     "@types/pg": "^8.15.5",
-    "@vitest/coverage-v8": "4.1.2",
+    "@vitest/coverage-v8": "^4.1.5",
     "barrelize": "^1.7.3",
     "eslint": "^10.0.0",
     "prisma": "^7.6.0",
@@ -62,7 +62,7 @@
     "typescript-eslint": "^8.56.0",
     "vite-tsconfig-paths": "^6.1.1",
     "vitepress": "2.0.0-alpha.16",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.5"
   },
   "engines": {
     "node": ">=20.0.0"