@kavo/mikroorm 0.6.0

package/dist/mikro-orm-repository-adapter.js

@@ -0,0 +1,428 @@
+import { AlreadyDeletedException, ConfigurationException, NotDeletedException, NotFoundException } from "@kavo/core";
+import { wrap } from "@mikro-orm/core";
+import { mapDriverError } from "./error-mapping.js";
+import { translateFilter } from "./filter-translator.js";
+import { toPlain, toPlainAll } from "./plain-entity.js";
+/**
+ * `RepositoryAdapter` over a MikroORM `EntityManager`: CRUD with hard *or*
+ * soft delete, restore, purge, filtering, sorting, pagination, optional
+ * counting, and nested relation includes.
+ *
+ * Two things are specific to MikroORM and load-bearing:
+ *
+ * **Every method forks the EntityManager.** MikroORM is a Unit-of-Work ORM:
+ * an `EntityManager` owns an identity map that caches every entity it has
+ * loaded, and reusing one across requests would serve stale rows and leak
+ * one caller's entities into another's. `orm.em` is the *root* manager and
+ * is not meant to be queried directly; `orm.em.fork()` gives each operation
+ * a clean, isolated one, which is the same scope a request-scoped
+ * `RequestContext` would give a hand-written MikroORM application.
+ *
+ * **`IncludeNode.strategy` is deliberately ignored**, exactly as in
+ * `@kavo/prisma` and unlike `@kavo/typeorm`. The TypeORM adapter translates
+ * the join/batch split because it drives a raw SQL query builder, where a
+ * to-many `JOIN` multiplies root rows and separate batched queries are how
+ * that is avoided. MikroORM resolves `populate` with its own queries and
+ * applies `limit`/`offset` to the root regardless of the load strategy, so a
+ * to-many include never disturbs pagination here. There is nothing left for
+ * the distinction to control, and MikroORM's `strategy` option is per-query
+ * rather than per-relation anyway — it could not express a mixed tree.
+ */
+export class MikroOrmRepositoryAdapter {
+    orm;
+    entity;
+    idField;
+    filterOptions;
+    /**
+     * Relation property name → the target entity's primary-key property.
+     * Resolved lazily: a bidirectional relation's target may not be registered
+     * with MikroORM's metadata storage at the time this adapter is built.
+     */
+    relationIdFields;
+    constructor(orm, metadata, options = {}) {
+        this.orm = orm;
+        this.entity = metadata.entity;
+        this.idField = metadata.idField;
+        this.filterOptions = {
+            idField: metadata.idField,
+            caseInsensitiveFilters: options.caseInsensitiveFilters ?? false,
+        };
+        const relationIdFields = new Map();
+        for (const relation of metadata.relations) {
+            relationIdFields.set(relation.name, () => {
+                const target = this.orm.getMetadata().getByClassName(relation.target().name, false);
+                return target?.primaryKeys[0] ?? "id";
+            });
+        }
+        this.relationIdFields = relationIdFields;
+    }
+    /** A clean, isolated `EntityManager` for one operation — see the class doc. */
+    fork() {
+        return this.orm.em.fork();
+    }
+    // ── Reads ────────────────────────────────────────────────────────────
+    async findOneById(id, query, context) {
+        try {
+            const include = query?.include ?? {};
+            const where = this.scopeToLive({ [this.idField]: id }, context, query?.withDeleted ?? false, query?.onlyDeleted ?? false);
+            const row = await this.fork().findOne(this.entity, where, this.populateOptions(include));
+            return row === null ? null : pruneIncluded(toPlain(row), include);
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async findOne(query, context) {
+        try {
+            // `em.find(…, { limit: 1 })` rather than `em.findOne`: MikroORM's
+            // validator rejects `em.findOne` with an empty `where` outright, and an
+            // unfiltered query is a legitimate shape here — `findOne`'s contract is
+            // "first match of the query, or null", and a query with no filter
+            // matches everything. `em.find` accepts it, so routing through it keeps
+            // the contract without an empty-where special case. The two are
+            // otherwise identical: `findOne` is itself a limit-1 `find`.
+            const rows = await this.fork().find(this.entity, this.buildWhere(query, context), {
+                ...this.buildFindOptions(query),
+                limit: 1,
+            });
+            const row = rows[0];
+            return row === undefined ? null : pruneIncluded(toPlain(row), query.include);
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async findMany(query, context) {
+        try {
+            const rows = await this.fork().find(this.entity, this.buildWhere(query, context), {
+                ...this.buildFindOptions(query),
+                offset: query.pagination.offset,
+                limit: query.pagination.limit,
+            });
+            return toPlainAll(rows).map((row) => pruneIncluded(row, query.include));
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async count(query, context) {
+        try {
+            // A dedicated count query — never fetch-then-length: the engine only
+            // calls this when `query.count` is true, so `total: null` costs zero
+            // queries. No populate: counting matching roots never needs their
+            // relations.
+            return await this.fork().count(this.entity, this.buildWhere(query, context));
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    /** The translated filter, narrowed to the request's soft-delete scope. */
+    buildWhere(query, context) {
+        return this.scopeToLive(translateFilter(query.filter, this.filterOptions), context, query.withDeleted, query.onlyDeleted);
+    }
+    buildFindOptions(query) {
+        const orderBy = query.sort.map((sort) => nestOrderBy(sort.field, sort.direction));
+        return {
+            ...(orderBy.length > 0 && { orderBy }),
+            ...this.populateOptions(query.include),
+        };
+    }
+    // ── Relation includes ───────────────────────────────────────────────
+    /**
+     * Translate a validated `IncludeTree` into MikroORM's `populate` paths.
+     *
+     * Soft-delete scoping of included rows is deliberately **not** done here —
+     * see {@link pruneIncluded}. MikroORM's `populateWhere` cannot express it:
+     * a nested condition (`{ articles: { deletedAt: null, notes: { deletedAt:
+     * null } } }`) is read as a relation-path predicate on the *parent*, so an
+     * article with no live notes is dropped from the parent's collection
+     * altogether rather than coming back with an empty one. The dotted spelling
+     * MikroORM rejects outright, and the parent-only spelling silently leaves
+     * every deeper level unscoped.
+     */
+    populateOptions(tree) {
+        const paths = populatePaths(tree);
+        return paths.length === 0 ? {} : { populate: paths };
+    }
+    // ── Soft delete ──────────────────────────────────────────────────────
+    /**
+     * Three-way soft-delete scope: exclude deleted rows by default, include
+     * both live and deleted with `withDeleted`, or restrict to only deleted
+     * with `onlyDeleted` (mutually exclusive — validated upstream).
+     *
+     * There is one shape to handle rather than TypeORM's two: MikroORM
+     * declares no delete-date column of its own, so the marker is always an
+     * ordinary property and always needs its predicate spelled out.
+     */
+    scopeToLive(where, context, withDeleted, onlyDeleted = false) {
+        const softDelete = context.config.softDelete;
+        if (softDelete.strategy !== "soft")
+            return where ?? {};
+        if (onlyDeleted)
+            return and(where, { [softDelete.field]: { $ne: null } });
+        if (withDeleted)
+            return where ?? {};
+        return and(where, { [softDelete.field]: { $eq: null } });
+    }
+    /** The resolved strategy, refused when an operation requires soft. */
+    requireSoftDelete(context, operation) {
+        const softDelete = context.config.softDelete;
+        if (softDelete.strategy !== "soft") {
+            throw new ConfigurationException(context.entityName, "softDelete", `'${operation}' requires a soft-deletable entity, but '${context.entityName}' ` +
+                `resolves to a hard delete strategy`);
+        }
+        return softDelete;
+    }
+    isDeleted(row, field) {
+        return row[field] !== null && row[field] !== undefined;
+    }
+    /** One row by id, as a plain object, under the given soft-delete scope. */
+    async byId(id, context, withDeleted) {
+        const where = this.scopeToLive({ [this.idField]: id }, context, withDeleted);
+        const row = await this.fork().findOne(this.entity, where);
+        return row === null ? null : toPlain(row);
+    }
+    // ── Writes ───────────────────────────────────────────────────────────
+    async create(data, context) {
+        try {
+            const em = this.fork();
+            const created = em.create(this.entity, this.toWriteData(data));
+            await em.flush();
+            return toPlain(created);
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async update(id, data, context) {
+        return this.mergeAndFlush(id, data, context);
+    }
+    async patch(id, data, context) {
+        return this.mergeAndFlush(id, data, context);
+    }
+    /**
+     * update and patch share one load-merge-flush primitive: the *shape* of
+     * `data` differs (full body vs. sparse) because the DTO layer differs, not
+     * the persistence mechanics.
+     *
+     * This goes through the Unit of Work rather than `nativeUpdate` — one
+     * managed entity, assigned and flushed — so lifecycle hooks,
+     * `onUpdate` properties, and relation diffing all behave as they would in
+     * a hand-written MikroORM application. The row is loaded first anyway, to
+     * turn a missing id into `NotFoundException`, so this costs no extra
+     * query.
+     */
+    async mergeAndFlush(id, data, context) {
+        try {
+            const em = this.fork();
+            // Scoped to live rows: a soft-deleted row is invisible to updates,
+            // exactly as it is to reads. Reviving one is `restore`'s job.
+            const where = this.scopeToLive({ [this.idField]: id }, context, false);
+            const existing = await em.findOne(this.entity, where);
+            if (existing === null)
+                throw this.notFound(id, context);
+            wrap(existing).assign(this.toWriteData(data), { em });
+            await em.flush();
+            return toPlain(existing);
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async delete(id, context) {
+        const softDelete = context.config.softDelete;
+        try {
+            if (softDelete.strategy === "hard") {
+                const affected = await this.fork().nativeDelete(this.entity, { [this.idField]: id });
+                if (affected === 0)
+                    throw this.notFound(id, context);
+                return;
+            }
+            const { field } = softDelete;
+            const existing = await this.byId(id, context, true);
+            if (existing === null)
+                throw this.notFound(id, context);
+            if (this.isDeleted(existing, field)) {
+                throw new AlreadyDeletedException({
+                    messageParams: { entity: context.entityName, id: String(id) },
+                    context: errorContext(context),
+                });
+            }
+            await this.fork().nativeUpdate(this.entity, { [this.idField]: id }, { [field]: new Date() });
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async restore(id, context) {
+        try {
+            const { field } = this.requireSoftDelete(context, "restore");
+            const existing = await this.byId(id, context, true);
+            if (existing === null)
+                throw this.notFound(id, context);
+            if (!this.isDeleted(existing, field)) {
+                throw new NotDeletedException({
+                    messageParams: { entity: context.entityName, id: String(id) },
+                    context: errorContext(context),
+                });
+            }
+            await this.fork().nativeUpdate(this.entity, { [this.idField]: id }, { [field]: null });
+            // Clearing the marker is a single-field write with no relation
+            // involvement, so the already-loaded row is corrected in place rather
+            // than re-read.
+            existing[field] = null;
+            return existing;
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    async purge(id, context) {
+        const softDelete = context.config.softDelete;
+        try {
+            if (softDelete.strategy === "soft") {
+                // Purge is the second step of a two-step delete: it removes a row
+                // that is already soft-deleted, never a live one.
+                const existing = await this.byId(id, context, true);
+                if (existing === null)
+                    throw this.notFound(id, context);
+                if (!this.isDeleted(existing, softDelete.field)) {
+                    throw new NotDeletedException({
+                        messageParams: { entity: context.entityName, id: String(id) },
+                        context: errorContext(context),
+                    });
+                }
+            }
+            const affected = await this.fork().nativeDelete(this.entity, { [this.idField]: id });
+            if (affected === 0)
+                throw this.notFound(id, context);
+        }
+        catch (error) {
+            throw mapDriverError(error, errorContext(context));
+        }
+    }
+    /**
+     * Normalize the engine's write payload for MikroORM.
+     *
+     * Core's default deserializer narrows a relation value to `{ id }` (or an
+     * array of them) — association by id, ADR-0014. MikroORM associates by
+     * *primary key value*, and would read a nested `{ id }` object as a
+     * request to create a new entity, so each relation value is unwrapped to
+     * the bare key before it reaches `create`/`assign`.
+     */
+    toWriteData(data) {
+        const result = { ...data };
+        for (const [name, idFieldOf] of this.relationIdFields) {
+            if (!(name in result))
+                continue;
+            result[name] = unwrapAssociation(result[name], idFieldOf());
+        }
+        return result;
+    }
+    notFound(id, context) {
+        return new NotFoundException({
+            messageParams: { entity: context.entityName, id: String(id) },
+            context: errorContext(context),
+        });
+    }
+}
+/**
+ * `{ id: 5 }` → `5`; arrays element-wise; scalars and `null` unchanged.
+ *
+ * An object carrying no id becomes `null` rather than being passed through.
+ * That mirrors core's own `associate()` exactly, and it matters because core
+ * only narrows a relation when the *target* entity is in its catalog — a
+ * relation whose target was never `createCrud`-ed arrives here as whatever
+ * the client sent. Handing that object to `em.create` would put a nested
+ * write one cascade setting away from working, which is precisely what
+ * ADR-0014 rules out: relations are associated by id, never deep-written.
+ */
+/**
+ * Apply the two include-tree rules core expects of a loaded row: every
+ * included relation is **present**, and no soft-deleted related row is in it.
+ *
+ * Both are done here, in memory, rather than in the query — see
+ * `populateOptions` for why `populateWhere` cannot do the second one without
+ * silently dropping parents. The cost is that soft-deleted related rows are
+ * fetched and then discarded; the alternative spellings are wrong rather than
+ * merely slower, so this is the honest trade. Soft-deleted *roots* are still
+ * excluded in SQL (`scopeToLive`), which is where the volume is.
+ *
+ * "Present" matters because core's serializer treats an absent key as "the
+ * adapter never hydrated this" and skips it — so an included to-many that
+ * matches nothing must be `[]`, not missing. A root `withDeleted` never
+ * widens an included relation: this prunes regardless of the root's scope.
+ */
+function pruneIncluded(row, tree) {
+    const source = row;
+    for (const node of Object.values(tree)) {
+        const name = node.relation.name;
+        const value = source[name];
+        const deleted = (candidate) => {
+            if (node.softDelete.strategy !== "soft")
+                return false;
+            const marker = candidate[node.softDelete.field];
+            return marker !== null && marker !== undefined;
+        };
+        if (Array.isArray(value)) {
+            const live = value.filter((child) => !deleted(child));
+            for (const child of live)
+                pruneIncluded(child, node.children);
+            source[name] = live;
+            continue;
+        }
+        // A to-one that was populated is an object; anything else (a bare foreign
+        // key from an uninitialized reference, `undefined`, `null`) becomes null.
+        if (value !== null && typeof value === "object" && !deleted(value)) {
+            pruneIncluded(value, node.children);
+            continue;
+        }
+        source[name] = node.relation.cardinality === "many" ? [] : null;
+    }
+    return row;
+}
+function unwrapAssociation(value, idField) {
+    if (value === null || value === undefined)
+        return null;
+    if (Array.isArray(value)) {
+        // Nulls are filtered, not mapped through, exactly as core's `associate`
+        // does: a to-many element carrying no id contributes nothing, and passing
+        // `[null]` to `em.create`/`assign` would fail at the driver as a 500
+        // instead of being ignored.
+        return value.map((element) => unwrapAssociation(element, idField)).filter((element) => element !== null);
+    }
+    if (typeof value === "object") {
+        return value[idField] ?? null;
+    }
+    return value;
+}
+/** Combine two predicates, keeping `undefined` from degenerating into `{}`. */
+function and(where, extra) {
+    return where === undefined ? extra : { $and: [where, extra] };
+}
+/** The include tree flattened to the dotted paths MikroORM's `populate` takes. */
+function populatePaths(tree, prefix = "") {
+    const paths = [];
+    for (const node of Object.values(tree)) {
+        const path = prefix === "" ? node.relation.name : `${prefix}.${node.relation.name}`;
+        paths.push(path);
+        paths.push(...populatePaths(node.children, path));
+    }
+    return paths;
+}
+/** `"author.name"` + `"asc"` → `{ author: { name: "asc" } }`. */
+function nestOrderBy(field, direction) {
+    const segments = field.split(".");
+    return segments.slice(0, -1).reduceRight((inner, segment) => ({ [segment]: inner }), {
+        [segments[segments.length - 1]]: direction,
+    });
+}
+function errorContext(context) {
+    return {
+        entityName: context.entityName,
+        operation: context.operation,
+        correlationId: context.correlationId,
+    };
+}
+//# sourceMappingURL=mikro-orm-repository-adapter.js.map

package/dist/mikro-orm-repository-adapter.js.map

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

package/dist/plain-entity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MikroORM entity instance → plain object, at the adapter boundary.
+ *
+ * This conversion is **required**, not a convenience. A MikroORM to-many
+ * relation is a `Collection<T>`, not an array, and core's `DefaultSerializer`
+ * branches on `Array.isArray` to decide whether an included relation is a
+ * list or a single row — a `Collection` would fall down the single-row path
+ * and serialize its internal fields instead of its items. `@kavo/mongoose`
+ * converts documents at the same seam and for the same reason: core consumes
+ * plain data, so the ORM's own row representation stops here.
+ *
+ * `wrap(entity).toObject()` is what performs it, which has two consequences
+ * worth naming because they are behavior, not implementation detail:
+ *
+ * 1. **Unpopulated relations collapse to their primary key.** A to-one that
+ *    was not populated comes back as the raw foreign key (`author: 1`) and a
+ *    to-many as `[]`. That is harmless — core's serializer emits a relation
+ *    key only for nodes on the request's include tree — and it is why a
+ *    relation must be `include=`d to appear as an object.
+ * 2. **MikroORM's own property options apply.** A custom `serializer` runs
+ *    before core ever sees the row, and a `@Property({ hidden: true })` is
+ *    dropped. The hidden case is belt-and-braces rather than the guard:
+ *    `buildEntityMetadata` excludes such a property from the seam entirely,
+ *    which is what keeps it off the default filter/sort allowlists too — a
+ *    column invisible in the body but filterable in the database would be a
+ *    blind extraction oracle. See doc 17, "Adapter-specific caveats".
+ */
+export declare function toPlain<Entity extends object>(entity: Entity): Entity;
+/** {@link toPlain} over a list, for the `findMany` path. */
+export declare function toPlainAll<Entity extends object>(entities: readonly Entity[]): readonly Entity[];
+//# sourceMappingURL=plain-entity.d.ts.map

package/dist/plain-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-entity.d.ts","sourceRoot":"","sources":["../src/plain-entity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,MAAM,SAAS,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAEhG"}

package/dist/plain-entity.js

@@ -0,0 +1,36 @@
+import { wrap } from "@mikro-orm/core";
+/**
+ * MikroORM entity instance → plain object, at the adapter boundary.
+ *
+ * This conversion is **required**, not a convenience. A MikroORM to-many
+ * relation is a `Collection<T>`, not an array, and core's `DefaultSerializer`
+ * branches on `Array.isArray` to decide whether an included relation is a
+ * list or a single row — a `Collection` would fall down the single-row path
+ * and serialize its internal fields instead of its items. `@kavo/mongoose`
+ * converts documents at the same seam and for the same reason: core consumes
+ * plain data, so the ORM's own row representation stops here.
+ *
+ * `wrap(entity).toObject()` is what performs it, which has two consequences
+ * worth naming because they are behavior, not implementation detail:
+ *
+ * 1. **Unpopulated relations collapse to their primary key.** A to-one that
+ *    was not populated comes back as the raw foreign key (`author: 1`) and a
+ *    to-many as `[]`. That is harmless — core's serializer emits a relation
+ *    key only for nodes on the request's include tree — and it is why a
+ *    relation must be `include=`d to appear as an object.
+ * 2. **MikroORM's own property options apply.** A custom `serializer` runs
+ *    before core ever sees the row, and a `@Property({ hidden: true })` is
+ *    dropped. The hidden case is belt-and-braces rather than the guard:
+ *    `buildEntityMetadata` excludes such a property from the seam entirely,
+ *    which is what keeps it off the default filter/sort allowlists too — a
+ *    column invisible in the body but filterable in the database would be a
+ *    blind extraction oracle. See doc 17, "Adapter-specific caveats".
+ */
+export function toPlain(entity) {
+    return wrap(entity).toObject();
+}
+/** {@link toPlain} over a list, for the `findMany` path. */
+export function toPlainAll(entities) {
+    return entities.map((entity) => toPlain(entity));
+}
+//# sourceMappingURL=plain-entity.js.map

package/dist/plain-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-entity.js","sourceRoot":"","sources":["../src/plain-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,OAAO,CAAwB,MAAc;IAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAY,CAAC;AAC3C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAwB,QAA2B;IAC3E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@kavo/mikroorm",
+  "version": "0.6.0",
+  "description": "Kavo MikroORM adapter — implements @kavo/core's RepositoryAdapter over a MikroORM EntityManager.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kavo-labs/kavo.git",
+    "directory": "packages/orms/mikroorm"
+  },
+  "homepage": "https://github.com/kavo-labs/kavo/tree/main/packages/orms/mikroorm#readme",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kavo/core": "workspace:^"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^7.0.0"
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "^7.1.9",
+    "@mikro-orm/decorators": "^7.1.9",
+    "@mikro-orm/sqlite": "^7.1.9",
+    "reflect-metadata": "^0.2.2"
+  }
+}