@getstrata/core 2.2.5 → 2.2.7

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @getstrata/core changelog
 
+## 2.2.7
+
+- Where an ordinary operation needs SQL because the framework cannot express it
+
+## 2.2.6
+
+-  fix(cli): relay shutdown to children and simplify container launcher
+
 ## 2.2.5
 
 -  fix(starter): keep container readiness independent of API admission

package/dist/core/database/types.d.ts

@@ -40,6 +40,8 @@ type ModelWriteValues<TEntity> = Partial<TEntity>;
 type QueryOrder<TEntity> = {
     column: keyof TEntity & string;
     direction?: "ASC" | "DESC" | "asc" | "desc";
+    /** Explicit placement; omitted retains the database's default. */
+    nulls?: "first" | "last";
 };
 type QueryOrderShorthand<TEntity> = Partial<Record<keyof TEntity & string, "ASC" | "DESC" | "asc" | "desc">>;
 type QueryJoinOn = {

package/dist/entries/database/query.js

@@ -254,8 +254,18 @@ function normalizeOrderBy(orderBy) {
   }));
 }
 function buildOrderByClause(tableName, orderBy) {
-  const parts = normalizeOrderBy(orderBy).map(({ column, direction }) => {
-    return `${resolveQualifiedColumn(tableName, column)} ${normalizeDirection(direction)}`;
+  const parts = normalizeOrderBy(orderBy).map(({ column, direction, nulls }) => {
+    if (nulls !== undefined && nulls !== "first" && nulls !== "last") {
+      throw new TypeError("Invalid null ordering: expected first or last.");
+    }
+    const reference = resolveQualifiedColumn(tableName, column);
+    const ordered = `${reference} ${normalizeDirection(direction)}`;
+    if (nulls === undefined)
+      return ordered;
+    if (currentSqlDialect().driver === "mysql") {
+      return `(${reference} IS NULL) ${nulls === "first" ? "DESC" : "ASC"}, ${ordered}`;
+    }
+    return `${ordered} NULLS ${nulls.toUpperCase()}`;
   });
   return parts.length > 0 ? ` ORDER BY ${parts.join(", ")}` : "";
 }

package/dist/entries/database/repositoryQuery.js

@@ -278,8 +278,18 @@ function normalizeOrderBy(orderBy) {
   }));
 }
 function buildOrderByClause(tableName, orderBy) {
-  const parts = normalizeOrderBy(orderBy).map(({ column, direction }) => {
-    return `${resolveQualifiedColumn(tableName, column)} ${normalizeDirection(direction)}`;
+  const parts = normalizeOrderBy(orderBy).map(({ column, direction, nulls }) => {
+    if (nulls !== undefined && nulls !== "first" && nulls !== "last") {
+      throw new TypeError("Invalid null ordering: expected first or last.");
+    }
+    const reference = resolveQualifiedColumn(tableName, column);
+    const ordered = `${reference} ${normalizeDirection(direction)}`;
+    if (nulls === undefined)
+      return ordered;
+    if (currentSqlDialect().driver === "mysql") {
+      return `(${reference} IS NULL) ${nulls === "first" ? "DESC" : "ASC"}, ${ordered}`;
+    }
+    return `${ordered} NULLS ${nulls.toUpperCase()}`;
   });
   return parts.length > 0 ? ` ORDER BY ${parts.join(", ")}` : "";
 }

package/dist/index.js

@@ -4438,8 +4438,18 @@ function normalizeOrderBy(orderBy) {
   }));
 }
 function buildOrderByClause(tableName, orderBy) {
-  const parts = normalizeOrderBy(orderBy).map(({ column, direction }) => {
-    return `${resolveQualifiedColumn(tableName, column)} ${normalizeDirection(direction)}`;
+  const parts = normalizeOrderBy(orderBy).map(({ column, direction, nulls }) => {
+    if (nulls !== undefined && nulls !== "first" && nulls !== "last") {
+      throw new TypeError("Invalid null ordering: expected first or last.");
+    }
+    const reference = resolveQualifiedColumn(tableName, column);
+    const ordered = `${reference} ${normalizeDirection(direction)}`;
+    if (nulls === undefined)
+      return ordered;
+    if (currentSqlDialect().driver === "mysql") {
+      return `(${reference} IS NULL) ${nulls === "first" ? "DESC" : "ASC"}, ${ordered}`;
+    }
+    return `${ordered} NULLS ${nulls.toUpperCase()}`;
   });
   return parts.length > 0 ? ` ORDER BY ${parts.join(", ")}` : "";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/core",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "description": "Strata Bun framework public API",
   "type": "module",
   "license": "MIT",