zibri 2.4.1 → 2.5.0

package/src/assets/asset.service.ts

@@ -58,7 +58,9 @@ export class AssetService implements AssetServiceInterface, OnAppInit {
         await inject(ZIBRI_DI_TOKENS.ROUTER).registerRoute({
             httpMethod: HttpMethod.GET,
             route: '/favicon.ico',
-            handler: () => FileResponse.fromPath(FsUtilities.getPath(this.publicAssetsPath, 'favicon.png'))
+            handler: () => FileResponse.fromPath(FsUtilities.getPath(this.publicAssetsPath, 'favicon.png')),
+            versions: 'all',
+            openApi: { useInOpenApi: false }
         });
 
     }

package/src/auth/2fa/methods/otp/otp-credentials.model.ts

@@ -27,7 +27,7 @@ export class OtpCredentials extends BaseEntity {
      * The two factor url that is needed to display a qr code.
      */
     @Property.string({ required: false })
-    qrCodeUrl: string | undefined;
+    qrCodeUrl: string | undefined | null;
 }
 
 /**

package/src/auth/2fa/methods/otp/otp.two-factor-method.ts

@@ -84,7 +84,7 @@ export class OtpTwoFactorMethod implements TwoFactorMethod<never, OtpConfirmRegi
     }
 
     private extractTokenFromRequestContext(context: HttpRequestContext | WebsocketRequestContext): string {
-        const code: string | undefined = context.request.headers[this.otpHeader];
+        const code: string | undefined = context.request.headers?.[this.otpHeader];
         if (!code) {
             throw new UnauthorizedError(`"${this.otpHeader}" header not found`);
         }

package/src/auth/strategies/cookie/cookie-auth.controller.ts

@@ -43,7 +43,7 @@ class CookieAuthRefreshLoginDto extends OmitClass(CookieAuthRefreshLoginData, ['
 
 class CookieAuthLogoutDto extends OmitClass(CookieAuthLogoutData, ['transaction']) {}
 
-@Controller('/auth', { allowOrphan: true })
+@Controller('/auth', { allowOrphan: true, versions: 'all' })
 export class CookieAuthController implements AuthControllerInterface<
     CookieAuthCredentialsDto,
     CookieAuthData<string>,

package/src/auth/strategies/jwt/jwt-auth.controller.ts

@@ -56,7 +56,7 @@ class JwtConfirmPasswordResetDto extends OmitClass(JwtConfirmPasswordResetData,
 
 class JwtRefreshLoginDto extends OmitClass(JwtRefreshLoginData, ['transaction']) {}
 
-@Controller('/auth', { allowOrphan: true })
+@Controller('/auth', { allowOrphan: true, versions: 'all' })
 export class JwtAuthController implements AuthControllerInterface<
     JwtCredentialsDto,
     JwtAuthData<string>,

package/src/auth/strategies/jwt/jwt.auth-strategy.ts

@@ -383,7 +383,7 @@ implements AuthStrategyInterface<
     private extractAccessTokenFromRequestContext(
         context: HttpRequestContext | WebsocketRequestContext
     ): string | undefined {
-        const authHeader: string | string[] | undefined = context.request.headers.authorization;
+        const authHeader: string | string[] | undefined = context.request.headers?.authorization;
         if (authHeader == undefined || typeof authHeader !== 'string') {
             return undefined;
         }

package/src/backup/backup-resource-entity.model.ts

@@ -18,7 +18,7 @@ export class BackupResourceEntity extends BaseEntity {
      * The size of the resource in bytes.
      */
     @Property.number({ required: false })
-    size: number | undefined;
+    size: number | undefined | null;
     /**
      * Whether or not the backup of this resource has been completed.
      */

package/src/backup/backup-service.test.ts

@@ -17,6 +17,7 @@ import { BaseEntity } from '../entity/base-entity.model';
 import { Entity } from '../entity/decorators/entity.decorator';
 import { Property } from '../entity/decorators/property.decorator';
 import { Newable } from '../types/newable.type';
+import { OmitStrict } from '../types/omit-strict.type';
 import { FsUtilities, FsPath } from '../utilities/fs.utilities';
 
 const backupFsFolder: FsPath = FsUtilities.getPath(testFileFolder, 'backups');
@@ -42,7 +43,7 @@ class Item {
 class DbDataSource extends PostgresDataSource {
     rootPw: string = 'password';
     rootUsername: string = 'postgres';
-    options: PostgresOptions = {
+    options: OmitStrict<PostgresOptions, 'type'> = {
         host: 'localhost',
         username: 'postgres',
         password: 'password',

package/src/change-sets/models/change-set.model.ts

@@ -26,7 +26,7 @@ export class ChangeSet extends BaseEntity {
      * The id of the user that changed something.
      */
     @Property.string({ format: 'uuid', required: false })
-    createdBy?: string;
+    createdBy?: string | null;
     /**
      * The things that have been changed.
      */

package/src/change-sets/models/change.model.ts

@@ -18,12 +18,12 @@ export class Change<T = unknown> extends BaseEntity {
      * The value before it was changed.
      */
     @Property.unknown({ required: false })
-    previousValue?: T;
+    previousValue?: T | null;
     /**
      * The value after it was changed.
      */
     @Property.unknown({ required: false })
-    newValue?: T;
+    newValue?: T | null;
     /**
      * The change set that this change belongs to.
      */

package/src/context/cache/cache.context.ts

@@ -24,10 +24,10 @@ export class CacheContext {
      * Whether or not the cache has been hit.
      */
     @Property.boolean({ required: false })
-    hit?: boolean;
+    hit?: boolean | null;
     /**
      * The duration that the original function took.
      */
     @Property.number({ required: false })
-    durationInMs?: number;
+    durationInMs?: number | null;
 }

package/src/context/request/request-context-token.model.ts

@@ -51,7 +51,7 @@ export const ZIBRI_REQUEST_CONTEXT_TOKENS = {
         'correlation_id',
         ctx => {
             const correlationIdHeader: string = inject(ZIBRI_DI_TOKENS.CORRELATION_ID_HEADER);
-            return ctx.request.headers[correlationIdHeader as KnownHeader] ?? UUIDUtilities.generate();
+            return ctx.request.headers?.[correlationIdHeader as KnownHeader] ?? UUIDUtilities.generate();
         }
     ),
     CURRENT_USER: new RequestContextToken(

package/src/cron/cron-job-entity.model.ts

@@ -43,13 +43,13 @@ export class CronJobEntity extends BaseEntity {
      * The timestamp at which this cron job has been last run.
      */
     @Property.date({ required: false })
-    lastRun!: Date | undefined;
+    lastRun?: Date | null;
 
     /**
      * The error message that this cron job failed with.
      */
     @Property.string({ required: false })
-    errorMessage!: string | undefined;
+    errorMessage?: string | null;
 }
 
 /**

package/src/data-source/data-sources/postgres-typeorm-data-source.model.ts

@@ -73,6 +73,16 @@ export abstract class PostgresDataSource extends TypeOrmBaseDataSource<PostgresO
         super(logger, authService);
     }
 
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    async init(): Promise<void> {
+        await super.init();
+        if (!this.ds) {
+            throw new DataSourceInitializationError();
+        }
+        // eslint-disable-next-line cspell/spellchecker
+        await this.ds.query('CREATE EXTENSION IF NOT EXISTS pg_trgm');
+    }
+
     // eslint-disable-next-line jsdoc/require-jsdoc
     query<T extends BaseEntity>(entityClass: Newable<T>, options?: QueryOptions): QueryBuilder<T> {
         if (!this.ds) {

package/src/data-source/data-sources/typeorm-base-data-source.model.ts

@@ -28,10 +28,9 @@ import { type LoggerInterface } from '../../logging/logger.interface';
 import { ExcludeStrict } from '../../types/exclude-strict.type';
 import { Newable } from '../../types/newable.type';
 import { OmitStrict } from '../../types/omit-strict.type';
-import { Version } from '../../types/version.type';
-import { compareVersion } from '../../utilities/compare-versions.function';
 import { MetadataUtilities } from '../../utilities/metadata.utilities';
 import { ObjectUtilities } from '../../utilities/object.utilities';
+import { SemVerUtilities, SemVerVersion } from '../../utilities/sem-ver.utilities';
 import { TypeOrmUtilities } from '../../utilities/typeorm.utilities';
 import { getDefaultBeforeReturnHook, getDefaultBeforeSaveHook } from '../hooks/hooks.default';
 import { MigrationEntity } from '../migration/migration-entity.model';
@@ -217,19 +216,19 @@ export abstract class TypeOrmBaseDataSource<TOptions extends DataSourceOptions>
         const finishedMigrationVersions: string[] = (await migrationsRepository.findAll()).map(m => m.version);
         const allMigrations: MigrationWithName[] = this.migrations.map(m => ({ migration: inject(m), name: m.name }));
 
-        const appVersion: Version | undefined = GlobalRegistry.getAppData('version');
+        const appVersion: SemVerVersion | undefined = GlobalRegistry.getAppData('version');
         if (!appVersion) {
             throw new Error('Couldn\'t run migrations: No app version could be resolved');
         }
 
         const migrationsToRunUp: MigrationWithName[] = allMigrations.filter(m => {
             return !finishedMigrationVersions.includes(m.migration.version)
-                && compareVersion(m.migration.version, appVersion) !== 'bigger';
+                && SemVerUtilities.compare(m.migration.version, appVersion) !== 'bigger';
         });
 
         const migrationsToRunDown: MigrationWithName[] = allMigrations.filter(m => {
             return finishedMigrationVersions.includes(m.migration.version)
-                && compareVersion(m.migration.version, appVersion) === 'bigger';
+                && SemVerUtilities.compare(m.migration.version, appVersion) === 'bigger';
         });
 
         for (const migration of migrationsToRunUp) {

package/src/data-source/data-sources/where-converter/postgres-typeorm-where-filter.converter.ts

@@ -1,7 +1,7 @@
 import { Raw, FindOperator, DataSource as ToDataSource } from 'typeorm';
 import { RelationMetadata as ToRelationMetadata } from 'typeorm/metadata/RelationMetadata.js';
 
-import { TypeOrmWhereFilterConverter } from './typeorm-where-filter.converter';
+import { TypeOrmWhereFilterConverter, WhereFilterHandler } from './typeorm-where-filter.converter';
 import { BaseEntity } from '../../../entity/base-entity.model';
 import { EntityMetadata } from '../../../entity/decorators/entity.decorator';
 import { PropertyMetadata, RelationMetadata } from '../../../entity/decorators/property.decorator';
@@ -9,6 +9,7 @@ import { EntityMetadataMissingError } from '../../../entity/entity-metadata-miss
 import { Relation } from '../../../entity/models/relation.enum';
 import { Newable } from '../../../types/newable.type';
 import { MetadataUtilities } from '../../../utilities/metadata.utilities';
+import { NumberUtilities } from '../../../utilities/number.utilities';
 import { WhereFilterKeys } from '../../models/where/where-filter-keys.model';
 import { Where } from '../../models/where/where-filter.model';
 
@@ -32,7 +33,7 @@ type JsonbOperatorHandler = (
  */
 export class PostgresTypeOrmWhereFilterConverter extends TypeOrmWhereFilterConverter {
 
-    private readonly jsonbOperatorHandlers: Record<string, JsonbOperatorHandler> = {
+    private readonly jsonbOperatorHandlers: Record<WhereFilterKeys, JsonbOperatorHandler> = {
         is: (jp, _tp, _cp, val) => val === null
             ? `${jp} = 'null'::jsonb`
             : `${jp} @> ${this.toJsonbLiteral(val as object)}`,
@@ -59,12 +60,27 @@ export class PostgresTypeOrmWhereFilterConverter extends TypeOrmWhereFilterConve
         },
         like: (_jp, tp, _cp, val) => `${tp} LIKE ${this.toSqlLiteral(val)}`,
         iLike: (_jp, tp, _cp, val) => `${tp} ILIKE ${this.toSqlLiteral(val)}`,
+        fuzzyLike: (_jp, tp, _cp, val) => {
+            if (typeof val !== 'object' || !('value' in (val as object))) {
+                throw new Error('fuzzyLike expects an object with a "value" property');
+            }
+            const { value: searchString, minSimilarity = 0.3 } = val as {
+                // eslint-disable-next-line jsdoc/require-jsdoc
+                value: string,
+                // eslint-disable-next-line jsdoc/require-jsdoc
+                minSimilarity?: number
+            };
+            const safeSearch: string = this.toSqlLiteral(searchString);
+            return `similarity(${tp}, ${safeSearch}) >= ${NumberUtilities.divide(minSimilarity, 100)}`;
+        },
         greaterThan: (_jp, _tp, cp, val) => `${cp} > ${this.toSqlLiteral(val)}`,
         after: (_jp, _tp, cp, val) => `${cp} > ${this.toSqlLiteral(val)}`,
         greaterThanEquals: (_jp, _tp, cp, val) => `${cp} >= ${this.toSqlLiteral(val)}`,
+        afterOrOn: (_jp, _tp, cp, val) => `${cp} >= ${this.toSqlLiteral(val)}`,
         lesserThan: (_jp, _tp, cp, val) => `${cp} < ${this.toSqlLiteral(val)}`,
         before: (_jp, _tp, cp, val) => `${cp} < ${this.toSqlLiteral(val)}`,
         lesserThanEquals: (_jp, _tp, cp, val) => `${cp} <= ${this.toSqlLiteral(val)}`,
+        beforeOrOn: (_jp, _tp, cp, val) => `${cp} <= ${this.toSqlLiteral(val)}`,
         length: (jp, _tp, _cp, val) => `jsonb_array_length(${jp}) = ${this.toSqlLiteral(val)}`,
         lengthGreaterThan: (jp, _tp, _cp, val) => `jsonb_array_length(${jp}) > ${this.toSqlLiteral(val)}`,
         lengthGreaterThanEquals: (jp, _tp, _cp, val) => `jsonb_array_length(${jp}) >= ${this.toSqlLiteral(val)}`,
@@ -89,6 +105,23 @@ export class PostgresTypeOrmWhereFilterConverter extends TypeOrmWhereFilterConve
         super(dataSource);
     }
 
+    // eslint-disable-next-line jsdoc/require-jsdoc
+    protected fuzzyLikeWhereFilterHandler: WhereFilterHandler = (value) => {
+        if (typeof value !== 'object' || value === null || !('value' in value)) {
+            throw new Error('fuzzyLike expects an object with a "value" property');
+        }
+        const { value: searchString, minSimilarity = 30 } = value as {
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            value: string,
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            minSimilarity?: number
+        };
+        const safeSearch: string = this.toSqlLiteral(searchString); // produces e.g. 'hello'
+        return Raw(
+            alias => `similarity(${alias}, ${safeSearch}) >= ${NumberUtilities.divide(minSimilarity, 100)}`
+        );
+    };
+
     // ── JSONB-aware "where" handler ─────────────────────────────
 
     // eslint-disable-next-line jsdoc/require-jsdoc

package/src/data-source/data-sources/where-converter/typeorm-where-filter.converter.ts

@@ -34,6 +34,12 @@ export type WhereFilterHandler = (
  * Abstract base converter that transforms a Zibri WhereFilter into a TypeORM FindOptionsWhere.
  */
 export abstract class TypeOrmWhereFilterConverter {
+
+    /**
+     * Handler for a fuzzyLike filter.
+     */
+    protected abstract fuzzyLikeWhereFilterHandler: WhereFilterHandler;
+
     /**
      * A map that defines how Zibri's where filter properties are mapped to their typeorm counterpart.
      */
@@ -54,11 +60,19 @@ export abstract class TypeOrmWhereFilterConverter {
         },
         after: (value) => MoreThan(value),
         before: (value) => LessThan(value),
+        afterOrOn: (value) => MoreThanOrEqual(value),
+        beforeOrOn: (value) => LessThanOrEqual(value),
         greaterThan: (value) => MoreThan(value),
         greaterThanEquals: (value) => MoreThanOrEqual(value),
         lesserThan: (value) => LessThan(value),
         lesserThanEquals: (value) => LessThanOrEqual(value),
         iLike: (value) => ILike(value),
+        fuzzyLike: (value, metadata, nestedProperties, entityClass) => this.fuzzyLikeWhereFilterHandler(
+            value,
+            metadata,
+            nestedProperties,
+            entityClass
+        ),
         is: (value, metadata) => {
             if (value === null) {
                 return IsNull();
@@ -67,7 +81,6 @@ export abstract class TypeOrmWhereFilterConverter {
             if (
                 (metadata.type === Relation.MANY_TO_ONE
                     || metadata.type === Relation.BELONGS_TO_ONE)
-                && value !== null
                 && typeof value === 'object'
                 && !Array.isArray(value)
                 && 'id' in value

package/src/data-source/hooks/hooks.test.ts

@@ -33,7 +33,7 @@ class HookTestEntity extends BaseEntity implements ChangeSetEntity, SoftDeleteEn
     isActive!: boolean; // default value set on create
 
     @Property.string({ required: false, excludeFromChangeSets: true })
-    internalNote?: string; // excluded from change sets
+    internalNote?: string | null; // excluded from change sets
 
     @Property.boolean({ default: false })
     deleted!: boolean; // required by SoftDeleteEntity

package/src/data-source/migration/migration-entity.model.ts

@@ -1,7 +1,7 @@
 import { BaseEntity } from '../../entity/base-entity.model';
 import { Entity } from '../../entity/decorators/entity.decorator';
 import { Property } from '../../entity/decorators/property.decorator';
-import { type Version } from '../../types/version.type';
+import { type SemVerVersion } from '../../utilities/sem-ver.utilities';
 
 /**
  * The migration entity that is stored in the db.
@@ -18,7 +18,7 @@ export class MigrationEntity extends BaseEntity {
      * The version at which this migration should run.
      */
     @Property.string({ unique: true })
-    version!: Version;
+    version!: SemVerVersion;
 
     /**
      * The timestamp at which the migration ran.

package/src/data-source/migration/migration.model.ts

@@ -2,7 +2,7 @@ import { MigrationEntity } from './migration-entity.model';
 import { repositoryTokenFor } from '../../di/decorators/inject-repository.decorator';
 import { inject } from '../../di/inject.function';
 import { Newable } from '../../types/newable.type';
-import { Version } from '../../types/version.type';
+import { SemVerVersion } from '../../utilities/sem-ver.utilities';
 import { DataSourceInterface } from '../data-sources/data-source.interface';
 import { Repository } from '../repository';
 import { Transaction } from '../transaction/transaction.model';
@@ -11,7 +11,7 @@ import { Transaction } from '../transaction/transaction.model';
  * Base class for a data source migration.
  */
 export abstract class Migration {
-    abstract readonly version: Version;
+    abstract readonly version: SemVerVersion;
     /**
      * The data source that the migration is for.
      */

package/src/data-source/migration/migration.test.ts

@@ -20,7 +20,7 @@ import { Property } from '../../entity/decorators/property.decorator';
 import { GlobalRegistry } from '../../global/global-registry';
 import { Newable } from '../../types/newable.type';
 import { OmitStrict } from '../../types/omit-strict.type';
-import { Version } from '../../types/version.type';
+import { SemVerVersion } from '../../types/version.type';
 import { PostgresDataSource, PostgresOptions } from '../data-sources/postgres-typeorm-data-source.model';
 import { DataSource } from '../decorators/data-source.decorator';
 import { Repository } from '../repository';
@@ -68,7 +68,7 @@ class DbDataSource extends PostgresDataSource {
 
 @Injectable()
 class AddTestValueMigration extends Migration {
-    version: Version = '0.0.1';
+    version: SemVerVersion = '0.0.1';
 
     constructor(
         @InjectRepository(Item)

package/src/data-source/models/where/date-where-filter.model.ts

@@ -5,13 +5,21 @@ import { BaseWhereFilter, BaseWhereFilterObject } from './base-where-filter.mode
  */
 type DateFilterWhereObject = BaseWhereFilterObject<Date> & {
     /**
-     * The property needs to be after the value.
+     * The property needs to be after the date.
      */
     after?: Date,
     /**
-     * The property needs to be before the value.
+     * The property needs to be before the date.
      */
-    before?: Date
+    before?: Date,
+    /**
+     * The property needs to be after or on the date.
+     */
+    afterOrOn?: Date,
+    /**
+     * The property needs to be before or on the date.
+     */
+    beforeOrOn?: Date
 };
 
 /**

package/src/data-source/models/where/string-where-filter.model.ts

@@ -1,4 +1,6 @@
 import { BaseWhereFilter, BaseWhereFilterObject } from './base-where-filter.model';
+import { ExcludeStrict } from '../../../types/exclude-strict.type';
+import { Percentage } from '../../../types/percentage.type';
 
 /**
  * The string where filter object.
@@ -13,7 +15,22 @@ type StringWhereFilterObject = BaseWhereFilterObject<string> & {
      * The property needs to be like the provided string, ignoring case.
      * @example '%.cOm'
      */
-    iLike?: string
+    iLike?: string,
+    /**
+     * The property needs to fuzzily be like the provided string so that eg. Typos don't matter.
+     */
+    fuzzyLike?: {
+        /**
+         * The search value.
+         */
+        value: string,
+        /**
+         * The minimum similarity that the search term must have as a percentage between 1 and 99.
+         *
+         * 1 matches almost everything while 99 is basically just a strict equal.
+         */
+        minSimilarity?: ExcludeStrict<Percentage, 0 | 100>
+    }
 };
 
 /**

package/src/data-source/models/where/where-filter-keys.model.ts

@@ -60,12 +60,15 @@ const whereFilterKeysRecord: Record<WhereFilterKeys, WhereFilterKeys> = {
     oneOf: 'oneOf',
     notOneOf: 'notOneOf',
     after: 'after',
+    afterOrOn: 'afterOrOn',
     before: 'before',
+    beforeOrOn: 'beforeOrOn',
     greaterThan: 'greaterThan',
     greaterThanEquals: 'greaterThanEquals',
     lesserThan: 'lesserThan',
     lesserThanEquals: 'lesserThanEquals',
     iLike: 'iLike',
+    fuzzyLike: 'fuzzyLike',
     is: 'is',
     where: 'where',
     includes: 'includes',

package/src/data-source/nested-where-filter.test.ts

@@ -20,7 +20,7 @@ class Address {
     city!: string;
 
     @Property.string({ required: false })
-    type?: string; // 'home', 'work', etc.
+    type?: string | null; // 'home', 'work', etc.
 }
 
 class PersonalData {
@@ -182,7 +182,6 @@ describe('Where filters – deeply nested (object → array → object)', () =>
 
     // ===== Array of objects: includes (contains) – requires feature, skip for now =====
     it('array includes (contains all specified objects)', async () => {
-        // TODO: implement partial object match in includes for object arrays
         const res: Customer[] = await customerRepo.findAll({
             where: {
                 personalData: {
@@ -197,7 +196,6 @@ describe('Where filters – deeply nested (object → array → object)', () =>
 
     // ===== Array of objects: nested where on items (if supported) =====
     it('array item where filter', async () => {
-        // TODO: implement 'where' on array items to filter by item properties
         const res: Customer[] = await customerRepo.findAll({
             where: {
                 personalData: {
@@ -340,5 +338,12 @@ describe('Where filters – deeply nested (object → array → object)', () =>
             });
             expect(res.map(c => c.id)).toEqual([container2.id]);
         });
+
+        it('fuzzyLike on title', async () => {
+            const res: Container[] = await containerRepo.findAll({
+                where: { title: { fuzzyLike: { value: 'Cont', minSimilarity: 30 } } }
+            });
+            expect(res.map(c => c.id)).toEqual(expect.arrayContaining([container.id, container2.id]));
+        });
     });
 });

package/src/data-source/repository.test.ts

@@ -87,7 +87,7 @@ class User extends BaseEntity {
     company!: Company;
 
     @Property.string({ format: 'uuid', required: false })
-    companyId!: string;
+    companyId?: string | null;
 
     @Property.oneToMany({ target: () => Post, inverseSide: 'author' })
     posts!: Post[];
@@ -96,7 +96,7 @@ class User extends BaseEntity {
     profile!: Profile;
 
     @Property.string({ format: 'uuid', required: false })
-    profileId!: string;
+    profileId?: string | null;
 
     @Property.manyToMany({ target: () => Group, inverseSide: 'members', joinTable: true })
     groups!: Group[];

package/src/data-source/where-filter.test.ts

@@ -152,6 +152,23 @@ describe('Where filters', () => {
             expect(res.map(p => p.id)).toEqual([prodA.id]);
         });
 
+        it('fuzzyLike', async () => {
+            // eslint-disable-next-line cspell/spellchecker
+            // "Alpha" and "Beta" are seeded. A fuzzy search for "Alpah" (typo) should still match.
+            const res: Product[] = await productRepo.findAll({
+                // eslint-disable-next-line cspell/spellchecker
+                where: { name: { fuzzyLike: { value: 'Alpah', minSimilarity: 30 } } }
+            });
+            expect(res.map(p => p.id)).toEqual([prodA.id]);
+        });
+
+        it('fuzzyLike with low similarity returns nothing', async () => {
+            const res: Product[] = await productRepo.findAll({
+                where: { name: { fuzzyLike: { value: 'Zzzz', minSimilarity: 90 } } }
+            });
+            expect(res).toHaveLength(0);
+        });
+
         it('null', async () => {
             await productRepo.updateById(prodA.id, { name: null }); // set to null
             const res: Product[] = await productRepo.findAll({ where: { name: null } });
@@ -406,13 +423,6 @@ describe('Where filters', () => {
             const res: Product[] = await productRepo.findAll({ where: { category: { is: catFood } } });
             expect(res.map(p => p.id)).toEqual([prodFood.id]);
         });
-
-        // TODO
-        // it('null (no category)', async () => {
-        //     await productRepo.updateById(prodFood.id, { category: null });
-        //     const res: Product[] = await productRepo.findAll({ where: { category: null } });
-        //     expect(res.map(p => p.id)).toEqual([prodFood.id]);
-        // });
     });
 
     // =================== ARRAY OF OBJECTS (Review[]) ===================

package/src/di/default/zibri-di-providers.default.ts

@@ -25,6 +25,7 @@ import { DataSourceService } from '../../data-source/data-source.service';
 import { EmailService } from '../../email/email.service';
 import { errorHandler } from '../../error-handling/error-handler';
 import { EventService } from '../../event/event.service';
+import { KnownHeader } from '../../http/known-header.enum';
 import { HttpClient } from '../../http-client/http-client';
 import { LocalizeOptionsInput } from '../../localization/models/localize-options.model';
 import { LogLevel } from '../../logging/log-level.enum';
@@ -39,6 +40,7 @@ import { Router } from '../../routing/router';
 import { FsUtilities } from '../../utilities/fs.utilities';
 import { Ms } from '../../utilities/ms';
 import { ValidationService } from '../../validation/validation.service';
+import { VersioningService } from '../../versioning/versioning.service';
 import { WebsocketService } from '../../websocket/services/websocket.service';
 import { DiTokenProviderRecord } from '../models/di-token.model';
 
@@ -147,6 +149,8 @@ export const ZIBRI_DI_PROVIDERS: DiTokenProviderRecord<typeof ZIBRI_DI_TOKENS> =
     ENCRYPTION_STRATEGIES: { useValue: [AesGcmEncryptionStrategy] },
     ENCRYPTION_MASTER_OPTIONS: { useValue: undefined },
     CACHE_SERVICE: { useClass: CacheService },
+    VERSIONING_SERVICE: { useClass: VersioningService },
+    VERSION_HEADER: { useValue: KnownHeader.X_VERSION },
     // dynamic
     CURRENT_REQUEST_CONTEXT: {
         useFactory: () => AlsUtilities.getCurrentRequestContext(),

package/src/di/default/zibri-di-tokens.default.ts

@@ -38,6 +38,7 @@ import { RouterInterface } from '../../routing/router.interface';
 import { Newable } from '../../types/newable.type';
 import { FsPath } from '../../utilities/fs.utilities';
 import { ValidationServiceInterface } from '../../validation/validation-service.interface';
+import { VersioningServiceInterface } from '../../versioning/versioning-service.interface';
 import { WebsocketOptions } from '../../websocket/models/websocket-options.model';
 import { WebsocketServiceInterface } from '../../websocket/services/websocket-service.interface';
 import { TokenRecord } from '../models/di-token.model';
@@ -115,6 +116,8 @@ export const ZIBRI_DI_TOKENS = {
         'zi.encryption_master_options'
     ),
     CACHE_SERVICE: ziToken<CacheServiceInterface>('zi.cache_service'),
+    VERSIONING_SERVICE: ziToken<VersioningServiceInterface>('zi.versioning_service'),
+    VERSION_HEADER: ziToken<string>('zi.version_header'),
     // dynamic/context based tokens
     CURRENT_REQUEST_CONTEXT: ziToken<HttpRequestContext | WebsocketRequestContext | undefined>('zi.current_request_context'),
     DEFAULT_CSP_OPTIONS: ziToken<CspOptions>('zi.default_csp_options'),

package/src/email/email.service.ts

@@ -101,15 +101,15 @@ export class EmailService implements EmailServiceInterface, OnAppInit, OnAppShut
      * @param email - The email to send out.
      */
     protected async send(email: Email): Promise<void> {
-        await this.validateAttachments(email.attachments);
+        await this.validateAttachments(email.attachments ?? undefined);
         const res: SMTPTransport.SentMessageInfo = await this.transporter.sendMail({
             html: email.html,
             subject: email.subject,
             from: email.sender,
             to: email.recipients,
-            bcc: email.bcc,
-            cc: email.cc,
-            attachments: email.attachments
+            bcc: email.bcc ?? undefined,
+            cc: email.cc ?? undefined,
+            attachments: email.attachments ?? undefined
         });
 
         const status: EmailStatus = res.rejected.length ? EmailStatus.FAILED : EmailStatus.SENT;
@@ -132,7 +132,7 @@ export class EmailService implements EmailServiceInterface, OnAppInit, OnAppShut
      * @param attachments - The attachments to resolve.
      * @returns The resolved attachments.
      */
-    protected async validateAttachments(attachments: EmailAttachment[] | undefined): Promise<void> {
+    protected async validateAttachments(attachments: EmailAttachment[] | undefined | null): Promise<void> {
         if (!attachments?.length) {
             return;
         }