nucleus-core-ts 0.10.113 → 0.10.114

package/dist/src/Nucleus/routes/entity/sortCollation.d.ts

@@ -0,0 +1,16 @@
+import { type SQL } from 'drizzle-orm';
+export declare const COLLATABLE_COLUMN_TYPES: Set<string>;
+/**
+ * A collation name is an IDENTIFIER, so it is interpolated into the SQL text
+ * and cannot be sent as a bound parameter. It comes from config rather than
+ * from a request, but "not attacker-controlled today" is not the same as safe:
+ * accept a bare identifier and nothing else.
+ */
+export declare function normalizeSortCollation(raw: unknown): string;
+/** True when `raw` was given but is not usable — the caller should log it. */
+export declare function isRejectedSortCollation(raw: unknown): boolean;
+/**
+ * Wraps a sort column in the configured collation when — and only when — the
+ * column is a character type.
+ */
+export declare function collateColumn(col: unknown, collation: string): SQL;

package/dist/src/Nucleus/routes/entity/types.d.ts

@@ -30,6 +30,8 @@ export interface EntityRouteConfig {
     entities: NucleusTable[];
     logger: Logger;
     databaseUrl?: string;
+    /** ICU collation for text-column sorts (see `database.sortCollation`). */
+    sortCollation?: string;
     dbPool?: import('pg').Pool | null;
     storage?: {
         enabled?: boolean;

package/dist/src/types.d.ts

@@ -210,6 +210,24 @@ export interface NucleusConfigOptions {
             maxUses?: number;
         };
         isMultiTenant?: boolean;
+        /**
+         * Collation applied to text-column sorts, e.g. `tr-TR-x-icu`.
+         *
+         * Postgres' default collation on a `C`/`POSIX` database orders by BYTE, so
+         * an "A-Z" list is not alphabetical in any language with letters outside
+         * ASCII. Measured on a Turkish catalogue: `ALBITROL` sorted before
+         * `Airtide` (uppercase letters sort before lowercase), and every name
+         * starting with ç/ğ/ı/ö/ş/ü landed after `z`. The list looked sorted and
+         * was not — the worst kind of wrong, because nothing about it invites a
+         * second look.
+         *
+         * Set the ICU collation for the install's language (`tr-TR-x-icu`,
+         * `de-DE-x-icu`, ...) and every entity sort on a text column uses it.
+         * Unset (default) keeps the database's own collation, so existing installs
+         * do not change order under them. An unknown collation is refused at boot
+         * rather than applied — see the entity route.
+         */
+        sortCollation?: string;
         schemas?: string[];
         /**
          * Deadline for the startup schema push (default 120000 ms).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nucleus-core-ts",
-  "version": "0.10.113",
+  "version": "0.10.114",
   "description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
   "author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
   "license": "SEE LICENSE IN LICENSE",