@lenne.tech/nest-server 12.0.0 → 12.1.0

package/dist/core/common/persistence/sql/sql-cast.js

@@ -0,0 +1,194 @@
+import { isObjectIdLike } from '../../helpers/id.helper.js';
+import { QueryCastError } from './sql-errors.js';
+export function castFilterValue(field, path, value, setters = true) {
+    const kind = field.kind === 'enum' ? (field.enumBase ?? 'string') : field.kind;
+    switch (kind) {
+        case 'bigint':
+            return castBigInt(path, value);
+        case 'boolean':
+            return castBoolean(path, value);
+        case 'date':
+            return castDate(path, value);
+        case 'decimal':
+            return castDecimal(path, value);
+        case 'id':
+            return castObjectId(path, value);
+        case 'number':
+            return castNumber(path, value);
+        case 'ref':
+            return castRef(path, value);
+        case 'string':
+            return castString(field, path, value, setters);
+        case 'uuid':
+            return castUuid(path, value);
+        default:
+            return value === undefined ? null : value;
+    }
+}
+function castNumber(path, value) {
+    if (isNullish(value) || value === '') {
+        return null;
+    }
+    const result = typeof value === 'string' || typeof value === 'boolean'
+        ? Number(value)
+        : typeof value === 'number'
+            ? value
+            : isBoxedNumber(value)
+                ? Number(value)
+                : Number.NaN;
+    if (Number.isNaN(result)) {
+        throw new QueryCastError(path, 'Number', value);
+    }
+    return result;
+}
+const TRUE_VALUES = new Set([true, 'true', 1, '1', 'yes']);
+const FALSE_VALUES = new Set([false, 'false', 0, '0', 'no']);
+function castBoolean(path, value) {
+    if (TRUE_VALUES.has(value)) {
+        return true;
+    }
+    if (FALSE_VALUES.has(value)) {
+        return false;
+    }
+    if (isNullish(value)) {
+        return null;
+    }
+    throw new QueryCastError(path, 'Boolean', value);
+}
+function castDate(path, value) {
+    if (isNullish(value) || value === '') {
+        return null;
+    }
+    if (typeof value === 'boolean') {
+        throw new QueryCastError(path, 'Date', value);
+    }
+    let date;
+    if (value instanceof Date) {
+        date = value;
+    }
+    else if (typeof value === 'number' || isBoxedNumber(value)) {
+        date = new Date(Number(value));
+    }
+    else if (typeof value === 'string' && !Number.isNaN(Number(value))) {
+        const asNumber = Number(value);
+        date = asNumber >= 275761 || asNumber < -271820 ? new Date(asNumber) : new Date(value);
+    }
+    else if (typeof value === 'string') {
+        date = new Date(value);
+    }
+    else {
+        throw new QueryCastError(path, 'Date', value);
+    }
+    if (Number.isNaN(date.valueOf())) {
+        throw new QueryCastError(path, 'Date', value);
+    }
+    return date;
+}
+function castString(field, path, value, setters) {
+    if (isNullish(value)) {
+        return null;
+    }
+    let result;
+    if (typeof value._id === 'string') {
+        result = value._id;
+    }
+    else if (typeof value === 'string' ||
+        (typeof value.toString === 'function' &&
+            value.toString !== Object.prototype.toString &&
+            !Array.isArray(value))) {
+        result = String(value);
+    }
+    else {
+        throw new QueryCastError(path, 'String', value);
+    }
+    if (setters) {
+        if (field.lowercase) {
+            result = result.toLowerCase();
+        }
+        if (field.trim) {
+            result = result.trim();
+        }
+    }
+    return result;
+}
+const OBJECT_ID_HEX = /^[0-9a-f]{24}$/i;
+function castObjectId(path, value) {
+    if (isNullish(value)) {
+        return null;
+    }
+    const candidate = idCandidate(value);
+    if (typeof candidate === 'string' && OBJECT_ID_HEX.test(candidate)) {
+        return candidate.toLowerCase();
+    }
+    throw new QueryCastError(path, 'ObjectId', value);
+}
+function castRef(path, value) {
+    if (isNullish(value)) {
+        return null;
+    }
+    const candidate = idCandidate(value);
+    if (typeof candidate === 'string') {
+        return OBJECT_ID_HEX.test(candidate) ? candidate.toLowerCase() : candidate;
+    }
+    throw new QueryCastError(path, 'ObjectId', value);
+}
+function idCandidate(value) {
+    if (isObjectIdLike(value)) {
+        return value.toHexString();
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    const nested = value?._id ?? value?.id;
+    if (isObjectIdLike(nested)) {
+        return nested.toHexString();
+    }
+    return typeof nested === 'string' ? nested : undefined;
+}
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function castUuid(path, value) {
+    if (isNullish(value)) {
+        return null;
+    }
+    const text = typeof value === 'string' ? value : String(value?.toString?.());
+    if (UUID.test(text)) {
+        return text.toLowerCase();
+    }
+    throw new QueryCastError(path, 'UUID', value);
+}
+function castBigInt(path, value) {
+    if (isNullish(value) || value === '') {
+        return null;
+    }
+    try {
+        if (typeof value === 'bigint') {
+            return value.toString();
+        }
+        if (typeof value === 'number' && Number.isInteger(value)) {
+            return BigInt(value).toString();
+        }
+        if (typeof value === 'string' && /^-?\d+$/.test(value.trim())) {
+            return BigInt(value.trim()).toString();
+        }
+    }
+    catch {
+    }
+    throw new QueryCastError(path, 'BigInt', value);
+}
+function castDecimal(path, value) {
+    if (isNullish(value) || value === '') {
+        return null;
+    }
+    const text = typeof value === 'number' ? String(value) : typeof value === 'string' ? value.trim() : String(value);
+    if (/^-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/i.test(text)) {
+        return text;
+    }
+    throw new QueryCastError(path, 'Decimal128', value);
+}
+function isNullish(value) {
+    return value === null || value === undefined;
+}
+function isBoxedNumber(value) {
+    return Object.prototype.toString.call(value) === '[object Number]' && typeof value === 'object';
+}
+//# sourceMappingURL=sql-cast.js.map

package/dist/core/common/persistence/sql/sql-cast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-cast.js","sourceRoot":"","sources":["../../../../../src/core/common/persistence/sql/sql-cast.ts"],"names":[],"mappings":"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"}

package/dist/core/common/persistence/sql/sql-data-store.d.ts

@@ -0,0 +1,79 @@
+import { Logger } from '@nestjs/common';
+import type { DataStore, DataStoreUpdate, FindOptions, PushOptions, StoreCapabilities, StoredRecord, UpdateOptions, Where } from '../data-store.interface.js';
+import type { FieldDescriptor, ModelDescriptor } from '../model-descriptor.interface.js';
+import type { DeclaredSchema } from '../mongo/model-declarations.js';
+import type { SqlExecutor, SqlStatement } from './sql-executor.interface.js';
+import { SqlParams } from './sql-naming.js';
+export declare const POSTGRES_STORE_CAPABILITIES: Readonly<StoreCapabilities>;
+export interface SqlDataStoreOptions {
+    schema?: DeclaredSchema | {
+        path(name: string): any;
+    };
+}
+export declare class SqlDataStore<T = Record<string, any>> implements DataStore<T> {
+    protected readonly executor: SqlExecutor;
+    protected readonly model: ModelDescriptor;
+    protected readonly options: SqlDataStoreOptions;
+    readonly capabilities: Readonly<StoreCapabilities>;
+    readonly driver: string;
+    protected readonly logger: Logger;
+    protected readonly table: string;
+    protected readonly fields: Map<string, FieldDescriptor>;
+    protected collationWarned: boolean;
+    constructor(executor: SqlExecutor, model: ModelDescriptor, options?: SqlDataStoreOptions);
+    get modelName(): string;
+    count(where?: Where<T>): Promise<number>;
+    sum(field: string, where?: Where<T>): Promise<{
+        count: number;
+        sum: number;
+    }>;
+    distinct(field: string, where?: Where<T>): Promise<unknown[]>;
+    find(where?: Where<T>, options?: FindOptions): Promise<StoredRecord<T>[]>;
+    findById(id: string, options?: Pick<FindOptions, 'exclude' | 'select'>): Promise<null | StoredRecord<T>>;
+    findOne(where: Where<T>, options?: Omit<FindOptions, 'limit' | 'skip'>): Promise<null | StoredRecord<T>>;
+    protected insertValues(doc: Record<string, any>, params: SqlParams): {
+        columns: string[];
+        id: string;
+        values: string[];
+    };
+    insert(record: Partial<T>): Promise<StoredRecord<T>>;
+    updateById(id: string, update: DataStoreUpdate<T>, options?: UpdateOptions): Promise<null | StoredRecord<T>>;
+    updateOne(where: Where<T>, update: DataStoreUpdate<T>): Promise<null | StoredRecord<T>>;
+    deleteById(id: string): Promise<null | StoredRecord<T>>;
+    deleteMany(where: Where<T>): Promise<number>;
+    deleteOne(where: Where<T>): Promise<null | StoredRecord<T>>;
+    updateMany(where: Where<T>, update: DataStoreUpdate<T>): Promise<number>;
+    pushToArray(id: string, field: string, items: readonly unknown[], options?: PushOptions): Promise<void>;
+    pullFromArray(id: string, field: string, condition: unknown): Promise<void>;
+    native<N = unknown>(reason: string): N;
+    raw<N = unknown>(reason: string): N;
+    protected beforeInsert(doc: Record<string, any>): Promise<Record<string, any>>;
+    protected beforeUpdate(update: Record<string, any>, options?: UpdateOptions): Promise<Record<string, any>>;
+    protected preparePatch(update: DataStoreUpdate<T>, options?: UpdateOptions): Promise<Record<string, any>>;
+    private dropUndeclared;
+    protected where(where: undefined | Where<T>, params: SqlParams): string;
+    protected compileWhere(where: Where, params: SqlParams): string;
+    protected exists(where: undefined | Where<T>): Promise<boolean>;
+    protected run<R = Record<string, any>>(statement: SqlStatement): Promise<{
+        rowCount: number;
+        rows: R[];
+    }>;
+    protected updateColumn(id: string, column: string, value: string, params: SqlParams): Promise<void>;
+    protected selectList(select?: readonly string[], exclude?: readonly string[]): string;
+    protected quote(name: string): string;
+    protected compileUpdate(update: DataStoreUpdate, params: SqlParams): string[];
+    protected orderBy(options: FindOptions, params: SqlParams): string;
+    protected itemOrder(sort: Record<string, -1 | 1> | number, params: SqlParams): string;
+    protected toColumn(field: FieldDescriptor, path: string, value: unknown, params: SqlParams): string;
+    protected castItem(field: FieldDescriptor, path: string, item: unknown): unknown;
+    protected fromColumn(field: FieldDescriptor, value: unknown): unknown;
+    protected toRecords(rows: Record<string, any>[], select?: readonly string[]): StoredRecord<T>[];
+    protected arrayField(field: string, method: string): FieldDescriptor;
+    private applyFunctionDefaults;
+    private auditFields;
+    private timestampFields;
+    private passwordEnabled;
+    protected roleGuardEnabled(): boolean;
+    private auditEnabled;
+    protected mapError(error: unknown): unknown;
+}