@tstdl/base 0.93.45 → 0.93.47

package/orm/sqls.d.ts

@@ -61,7 +61,14 @@ export type TsHeadlineOptions = {
     fragmentDelimiter?: string;
 };
 export declare function enumValue<T extends EnumerationObject>(enumeration: T, dbEnum: PgEnumFromEnumeration<T> | string | null, value: EnumerationValue<T>): SQL<string>;
-export declare function exclusiveNotNull(columns: Column[]): SQL;
+/**
+ * Generates a SQL condition that ensures exactly one of the specified columns is non-null and optional custom conditions.
+ * @param enumeration The enumeration object
+ * @param discriminator The column used to discriminate between different enumeration values
+ * @param conditionMapping An object mapping enumeration values to columns and conditions
+ */
+export declare function exclusiveReference<T extends EnumerationObject>(enumeration: T, discriminator: Column, conditionMapping: Record<EnumerationValue<T>, Column | [Column, condition: boolean | SQL] | null>): SQL;
+export declare function exclusiveNotNull(...columns: Column[]): SQL;
 /**
  * Generates a SQL `CASE ... WHEN ... END` statement for dynamic condition mapping based on an enumeration.
  *

package/orm/sqls.js

@@ -4,10 +4,10 @@
  * simplifying common SQL operations like generating UUIDs, working with intervals,
  * and aggregating data.
  */
-import { Column, eq, sql, isNotNull as sqlIsNotNull, Table } from 'drizzle-orm';
+import { and, Column, eq, sql, isNotNull as sqlIsNotNull, Table } from 'drizzle-orm';
 import { match, P } from 'ts-pattern';
-import { objectEntries } from '../utils/object/object.js';
-import { assertDefined, isDefined, isInstanceOf, isNull, isNumber, isString } from '../utils/type-guards.js';
+import { mapObjectValues, objectEntries, objectValues } from '../utils/object/object.js';
+import { assertDefined, isDefined, isInstanceOf, isNotNull, isNull, isNumber, isString } from '../utils/type-guards.js';
 import { getEnumName } from './enums.js';
 /** Drizzle SQL helper for getting the current transaction's timestamp. Returns a Date object. */
 export const TRANSACTION_TIMESTAMP = sql `transaction_timestamp()`;
@@ -24,7 +24,26 @@ export function enumValue(enumeration, dbEnum, value) {
     const enumType = isString(dbEnum) ? sql `"${sql.raw(dbEnum)}"` : dbEnum;
     return sql `'${sql.raw(String(value))}'::${enumType}`;
 }
-export function exclusiveNotNull(columns) {
+/**
+ * Generates a SQL condition that ensures exactly one of the specified columns is non-null and optional custom conditions.
+ * @param enumeration The enumeration object
+ * @param discriminator The column used to discriminate between different enumeration values
+ * @param conditionMapping An object mapping enumeration values to columns and conditions
+ */
+export function exclusiveReference(enumeration, discriminator, conditionMapping) {
+    const columns = objectValues(conditionMapping).filter(isNotNull).map((value) => isInstanceOf(value, Column) ? value : value[0]);
+    const mapping = mapObjectValues(conditionMapping, (value) => {
+        if (isInstanceOf(value, Column)) {
+            return value;
+        }
+        if (isNull(value)) {
+            return sql `FALSE`;
+        }
+        return value[1];
+    });
+    return and(exclusiveNotNull(...columns), enumerationCaseWhen(enumeration, discriminator, mapping));
+}
+export function exclusiveNotNull(...columns) {
     return eq(numNonNulls(...columns), sql.raw('1'));
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tstdl/base",
-  "version": "0.93.45",
+  "version": "0.93.47",
   "author": "Patrick Hein",
   "publishConfig": {
     "access": "public"