@elysiumjs/mnemosyne 0.1.2 → 0.3.1

package/src/keyv-redis.ts

@@ -1,313 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { KeyvStoreAdapter } from 'cacheable';
-import type { KeyvEntry, StoredData } from 'keyv';
-
-import { EventEmitter } from 'node:events';
-
-import { Event, Redis } from '@elysiumjs/core';
-
-/**
- * Keyv adapter for redis. This adapter is based on the Bun's Redis client.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class KeyvRedis extends EventEmitter implements KeyvStoreAdapter {
-	#client?: Bun.RedisClient;
-	#namespace: string | undefined;
-	#keyPrefixSeparator = '::';
-	#clearBatchSize = 1000;
-	#useUnlink = true;
-	#noNamespaceAffectsAll = false;
-
-	#connection: string;
-
-	constructor(props: {
-		/**
-		 * The Redis connection to use.
-		 */
-		connection: string;
-
-		/**
-		 * Namespace for the connection.
-		 */
-		namespace?: string;
-
-		/**
-		 * Separator to use between namespace and key.
-		 */
-		keyPrefixSeparator?: string;
-
-		/**
-		 * Number of keys to delete in a single batch.
-		 */
-		clearBatchSize?: number;
-
-		/**
-		 * Enable Unlink instead of using Del for clearing keys. This is more performant but may not be supported by all Redis versions.
-		 */
-		useUnlink?: boolean;
-
-		/**
-		 * Whether to allow clearing all keys when no namespace is set.
-		 * If set to true and no namespace is set, iterate() will return all keys.
-		 * Defaults to `false`.
-		 */
-		noNamespaceAffectsAll?: boolean;
-	}) {
-		super();
-
-		Event.once('elysium:app:launched', () => {
-			this.#client = Redis.getConnection(props.connection);
-		});
-
-		this.#connection = props.connection;
-		this.#namespace = props.namespace;
-		this.#keyPrefixSeparator = props.keyPrefixSeparator ?? '::';
-		this.#clearBatchSize = props.clearBatchSize ?? 1000;
-		this.#useUnlink = props.useUnlink ?? true;
-		this.#noNamespaceAffectsAll = props.noNamespaceAffectsAll ?? false;
-
-		this.on('error', (error) => {
-			Event.emit('elysium:error', error);
-		});
-	}
-
-	public get client() {
-		return this.#client!;
-	}
-
-	/**
-	 * Get the options for the adapter.
-	 */
-	public get opts() {
-		return {
-			namespace: this.#namespace,
-			keyPrefixSeparator: this.#keyPrefixSeparator,
-			clearBatchSize: this.#clearBatchSize,
-			noNamespaceAffectsAll: this.#noNamespaceAffectsAll,
-			dialect: 'redis',
-			url: this.#connection
-		};
-	}
-
-	/**
-	 * Gets the namespace for the adapter. If undefined, it will not use a namespace including keyPrefixing.
-	 * @default undefined
-	 */
-	public get namespace(): string | undefined {
-		return this.#namespace;
-	}
-
-	/**
-	 * Sets the namespace for the adapter. If undefined, it will not use a namespace including keyPrefixing.
-	 */
-	public set namespace(value: string | undefined) {
-		this.#namespace = value;
-	}
-
-	public async get<Value>(key: string): Promise<StoredData<Value> | undefined> {
-		key = this.createKeyPrefix(key, this.#namespace);
-		const value = await this.client.get(key);
-
-		return value === null ? undefined : (value as Value);
-	}
-
-	public async set(key: string, value: any, ttl?: number) {
-		key = this.createKeyPrefix(key, this.#namespace);
-
-		if (ttl) {
-			await this.client.set(key, value, 'PX', ttl);
-		} else {
-			await this.client.set(key, value);
-		}
-	}
-
-	public async setMany(values: Array<KeyvEntry>): Promise<void> {
-		// TODO: Use MULTI when available in Bun
-		const multi = [];
-
-		for (const { key, value, ttl } of values) {
-			const prefixedKey = this.createKeyPrefix(key, this.#namespace);
-			if (ttl) {
-				// eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/no-unsafe-argument
-				multi.push(this.client.set(prefixedKey, value, 'PX', ttl));
-			} else {
-				// eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-				multi.push(this.client.set(prefixedKey, value));
-			}
-		}
-
-		await Promise.all(multi);
-	}
-
-	public async delete(key: string): Promise<boolean> {
-		key = this.createKeyPrefix(key, this.#namespace);
-		// TODO: Use UNLINK when available in Bun
-		const deleted = await (this.#useUnlink
-			? this.client.send('UNLINK', [key])
-			: this.client.del(key));
-
-		return deleted > 0;
-	}
-
-	public async clear(): Promise<void> {
-		try {
-			if (!this.#namespace && this.#noNamespaceAffectsAll) {
-				await this.client.send('FLUSHDB', []);
-				return;
-			}
-
-			let cursor = '0';
-			const batchSize = this.#clearBatchSize;
-			const match = this.#namespace ? `${this.#namespace}${this.#keyPrefixSeparator}*` : '*';
-			const deletePromises = [];
-
-			do {
-				const result = await this.client.send('SCAN', [
-					cursor,
-					'MATCH',
-					match,
-					'COUNT',
-					batchSize.toString(),
-					'TYPE',
-					'string'
-				]);
-
-				// Parse the result
-				let [newCursor, keys] = result;
-				cursor = newCursor.toString();
-
-				if (keys.length === 0) {
-					continue;
-				}
-
-				if (!this.#namespace) {
-					keys = keys.filter((key: string) => !key.includes(this.#keyPrefixSeparator));
-				}
-
-				deletePromises.push(keys.map((key: string) => this.client.del(key)));
-			} while (cursor !== '0');
-
-			await Promise.all(deletePromises);
-		} catch (error) {
-			this.emit('error', error);
-		}
-	}
-
-	public async has(key: string): Promise<boolean> {
-		key = this.createKeyPrefix(key, this.#namespace);
-		return this.client.exists(key);
-	}
-
-	public async hasMany(keys: string[]): Promise<boolean[]> {
-		const multi = [];
-
-		for (const key of keys) {
-			const prefixedKey = this.createKeyPrefix(key, this.#namespace);
-			multi.push(this.client.exists(prefixedKey));
-		}
-
-		return Promise.all(multi);
-	}
-
-	public async getMany<Value>(keys: string[]): Promise<Array<StoredData<Value | undefined>>> {
-		if (keys.length === 0) {
-			return [];
-		}
-
-		keys = keys.map((key) => this.createKeyPrefix(key, this.#namespace));
-		const values = await this.client.mget(...keys);
-
-		return values as Value[];
-	}
-
-	public async disconnect(): Promise<void> {
-		this.client.close();
-	}
-
-	public async deleteMany(keys: string[]): Promise<boolean> {
-		let result = false;
-
-		// TODO: Use MULTI when available in Bun
-		const multi = [];
-
-		for (const key of keys) {
-			const prefixedKey = this.createKeyPrefix(key, this.#namespace);
-			if (this.#useUnlink) {
-				multi.push(this.client.send('UNLINK', [prefixedKey]));
-			} else {
-				multi.push(this.client.del(prefixedKey));
-			}
-		}
-
-		const results = await Promise.all(multi);
-
-		for (const deleted of results) {
-			if (typeof deleted === 'number' && deleted > 0) {
-				result = true;
-			}
-		}
-
-		return result;
-	}
-
-	public async *iterator<Value>(
-		namespace?: string
-	): AsyncGenerator<Array<string | Awaited<Value> | undefined>, void> {
-		const match = namespace ? `${namespace}${this.#keyPrefixSeparator}*` : '*';
-		let cursor = '0';
-
-		do {
-			const result = await this.client.send('SCAN', [cursor, 'MATCH', match, 'TYPE', 'string']);
-
-			// Parse the result
-			let [newCursor, keys] = result;
-			cursor = newCursor.toString();
-
-			if (!namespace && !this.#noNamespaceAffectsAll) {
-				keys = keys.filter((key: string) => !key.includes(this.#keyPrefixSeparator));
-			}
-
-			if (keys.length > 0) {
-				const values = await this.client.mget(...keys);
-				for (const i of keys.keys()) {
-					const key = this.getKeyWithoutPrefix(keys[i], namespace);
-					const value = values[i];
-					yield [key, value!];
-				}
-			}
-		} while (cursor !== '0');
-	}
-
-	/**
-	 * Helper function to create a key with a namespace.
-	 * @param key The key to prefix.
-	 * @param namespace The namespace to prefix the key with.
-	 * @returns The key with the namespace such as 'namespace::key'.
-	 */
-	public createKeyPrefix(key: string, namespace?: string): string {
-		return !!namespace ? `${namespace}${this.#keyPrefixSeparator}${key}` : key;
-	}
-
-	/**
-	 * Helper function to remove the namespace from a key.
-	 * @param key The key to remove the namespace from.
-	 * @param namespace The namespace to remove from the key.
-	 * @returns The key without the namespace.
-	 */
-	public getKeyWithoutPrefix(key: string, namespace?: string): string {
-		return !!namespace ? key.replace(`${namespace}${this.#keyPrefixSeparator}`, '') : key;
-	}
-}

package/src/model.ts

@@ -1,189 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { TSchema } from 'elysia';
-import type { ColumnMetadata, ModelAdapter } from './interfaces';
-
-import { Application } from '@elysiumjs/core';
-import { t } from 'elysia';
-
-import { getCurrentTenant, getTenancyStrategy } from './tenancy';
-
-/**
- * Creates a validation schema from normalized column metadata.
- * @author Axel Nana <axel.nana@workbud.com>
- * @param columns The column metadata to create the schema from.
- * @param options The schema generation options.
- * @returns A validation schema based on the given columns.
- */
-export const createSchemaFromModel = (
-	columns: ColumnMetadata[],
-	{ mode = 'select' }: { mode?: 'create' | 'update' | 'select' } = {}
-) => {
-	if (columns === undefined || columns.length === 0) return t.Object({});
-
-	const properties: { [key: string]: TSchema } = {};
-
-	for (const column of columns) {
-		if (['create', 'update'].includes(mode) && column.isPrimaryKey) {
-			continue;
-		}
-
-		properties[column.name] = parseColumnType(column);
-
-		if (column.nullable) {
-			properties[column.name] = t.Nullable(properties[column.name]);
-		}
-
-		if (mode === 'update' || column.hasDefault || column.nullable) {
-			properties[column.name] = t.Optional(properties[column.name]);
-		}
-	}
-
-	return t.Object(properties);
-};
-
-/**
- * Creates a validation schema from a column's metadata.
- * @author Axel Nana <axel.nana@workbud.com>
- * @param column The column metadata.
- * @returns A validation schema based on the given column.
- */
-const parseColumnType = (column: ColumnMetadata) => {
-	switch (column.dataType) {
-		case 'string':
-			return t.String();
-		case 'uuid':
-			return t.String({ format: 'uuid' });
-		case 'number':
-			return t.Number();
-		case 'boolean':
-			return t.Boolean();
-		case 'array':
-			return t.Array(t.Any());
-		case 'json':
-			return t.Object({});
-		case 'date':
-			return t
-				.Transform(t.String({ format: 'date' }))
-				.Decode((date) => new Date(date))
-				.Encode((date) => date.toISOString());
-		case 'datetime':
-			return t
-				.Transform(t.String({ format: 'date-time' }))
-				.Decode((date) => new Date(date))
-				.Encode((date) => date.toISOString());
-		case 'bigint':
-			return t.BigInt();
-		case 'buffer':
-			return t.File();
-		default:
-			return t.Never();
-	}
-};
-
-/**
- * Mixin used to create a new abstract model class.
- * @author Axel Nana <axel.nana@workbud.com>
- * @template TTable The ORM-specific table type.
- * @template TColumns The table columns configuration type.
- * @param tableName The name of the table.
- * @param columns The table columns configuration.
- * @param adapter The model adapter for the ORM.
- * @param baseTable The base ORM table instance.
- */
-export const AbstractModel = <TTable, TColumns extends Record<string, unknown>>(
-	tableName: string,
-	columns: TColumns,
-	adapter: ModelAdapter<TTable>,
-	baseTable: TTable
-) => {
-	const columnMetadata = adapter.getColumns(baseTable);
-
-	class M {
-		/**
-		 * The data type returned by the select queries.
-		 */
-		public static readonly $inferSelect: unknown = undefined;
-
-		/**
-		 * The data type needed by the insert queries.
-		 */
-		public static readonly $inferInsert: unknown = undefined;
-
-		/**
-		 * The data type needed by the update queries.
-		 */
-		public static readonly $inferUpdate: unknown = undefined;
-
-		/**
-		 * The ORM-specific table schema wrapped by this model.
-		 * Will be automatically resolved to a tenant-scoped table when tenancy is active.
-		 */
-		public static get table(): TTable {
-			// If we are not inside an Application context, we can't use the tenancy system
-			if (!Application.instance || !Application.context.getStore) {
-				return baseTable;
-			}
-
-			if (this.supportTenancy) {
-				const tenant = getCurrentTenant() ?? 'public';
-				if (tenant !== 'public') {
-					const strategy = getTenancyStrategy();
-					if (strategy) {
-						return strategy.resolveTable(baseTable, tenant) as TTable;
-					}
-					return adapter.createTenantTable(baseTable, tenant);
-				}
-			}
-
-			return baseTable;
-		}
-
-		/**
-		 * The name of the table wrapped by the model.
-		 */
-		public static readonly tableName: string = tableName;
-
-		/**
-		 * The table columns configuration.
-		 */
-		public static readonly columns: TColumns = columns;
-
-		/**
-		 * The validation schema for creating records.
-		 */
-		public static readonly insertSchema = createSchemaFromModel(columnMetadata, { mode: 'create' });
-
-		/**
-		 * The validation schema for updating records.
-		 */
-		public static readonly updateSchema = createSchemaFromModel(columnMetadata, { mode: 'update' });
-
-		/**
-		 * The validation schema for selecting records.
-		 */
-		public static readonly selectSchema = createSchemaFromModel(columnMetadata, { mode: 'select' });
-
-		/**
-		 * Whether the model supports tenancy.
-		 *
-		 * Set it to `true` if the model supports tenancy. This means that the model will be
-		 * wrapped by the tenancy strategy when the current tenant is not `public`.
-		 */
-		public static readonly supportTenancy: boolean = false;
-	}
-
-	return M;
-};

package/src/repository.ts

@@ -1,137 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { AbstractDatabase } from './database';
-import type { IdType, ModelClass, RepositoryInterface } from './interfaces';
-
-/**
- * Mixin used to create a new abstract repository class over a model.
- *
- * All CRUD methods are abstract and must be implemented by driver-specific
- * subclasses.
- *
- * @author Axel Nana <axel.nana@workbud.com>
- * @template TModel The type of the model class wrapped by the repository.
- * @template TConnection The database connection type.
- * @param model The model class wrapped by the repository.
- * @param database The database manager instance.
- */
-export const AbstractRepository = <TModel extends ModelClass, TConnection>(
-	model: TModel,
-	database: AbstractDatabase<TConnection, unknown>
-) => {
-	type TSelect = TModel['$inferSelect'];
-	type TInsert = TModel['$inferInsert'];
-	type TUpdate = TModel['$inferUpdate'];
-
-	abstract class R implements RepositoryInterface<TSelect, TInsert, TUpdate> {
-		/**
-		 * The model class wrapped by this repository.
-		 */
-		public static readonly Model: TModel = model;
-
-		/**
-		 * The database connection name to use.
-		 *
-		 * Update this value to change the database connection used by this repository.
-		 */
-		public static readonly connection: string = 'default';
-
-		/**
-		 * The database connection used by this repository.
-		 */
-		public get db(): TConnection {
-			return database.getConnection((this.constructor as typeof R).connection);
-		}
-
-		/**
-		 * Retrieves all the records in the database.
-		 * @returns All the records in the database.
-		 */
-		public abstract all(): Promise<TSelect[]>;
-
-		/**
-		 * Get a paginated subset of the records in the database.
-		 * @param count The number of records to retrieve per page.
-		 * @param page The page number to retrieve.
-		 * @returns A paginated response containing the records and the total number of records.
-		 */
-		public abstract paginate(
-			count: number,
-			page?: number
-		): Promise<{ page: number; data: TSelect[]; total: number }>;
-
-		/**
-		 * Retrieves a record by its id.
-		 * @param id The id of the record to retrieve.
-		 * @returns The record with the given id, or `null` if not found.
-		 */
-		public abstract find(id: IdType): Promise<TSelect | null>;
-
-		/**
-		 * Finds the first record with a column matching the given value.
-		 * @param column The column to filter by.
-		 * @param value The value the column should match.
-		 * @returns The first record with a column matching the given value.
-		 */
-		public abstract findBy<TKey extends keyof TSelect>(
-			column: TKey,
-			value: TSelect[TKey]
-		): Promise<TSelect | null>;
-
-		/**
-		 * Inserts a new record in the database.
-		 * @param data The data to insert.
-		 * @returns The inserted record.
-		 */
-		public abstract insert(data: TInsert): Promise<TSelect>;
-
-		/**
-		 * Updates a record in the database.
-		 * @param id The id of the record to update.
-		 * @param data The data to update.
-		 * @returns The updated record.
-		 */
-		public abstract update(id: IdType, data: TUpdate): Promise<TSelect>;
-
-		/**
-		 * Updates all the records in the database.
-		 * @param data The data to update.
-		 * @returns The updated records.
-		 */
-		public abstract updateAll(data: TUpdate): Promise<TSelect[]>;
-
-		/**
-		 * Deletes a record from the database.
-		 * @param id The ID of the record to delete.
-		 * @returns The deleted record.
-		 */
-		public abstract delete(id: IdType): Promise<TSelect>;
-
-		/**
-		 * Deletes all the records from the database.
-		 * @returns All the deleted records.
-		 */
-		public abstract deleteAll(): Promise<TSelect[]>;
-
-		/**
-		 * Checks if a record exists in the database.
-		 * @param id The ID of the record to check.
-		 * @returns True if the record exists, false otherwise.
-		 */
-		public abstract exists(id: IdType): Promise<boolean>;
-	}
-
-	return R;
-};