@cqrs-ddd/mikro-orm 0.2.0

package/dist/errors/mikro-orm.dialect.js

@@ -0,0 +1,96 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MikroOrmDialect = void 0;
+const core_1 = require("@mikro-orm/core");
+const SQLITE_COLUMNS = /UNIQUE constraint failed: (.+)$/m;
+function constraintsOf(meta, naming) {
+    const describe = (key, properties, name) => {
+        const fields = properties.flatMap((property) => meta.properties[property].fieldNames);
+        return {
+            key,
+            name: name ?? naming.indexName(meta.tableName, fields, 'unique'),
+            columns: fields.map((field) => `${meta.tableName}.${field}`).join(', '),
+        };
+    };
+    const constraints = Object.values(meta.properties)
+        .filter((property) => property.unique)
+        .map((property) => describe(property.name, [property.name], typeof property.unique === 'string' ? property.unique : undefined));
+    for (const unique of meta.uniques) {
+        const properties = [unique.properties ?? []].flat();
+        const key = properties.length === 1 ? properties[0] : unique.name;
+        if (key === undefined) {
+            throw new TypeError(`${meta.className}: a unique constraint over several properties needs a name to be mapped.`);
+        }
+        constraints.push(properties.length > 0
+            ? describe(key, properties, unique.name)
+            : { key, name: key });
+    }
+    return constraints;
+}
+function assertDistinctColumns(meta, constraints) {
+    const seen = new Map();
+    for (const { name, columns } of constraints) {
+        if (columns === undefined)
+            continue;
+        const other = seen.get(columns);
+        if (other !== undefined) {
+            throw new TypeError(`${meta.className}: unique constraints ${other} and ${name} cover the same columns; SQLite cannot tell them apart.`);
+        }
+        seen.set(columns, name);
+    }
+}
+/**
+ * The MikroORM persistence dialect: it reads the violated unique constraint of a
+ * `UniqueConstraintViolationException` through the ORM's entity metadata, so a
+ * repository maps it by entity property and never names a constraint or column.
+ *
+ * - PostgreSQL reports the constraint name; it is matched against the names in
+ *   the mapping (`unique: 'name'` on a property, `uniques[].name`) or, when none
+ *   is declared, the naming strategy's `indexName`.
+ * - SQLite and libSQL report the `table.column` list; it is matched against the
+ *   columns of each constraint.
+ *
+ * Any other error, an entity without metadata, or an unknown constraint yields
+ * `undefined`, so the decorator rethrows the original error.
+ *
+ * @throws {TypeError} On construction, when a multi-property unique constraint
+ *   has no name, or two constraints of one entity cover the same columns.
+ *
+ * @example
+ * ```ts
+ * const orm = await MikroORM.init(options);
+ * setPersistenceDialect(new MikroOrmDialect(orm));
+ * ```
+ */
+class MikroOrmDialect {
+    constraints = new Map();
+    metadata;
+    constructor(orm) {
+        const naming = orm.config.getNamingStrategy();
+        this.metadata = orm.getMetadata();
+        for (const meta of this.metadata.getAll().values()) {
+            if (!meta.tableName)
+                continue;
+            const constraints = constraintsOf(meta, naming);
+            assertDistinctColumns(meta, constraints);
+            this.constraints.set(meta, constraints);
+        }
+    }
+    uniqueViolation(error, entity) {
+        if (!(error instanceof core_1.UniqueConstraintViolationException))
+            return undefined;
+        const meta = this.metadata.find(entity.constructor);
+        const constraints = meta ? this.constraints.get(meta) : undefined;
+        if (!constraints)
+            return undefined;
+        const { constraint } = error;
+        if (typeof constraint === 'string') {
+            return constraints.find(({ name }) => name === constraint)?.key;
+        }
+        const columns = SQLITE_COLUMNS.exec(error.message)?.[1].trim();
+        return constraints.find((unique) => unique.columns === columns)?.key;
+    }
+}
+exports.MikroOrmDialect = MikroOrmDialect;
+//# sourceMappingURL=mikro-orm.dialect.js.map

package/dist/errors/mikro-orm.dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mikro-orm.dialect.js","sourceRoot":"","sources":["../../src/errors/mikro-orm.dialect.ts"],"names":[],"mappings":"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"}

package/dist/errors/transient-error.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Persistence-adapter classifier for driver/network failures that are reasonable
+ * to retry. This function is infrastructure-only; application handlers consume
+ * {@link TransientOperationError} instead of importing this classifier.
+ *
+ * An error is transient when its `code` is one of:
+ * - a retryable PostgreSQL SQLSTATE: serialization failure `40001`, deadlock
+ *   `40P01`, lock not available `55P03`, shutdown `57P01`–`57P03`, or any code
+ *   in the connection-exception (`08`) or insufficient-resource (`53`) class;
+ * - a Node network error: `ECONNREFUSED`, `ECONNRESET`, `EHOSTUNREACH`,
+ *   `ENETUNREACH`, `EPIPE` or `ETIMEDOUT`;
+ * - `SQLITE_BUSY` or `SQLITE_LOCKED`;
+ *
+ * or when its `name` is `TaskCancelledError` or `TimeoutError`. A wrapped error
+ * is classified through its `cause` chain, which may be cyclic.
+ */
+export declare function isTransientPersistenceError(error: unknown): boolean;
+/**
+ * Translates persistence-specific transient failures into the neutral application
+ * retry signal. Non-transient failures are returned unchanged.
+ *
+ * This is the canonical `otherwise` translator for `@MapPersistenceErrors` and
+ * `@PersistedWrite` of `@cqrs-ddd/core`. Because non-transient errors keep their identity,
+ * domain errors a repository throws on purpose (`ConcurrencyConflictError`,
+ * `EntityNotFoundException`) pass through without a re-throw guard.
+ *
+ * @param error - The failure raised by the persistence operation.
+ * @param operation - What was being done, for the message, such as
+ *   `` `deleting User ${user.id}` ``.
+ * @returns A {@link TransientOperationError} whose `cause` is `error`, or
+ *   `error` itself when it is not transient.
+ *
+ * @example
+ * ```ts
+ * @MapPersistenceErrors<[User], User>({
+ *   entity: ([user]) => user,
+ *   otherwise: (error, user) =>
+ *     mapPersistenceError(error, `deleting User ${user.id}`),
+ * })
+ * async save(user: User): Promise<null> { ... }
+ *
+ * // Outside the lifecycle decorators:
+ * try {
+ *   return await em.findOne(Auth, { refreshTokenHash: hash }, { refresh: true });
+ * } catch (error) {
+ *   throw mapPersistenceError(error, 'auth session lookup');
+ * }
+ * ```
+ */
+export declare function mapPersistenceError(error: unknown, operation: string): unknown;
+//# sourceMappingURL=transient-error.d.ts.map

package/dist/errors/transient-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-error.d.ts","sourceRoot":"","sources":["../../src/errors/transient-error.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAOT"}

package/dist/errors/transient-error.js

@@ -0,0 +1,97 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTransientPersistenceError = isTransientPersistenceError;
+exports.mapPersistenceError = mapPersistenceError;
+const domain_1 = require("@cqrs-ddd/core/domain");
+const TRANSIENT_CODES = new Set([
+    '40001', // PostgreSQL serialization failure
+    '40P01', // PostgreSQL deadlock
+    '55P03', // PostgreSQL lock not available
+    '57P01', // PostgreSQL admin shutdown
+    '57P02', // PostgreSQL crash shutdown
+    '57P03', // PostgreSQL cannot connect now
+    'ECONNREFUSED',
+    'ECONNRESET',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'EPIPE',
+    'ETIMEDOUT',
+    'SQLITE_BUSY',
+    'SQLITE_LOCKED',
+]);
+/**
+ * Persistence-adapter classifier for driver/network failures that are reasonable
+ * to retry. This function is infrastructure-only; application handlers consume
+ * {@link TransientOperationError} instead of importing this classifier.
+ *
+ * An error is transient when its `code` is one of:
+ * - a retryable PostgreSQL SQLSTATE: serialization failure `40001`, deadlock
+ *   `40P01`, lock not available `55P03`, shutdown `57P01`–`57P03`, or any code
+ *   in the connection-exception (`08`) or insufficient-resource (`53`) class;
+ * - a Node network error: `ECONNREFUSED`, `ECONNRESET`, `EHOSTUNREACH`,
+ *   `ENETUNREACH`, `EPIPE` or `ETIMEDOUT`;
+ * - `SQLITE_BUSY` or `SQLITE_LOCKED`;
+ *
+ * or when its `name` is `TaskCancelledError` or `TimeoutError`. A wrapped error
+ * is classified through its `cause` chain, which may be cyclic.
+ */
+function isTransientPersistenceError(error) {
+    const seen = new Set();
+    let current = error;
+    while (current && typeof current === 'object' && !seen.has(current)) {
+        seen.add(current);
+        const candidate = current;
+        const code = typeof candidate.code === 'string' ? candidate.code : '';
+        if (TRANSIENT_CODES.has(code) ||
+            code.startsWith('08') || // PostgreSQL connection exception class
+            code.startsWith('53') // PostgreSQL insufficient-resource class
+        ) {
+            return true;
+        }
+        if (candidate.name === 'TaskCancelledError' ||
+            candidate.name === 'TimeoutError') {
+            return true;
+        }
+        current = candidate.cause;
+    }
+    return false;
+}
+/**
+ * Translates persistence-specific transient failures into the neutral application
+ * retry signal. Non-transient failures are returned unchanged.
+ *
+ * This is the canonical `otherwise` translator for `@MapPersistenceErrors` and
+ * `@PersistedWrite` of `@cqrs-ddd/core`. Because non-transient errors keep their identity,
+ * domain errors a repository throws on purpose (`ConcurrencyConflictError`,
+ * `EntityNotFoundException`) pass through without a re-throw guard.
+ *
+ * @param error - The failure raised by the persistence operation.
+ * @param operation - What was being done, for the message, such as
+ *   `` `deleting User ${user.id}` ``.
+ * @returns A {@link TransientOperationError} whose `cause` is `error`, or
+ *   `error` itself when it is not transient.
+ *
+ * @example
+ * ```ts
+ * @MapPersistenceErrors<[User], User>({
+ *   entity: ([user]) => user,
+ *   otherwise: (error, user) =>
+ *     mapPersistenceError(error, `deleting User ${user.id}`),
+ * })
+ * async save(user: User): Promise<null> { ... }
+ *
+ * // Outside the lifecycle decorators:
+ * try {
+ *   return await em.findOne(Auth, { refreshTokenHash: hash }, { refresh: true });
+ * } catch (error) {
+ *   throw mapPersistenceError(error, 'auth session lookup');
+ * }
+ * ```
+ */
+function mapPersistenceError(error, operation) {
+    return isTransientPersistenceError(error)
+        ? new domain_1.TransientOperationError(`Transient persistence failure while ${operation}.`, { cause: error })
+        : error;
+}
+//# sourceMappingURL=transient-error.js.map

package/dist/errors/transient-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-error.js","sourceRoot":"","sources":["../../src/errors/transient-error.ts"],"names":[],"mappings":";AAAA,sEAAsE;;AAqCtE,kEA6BC;AAkCD,kDAUC;AA5GD,kDAAgE;AAEhE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,OAAO,EAAE,mCAAmC;IAC5C,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,gCAAgC;IACzC,OAAO,EAAE,4BAA4B;IACrC,OAAO,EAAE,4BAA4B;IACrC,OAAO,EAAE,gCAAgC;IACzC,cAAc;IACd,YAAY;IACZ,cAAc;IACd,aAAa;IACb,OAAO;IACP,WAAW;IACX,aAAa;IACb,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,2BAA2B,CAAC,KAAc;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,SAAS,GAAG,OAIjB,CAAC;QACF,MAAM,IAAI,GAAG,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,IACE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,wCAAwC;YACjE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,yCAAyC;UAC/D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IACE,SAAS,CAAC,IAAI,KAAK,oBAAoB;YACvC,SAAS,CAAC,IAAI,KAAK,cAAc,EACjC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,mBAAmB,CACjC,KAAc,EACd,SAAiB;IAEjB,OAAO,2BAA2B,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,IAAI,gCAAuB,CACzB,uCAAuC,SAAS,GAAG,EACnD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB;QACH,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC"}

package/dist/helpers/sql-identifier.d.ts

@@ -0,0 +1,19 @@
+/** Options for {@link isSqlIdentifier}. */
+export interface SqlIdentifierOptions {
+    /** Also accept one `schema.` qualifier, as in `app.cache`. Default `false`. */
+    readonly qualified?: boolean;
+}
+/**
+ * Whether `name` is an unquoted SQL identifier: a letter or underscore, then
+ * letters, digits or underscores. Use it before interpolating a name into SQL
+ * text, where it cannot be passed as a parameter.
+ *
+ * @example
+ * ```ts
+ * isSqlIdentifier('tenant_a');                       // true
+ * isSqlIdentifier('tenant-a');                       // false
+ * isSqlIdentifier('app.cache', { qualified: true }); // true
+ * ```
+ */
+export declare function isSqlIdentifier(name: string, options?: SqlIdentifierOptions): boolean;
+//# sourceMappingURL=sql-identifier.d.ts.map

package/dist/helpers/sql-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-identifier.d.ts","sourceRoot":"","sources":["../../src/helpers/sql-identifier.ts"],"names":[],"mappings":"AAMA,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAET"}

package/dist/helpers/sql-identifier.js

@@ -0,0 +1,23 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSqlIdentifier = isSqlIdentifier;
+const NAME = '[A-Za-z_][A-Za-z0-9_]*';
+const UNQUALIFIED = new RegExp(`^${NAME}$`);
+const QUALIFIED = new RegExp(`^${NAME}(\\.${NAME})?$`);
+/**
+ * Whether `name` is an unquoted SQL identifier: a letter or underscore, then
+ * letters, digits or underscores. Use it before interpolating a name into SQL
+ * text, where it cannot be passed as a parameter.
+ *
+ * @example
+ * ```ts
+ * isSqlIdentifier('tenant_a');                       // true
+ * isSqlIdentifier('tenant-a');                       // false
+ * isSqlIdentifier('app.cache', { qualified: true }); // true
+ * ```
+ */
+function isSqlIdentifier(name, options = {}) {
+    return (options.qualified ? QUALIFIED : UNQUALIFIED).test(name);
+}
+//# sourceMappingURL=sql-identifier.js.map

package/dist/helpers/sql-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-identifier.js","sourceRoot":"","sources":["../../src/helpers/sql-identifier.ts"],"names":[],"mappings":";AAAA,sEAAsE;;AAwBtE,0CAKC;AA3BD,MAAM,IAAI,GAAG,wBAAwB,CAAC;AACtC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;AAC5C,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC;AAQvD;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,IAAY,EACZ,UAAgC,EAAE;IAElC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './cache/cache-entry';
+export * from './cache/mikro-orm.cache';
+export * from './concurrency/assert-autocommit';
+export * from './concurrency/optimistic-delete';
+export * from './concurrency/optimistic-update';
+export * from './errors/mikro-orm.dialect';
+export * from './errors/transient-error';
+export * from './helpers/sql-identifier';
+export * from './interfaces/entity-manager-source';
+export * from './mapping/root-entity.properties';
+export * from './mapping/unix-timestamp.type';
+export * from './repository/aggregate.repository';
+export * from './tenancy/tenant-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cache/cache-entry"), exports);
+__exportStar(require("./cache/mikro-orm.cache"), exports);
+__exportStar(require("./concurrency/assert-autocommit"), exports);
+__exportStar(require("./concurrency/optimistic-delete"), exports);
+__exportStar(require("./concurrency/optimistic-update"), exports);
+__exportStar(require("./errors/mikro-orm.dialect"), exports);
+__exportStar(require("./errors/transient-error"), exports);
+__exportStar(require("./helpers/sql-identifier"), exports);
+__exportStar(require("./interfaces/entity-manager-source"), exports);
+__exportStar(require("./mapping/root-entity.properties"), exports);
+__exportStar(require("./mapping/unix-timestamp.type"), exports);
+__exportStar(require("./repository/aggregate.repository"), exports);
+__exportStar(require("./tenancy/tenant-store"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;;;;;;;;;;;;;;AAEtE,sDAAoC;AACpC,0DAAwC;AACxC,kEAAgD;AAChD,kEAAgD;AAChD,kEAAgD;AAChD,6DAA2C;AAC3C,2DAAyC;AACzC,2DAAyC;AACzC,qEAAmD;AACnD,mEAAiD;AACjD,gEAA8C;AAC9C,oEAAkD;AAClD,yDAAuC"}

package/dist/interfaces/entity-manager-source.d.ts

@@ -0,0 +1,19 @@
+import type { EntityManager } from '@mikro-orm/core';
+/**
+ * Supplies the MikroORM `EntityManager` for the current operation.
+ *
+ * {@link AggregateRepository} and {@link MikroOrmCache} read `em` on every
+ * operation and never keep it, so a source may return a different manager each
+ * time: the current tenant's in a multi-tenant application, or the current
+ * request's. A getter over the application's own store satisfies it, and so
+ * does a plain `{ em }` object in a single-database setup or a test.
+ *
+ * @example
+ * ```ts
+ * const source: IEntityManagerSource = { em: orm.em.fork() };
+ * ```
+ */
+export interface IEntityManagerSource {
+    readonly em: EntityManager;
+}
+//# sourceMappingURL=entity-manager-source.d.ts.map

package/dist/interfaces/entity-manager-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-manager-source.d.ts","sourceRoot":"","sources":["../../src/interfaces/entity-manager-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;CAC5B"}

package/dist/interfaces/entity-manager-source.js

@@ -0,0 +1,4 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=entity-manager-source.js.map

package/dist/interfaces/entity-manager-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-manager-source.js","sourceRoot":"","sources":["../../src/interfaces/entity-manager-source.ts"],"names":[],"mappings":";AAAA,sEAAsE"}

package/dist/mapping/root-entity.properties.d.ts

@@ -0,0 +1,63 @@
+import { UnixTimestampType } from './unix-timestamp.type';
+/** Column names for the {@link rootEntityProperties} mapping. */
+export interface RootEntityColumns {
+    /** Default `'id'`. */
+    readonly id?: string;
+    /** Default `'created_at'`. */
+    readonly createdAt?: string;
+    /** Default `'updated_at'`. */
+    readonly updatedAt?: string;
+}
+/**
+ * Identity and timestamp columns shared by every `RootEntity` schema, mapped
+ * through the entity's private hydration setters (`accessor: true`). Timestamps
+ * are stored as epoch milliseconds through {@link UnixTimestampType}. Returns
+ * fresh property definitions for each schema.
+ *
+ * @param columns - Column names that differ from the defaults.
+ *
+ * @example
+ * ```ts
+ * export const UserSchema = new EntitySchema<User, AggregateRoot>({
+ *   class: User as any,
+ *   tableName: 'users',
+ *   properties: {
+ *     ...rootEntityProperties(),
+ *     version: versionProperty(),
+ *     email: { type: 'string', unique: true },
+ *   },
+ * });
+ * ```
+ */
+export declare function rootEntityProperties(columns?: RootEntityColumns): {
+    readonly id: {
+        readonly type: "string";
+        readonly primary: true;
+        readonly fieldName: string;
+        readonly accessor: true;
+    };
+    readonly createdAt: {
+        readonly type: typeof UnixTimestampType;
+        readonly fieldName: string;
+        readonly accessor: true;
+    };
+    readonly updatedAt: {
+        readonly type: typeof UnixTimestampType;
+        readonly fieldName: string;
+        readonly accessor: true;
+    };
+};
+/**
+ * Optimistic-concurrency version column for aggregates written with version
+ * checks. New rows start at version 1, matching a new `RootEntity`.
+ *
+ * @param column - Column name. Default `'version'`.
+ */
+export declare function versionProperty(column?: string): {
+    readonly type: "number";
+    readonly fieldName: string;
+    readonly default: 1;
+    readonly accessor: true;
+    readonly version: true;
+};
+//# sourceMappingURL=root-entity.properties.d.ts.map

package/dist/mapping/root-entity.properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-entity.properties.d.ts","sourceRoot":"","sources":["../../src/mapping/root-entity.properties.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;EAmBnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAY;;;;;;EAQjD"}

package/dist/mapping/root-entity.properties.js

@@ -0,0 +1,63 @@
+"use strict";
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rootEntityProperties = rootEntityProperties;
+exports.versionProperty = versionProperty;
+const unix_timestamp_type_1 = require("./unix-timestamp.type");
+/**
+ * Identity and timestamp columns shared by every `RootEntity` schema, mapped
+ * through the entity's private hydration setters (`accessor: true`). Timestamps
+ * are stored as epoch milliseconds through {@link UnixTimestampType}. Returns
+ * fresh property definitions for each schema.
+ *
+ * @param columns - Column names that differ from the defaults.
+ *
+ * @example
+ * ```ts
+ * export const UserSchema = new EntitySchema<User, AggregateRoot>({
+ *   class: User as any,
+ *   tableName: 'users',
+ *   properties: {
+ *     ...rootEntityProperties(),
+ *     version: versionProperty(),
+ *     email: { type: 'string', unique: true },
+ *   },
+ * });
+ * ```
+ */
+function rootEntityProperties(columns = {}) {
+    return {
+        id: {
+            type: 'string',
+            primary: true,
+            fieldName: columns.id ?? 'id',
+            accessor: true,
+        },
+        createdAt: {
+            type: unix_timestamp_type_1.UnixTimestampType,
+            fieldName: columns.createdAt ?? 'created_at',
+            accessor: true,
+        },
+        updatedAt: {
+            type: unix_timestamp_type_1.UnixTimestampType,
+            fieldName: columns.updatedAt ?? 'updated_at',
+            accessor: true,
+        },
+    };
+}
+/**
+ * Optimistic-concurrency version column for aggregates written with version
+ * checks. New rows start at version 1, matching a new `RootEntity`.
+ *
+ * @param column - Column name. Default `'version'`.
+ */
+function versionProperty(column = 'version') {
+    return {
+        type: 'number',
+        fieldName: column,
+        default: 1,
+        accessor: true,
+        version: true,
+    };
+}
+//# sourceMappingURL=root-entity.properties.js.map

package/dist/mapping/root-entity.properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-entity.properties.js","sourceRoot":"","sources":["../../src/mapping/root-entity.properties.ts"],"names":[],"mappings":";AAAA,sEAAsE;;AAmCtE,oDAmBC;AAQD,0CAQC;AApED,+DAA0D;AAY1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,oBAAoB,CAAC,UAA6B,EAAE;IAClE,OAAO;QACL,EAAE,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,IAAI;YAC7B,QAAQ,EAAE,IAAI;SACf;QACD,SAAS,EAAE;YACT,IAAI,EAAE,uCAAiB;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,YAAY;YAC5C,QAAQ,EAAE,IAAI;SACf;QACD,SAAS,EAAE;YACT,IAAI,EAAE,uCAAiB;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,YAAY;YAC5C,QAAQ,EAAE,IAAI;SACf;KACO,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAM,GAAG,SAAS;IAChD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;KACL,CAAC;AACb,CAAC"}

package/dist/mapping/unix-timestamp.type.d.ts

@@ -0,0 +1,17 @@
+import { type EntityProperty, Platform, type TransformContext, Type } from '@mikro-orm/core';
+type Timestamp = Date | number | string | bigint;
+/**
+ * MikroORM type that stores a `Date` as epoch milliseconds in a 64-bit `bigint`
+ * column.
+ *
+ * `null` and `undefined` pass through in both directions. A value that has no
+ * valid time throws a `TypeError` rather than being stored or returned as
+ * `NaN`.
+ */
+export declare class UnixTimestampType extends Type<Date | null | undefined, number | null | undefined> {
+    convertToDatabaseValue(value: Timestamp | null | undefined, _platform?: Platform, _context?: TransformContext): number | null | undefined;
+    convertToJSValue(value: Timestamp | null | undefined, _platform?: Platform, _context?: TransformContext): Date | null | undefined;
+    getColumnType(prop?: EntityProperty, platform?: Platform): string;
+}
+export {};
+//# sourceMappingURL=unix-timestamp.type.d.ts.map

package/dist/mapping/unix-timestamp.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-timestamp.type.d.ts","sourceRoot":"","sources":["../../src/mapping/unix-timestamp.type.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,QAAQ,EACR,KAAK,gBAAgB,EACrB,IAAI,EACL,MAAM,iBAAiB,CAAC;AAEzB,KAAK,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AA0BjD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,IAAI,CACzC,IAAI,GAAG,IAAI,GAAG,SAAS,EACvB,MAAM,GAAG,IAAI,GAAG,SAAS,CAC1B;IACC,sBAAsB,CACpB,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS,CAAC,EAAE,QAAQ,EACpB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,MAAM,GAAG,IAAI,GAAG,SAAS;IAK5B,gBAAgB,CACd,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACnC,SAAS,CAAC,EAAE,QAAQ,EACpB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,IAAI,GAAG,IAAI,GAAG,SAAS;IAM1B,aAAa,CACX,IAAI,GAAE,cAAqC,EAC3C,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM;CAGV"}

package/dist/mapping/unix-timestamp.type.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnixTimestampType = void 0;
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+const core_1 = require("@mikro-orm/core");
+/**
+ * Converts a timestamp value to epoch milliseconds, or throws.
+ *
+ * A number, a bigint, a numeric string, a date string and a `Date` are read. A
+ * blank string, `NaN`, an infinite number, an unparsable string, an invalid
+ * `Date` and any other value have no valid time.
+ */
+function toEpochMilliseconds(value) {
+    let milliseconds = Number.NaN;
+    if (value instanceof Date)
+        milliseconds = value.getTime();
+    else if (typeof value === 'number')
+        milliseconds = value;
+    else if (typeof value === 'bigint')
+        milliseconds = Number(value);
+    else if (typeof value === 'string' && value.trim() !== '') {
+        const numeric = Number(value);
+        milliseconds = Number.isNaN(numeric) ? Date.parse(value) : numeric;
+    }
+    if (!Number.isFinite(milliseconds)) {
+        throw new TypeError(`UnixTimestampType cannot read ${typeof value} value ${JSON.stringify(String(value))} as a timestamp.`);
+    }
+    return milliseconds;
+}
+/**
+ * MikroORM type that stores a `Date` as epoch milliseconds in a 64-bit `bigint`
+ * column.
+ *
+ * `null` and `undefined` pass through in both directions. A value that has no
+ * valid time throws a `TypeError` rather than being stored or returned as
+ * `NaN`.
+ */
+class UnixTimestampType extends core_1.Type {
+    convertToDatabaseValue(value, _platform, _context) {
+        if (value == null)
+            return value;
+        return toEpochMilliseconds(value);
+    }
+    convertToJSValue(value, _platform, _context) {
+        if (value == null)
+            return value;
+        const milliseconds = toEpochMilliseconds(value);
+        return value instanceof Date ? value : new Date(milliseconds);
+    }
+    getColumnType(prop = {}, platform) {
+        return platform ? platform.getBigIntTypeDeclarationSQL(prop) : 'bigint';
+    }
+}
+exports.UnixTimestampType = UnixTimestampType;
+//# sourceMappingURL=unix-timestamp.type.js.map

package/dist/mapping/unix-timestamp.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-timestamp.type.js","sourceRoot":"","sources":["../../src/mapping/unix-timestamp.type.ts"],"names":[],"mappings":";;;AAAA,sEAAsE;AACtE,0CAKyB;AAIzB;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC;IAC9B,IAAI,KAAK,YAAY,IAAI;QAAE,YAAY,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;SACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,YAAY,GAAG,KAAK,CAAC;SACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;SAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,SAAS,CACjB,iCAAiC,OAAO,KAAK,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,kBAAkB,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,iBAAkB,SAAQ,WAGtC;IACC,sBAAsB,CACpB,KAAmC,EACnC,SAAoB,EACpB,QAA2B;QAE3B,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAChC,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,gBAAgB,CACd,KAAmC,EACnC,SAAoB,EACpB,QAA2B;QAE3B,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;IAED,aAAa,CACX,OAAuB,EAAoB,EAC3C,QAAmB;QAEnB,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,CAAC;CACF;AA7BD,8CA6BC"}