joist-core 2.3.0-next.97 → 2.3.0-next.99

package/build/drivers/Driver.d.cts

@@ -1,4 +1,4 @@
-import { JoinRowTodo, Todo } from "../Todo.cjs";
+import { JoinRowTodo, Todo } from "../flush/Todo.cjs";
 import { ParsedFindQuery } from "../queries/find/QueryParser.cjs";
 import { RowData } from "../RowData.cjs";
 import { PreloadPlugin } from "../plugins/PreloadPlugin.cjs";

package/build/drivers/Driver.d.mts

@@ -1,4 +1,4 @@
-import { JoinRowTodo, Todo } from "../Todo.mjs";
+import { JoinRowTodo, Todo } from "../flush/Todo.mjs";
 import { ParsedFindQuery } from "../queries/find/QueryParser.mjs";
 import { RowData } from "../RowData.mjs";
 import { PreloadPlugin } from "../plugins/PreloadPlugin.mjs";

package/build/drivers/Driver.js

@@ -1,4 +1,3 @@
-import "../Todo.js";
 import "../plugins/PreloadPlugin.js";
 import "../EntityManager.js";
 export {};

package/build/drivers/EntityWriter.cjs

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_fields = require("../fields.cjs");
-require("../Todo.cjs");
-const require_utils = require("../utils.cjs");
 const require_keys = require("../keys.cjs");
-const require_fieldSerde = require("../fieldSerde.cjs");
+const require_utils = require("../utils.cjs");
+const require_serde_fieldSerde = require("../serde/fieldSerde.cjs");
 const require_EntityMetadata = require("../EntityMetadata.cjs");
 require("../Entity.cjs");
 const require_BaseEntity = require("../BaseEntity.cjs");
@@ -47,7 +46,7 @@ function addInserts(ops, todo, fixups) {
 	}
 }
 function newInsertOp(meta, entities, fixups) {
-	const columns = Object.values(meta.fields).filter(require_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
+	const columns = Object.values(meta.fields).filter(require_serde_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
 	const columnValues = collectBindings(entities, meta.tableName, columns, fixups);
 	return {
 		tableName: meta.tableName,
@@ -56,7 +55,7 @@ function newInsertOp(meta, entities, fixups) {
 	};
 }
 function newStiInsertOp(root, entities, fixups) {
-	const columns = Object.values(require_EntityMetadata.getMetadata(entities[0]).allFields).filter(require_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
+	const columns = Object.values(require_EntityMetadata.getMetadata(entities[0]).allFields).filter(require_serde_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
 	const columnValues = collectBindings(entities, root.tableName, columns, fixups);
 	return {
 		tableName: root.tableName,
@@ -96,7 +95,7 @@ function addLazyUpdates(ops, meta, entities) {
 	const idColumn = meta.fields["id"].serde.columns[0];
 	for (const fieldName of meta.lazyFieldNames) {
 		const field = meta.fields[fieldName];
-		if (!require_fieldSerde.hasSerde(field)) continue;
+		if (!require_serde_fieldSerde.hasSerde(field)) continue;
 		const changed = entities.filter((e) => fieldName in require_BaseEntity.getInstanceData(e).changedData);
 		if (changed.length === 0) continue;
 		const columns = [idColumn, ...field.serde.columns];
@@ -121,7 +120,7 @@ function newUpdateOp(meta, entities) {
 		const { data } = require_BaseEntity.getInstanceData(entity);
 		for (const key of changedFields) if (!(key in data) && require_fields.isChangeableField(entity, key) && !lazyFieldNames.has(key)) require_fields.getField(entity, key);
 	}
-	const columns = (meta.inheritanceType === "sti" ? require_EntityMetadata.getBaseSelfAndSubMetas(meta).flatMap((meta) => meta.stiDiscriminatorField ? Object.values(meta.fields) : Object.values(meta.fields).filter((f) => f.fieldName !== "id")) : Object.values(meta.fields)).filter((f) => changedFields.has(f.fieldName)).filter((f) => !lazyFieldNames.has(f.fieldName)).filter(require_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
+	const columns = (meta.inheritanceType === "sti" ? require_EntityMetadata.getBaseSelfAndSubMetas(meta).flatMap((meta) => meta.stiDiscriminatorField ? Object.values(meta.fields) : Object.values(meta.fields).filter((f) => f.fieldName !== "id")) : Object.values(meta.fields)).filter((f) => changedFields.has(f.fieldName)).filter((f) => !lazyFieldNames.has(f.fieldName)).filter(require_serde_fieldSerde.hasSerde).flatMap((f) => f.serde.columns);
 	if (columns.length === 1) return;
 	if (updatedAt) {
 		const serde = meta.fields[updatedAt].serde;

package/build/drivers/EntityWriter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"EntityWriter.cjs","names":["groupBy","getMetadata","hasSerde","getInstanceData","isChangeableField","getBaseSelfAndSubMetas","keyToNumber","getBaseAndSelfMetas"],"sources":["../../src/drivers/EntityWriter.ts"],"sourcesContent":["import { getInstanceData } from \"../BaseEntity.ts\";\nimport { type Entity } from \"../Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PrimitiveField,\n  getBaseAndSelfMetas,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"../EntityMetadata.ts\";\nimport { getField, isChangeableField } from \"../fields.ts\";\nimport { type FieldColumn, type TimestampSerde, hasSerde } from \"../fieldSerde.ts\";\nimport { keyToNumber } from \"../keys.ts\";\nimport { type Todo } from \"../Todo.ts\";\nimport { groupBy } from \"../utils.ts\";\n\n/** A simplified view of columns, with only the keys necessary to create SQL statements. */\nexport type OpColumn = { columnName: string; dbType: string; isNullableArray?: boolean };\nexport type InsertOp = { tableName: string; columns: OpColumn[]; columnValues: any[][] };\n/**\n * A logical `update` operation.\n *\n * If we're using op locks, `columns` will include both the new `updatedAt` value (as bumped\n * by the `EntityManager` on mutate), as well as an extra/last \"original updated at\" column\n * (with respective pre-update values in the `rows` data), for including in the conditional\n * update clause.\n */\nexport type UpdateOp = {\n  tableName: string;\n  columns: OpColumn[];\n  columnValues: any[][];\n  updatedAt: string | undefined;\n};\nexport type DeleteOp = { tableName: string; ids: any[] };\n\ntype Ops = { inserts: InsertOp[]; updates: UpdateOp[]; deletes: DeleteOp[] };\n\n/**\n * In schemas with entity FK cycles, we may insert a dummy/null value, and later fix it up\n * before the transaction commits.\n *\n * I.e. `INSERT author.favorite_book_id` as `NULL` and then later do an `UPDATE author\n * SET favorite_book_id = 1` after the book has been inserted/we have the id.\n */\nexport type InsertFixup = {\n  entity: Entity;\n  tableName: string;\n  column: OpColumn;\n  value: any;\n};\n\n/**\n * Builds AST-ish `Ops` for the inserts/updates/deletes in `todos`.\n *\n * This helps decouple the database-specific driver/library from the knowledge\n * of turning entities into table operations, i.e. so they can be unaware of\n * complexities like field -> column mapping, oplocks, and class table inheritance.\n *\n * We still assume Postgres b/c we assume all ids have been pre-assigned for INSERTs,\n * and don't do any topological sorting of cross-row FK dependencies.\n *\n * But this should let us experiment with knex vs. raw client/etc.\n */\nexport function generateOps(todos: Record<string, Todo>): Ops {\n  const ops: Ops = { inserts: [], updates: [], deletes: [] };\n  const fixups: InsertFixup[] = [];\n  // Would be nice to conditionally sort\n  const sorted = Object.values(todos).sort(\n    (a, b) => (a.metadata.nonDeferredFkOrder ?? 0) - (b.metadata.nonDeferredFkOrder ?? 0),\n  );\n  for (const todo of sorted) {\n    addInserts(ops, todo, fixups);\n    addUpdates(ops, todo);\n    addDeletes(ops, todo);\n  }\n  if (fixups.length > 0) translateFixupsIntoUpdates(ops, fixups);\n  return ops;\n}\n\nfunction addInserts(ops: Ops, todo: Todo, fixups: InsertFixup[]): void {\n  if (todo.inserts.length > 0) {\n    // If we have subtypes, this todo.metadata will always be the base type\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        // Insert into each of the CTI tables\n        for (const [meta, group] of groupEntitiesByTable(todo.inserts)) {\n          ops.inserts.push(newInsertOp(meta, group, fixups));\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        // One INSERT per subtype, so each statement's column list spans exactly what that subtype can\n        // set. A single statement across subtypes has to bind NULL for the other subtypes' columns,\n        // which defeats their database defaults, and outright fails for notNull ones.\n        for (const group of groupBy(todo.inserts, (e) => getMetadata(e)).values()) {\n          ops.inserts.push(newStiInsertOp(meta, group, fixups));\n        }\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      ops.inserts.push(newInsertOp(meta, todo.inserts, fixups));\n    }\n  }\n}\n\nfunction newInsertOp(meta: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // Purposefully use `meta.fields` instead of `allFields` b/c each CTI table has its own `InsertOp`\n  const columns = Object.values(meta.fields)\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, meta.tableName, columns, fixups);\n  return { tableName: meta.tableName, columns, columnValues };\n}\n\nfunction newStiInsertOp(root: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // `allFields` is the base's fields plus this subtype's own, i.e. everything this subtype can write.\n  // Anything it can't write is left out of the statement entirely, so the database applies its default.\n  const fields: Field[] = Object.values(getMetadata(entities[0]).allFields);\n  const columns = fields.filter(hasSerde).flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, root.tableName, columns, fixups);\n  return { tableName: root.tableName, columns, columnValues };\n}\n\nfunction addUpdates(ops: Ops, todo: Todo): void {\n  if (todo.updates.length > 0) {\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        for (const [meta, group] of groupEntitiesByTable(todo.updates)) {\n          const op = newUpdateOp(meta, group);\n          if (op) ops.updates.push(op);\n          addLazyUpdates(ops, meta, group);\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        const op = newUpdateOp(meta, todo.updates);\n        if (op) ops.updates.push(op);\n        addLazyUpdates(ops, meta, todo.updates);\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      const op = newUpdateOp(meta, todo.updates);\n      if (op) ops.updates.push(op);\n      addLazyUpdates(ops, meta, todo.updates);\n    }\n  }\n}\n\n/**\n * Writes changed `lazy` columns via a targeted `UPDATE table SET lazy_col = ... WHERE id in (...)`.\n *\n * Lazy columns are excluded from the main batch UPDATE (which spans the batch's union of changed fields),\n * so that entities in the batch that never loaded a lazy column keep their existing db value instead of\n * being overwritten with null. Here we write each lazy column only for the entities that actually changed it.\n */\nfunction addLazyUpdates(ops: Ops, meta: EntityMetadata, entities: Entity[]): void {\n  const idColumn = meta.fields[\"id\"].serde!.columns[0];\n  for (const fieldName of meta.lazyFieldNames!) {\n    const field = meta.fields[fieldName];\n    if (!hasSerde(field)) continue;\n    const changed = entities.filter((e) => fieldName in getInstanceData(e).changedData);\n    if (changed.length === 0) continue;\n    const columns: BindingColumn[] = [idColumn, ...field.serde.columns];\n    const columnValues = collectBindings(changed, meta.tableName, columns, undefined);\n    ops.updates.push({ tableName: meta.tableName, columns, columnValues, updatedAt: undefined });\n  }\n}\n\nfunction newUpdateOp(meta: EntityMetadata, entities: Entity[]): UpdateOp | undefined {\n  // We only include changed fields in our `UPDATE`--maybe we could change this\n  // to always use the same fields, to take advantage of Prepared Statements.\n  const changedFields = new Set<string>();\n  for (const entity of entities) {\n    for (const fieldName in getInstanceData(entity).changedData) changedFields.add(fieldName);\n  }\n  // Sometimes with derived fields, an instance will be marked as an update, but if the derived field hasn't\n  // actually changed, it'll be a noop, so just short-circuit if it looks like that happened. Unless touched.\n  if (changedFields.size === 0 && !entities.some((e) => getInstanceData(e).isTouched)) {\n    return undefined;\n  }\n\n  // We may have loaded a1 and a2, and changed a1.firstName, and a2.lastName, but either one\n  // might be missing the other's changed fields in it's lazy-initialized data field...\n  // (Use `?` because subtypes won't have the updatedAt, and it will be handled by the base type\n  // `newUpdateUp`--except STI where we're doing it all in one go, probably needs checked here.)\n  const updatedAt = meta.timestampFields?.updatedAt;\n  changedFields.add(\"id\");\n  if (updatedAt) changedFields.add(updatedAt);\n  // `lazy` columns are deliberately excluded from the batch UPDATE and written by `addLazyUpdates`; an\n  // entity that never loaded a lazy column isn't in `row`, so forcing `getField` here would clobber it to null.\n  const lazyFieldNames = meta.lazyFieldNames!;\n  for (const entity of entities) {\n    const { data } = getInstanceData(entity);\n    for (const key of changedFields) {\n      // Check isChangeableField because we might be updating the base `publishers` table\n      // and `originalData` might have fields from a subclass `large_publishers` table.\n      if (!(key in data) && isChangeableField(entity, key) && !lazyFieldNames.has(key)) {\n        getField(entity, key);\n      }\n    }\n  }\n\n  const columns: Array<BindingColumn> = (\n    meta.inheritanceType === \"sti\"\n      ? // Hack this one handling of STI into here...\n        getBaseSelfAndSubMetas(meta).flatMap((meta) =>\n          meta.stiDiscriminatorField\n            ? Object.values(meta.fields)\n            : Object.values(meta.fields).filter((f) => f.fieldName !== \"id\"),\n        )\n      : Object.values(meta.fields)\n  )\n    .filter((f) => changedFields.has(f.fieldName))\n    .filter((f) => !lazyFieldNames.has(f.fieldName))\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n\n  // If we're using class table inheritance, base/child tables may not have any columns to update\n  if (columns.length === 1) {\n    return undefined;\n  }\n\n  // We already have the bumped updated_at column, but also include the original updated_at for the data CTE\n  if (updatedAt) {\n    const serde = meta.fields[updatedAt].serde as TimestampSerde<unknown>;\n    columns.push({\n      columnName: \"__original_updated_at\",\n      dbType: \"timestamptz\",\n      dbValue: (_, entity) => serde.dbValue(getInstanceData(entity).originalData),\n    });\n  }\n\n  const columnValues = collectBindings(entities, meta.tableName, columns, []);\n  const updatedAtColumn = updatedAt ? (meta.fields[updatedAt] as PrimitiveField).serde.columns[0] : undefined;\n  return { tableName: meta.tableName, columns, updatedAt: updatedAtColumn?.columnName, columnValues };\n}\n\nfunction addDeletes(ops: Ops, todo: Todo): void {\n  if (todo.deletes.length > 0) {\n    const meta = todo.metadata;\n    const ids = todo.deletes.map((e) => keyToNumber(meta, e.idTagged!).toString());\n    if (meta.subTypes.length > 0) {\n      getBaseSelfAndSubMetas(meta).forEach((meta) => {\n        ops.deletes.push({ tableName: meta.tableName, ids });\n      });\n    } else {\n      ops.deletes.push({ tableName: meta.tableName, ids });\n    }\n  }\n}\n\nfunction groupEntitiesByTable(entities: Entity[]): Array<[EntityMetadata, Entity[]]> {\n  const entitiesByType: Map<EntityMetadata, Entity[]> = new Map();\n  for (const e of entities) {\n    for (const m of getBaseAndSelfMetas(getMetadata(e))) {\n      let list = entitiesByType.get(m);\n      if (!list) {\n        list = [];\n        entitiesByType.set(m, list);\n      }\n      list.push(e);\n    }\n  }\n  return [...entitiesByType.entries()];\n}\n\ntype BindingColumn = OpColumn & Pick<FieldColumn, \"dbValue\">;\ntype EntityWithData = Entity & { __data: { data: Record<string, unknown> } };\n\n/**\n * Builds a *columnar* array of bindings for the given `entities` and `columns`.\n *\n * We use a columnar approach, instead of `rows[]`, to best match the unnest-based\n * column operations in our `batchInsert` / `batchUpdate` SQL statements.\n */\nfunction collectBindings(\n  entities: Entity[],\n  tableName: string,\n  columns: BindingColumn[],\n  fixups: InsertFixup[] | undefined,\n): any[][] {\n  const entityCount = entities.length;\n  const bindings: any[][] = new Array(columns.length);\n  const entitiesWithData = entities as EntityWithData[];\n  // Cache data separately; this benchmarks faster than `entities[i].__data.data` in the inner loop.\n  const entityData = new Array(entityCount);\n  for (let i = 0; i < entityCount; i++) entityData[i] = entitiesWithData[i].__data.data;\n  for (let columnIndex = 0; columnIndex < columns.length; columnIndex++) {\n    const column = columns[columnIndex];\n    const columnValues: any[] = new Array(entityCount);\n    for (let entityIndex = 0; entityIndex < entityCount; entityIndex++) {\n      columnValues[entityIndex] =\n        column.dbValue(entityData[entityIndex], entities[entityIndex], tableName, fixups) ?? null;\n    }\n    bindings[columnIndex] = columnValues;\n  }\n  return bindings;\n}\n/**\n * Given `fixups` that indicate where we inserted `NULL` into non-deferred FKs, create `UPDATE`s\n * that insert the value now that the FK check will succeed.\n */\nfunction translateFixupsIntoUpdates(ops: Ops, fixups: InsertFixup[]): void {\n  // Create a single `UPDATE` for the N fixups we might have for each table/column combination\n  groupBy(fixups, (f) => `${f.tableName}.${f.column.columnName}`).forEach((fixups) => {\n    const { tableName, entity, column } = fixups[0];\n    ops.updates.push({\n      tableName,\n      columns: [getMetadata(entity).fields[\"id\"].serde!.columns[0], column],\n      columnValues: [\n        // Make 1 column of ids, and 1 column of values\n        fixups.map((fixup) => fixup.entity.id),\n        fixups.map((fixup) => fixup.value),\n      ],\n      updatedAt: undefined,\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"EntityWriter.cjs","names":["groupBy","getMetadata","hasSerde","getInstanceData","isChangeableField","getBaseSelfAndSubMetas","keyToNumber","getBaseAndSelfMetas"],"sources":["../../src/drivers/EntityWriter.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PrimitiveField,\n  getBaseAndSelfMetas,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { getField, isChangeableField } from \"src/fields.ts\";\nimport type { Todo } from \"src/flush/Todo.ts\";\nimport { keyToNumber } from \"src/keys.ts\";\nimport { type FieldColumn, type TimestampSerde, hasSerde } from \"src/serde/fieldSerde.ts\";\nimport { groupBy } from \"src/utils.ts\";\n\n/** A simplified view of columns, with only the keys necessary to create SQL statements. */\nexport type OpColumn = { columnName: string; dbType: string; isNullableArray?: boolean };\nexport type InsertOp = { tableName: string; columns: OpColumn[]; columnValues: any[][] };\n/**\n * A logical `update` operation.\n *\n * If we're using op locks, `columns` will include both the new `updatedAt` value (as bumped\n * by the `EntityManager` on mutate), as well as an extra/last \"original updated at\" column\n * (with respective pre-update values in the `rows` data), for including in the conditional\n * update clause.\n */\nexport type UpdateOp = {\n  tableName: string;\n  columns: OpColumn[];\n  columnValues: any[][];\n  updatedAt: string | undefined;\n};\nexport type DeleteOp = { tableName: string; ids: any[] };\n\ntype Ops = { inserts: InsertOp[]; updates: UpdateOp[]; deletes: DeleteOp[] };\n\n/**\n * In schemas with entity FK cycles, we may insert a dummy/null value, and later fix it up\n * before the transaction commits.\n *\n * I.e. `INSERT author.favorite_book_id` as `NULL` and then later do an `UPDATE author\n * SET favorite_book_id = 1` after the book has been inserted/we have the id.\n */\nexport type InsertFixup = {\n  entity: Entity;\n  tableName: string;\n  column: OpColumn;\n  value: any;\n};\n\n/**\n * Builds AST-ish `Ops` for the inserts/updates/deletes in `todos`.\n *\n * This helps decouple the database-specific driver/library from the knowledge\n * of turning entities into table operations, i.e. so they can be unaware of\n * complexities like field -> column mapping, oplocks, and class table inheritance.\n *\n * We still assume Postgres b/c we assume all ids have been pre-assigned for INSERTs,\n * and don't do any topological sorting of cross-row FK dependencies.\n *\n * But this should let us experiment with knex vs. raw client/etc.\n */\nexport function generateOps(todos: Record<string, Todo>): Ops {\n  const ops: Ops = { inserts: [], updates: [], deletes: [] };\n  const fixups: InsertFixup[] = [];\n  // Would be nice to conditionally sort\n  const sorted = Object.values(todos).sort(\n    (a, b) => (a.metadata.nonDeferredFkOrder ?? 0) - (b.metadata.nonDeferredFkOrder ?? 0),\n  );\n  for (const todo of sorted) {\n    addInserts(ops, todo, fixups);\n    addUpdates(ops, todo);\n    addDeletes(ops, todo);\n  }\n  if (fixups.length > 0) translateFixupsIntoUpdates(ops, fixups);\n  return ops;\n}\n\nfunction addInserts(ops: Ops, todo: Todo, fixups: InsertFixup[]): void {\n  if (todo.inserts.length > 0) {\n    // If we have subtypes, this todo.metadata will always be the base type\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        // Insert into each of the CTI tables\n        for (const [meta, group] of groupEntitiesByTable(todo.inserts)) {\n          ops.inserts.push(newInsertOp(meta, group, fixups));\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        // One INSERT per subtype, so each statement's column list spans exactly what that subtype can\n        // set. A single statement across subtypes has to bind NULL for the other subtypes' columns,\n        // which defeats their database defaults, and outright fails for notNull ones.\n        for (const group of groupBy(todo.inserts, (e) => getMetadata(e)).values()) {\n          ops.inserts.push(newStiInsertOp(meta, group, fixups));\n        }\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      ops.inserts.push(newInsertOp(meta, todo.inserts, fixups));\n    }\n  }\n}\n\nfunction newInsertOp(meta: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // Purposefully use `meta.fields` instead of `allFields` b/c each CTI table has its own `InsertOp`\n  const columns = Object.values(meta.fields)\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, meta.tableName, columns, fixups);\n  return { tableName: meta.tableName, columns, columnValues };\n}\n\nfunction newStiInsertOp(root: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // `allFields` is the base's fields plus this subtype's own, i.e. everything this subtype can write.\n  // Anything it can't write is left out of the statement entirely, so the database applies its default.\n  const fields: Field[] = Object.values(getMetadata(entities[0]).allFields);\n  const columns = fields.filter(hasSerde).flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, root.tableName, columns, fixups);\n  return { tableName: root.tableName, columns, columnValues };\n}\n\nfunction addUpdates(ops: Ops, todo: Todo): void {\n  if (todo.updates.length > 0) {\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        for (const [meta, group] of groupEntitiesByTable(todo.updates)) {\n          const op = newUpdateOp(meta, group);\n          if (op) ops.updates.push(op);\n          addLazyUpdates(ops, meta, group);\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        const op = newUpdateOp(meta, todo.updates);\n        if (op) ops.updates.push(op);\n        addLazyUpdates(ops, meta, todo.updates);\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      const op = newUpdateOp(meta, todo.updates);\n      if (op) ops.updates.push(op);\n      addLazyUpdates(ops, meta, todo.updates);\n    }\n  }\n}\n\n/**\n * Writes changed `lazy` columns via a targeted `UPDATE table SET lazy_col = ... WHERE id in (...)`.\n *\n * Lazy columns are excluded from the main batch UPDATE (which spans the batch's union of changed fields),\n * so that entities in the batch that never loaded a lazy column keep their existing db value instead of\n * being overwritten with null. Here we write each lazy column only for the entities that actually changed it.\n */\nfunction addLazyUpdates(ops: Ops, meta: EntityMetadata, entities: Entity[]): void {\n  const idColumn = meta.fields[\"id\"].serde!.columns[0];\n  for (const fieldName of meta.lazyFieldNames!) {\n    const field = meta.fields[fieldName];\n    if (!hasSerde(field)) continue;\n    const changed = entities.filter((e) => fieldName in getInstanceData(e).changedData);\n    if (changed.length === 0) continue;\n    const columns: BindingColumn[] = [idColumn, ...field.serde.columns];\n    const columnValues = collectBindings(changed, meta.tableName, columns, undefined);\n    ops.updates.push({ tableName: meta.tableName, columns, columnValues, updatedAt: undefined });\n  }\n}\n\nfunction newUpdateOp(meta: EntityMetadata, entities: Entity[]): UpdateOp | undefined {\n  // We only include changed fields in our `UPDATE`--maybe we could change this\n  // to always use the same fields, to take advantage of Prepared Statements.\n  const changedFields = new Set<string>();\n  for (const entity of entities) {\n    for (const fieldName in getInstanceData(entity).changedData) changedFields.add(fieldName);\n  }\n  // Sometimes with derived fields, an instance will be marked as an update, but if the derived field hasn't\n  // actually changed, it'll be a noop, so just short-circuit if it looks like that happened. Unless touched.\n  if (changedFields.size === 0 && !entities.some((e) => getInstanceData(e).isTouched)) {\n    return undefined;\n  }\n\n  // We may have loaded a1 and a2, and changed a1.firstName, and a2.lastName, but either one\n  // might be missing the other's changed fields in it's lazy-initialized data field...\n  // (Use `?` because subtypes won't have the updatedAt, and it will be handled by the base type\n  // `newUpdateUp`--except STI where we're doing it all in one go, probably needs checked here.)\n  const updatedAt = meta.timestampFields?.updatedAt;\n  changedFields.add(\"id\");\n  if (updatedAt) changedFields.add(updatedAt);\n  // `lazy` columns are deliberately excluded from the batch UPDATE and written by `addLazyUpdates`; an\n  // entity that never loaded a lazy column isn't in `row`, so forcing `getField` here would clobber it to null.\n  const lazyFieldNames = meta.lazyFieldNames!;\n  for (const entity of entities) {\n    const { data } = getInstanceData(entity);\n    for (const key of changedFields) {\n      // Check isChangeableField because we might be updating the base `publishers` table\n      // and `originalData` might have fields from a subclass `large_publishers` table.\n      if (!(key in data) && isChangeableField(entity, key) && !lazyFieldNames.has(key)) {\n        getField(entity, key);\n      }\n    }\n  }\n\n  const columns: Array<BindingColumn> = (\n    meta.inheritanceType === \"sti\"\n      ? // Hack this one handling of STI into here...\n        getBaseSelfAndSubMetas(meta).flatMap((meta) =>\n          meta.stiDiscriminatorField\n            ? Object.values(meta.fields)\n            : Object.values(meta.fields).filter((f) => f.fieldName !== \"id\"),\n        )\n      : Object.values(meta.fields)\n  )\n    .filter((f) => changedFields.has(f.fieldName))\n    .filter((f) => !lazyFieldNames.has(f.fieldName))\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n\n  // If we're using class table inheritance, base/child tables may not have any columns to update\n  if (columns.length === 1) {\n    return undefined;\n  }\n\n  // We already have the bumped updated_at column, but also include the original updated_at for the data CTE\n  if (updatedAt) {\n    const serde = meta.fields[updatedAt].serde as TimestampSerde<unknown>;\n    columns.push({\n      columnName: \"__original_updated_at\",\n      dbType: \"timestamptz\",\n      dbValue: (_, entity) => serde.dbValue(getInstanceData(entity).originalData),\n    });\n  }\n\n  const columnValues = collectBindings(entities, meta.tableName, columns, []);\n  const updatedAtColumn = updatedAt ? (meta.fields[updatedAt] as PrimitiveField).serde.columns[0] : undefined;\n  return { tableName: meta.tableName, columns, updatedAt: updatedAtColumn?.columnName, columnValues };\n}\n\nfunction addDeletes(ops: Ops, todo: Todo): void {\n  if (todo.deletes.length > 0) {\n    const meta = todo.metadata;\n    const ids = todo.deletes.map((e) => keyToNumber(meta, e.idTagged!).toString());\n    if (meta.subTypes.length > 0) {\n      getBaseSelfAndSubMetas(meta).forEach((meta) => {\n        ops.deletes.push({ tableName: meta.tableName, ids });\n      });\n    } else {\n      ops.deletes.push({ tableName: meta.tableName, ids });\n    }\n  }\n}\n\nfunction groupEntitiesByTable(entities: Entity[]): Array<[EntityMetadata, Entity[]]> {\n  const entitiesByType: Map<EntityMetadata, Entity[]> = new Map();\n  for (const e of entities) {\n    for (const m of getBaseAndSelfMetas(getMetadata(e))) {\n      let list = entitiesByType.get(m);\n      if (!list) {\n        list = [];\n        entitiesByType.set(m, list);\n      }\n      list.push(e);\n    }\n  }\n  return [...entitiesByType.entries()];\n}\n\ntype BindingColumn = OpColumn & Pick<FieldColumn, \"dbValue\">;\ntype EntityWithData = Entity & { __data: { data: Record<string, unknown> } };\n\n/**\n * Builds a *columnar* array of bindings for the given `entities` and `columns`.\n *\n * We use a columnar approach, instead of `rows[]`, to best match the unnest-based\n * column operations in our `batchInsert` / `batchUpdate` SQL statements.\n */\nfunction collectBindings(\n  entities: Entity[],\n  tableName: string,\n  columns: BindingColumn[],\n  fixups: InsertFixup[] | undefined,\n): any[][] {\n  const entityCount = entities.length;\n  const bindings: any[][] = new Array(columns.length);\n  const entitiesWithData = entities as EntityWithData[];\n  // Cache data separately; this benchmarks faster than `entities[i].__data.data` in the inner loop.\n  const entityData = new Array(entityCount);\n  for (let i = 0; i < entityCount; i++) entityData[i] = entitiesWithData[i].__data.data;\n  for (let columnIndex = 0; columnIndex < columns.length; columnIndex++) {\n    const column = columns[columnIndex];\n    const columnValues: any[] = new Array(entityCount);\n    for (let entityIndex = 0; entityIndex < entityCount; entityIndex++) {\n      columnValues[entityIndex] =\n        column.dbValue(entityData[entityIndex], entities[entityIndex], tableName, fixups) ?? null;\n    }\n    bindings[columnIndex] = columnValues;\n  }\n  return bindings;\n}\n/**\n * Given `fixups` that indicate where we inserted `NULL` into non-deferred FKs, create `UPDATE`s\n * that insert the value now that the FK check will succeed.\n */\nfunction translateFixupsIntoUpdates(ops: Ops, fixups: InsertFixup[]): void {\n  // Create a single `UPDATE` for the N fixups we might have for each table/column combination\n  groupBy(fixups, (f) => `${f.tableName}.${f.column.columnName}`).forEach((fixups) => {\n    const { tableName, entity, column } = fixups[0];\n    ops.updates.push({\n      tableName,\n      columns: [getMetadata(entity).fields[\"id\"].serde!.columns[0], column],\n      columnValues: [\n        // Make 1 column of ids, and 1 column of values\n        fixups.map((fixup) => fixup.entity.id),\n        fixups.map((fixup) => fixup.value),\n      ],\n      updatedAt: undefined,\n    });\n  });\n}\n"],"mappings":"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"}

package/build/drivers/EntityWriter.d.cts

@@ -1,4 +1,4 @@
-import { Todo } from "../Todo.cjs";
+import { Todo } from "../flush/Todo.cjs";
 import { Entity } from "../Entity.cjs";
 //#region src/drivers/EntityWriter.d.ts
 /** A simplified view of columns, with only the keys necessary to create SQL statements. */

package/build/drivers/EntityWriter.d.mts

@@ -1,4 +1,4 @@
-import { Todo } from "../Todo.mjs";
+import { Todo } from "../flush/Todo.mjs";
 import { Entity } from "../Entity.mjs";
 //#region src/drivers/EntityWriter.d.ts
 /** A simplified view of columns, with only the keys necessary to create SQL statements. */

package/build/drivers/EntityWriter.js

@@ -1,8 +1,7 @@
 import { getField, isChangeableField } from "../fields.js";
-import "../Todo.js";
-import { groupBy } from "../utils.js";
 import { keyToNumber } from "../keys.js";
-import { hasSerde } from "../fieldSerde.js";
+import { groupBy } from "../utils.js";
+import { hasSerde } from "../serde/fieldSerde.js";
 import { getBaseAndSelfMetas, getBaseSelfAndSubMetas, getMetadata } from "../EntityMetadata.js";
 import "../Entity.js";
 import { getInstanceData } from "../BaseEntity.js";

package/build/drivers/EntityWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityWriter.js","names":[],"sources":["../../src/drivers/EntityWriter.ts"],"sourcesContent":["import { getInstanceData } from \"../BaseEntity.ts\";\nimport { type Entity } from \"../Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PrimitiveField,\n  getBaseAndSelfMetas,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"../EntityMetadata.ts\";\nimport { getField, isChangeableField } from \"../fields.ts\";\nimport { type FieldColumn, type TimestampSerde, hasSerde } from \"../fieldSerde.ts\";\nimport { keyToNumber } from \"../keys.ts\";\nimport { type Todo } from \"../Todo.ts\";\nimport { groupBy } from \"../utils.ts\";\n\n/** A simplified view of columns, with only the keys necessary to create SQL statements. */\nexport type OpColumn = { columnName: string; dbType: string; isNullableArray?: boolean };\nexport type InsertOp = { tableName: string; columns: OpColumn[]; columnValues: any[][] };\n/**\n * A logical `update` operation.\n *\n * If we're using op locks, `columns` will include both the new `updatedAt` value (as bumped\n * by the `EntityManager` on mutate), as well as an extra/last \"original updated at\" column\n * (with respective pre-update values in the `rows` data), for including in the conditional\n * update clause.\n */\nexport type UpdateOp = {\n  tableName: string;\n  columns: OpColumn[];\n  columnValues: any[][];\n  updatedAt: string | undefined;\n};\nexport type DeleteOp = { tableName: string; ids: any[] };\n\ntype Ops = { inserts: InsertOp[]; updates: UpdateOp[]; deletes: DeleteOp[] };\n\n/**\n * In schemas with entity FK cycles, we may insert a dummy/null value, and later fix it up\n * before the transaction commits.\n *\n * I.e. `INSERT author.favorite_book_id` as `NULL` and then later do an `UPDATE author\n * SET favorite_book_id = 1` after the book has been inserted/we have the id.\n */\nexport type InsertFixup = {\n  entity: Entity;\n  tableName: string;\n  column: OpColumn;\n  value: any;\n};\n\n/**\n * Builds AST-ish `Ops` for the inserts/updates/deletes in `todos`.\n *\n * This helps decouple the database-specific driver/library from the knowledge\n * of turning entities into table operations, i.e. so they can be unaware of\n * complexities like field -> column mapping, oplocks, and class table inheritance.\n *\n * We still assume Postgres b/c we assume all ids have been pre-assigned for INSERTs,\n * and don't do any topological sorting of cross-row FK dependencies.\n *\n * But this should let us experiment with knex vs. raw client/etc.\n */\nexport function generateOps(todos: Record<string, Todo>): Ops {\n  const ops: Ops = { inserts: [], updates: [], deletes: [] };\n  const fixups: InsertFixup[] = [];\n  // Would be nice to conditionally sort\n  const sorted = Object.values(todos).sort(\n    (a, b) => (a.metadata.nonDeferredFkOrder ?? 0) - (b.metadata.nonDeferredFkOrder ?? 0),\n  );\n  for (const todo of sorted) {\n    addInserts(ops, todo, fixups);\n    addUpdates(ops, todo);\n    addDeletes(ops, todo);\n  }\n  if (fixups.length > 0) translateFixupsIntoUpdates(ops, fixups);\n  return ops;\n}\n\nfunction addInserts(ops: Ops, todo: Todo, fixups: InsertFixup[]): void {\n  if (todo.inserts.length > 0) {\n    // If we have subtypes, this todo.metadata will always be the base type\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        // Insert into each of the CTI tables\n        for (const [meta, group] of groupEntitiesByTable(todo.inserts)) {\n          ops.inserts.push(newInsertOp(meta, group, fixups));\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        // One INSERT per subtype, so each statement's column list spans exactly what that subtype can\n        // set. A single statement across subtypes has to bind NULL for the other subtypes' columns,\n        // which defeats their database defaults, and outright fails for notNull ones.\n        for (const group of groupBy(todo.inserts, (e) => getMetadata(e)).values()) {\n          ops.inserts.push(newStiInsertOp(meta, group, fixups));\n        }\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      ops.inserts.push(newInsertOp(meta, todo.inserts, fixups));\n    }\n  }\n}\n\nfunction newInsertOp(meta: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // Purposefully use `meta.fields` instead of `allFields` b/c each CTI table has its own `InsertOp`\n  const columns = Object.values(meta.fields)\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, meta.tableName, columns, fixups);\n  return { tableName: meta.tableName, columns, columnValues };\n}\n\nfunction newStiInsertOp(root: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // `allFields` is the base's fields plus this subtype's own, i.e. everything this subtype can write.\n  // Anything it can't write is left out of the statement entirely, so the database applies its default.\n  const fields: Field[] = Object.values(getMetadata(entities[0]).allFields);\n  const columns = fields.filter(hasSerde).flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, root.tableName, columns, fixups);\n  return { tableName: root.tableName, columns, columnValues };\n}\n\nfunction addUpdates(ops: Ops, todo: Todo): void {\n  if (todo.updates.length > 0) {\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        for (const [meta, group] of groupEntitiesByTable(todo.updates)) {\n          const op = newUpdateOp(meta, group);\n          if (op) ops.updates.push(op);\n          addLazyUpdates(ops, meta, group);\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        const op = newUpdateOp(meta, todo.updates);\n        if (op) ops.updates.push(op);\n        addLazyUpdates(ops, meta, todo.updates);\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      const op = newUpdateOp(meta, todo.updates);\n      if (op) ops.updates.push(op);\n      addLazyUpdates(ops, meta, todo.updates);\n    }\n  }\n}\n\n/**\n * Writes changed `lazy` columns via a targeted `UPDATE table SET lazy_col = ... WHERE id in (...)`.\n *\n * Lazy columns are excluded from the main batch UPDATE (which spans the batch's union of changed fields),\n * so that entities in the batch that never loaded a lazy column keep their existing db value instead of\n * being overwritten with null. Here we write each lazy column only for the entities that actually changed it.\n */\nfunction addLazyUpdates(ops: Ops, meta: EntityMetadata, entities: Entity[]): void {\n  const idColumn = meta.fields[\"id\"].serde!.columns[0];\n  for (const fieldName of meta.lazyFieldNames!) {\n    const field = meta.fields[fieldName];\n    if (!hasSerde(field)) continue;\n    const changed = entities.filter((e) => fieldName in getInstanceData(e).changedData);\n    if (changed.length === 0) continue;\n    const columns: BindingColumn[] = [idColumn, ...field.serde.columns];\n    const columnValues = collectBindings(changed, meta.tableName, columns, undefined);\n    ops.updates.push({ tableName: meta.tableName, columns, columnValues, updatedAt: undefined });\n  }\n}\n\nfunction newUpdateOp(meta: EntityMetadata, entities: Entity[]): UpdateOp | undefined {\n  // We only include changed fields in our `UPDATE`--maybe we could change this\n  // to always use the same fields, to take advantage of Prepared Statements.\n  const changedFields = new Set<string>();\n  for (const entity of entities) {\n    for (const fieldName in getInstanceData(entity).changedData) changedFields.add(fieldName);\n  }\n  // Sometimes with derived fields, an instance will be marked as an update, but if the derived field hasn't\n  // actually changed, it'll be a noop, so just short-circuit if it looks like that happened. Unless touched.\n  if (changedFields.size === 0 && !entities.some((e) => getInstanceData(e).isTouched)) {\n    return undefined;\n  }\n\n  // We may have loaded a1 and a2, and changed a1.firstName, and a2.lastName, but either one\n  // might be missing the other's changed fields in it's lazy-initialized data field...\n  // (Use `?` because subtypes won't have the updatedAt, and it will be handled by the base type\n  // `newUpdateUp`--except STI where we're doing it all in one go, probably needs checked here.)\n  const updatedAt = meta.timestampFields?.updatedAt;\n  changedFields.add(\"id\");\n  if (updatedAt) changedFields.add(updatedAt);\n  // `lazy` columns are deliberately excluded from the batch UPDATE and written by `addLazyUpdates`; an\n  // entity that never loaded a lazy column isn't in `row`, so forcing `getField` here would clobber it to null.\n  const lazyFieldNames = meta.lazyFieldNames!;\n  for (const entity of entities) {\n    const { data } = getInstanceData(entity);\n    for (const key of changedFields) {\n      // Check isChangeableField because we might be updating the base `publishers` table\n      // and `originalData` might have fields from a subclass `large_publishers` table.\n      if (!(key in data) && isChangeableField(entity, key) && !lazyFieldNames.has(key)) {\n        getField(entity, key);\n      }\n    }\n  }\n\n  const columns: Array<BindingColumn> = (\n    meta.inheritanceType === \"sti\"\n      ? // Hack this one handling of STI into here...\n        getBaseSelfAndSubMetas(meta).flatMap((meta) =>\n          meta.stiDiscriminatorField\n            ? Object.values(meta.fields)\n            : Object.values(meta.fields).filter((f) => f.fieldName !== \"id\"),\n        )\n      : Object.values(meta.fields)\n  )\n    .filter((f) => changedFields.has(f.fieldName))\n    .filter((f) => !lazyFieldNames.has(f.fieldName))\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n\n  // If we're using class table inheritance, base/child tables may not have any columns to update\n  if (columns.length === 1) {\n    return undefined;\n  }\n\n  // We already have the bumped updated_at column, but also include the original updated_at for the data CTE\n  if (updatedAt) {\n    const serde = meta.fields[updatedAt].serde as TimestampSerde<unknown>;\n    columns.push({\n      columnName: \"__original_updated_at\",\n      dbType: \"timestamptz\",\n      dbValue: (_, entity) => serde.dbValue(getInstanceData(entity).originalData),\n    });\n  }\n\n  const columnValues = collectBindings(entities, meta.tableName, columns, []);\n  const updatedAtColumn = updatedAt ? (meta.fields[updatedAt] as PrimitiveField).serde.columns[0] : undefined;\n  return { tableName: meta.tableName, columns, updatedAt: updatedAtColumn?.columnName, columnValues };\n}\n\nfunction addDeletes(ops: Ops, todo: Todo): void {\n  if (todo.deletes.length > 0) {\n    const meta = todo.metadata;\n    const ids = todo.deletes.map((e) => keyToNumber(meta, e.idTagged!).toString());\n    if (meta.subTypes.length > 0) {\n      getBaseSelfAndSubMetas(meta).forEach((meta) => {\n        ops.deletes.push({ tableName: meta.tableName, ids });\n      });\n    } else {\n      ops.deletes.push({ tableName: meta.tableName, ids });\n    }\n  }\n}\n\nfunction groupEntitiesByTable(entities: Entity[]): Array<[EntityMetadata, Entity[]]> {\n  const entitiesByType: Map<EntityMetadata, Entity[]> = new Map();\n  for (const e of entities) {\n    for (const m of getBaseAndSelfMetas(getMetadata(e))) {\n      let list = entitiesByType.get(m);\n      if (!list) {\n        list = [];\n        entitiesByType.set(m, list);\n      }\n      list.push(e);\n    }\n  }\n  return [...entitiesByType.entries()];\n}\n\ntype BindingColumn = OpColumn & Pick<FieldColumn, \"dbValue\">;\ntype EntityWithData = Entity & { __data: { data: Record<string, unknown> } };\n\n/**\n * Builds a *columnar* array of bindings for the given `entities` and `columns`.\n *\n * We use a columnar approach, instead of `rows[]`, to best match the unnest-based\n * column operations in our `batchInsert` / `batchUpdate` SQL statements.\n */\nfunction collectBindings(\n  entities: Entity[],\n  tableName: string,\n  columns: BindingColumn[],\n  fixups: InsertFixup[] | undefined,\n): any[][] {\n  const entityCount = entities.length;\n  const bindings: any[][] = new Array(columns.length);\n  const entitiesWithData = entities as EntityWithData[];\n  // Cache data separately; this benchmarks faster than `entities[i].__data.data` in the inner loop.\n  const entityData = new Array(entityCount);\n  for (let i = 0; i < entityCount; i++) entityData[i] = entitiesWithData[i].__data.data;\n  for (let columnIndex = 0; columnIndex < columns.length; columnIndex++) {\n    const column = columns[columnIndex];\n    const columnValues: any[] = new Array(entityCount);\n    for (let entityIndex = 0; entityIndex < entityCount; entityIndex++) {\n      columnValues[entityIndex] =\n        column.dbValue(entityData[entityIndex], entities[entityIndex], tableName, fixups) ?? null;\n    }\n    bindings[columnIndex] = columnValues;\n  }\n  return bindings;\n}\n/**\n * Given `fixups` that indicate where we inserted `NULL` into non-deferred FKs, create `UPDATE`s\n * that insert the value now that the FK check will succeed.\n */\nfunction translateFixupsIntoUpdates(ops: Ops, fixups: InsertFixup[]): void {\n  // Create a single `UPDATE` for the N fixups we might have for each table/column combination\n  groupBy(fixups, (f) => `${f.tableName}.${f.column.columnName}`).forEach((fixups) => {\n    const { tableName, entity, column } = fixups[0];\n    ops.updates.push({\n      tableName,\n      columns: [getMetadata(entity).fields[\"id\"].serde!.columns[0], column],\n      columnValues: [\n        // Make 1 column of ids, and 1 column of values\n        fixups.map((fixup) => fixup.entity.id),\n        fixups.map((fixup) => fixup.value),\n      ],\n      updatedAt: undefined,\n    });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"EntityWriter.js","names":[],"sources":["../../src/drivers/EntityWriter.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PrimitiveField,\n  getBaseAndSelfMetas,\n  getBaseSelfAndSubMetas,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { getField, isChangeableField } from \"src/fields.ts\";\nimport type { Todo } from \"src/flush/Todo.ts\";\nimport { keyToNumber } from \"src/keys.ts\";\nimport { type FieldColumn, type TimestampSerde, hasSerde } from \"src/serde/fieldSerde.ts\";\nimport { groupBy } from \"src/utils.ts\";\n\n/** A simplified view of columns, with only the keys necessary to create SQL statements. */\nexport type OpColumn = { columnName: string; dbType: string; isNullableArray?: boolean };\nexport type InsertOp = { tableName: string; columns: OpColumn[]; columnValues: any[][] };\n/**\n * A logical `update` operation.\n *\n * If we're using op locks, `columns` will include both the new `updatedAt` value (as bumped\n * by the `EntityManager` on mutate), as well as an extra/last \"original updated at\" column\n * (with respective pre-update values in the `rows` data), for including in the conditional\n * update clause.\n */\nexport type UpdateOp = {\n  tableName: string;\n  columns: OpColumn[];\n  columnValues: any[][];\n  updatedAt: string | undefined;\n};\nexport type DeleteOp = { tableName: string; ids: any[] };\n\ntype Ops = { inserts: InsertOp[]; updates: UpdateOp[]; deletes: DeleteOp[] };\n\n/**\n * In schemas with entity FK cycles, we may insert a dummy/null value, and later fix it up\n * before the transaction commits.\n *\n * I.e. `INSERT author.favorite_book_id` as `NULL` and then later do an `UPDATE author\n * SET favorite_book_id = 1` after the book has been inserted/we have the id.\n */\nexport type InsertFixup = {\n  entity: Entity;\n  tableName: string;\n  column: OpColumn;\n  value: any;\n};\n\n/**\n * Builds AST-ish `Ops` for the inserts/updates/deletes in `todos`.\n *\n * This helps decouple the database-specific driver/library from the knowledge\n * of turning entities into table operations, i.e. so they can be unaware of\n * complexities like field -> column mapping, oplocks, and class table inheritance.\n *\n * We still assume Postgres b/c we assume all ids have been pre-assigned for INSERTs,\n * and don't do any topological sorting of cross-row FK dependencies.\n *\n * But this should let us experiment with knex vs. raw client/etc.\n */\nexport function generateOps(todos: Record<string, Todo>): Ops {\n  const ops: Ops = { inserts: [], updates: [], deletes: [] };\n  const fixups: InsertFixup[] = [];\n  // Would be nice to conditionally sort\n  const sorted = Object.values(todos).sort(\n    (a, b) => (a.metadata.nonDeferredFkOrder ?? 0) - (b.metadata.nonDeferredFkOrder ?? 0),\n  );\n  for (const todo of sorted) {\n    addInserts(ops, todo, fixups);\n    addUpdates(ops, todo);\n    addDeletes(ops, todo);\n  }\n  if (fixups.length > 0) translateFixupsIntoUpdates(ops, fixups);\n  return ops;\n}\n\nfunction addInserts(ops: Ops, todo: Todo, fixups: InsertFixup[]): void {\n  if (todo.inserts.length > 0) {\n    // If we have subtypes, this todo.metadata will always be the base type\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        // Insert into each of the CTI tables\n        for (const [meta, group] of groupEntitiesByTable(todo.inserts)) {\n          ops.inserts.push(newInsertOp(meta, group, fixups));\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        // One INSERT per subtype, so each statement's column list spans exactly what that subtype can\n        // set. A single statement across subtypes has to bind NULL for the other subtypes' columns,\n        // which defeats their database defaults, and outright fails for notNull ones.\n        for (const group of groupBy(todo.inserts, (e) => getMetadata(e)).values()) {\n          ops.inserts.push(newStiInsertOp(meta, group, fixups));\n        }\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      ops.inserts.push(newInsertOp(meta, todo.inserts, fixups));\n    }\n  }\n}\n\nfunction newInsertOp(meta: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // Purposefully use `meta.fields` instead of `allFields` b/c each CTI table has its own `InsertOp`\n  const columns = Object.values(meta.fields)\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, meta.tableName, columns, fixups);\n  return { tableName: meta.tableName, columns, columnValues };\n}\n\nfunction newStiInsertOp(root: EntityMetadata, entities: Entity[], fixups: InsertFixup[]): InsertOp {\n  // `allFields` is the base's fields plus this subtype's own, i.e. everything this subtype can write.\n  // Anything it can't write is left out of the statement entirely, so the database applies its default.\n  const fields: Field[] = Object.values(getMetadata(entities[0]).allFields);\n  const columns = fields.filter(hasSerde).flatMap((f) => f.serde.columns);\n  const columnValues = collectBindings(entities, root.tableName, columns, fixups);\n  return { tableName: root.tableName, columns, columnValues };\n}\n\nfunction addUpdates(ops: Ops, todo: Todo): void {\n  if (todo.updates.length > 0) {\n    const meta = todo.metadata;\n    if (meta.subTypes.length > 0) {\n      if (meta.inheritanceType === \"cti\") {\n        for (const [meta, group] of groupEntitiesByTable(todo.updates)) {\n          const op = newUpdateOp(meta, group);\n          if (op) ops.updates.push(op);\n          addLazyUpdates(ops, meta, group);\n        }\n      } else if (meta.inheritanceType === \"sti\") {\n        const op = newUpdateOp(meta, todo.updates);\n        if (op) ops.updates.push(op);\n        addLazyUpdates(ops, meta, todo.updates);\n      } else {\n        throw new Error(`Found ${meta.tableName} subTypes without a known inheritanceType ${meta.inheritanceType}`);\n      }\n    } else {\n      const op = newUpdateOp(meta, todo.updates);\n      if (op) ops.updates.push(op);\n      addLazyUpdates(ops, meta, todo.updates);\n    }\n  }\n}\n\n/**\n * Writes changed `lazy` columns via a targeted `UPDATE table SET lazy_col = ... WHERE id in (...)`.\n *\n * Lazy columns are excluded from the main batch UPDATE (which spans the batch's union of changed fields),\n * so that entities in the batch that never loaded a lazy column keep their existing db value instead of\n * being overwritten with null. Here we write each lazy column only for the entities that actually changed it.\n */\nfunction addLazyUpdates(ops: Ops, meta: EntityMetadata, entities: Entity[]): void {\n  const idColumn = meta.fields[\"id\"].serde!.columns[0];\n  for (const fieldName of meta.lazyFieldNames!) {\n    const field = meta.fields[fieldName];\n    if (!hasSerde(field)) continue;\n    const changed = entities.filter((e) => fieldName in getInstanceData(e).changedData);\n    if (changed.length === 0) continue;\n    const columns: BindingColumn[] = [idColumn, ...field.serde.columns];\n    const columnValues = collectBindings(changed, meta.tableName, columns, undefined);\n    ops.updates.push({ tableName: meta.tableName, columns, columnValues, updatedAt: undefined });\n  }\n}\n\nfunction newUpdateOp(meta: EntityMetadata, entities: Entity[]): UpdateOp | undefined {\n  // We only include changed fields in our `UPDATE`--maybe we could change this\n  // to always use the same fields, to take advantage of Prepared Statements.\n  const changedFields = new Set<string>();\n  for (const entity of entities) {\n    for (const fieldName in getInstanceData(entity).changedData) changedFields.add(fieldName);\n  }\n  // Sometimes with derived fields, an instance will be marked as an update, but if the derived field hasn't\n  // actually changed, it'll be a noop, so just short-circuit if it looks like that happened. Unless touched.\n  if (changedFields.size === 0 && !entities.some((e) => getInstanceData(e).isTouched)) {\n    return undefined;\n  }\n\n  // We may have loaded a1 and a2, and changed a1.firstName, and a2.lastName, but either one\n  // might be missing the other's changed fields in it's lazy-initialized data field...\n  // (Use `?` because subtypes won't have the updatedAt, and it will be handled by the base type\n  // `newUpdateUp`--except STI where we're doing it all in one go, probably needs checked here.)\n  const updatedAt = meta.timestampFields?.updatedAt;\n  changedFields.add(\"id\");\n  if (updatedAt) changedFields.add(updatedAt);\n  // `lazy` columns are deliberately excluded from the batch UPDATE and written by `addLazyUpdates`; an\n  // entity that never loaded a lazy column isn't in `row`, so forcing `getField` here would clobber it to null.\n  const lazyFieldNames = meta.lazyFieldNames!;\n  for (const entity of entities) {\n    const { data } = getInstanceData(entity);\n    for (const key of changedFields) {\n      // Check isChangeableField because we might be updating the base `publishers` table\n      // and `originalData` might have fields from a subclass `large_publishers` table.\n      if (!(key in data) && isChangeableField(entity, key) && !lazyFieldNames.has(key)) {\n        getField(entity, key);\n      }\n    }\n  }\n\n  const columns: Array<BindingColumn> = (\n    meta.inheritanceType === \"sti\"\n      ? // Hack this one handling of STI into here...\n        getBaseSelfAndSubMetas(meta).flatMap((meta) =>\n          meta.stiDiscriminatorField\n            ? Object.values(meta.fields)\n            : Object.values(meta.fields).filter((f) => f.fieldName !== \"id\"),\n        )\n      : Object.values(meta.fields)\n  )\n    .filter((f) => changedFields.has(f.fieldName))\n    .filter((f) => !lazyFieldNames.has(f.fieldName))\n    .filter(hasSerde)\n    .flatMap((f) => f.serde.columns);\n\n  // If we're using class table inheritance, base/child tables may not have any columns to update\n  if (columns.length === 1) {\n    return undefined;\n  }\n\n  // We already have the bumped updated_at column, but also include the original updated_at for the data CTE\n  if (updatedAt) {\n    const serde = meta.fields[updatedAt].serde as TimestampSerde<unknown>;\n    columns.push({\n      columnName: \"__original_updated_at\",\n      dbType: \"timestamptz\",\n      dbValue: (_, entity) => serde.dbValue(getInstanceData(entity).originalData),\n    });\n  }\n\n  const columnValues = collectBindings(entities, meta.tableName, columns, []);\n  const updatedAtColumn = updatedAt ? (meta.fields[updatedAt] as PrimitiveField).serde.columns[0] : undefined;\n  return { tableName: meta.tableName, columns, updatedAt: updatedAtColumn?.columnName, columnValues };\n}\n\nfunction addDeletes(ops: Ops, todo: Todo): void {\n  if (todo.deletes.length > 0) {\n    const meta = todo.metadata;\n    const ids = todo.deletes.map((e) => keyToNumber(meta, e.idTagged!).toString());\n    if (meta.subTypes.length > 0) {\n      getBaseSelfAndSubMetas(meta).forEach((meta) => {\n        ops.deletes.push({ tableName: meta.tableName, ids });\n      });\n    } else {\n      ops.deletes.push({ tableName: meta.tableName, ids });\n    }\n  }\n}\n\nfunction groupEntitiesByTable(entities: Entity[]): Array<[EntityMetadata, Entity[]]> {\n  const entitiesByType: Map<EntityMetadata, Entity[]> = new Map();\n  for (const e of entities) {\n    for (const m of getBaseAndSelfMetas(getMetadata(e))) {\n      let list = entitiesByType.get(m);\n      if (!list) {\n        list = [];\n        entitiesByType.set(m, list);\n      }\n      list.push(e);\n    }\n  }\n  return [...entitiesByType.entries()];\n}\n\ntype BindingColumn = OpColumn & Pick<FieldColumn, \"dbValue\">;\ntype EntityWithData = Entity & { __data: { data: Record<string, unknown> } };\n\n/**\n * Builds a *columnar* array of bindings for the given `entities` and `columns`.\n *\n * We use a columnar approach, instead of `rows[]`, to best match the unnest-based\n * column operations in our `batchInsert` / `batchUpdate` SQL statements.\n */\nfunction collectBindings(\n  entities: Entity[],\n  tableName: string,\n  columns: BindingColumn[],\n  fixups: InsertFixup[] | undefined,\n): any[][] {\n  const entityCount = entities.length;\n  const bindings: any[][] = new Array(columns.length);\n  const entitiesWithData = entities as EntityWithData[];\n  // Cache data separately; this benchmarks faster than `entities[i].__data.data` in the inner loop.\n  const entityData = new Array(entityCount);\n  for (let i = 0; i < entityCount; i++) entityData[i] = entitiesWithData[i].__data.data;\n  for (let columnIndex = 0; columnIndex < columns.length; columnIndex++) {\n    const column = columns[columnIndex];\n    const columnValues: any[] = new Array(entityCount);\n    for (let entityIndex = 0; entityIndex < entityCount; entityIndex++) {\n      columnValues[entityIndex] =\n        column.dbValue(entityData[entityIndex], entities[entityIndex], tableName, fixups) ?? null;\n    }\n    bindings[columnIndex] = columnValues;\n  }\n  return bindings;\n}\n/**\n * Given `fixups` that indicate where we inserted `NULL` into non-deferred FKs, create `UPDATE`s\n * that insert the value now that the FK check will succeed.\n */\nfunction translateFixupsIntoUpdates(ops: Ops, fixups: InsertFixup[]): void {\n  // Create a single `UPDATE` for the N fixups we might have for each table/column combination\n  groupBy(fixups, (f) => `${f.tableName}.${f.column.columnName}`).forEach((fixups) => {\n    const { tableName, entity, column } = fixups[0];\n    ops.updates.push({\n      tableName,\n      columns: [getMetadata(entity).fields[\"id\"].serde!.columns[0], column],\n      columnValues: [\n        // Make 1 column of ids, and 1 column of values\n        fixups.map((fixup) => fixup.entity.id),\n        fixups.map((fixup) => fixup.value),\n      ],\n      updatedAt: undefined,\n    });\n  });\n}\n"],"mappings":"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"}

package/build/drivers/IdAssigner.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
-require("../Todo.cjs");
 const require_keys = require("../keys.cjs");
 const require_BaseEntity = require("../BaseEntity.cjs");
 let crypto = require("crypto");

package/build/drivers/IdAssigner.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"IdAssigner.cjs","names":["#runner","keyToTaggedId"],"sources":["../../src/drivers/IdAssigner.ts"],"sourcesContent":["import * as crypto from \"crypto\";\n\nimport { getInstanceData } from \"../BaseEntity.ts\";\nimport { keyToTaggedId } from \"../keys.ts\";\nimport { type Todo } from \"../Todo.ts\";\n\nexport interface IdAssigner {\n  assignNewIds(todos: Record<string, Todo>): Promise<void>;\n}\n\n/** Super-small/dumb wrapper around maybe-Knex/maybe-postgres.js/maybe-Bun-sql libraries. */\ntype QueryRunner = (sql: string) => Promise<any[]>;\n\n/**\n * Assigns all new entities an id directly from their corresponding sequence generator, instead of via INSERTs.\n *\n * This lets us avoid cyclic issues with some INSERTs having foreign keys to other rows that themselves\n * need to first be INSERTed.\n */\nexport class SequenceIdAssigner implements IdAssigner {\n  #runner: QueryRunner;\n\n  public constructor(runner: QueryRunner) {\n    this.#runner = runner;\n  }\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    const seqStatements: string[] = [];\n    Object.values(todos).forEach((todo) => {\n      // Even if we have INSERTs, the user may have already assigned ids...\n      const needsIds = todo.inserts.filter((e) => e.idMaybe === undefined);\n      if (needsIds.length > 0) {\n        const sequenceName = `${todo.metadata.tableName}_id_seq`;\n        const sql = `select nextval('${sequenceName}') from generate_series(1, ${needsIds.length})`;\n        seqStatements.push(sql);\n      }\n    });\n    if (seqStatements.length > 0) {\n      // There will be 1 per table; 1 single insert should be fine but we might need to batch for super-large schemas?\n      const sql = seqStatements.join(\" UNION ALL \");\n      const result = await this.#runner(sql);\n      let i = 0;\n      Object.values(todos).forEach((todo) => {\n        for (const insert of todo.inserts.filter((e) => e.idMaybe === undefined)) {\n          // Use todo.metadata so that all subtypes get their base type's tag\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, result[i++][\"nextval\"]);\n        }\n      });\n    }\n  }\n}\n\n/**\n * Creates random UUIDs for uuid-based keys in production environments.\n *\n * See {@link TestUuidAssigner} for creating stable-ish ids for tests\n */\nexport class RandomUuidAssigner implements IdAssigner {\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.values(todos).forEach((todo) => {\n      for (const insert of todo.inserts) {\n        getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, crypto.randomUUID());\n      }\n    });\n  }\n}\n\n/**\n * Creates deterministic / stable-ish UUIDs for test suites.\n *\n * We use each entity's tag as the 3rd group of digits, and a per-entity incrementing integer as\n * the 4th group of digits.\n *\n * E.g. a test with two Authors (tag `a`) and three Books (tag `b`) will get these ids:\n *\n * ```\n * 00000000-0000-0000-000a-000000000000\n * 00000000-0000-0000-000a-000000000001\n * 00000000-0000-0000-000b-000000000000\n * 00000000-0000-0000-000b-000000000001\n * 00000000-0000-0000-000b-000000000002\n * ```\n */\nexport class TestUuidAssigner implements IdAssigner {\n  private nextId: Record<string, number> = {};\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.entries(todos).forEach(([, todo]) => {\n      if (todo.inserts.length > 0) {\n        const tag = todo.metadata.tagName.substring(0, 4).padStart(4, \"0\");\n        this.nextId[tag] ??= 0;\n        for (const insert of todo.inserts) {\n          const id = String(this.nextId[tag]++);\n          const uuid = `00000000-0000-0000-${tag}-${id.padStart(12, \"0\")}`;\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, uuid);\n        }\n      }\n    });\n  }\n\n  reset() {\n    this.nextId = {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,IAAa,qBAAb,MAAsD;CACpD;CAEA,YAAmB,QAAqB;EACtC,KAAKA,UAAU;CACjB;CAEA,MAAM,aAAa,OAA4C;EAC7D,MAAM,gBAA0B,CAAC;EACjC,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GAErC,MAAM,WAAW,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS;GACnE,IAAI,SAAS,SAAS,GAAG;IAEvB,MAAM,MAAM,mBAAmB,GADP,KAAK,SAAS,UAAU,SACJ,6BAA6B,SAAS,OAAO;IACzF,cAAc,KAAK,GAAG;GACxB;EACF,CAAC;EACD,IAAI,cAAc,SAAS,GAAG;GAE5B,MAAM,MAAM,cAAc,KAAK,aAAa;GAC5C,MAAM,SAAS,MAAM,KAAKA,QAAQ,GAAG;GACrC,IAAI,IAAI;GACR,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;IACrC,KAAK,MAAM,UAAU,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS,GAErE,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQC,aAAAA,cAAc,KAAK,UAAU,OAAO,IAAI,CAAC,UAAU;GAE5F,CAAC;EACH;CACF;AACF;;;;;;AAOA,IAAa,qBAAb,MAAsD;CACpD,MAAM,aAAa,OAA4C;EAC7D,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GACrC,KAAK,MAAM,UAAU,KAAK,SACxB,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQA,aAAAA,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC;EAEzF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;AAkBA,IAAa,mBAAb,MAAoD;CAClD,SAAyC,CAAC;CAE1C,MAAM,aAAa,OAA4C;EAC7D,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU;GAC1C,IAAI,KAAK,QAAQ,SAAS,GAAG;IAC3B,MAAM,MAAM,KAAK,SAAS,QAAQ,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;IACjE,KAAK,OAAO,SAAS;IACrB,KAAK,MAAM,UAAU,KAAK,SAAS;KAEjC,MAAM,OAAO,sBAAsB,IAAI,GAD5B,OAAO,KAAK,OAAO,IAAI,EACS,CAAC,CAAC,SAAS,IAAI,GAAG;KAC7D,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQA,aAAAA,cAAc,KAAK,UAAU,IAAI;IACxE;GACF;EACF,CAAC;CACH;CAEA,QAAQ;EACN,KAAK,SAAS,CAAC;CACjB;AACF"}
+{"version":3,"file":"IdAssigner.cjs","names":["#runner","keyToTaggedId"],"sources":["../../src/drivers/IdAssigner.ts"],"sourcesContent":["import * as crypto from \"crypto\";\n\nimport { getInstanceData } from \"src/BaseEntity.ts\";\nimport type { Todo } from \"src/flush/Todo.ts\";\nimport { keyToTaggedId } from \"src/keys.ts\";\n\nexport interface IdAssigner {\n  assignNewIds(todos: Record<string, Todo>): Promise<void>;\n}\n\n/** Super-small/dumb wrapper around maybe-Knex/maybe-postgres.js/maybe-Bun-sql libraries. */\ntype QueryRunner = (sql: string) => Promise<any[]>;\n\n/**\n * Assigns all new entities an id directly from their corresponding sequence generator, instead of via INSERTs.\n *\n * This lets us avoid cyclic issues with some INSERTs having foreign keys to other rows that themselves\n * need to first be INSERTed.\n */\nexport class SequenceIdAssigner implements IdAssigner {\n  #runner: QueryRunner;\n\n  public constructor(runner: QueryRunner) {\n    this.#runner = runner;\n  }\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    const seqStatements: string[] = [];\n    Object.values(todos).forEach((todo) => {\n      // Even if we have INSERTs, the user may have already assigned ids...\n      const needsIds = todo.inserts.filter((e) => e.idMaybe === undefined);\n      if (needsIds.length > 0) {\n        const sequenceName = `${todo.metadata.tableName}_id_seq`;\n        const sql = `select nextval('${sequenceName}') from generate_series(1, ${needsIds.length})`;\n        seqStatements.push(sql);\n      }\n    });\n    if (seqStatements.length > 0) {\n      // There will be 1 per table; 1 single insert should be fine but we might need to batch for super-large schemas?\n      const sql = seqStatements.join(\" UNION ALL \");\n      const result = await this.#runner(sql);\n      let i = 0;\n      Object.values(todos).forEach((todo) => {\n        for (const insert of todo.inserts.filter((e) => e.idMaybe === undefined)) {\n          // Use todo.metadata so that all subtypes get their base type's tag\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, result[i++][\"nextval\"]);\n        }\n      });\n    }\n  }\n}\n\n/**\n * Creates random UUIDs for uuid-based keys in production environments.\n *\n * See {@link TestUuidAssigner} for creating stable-ish ids for tests\n */\nexport class RandomUuidAssigner implements IdAssigner {\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.values(todos).forEach((todo) => {\n      for (const insert of todo.inserts) {\n        getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, crypto.randomUUID());\n      }\n    });\n  }\n}\n\n/**\n * Creates deterministic / stable-ish UUIDs for test suites.\n *\n * We use each entity's tag as the 3rd group of digits, and a per-entity incrementing integer as\n * the 4th group of digits.\n *\n * E.g. a test with two Authors (tag `a`) and three Books (tag `b`) will get these ids:\n *\n * ```\n * 00000000-0000-0000-000a-000000000000\n * 00000000-0000-0000-000a-000000000001\n * 00000000-0000-0000-000b-000000000000\n * 00000000-0000-0000-000b-000000000001\n * 00000000-0000-0000-000b-000000000002\n * ```\n */\nexport class TestUuidAssigner implements IdAssigner {\n  private nextId: Record<string, number> = {};\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.entries(todos).forEach(([, todo]) => {\n      if (todo.inserts.length > 0) {\n        const tag = todo.metadata.tagName.substring(0, 4).padStart(4, \"0\");\n        this.nextId[tag] ??= 0;\n        for (const insert of todo.inserts) {\n          const id = String(this.nextId[tag]++);\n          const uuid = `00000000-0000-0000-${tag}-${id.padStart(12, \"0\")}`;\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, uuid);\n        }\n      }\n    });\n  }\n\n  reset() {\n    this.nextId = {};\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,IAAa,qBAAb,MAAsD;CACpD;CAEA,YAAmB,QAAqB;EACtC,KAAKA,UAAU;CACjB;CAEA,MAAM,aAAa,OAA4C;EAC7D,MAAM,gBAA0B,CAAC;EACjC,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GAErC,MAAM,WAAW,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS;GACnE,IAAI,SAAS,SAAS,GAAG;IAEvB,MAAM,MAAM,mBAAmB,GADP,KAAK,SAAS,UAAU,SACJ,6BAA6B,SAAS,OAAO;IACzF,cAAc,KAAK,GAAG;GACxB;EACF,CAAC;EACD,IAAI,cAAc,SAAS,GAAG;GAE5B,MAAM,MAAM,cAAc,KAAK,aAAa;GAC5C,MAAM,SAAS,MAAM,KAAKA,QAAQ,GAAG;GACrC,IAAI,IAAI;GACR,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;IACrC,KAAK,MAAM,UAAU,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS,GAErE,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQC,aAAAA,cAAc,KAAK,UAAU,OAAO,IAAI,CAAC,UAAU;GAE5F,CAAC;EACH;CACF;AACF;;;;;;AAOA,IAAa,qBAAb,MAAsD;CACpD,MAAM,aAAa,OAA4C;EAC7D,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GACrC,KAAK,MAAM,UAAU,KAAK,SACxB,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQA,aAAAA,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC;EAEzF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;AAkBA,IAAa,mBAAb,MAAoD;CAClD,SAAyC,CAAC;CAE1C,MAAM,aAAa,OAA4C;EAC7D,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU;GAC1C,IAAI,KAAK,QAAQ,SAAS,GAAG;IAC3B,MAAM,MAAM,KAAK,SAAS,QAAQ,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;IACjE,KAAK,OAAO,SAAS;IACrB,KAAK,MAAM,UAAU,KAAK,SAAS;KAEjC,MAAM,OAAO,sBAAsB,IAAI,GAD5B,OAAO,KAAK,OAAO,IAAI,EACS,CAAC,CAAC,SAAS,IAAI,GAAG;KAC7D,mBAAA,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQA,aAAAA,cAAc,KAAK,UAAU,IAAI;IACxE;GACF;EACF,CAAC;CACH;CAEA,QAAQ;EACN,KAAK,SAAS,CAAC;CACjB;AACF"}

package/build/drivers/IdAssigner.d.cts

@@ -1,4 +1,4 @@
-import { Todo } from "../Todo.cjs";
+import { Todo } from "../flush/Todo.cjs";
 //#region src/drivers/IdAssigner.d.ts
 interface IdAssigner {
   assignNewIds(todos: Record<string, Todo>): Promise<void>;

package/build/drivers/IdAssigner.d.mts

@@ -1,4 +1,4 @@
-import { Todo } from "../Todo.mjs";
+import { Todo } from "../flush/Todo.mjs";
 //#region src/drivers/IdAssigner.d.ts
 interface IdAssigner {
   assignNewIds(todos: Record<string, Todo>): Promise<void>;

package/build/drivers/IdAssigner.js

@@ -1,4 +1,3 @@
-import "../Todo.js";
 import { keyToTaggedId } from "../keys.js";
 import { getInstanceData } from "../BaseEntity.js";
 import * as crypto from "crypto";

package/build/drivers/IdAssigner.js.map

@@ -1 +1 @@
-{"version":3,"file":"IdAssigner.js","names":["#runner"],"sources":["../../src/drivers/IdAssigner.ts"],"sourcesContent":["import * as crypto from \"crypto\";\n\nimport { getInstanceData } from \"../BaseEntity.ts\";\nimport { keyToTaggedId } from \"../keys.ts\";\nimport { type Todo } from \"../Todo.ts\";\n\nexport interface IdAssigner {\n  assignNewIds(todos: Record<string, Todo>): Promise<void>;\n}\n\n/** Super-small/dumb wrapper around maybe-Knex/maybe-postgres.js/maybe-Bun-sql libraries. */\ntype QueryRunner = (sql: string) => Promise<any[]>;\n\n/**\n * Assigns all new entities an id directly from their corresponding sequence generator, instead of via INSERTs.\n *\n * This lets us avoid cyclic issues with some INSERTs having foreign keys to other rows that themselves\n * need to first be INSERTed.\n */\nexport class SequenceIdAssigner implements IdAssigner {\n  #runner: QueryRunner;\n\n  public constructor(runner: QueryRunner) {\n    this.#runner = runner;\n  }\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    const seqStatements: string[] = [];\n    Object.values(todos).forEach((todo) => {\n      // Even if we have INSERTs, the user may have already assigned ids...\n      const needsIds = todo.inserts.filter((e) => e.idMaybe === undefined);\n      if (needsIds.length > 0) {\n        const sequenceName = `${todo.metadata.tableName}_id_seq`;\n        const sql = `select nextval('${sequenceName}') from generate_series(1, ${needsIds.length})`;\n        seqStatements.push(sql);\n      }\n    });\n    if (seqStatements.length > 0) {\n      // There will be 1 per table; 1 single insert should be fine but we might need to batch for super-large schemas?\n      const sql = seqStatements.join(\" UNION ALL \");\n      const result = await this.#runner(sql);\n      let i = 0;\n      Object.values(todos).forEach((todo) => {\n        for (const insert of todo.inserts.filter((e) => e.idMaybe === undefined)) {\n          // Use todo.metadata so that all subtypes get their base type's tag\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, result[i++][\"nextval\"]);\n        }\n      });\n    }\n  }\n}\n\n/**\n * Creates random UUIDs for uuid-based keys in production environments.\n *\n * See {@link TestUuidAssigner} for creating stable-ish ids for tests\n */\nexport class RandomUuidAssigner implements IdAssigner {\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.values(todos).forEach((todo) => {\n      for (const insert of todo.inserts) {\n        getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, crypto.randomUUID());\n      }\n    });\n  }\n}\n\n/**\n * Creates deterministic / stable-ish UUIDs for test suites.\n *\n * We use each entity's tag as the 3rd group of digits, and a per-entity incrementing integer as\n * the 4th group of digits.\n *\n * E.g. a test with two Authors (tag `a`) and three Books (tag `b`) will get these ids:\n *\n * ```\n * 00000000-0000-0000-000a-000000000000\n * 00000000-0000-0000-000a-000000000001\n * 00000000-0000-0000-000b-000000000000\n * 00000000-0000-0000-000b-000000000001\n * 00000000-0000-0000-000b-000000000002\n * ```\n */\nexport class TestUuidAssigner implements IdAssigner {\n  private nextId: Record<string, number> = {};\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.entries(todos).forEach(([, todo]) => {\n      if (todo.inserts.length > 0) {\n        const tag = todo.metadata.tagName.substring(0, 4).padStart(4, \"0\");\n        this.nextId[tag] ??= 0;\n        for (const insert of todo.inserts) {\n          const id = String(this.nextId[tag]++);\n          const uuid = `00000000-0000-0000-${tag}-${id.padStart(12, \"0\")}`;\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, uuid);\n        }\n      }\n    });\n  }\n\n  reset() {\n    this.nextId = {};\n  }\n}\n"],"mappings":";;;;;;;;;;;AAmBA,IAAa,qBAAb,MAAsD;CACpD;CAEA,YAAmB,QAAqB;EACtC,KAAKA,UAAU;CACjB;CAEA,MAAM,aAAa,OAA4C;EAC7D,MAAM,gBAA0B,CAAC;EACjC,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GAErC,MAAM,WAAW,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS;GACnE,IAAI,SAAS,SAAS,GAAG;IAEvB,MAAM,MAAM,mBAAmB,GADP,KAAK,SAAS,UAAU,SACJ,6BAA6B,SAAS,OAAO;IACzF,cAAc,KAAK,GAAG;GACxB;EACF,CAAC;EACD,IAAI,cAAc,SAAS,GAAG;GAE5B,MAAM,MAAM,cAAc,KAAK,aAAa;GAC5C,MAAM,SAAS,MAAM,KAAKA,QAAQ,GAAG;GACrC,IAAI,IAAI;GACR,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;IACrC,KAAK,MAAM,UAAU,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS,GAErE,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,OAAO,IAAI,CAAC,UAAU;GAE5F,CAAC;EACH;CACF;AACF;;;;;;AAOA,IAAa,qBAAb,MAAsD;CACpD,MAAM,aAAa,OAA4C;EAC7D,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GACrC,KAAK,MAAM,UAAU,KAAK,SACxB,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC;EAEzF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;AAkBA,IAAa,mBAAb,MAAoD;CAClD,SAAyC,CAAC;CAE1C,MAAM,aAAa,OAA4C;EAC7D,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU;GAC1C,IAAI,KAAK,QAAQ,SAAS,GAAG;IAC3B,MAAM,MAAM,KAAK,SAAS,QAAQ,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;IACjE,KAAK,OAAO,SAAS;IACrB,KAAK,MAAM,UAAU,KAAK,SAAS;KAEjC,MAAM,OAAO,sBAAsB,IAAI,GAD5B,OAAO,KAAK,OAAO,IAAI,EACS,CAAC,CAAC,SAAS,IAAI,GAAG;KAC7D,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,IAAI;IACxE;GACF;EACF,CAAC;CACH;CAEA,QAAQ;EACN,KAAK,SAAS,CAAC;CACjB;AACF"}
+{"version":3,"file":"IdAssigner.js","names":["#runner"],"sources":["../../src/drivers/IdAssigner.ts"],"sourcesContent":["import * as crypto from \"crypto\";\n\nimport { getInstanceData } from \"src/BaseEntity.ts\";\nimport type { Todo } from \"src/flush/Todo.ts\";\nimport { keyToTaggedId } from \"src/keys.ts\";\n\nexport interface IdAssigner {\n  assignNewIds(todos: Record<string, Todo>): Promise<void>;\n}\n\n/** Super-small/dumb wrapper around maybe-Knex/maybe-postgres.js/maybe-Bun-sql libraries. */\ntype QueryRunner = (sql: string) => Promise<any[]>;\n\n/**\n * Assigns all new entities an id directly from their corresponding sequence generator, instead of via INSERTs.\n *\n * This lets us avoid cyclic issues with some INSERTs having foreign keys to other rows that themselves\n * need to first be INSERTed.\n */\nexport class SequenceIdAssigner implements IdAssigner {\n  #runner: QueryRunner;\n\n  public constructor(runner: QueryRunner) {\n    this.#runner = runner;\n  }\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    const seqStatements: string[] = [];\n    Object.values(todos).forEach((todo) => {\n      // Even if we have INSERTs, the user may have already assigned ids...\n      const needsIds = todo.inserts.filter((e) => e.idMaybe === undefined);\n      if (needsIds.length > 0) {\n        const sequenceName = `${todo.metadata.tableName}_id_seq`;\n        const sql = `select nextval('${sequenceName}') from generate_series(1, ${needsIds.length})`;\n        seqStatements.push(sql);\n      }\n    });\n    if (seqStatements.length > 0) {\n      // There will be 1 per table; 1 single insert should be fine but we might need to batch for super-large schemas?\n      const sql = seqStatements.join(\" UNION ALL \");\n      const result = await this.#runner(sql);\n      let i = 0;\n      Object.values(todos).forEach((todo) => {\n        for (const insert of todo.inserts.filter((e) => e.idMaybe === undefined)) {\n          // Use todo.metadata so that all subtypes get their base type's tag\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, result[i++][\"nextval\"]);\n        }\n      });\n    }\n  }\n}\n\n/**\n * Creates random UUIDs for uuid-based keys in production environments.\n *\n * See {@link TestUuidAssigner} for creating stable-ish ids for tests\n */\nexport class RandomUuidAssigner implements IdAssigner {\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.values(todos).forEach((todo) => {\n      for (const insert of todo.inserts) {\n        getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, crypto.randomUUID());\n      }\n    });\n  }\n}\n\n/**\n * Creates deterministic / stable-ish UUIDs for test suites.\n *\n * We use each entity's tag as the 3rd group of digits, and a per-entity incrementing integer as\n * the 4th group of digits.\n *\n * E.g. a test with two Authors (tag `a`) and three Books (tag `b`) will get these ids:\n *\n * ```\n * 00000000-0000-0000-000a-000000000000\n * 00000000-0000-0000-000a-000000000001\n * 00000000-0000-0000-000b-000000000000\n * 00000000-0000-0000-000b-000000000001\n * 00000000-0000-0000-000b-000000000002\n * ```\n */\nexport class TestUuidAssigner implements IdAssigner {\n  private nextId: Record<string, number> = {};\n\n  async assignNewIds(todos: Record<string, Todo>): Promise<void> {\n    Object.entries(todos).forEach(([, todo]) => {\n      if (todo.inserts.length > 0) {\n        const tag = todo.metadata.tagName.substring(0, 4).padStart(4, \"0\");\n        this.nextId[tag] ??= 0;\n        for (const insert of todo.inserts) {\n          const id = String(this.nextId[tag]++);\n          const uuid = `00000000-0000-0000-${tag}-${id.padStart(12, \"0\")}`;\n          getInstanceData(insert).data[\"id\"] = keyToTaggedId(todo.metadata, uuid);\n        }\n      }\n    });\n  }\n\n  reset() {\n    this.nextId = {};\n  }\n}\n"],"mappings":";;;;;;;;;;AAmBA,IAAa,qBAAb,MAAsD;CACpD;CAEA,YAAmB,QAAqB;EACtC,KAAKA,UAAU;CACjB;CAEA,MAAM,aAAa,OAA4C;EAC7D,MAAM,gBAA0B,CAAC;EACjC,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GAErC,MAAM,WAAW,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS;GACnE,IAAI,SAAS,SAAS,GAAG;IAEvB,MAAM,MAAM,mBAAmB,GADP,KAAK,SAAS,UAAU,SACJ,6BAA6B,SAAS,OAAO;IACzF,cAAc,KAAK,GAAG;GACxB;EACF,CAAC;EACD,IAAI,cAAc,SAAS,GAAG;GAE5B,MAAM,MAAM,cAAc,KAAK,aAAa;GAC5C,MAAM,SAAS,MAAM,KAAKA,QAAQ,GAAG;GACrC,IAAI,IAAI;GACR,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;IACrC,KAAK,MAAM,UAAU,KAAK,QAAQ,QAAQ,MAAM,EAAE,YAAY,KAAA,CAAS,GAErE,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,OAAO,IAAI,CAAC,UAAU;GAE5F,CAAC;EACH;CACF;AACF;;;;;;AAOA,IAAa,qBAAb,MAAsD;CACpD,MAAM,aAAa,OAA4C;EAC7D,OAAO,OAAO,KAAK,CAAC,CAAC,SAAS,SAAS;GACrC,KAAK,MAAM,UAAU,KAAK,SACxB,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,OAAO,WAAW,CAAC;EAEzF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;AAkBA,IAAa,mBAAb,MAAoD;CAClD,SAAyC,CAAC;CAE1C,MAAM,aAAa,OAA4C;EAC7D,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU;GAC1C,IAAI,KAAK,QAAQ,SAAS,GAAG;IAC3B,MAAM,MAAM,KAAK,SAAS,QAAQ,UAAU,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG;IACjE,KAAK,OAAO,SAAS;IACrB,KAAK,MAAM,UAAU,KAAK,SAAS;KAEjC,MAAM,OAAO,sBAAsB,IAAI,GAD5B,OAAO,KAAK,OAAO,IAAI,EACS,CAAC,CAAC,SAAS,IAAI,GAAG;KAC7D,gBAAgB,MAAM,CAAC,CAAC,KAAK,QAAQ,cAAc,KAAK,UAAU,IAAI;IACxE;GACF;EACF,CAAC;CACH;CAEA,QAAQ;EACN,KAAK,SAAS,CAAC;CACjB;AACF"}

package/build/drivers/driverApi.cjs

@@ -0,0 +1,19 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_utils = require("../utils.cjs");
+const require_runtimeConfig = require("../runtimeConfig.cjs");
+const require_queries_find_buildFindQuery = require("../queries/find/buildFindQuery.cjs");
+const require_dataloaders_findDataLoader = require("../dataloaders/findDataLoader.cjs");
+const require_drivers_EntityWriter = require("./EntityWriter.cjs");
+//#region src/drivers/driverApi.ts
+const driverApi = {
+	buildValuesCte: require_dataloaders_findDataLoader.buildValuesCte,
+	generateOps: require_drivers_EntityWriter.generateOps,
+	buildCteSql: require_queries_find_buildFindQuery.buildCteSql,
+	getRuntimeConfig: require_runtimeConfig.getRuntimeConfig,
+	batched: require_utils.batched,
+	cleanSql: require_utils.cleanSql
+};
+//#endregion
+exports.driverApi = driverApi;
+
+//# sourceMappingURL=driverApi.cjs.map

package/build/drivers/driverApi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"driverApi.cjs","names":[],"sources":["../../src/drivers/driverApi.ts"],"sourcesContent":["import { buildValuesCte } from \"src/dataloaders/findDataLoader.ts\";\nimport { type DeleteOp, type InsertOp, type UpdateOp, generateOps } from \"src/drivers/EntityWriter.ts\";\nimport { buildCteSql } from \"src/queries/find/buildFindQuery.ts\";\nimport { getRuntimeConfig } from \"src/runtimeConfig.ts\";\nimport { batched, cleanSql } from \"src/utils.ts\";\n\nexport const driverApi = {\n  buildValuesCte,\n  generateOps,\n  buildCteSql,\n  getRuntimeConfig,\n  batched,\n  cleanSql,\n};\n\nexport type driverApi = {\n  DeleteOp: DeleteOp;\n  UpdateOp: UpdateOp;\n  InsertOp: InsertOp;\n};\n"],"mappings":";;;;;;;AAMA,MAAa,YAAY;CACvB,gBAAA,mCAAA;CACA,aAAA,6BAAA;CACA,aAAA,oCAAA;CACA,kBAAA,sBAAA;CACA,SAAA,cAAA;CACA,UAAA,cAAA;AACF"}

package/build/drivers/driverApi.d.cts

@@ -0,0 +1,22 @@
+import { batched, cleanSql } from "../utils.cjs";
+import { DeleteOp, InsertOp, UpdateOp, generateOps } from "./EntityWriter.cjs";
+import { buildCteSql } from "../queries/find/buildFindQuery.cjs";
+import { buildValuesCte } from "../dataloaders/findDataLoader.cjs";
+import { getRuntimeConfig } from "../runtimeConfig.cjs";
+//#region src/drivers/driverApi.d.ts
+declare const driverApi: {
+  buildValuesCte: typeof buildValuesCte;
+  generateOps: typeof generateOps;
+  buildCteSql: typeof buildCteSql;
+  getRuntimeConfig: typeof getRuntimeConfig;
+  batched: typeof batched;
+  cleanSql: typeof cleanSql;
+};
+type driverApi = {
+  DeleteOp: DeleteOp;
+  UpdateOp: UpdateOp;
+  InsertOp: InsertOp;
+};
+//#endregion
+export { driverApi };
+//# sourceMappingURL=driverApi.d.cts.map

package/build/drivers/driverApi.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driverApi.d.cts","names":[],"sources":["../../src/drivers/driverApi.ts"],"mappings":";;;;;;cAMa;;;;;;;;KASD;EACV,UAAU;EACV,UAAU;EACV,UAAU"}

package/build/drivers/driverApi.d.mts

@@ -0,0 +1,22 @@
+import { batched, cleanSql } from "../utils.mjs";
+import { DeleteOp, InsertOp, UpdateOp, generateOps } from "./EntityWriter.mjs";
+import { buildCteSql } from "../queries/find/buildFindQuery.mjs";
+import { buildValuesCte } from "../dataloaders/findDataLoader.mjs";
+import { getRuntimeConfig } from "../runtimeConfig.mjs";
+//#region src/drivers/driverApi.d.ts
+declare const driverApi: {
+  buildValuesCte: typeof buildValuesCte;
+  generateOps: typeof generateOps;
+  buildCteSql: typeof buildCteSql;
+  getRuntimeConfig: typeof getRuntimeConfig;
+  batched: typeof batched;
+  cleanSql: typeof cleanSql;
+};
+type driverApi = {
+  DeleteOp: DeleteOp;
+  UpdateOp: UpdateOp;
+  InsertOp: InsertOp;
+};
+//#endregion
+export { driverApi };
+//# sourceMappingURL=driverApi.d.mts.map

package/build/drivers/driverApi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driverApi.d.mts","names":[],"sources":["../../src/drivers/driverApi.ts"],"mappings":";;;;;;cAMa;;;;;;;;KASD;EACV,UAAU;EACV,UAAU;EACV,UAAU"}

package/build/drivers/driverApi.js

@@ -0,0 +1,18 @@
+import { batched, cleanSql } from "../utils.js";
+import { getRuntimeConfig } from "../runtimeConfig.js";
+import { buildCteSql } from "../queries/find/buildFindQuery.js";
+import { buildValuesCte } from "../dataloaders/findDataLoader.js";
+import { generateOps } from "./EntityWriter.js";
+//#region src/drivers/driverApi.ts
+const driverApi = {
+	buildValuesCte,
+	generateOps,
+	buildCteSql,
+	getRuntimeConfig,
+	batched,
+	cleanSql
+};
+//#endregion
+export { driverApi };
+
+//# sourceMappingURL=driverApi.js.map

package/build/drivers/driverApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driverApi.js","names":[],"sources":["../../src/drivers/driverApi.ts"],"sourcesContent":["import { buildValuesCte } from \"src/dataloaders/findDataLoader.ts\";\nimport { type DeleteOp, type InsertOp, type UpdateOp, generateOps } from \"src/drivers/EntityWriter.ts\";\nimport { buildCteSql } from \"src/queries/find/buildFindQuery.ts\";\nimport { getRuntimeConfig } from \"src/runtimeConfig.ts\";\nimport { batched, cleanSql } from \"src/utils.ts\";\n\nexport const driverApi = {\n  buildValuesCte,\n  generateOps,\n  buildCteSql,\n  getRuntimeConfig,\n  batched,\n  cleanSql,\n};\n\nexport type driverApi = {\n  DeleteOp: DeleteOp;\n  UpdateOp: UpdateOp;\n  InsertOp: InsertOp;\n};\n"],"mappings":";;;;;;AAMA,MAAa,YAAY;CACvB;CACA;CACA;CACA;CACA;CACA;AACF"}

package/build/fields.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_temporal = require("./temporal.cjs");
-const require_utils = require("./utils.cjs");
+const require_serde_temporal = require("./serde/temporal.cjs");
 const require_keys = require("./keys.cjs");
+const require_utils = require("./utils.cjs");
 const require_EntityMetadata = require("./EntityMetadata.cjs");
 const require_index = require("./index.cjs");
 const require_EntityManager = require("./EntityManager.cjs");
@@ -105,7 +105,7 @@ function equalArrays(a, b) {
 	if (a.length !== b.length) return false;
 	return a.every((_, i) => equal(a[i], b[i]));
 }
-const Temporal = require_temporal.maybeRequireTemporal()?.Temporal;
+const Temporal = require_serde_temporal.maybeRequireTemporal()?.Temporal;
 function equal(a, b) {
 	if (a === b) return true;
 	if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();

package/build/fields.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fields.cjs","names":["getEmInternalApi","getInstanceData","getMetadata","fail","cleanStringValue","isEntity","maybeResolveReferenceToId","maybeRequireTemporal"],"sources":["../src/fields.ts"],"sourcesContent":["import { getInstanceData } from \"./BaseEntity.ts\";\nimport { type Entity, isEntity } from \"./Entity.ts\";\nimport { getEmInternalApi } from \"./EntityManager.ts\";\nimport { type Field, getMetadata } from \"./EntityMetadata.ts\";\nimport { cleanStringValue, ensureNotDeleted, maybeResolveReferenceToId } from \"./index.ts\";\nimport { maybeRequireTemporal } from \"./temporal.ts\";\nimport { fail } from \"./utils.ts\";\n\n/**\n * Returns the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated getters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n */\nexport function getField(entity: Entity, fieldName: string): any {\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  api.pluginManager.beforeGetField(entity, fieldName);\n  // We may not have converted the database column value into domain values yet\n  const instanceData = getInstanceData(entity);\n  const { data } = instanceData;\n  if (fieldName in data) {\n    return data[fieldName];\n  } else {\n    if (!entity.isNewEntity) {\n      const field = getMetadata(entity).allFields[fieldName];\n      const serde = field?.serde ?? fail(`Missing serde for ${fieldName}`);\n      data[fieldName] = serde.fromRow(instanceData.rowData, instanceData.rowIndex);\n    }\n    return data[fieldName];\n  }\n}\n\n/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */\nexport function isChangeableField(entity: Entity, fieldName: string): boolean {\n  return !!getMetadata(entity).allFields[fieldName]?.serde;\n}\n\n/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */\nexport function isFieldSet(entity: Entity, fieldName: string): boolean {\n  const { data } = getInstanceData(entity);\n  if (fieldName in data) return true;\n  // Avoid calling `getField` on new entities because it populates the field as a side effect.\n  if (entity.isNewEntity) return false;\n  // We may not have converted the database column value into domain values yet.\n  getField(entity, fieldName);\n  return fieldName in data;\n}\n\n/**\n * Sets the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated setters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n *\n * Returns `true` if the value was changed, or `false` if it was a noop.\n */\nexport function setField(entity: Entity, fieldName: string, newValue: any): boolean {\n  ensureNotDeleted(entity, \"pending\");\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;\n\n  // If we're flushing, only allow writes from hooks\n  api.checkWritesAllowed();\n\n  // Tell any `#isLoaded` or `#value` caches that they might be stale\n  isLoadedCache.resetIsLoaded(entity, fieldName);\n\n  const instanceData = getInstanceData(entity);\n  const { data, originalData, flushedData } = instanceData;\n\n  // Do string sanitization\n  const field = getMetadata(entity).allFields[fieldName];\n  if (field.kind === \"primitive\" && field.type === \"string\" && field.sanitize !== false) {\n    newValue = cleanStringValue(newValue);\n  }\n\n  const currentValue = getField(entity, fieldName);\n  const isReference = field.kind === \"m2o\" || field.kind === \"poly\";\n  const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);\n  // Remember every prior reference value so `followReverseHint` can rewalk both original and transient owners.\n  if (isReference && !currentEqualsNew) {\n    instanceData.rememberReferenceValue(fieldName, currentValue);\n  }\n\n  // If a `set` occurs during the AsyncReactiveField-loop, copy the last-flushed value to flushedData.\n  // Then our `pendingOperation` logic can tell \"do we need another micro-flush?\" separately\n  // from our public-facing changed fields logic.\n  if (flushedData) {\n    if (fieldName in flushedData) {\n      // We've already copied the last-micro-flush value into flushedData,\n      // are we changing back to that? If so, we won't need another micro-flush.\n      if (equalOrSameEntity(flushedData[fieldName], newValue)) {\n        delete flushedData[fieldName];\n      } else {\n        // Otherwise just let data[fieldName] get the even-newer value, and keep\n        // flushedData[fieldName] as the last-micro-flushed value.\n      }\n    } else if (!currentEqualsNew) {\n      // This is the 1st rqf-loop change for this field, so let data[fieldName]\n      // get the even newer value, but keep the last-micro-flushed value in flushedData.\n      flushedData[fieldName] = currentValue;\n    }\n  }\n\n  // \"Un-dirty\" our originalData if newValue is reverting to originalData\n  if (fieldName in originalData) {\n    if (fieldValueEquals(field, originalData[fieldName], newValue)) {\n      indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n      pluginManager.beforeSetField(entity, fieldName, newValue);\n      data[fieldName] = newValue;\n      instanceData.markFieldClean(fieldName);\n\n      fieldLogger.logSet(entity, fieldName, newValue);\n      if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) {\n        rm.queueDownstreamReactables(entity, fieldName);\n      } else {\n        // For normal reverts, the field is clean again, so any pending downstream work can be removed.\n        rm.dequeueDownstreamReactables(entity, fieldName);\n      }\n\n      return true;\n    }\n  }\n\n  // Push this logic into a field serde type abstraction?\n  if (currentEqualsNew) {\n    // If we're doing `entity.field = undefined`, we'll be equal, but mark ourselves as \"set\"\n    // so that defaults know to respect the intent of keeping this field undefined.\n    if (!(fieldName in data)) data[fieldName] = undefined;\n    return false;\n  }\n\n  // Only save the currentValue on the 1st change of this field\n  if (!(fieldName in originalData)) {\n    instanceData.markFieldDirty(fieldName, currentValue);\n  }\n  fieldLogger.logSet(entity, fieldName, newValue);\n  rm.queueDownstreamReactables(entity, fieldName);\n\n  indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n  pluginManager.beforeSetField(entity, fieldName, newValue);\n  data[fieldName] = newValue;\n  return true;\n}\n\nfunction fieldValueEquals(field: Field, a: unknown, b: unknown): boolean {\n  // Primitive scalar sets are the common path, so avoid Date/Temporal/entity checks when both values cannot need them.\n  if (field.kind !== \"m2o\" && field.kind !== \"poly\" && isNonObjectValue(a) && isNonObjectValue(b)) return a === b;\n  return equalOrSameEntity(a, b);\n}\n\nfunction isNonObjectValue(value: unknown): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\nfunction equalOrSameEntity(a: any, b: any): boolean {\n  return (\n    equal(a, b) ||\n    (Array.isArray(a) && Array.isArray(b) && equalArrays(a, b)) ||\n    // This is kind of gross, but make sure not to compare two both-new entities\n    (((isEntity(a) && !a.isNewEntity) || (isEntity(b) && !b.isNewEntity)) &&\n      maybeResolveReferenceToId(a) === maybeResolveReferenceToId(b))\n  );\n}\n\nexport function equalArrays(a: any[], b: any[]): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((_: any, i) => equal(a[i], b[i]));\n}\n\nconst Temporal = maybeRequireTemporal()?.Temporal;\nexport function equal(a: any, b: any): boolean {\n  if (a === b) return true;\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();\n  if (Temporal) {\n    if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate) return a.equals(b);\n  }\n  return false;\n}\n"],"mappings":"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"}
+{"version":3,"file":"fields.cjs","names":["getEmInternalApi","getInstanceData","getMetadata","fail","cleanStringValue","isEntity","maybeResolveReferenceToId","maybeRequireTemporal"],"sources":["../src/fields.ts"],"sourcesContent":["import { getInstanceData } from \"src/BaseEntity.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { type Field, getMetadata } from \"src/EntityMetadata.ts\";\nimport { cleanStringValue, ensureNotDeleted, maybeResolveReferenceToId } from \"src/index.ts\";\nimport { maybeRequireTemporal } from \"src/serde/temporal.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/**\n * Returns the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated getters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n */\nexport function getField(entity: Entity, fieldName: string): any {\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  api.pluginManager.beforeGetField(entity, fieldName);\n  // We may not have converted the database column value into domain values yet\n  const instanceData = getInstanceData(entity);\n  const { data } = instanceData;\n  if (fieldName in data) {\n    return data[fieldName];\n  } else {\n    if (!entity.isNewEntity) {\n      const field = getMetadata(entity).allFields[fieldName];\n      const serde = field?.serde ?? fail(`Missing serde for ${fieldName}`);\n      data[fieldName] = serde.fromRow(instanceData.rowData, instanceData.rowIndex);\n    }\n    return data[fieldName];\n  }\n}\n\n/** Returns whether `fieldName` is a field/column on `entity` that can be changed. */\nexport function isChangeableField(entity: Entity, fieldName: string): boolean {\n  return !!getMetadata(entity).allFields[fieldName]?.serde;\n}\n\n/** Returns whether `fieldName` has been set, even if it's undefined, on `entity`. */\nexport function isFieldSet(entity: Entity, fieldName: string): boolean {\n  const { data } = getInstanceData(entity);\n  if (fieldName in data) return true;\n  // Avoid calling `getField` on new entities because it populates the field as a side effect.\n  if (entity.isNewEntity) return false;\n  // We may not have converted the database column value into domain values yet.\n  getField(entity, fieldName);\n  return fieldName in data;\n}\n\n/**\n * Sets the current value of `fieldName`, this is an internal method that should\n * only be called by the code-generated setters.\n *\n * We skip any typing like `fieldName: keyof T` because this method should only be\n * called by trusted codegen anyway.\n *\n * Returns `true` if the value was changed, or `false` if it was a noop.\n */\nexport function setField(entity: Entity, fieldName: string, newValue: any): boolean {\n  ensureNotDeleted(entity, \"pending\");\n  const { em } = entity;\n  const api = getEmInternalApi(em);\n  const { rm, pluginManager, indexManager, fieldLogger, isLoadedCache } = api;\n\n  // If we're flushing, only allow writes from hooks\n  api.checkWritesAllowed();\n\n  // Tell any `#isLoaded` or `#value` caches that they might be stale\n  isLoadedCache.resetIsLoaded(entity, fieldName);\n\n  const instanceData = getInstanceData(entity);\n  const { data, originalData, flushedData } = instanceData;\n\n  // Do string sanitization\n  const field = getMetadata(entity).allFields[fieldName];\n  if (field.kind === \"primitive\" && field.type === \"string\" && field.sanitize !== false) {\n    newValue = cleanStringValue(newValue);\n  }\n\n  const currentValue = getField(entity, fieldName);\n  const isReference = field.kind === \"m2o\" || field.kind === \"poly\";\n  const currentEqualsNew = fieldValueEquals(field, currentValue, newValue);\n  // Remember every prior reference value so `followReverseHint` can rewalk both original and transient owners.\n  if (isReference && !currentEqualsNew) {\n    instanceData.rememberReferenceValue(fieldName, currentValue);\n  }\n\n  // If a `set` occurs during the AsyncReactiveField-loop, copy the last-flushed value to flushedData.\n  // Then our `pendingOperation` logic can tell \"do we need another micro-flush?\" separately\n  // from our public-facing changed fields logic.\n  if (flushedData) {\n    if (fieldName in flushedData) {\n      // We've already copied the last-micro-flush value into flushedData,\n      // are we changing back to that? If so, we won't need another micro-flush.\n      if (equalOrSameEntity(flushedData[fieldName], newValue)) {\n        delete flushedData[fieldName];\n      } else {\n        // Otherwise just let data[fieldName] get the even-newer value, and keep\n        // flushedData[fieldName] as the last-micro-flushed value.\n      }\n    } else if (!currentEqualsNew) {\n      // This is the 1st rqf-loop change for this field, so let data[fieldName]\n      // get the even newer value, but keep the last-micro-flushed value in flushedData.\n      flushedData[fieldName] = currentValue;\n    }\n  }\n\n  // \"Un-dirty\" our originalData if newValue is reverting to originalData\n  if (fieldName in originalData) {\n    if (fieldValueEquals(field, originalData[fieldName], newValue)) {\n      indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n      pluginManager.beforeSetField(entity, fieldName, newValue);\n      data[fieldName] = newValue;\n      instanceData.markFieldClean(fieldName);\n\n      fieldLogger.logSet(entity, fieldName, newValue);\n      if (isReference && instanceData.getReferenceHistory(fieldName).length > 0) {\n        rm.queueDownstreamReactables(entity, fieldName);\n      } else {\n        // For normal reverts, the field is clean again, so any pending downstream work can be removed.\n        rm.dequeueDownstreamReactables(entity, fieldName);\n      }\n\n      return true;\n    }\n  }\n\n  // Push this logic into a field serde type abstraction?\n  if (currentEqualsNew) {\n    // If we're doing `entity.field = undefined`, we'll be equal, but mark ourselves as \"set\"\n    // so that defaults know to respect the intent of keeping this field undefined.\n    if (!(fieldName in data)) data[fieldName] = undefined;\n    return false;\n  }\n\n  // Only save the currentValue on the 1st change of this field\n  if (!(fieldName in originalData)) {\n    instanceData.markFieldDirty(fieldName, currentValue);\n  }\n  fieldLogger.logSet(entity, fieldName, newValue);\n  rm.queueDownstreamReactables(entity, fieldName);\n\n  indexManager.maybeUpdateFieldIndex(entity, fieldName, currentValue, newValue);\n\n  pluginManager.beforeSetField(entity, fieldName, newValue);\n  data[fieldName] = newValue;\n  return true;\n}\n\nfunction fieldValueEquals(field: Field, a: unknown, b: unknown): boolean {\n  // Primitive scalar sets are the common path, so avoid Date/Temporal/entity checks when both values cannot need them.\n  if (field.kind !== \"m2o\" && field.kind !== \"poly\" && isNonObjectValue(a) && isNonObjectValue(b)) return a === b;\n  return equalOrSameEntity(a, b);\n}\n\nfunction isNonObjectValue(value: unknown): boolean {\n  return value === null || typeof value !== \"object\";\n}\n\nfunction equalOrSameEntity(a: any, b: any): boolean {\n  return (\n    equal(a, b) ||\n    (Array.isArray(a) && Array.isArray(b) && equalArrays(a, b)) ||\n    // This is kind of gross, but make sure not to compare two both-new entities\n    (((isEntity(a) && !a.isNewEntity) || (isEntity(b) && !b.isNewEntity)) &&\n      maybeResolveReferenceToId(a) === maybeResolveReferenceToId(b))\n  );\n}\n\nexport function equalArrays(a: any[], b: any[]): boolean {\n  if (a.length !== b.length) return false;\n  return a.every((_: any, i) => equal(a[i], b[i]));\n}\n\nconst Temporal = maybeRequireTemporal()?.Temporal;\nexport function equal(a: any, b: any): boolean {\n  if (a === b) return true;\n  if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime();\n  if (Temporal) {\n    if (a instanceof Temporal.ZonedDateTime && b instanceof Temporal.ZonedDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDateTime && b instanceof Temporal.PlainDateTime) return a.equals(b);\n    if (a instanceof Temporal.PlainDate && b instanceof Temporal.PlainDate) return a.equals(b);\n  }\n  return false;\n}\n"],"mappings":"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"}

package/build/fields.js

@@ -1,6 +1,6 @@
-import { maybeRequireTemporal } from "./temporal.js";
-import { cleanStringValue, fail } from "./utils.js";
+import { maybeRequireTemporal } from "./serde/temporal.js";
 import { maybeResolveReferenceToId } from "./keys.js";
+import { cleanStringValue, fail } from "./utils.js";
 import { getMetadata } from "./EntityMetadata.js";
 import { ensureNotDeleted } from "./index.js";
 import { getEmInternalApi } from "./EntityManager.js";