@t4h.framework/orm 0.10.2 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @t4h.framework/orm
 
+## 0.11.0
+
+### Minor Changes
+
+- [#201](https://github.com/tech4humans-brasil/framework/pull/201) [`374e2d7`](https://github.com/tech4humans-brasil/framework/commit/374e2d759ac1fda954981545a791652dede445ae) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Relations: `@ManyToOne` and `@OneToMany` link entities. The to-one side is a
+  `Ref<T>`, the many side is a lazy `MapCollection<T>` (`map`, `filter`,
+  `toArray`, `toRefCollection`, …), and `populate` on `getSnapshot` reads the
+  row and its nested relations in a single `ORMLoadActivity`, one query per
+  relation and level. The result is typed `Populated<T, P>`: a populated
+  `@ManyToOne` is the related row's snapshot (`null` when it no longer exists)
+  instead of a `Ref`. `RefCollection.getSnapshots`
+  reads every row of a collection in one activity, and a `RefCollection` now
+  serializes its `orm` and `table` too. `load(relation)` on a `Ref` or a
+  `RefCollection` follows a relation and returns refs only: a `@ManyToOne`
+  gives the related refs through one `ORMLoadRelationActivity`, a `@OneToMany`
+  gives a `MapCollection` (over every parent, for a collection) read only when
+  used. Owning columns store the related row ref and are indexed; `create`,
+  `update`, `upsert` and `where` accept a `Ref` for them, and `create` also
+  takes the data of new related rows on either side (`EntityCreateData`),
+  created level by level in one `ORMCreateActivity` per relation. `ORMClaim` gains the abstract
+  `getSnapshots`, which reads several rows at once and must be implemented by
+  every claim. `Ref.getSnapshot` now always runs `ORMLoadActivity` instead of
+  `ORMGetSnapshotActivity`, so runs started on an older version do not replay
+  it. Hosts must register `ORMLoadActivity`,
+  `ORMLoadRelationActivity` and the `orm:map-collection` codec kind.
+
 ## 0.10.2
 
 ## 0.10.1

package/README.md

@@ -21,6 +21,7 @@ abstract class ORMClaim<R extends SerializableRowRef> {
   public abstract getSnapshot(input: SerializableGetSnapshotInput<R>): SerializedRow | Promise<SerializedRow>
   public abstract update(input: SerializableUpdateInput<R>): void | Promise<void>
   public abstract remove(input: SerializableRemoveInput<R>): void | Promise<void>
+  public abstract getSnapshots(input: SerializableGetSnapshotsInput<R>): (SerializedRow | null)[] | Promise<(SerializedRow | null)[]>
   public abstract delete(input: SerializableDeleteInput): number | Promise<number>
 
   // Default: find, then create or update. Override for a native upsert.
@@ -222,11 +223,43 @@ const usersRef = await orm.find(User, { where: { active: true } })
 
 const users = usersRef.toArray()            // Ref<User>[]
 usersRef.forEach(ref => { /* ... */ })
-usersRef.map(ref => ref.getSnapshot())
+await usersRef.getSnapshots()               // (User | null)[] in one activity
 usersRef.filter(ref => { /* ... */ })
 usersRef.at(0)                              // Ref<User> | undefined
 ```
 
+## Relations
+
+`@ManyToOne` owns the relation and stores the related row in a column; `@OneToMany` reads it back from the other table. The to-one side is a `Ref<T>`, the many side a lazy `MapCollection<T>`:
+
+```typescript
+@Entity({ tableName: 'users' })
+class User {
+  @OneToMany(() => Post, { mappedBy: 'author' })
+  public posts!: MapCollection<Post>
+}
+
+@Entity({ tableName: 'posts' })
+class Post {
+  @ManyToOne(() => User)
+  public author!: Ref<User>
+}
+
+await orm.create(Post, { title: 'Hello', author: userRef })
+
+const aliceRef = await orm.findOne(User, { where: { name: 'Alice' } })
+
+const user = await aliceRef!.getSnapshot({
+  populate: ['posts'],          // read in the same activity
+})
+
+await user!.posts.map(post => post.title)
+
+const posts = await aliceRef!.load('posts') // MapCollection<Post>, read when used
+```
+
+See [docs/relations.md](./docs/relations.md).
+
 ## Query Operators
 
 The `where` clause supports the following operators:
@@ -251,7 +284,9 @@ The package includes the following activities (used internally by `ORM` and `Ref
 - `ORMCreateActivity` -- creates one or more rows
 - `ORMFindActivity` -- finds multiple rows
 - `ORMFindOneActivity` -- finds a single row
-- `ORMGetSnapshotActivity` -- retrieves full entity data from a ref
+- `ORMGetSnapshotActivity` -- retrieves full entity data from a ref (no longer used by `Ref.getSnapshot`)
+- `ORMLoadActivity` -- backs `getSnapshot` / `getSnapshots`: retrieves rows with their relations and `populate` in one activity
+- `ORMLoadRelationActivity` -- follows a to-one relation from one or more refs, returning refs
 - `ORMUpdateActivity` -- updates a row
 - `ORMUpsertActivity` -- inserts or updates rows by `conflictOn` (via `ORMClaim.upsert`)
 - `ORMRemoveActivity` -- removes a row

package/dist/activities/ORMLoadActivity.d.ts

@@ -0,0 +1,16 @@
+import { SyncActivity } from '@t4h.framework/core';
+import type { SerializableLoadInput, SerializableLoadedRow } from '../typings/ORM.js';
+declare const CLAIMS_KEY: unique symbol;
+export declare class ORMLoadActivity extends SyncActivity<[
+    input: SerializableLoadInput
+], SerializableLoadInput, (SerializableLoadedRow | null)[], (SerializableLoadedRow | null)[]> {
+    private readonly [CLAIMS_KEY];
+    toInput(input: SerializableLoadInput): SerializableLoadInput;
+    run(input: SerializableLoadInput): Promise<(SerializableLoadedRow | null)[]>;
+    toOutput(output: (SerializableLoadedRow | null)[]): (SerializableLoadedRow | null)[];
+    private read;
+    private fetch;
+    private populate;
+}
+export {};
+//# sourceMappingURL=ORMLoadActivity.d.ts.map

package/dist/activities/ORMLoadActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ORMLoadActivity.d.ts","sourceRoot":"","sources":["../../src/activities/ORMLoadActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,qBAAqB,CAAA;AAYzD,OAAO,KAAK,EAEV,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,mBAAmB,CAAA;AAE1B,QAAA,MAAM,UAAU,eAAqC,CAAA;AAErD,qBAAa,eAAgB,SAAQ,YAAY,CAC/C;IAAC,KAAK,EAAE,qBAAqB;CAAC,EAC9B,qBAAqB,EACrB,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,EAChC,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,CACjC;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAE3B;IAEK,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB;IAItD,GAAG,CAAC,KAAK,EAAE,qBAAqB;IAyBtC,QAAQ,CACb,MAAM,EAAE,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,GACvC,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE;YAIrB,IAAI;YA0BJ,KAAK;YAUL,QAAQ;CAyDvB"}

package/dist/activities/ORMLoadActivity.js

@@ -0,0 +1,90 @@
+import { SyncActivity, Claim } from '@t4h.framework/core';
+import { ORMClaim } from '../claims/ORMClaim.js';
+import { getEntityByTableName, getEntityRelations, getEntityTableName, getInverseRelation, } from '../decorators/metadata.js';
+import { Populate } from '../helpers/Populate.js';
+import { toRefKey } from '../helpers/toRefKey.js';
+const CLAIMS_KEY = Symbol('orm-load-activity-claims');
+export class ORMLoadActivity extends SyncActivity {
+    [CLAIMS_KEY] = new Claim({
+        orm: ORMClaim,
+    });
+    toInput(input) {
+        return input;
+    }
+    async run(input) {
+        const { orm, table } = input;
+        const tree = Populate.toTree(input.populate);
+        if ('where' in input) {
+            const rows = await this.fetch({
+                orm,
+                table,
+                where: input.where,
+                orderBy: input.orderBy,
+            });
+            await this.populate(orm, table, rows, tree);
+            return rows;
+        }
+        const rows = await this.read(orm, table, input.refs);
+        await this.populate(orm, table, [...rows.values()], tree);
+        return input.refs.map(ref => rows.get(toRefKey(ref)) ?? null);
+    }
+    toOutput(output) {
+        return output;
+    }
+    async read(orm, table, refs) {
+        const unique = [...new Map(refs.map(ref => [toRefKey(ref), ref])).values()];
+        const rows = new Map();
+        if (!unique.length)
+            return rows;
+        const snapshots = await this[CLAIMS_KEY].orm.getSnapshots({
+            orm,
+            table,
+            refs: unique,
+        });
+        unique.forEach((ref, index) => {
+            const data = snapshots[index];
+            if (data)
+                rows.set(toRefKey(ref), { ref, data, relations: {} });
+        });
+        return rows;
+    }
+    async fetch(input) {
+        const refs = await this[CLAIMS_KEY].orm.find(input);
+        const rows = await this.read(input.orm, input.table, refs);
+        return refs.flatMap(ref => rows.get(toRefKey(ref)) ?? []);
+    }
+    async populate(orm, table, rows, tree) {
+        if (!rows.length)
+            return;
+        const entity = getEntityByTableName(table);
+        for (const relation of getEntityRelations(entity).values()) {
+            const nested = tree.get(relation.name);
+            if (!nested)
+                continue;
+            const target = getEntityTableName(relation.entity());
+            if (relation.kind === 'one-to-many') {
+                const mappedBy = getInverseRelation(entity, relation).name;
+                const children = await this.fetch({
+                    orm,
+                    table: target,
+                    where: { [mappedBy]: { $in: rows.map(row => row.ref) } },
+                    orderBy: relation.orderBy,
+                });
+                await this.populate(orm, target, children, nested);
+                const groups = Map.groupBy(children, child => toRefKey(child.data[mappedBy]));
+                for (const row of rows)
+                    row.relations[relation.name] = groups.get(toRefKey(row.ref)) ?? [];
+                continue;
+            }
+            const refs = rows.map(row => row.data[relation.name] ?? null);
+            const related = await this.read(orm, target, refs.filter(ref => ref !== null));
+            await this.populate(orm, target, [...related.values()], nested);
+            rows.forEach((row, index) => {
+                const ref = refs[index];
+                if (ref !== null)
+                    row.relations[relation.name] = related.get(toRefKey(ref)) ?? null;
+            });
+        }
+    }
+}
+//# sourceMappingURL=ORMLoadActivity.js.map

package/dist/activities/ORMLoadActivity.js.map

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

package/dist/activities/ORMLoadRelationActivity.d.ts

@@ -0,0 +1,13 @@
+import { SyncActivity } from '@t4h.framework/core';
+import type { SerializableLoadRelationInput, SerializableRowRef } from '../typings/ORM.js';
+declare const CLAIMS_KEY: unique symbol;
+export declare class ORMLoadRelationActivity extends SyncActivity<[
+    input: SerializableLoadRelationInput
+], SerializableLoadRelationInput, (SerializableRowRef | null)[], (SerializableRowRef | null)[]> {
+    private readonly [CLAIMS_KEY];
+    toInput(input: SerializableLoadRelationInput): SerializableLoadRelationInput;
+    run({ orm, table, refs, relation: name, }: SerializableLoadRelationInput): Promise<(SerializableRowRef | null)[]>;
+    toOutput(output: (SerializableRowRef | null)[]): (SerializableRowRef | null)[];
+}
+export {};
+//# sourceMappingURL=ORMLoadRelationActivity.d.ts.map

package/dist/activities/ORMLoadRelationActivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ORMLoadRelationActivity.d.ts","sourceRoot":"","sources":["../../src/activities/ORMLoadRelationActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,qBAAqB,CAAA;AAOzD,OAAO,KAAK,EACV,6BAA6B,EAC7B,kBAAkB,EACnB,MAAM,mBAAmB,CAAA;AAE1B,QAAA,MAAM,UAAU,eAA8C,CAAA;AAE9D,qBAAa,uBAAwB,SAAQ,YAAY,CACvD;IAAC,KAAK,EAAE,6BAA6B;CAAC,EACtC,6BAA6B,EAC7B,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,EAC7B,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAC9B;IACC,OAAO,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAE3B;IAEK,OAAO,CACZ,KAAK,EAAE,6BAA6B,GACnC,6BAA6B;IAInB,GAAG,CAAC,EACf,GAAG,EACH,KAAK,EACL,IAAI,EACJ,QAAQ,EAAE,IAAI,GACf,EAAE,6BAA6B,GAAG,OAAO,CAAC,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,CAAC;IAWlE,QAAQ,CACb,MAAM,EAAE,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,GACpC,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE;CAGjC"}

package/dist/activities/ORMLoadRelationActivity.js

@@ -0,0 +1,23 @@
+import { SyncActivity, Claim } from '@t4h.framework/core';
+import { ORMClaim } from '../claims/ORMClaim.js';
+import { getEntityByTableName, getEntityRelations, } from '../decorators/metadata.js';
+const CLAIMS_KEY = Symbol('orm-load-relation-activity-claims');
+export class ORMLoadRelationActivity extends SyncActivity {
+    [CLAIMS_KEY] = new Claim({
+        orm: ORMClaim,
+    });
+    toInput(input) {
+        return input;
+    }
+    async run({ orm, table, refs, relation: name, }) {
+        const relation = getEntityRelations(getEntityByTableName(table)).get(name);
+        if (relation?.kind !== 'many-to-one')
+            throw new Error(`Table "${table}" has no @ManyToOne "${name}"`);
+        const rows = await this[CLAIMS_KEY].orm.getSnapshots({ orm, table, refs });
+        return rows.map(row => row?.[name] ?? null);
+    }
+    toOutput(output) {
+        return output;
+    }
+}
+//# sourceMappingURL=ORMLoadRelationActivity.js.map

package/dist/activities/ORMLoadRelationActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ORMLoadRelationActivity.js","sourceRoot":"","sources":["../../src/activities/ORMLoadRelationActivity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAA;AAMlC,MAAM,UAAU,GAAG,MAAM,CAAC,mCAAmC,CAAC,CAAA;AAE9D,MAAM,OAAO,uBAAwB,SAAQ,YAK5C;IACkB,CAAC,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC;QACxC,GAAG,EAAE,QAAQ;KACd,CAAC,CAAA;IAEK,OAAO,CACZ,KAAoC;QAEpC,OAAO,KAAK,CAAA;IACd,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,EACf,GAAG,EACH,KAAK,EACL,IAAI,EACJ,QAAQ,EAAE,IAAI,GACgB;QAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE1E,IAAI,QAAQ,EAAE,IAAI,KAAK,aAAa;YAClC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,wBAAwB,IAAI,GAAG,CAAC,CAAA;QAEjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAE1E,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAA;IAC7C,CAAC;IAEM,QAAQ,CACb,MAAqC;QAErC,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/claims/ORMClaim.d.ts

@@ -1,8 +1,14 @@
-import type { SerializableCreateInput, SerializableFindInput, SerializableGetSnapshotInput, SerializableRemoveInput, SerializableDeleteInput, SerializableUpdateInput, SerializableUpsertInput, SerializableRowRef, SerializedRow } from '../typings/ORM.js';
+import type { SerializableCreateInput, SerializableFindInput, SerializableGetSnapshotInput, SerializableGetSnapshotsInput, SerializableRemoveInput, SerializableDeleteInput, SerializableUpdateInput, SerializableUpsertInput, SerializableRowRef, SerializedRow } from '../typings/ORM.js';
+/**
+ * A @ManyToOne column must come back from `getSnapshot(s)` exactly as the ref
+ * `create` / `find` returned (same type, same key order): relations match rows
+ * by comparing the two.
+ */
 export declare abstract class ORMClaim<R extends SerializableRowRef> {
     abstract find(input: SerializableFindInput): R[] | Promise<R[]>;
     abstract create(input: SerializableCreateInput): R[] | Promise<R[]>;
     abstract getSnapshot(input: SerializableGetSnapshotInput<R>): SerializedRow | null | Promise<SerializedRow | null>;
+    abstract getSnapshots(input: SerializableGetSnapshotsInput<R>): (SerializedRow | null)[] | Promise<(SerializedRow | null)[]>;
     abstract update(input: SerializableUpdateInput<R>): void | Promise<void>;
     abstract remove(input: SerializableRemoveInput<R>): void | Promise<void>;
     upsert({ orm, table, conflictOn, data, }: SerializableUpsertInput): Promise<R[]>;

package/dist/claims/ORMClaim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ORMClaim.d.ts","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B,8BAAsB,QAAQ,CAAC,CAAC,SAAS,kBAAkB;aACzC,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAEtD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAE1D,WAAW,CACzB,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACrC,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;aAEvC,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;aAEP,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEV,MAAM,CAAC,EAClB,GAAG,EACH,KAAK,EACL,UAAU,EACV,IAAI,GACL,EAAE,uBAAuB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAwBzB,MAAM,CACpB,KAAK,EAAE,uBAAuB,GAC7B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"ORMClaim.d.ts","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACd,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,8BAAsB,QAAQ,CAAC,CAAC,SAAS,kBAAkB;aACzC,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAEtD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAE1D,WAAW,CACzB,KAAK,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACrC,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;aAEvC,YAAY,CAC1B,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GACtC,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC;aAE/C,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;aAEP,MAAM,CACpB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEV,MAAM,CAAC,EAClB,GAAG,EACH,KAAK,EACL,UAAU,EACV,IAAI,GACL,EAAE,uBAAuB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAwBzB,MAAM,CACpB,KAAK,EAAE,uBAAuB,GAC7B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAC5B"}

package/dist/claims/ORMClaim.js

@@ -1,3 +1,8 @@
+/**
+ * A @ManyToOne column must come back from `getSnapshot(s)` exactly as the ref
+ * `create` / `find` returned (same type, same key order): relations match rows
+ * by comparing the two.
+ */
 export class ORMClaim {
     async upsert({ orm, table, conflictOn, data, }) {
         const refs = [];

package/dist/claims/ORMClaim.js.map

@@ -1 +1 @@
-{"version":3,"file":"ORMClaim.js","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAYA,MAAM,OAAgB,QAAQ;IAiBrB,KAAK,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,KAAK,EACL,UAAU,EACV,IAAI,GACoB;QACxB,MAAM,IAAI,GAAQ,EAAE,CAAA;QAEpB,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAE,CAAC,CAAC,CAC3C,CAAA;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;YAEzE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;gBAEjE,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;YAEpD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CAKF"}
+{"version":3,"file":"ORMClaim.js","sourceRoot":"","sources":["../../src/claims/ORMClaim.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,OAAgB,QAAQ;IAqBrB,KAAK,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,KAAK,EACL,UAAU,EACV,IAAI,GACoB;QACxB,MAAM,IAAI,GAAQ,EAAE,CAAA;QAEpB,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAE,CAAC,CAAC,CAC3C,CAAA;YAED,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;YAEzE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;gBAEjE,SAAQ;YACV,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;YAEpD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CAKF"}

package/dist/decorators/ManyToOne.d.ts

@@ -0,0 +1,6 @@
+import type { EntityConstructor } from '../typings/ORM.js';
+export interface ManyToOneOptions {
+    nullable?: boolean;
+}
+export declare function ManyToOne(entity: () => EntityConstructor, options?: ManyToOneOptions): PropertyDecorator;
+//# sourceMappingURL=ManyToOne.d.ts.map

package/dist/decorators/ManyToOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManyToOne.d.ts","sourceRoot":"","sources":["../../src/decorators/ManyToOne.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,iBAAiB,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACzB,iBAAiB,CAenB"}

package/dist/decorators/ManyToOne.js

@@ -0,0 +1,15 @@
+import { getEntityMetadata } from './metadata.js';
+export function ManyToOne(entity, options) {
+    return (target, propertyKey) => {
+        const metadata = getEntityMetadata(target.constructor);
+        const name = propertyKey;
+        metadata.indexes.push({ properties: [name] });
+        metadata.relations.set(name, {
+            name,
+            kind: 'many-to-one',
+            entity,
+            nullable: options?.nullable,
+        });
+    };
+}
+//# sourceMappingURL=ManyToOne.js.map

package/dist/decorators/ManyToOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManyToOne.js","sourceRoot":"","sources":["../../src/decorators/ManyToOne.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAOjD,MAAM,UAAU,SAAS,CACvB,MAA+B,EAC/B,OAA0B;IAE1B,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAA4B,CAAC,CAAA;QAEvE,MAAM,IAAI,GAAG,WAAqB,CAAA;QAElC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAE7C,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;YAC3B,IAAI;YACJ,IAAI,EAAE,aAAa;YACnB,MAAM;YACN,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/decorators/OneToMany.d.ts

@@ -0,0 +1,7 @@
+import type { EntityConstructor } from '../typings/ORM.js';
+export interface OneToManyOptions {
+    mappedBy: string;
+    orderBy?: Record<string, 'asc' | 'desc'>;
+}
+export declare function OneToMany(entity: () => EntityConstructor, options: OneToManyOptions): PropertyDecorator;
+//# sourceMappingURL=OneToMany.d.ts.map

package/dist/decorators/OneToMany.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OneToMany.d.ts","sourceRoot":"","sources":["../../src/decorators/OneToMany.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA;CACzC;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,iBAAiB,EAC/B,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CAmBnB"}

package/dist/decorators/OneToMany.js

@@ -0,0 +1,17 @@
+import { getEntityMetadata } from './metadata.js';
+export function OneToMany(entity, options) {
+    return (target, propertyKey) => {
+        if (!options?.mappedBy)
+            throw new Error(`@OneToMany "${String(propertyKey)}" requires a mappedBy property`);
+        const metadata = getEntityMetadata(target.constructor);
+        const name = propertyKey;
+        metadata.relations.set(name, {
+            name,
+            kind: 'one-to-many',
+            entity,
+            mappedBy: options.mappedBy,
+            orderBy: options.orderBy,
+        });
+    };
+}
+//# sourceMappingURL=OneToMany.js.map

package/dist/decorators/OneToMany.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OneToMany.js","sourceRoot":"","sources":["../../src/decorators/OneToMany.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAQjD,MAAM,UAAU,SAAS,CACvB,MAA+B,EAC/B,OAAyB;IAEzB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,IAAI,CAAC,OAAO,EAAE,QAAQ;YACpB,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,WAAW,CAAC,gCAAgC,CACnE,CAAA;QAEH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAA4B,CAAC,CAAA;QAEvE,MAAM,IAAI,GAAG,WAAqB,CAAA;QAElC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;YAC3B,IAAI;YACJ,IAAI,EAAE,aAAa;YACnB,MAAM;YACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/decorators/metadata.d.ts

@@ -3,8 +3,23 @@ import type { IndexMetadata } from './Index.js';
 export interface EntityMetadata {
     tableName?: string;
     properties: Map<string, PropertyMetadata>;
+    relations: Map<string, RelationMetadata>;
     indexes: Array<IndexMetadata>;
 }
+export interface ManyToOneMetadata {
+    name: string;
+    kind: 'many-to-one';
+    entity: () => new (...args: any[]) => any;
+    nullable?: boolean;
+}
+export interface OneToManyMetadata {
+    name: string;
+    kind: 'one-to-many';
+    entity: () => new (...args: any[]) => any;
+    mappedBy: string;
+    orderBy?: Record<string, 'asc' | 'desc'>;
+}
+export type RelationMetadata = ManyToOneMetadata | OneToManyMetadata;
 export interface PropertyMetadata {
     name: string;
     type?: string;
@@ -17,4 +32,6 @@ export declare function getEntityTableName(target: new (...args: any[]) => any):
 export declare function getEntityProperties(target: new (...args: any[]) => any): Map<string, PropertyMetadata>;
 export declare function registerEntity(target: new (...args: any[]) => any): void;
 export declare function getEntityByTableName(tableName: string): new (...args: any[]) => any;
+export declare function getEntityRelations(target: new (...args: any[]) => any): Map<string, RelationMetadata>;
+export declare function getInverseRelation(owner: new (...args: any[]) => any, relation: OneToManyMetadata): ManyToOneMetadata;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/decorators/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAMD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,cAAc,CAShB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI,CAExE;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAChB,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAS7B"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACxC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,MAAM,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,MAAM,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,CAAA;CACzC;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAMD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,cAAc,CAShB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI,CAExE;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAChB,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAS7B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAClC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAE/B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CAWnB"}

package/dist/decorators/metadata.js

@@ -3,7 +3,7 @@ const entityRegistry = new Map();
 export function getEntityMetadata(target) {
     let metadata = entityMetadataMap.get(target.prototype);
     if (!metadata) {
-        metadata = { properties: new Map(), indexes: [] };
+        metadata = { properties: new Map(), relations: new Map(), indexes: [] };
         entityMetadataMap.set(target.prototype, metadata);
     }
     return metadata;
@@ -24,4 +24,14 @@ export function getEntityByTableName(tableName) {
         throw new Error(`Could not find an entity for table "${tableName}": is it decorated with @Entity?`);
     return entity;
 }
+export function getEntityRelations(target) {
+    return getEntityMetadata(target).relations;
+}
+export function getInverseRelation(owner, relation) {
+    const target = relation.entity();
+    const inverse = getEntityRelations(target).get(relation.mappedBy);
+    if (inverse?.kind !== 'many-to-one' || inverse.entity() !== owner)
+        throw new Error(`Relation "${owner.name}.${relation.name}" is mapped by "${target.name}.${relation.mappedBy}", which must be a @ManyToOne to ${owner.name}`);
+    return inverse;
+}
 //# sourceMappingURL=metadata.js.map

package/dist/decorators/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAkBA,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAA0B,CAAA;AAE/D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuC,CAAA;AAErE,MAAM,UAAU,iBAAiB,CAC/B,MAAmC;IAEnC,IAAI,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QACjD,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE1C,OAAO,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmC;IAChE,cAAc,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAiB;IAEjB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAE5C,IAAI,CAAC,MAAM;QACT,MAAM,IAAI,KAAK,CACb,uCAAuC,SAAS,kCAAkC,CACnF,CAAA;IAEH,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAoCA,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAA0B,CAAA;AAE/D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuC,CAAA;AAErE,MAAM,UAAU,iBAAiB,CAC/B,MAAmC;IAEnC,IAAI,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAEtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;QACvE,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAE1C,OAAO,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmC;IAChE,cAAc,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAiB;IAEjB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAE5C,IAAI,CAAC,MAAM;QACT,MAAM,IAAI,KAAK,CACb,uCAAuC,SAAS,kCAAkC,CACnF,CAAA;IAEH,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAmC;IAEnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAkC,EAClC,QAA2B;IAE3B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;IAEhC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEjE,IAAI,OAAO,EAAE,IAAI,KAAK,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,KAAK,KAAK;QAC/D,MAAM,IAAI,KAAK,CACb,aAAa,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,mBAAmB,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,oCAAoC,KAAK,CAAC,IAAI,EAAE,CAC5I,CAAA;IAEH,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/helpers/Insert.d.ts

@@ -0,0 +1,22 @@
+import type { EntityConstructor } from '../typings/ORM.js';
+export declare namespace Insert {
+    type Row = Record<string, unknown>;
+    interface Parents {
+        relation: string;
+        plan: Plan;
+        rows: number[];
+    }
+    interface Children {
+        relation: string;
+        plan: Plan;
+        parents: number[];
+    }
+    interface Plan {
+        entity: EntityConstructor;
+        rows: Row[];
+        parents: Parents[];
+        children: Children[];
+    }
+    function plan(entity: EntityConstructor, data: Row[], filled?: string): Promise<Plan>;
+}
+//# sourceMappingURL=Insert.d.ts.map

package/dist/helpers/Insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Insert.d.ts","sourceRoot":"","sources":["../../src/helpers/Insert.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,mBAAmB,CAAA;AAEzE,yBAAiB,MAAM,CAAC;IACtB,KAAY,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEzC,UAAiB,OAAO;QACtB,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,IAAI,CAAA;QACV,IAAI,EAAE,MAAM,EAAE,CAAA;KACf;IAED,UAAiB,QAAQ;QACvB,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,IAAI,CAAA;QACV,OAAO,EAAE,MAAM,EAAE,CAAA;KAClB;IAED,UAAiB,IAAI;QACnB,MAAM,EAAE,iBAAiB,CAAA;QACzB,IAAI,EAAE,GAAG,EAAE,CAAA;QACX,OAAO,EAAE,OAAO,EAAE,CAAA;QAClB,QAAQ,EAAE,QAAQ,EAAE,CAAA;KACrB;IAQD,SAAsB,IAAI,CACxB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA0Ff;CACF"}

package/dist/helpers/Insert.js

@@ -0,0 +1,73 @@
+import { isPlainObject } from './isPlainObject.js';
+import { Serialize } from './Serialize.js';
+import { applyDefaultProperties } from '../constraints/apply-default-properties.js';
+import { assertConstraints } from '../constraints/assert-constraints.js';
+import { getEntityMetadata, getEntityRelations, getInverseRelation, } from '../decorators/metadata.js';
+import { ConstraintError } from '../errors/ConstraintError.js';
+export var Insert;
+(function (Insert) {
+    const group = (groups, key, create) => {
+        if (!groups.has(key))
+            groups.set(key, create());
+        return groups.get(key);
+    };
+    async function plan(entity, data, filled) {
+        const relations = getEntityRelations(entity);
+        const parents = new Map();
+        const children = new Map();
+        const rows = data.map((raw, index) => {
+            const row = { ...raw };
+            if (filled && row[filled] !== undefined)
+                throw new ConstraintError(`Property "${filled}" is set by the row it is nested in`);
+            const later = filled ? [filled] : [];
+            for (const relation of relations.values()) {
+                const { name } = relation;
+                const value = row[name];
+                if (relation.kind === 'many-to-one') {
+                    if (!isPlainObject(value))
+                        continue;
+                    const parent = group(parents, name, () => ({ data: [], rows: [] }));
+                    parent.data.push(value);
+                    parent.rows.push(index);
+                    later.push(name);
+                    delete row[name];
+                    continue;
+                }
+                if (value === undefined)
+                    continue;
+                if (!Array.isArray(value) || !value.every(isPlainObject))
+                    throw new ConstraintError(`Property "${name}" takes the data of new ${relation.entity().name} rows`);
+                const child = group(children, name, () => ({ data: [], parents: [] }));
+                for (const item of value) {
+                    child.data.push(item);
+                    child.parents.push(index);
+                }
+                delete row[name];
+            }
+            Serialize.assertRelations(entity, [row], { except: later });
+            return row;
+        });
+        const defaulted = applyDefaultProperties(rows, getEntityMetadata(entity));
+        await assertConstraints(entity, defaulted);
+        return {
+            entity,
+            rows: defaulted,
+            parents: await Promise.all([...parents].map(async ([relation, parent]) => ({
+                relation,
+                plan: await plan(relations.get(relation).entity(), parent.data),
+                rows: parent.rows,
+            }))),
+            children: await Promise.all([...children].map(async ([name, child]) => {
+                const relation = relations.get(name);
+                const inverse = getInverseRelation(entity, relation).name;
+                return {
+                    relation: inverse,
+                    plan: await plan(relation.entity(), child.data, inverse),
+                    parents: child.parents,
+                };
+            })),
+        };
+    }
+    Insert.plan = plan;
+})(Insert || (Insert = {}));
+//# sourceMappingURL=Insert.js.map

package/dist/helpers/Insert.js.map

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

package/dist/helpers/Populate.d.ts

@@ -0,0 +1,13 @@
+import type { EntityConstructor } from '../typings/ORM.js';
+import type { RelationKey, Related } from '../typings/Relations.js';
+type Depth = [never, 0, 1, 2, 3];
+export type Populate<T, D extends number = 4> = [D] extends [never] ? never : {
+    [K in RelationKey<T>]: K | `${K}.${Populate<Related<T[K]>, Depth[D]>}`;
+}[RelationKey<T>];
+export declare namespace Populate {
+    type Tree = Map<string, Tree>;
+    function toTree(paths: readonly string[]): Tree;
+    function assert(entity: EntityConstructor, paths: readonly string[]): void;
+}
+export {};
+//# sourceMappingURL=Populate.d.ts.map

package/dist/helpers/Populate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Populate.d.ts","sourceRoot":"","sources":["../../src/helpers/Populate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEnE,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAEhC,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAC/D,KAAK,GACL;KACG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;CACvE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;AAErB,yBAAiB,QAAQ,CAAC;IACxB,KAAY,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAEpC,SAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAcrD;IAED,SAAgB,MAAM,CACpB,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,IAAI,CAiBN;CACF"}

package/dist/helpers/Populate.js

@@ -0,0 +1,31 @@
+import { getEntityRelations, } from '../decorators/metadata.js';
+export var Populate;
+(function (Populate) {
+    function toTree(paths) {
+        const tree = new Map();
+        for (const path of paths) {
+            let node = tree;
+            for (const segment of path.split('.')) {
+                if (!node.has(segment))
+                    node.set(segment, new Map());
+                node = node.get(segment);
+            }
+        }
+        return tree;
+    }
+    Populate.toTree = toTree;
+    function assert(entity, paths) {
+        const visit = (target, tree, at) => {
+            const relations = getEntityRelations(target);
+            for (const [name, nested] of tree) {
+                const relation = relations.get(name);
+                if (!relation)
+                    throw new Error(`Cannot populate "${at}${name}": "${target.name}" has no relation "${name}"`);
+                visit(relation.entity(), nested, `${at}${name}.`);
+            }
+        };
+        visit(entity, toTree(paths), '');
+    }
+    Populate.assert = assert;
+})(Populate || (Populate = {}));
+//# sourceMappingURL=Populate.js.map

package/dist/helpers/Populate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Populate.js","sourceRoot":"","sources":["../../src/helpers/Populate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAA;AAYlC,MAAM,KAAW,QAAQ,CAwCxB;AAxCD,WAAiB,QAAQ;IAGvB,SAAgB,MAAM,CAAC,KAAwB;QAC7C,MAAM,IAAI,GAAS,IAAI,GAAG,EAAE,CAAA;QAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,GAAG,IAAI,CAAA;YAEf,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;gBAEpD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAE,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAde,eAAM,SAcrB,CAAA;IAED,SAAgB,MAAM,CACpB,MAAyB,EACzB,KAAwB;QAExB,MAAM,KAAK,GAAG,CAAC,MAAyB,EAAE,IAAU,EAAE,EAAU,EAAE,EAAE;YAClE,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;YAE5C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAiC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAElE,IAAI,CAAC,QAAQ;oBACX,MAAM,IAAI,KAAK,CACb,oBAAoB,EAAE,GAAG,IAAI,OAAO,MAAM,CAAC,IAAI,sBAAsB,IAAI,GAAG,CAC7E,CAAA;gBAEH,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAA;YACnD,CAAC;QACH,CAAC,CAAA;QAED,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IAClC,CAAC;IApBe,eAAM,SAoBrB,CAAA;AACH,CAAC,EAxCgB,QAAQ,KAAR,QAAQ,QAwCxB"}