@tstdl/base 0.93.14 → 0.93.16

package/document-management/api/document-management.api.d.ts

@@ -179,6 +179,7 @@ export declare const documentManagementApiDefinition: {
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: import("../../orm/types.js").IsPrimaryKey<import("../../orm/types.js").HasDefault<import("../../orm/types.js").Uuid>>;
                 description?: string | null | undefined;
+                readonly __entityMeta__?: import("../../orm/entity.js").EntityMeta | undefined;
                 tenantId?: string | null | undefined;
                 label?: string | undefined;
                 metadata?: Partial<{
@@ -232,6 +233,7 @@ export declare const documentManagementApiDefinition: {
             method: "PATCH";
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: import("../../orm/types.js").IsPrimaryKey<import("../../orm/types.js").HasDefault<import("../../orm/types.js").Uuid>>;
+                readonly __entityMeta__?: import("../../orm/entity.js").EntityMeta | undefined;
                 tenantId?: string | null | undefined;
                 typeId?: import("../../orm/types.js").Uuid | undefined;
                 comment?: string | null | undefined;
@@ -579,6 +581,7 @@ declare const _DocumentManagementApi: import("../../api/client/index.js").ApiCli
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: import("../../orm/types.js").IsPrimaryKey<import("../../orm/types.js").HasDefault<import("../../orm/types.js").Uuid>>;
                 description?: string | null | undefined;
+                readonly __entityMeta__?: import("../../orm/entity.js").EntityMeta | undefined;
                 tenantId?: string | null | undefined;
                 label?: string | undefined;
                 metadata?: Partial<{
@@ -632,6 +635,7 @@ declare const _DocumentManagementApi: import("../../api/client/index.js").ApiCli
             method: "PATCH";
             parameters: import("../../schema/index.js").ObjectSchema<{
                 id: import("../../orm/types.js").IsPrimaryKey<import("../../orm/types.js").HasDefault<import("../../orm/types.js").Uuid>>;
+                readonly __entityMeta__?: import("../../orm/entity.js").EntityMeta | undefined;
                 tenantId?: string | null | undefined;
                 typeId?: import("../../orm/types.js").Uuid | undefined;
                 comment?: string | null | undefined;

package/document-management/service-models/document.service-model.d.ts

@@ -97,6 +97,7 @@ export declare const createDocumentRequestsTemplateParametersSchema: import("../
 export declare const updateDocumentRequestsTemplateParametersSchema: import("../../schema/index.js").ObjectSchema<{
     id: import("../../orm/index.js").IsPrimaryKey<import("../../orm/index.js").HasDefault<import("../../orm/index.js").Uuid>>;
     description?: string | null | undefined;
+    readonly __entityMeta__?: import("../../orm/index.js").EntityMeta | undefined;
     tenantId?: string | null | undefined;
     label?: string | undefined;
     metadata?: Partial<{
@@ -126,6 +127,7 @@ export declare const createDocumentRequestTemplateParametersSchema: import("../.
 }>;
 export declare const updateDocumentRequestTemplateParametersSchema: import("../../schema/index.js").ObjectSchema<{
     id: import("../../orm/index.js").IsPrimaryKey<import("../../orm/index.js").HasDefault<import("../../orm/index.js").Uuid>>;
+    readonly __entityMeta__?: import("../../orm/index.js").EntityMeta | undefined;
     tenantId?: string | null | undefined;
     typeId?: import("../../orm/index.js").Uuid | undefined;
     comment?: string | null | undefined;

package/injector/injector.js

@@ -375,7 +375,7 @@ export class Injector {
     }
     _resolveProvider(resolutionTag, registration, resolveArgument, options, context, resolutionContext, injectionContext, chain) {
         try {
-            setResolving(registration.token, context, chain);
+            setResolving(this, registration.token, context, chain);
             const { provider } = registration;
             let result;
             if (isClassProvider(provider)) {
@@ -417,7 +417,7 @@ export class Injector {
             return result.value;
         }
         finally {
-            deleteResolving(registration.token, context);
+            deleteResolving(this, registration.token, context);
         }
     }
     resolveClassInjection(resolutionTag, context, constructor, metadata, resolveArgument, chain) {
@@ -523,7 +523,7 @@ function addRegistration(registrations, registration) {
 function newInternalResolveContext() {
     return {
         resolves: 0,
-        resolving: new Set(),
+        resolving: new FactoryMap(() => new Set()),
         resolutionScopedResolutions: new MultiKeyMap(),
         resolutions: [],
         resolutionContextData: new FactoryMap(() => ({})),
@@ -594,14 +594,15 @@ function resolveArgumentIdentity(registration, resolveArgument, chain) {
     }
     return resolveArgument;
 }
-function setResolving(token, context, chain) {
-    if (context.resolving.has(token)) {
+function setResolving(injector, token, context, chain) {
+    const resolvingSet = context.resolving.get(injector);
+    if (resolvingSet.has(token)) {
         throw new ResolveError('Circular dependency detected. Use forwardRef for circular dependencies between classes.', chain);
     }
-    context.resolving.add(token);
+    resolvingSet.add(token);
 }
-function deleteResolving(token, context) {
-    context.resolving.delete(token);
+function deleteResolving(injector, token, context) {
+    context.resolving.get(injector).delete(token);
 }
 function throwOnPromise(value, type, chain) {
     if (isPromise(value)) {

package/mail/drizzle/0001_flimsy_bloodscream.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "mail"."log" DROP COLUMN "revision";--> statement-breakpoint
+ALTER TABLE "mail"."log" DROP COLUMN "revision_timestamp";--> statement-breakpoint
+ALTER TABLE "mail"."log" DROP COLUMN "create_timestamp";--> statement-breakpoint
+ALTER TABLE "mail"."log" DROP COLUMN "delete_timestamp";--> statement-breakpoint
+ALTER TABLE "mail"."log" DROP COLUMN "attributes";

package/mail/drizzle/meta/0001_snapshot.json

@@ -0,0 +1,69 @@
+{
+  "id": "28ddafef-64f4-437d-9406-82a02c76570e",
+  "prevId": "f8cdba37-11b9-477a-9f5a-5ef4b5026011",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "mail.log": {
+      "name": "log",
+      "schema": "mail",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "timestamp": {
+          "name": "timestamp",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "template": {
+          "name": "template",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "data": {
+          "name": "data",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "send_result": {
+          "name": "send_result",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "errors": {
+          "name": "errors",
+          "type": "text[]",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/mail/drizzle/meta/_journal.json

@@ -8,6 +8,13 @@
       "when": 1740059198387,
       "tag": "0000_previous_malcolm_colcord",
       "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "7",
+      "when": 1761124592125,
+      "tag": "0001_flimsy_bloodscream",
+      "breakpoints": true
     }
   ]
 }

package/mail/mail.service.js

@@ -33,7 +33,7 @@ let MailService = class MailService {
             template: templateName ?? null,
             data,
             sendResult: null,
-            errors: null
+            errors: null,
         });
         try {
             const result = await this.#mailClient.send(data, clientConfig);
@@ -53,15 +53,15 @@ let MailService = class MailService {
     async sendTemplate(keyOrTemplate, mailData, templateContext, clientConfig) {
         const { name, fields: { subject, html, text } } = await this.#templateService.render(keyOrTemplate, templateContext);
         const fullMailData = { ...mailData, subject, content: { html, text } };
-        return this.send(fullMailData, clientConfig, name);
+        return await this.send(fullMailData, clientConfig, name);
     }
 };
 MailService = __decorate([
     Singleton({
         providers: [
             provide(EntityRepositoryConfig, { useValue: { schema: 'mail' } }),
-            provide(DatabaseConfig, { useFactory: (_, context) => context.resolve(MailModuleConfig).database ?? context.resolve(DatabaseConfig, undefined, { skipSelf: true }) })
-        ]
+            provide(DatabaseConfig, { useFactory: (_, context) => context.resolve(MailModuleConfig).database ?? context.resolve(DatabaseConfig, undefined, { skipSelf: true }) }),
+        ],
     })
 ], MailService);
 export { MailService };

package/mail/models/mail-log.model.d.ts

@@ -1,7 +1,7 @@
-import { Entity, type Json, type Timestamp } from '../../orm/index.js';
+import { EntityWithoutMetadata, type Json, type Timestamp } from '../../orm/index.js';
 import type { MailData } from './mail-data.model.js';
 import type { MailSendResult } from './mail-send-result.model.js';
-export declare class MailLog extends Entity {
+export declare class MailLog extends EntityWithoutMetadata {
     timestamp: Timestamp;
     template: string | null;
     data: Json<MailData>;

package/mail/models/mail-log.model.js

@@ -7,9 +7,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { Entity, JsonProperty, Table, TimestampProperty } from '../../orm/index.js';
+import { EntityWithoutMetadata, JsonProperty, Table, TimestampProperty } from '../../orm/index.js';
 import { StringProperty } from '../../schema/index.js';
-let MailLog = class MailLog extends Entity {
+let MailLog = class MailLog extends EntityWithoutMetadata {
     timestamp;
     template;
     data;

package/message-bus/local/local-message-bus-provider.d.ts

@@ -1,7 +1,8 @@
 import { MessageBusProvider } from '../message-bus-provider.js';
 import { LocalMessageBus } from './local-message-bus.js';
-export declare class LocalMessageBusProvider extends MessageBusProvider {
+export declare class LocalMessageBusProvider extends MessageBusProvider implements Disposable {
     private readonly logger;
     private readonly channelSubjectsMap;
     get<T>(channel: string): LocalMessageBus<T>;
+    [Symbol.dispose](): void;
 }

package/message-bus/local/local-message-bus-provider.js

@@ -10,7 +10,6 @@ import { WeakRefMap } from '../../data-structures/weak-ref-map.js';
 import { inject, Singleton } from '../../injector/index.js';
 import { Logger } from '../../logger/index.js';
 import { FactoryMap } from '../../utils/factory-map.js';
-import { isUndefined } from '../../utils/type-guards.js';
 import { MessageBusProvider } from '../message-bus-provider.js';
 import { LocalMessageBus } from './local-message-bus.js';
 let LocalMessageBusProvider = LocalMessageBusProvider_1 = class LocalMessageBusProvider extends MessageBusProvider {
@@ -18,11 +17,13 @@ let LocalMessageBusProvider = LocalMessageBusProvider_1 = class LocalMessageBusP
     channelSubjectsMap = new FactoryMap(() => new Subject(), WeakRefMap.supported ? new WeakRefMap() : undefined);
     get(channel) {
         const subject = this.channelSubjectsMap.get(channel);
-        if (isUndefined(subject)) {
+        return new LocalMessageBus(subject, this.logger);
+    }
+    [Symbol.dispose]() {
+        for (const [channel, subject] of this.channelSubjectsMap.entries()) {
             this.channelSubjectsMap.delete(channel);
-            return this.get(channel);
+            subject.complete();
         }
-        return new LocalMessageBus(subject, this.logger);
     }
 };
 LocalMessageBusProvider = LocalMessageBusProvider_1 = __decorate([

package/message-bus/local/local-message-bus.js

@@ -26,9 +26,7 @@ let LocalMessageBus = class LocalMessageBus extends MessageBusBase {
     _publish(message) {
         this.subject.next({ source: this.source, message });
     }
-    _dispose() {
-        this.subject.complete();
-    }
+    _dispose() { }
 };
 LocalMessageBus = __decorate([
     Injectable({

package/message-bus/message-bus-base.js

@@ -21,14 +21,14 @@ export class MessageBusBase extends MessageBus {
     }
     async publish(message) {
         if (this.disposeToken.isSet) {
-            throw new Error('message-bus is disposed');
+            throw new Error('MessageBus is disposed.');
         }
         this.publishSubject.next(message);
         await this._publish(message);
     }
     async [Symbol.asyncDispose]() {
         if (this.disposeToken.isSet) {
-            throw new Error('message-bus is disposed');
+            throw new Error('MessageBus is disposed.');
         }
         this.disposeToken.set();
         this.publishSubject.complete();

package/orm/data-types/index.d.ts

@@ -5,3 +5,4 @@
 export * from './bytea.js';
 export * from './numeric-date.js';
 export * from './timestamp.js';
+export * from './tsvector.js';

package/orm/data-types/index.js

@@ -5,3 +5,4 @@
 export * from './bytea.js';
 export * from './numeric-date.js';
 export * from './timestamp.js';
+export * from './tsvector.js';

package/orm/data-types/tsvector.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module
+ * Defines a custom Drizzle type for handling PostgreSQL `tsvector` columns.
+ */
+import { type ConvertCustomConfig, type PgCustomColumnBuilder } from 'drizzle-orm/pg-core';
+type Config = {
+    data: unknown;
+};
+/**
+ * Custom Drizzle type for PostgreSQL `tsvector` columns.
+ */
+export declare const tsvector: {
+    (): PgCustomColumnBuilder<ConvertCustomConfig<"", Config>>;
+    <TName extends string>(dbName: TName): PgCustomColumnBuilder<ConvertCustomConfig<TName, Config>>;
+};
+export {};

package/orm/data-types/tsvector.js

@@ -0,0 +1,13 @@
+/**
+ * @module
+ * Defines a custom Drizzle type for handling PostgreSQL `tsvector` columns.
+ */
+import { customType } from 'drizzle-orm/pg-core';
+/**
+ * Custom Drizzle type for PostgreSQL `tsvector` columns.
+ */
+export const tsvector = customType({
+    dataType() {
+        return 'tsvector';
+    },
+});

package/orm/decorators.d.ts

@@ -6,7 +6,8 @@ import type { SQL } from 'drizzle-orm';
 import type { LiteralUnion } from 'type-fest';
 import { type SpecificCreateDecoratorOptions } from '../reflection/index.js';
 import type { AbstractConstructor, Record, TypedOmit } from '../types/index.js';
-import type { AnyEntity, Entity, EntityType, EntityWithoutMetadata } from './entity.js';
+import type { ValueOrProvider } from '../utils/value-or-provider.js';
+import type { AnyEntity, BaseEntity, Entity, EntityType } from './entity.js';
 import type { Query } from './query.js';
 import type { TargetColumnPaths } from './repository.types.js';
 import type { PgTableFromType } from './server/types.js';
@@ -14,16 +15,17 @@ type IndexMethod = LiteralUnion<'hash' | 'btree' | 'gist' | 'spgist' | 'gin' | '
 type NamingStrategy = 'abbreviated-table';
 type Column<T> = Extract<keyof T, string>;
 type Columns<T> = [Column<T>, ...Column<T>[]];
+export type SqlBuilder<T extends BaseEntity = any, R = SQL> = (table: PgTableFromType<EntityType<T>>) => R;
 /**
  * Builder function type for creating SQL check constraints.
  * @param table The Drizzle table object.
  */
-export type CheckBuilder<T extends Entity = any> = (table: PgTableFromType<EntityType<T>>) => SQL;
+export type CheckBuilder<T extends BaseEntity = any> = SqlBuilder<T>;
 /**
  * Builder function type for creating partial index WHERE clauses.
  * @param table The Drizzle table object.
  */
-export type WhereBuilder<T extends Entity | EntityWithoutMetadata = any> = (table: PgTableFromType<EntityType<T>>) => Query<T>;
+export type WhereBuilder<T extends BaseEntity = any> = SqlBuilder<T, Query<T>>;
 /**
  * Reflection data stored for ORM table decorators.
  */
@@ -34,6 +36,7 @@ export type OrmTableReflectionData = {
     compundPrimaryKeyNaming?: NamingStrategy;
     unique?: UniqueReflectionData[];
     index?: IndexReflectionData[];
+    fullTextSearch?: FullTextSearchReflectionData[];
     checks?: CheckReflectionData[];
     foreignKeys?: ForeignKeyReflectionData[];
 };
@@ -77,8 +80,8 @@ export type UniqueReflectionData = {
  * Reflection data for index definitions.
  * @template T The entity type.
  */
-export type IndexReflectionData<T extends Entity | EntityWithoutMetadata = any> = {
-    columns?: (string | [string, 'asc' | 'desc'] | SQL)[];
+export type IndexReflectionData<T extends BaseEntity = any> = {
+    columns?: (string | [string, 'asc' | 'desc'])[];
     order?: 'asc' | 'desc';
     options?: {
         name?: string;
@@ -87,22 +90,45 @@ export type IndexReflectionData<T extends Entity | EntityWithoutMetadata = any>
         unique?: boolean;
         where?: WhereBuilder<T>;
         nulls?: 'first' | 'last';
+    };
+};
+export type FullTextSearchFeature = 'vector' | 'trigram';
+export type FullTextSearchReflectionData<T extends BaseEntity = BaseEntity> = {
+    name: string;
+    /**
+     * Columns or SQL expression to use as the text source.
+     */
+    source?: ValueOrProvider<TargetColumnPaths<T>[] | SQL<string>, PgTableFromType<EntityType<T>>>;
+    parade?: {};
+    /**
+     * Configuration for vector search (tsvector).
+     */
+    vector?: {
         /**
-         * For full-text search indexes (e.g., GIN), specifies the text search configuration language (e.g., 'english').
-         * Can also be a SQL object for dynamic configuration.
+         * Raw SQL or builder function for generating the tsvector source.
          */
-        language?: string | SQL;
+        rawVectorSource?: ValueOrProvider<SQL, PgTableFromType<EntityType<T>>>;
         /**
-         * For multi-column full-text search indexes, specifies how to create the tsvector.
-         * - 'concat': (Default) Concatenate columns into a single tsvector.
-         * - 'separate': Create a separate tsvector for each column, useful for indexing columns with different languages or weights.
+         * Language configuration, used for stemming, stop-words, etc.
+         * Can be a string (e.g., 'simple', 'english') or a SQL expression / builder.
+         * Not applicable if `rawVectorSource` is provided.
          */
-        vectors?: 'concat' | 'separate';
+        language?: string | SQL | SqlBuilder<T>;
         /**
-         * For multi-column full-text search indexes, specifies weights for columns.
+         * Weights for columns in source.
          * Keys are column names, values are 'A', 'B', 'C', or 'D'.
+         * Not applicable if `rawVectorSource` is provided.
+         */
+        weights?: Partial<Record<TargetColumnPaths<T>, 'A' | 'B' | 'C' | 'D'>>;
+    };
+    /**
+     * Configuration for trigram search (pg_trgm).
+     */
+    trigram?: {
+        /**
+         * Similarity threshold between 0 and 1 for trigram matching.
          */
-        weights?: Partial<Record<TargetColumnPaths<any>, 'A' | 'B' | 'C' | 'D'>>;
+        threshold?: number;
     };
 };
 type CheckReflectionData = {
@@ -121,10 +147,6 @@ export type ForeignKeyReflectionData = {
         naming?: NamingStrategy;
     };
 };
-export type GinIndexOptions<T extends Entity | EntityWithoutMetadata = any> = TypedOmit<NonNullable<IndexReflectionData<T>['options']>, 'using' | 'weights'> & {
-    weights?: Partial<Record<TargetColumnPaths<any>, 'A' | 'B' | 'C' | 'D'>>;
-    language?: string | SQL;
-};
 /**
  * Factory function to create a class decorator for ORM table configuration.
  * Merges provided data with existing ORM reflection data on the class metadata.
@@ -217,27 +239,17 @@ export declare function Unique<T extends AnyEntity>(columns: Columns<T>, options
  * @param name Optional name for the index.
  * @param options Additional index options (e.g., method, uniqueness, conditions).
  */
-export declare function Index<T extends Entity | EntityWithoutMetadata = any>(options?: IndexReflectionData<T>['options']): PropertyDecorator;
+export declare function Index<T extends BaseEntity = any>(options?: IndexReflectionData<T>['options']): PropertyDecorator;
 /**
  * Define a composite index on multiple columns.
  * @template T The entity type.
  * @param columns An array of property names (or tuples with direction) included in the index.
  * @param options Additional index options.
  */
-export declare function Index<T extends Entity | EntityWithoutMetadata = any>(columns: Columns<T>, options?: IndexReflectionData<T>['options']): ClassDecorator;
-/**
- * Defines a GIN index on a single column, often for full-text search.
- * @param options GIN index options. For full-text search, `language` is required.
- */
-export declare function GinIndex<T extends Entity | EntityWithoutMetadata = any>(options: GinIndexOptions<T>): PropertyDecorator;
-/**
- * Defines a composite GIN index on multiple columns, often for full-text search.
- * @param columnsOrSql The columns to include in the index.
- * @param options GIN index options. For full-text search, providing a `language` is highly recommended.
- */
-export declare function GinIndex<T extends Entity | EntityWithoutMetadata = any>(columnsOrSql: (Column<T> | SQL)[], options?: GinIndexOptions<T>): ClassDecorator;
+export declare function Index<T extends BaseEntity = any>(columns: Columns<T>, options?: IndexReflectionData<T>['options']): ClassDecorator;
+export declare function FullTextSearch<T extends BaseEntity>(name: string, options: TypedOmit<FullTextSearchReflectionData<T>, 'name'>): ClassDecorator;
 /**
- * Automatically expire records after a certain time to live (TTL) based on the createTimestamp metadata. Requires extension of {@link Entity} instead of {@link EntityWithoutMetadata}.
+ * Automatically expire records after a certain time to live (TTL) based on the createTimestamp metadata. Requires extension of {@link Entity} instead of {@link BaseEntity}.
  * @param ttl Time To Live in milliseconds.
  * @param mode Whether to delete soft or hard.
  */

package/orm/decorators.js

@@ -137,14 +137,11 @@ export function Index(columnsOrOptions, options) {
     }
     return createColumnDecorator({ index: { options: columnsOrOptions } });
 }
-export function GinIndex(columnsOrSqlOrOptions, options) {
-    if (isArray(columnsOrSqlOrOptions)) {
-        return createTableDecorator({ index: [{ columns: columnsOrSqlOrOptions, options: { ...options, using: 'gin' } }] });
-    }
-    return createColumnDecorator({ index: { options: { ...columnsOrSqlOrOptions, using: 'gin' } } });
+export function FullTextSearch(name, options) {
+    return createTableDecorator({ fullTextSearch: [{ name, ...options }] });
 }
 /**
- * Automatically expire records after a certain time to live (TTL) based on the createTimestamp metadata. Requires extension of {@link Entity} instead of {@link EntityWithoutMetadata}.
+ * Automatically expire records after a certain time to live (TTL) based on the createTimestamp metadata. Requires extension of {@link Entity} instead of {@link BaseEntity}.
  * @param ttl Time To Live in milliseconds.
  * @param mode Whether to delete soft or hard.
  */

package/orm/entity.d.ts

@@ -1,13 +1,15 @@
-import type { Type } from '../types/index.js';
+import type { Record, Type } from '../types/index.js';
 import type { Embedded, HasDefault, IsPrimaryKey, Json, Timestamp, Uuid } from './types.js';
 /**
  * Represents the type (constructor) of an entity, potentially holding an entity name.
  * @template T - The entity class type.
  */
-export interface EntityType<T extends Entity | EntityWithoutMetadata = Entity | EntityWithoutMetadata> extends Type<T> {
+export interface EntityType<T extends BaseEntity = BaseEntity | Entity> extends Type<T> {
     readonly entityName?: string;
 }
-export type AnyEntity = Entity | EntityWithoutMetadata;
+export type AnyEntity = BaseEntity | Entity;
+export type EntityMeta = Record<string>;
+export declare const entityMeta: "__entityMeta__";
 /**
  * Base class for extensible metadata attributes associated with an entity.
  * Allows storing arbitrary key-value pairs.
@@ -26,23 +28,28 @@ export declare abstract class EntityMetadata {
     attributes: HasDefault<Json<EntityMetadataAttributes>>;
 }
 /**
- * Abstract base class for entities that include standard metadata.
- * Provides a default `id` (UUID primary key) and an `metadata` field.
+ * Abstract base class for entities that do *not* include the standard metadata fields.
+ * Provides only a default `id` (UUID primary key). Useful for simpler tables or join tables.
  */
-export declare abstract class Entity {
+export declare abstract class BaseEntity<TMeta extends EntityMeta = EntityMeta> {
     id: IsPrimaryKey<HasDefault<Uuid>>;
-    metadata: Embedded<EntityMetadata>;
+    readonly [entityMeta]?: TMeta;
 }
 /**
- * Abstract base class for entities that do *not* include the standard metadata fields.
- * Provides only a default `id` (UUID primary key). Useful for simpler tables or join tables.
+ * Abstract base class for entities that include standard metadata.
+ * Provides a default `id` (UUID primary key) and an `metadata` field.
  */
-export declare abstract class EntityWithoutMetadata {
-    id: IsPrimaryKey<HasDefault<Uuid>>;
+export declare abstract class Entity<TMeta extends EntityMeta = EntityMeta> extends BaseEntity<TMeta> {
+    metadata: Embedded<EntityMetadata>;
 }
-export declare abstract class TenantEntity extends Entity {
+export declare abstract class TenantEntity<TMeta extends EntityMeta = EntityMeta> extends Entity<TMeta> {
     tenantId: Uuid;
 }
-export declare abstract class TenantEntityWithoutMetadata extends EntityWithoutMetadata {
+export declare abstract class TenantBaseEntity<TMeta extends EntityMeta = EntityMeta> extends BaseEntity<TMeta> {
     tenantId: Uuid;
 }
+export { 
+/**
+ * @deprecated Use BaseEntity instead.
+ */
+BaseEntity as EntityWithoutMetadata, };

package/orm/entity.js

@@ -14,6 +14,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { Defaulted, Integer } from '../schema/index.js';
 import { EmbeddedProperty, PrimaryKeyProperty } from './decorators.js';
 import { JsonProperty, TimestampProperty, UuidProperty } from './schemas/index.js';
+export const entityMeta = '__entityMeta__';
 /**
  * Base class for extensible metadata attributes associated with an entity.
  * Allows storing arbitrary key-value pairs.
@@ -55,34 +56,28 @@ __decorate([
     __metadata("design:type", Object)
 ], EntityMetadata.prototype, "attributes", void 0);
 /**
- * Abstract base class for entities that include standard metadata.
- * Provides a default `id` (UUID primary key) and an `metadata` field.
+ * Abstract base class for entities that do *not* include the standard metadata fields.
+ * Provides only a default `id` (UUID primary key). Useful for simpler tables or join tables.
  */
-export class Entity {
+export class BaseEntity {
     id;
-    metadata;
 }
 __decorate([
     PrimaryKeyProperty(),
     UuidProperty({ defaultRandom: true }),
     __metadata("design:type", Object)
-], Entity.prototype, "id", void 0);
-__decorate([
-    EmbeddedProperty(EntityMetadata, { prefix: null }),
-    __metadata("design:type", Object)
-], Entity.prototype, "metadata", void 0);
+], BaseEntity.prototype, "id", void 0);
 /**
- * Abstract base class for entities that do *not* include the standard metadata fields.
- * Provides only a default `id` (UUID primary key). Useful for simpler tables or join tables.
+ * Abstract base class for entities that include standard metadata.
+ * Provides a default `id` (UUID primary key) and an `metadata` field.
  */
-export class EntityWithoutMetadata {
-    id;
+export class Entity extends BaseEntity {
+    metadata;
 }
 __decorate([
-    PrimaryKeyProperty(),
-    UuidProperty({ defaultRandom: true }),
+    EmbeddedProperty(EntityMetadata, { prefix: null }),
     __metadata("design:type", Object)
-], EntityWithoutMetadata.prototype, "id", void 0);
+], Entity.prototype, "metadata", void 0);
 export class TenantEntity extends Entity {
     tenantId;
 }
@@ -90,10 +85,15 @@ __decorate([
     UuidProperty(),
     __metadata("design:type", String)
 ], TenantEntity.prototype, "tenantId", void 0);
-export class TenantEntityWithoutMetadata extends EntityWithoutMetadata {
+export class TenantBaseEntity extends BaseEntity {
     tenantId;
 }
 __decorate([
     UuidProperty(),
     __metadata("design:type", String)
-], TenantEntityWithoutMetadata.prototype, "tenantId", void 0);
+], TenantBaseEntity.prototype, "tenantId", void 0);
+export { 
+/**
+ * @deprecated Use BaseEntity instead.
+ */
+BaseEntity as EntityWithoutMetadata, };