joist-orm 0.1.536 → 1.0.0

package/build/src/drivers/PostgresDriver.d.ts

@@ -0,0 +1,40 @@
+import { Knex } from "knex";
+import { Entity, EntityConstructor, EntityManager, EntityMetadata, FilterAndSettings, OneToManyCollection } from "../index";
+import { ManyToManyCollection, OneToOneReferenceImpl } from "../relations";
+import { JoinRow } from "../relations/ManyToManyCollection";
+import { JoinRowTodo, Todo } from "../Todo";
+import { Driver } from "./driver";
+import { IdAssigner } from "./IdAssigner";
+export interface PostgresDriverOpts {
+    idAssigner?: IdAssigner;
+}
+/**
+ * Implements the `Driver` interface for Postgres.
+ *
+ * This is the canonical driver implementation and leverages several aspects of
+ * Postgres for the best performance, i.e.:
+ *
+ * - Deferred foreign key constraints are used to allow bulk inserting/updating
+ * all entities without any topographic sorting/ordering issues.
+ *
+ * - Sequences are used to bulk-assign + then bulk-insert all entities, to again
+ * avoid issues with ordering issues (cannot bulk insert A w/o knowing the id of B).
+ *
+ * - We use a pg-specific bulk update syntax.
+ */
+export declare class PostgresDriver implements Driver {
+    private readonly knex;
+    private readonly idAssigner;
+    constructor(knex: Knex, opts?: PostgresDriverOpts);
+    load<T extends Entity>(em: EntityManager, meta: EntityMetadata<T>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    loadManyToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: ManyToManyCollection<T, U>, keys: readonly string[]): Promise<JoinRow[]>;
+    findManyToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: ManyToManyCollection<T, U>, keys: readonly string[]): Promise<JoinRow[]>;
+    loadOneToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: OneToManyCollection<T, U>, untaggedIds: readonly string[]): Promise<U[]>;
+    findOneToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: OneToManyCollection<T, U>, keys: readonly string[]): Promise<U[]>;
+    loadOneToOne<T extends Entity, U extends Entity>(em: EntityManager, reference: OneToOneReferenceImpl<T, U>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    find<T extends Entity>(em: EntityManager, type: EntityConstructor<T>, queries: FilterAndSettings<T>[]): Promise<unknown[][]>;
+    transaction<T>(em: EntityManager, fn: (txn: Knex.Transaction) => Promise<T>, isolationLevel?: "serializable"): Promise<T>;
+    flushEntities(em: EntityManager, todos: Record<string, Todo>): Promise<void>;
+    flushJoinTables(em: EntityManager, joinRows: Record<string, JoinRowTodo>): Promise<void>;
+    private getMaybeInTxnKnex;
+}

package/build/src/drivers/PostgresDriver.js

@@ -0,0 +1,376 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresDriver = void 0;
+const findDataLoader_1 = require("../dataloaders/findDataLoader");
+const index_1 = require("../index");
+const utils_1 = require("../utils");
+const IdAssigner_1 = require("./IdAssigner");
+/**
+ * Implements the `Driver` interface for Postgres.
+ *
+ * This is the canonical driver implementation and leverages several aspects of
+ * Postgres for the best performance, i.e.:
+ *
+ * - Deferred foreign key constraints are used to allow bulk inserting/updating
+ * all entities without any topographic sorting/ordering issues.
+ *
+ * - Sequences are used to bulk-assign + then bulk-insert all entities, to again
+ * avoid issues with ordering issues (cannot bulk insert A w/o knowing the id of B).
+ *
+ * - We use a pg-specific bulk update syntax.
+ */
+class PostgresDriver {
+    constructor(knex, opts) {
+        this.knex = knex;
+        this.idAssigner = opts?.idAssigner ?? new IdAssigner_1.SequenceIdAssigner();
+    }
+    load(em, meta, untaggedIds) {
+        const knex = this.getMaybeInTxnKnex(em);
+        return knex.select("*").from(meta.tableName).whereIn("id", untaggedIds);
+    }
+    loadManyToMany(em, collection, keys) {
+        const knex = this.getMaybeInTxnKnex(em);
+        // Break out `column_id=string` keys out
+        const columns = {};
+        keys.forEach((key) => {
+            const [columnId, id] = key.split("=");
+            (0, utils_1.getOrSet)(columns, columnId, []).push(id);
+        });
+        // Or together `where tag_id in (...)` or `book_id in (...)`
+        let query = knex.select("*").from(collection.joinTableName);
+        Object.entries(columns).forEach(([columnId, values]) => {
+            // Pick the right meta i.e. tag_id --> TagMeta or book_id --> BookMeta
+            const meta = collection.columnName == columnId ? (0, index_1.getMetadata)(collection.entity) : collection.otherMeta;
+            query = query.orWhereIn(columnId, values.map((id) => (0, index_1.keyToNumber)(meta, id)));
+        });
+        return query.orderBy("id");
+    }
+    findManyToMany(em, collection, keys) {
+        const knex = this.getMaybeInTxnKnex(em);
+        // Or together `where (tag_id = X and book_id = Y)` or `(book_id = B and tag_id = A)`
+        let query = knex.select("*").from(collection.joinTableName);
+        keys.forEach((key) => {
+            const [one, two] = key.split(",");
+            const [columnOne, idOne] = one.split("=");
+            const [columnTwo, idTwo] = two.split("=");
+            const [meta1, meta2] = collection.columnName === columnOne
+                ? [collection.meta, collection.otherMeta]
+                : [collection.otherMeta, collection.meta];
+            // Pick the right meta i.e. tag_id --> TagMeta or book_id --> BookMeta
+            query = query.orWhere((q) => {
+                q.where(columnOne, (0, index_1.keyToNumber)(meta1, idOne)).andWhere(columnTwo, (0, index_1.keyToNumber)(meta2, idTwo));
+            });
+        });
+        return query.orderBy("id");
+    }
+    loadOneToMany(em, collection, untaggedIds) {
+        const knex = this.getMaybeInTxnKnex(em);
+        return knex
+            .select("*")
+            .from(collection.otherMeta.tableName)
+            .whereIn(collection.otherColumnName, untaggedIds)
+            .orderBy("id");
+    }
+    findOneToMany(em, collection, keys) {
+        const knex = this.getMaybeInTxnKnex(em);
+        let query = knex.select("*").from(collection.otherMeta.tableName);
+        // Or together `where (id = X and book_id = Y)`
+        keys.forEach((key) => {
+            const [one, two] = key.split(",");
+            // columnOne is the `id=`, so is really the "other" side of the o2m
+            const [columnOne, idOne] = one.split("=");
+            const [columnTwo, idTwo] = two.split("=");
+            const [meta1, meta2] = [collection.otherMeta, collection.meta];
+            // Pick the right meta i.e. tag_id --> TagMeta or book_id --> BookMeta
+            query = query.orWhere((q) => {
+                q.where(columnOne, (0, index_1.keyToNumber)(meta1, idOne)).andWhere(columnTwo, (0, index_1.keyToNumber)(meta2, idTwo));
+            });
+        });
+        return query.orderBy("id");
+    }
+    loadOneToOne(em, reference, untaggedIds) {
+        const knex = this.getMaybeInTxnKnex(em);
+        return knex
+            .select("*")
+            .from(reference.otherMeta.tableName)
+            .whereIn(reference.otherColumnName, untaggedIds)
+            .orderBy("id");
+    }
+    async find(em, type, queries) {
+        const knex = this.getMaybeInTxnKnex(em);
+        // If there is only 1 query, we can skip the tagging step.
+        if (queries.length === 1) {
+            return [ensureUnderLimit(await (0, index_1.buildQuery)(knex, type, queries[0]))];
+        }
+        // Map each incoming query[i] to itself or a previous dup
+        const uniqueQueries = [];
+        const queryToUnique = {};
+        queries.forEach((q, i) => {
+            let j = uniqueQueries.findIndex((uq) => (0, findDataLoader_1.whereFilterHash)(uq) === (0, findDataLoader_1.whereFilterHash)(q));
+            if (j === -1) {
+                uniqueQueries.push(q);
+                j = uniqueQueries.length - 1;
+            }
+            queryToUnique[i] = j;
+        });
+        // There are duplicate queries, but only one unique query, so we can execute just it w/o tagging.
+        if (uniqueQueries.length === 1) {
+            const rows = ensureUnderLimit(await (0, index_1.buildQuery)(knex, type, queries[0]));
+            // Reuse this same result for however many callers asked for it.
+            return queries.map(() => rows);
+        }
+        // TODO: Instead of this tagged approach, we could probably check if the each
+        // where cause: a) has the same structure for joins, and b) has conditions that
+        // we can evaluate client-side, and then combine it into a query like:
+        //
+        // SELECT entity.*, t1.foo as condition1, t2.bar as condition2 FROM ...
+        // WHERE t1.foo (union of each queries condition)
+        //
+        // And then use the `condition1` and `condition2` to tease the combined result set
+        // back apart into each condition's result list.
+        // For each query, add an additional `__tag` column that will identify that query's
+        // corresponding rows in the combined/UNION ALL'd result set.
+        //
+        // We also add a `__row` column with that queries order, so that after we `UNION ALL`,
+        // we can order by `__tag` + `__row` and ensure we're getting back the combined rows
+        // exactly as they would be in done individually (i.e. per the docs `UNION ALL` does
+        // not guarantee order).
+        const tagged = uniqueQueries.map((queryAndSettings, i) => {
+            const query = (0, index_1.buildQuery)(knex, type, queryAndSettings);
+            return query.select(knex.raw(`${i} as __tag`), knex.raw("row_number() over () as __row"));
+        });
+        const meta = (0, index_1.getMetadata)(type);
+        // Kind of dumb, but make a dummy row to start our query with
+        let query = knex
+            .select("*", knex.raw("-1 as __tag"), knex.raw("-1 as __row"))
+            .from(meta.tableName)
+            .orderBy("__tag", "__row")
+            .where({ id: -1 });
+        // Use the dummy query as a base, then `UNION ALL` in all the rest
+        tagged.forEach((add) => {
+            query = query.unionAll(add, true);
+        });
+        // Issue a single SQL statement for all of them
+        const rows = ensureUnderLimit(await query);
+        const resultForUniques = [];
+        uniqueQueries.forEach((q, i) => {
+            resultForUniques[i] = [];
+        });
+        rows.forEach((row) => {
+            resultForUniques[row["__tag"]].push(row);
+        });
+        // We return an array-of-arrays, where result[i] is the rows for queries[i]
+        const result = [];
+        queries.forEach((q, i) => {
+            result[i] = resultForUniques[queryToUnique[i]];
+        });
+        return result;
+    }
+    async transaction(em, fn, isolationLevel) {
+        const knex = this.getMaybeInTxnKnex(em);
+        const alreadyInTxn = "commit" in knex;
+        if (alreadyInTxn) {
+            return fn(knex);
+        }
+        return await knex.transaction(async (txn) => {
+            em.currentTxnKnex = txn;
+            try {
+                if (isolationLevel) {
+                    await txn.raw("set transaction isolation level serializable;");
+                }
+                await (0, index_1.beforeTransaction)(em, txn);
+                const result = await fn(txn);
+                await (0, index_1.afterTransaction)(em, txn);
+                return result;
+            }
+            finally {
+                em.currentTxnKnex = undefined;
+            }
+        });
+    }
+    async flushEntities(em, todos) {
+        const knex = this.getMaybeInTxnKnex(em);
+        const updatedAt = new Date();
+        await this.idAssigner.assignNewIds(knex, todos);
+        for await (const todo of Object.values(todos)) {
+            if (todo) {
+                const meta = todo.metadata;
+                if (todo.inserts.length > 0) {
+                    await batchInsert(knex, meta, todo.inserts);
+                }
+                if (todo.updates.length > 0) {
+                    todo.updates.forEach((e) => {
+                        // Should we just go through a setter?
+                        e.__orm.originalData["updatedAt"] = e.__orm.data["updatedAt"];
+                        e.__orm.data["updatedAt"] = updatedAt;
+                    });
+                    await batchUpdate(knex, meta, todo.updates);
+                }
+                if (todo.deletes.length > 0) {
+                    await batchDelete(knex, meta, todo.deletes);
+                }
+            }
+        }
+    }
+    async flushJoinTables(em, joinRows) {
+        const knex = this.getMaybeInTxnKnex(em);
+        for await (const [joinTableName, { m2m, newRows, deletedRows }] of Object.entries(joinRows)) {
+            if (newRows.length > 0) {
+                const sql = cleanSql(`
+          INSERT INTO ${joinTableName} (${m2m.columnName}, ${m2m.otherColumnName})
+          VALUES ${(0, utils_1.zeroTo)(newRows.length)
+                    .map(() => "(?, ?) ")
+                    .join(", ")}
+          ON CONFLICT (${m2m.columnName}, ${m2m.otherColumnName}) DO UPDATE SET id = ${joinTableName}.id
+          RETURNING id;
+        `);
+                const meta1 = (0, index_1.getMetadata)(m2m.entity);
+                const meta2 = m2m.otherMeta;
+                const bindings = newRows.flatMap((row) => {
+                    return [
+                        (0, index_1.keyToNumber)(meta1, (0, index_1.maybeResolveReferenceToId)(row[m2m.columnName])),
+                        (0, index_1.keyToNumber)(meta2, (0, index_1.maybeResolveReferenceToId)(row[m2m.otherColumnName])),
+                    ];
+                });
+                const { rows } = await knex.raw(sql, bindings);
+                for (let i = 0; i < rows.length; i++) {
+                    newRows[i].id = rows[i].id;
+                }
+            }
+            if (deletedRows.length > 0) {
+                // `remove`s that were done against unloaded ManyToManyCollections will not have row ids
+                const [haveIds, noIds] = (0, utils_1.partition)(deletedRows, (r) => r.id !== -1);
+                if (haveIds.length > 0) {
+                    await knex(joinTableName)
+                        .del()
+                        .whereIn("id", haveIds.map((e) => e.id));
+                }
+                if (noIds.length > 0) {
+                    const data = noIds.map((e) => [
+                        (0, index_1.deTagId)(m2m.meta, (0, index_1.maybeResolveReferenceToId)(e[m2m.columnName])),
+                        (0, index_1.deTagId)(m2m.otherMeta, (0, index_1.maybeResolveReferenceToId)(e[m2m.otherColumnName])),
+                    ]);
+                    await knex(joinTableName).del().whereIn([m2m.columnName, m2m.otherColumnName], data);
+                }
+            }
+        }
+    }
+    getMaybeInTxnKnex(em) {
+        return em.currentTxnKnex || this.knex;
+    }
+}
+exports.PostgresDriver = PostgresDriver;
+async function batchInsert(knex, meta, entities) {
+    // We don't use the ids that come back from batchInsert b/c we pre-assign ids for both inserts and updates.
+    // We also use `.transacting` b/c even when `knex` is already a Transaction object,
+    // `batchInsert` w/o the `transacting` adds savepoints that we don't want/need.
+    const fields = Object.values(meta.fields).filter(index_1.hasSerde);
+    const columns = fields.flatMap((f) => f.serde.columns);
+    // Issue 1 UPDATE statement with N `VALUES (..., ...), (..., ...), ...` clauses
+    // and bindings is each individual value.
+    const bindings = entities.flatMap((entity) => columns.map((c) => c.dbValue(entity.__orm.data) ?? null));
+    const sql = `
+    INSERT INTO ${meta.tableName} (${columns.map((c) => `"${c.columnName}"`).join(", ")})
+    VALUES ${entities.map(() => `(${columns.map(() => `?`).join(", ")})`).join(",")}
+  `;
+    await knex.raw(cleanSql(sql), bindings);
+}
+// Uses a pg-specific syntax to issue a bulk update
+async function batchUpdate(knex, meta, entities) {
+    // Get the unique set of fields that are changed across all of the entities (of this type) we want to bulk update
+    const changedFields = new Set();
+    // Id doesn't change, but we need it for our WHERE clause
+    changedFields.add("id");
+    changedFields.add("updatedAt");
+    entities.forEach((entity) => {
+        Object.keys(entity.__orm.originalData).forEach((key) => changedFields.add(key));
+    });
+    // Sometimes with derived fields, an instance will be marked as an update, but if the derived field hasn't changed,
+    // it'll be a noop, so just short-circuit if it looks like that happened, i.e. we have no changed fields.
+    // (unless one of the entities was `EntityManager.touch`-d, which seems force the save / updatedAt tick.)
+    if (changedFields.size === 2 && !entities.some((e) => e.__orm.isTouched)) {
+        return;
+    }
+    const fields = Object.values(meta.fields)
+        .filter((f) => changedFields.has(f.fieldName))
+        .filter(index_1.hasSerde);
+    const columns = fields.flatMap((f) => f.serde.columns);
+    // We need to handle array columns different because the "unnest" approach fundamentally
+    // won't work b/c we can't use it to send "a list of lists".
+    let sql;
+    let bindings;
+    if (fields.some((f) => f.serde instanceof index_1.EnumArrayFieldSerde)) {
+        // Issue 1 UPDATE statement with N `VALUES (..., ...), (..., ...), ...` clauses
+        // and bindings is each individual value.
+        bindings = entities.flatMap((entity) => [
+            ...columns.map((c) => c.dbValue(entity.__orm.data) ?? null),
+            entity.__orm.originalData.updatedAt,
+        ]);
+        sql = `
+      UPDATE ${meta.tableName}
+      SET ${columns
+            .filter((c) => c.columnName !== "id")
+            .map((c) => `"${c.columnName}" = data."${c.columnName}"`)
+            .join(", ")}
+      FROM (
+        VALUES ${entities.map(() => `(${columns.map((c) => `?::${c.dbType}`).join(", ")}, ?::timestamp)`).join(",")}
+      ) AS data(${columns.map((c) => c.columnName).join(",")},original_updated_at)
+      WHERE
+        ${meta.tableName}.id = data.id
+        AND date_trunc('milliseconds', ${meta.tableName}.updated_at) = data.original_updated_at
+      RETURNING ${meta.tableName}.id
+   `;
+    }
+    else {
+        // Issue 1 UPDATE statement with bindings having an array for each column's new values
+        bindings = columns.map(() => []);
+        // Add 1 more column for original_updated_at
+        const originalUpdatedAt = [];
+        bindings.push(originalUpdatedAt);
+        for (const entity of entities) {
+            columns.forEach((c, i) => {
+                bindings[i].push(c.dbValue(entity.__orm.data) ?? null);
+            });
+            originalUpdatedAt.push(entity.__orm.originalData.updatedAt);
+        }
+        sql = `
+      UPDATE ${meta.tableName}
+      SET ${columns
+            .filter((c) => c.columnName !== "id")
+            .map((c) => `"${c.columnName}" = data."${c.columnName}"`)
+            .join(", ")}
+      FROM (
+        SELECT
+          ${columns.map((c) => `unnest(?::${c.dbType}[]) as "${c.columnName}"`).join(", ")},
+          unnest(?::timestamptz[]) as original_updated_at
+      ) as data
+      WHERE
+        ${meta.tableName}.id = data.id
+        AND date_trunc('milliseconds', ${meta.tableName}.updated_at) = data.original_updated_at
+      RETURNING ${meta.tableName}.id
+     `;
+    }
+    const result = await knex.raw(cleanSql(sql), bindings);
+    if (result.rows.length !== entities.length) {
+        const updated = new Set(result.rows.map((r) => r.id));
+        const missing = entities.map((e) => e.idOrFail).filter((id) => !updated.has(id));
+        throw new Error(`Oplock failure for ${(0, index_1.tagIds)(meta, missing).join(", ")}`);
+    }
+}
+async function batchDelete(knex, meta, entities) {
+    await knex(meta.tableName)
+        .del()
+        .whereIn("id", entities.map((e) => (0, index_1.keyToNumber)(meta, e.id).toString()));
+    entities.forEach((entity) => (entity.__orm.deleted = "deleted"));
+}
+/** Strips new lines/indentation from our `UPDATE` string; doesn't do any actual SQL param escaping/etc. */
+function cleanSql(sql) {
+    return sql.trim().replace(/\n/g, "").replace(/  +/g, " ");
+}
+function ensureUnderLimit(rows) {
+    if (rows.length >= index_1.entityLimit) {
+        throw new Error(`Query returned more than ${index_1.entityLimit} rows`);
+    }
+    return rows;
+}
+//# sourceMappingURL=PostgresDriver.js.map

package/build/src/drivers/PostgresDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresDriver.js","sourceRoot":"","sources":["../../../src/drivers/PostgresDriver.ts"],"names":[],"mappings":";;;AACA,kEAAgE;AAChE,oCAkBkB;AAIlB,oCAAuD;AAEvD,6CAA8D;AAM9D;;;;;;;;;;;;;GAaG;AACH,MAAa,cAAc;IAGzB,YAA6B,IAAU,EAAE,IAAyB;QAArC,SAAI,GAAJ,IAAI,CAAM;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,+BAAkB,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,CACF,EAAiB,EACjB,IAAuB,EACvB,WAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC1E,CAAC;IAED,cAAc,CACZ,EAAiB,EACjB,UAAsC,EACtC,IAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAExC,wCAAwC;QACxC,MAAM,OAAO,GAA6B,EAAE,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,IAAA,gBAAQ,EAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,4DAA4D;QAC5D,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YACrD,sEAAsE;YACtE,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;YACvG,KAAK,GAAG,KAAK,CAAC,SAAS,CACrB,QAAQ,EACR,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,IAAI,EAAE,EAAE,CAAE,CAAC,CAC3C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,cAAc,CACZ,EAAiB,EACjB,UAAsC,EACtC,IAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAExC,qFAAqF;QACrF,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAClB,UAAU,CAAC,UAAU,KAAK,SAAS;gBACjC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC;gBACzC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAC9C,sEAAsE;YACtE,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC1B,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,aAAa,CACX,EAAiB,EACjB,UAAqC,EACrC,WAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI;aACR,MAAM,CAAC,GAAG,CAAC;aACX,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;aACpC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC;aAChD,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,aAAa,CACX,EAAiB,EACjB,UAAqC,EACrC,IAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAClE,+CAA+C;QAC/C,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,mEAAmE;YACnE,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;YAC/D,sEAAsE;YACtE,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC1B,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,YAAY,CACV,EAAiB,EACjB,SAAsC,EACtC,WAA8B;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI;aACR,MAAM,CAAC,GAAG,CAAC;aACX,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC;aACnC,OAAO,CAAC,SAAS,CAAC,eAAe,EAAE,WAAW,CAAC;aAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAiB,EACjB,IAA0B,EAC1B,OAA+B;QAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAExC,0DAA0D;QAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;YACxB,OAAO,CAAC,gBAAgB,CAAC,MAAM,IAAA,kBAAU,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrE;QAED,yDAAyD;QACzD,MAAM,aAAa,GAA2B,EAAE,CAAC;QACjD,MAAM,aAAa,GAA2B,EAAE,CAAC;QACjD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,IAAI,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,gCAAe,EAAC,EAAE,CAAC,KAAK,IAAA,gCAAe,EAAC,CAAC,CAAC,CAAC,CAAC;YACpF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE;gBACZ,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACtB,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;aAC9B;YACD,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,iGAAiG;QACjG,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,IAAA,kBAAU,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,gEAAgE;YAChE,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;SAChC;QAED,6EAA6E;QAC7E,+EAA+E;QAC/E,sEAAsE;QACtE,EAAE;QACF,uEAAuE;QACvE,iDAAiD;QACjD,EAAE;QACF,kFAAkF;QAClF,gDAAgD;QAEhD,mFAAmF;QACnF,6DAA6D;QAC7D,EAAE;QACF,sFAAsF;QACtF,oFAAoF;QACpF,oFAAoF;QACpF,wBAAwB;QACxB,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,IAAA,kBAAU,EAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAsB,CAAC;YAC5E,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,IAAI,CAAC,CAAC;QAE/B,6DAA6D;QAC7D,IAAI,KAAK,GAAG,IAAI;aACb,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;aACpB,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC;aACzB,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAErB,kEAAkE;QAClE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACrB,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,+CAA+C;QAC/C,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC;QAE3C,MAAM,gBAAgB,GAAY,EAAE,CAAC;QACrC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,gBAAgB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YACxB,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,2EAA2E;QAC3E,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,EAAiB,EACjB,EAAyC,EACzC,cAA+B;QAE/B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC;QACtC,IAAI,YAAY,EAAE;YAChB,OAAO,EAAE,CAAC,IAAwB,CAAC,CAAC;SACrC;QACD,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1C,EAAE,CAAC,cAAc,GAAG,GAAG,CAAC;YACxB,IAAI;gBACF,IAAI,cAAc,EAAE;oBAClB,MAAM,GAAG,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;iBAChE;gBACD,MAAM,IAAA,yBAAiB,EAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBACjC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,IAAA,wBAAgB,EAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAChC,OAAO,MAAM,CAAC;aACf;oBAAS;gBACR,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC;aAC/B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAiB,EAAE,KAA2B;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC7C,IAAI,IAAI,EAAE;gBACR,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;oBAC3B,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;iBAC7C;gBACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;oBAC3B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;wBACzB,sCAAsC;wBACtC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAC9D,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;oBACxC,CAAC,CAAC,CAAC;oBACH,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;iBAC7C;gBACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;oBAC3B,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;iBAC7C;aACF;SACF;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,EAAiB,EAAE,QAAqC;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;gBACtB,MAAM,GAAG,GAAG,QAAQ,CAAC;wBACL,aAAa,KAAK,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,eAAe;mBAC7D,IAAA,cAAM,EAAC,OAAO,CAAC,MAAM,CAAC;qBAC5B,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;qBACpB,IAAI,CAAC,IAAI,CAAC;yBACE,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,eAAe,wBAAwB,aAAa;;SAE3F,CAAC,CAAC;gBACH,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACtC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC;gBAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;oBACvC,OAAO;wBACL,IAAA,mBAAW,EAAC,KAAK,EAAE,IAAA,iCAAyB,EAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAE;wBACnE,IAAA,mBAAW,EAAC,KAAK,EAAE,IAAA,iCAAyB,EAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAE;qBACzE,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;oBACpC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5B;aACF;YACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC1B,wFAAwF;gBACxF,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAA,iBAAS,EAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEpE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;oBACtB,MAAM,IAAI,CAAC,aAAa,CAAC;yBACtB,GAAG,EAAE;yBACL,OAAO,CACN,IAAI,EACJ,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAG,CAAC,CAC1B,CAAC;iBACL;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;oBACpB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ;wBACE,IAAA,eAAO,EAAC,GAAG,CAAC,IAAI,EAAE,IAAA,iCAAyB,EAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAE,CAAC;wBAChE,IAAA,eAAO,EAAC,GAAG,CAAC,SAAS,EAAE,IAAA,iCAAyB,EAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAE,CAAC;qBACpE,CACX,CAAC;oBACF,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;iBACtF;aACF;SACF;IACH,CAAC;IAEO,iBAAiB,CAAC,EAAiB;QACzC,OAAO,EAAE,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC;IACxC,CAAC;CACF;AAtTD,wCAsTC;AAED,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,IAAyB,EAAE,QAAkB;IAClF,2GAA2G;IAC3G,mFAAmF;IACnF,+EAA+E;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,gBAAQ,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvD,+EAA+E;IAC/E,yCAAyC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACxG,MAAM,GAAG,GAAG;kBACI,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1E,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;GAChF,CAAC;IAEF,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,mDAAmD;AACnD,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,IAAyB,EAAE,QAAkB;IAClF,iHAAiH;IACjH,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,yDAAyD;IACzD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,mHAAmH;IACnH,yGAAyG;IACzG,yGAAyG;IACzG,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QACxE,OAAO;KACR;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC7C,MAAM,CAAC,gBAAQ,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEvD,wFAAwF;IACxF,4DAA4D;IAC5D,IAAI,GAAW,CAAC;IAChB,IAAI,QAAe,CAAC;IACpB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,2BAAmB,CAAC,EAAE;QAC9D,+EAA+E;QAC/E,yCAAyC;QACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;YAC3D,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS;SACpC,CAAC,CAAC;QACH,GAAG,GAAG;eACK,IAAI,CAAC,SAAS;YACjB,OAAO;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,aAAa,CAAC,CAAC,UAAU,GAAG,CAAC;aACxD,IAAI,CAAC,IAAI,CAAC;;iBAEF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;kBACjG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;;UAElD,IAAI,CAAC,SAAS;yCACiB,IAAI,CAAC,SAAS;kBACrC,IAAI,CAAC,SAAS;IAC5B,CAAC;KACF;SAAM;QACL,sFAAsF;QACtF,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,4CAA4C;QAC5C,MAAM,iBAAiB,GAAW,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE;YAC7B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;YACH,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;SAC7D;QACD,GAAG,GAAG;eACK,IAAI,CAAC,SAAS;YACjB,OAAO;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,aAAa,CAAC,CAAC,UAAU,GAAG,CAAC;aACxD,IAAI,CAAC,IAAI,CAAC;;;YAGP,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;UAIhF,IAAI,CAAC,SAAS;yCACiB,IAAI,CAAC,SAAS;kBACrC,IAAI,CAAC,SAAS;MAC1B,CAAC;KACJ;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAA,cAAM,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KAC3E;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,IAAyB,EAAE,QAAkB;IAClF,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;SACvB,GAAG,EAAE;SACL,OAAO,CACN,IAAI,EACJ,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,IAAI,EAAE,CAAC,CAAC,EAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CACzD,CAAC;IACJ,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,2GAA2G;AAC3G,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAe;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAW,EAAE;QAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,mBAAW,OAAO,CAAC,CAAC;KACjE;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/src/drivers/driver.d.ts

@@ -0,0 +1,23 @@
+import { Knex } from "knex";
+import { ManyToManyLargeCollection, OneToManyLargeCollection } from "src/relations";
+import { Entity, EntityConstructor, EntityManager, EntityMetadata } from "../EntityManager";
+import { FilterAndSettings } from "../QueryBuilder";
+import { JoinRow, ManyToManyCollection } from "../relations/ManyToManyCollection";
+import { OneToManyCollection } from "../relations/OneToManyCollection";
+import { OneToOneReferenceImpl } from "../relations/OneToOneReference";
+import { JoinRowTodo, Todo } from "../Todo";
+/** Isolates all SQL calls that joist needs to make to fetch/save data. */
+export interface Driver {
+    load<T extends Entity>(em: EntityManager, meta: EntityMetadata<T>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    /** Loads a given m2m relation for potentially multiple entities. */
+    loadManyToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: ManyToManyCollection<T, U>, keys: readonly string[]): Promise<JoinRow[]>;
+    /** Just finds presence in a m2m w/o loading the full relation. */
+    findManyToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: ManyToManyCollection<T, U> | ManyToManyLargeCollection<T, U>, keys: readonly string[]): Promise<JoinRow[]>;
+    loadOneToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: OneToManyCollection<T, U>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    findOneToMany<T extends Entity, U extends Entity>(em: EntityManager, collection: OneToManyCollection<T, U> | OneToManyLargeCollection<T, U>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    loadOneToOne<T extends Entity, U extends Entity>(em: EntityManager, reference: OneToOneReferenceImpl<T, U>, untaggedIds: readonly string[]): Promise<unknown[]>;
+    find<T extends Entity>(em: EntityManager, type: EntityConstructor<T>, queries: readonly FilterAndSettings<T>[]): Promise<unknown[][]>;
+    transaction<T>(em: EntityManager, fn: (txn: Knex.Transaction) => Promise<T>, isolationLevel?: "serializable"): Promise<T>;
+    flushEntities(em: EntityManager, todos: Record<string, Todo>): Promise<void>;
+    flushJoinTables(em: EntityManager, joinRows: Record<string, JoinRowTodo>): Promise<void>;
+}

package/build/src/drivers/driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=driver.js.map

package/build/src/drivers/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../src/drivers/driver.ts"],"names":[],"mappings":""}

package/build/src/drivers/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./driver";
+export * from "./IdAssigner";
+export * from "./InMemoryDriver";
+export * from "./PostgresDriver";

package/build/src/drivers/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./driver"), exports);
+__exportStar(require("./IdAssigner"), exports);
+__exportStar(require("./InMemoryDriver"), exports);
+__exportStar(require("./PostgresDriver"), exports);
+//# sourceMappingURL=index.js.map

package/build/src/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B;AAC7B,mDAAiC;AACjC,mDAAiC"}

package/build/{getProperties.js → src/getProperties.js}

@@ -14,7 +14,7 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 var __importStar = (this && this.__importStar) || function (mod) {
     if (mod && mod.__esModule) return mod;
     var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
     __setModuleDefault(result, mod);
     return result;
 };

package/build/src/getProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProperties.js","sourceRoot":"","sources":["../../src/getProperties.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,oDAAsC;AAGtC,uDAAuD;AACvD,MAAM,EAAE,GAAG,EAAE,CAAC;AAEd;;;;;GAKG;AACH,SAAgB,aAAa,CAAmB,IAAuB;IACrE,OAAO;QACL,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAClD,GAAG,MAAM,CAAC,IAAI,CACZ,IAAI,IAAI,CAAC,IAAI,CACX;YACE,QAAQ,EAAE,CAAC,QAAa,EAAE,MAAW,EAAE,EAAE;gBACvC,EAAE,CAAC,4BAA4B,GAAG,MAAM,CAAC;YAC3C,CAAC;SACK,EACR,EAAE,CACH,CACF;KACF,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,aAAa,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC;AAdD,sCAcC"}

package/build/src/index.d.ts

@@ -0,0 +1,62 @@
+import { Entity, EntityConstructor, EntityManager, EntityMetadata, EntityOrmField, Field, ManyToManyField, ManyToOneField, OneToManyField, OneToOneField, OptsOf, PolymorphicField } from "./EntityManager";
+import { Reference } from "./relations";
+import { AbstractRelationImpl } from "./relations/AbstractRelationImpl";
+export { newPgConnectionConfig } from "joist-utils";
+export { BaseEntity } from "./BaseEntity";
+export * from "./changes";
+export { ConfigApi, EntityHook } from "./config";
+export { DeepPartialOrNull } from "./createOrUpdatePartial";
+export * from "./drivers";
+export * from "./EntityManager";
+export * from "./getProperties";
+export * from "./keys";
+export { isNew, Loadable, Loaded, LoadHint, New, RelationsIn } from "./loaded";
+export * from "./loadLens";
+export * from "./newTestInstance";
+export * from "./QueryBuilder";
+export * from "./relations";
+export * from "./reverseHint";
+export { GenericError, newRequiredRule, ValidationError, ValidationErrors, ValidationRule, ValidationRuleResult, } from "./rules";
+export * from "./serde";
+export { fail } from "./utils";
+interface Flavoring<FlavorT> {
+    _type?: FlavorT;
+}
+export declare type Flavor<T, FlavorT> = T & Flavoring<FlavorT>;
+export declare function setField<T extends Entity>(entity: T, fieldName: keyof T, newValue: any): boolean;
+/**
+ * Sets each value in `values` on the current entity.
+ *
+ * The default behavior is that passing a value as either `null` or `undefined` will set
+ * the field as `undefined`, i.e. automatic `null` to `undefined` conversion.
+ *
+ * However, if you pass `ignoreUndefined: true`, then any opt that is `undefined` will be treated
+ * as "do not set", and `null` will still mean "set to `undefined`". This is useful for implementing
+ * APIs were an input of `undefined` means "do not set / noop" and `null` means "unset".
+ */
+export declare function setOpts<T extends Entity>(entity: T, values: Partial<OptsOf<T>> | string | undefined, opts?: {
+    calledFromConstructor?: boolean;
+    partial?: boolean;
+}): void;
+export declare function ensureNotDeleted(entity: Entity, opts?: {
+    ignore?: EntityOrmField["deleted"];
+}): void;
+/** Adds `null` to every key in `T` to accept partial-update-style input. */
+export declare type PartialOrNull<T> = {
+    [P in keyof T]?: T[P] | null;
+};
+export declare function getRequiredKeys<T extends Entity>(entity: T): string[];
+export declare function getRequiredKeys<T extends Entity>(type: EntityConstructor<T>): string[];
+/** Processes the metas based on any custom calls to the `configApi` hooks. */
+export declare function configureMetadata(metas: EntityMetadata<any>[]): void;
+export declare function getEm(entity: Entity): EntityManager<any>;
+export declare function getRelations(entity: Entity): AbstractRelationImpl<any>[];
+export declare function getConstructorFromTaggedId(id: string): EntityConstructor<any>;
+export declare function maybeGetConstructorFromReference(value: string | Entity | Reference<any, any, any> | undefined): EntityConstructor<any> | undefined;
+export declare function isOneToManyField(ormField: Field): ormField is OneToManyField;
+export declare function isManyToOneField(ormField: Field): ormField is ManyToOneField;
+export declare function isManyToManyField(ormField: Field): ormField is ManyToManyField;
+export declare function isOneToOneField(ormField: Field): ormField is OneToOneField;
+export declare function isPolymorphicField(ormField: Field): ormField is PolymorphicField;
+export declare function isReferenceField(ormField: Field): ormField is ManyToOneField | OneToOneField | PolymorphicField;
+export declare function isCollectionField(ormField: Field): ormField is OneToManyField | ManyToManyField;