@warlock.js/cascade 5.24.0 → 5.25.0

package/esm/model/methods/query-methods.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"query-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/query-methods.ts"],"sourcesContent":["import type {\n  AtomicUpdate,\n  AtomicUpdateOptions,\n  FindOneAndUpdateOptions,\n  PaginationOptions,\n  PaginationResult,\n  QueryBuilderContract,\n} from \"../../contracts\";\nimport type { DataSource } from \"../../data-source/data-source\";\nimport { dataSourceRegistry } from \"../../data-source/data-source-registry\";\nimport { sanitizeFilter } from \"../../utils/sanitize-filter\";\nimport type { ChildModel, GlobalScopeDefinition, Model } from \"../model\";\nimport { emitStaticEvent } from \"./static-event-methods\";\nimport { warnUndeclaredSensitiveFields } from \"./serialization-methods\";\n\nexport function buildQuery<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  BaseModel: typeof Model,\n): QueryBuilderContract<TModel> {\n  const queryBuilder = ModelClass.newQueryBuilder<TModel>();\n  const qb = queryBuilder;\n\n  // Collect global scopes from base Model and child model\n  const allGlobalScopes = new Map<string, GlobalScopeDefinition>([\n    ...BaseModel.globalScopes,\n    ...ModelClass.globalScopes,\n  ]);\n\n  queryBuilder.pendingGlobalScopes = allGlobalScopes;\n  queryBuilder.availableLocalScopes = ModelClass.localScopes;\n  queryBuilder.disabledGlobalScopes = new Set();\n  queryBuilder.relationDefinitions = ModelClass.relations;\n  queryBuilder.modelClass = ModelClass;\n\n  let fetchStartedAt = Date.now();\n\n  // Emitted from the builder's execute path (awaited), not at construction, so\n  // listener changes apply before the query runs and a throwing listener fails\n  // the query instead of becoming an unhandled rejection.\n  queryBuilder.onFetching(async () => {\n    fetchStartedAt = Date.now();\n\n    await emitStaticEvent(ModelClass, \"fetching\", queryBuilder, {\n      table: ModelClass.table,\n      modelClass: ModelClass,\n    });\n  });\n\n  queryBuilder.onHydrating(async (records: any[], context: any) => {\n    await emitStaticEvent(ModelClass, \"hydrating\", records as any, {\n      query: queryBuilder,\n      hydrateCallback: context?.hydrateCallback,\n    });\n  });\n\n  queryBuilder.hydrate((data: any) => {\n    return ModelClass.hydrate(data);\n  });\n\n  // Eager-loading runs inside the driver's `get()` so it works for any\n  // builder construction path (Model.query, Model.newQueryBuilder, custom\n  // subclassed builders). This hook only handles the model-level `fetched`\n  // event emission.\n  queryBuilder.onFetched(async (models: any[], context: any) => {\n    await emitStaticEvent(ModelClass, \"fetched\", models as any, {\n      query: queryBuilder,\n      rawRecords: context?.rawRecords ?? [],\n      duration: context?.duration ?? Date.now() - fetchStartedAt,\n    });\n  });\n\n  return queryBuilder;\n}\n\nexport function buildNewQueryBuilder<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n): QueryBuilderContract<TModel> {\n  const dataSource = ModelClass.getDataSource();\n\n  if (ModelClass.builder) {\n    const BuilderClass = ModelClass.builder;\n    return new BuilderClass(ModelClass.table, dataSource) as QueryBuilderContract<TModel>;\n  }\n\n  const queryBuilder = dataSource.driver.queryBuilder<TModel>(ModelClass.table);\n  return queryBuilder;\n}\n\nexport async function findFirst<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.first();\n}\n\nexport async function findLast<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n\n  return query.last();\n}\n\nexport async function findAll<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel[]> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.get();\n}\n\nexport function countRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<number> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.count();\n}\n\nexport async function findById<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  id: string | number,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  return query.where(ModelClass.primaryKey, id).first();\n}\n\nexport async function paginateRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  options: PaginationOptions & { filter?: Record<string, unknown> } = {},\n): Promise<PaginationResult<TModel>> {\n  const query = ModelClass.query();\n  if (options.filter) {\n    query.where(options.filter);\n  }\n\n  return query.paginate({\n    limit: options.limit,\n    page: options.page,\n  });\n}\n\nexport async function findLatest<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel[]> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return (await query.latest()) as unknown as TModel[];\n}\n\nexport function increaseField<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  field: string,\n  amount: number,\n): Promise<number> {\n  const query = ModelClass.query().where(filter);\n  return query.increment(field, amount);\n}\n\nexport function decreaseField<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  field: string,\n  amount: number,\n): Promise<number> {\n  const query = ModelClass.query().where(filter);\n  return query.decrement(field, amount);\n}\n\n// The atomic/find-and-modify statics below forward their filter straight to\n// the driver — they never pass through where(), so they must run the same\n// operator-injection check themselves. Only the FILTER is sanitized; update\n// operators ($set/$inc/…) are the point of these APIs and stay untouched.\n//\n// `trustedFilter` is the explicit, code-authored opt-out: it lets a conditional\n// filter such as `{ used: { $lt: 10 } }` through. It is stripped before the\n// options reach the driver.\nfunction resolveFilter(\n  filter: Record<string, unknown>,\n  options: AtomicUpdateOptions | undefined,\n): Record<string, unknown> {\n  return options?.trustedFilter ? filter : sanitizeFilter(filter);\n}\n\nfunction toDriverOptions<TOptions extends AtomicUpdateOptions>(\n  options: TOptions | undefined,\n): Omit<TOptions, \"trustedFilter\"> | undefined {\n  if (!options) {\n    return undefined;\n  }\n\n  const { trustedFilter: _trustedFilter, ...rest } = options;\n\n  return rest;\n}\n\n/**\n * Pin a driver-level write to the rows the model's global scopes (tenant, soft\n * delete) allow. The driver write APIs take a raw filter and never see scopes,\n * so the target ids are resolved through the scoped query builder and added to\n * the filter. `null` means no visible row matches: the write must be a no-op.\n */\nexport async function scopeWriteFilter(\n  ModelClass: ChildModel<any>,\n  filter: Record<string, unknown>,\n  single: boolean,\n): Promise<Record<string, unknown> | null> {\n  const primaryKey = ModelClass.primaryKey;\n  const ids = await ModelClass.query().where(filter).pluck(primaryKey);\n\n  if (ids.length === 0) {\n    return null;\n  }\n\n  return { ...filter, [primaryKey]: single ? ids[0] : { $in: ids } };\n}\n\n/**\n * Scoped filter for a write that may insert (`upsert`). With no visible match\n * the driver would insert or, worse, update a row a scope hides (another\n * tenant's, a soft-deleted one), so a hidden match is refused.\n */\nexport async function scopeUpsertFilter(\n  ModelClass: ChildModel<any>,\n  filter: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n  const scoped = await scopeWriteFilter(ModelClass, filter, true);\n\n  if (scoped) {\n    return scoped;\n  }\n\n  const hidden = await ModelClass.query().withoutGlobalScopes().where(filter).exists();\n\n  if (hidden) {\n    throw new Error(\n      `${ModelClass.name}: upsert matches a row hidden by a global scope (tenant or soft delete); refusing to touch it.`,\n    );\n  }\n\n  return filter;\n}\n\n/**\n * Run an atomic update and return the number of documents modified plus the\n * number inserted by an `upsert`.\n */\nexport async function performAtomic<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  operations: AtomicUpdate,\n  options?: AtomicUpdateOptions,\n): Promise<number> {\n  const resolved = resolveFilter(filter, options);\n  const scoped = options?.upsert\n    ? await scopeUpsertFilter(ModelClass, resolved)\n    : await scopeWriteFilter(ModelClass, resolved, false);\n\n  if (!scoped) {\n    return 0;\n  }\n\n  const result = await ModelClass.getDriver().atomic(\n    ModelClass.table,\n    scoped,\n    operations,\n    toDriverOptions(options),\n  );\n\n  return result.modifiedCount + (result.upsertedCount ?? 0);\n}\n\n/**\n * Update a row by id through the model writer: the row is loaded (scopes\n * apply), merged, and saved, so the schema, strictMode, casting, `updatedAt`\n * and events all apply. Returns 1 when a row was saved, 0 when none is visible.\n */\nexport async function updateById<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  id: string | number,\n  data: Record<string, unknown>,\n): Promise<number> {\n  const model = await ModelClass.query().where(ModelClass.primaryKey, id).first();\n\n  if (!model) {\n    return 0;\n  }\n\n  model.merge(data);\n  await model.save();\n\n  return 1;\n}\n\nexport async function findAndUpdateRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  update: AtomicUpdate,\n  options?: Omit<AtomicUpdateOptions, \"trustedFilter\">,\n): Promise<TModel[]> {\n  const primaryKey = ModelClass.primaryKey;\n  const safeFilter = sanitizeFilter(filter);\n\n  // Capture the matching ids first: the update usually changes the very field\n  // the filter matches on, so re-querying with the filter would find nothing.\n  const ids = await ModelClass.query().where(safeFilter).pluck(primaryKey);\n\n  if (ids.length === 0) {\n    if (!options?.upsert) {\n      return [];\n    }\n\n    await performAtomic(ModelClass, safeFilter, update, { ...options, trustedFilter: true });\n    return await ModelClass.query().where(safeFilter).get();\n  }\n\n  await performAtomic(\n    ModelClass,\n    { [primaryKey]: { $in: ids } },\n    update,\n    { ...options, trustedFilter: true },\n  );\n\n  return await ModelClass.query().whereIn(primaryKey, ids).get();\n}\n\nexport async function findOneAndUpdateRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  update: AtomicUpdate,\n  options?: FindOneAndUpdateOptions,\n): Promise<TModel | null> {\n  const resolved = resolveFilter(filter, options);\n  const scoped = options?.upsert\n    ? await scopeUpsertFilter(ModelClass, resolved)\n    : await scopeWriteFilter(ModelClass, resolved, true);\n\n  if (!scoped) return null;\n\n  const result = await ModelClass.getDriver().findOneAndUpdate(\n    ModelClass.table,\n    scoped,\n    update,\n    toDriverOptions(options),\n  );\n  if (!result) return null;\n  return ModelClass.hydrate(result as Record<string, unknown>) as TModel;\n}\n\nexport async function findAndReplaceRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  document: Record<string, unknown>,\n): Promise<TModel | null> {\n  const scoped = await scopeWriteFilter(ModelClass, sanitizeFilter(filter), true);\n\n  if (!scoped) return null;\n\n  const result = await ModelClass.getDriver().replace(ModelClass.table, scoped, document);\n  if (!result) return null;\n  return ModelClass.hydrate(result as Record<string, unknown>) as TModel;\n}\n\nexport async function findOneAndDeleteRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  options?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const scoped = await scopeWriteFilter(ModelClass, sanitizeFilter(filter), true);\n\n  if (!scoped) {\n    return null;\n  }\n\n  const result = await ModelClass.getDriver().findOneAndDelete(ModelClass.table, scoped, options);\n\n  if (!result) {\n    return null;\n  }\n\n  const model = ModelClass.hydrate(result as Record<string, unknown>);\n  model.dirtyTracker.reset();\n  return model;\n}\n\nexport function resolveDataSource<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n): DataSource {\n  const ref = ModelClass.dataSource;\n  let dataSource: DataSource;\n\n  if (typeof ref === \"string\") {\n    dataSource = dataSourceRegistry.get(ref);\n  } else if (ref) {\n    dataSource = ref;\n  } else {\n    dataSource = dataSourceRegistry.get();\n  }\n\n  if (!ModelClass.hasOwnProperty(\"_defaultsApplied\")) {\n    const driverDefaults = dataSource.driver.modelDefaults || {};\n    const dataSourceDefaults = dataSource.modelDefaults || {};\n\n    const mergedDefaults = {\n      ...driverDefaults,\n      ...dataSourceDefaults,\n    };\n\n    if (Object.keys(mergedDefaults).length > 0) {\n      (ModelClass as any).applyModelDefaults(mergedDefaults);\n    }\n\n    (ModelClass as any)._defaultsApplied = true;\n  }\n\n  // First data-source resolution is the earliest per-class hook every model\n  // passes through — warn here (once) if the schema carries credential-shaped\n  // fields that toJSON() would expose.\n  warnUndeclaredSensitiveFields(ModelClass);\n\n  return dataSource;\n}\n"],"mappings":"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"}
+{"version":3,"file":"query-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/query-methods.ts"],"sourcesContent":["import type {\n  AtomicUpdate,\n  AtomicUpdateOptions,\n  FindOneAndUpdateOptions,\n  PaginationOptions,\n  PaginationResult,\n  QueryBuilderContract,\n} from \"../../contracts\";\nimport type { DataSource } from \"../../data-source/data-source\";\nimport { dataSourceRegistry } from \"../../data-source/data-source-registry\";\nimport { sanitizeFilter } from \"../../utils/sanitize-filter\";\nimport { generateModelId } from \"../generate-model-id\";\nimport type { ChildModel, GlobalScopeDefinition, Model } from \"../model\";\nimport { emitStaticEvent } from \"./static-event-methods\";\nimport { warnUndeclaredSensitiveFields } from \"./serialization-methods\";\n\nexport function buildQuery<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  BaseModel: typeof Model,\n): QueryBuilderContract<TModel> {\n  const queryBuilder = ModelClass.newQueryBuilder<TModel>();\n  const qb = queryBuilder;\n\n  // Collect global scopes from base Model and child model\n  const allGlobalScopes = new Map<string, GlobalScopeDefinition>([\n    ...BaseModel.globalScopes,\n    ...ModelClass.globalScopes,\n  ]);\n\n  queryBuilder.pendingGlobalScopes = allGlobalScopes;\n  queryBuilder.availableLocalScopes = ModelClass.localScopes;\n  queryBuilder.disabledGlobalScopes = new Set();\n  queryBuilder.relationDefinitions = ModelClass.relations;\n  queryBuilder.modelClass = ModelClass;\n\n  let fetchStartedAt = Date.now();\n\n  // Emitted from the builder's execute path (awaited), not at construction, so\n  // listener changes apply before the query runs and a throwing listener fails\n  // the query instead of becoming an unhandled rejection.\n  queryBuilder.onFetching(async () => {\n    fetchStartedAt = Date.now();\n\n    await emitStaticEvent(ModelClass, \"fetching\", queryBuilder, {\n      table: ModelClass.table,\n      modelClass: ModelClass,\n    });\n  });\n\n  queryBuilder.onHydrating(async (records: any[], context: any) => {\n    await emitStaticEvent(ModelClass, \"hydrating\", records as any, {\n      query: queryBuilder,\n      hydrateCallback: context?.hydrateCallback,\n    });\n  });\n\n  queryBuilder.hydrate((data: any) => {\n    return ModelClass.hydrate(data);\n  });\n\n  // Eager-loading runs inside the driver's `get()` so it works for any\n  // builder construction path (Model.query, Model.newQueryBuilder, custom\n  // subclassed builders). This hook only handles the model-level `fetched`\n  // event emission.\n  queryBuilder.onFetched(async (models: any[], context: any) => {\n    await emitStaticEvent(ModelClass, \"fetched\", models as any, {\n      query: queryBuilder,\n      rawRecords: context?.rawRecords ?? [],\n      duration: context?.duration ?? Date.now() - fetchStartedAt,\n    });\n  });\n\n  return queryBuilder;\n}\n\nexport function buildNewQueryBuilder<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n): QueryBuilderContract<TModel> {\n  const dataSource = ModelClass.getDataSource();\n\n  if (ModelClass.builder) {\n    const BuilderClass = ModelClass.builder;\n    return new BuilderClass(ModelClass.table, dataSource) as QueryBuilderContract<TModel>;\n  }\n\n  const queryBuilder = dataSource.driver.queryBuilder<TModel>(ModelClass.table);\n  return queryBuilder;\n}\n\nexport async function findFirst<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.first();\n}\n\nexport async function findLast<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n\n  return query.last();\n}\n\nexport async function findAll<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel[]> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.get();\n}\n\nexport function countRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<number> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return query.count();\n}\n\nexport async function findById<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  id: string | number,\n): Promise<TModel | null> {\n  const query = ModelClass.query();\n  return query.where(ModelClass.primaryKey, id).first();\n}\n\nexport async function paginateRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  options: PaginationOptions & { filter?: Record<string, unknown> } = {},\n): Promise<PaginationResult<TModel>> {\n  const query = ModelClass.query();\n  if (options.filter) {\n    query.where(options.filter);\n  }\n\n  return query.paginate({\n    limit: options.limit,\n    page: options.page,\n  });\n}\n\nexport async function findLatest<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter?: Record<string, unknown>,\n): Promise<TModel[]> {\n  const query = ModelClass.query();\n  if (filter) {\n    query.where(filter);\n  }\n  return (await query.latest()) as unknown as TModel[];\n}\n\nexport function increaseField<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  field: string,\n  amount: number,\n): Promise<number> {\n  const query = ModelClass.query().where(filter);\n  return query.increment(field, amount);\n}\n\nexport function decreaseField<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  field: string,\n  amount: number,\n): Promise<number> {\n  const query = ModelClass.query().where(filter);\n  return query.decrement(field, amount);\n}\n\n// The atomic/find-and-modify statics below forward their filter straight to\n// the driver — they never pass through where(), so they must run the same\n// operator-injection check themselves. Only the FILTER is sanitized; update\n// operators ($set/$inc/…) are the point of these APIs and stay untouched.\n//\n// `trustedFilter` is the explicit, code-authored opt-out: it lets a conditional\n// filter such as `{ used: { $lt: 10 } }` through. It is stripped before the\n// options reach the driver.\nfunction resolveFilter(\n  filter: Record<string, unknown>,\n  options: AtomicUpdateOptions | undefined,\n): Record<string, unknown> {\n  return options?.trustedFilter ? filter : sanitizeFilter(filter);\n}\n\nfunction toDriverOptions<TOptions extends AtomicUpdateOptions>(\n  options: TOptions | undefined,\n): Omit<TOptions, \"trustedFilter\"> | undefined {\n  if (!options) {\n    return undefined;\n  }\n\n  const { trustedFilter: _trustedFilter, ...rest } = options;\n\n  return rest;\n}\n\n/**\n * Add the same generated `id` that normal Mongo inserts receive to an upsert's\n * insert branch. `$setOnInsert` keeps an existing document's id immutable.\n */\nasync function withAutoGeneratedUpsertId<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  operations: AtomicUpdate,\n  options: AtomicUpdateOptions | undefined,\n): Promise<AtomicUpdate> {\n  if (\n    !options?.upsert ||\n    !ModelClass.autoGenerateId ||\n    ModelClass.getDriver().name !== \"mongodb\" ||\n    Array.isArray(operations)\n  ) {\n    return operations;\n  }\n\n  const filterId = filter.id;\n  const filterConstrainsId =\n    Object.hasOwn(filter, \"id\") &&\n    (filterId === null ||\n      typeof filterId !== \"object\" ||\n      (!Array.isArray(filterId) && Object.hasOwn(filterId, \"$eq\")));\n  const updateSuppliesId =\n    Object.hasOwn(operations.$set ?? {}, \"id\") ||\n    Object.hasOwn(operations.$setOnInsert ?? {}, \"id\");\n\n  if (filterConstrainsId || updateSuppliesId) {\n    return operations;\n  }\n\n  const id = await generateModelId(ModelClass);\n\n  if (id === undefined) {\n    return operations;\n  }\n\n  return {\n    ...operations,\n    $setOnInsert: { ...operations.$setOnInsert, id },\n  };\n}\n\n/**\n * Pin a driver-level write to the rows the model's global scopes (tenant, soft\n * delete) allow. The driver write APIs take a raw filter and never see scopes,\n * so the target ids are resolved through the scoped query builder and added to\n * the filter. `null` means no visible row matches: the write must be a no-op.\n */\nexport async function scopeWriteFilter(\n  ModelClass: ChildModel<any>,\n  filter: Record<string, unknown>,\n  single: boolean,\n): Promise<Record<string, unknown> | null> {\n  const primaryKey = ModelClass.primaryKey;\n  const ids = await ModelClass.query().where(filter).pluck(primaryKey);\n\n  if (ids.length === 0) {\n    return null;\n  }\n\n  return { ...filter, [primaryKey]: single ? ids[0] : { $in: ids } };\n}\n\n/**\n * Scoped filter for a write that may insert (`upsert`). With no visible match\n * the driver would insert or, worse, update a row a scope hides (another\n * tenant's, a soft-deleted one), so a hidden match is refused.\n */\nexport async function scopeUpsertFilter(\n  ModelClass: ChildModel<any>,\n  filter: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n  const scoped = await scopeWriteFilter(ModelClass, filter, true);\n\n  if (scoped) {\n    return scoped;\n  }\n\n  const hidden = await ModelClass.query().withoutGlobalScopes().where(filter).exists();\n\n  if (hidden) {\n    throw new Error(\n      `${ModelClass.name}: upsert matches a row hidden by a global scope (tenant or soft delete); refusing to touch it.`,\n    );\n  }\n\n  return filter;\n}\n\n/**\n * Run an atomic update and return the number of documents modified plus the\n * number inserted by an `upsert`.\n */\nexport async function performAtomic<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  operations: AtomicUpdate,\n  options?: AtomicUpdateOptions,\n): Promise<number> {\n  const resolved = resolveFilter(filter, options);\n  const scoped = options?.upsert\n    ? await scopeUpsertFilter(ModelClass, resolved)\n    : await scopeWriteFilter(ModelClass, resolved, false);\n\n  if (!scoped) {\n    return 0;\n  }\n\n  const upsertOperations = await withAutoGeneratedUpsertId(ModelClass, scoped, operations, options);\n\n  const result = await ModelClass.getDriver().atomic(\n    ModelClass.table,\n    scoped,\n    upsertOperations,\n    toDriverOptions(options),\n  );\n\n  return result.modifiedCount + (result.upsertedCount ?? 0);\n}\n\n/**\n * Update a row by id through the model writer: the row is loaded (scopes\n * apply), merged, and saved, so the schema, strictMode, casting, `updatedAt`\n * and events all apply. Returns 1 when a row was saved, 0 when none is visible.\n */\nexport async function updateById<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  id: string | number,\n  data: Record<string, unknown>,\n): Promise<number> {\n  const model = await ModelClass.query().where(ModelClass.primaryKey, id).first();\n\n  if (!model) {\n    return 0;\n  }\n\n  model.merge(data);\n  await model.save();\n\n  return 1;\n}\n\nexport async function findAndUpdateRecords<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  update: AtomicUpdate,\n  options?: Omit<AtomicUpdateOptions, \"trustedFilter\">,\n): Promise<TModel[]> {\n  const primaryKey = ModelClass.primaryKey;\n  const safeFilter = sanitizeFilter(filter);\n\n  // Capture the matching ids first: the update usually changes the very field\n  // the filter matches on, so re-querying with the filter would find nothing.\n  const ids = await ModelClass.query().where(safeFilter).pluck(primaryKey);\n\n  if (ids.length === 0) {\n    if (!options?.upsert) {\n      return [];\n    }\n\n    await performAtomic(ModelClass, safeFilter, update, { ...options, trustedFilter: true });\n    return await ModelClass.query().where(safeFilter).get();\n  }\n\n  await performAtomic(ModelClass, { [primaryKey]: { $in: ids } }, update, {\n    ...options,\n    trustedFilter: true,\n  });\n\n  return await ModelClass.query().whereIn(primaryKey, ids).get();\n}\n\nexport async function findOneAndUpdateRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  update: AtomicUpdate,\n  options?: FindOneAndUpdateOptions,\n): Promise<TModel | null> {\n  const resolved = resolveFilter(filter, options);\n  const scoped = options?.upsert\n    ? await scopeUpsertFilter(ModelClass, resolved)\n    : await scopeWriteFilter(ModelClass, resolved, true);\n\n  if (!scoped) return null;\n\n  const upsertUpdate = await withAutoGeneratedUpsertId(ModelClass, scoped, update, options);\n\n  const result = await ModelClass.getDriver().findOneAndUpdate(\n    ModelClass.table,\n    scoped,\n    upsertUpdate,\n    toDriverOptions(options),\n  );\n  if (!result) return null;\n  return ModelClass.hydrate(result as Record<string, unknown>) as TModel;\n}\n\nexport async function findAndReplaceRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  document: Record<string, unknown>,\n): Promise<TModel | null> {\n  const scoped = await scopeWriteFilter(ModelClass, sanitizeFilter(filter), true);\n\n  if (!scoped) return null;\n\n  const result = await ModelClass.getDriver().replace(ModelClass.table, scoped, document);\n  if (!result) return null;\n  return ModelClass.hydrate(result as Record<string, unknown>) as TModel;\n}\n\nexport async function findOneAndDeleteRecord<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  filter: Record<string, unknown>,\n  options?: Record<string, unknown>,\n): Promise<TModel | null> {\n  const scoped = await scopeWriteFilter(ModelClass, sanitizeFilter(filter), true);\n\n  if (!scoped) {\n    return null;\n  }\n\n  const result = await ModelClass.getDriver().findOneAndDelete(ModelClass.table, scoped, options);\n\n  if (!result) {\n    return null;\n  }\n\n  const model = ModelClass.hydrate(result as Record<string, unknown>);\n  model.dirtyTracker.reset();\n  return model;\n}\n\nexport function resolveDataSource<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n): DataSource {\n  const ref = ModelClass.dataSource;\n  let dataSource: DataSource;\n\n  if (typeof ref === \"string\") {\n    dataSource = dataSourceRegistry.get(ref);\n  } else if (ref) {\n    dataSource = ref;\n  } else {\n    dataSource = dataSourceRegistry.get();\n  }\n\n  if (!ModelClass.hasOwnProperty(\"_defaultsApplied\")) {\n    const driverDefaults = dataSource.driver.modelDefaults || {};\n    const dataSourceDefaults = dataSource.modelDefaults || {};\n\n    const mergedDefaults = {\n      ...driverDefaults,\n      ...dataSourceDefaults,\n    };\n\n    if (Object.keys(mergedDefaults).length > 0) {\n      (ModelClass as any).applyModelDefaults(mergedDefaults);\n    }\n\n    (ModelClass as any)._defaultsApplied = true;\n  }\n\n  // First data-source resolution is the earliest per-class hook every model\n  // passes through — warn here (once) if the schema carries credential-shaped\n  // fields that toJSON() would expose.\n  warnUndeclaredSensitiveFields(ModelClass);\n\n  return dataSource;\n}\n"],"mappings":"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"}

package/esm/model/methods/write-methods.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"write-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/write-methods.ts"],"sourcesContent":["import { DatabaseWriter } from \"../../writer/database-writer\";\r\nimport type { InsertResult, WriterOptions } from \"../../contracts\";\r\nimport type { ChildModel, Model, ModelSchema } from \"../model\";\r\nimport { mergeDriverFields } from \"./accessor-methods\";\r\nimport { sanitizeFilter } from \"../../utils/sanitize-filter\";\r\nimport { emitModelEvent } from \"./instance-event-methods\";\r\n\r\n/**\r\n * Default number of rows processed per chunk by {@link createManyRecords}.\r\n *\r\n * Chunking keeps a single huge `createMany` call from flooding the driver:\r\n * the default path runs each chunk's `save()` calls under one `Promise.all`,\r\n * and the bulk path emits one multi-row `insertMany` per chunk so the\r\n * generated `INSERT ... VALUES (...),(...)` stays under the database's bind\r\n * parameter ceiling.\r\n */\r\nexport const DEFAULT_CREATE_MANY_BATCH_SIZE = 500;\r\n\r\n/**\r\n * Options for {@link createManyRecords} (and `Model.createMany`).\r\n */\r\nexport type CreateManyOptions = {\r\n  /**\r\n   * Number of rows processed per chunk.\r\n   *\r\n   * @default 500 ({@link DEFAULT_CREATE_MANY_BATCH_SIZE})\r\n   */\r\n  batchSize?: number;\r\n\r\n  /**\r\n   * Route each chunk through the driver's native multi-row insert\r\n   * (`insertMany`) instead of per-row `save()`.\r\n   *\r\n   * **Tradeoff:** the bulk path is 10–100× faster for large arrays but\r\n   * SKIPS the per-row lifecycle: `saving` / `creating` / `created` / `saved`\r\n   * events, instance hooks, and sync operations are NOT emitted. Casts,\r\n   * timestamps, defaults and id-generation that the writer normally applies\r\n   * ARE still applied (the rows are prepped through the same writer pipeline),\r\n   * so persisted columns match the default path.\r\n   *\r\n   * @default false\r\n   */\r\n  bulk?: boolean;\r\n};\r\n\r\nexport async function saveModel<TModel extends Model>(\r\n  model: TModel,\r\n  options?: WriterOptions & { merge?: Partial<ModelSchema> },\r\n): Promise<TModel> {\r\n  if (options?.merge) {\r\n    model.merge(options.merge);\r\n  }\r\n  const writer = new DatabaseWriter(model);\r\n  await writer.save(options);\r\n  return model;\r\n}\r\n\r\nexport async function createRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, data: Partial<TSchema>): Promise<TModel> {\r\n  const model = new ModelClass(data);\r\n  await model.save();\r\n  return model;\r\n}\r\n\r\n/**\r\n * Split an array into sequential chunks of at most `size` elements.\r\n *\r\n * @param items - The array to split.\r\n * @param size - Maximum chunk length (callers pass a value `>= 1`).\r\n * @returns An array of chunks preserving the original order.\r\n */\r\nfunction chunkArray<TItem>(items: TItem[], size: number): TItem[][] {\r\n  const chunks: TItem[][] = [];\r\n\r\n  for (let index = 0; index < items.length; index += size) {\r\n    chunks.push(items.slice(index, index + size));\r\n  }\r\n\r\n  return chunks;\r\n}\r\n\r\n/**\r\n * Create many records, chunking the work so a huge array can't overwhelm the\r\n * driver.\r\n *\r\n * Two strategies are available via `options.bulk`:\r\n *\r\n * - **Default (`bulk` falsy):** each row is persisted through `save()`, so\r\n *   model hooks, lifecycle events, casts and generated ids are all preserved.\r\n *   Rows are processed in sequential chunks of `batchSize`, each chunk running\r\n *   under a single `Promise.all`, so an array of millions of rows can't open\r\n *   millions of concurrent inserts at once.\r\n *\r\n * - **Bulk (`bulk: true`):** each chunk is routed to the driver's native\r\n *   multi-row insert (`insertMany`) for 10–100× throughput. This SKIPS the\r\n *   per-row save lifecycle (no `saving` / `creating` / `created` / `saved`\r\n *   events, hooks, or sync). Rows are still prepped through the writer\r\n *   pipeline (validation, casting, timestamps, defaults, id-generation) so the\r\n *   persisted columns match the default path, and the values returned by the\r\n *   driver (generated `_id`, timestamps, SQL `RETURNING *`) are merged back\r\n *   onto the returned models.\r\n *\r\n * Both strategies return the created model instances (an empty array is a\r\n * no-op that never touches the driver).\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param data - The rows to insert.\r\n * @param options - Chunking / bulk options.\r\n * @returns The created model instances.\r\n *\r\n * @example\r\n * ```typescript\r\n * // Default: per-row save(), chunked in batches of 500\r\n * const users = await User.createMany(rows);\r\n *\r\n * // Bulk: one multi-row INSERT per 1000-row chunk (skips per-row hooks)\r\n * const users = await User.createMany(rows, { bulk: true, batchSize: 1000 });\r\n * ```\r\n */\r\nexport async function createManyRecords<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  data: Partial<TSchema>[],\r\n  options: CreateManyOptions = {},\r\n): Promise<TModel[]> {\r\n  if (data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const batchSize =\r\n    options.batchSize && options.batchSize > 0\r\n      ? options.batchSize\r\n      : DEFAULT_CREATE_MANY_BATCH_SIZE;\r\n\r\n  const chunks = chunkArray(data, batchSize);\r\n\r\n  if (options.bulk === true) {\r\n    return await createManyBulk(ModelClass, chunks);\r\n  }\r\n\r\n  const created: TModel[] = [];\r\n\r\n  for (const chunk of chunks) {\r\n    const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n    // Reserve one contiguous id block for the whole chunk (1 counter op instead\r\n    // of N), pre-seeding each id-less model so its per-row save() no-ops id-gen.\r\n    await assignIdBlock(ModelClass, models);\r\n\r\n    const chunkModels = await Promise.all(\r\n      models.map(async (model) => {\r\n        await model.save();\r\n        return model;\r\n      }),\r\n    );\r\n\r\n    created.push(...chunkModels);\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\n/**\r\n * Reserve a single contiguous id block for one chunk and pre-assign the ids to\r\n * the models that don't already carry one, so the per-row writer's id\r\n * generation no-ops (its `model.get(\"id\")` guard short-circuits). This turns N\r\n * per-row counter round-trips into ONE per chunk.\r\n *\r\n * Falls back to per-row generation (a no-op here) when:\r\n * - the model disables auto-generation (`autoGenerateId === false`) — e.g. SQL,\r\n *   which uses native `SERIAL`;\r\n * - the data source's id generator has no batch API (`generateNextIds`) — the\r\n *   optional contract member is feature-detected;\r\n * - the model uses a random initial id / increment — a random stride can't form\r\n *   a contiguous block, so those models keep per-row generation.\r\n *\r\n * Only models WITHOUT a caller-supplied id consume a block slot, so a chunk\r\n * mixing supplied and auto ids allocates exactly the right number (no gaps).\r\n *\r\n * @param ModelClass - The model class being inserted.\r\n * @param models - The freshly-constructed (unsaved) models for one chunk.\r\n */\r\nasync function assignIdBlock<TModel extends Model>(\r\n  ModelClass: ChildModel<TModel>,\r\n  models: TModel[],\r\n): Promise<void> {\r\n  if (!ModelClass.autoGenerateId || ModelClass.randomInitialId || ModelClass.randomIncrement) {\r\n    return;\r\n  }\r\n\r\n  const idGenerator = ModelClass.getDataSource().idGenerator;\r\n\r\n  if (!idGenerator || typeof idGenerator.generateNextIds !== \"function\") {\r\n    return;\r\n  }\r\n\r\n  const idLessModels = models.filter((model) => !model.get(\"id\"));\r\n\r\n  if (idLessModels.length === 0) {\r\n    return;\r\n  }\r\n\r\n  const ids = await idGenerator.generateNextIds({\r\n    table: ModelClass.table,\r\n    initialId: ModelClass.initialId || 1,\r\n    incrementIdBy: ModelClass.incrementIdBy || 1,\r\n    count: idLessModels.length,\r\n  });\r\n\r\n  // Enforce the contract at this pluggable, feature-detected boundary: a\r\n  // non-conforming generator returning the wrong count would otherwise set\r\n  // `id = undefined` on the unmatched rows, the per-row writer would silently\r\n  // re-generate single ids, and the reserved block would no longer match what\r\n  // is persisted. Fail loud instead of corrupting the sequence.\r\n  if (ids.length !== idLessModels.length) {\r\n    throw new Error(\r\n      `generateNextIds returned ${ids.length} id(s) for ${idLessModels.length} row(s) on ` +\r\n        `\"${ModelClass.table}\" — a batch id generator must return exactly the requested count.`,\r\n    );\r\n  }\r\n\r\n  idLessModels.forEach((model, index) => {\r\n    model.set(\"id\", ids[index]);\r\n  });\r\n}\r\n\r\n/**\r\n * Bulk variant of {@link createManyRecords}: prep each row through the writer\r\n * pipeline (validation, casting, timestamps, defaults, id-generation) without\r\n * touching the database, then flush each chunk with a single\r\n * `driver.insertMany` call.\r\n *\r\n * The writer reuse goes through `DatabaseWriter.prepareForInsert()`, the same\r\n * pipeline `save()` uses for an insert, so the shared driver is never mutated\r\n * and concurrent `save()` calls are unaffected.\r\n *\r\n * @param ModelClass - The model class to create records for.\r\n * @param chunks - Pre-chunked rows.\r\n * @returns The created model instances with driver-returned values merged in.\r\n */\r\nasync function createManyBulk<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(ModelClass: ChildModel<TModel>, chunks: Partial<TSchema>[][]): Promise<TModel[]> {\r\n  const dataSource = ModelClass.getDataSource();\r\n  const driver = dataSource.driver;\r\n  const table = ModelClass.table;\r\n\r\n  const created: TModel[] = [];\r\n\r\n  {\r\n    for (const chunk of chunks) {\r\n      const models = chunk.map((item) => new ModelClass(item)) as TModel[];\r\n\r\n      // Reserve one contiguous id block for the whole chunk (1 counter op\r\n      // instead of N), pre-seeding each id-less model so the per-row writer's\r\n      // id generation no-ops.\r\n      await assignIdBlock(ModelClass, models);\r\n\r\n      // Prep every model through the real writer pipeline. The captured\r\n      // `insert` keeps this off the wire while still mutating each model's\r\n      // data with casts/timestamps/defaults/generated ids.\r\n      const preparedDocuments = await Promise.all(\r\n        models.map(async (model) => {\r\n          const document = await new DatabaseWriter(model).prepareForInsert({\r\n            skipEvents: true,\r\n            skipSync: true,\r\n          });\r\n          return { ...document } as Record<string, unknown>;\r\n        }),\r\n      );\r\n\r\n      const results = await driver.insertMany(table, preparedDocuments);\r\n\r\n      // Merge driver-returned values (generated _id, timestamps, RETURNING *)\r\n      // back onto each model so the returned instances reflect persisted state.\r\n      models.forEach((model, index) => {\r\n        const result = results[index] as InsertResult | Record<string, unknown> | undefined;\r\n\r\n        if (result) {\r\n          const returnedDocument =\r\n            \"document\" in (result as Record<string, unknown>)\r\n              ? (result as InsertResult).document\r\n              : result;\r\n\r\n          // Driver-returned identity (generated _id / RETURNING *) — merged\r\n          // through the framework-internal path so it is not treated as mass\r\n          // assignment on a model the writer has already marked persisted.\r\n          mergeDriverFields(model, returnedDocument as Record<string, unknown>);\r\n        }\r\n\r\n        model.dirtyTracker.reset();\r\n        model.isNew = false;\r\n      });\r\n\r\n      created.push(...models);\r\n    }\r\n  }\r\n\r\n  return created;\r\n}\r\n\r\nexport async function findOrCreateRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n): Promise<TModel> {\r\n  const existing = await ModelClass.first(filter as Record<string, unknown>);\r\n\r\n  if (existing) {\r\n    return existing;\r\n  }\r\n\r\n  return await createRecord(ModelClass, { ...filter, ...data } as Partial<TSchema>);\r\n}\r\n\r\nexport async function upsertRecord<\r\n  TModel extends Model,\r\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\r\n>(\r\n  ModelClass: ChildModel<TModel>,\r\n  filter: Partial<TSchema>,\r\n  data: Partial<TSchema>,\r\n  options?: Record<string, unknown>,\r\n): Promise<TModel> {\r\n  const driver = ModelClass.getDriver();\r\n  const safeFilter = sanitizeFilter(filter as Record<string, unknown>);\r\n  const mergedData = { ...safeFilter, ...data } as Record<string, unknown>;\r\n\r\n  const tempModel = new ModelClass(mergedData as Partial<TSchema>);\r\n  tempModel.isNew = true;\r\n\r\n  // One `saving` run against the model itself, so listener changes (slug,\r\n  // createdBy, ...) land in the data that is written.\r\n  await emitModelEvent(tempModel, \"saving\", {\r\n    isInsert: true,\r\n    options,\r\n    mode: \"upsert\",\r\n  });\r\n\r\n  // Validation, casting and Mongo id generation, same as `create()`.\r\n  await new DatabaseWriter(tempModel).prepareForUpsert();\r\n\r\n  const setData: Record<string, unknown> = { ...tempModel.data };\r\n  const setOnInsert: Record<string, unknown> = {};\r\n  const now = new Date();\r\n\r\n  // Identity and creation time belong to the insert only; an existing row\r\n  // keeps its own.\r\n  for (const key of new Set([\"id\", \"_id\", ModelClass.primaryKey])) {\r\n    if (key in setData) {\r\n      setOnInsert[key] = setData[key];\r\n      delete setData[key];\r\n    }\r\n  }\r\n\r\n  const createdAtColumn = ModelClass.createdAtColumn;\r\n  if (createdAtColumn) {\r\n    setOnInsert[createdAtColumn] = setData[createdAtColumn] ?? now;\r\n    delete setData[createdAtColumn];\r\n  }\r\n\r\n  const updatedAtColumn = ModelClass.updatedAtColumn;\r\n  if (updatedAtColumn) {\r\n    setData[updatedAtColumn] = now;\r\n  }\r\n\r\n  const result = await driver.findOneAndUpdate(\r\n    ModelClass.table,\r\n    safeFilter,\r\n    { $set: setData, $setOnInsert: setOnInsert },\r\n    { ...options, upsert: true, returnDocument: \"after\" },\r\n  );\r\n\r\n  const model = ModelClass.hydrate(result as Record<string, unknown>) as TModel;\r\n  model.dirtyTracker.reset();\r\n\r\n  await emitModelEvent(model, \"saved\", { filter: safeFilter, data: result, options, mode: \"upsert\" });\r\n\r\n  return model;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"write-methods.mjs","names":[],"sources":["../../../../../../../../cascade/src/model/methods/write-methods.ts"],"sourcesContent":["import { DatabaseWriter } from \"../../writer/database-writer\";\nimport type { InsertResult, WriterOptions } from \"../../contracts\";\nimport type { ChildModel, Model, ModelSchema } from \"../model\";\nimport { mergeDriverFields } from \"./accessor-methods\";\nimport { sanitizeFilter } from \"../../utils/sanitize-filter\";\nimport { emitModelEvent } from \"./instance-event-methods\";\n\n/**\n * Default number of rows processed per chunk by {@link createManyRecords}.\n *\n * Chunking keeps a single huge `createMany` call from flooding the driver:\n * the default path runs each chunk's `save()` calls under one `Promise.all`,\n * and the bulk path emits one multi-row `insertMany` per chunk so the\n * generated `INSERT ... VALUES (...),(...)` stays under the database's bind\n * parameter ceiling.\n */\nexport const DEFAULT_CREATE_MANY_BATCH_SIZE = 500;\n\n/**\n * Options for {@link createManyRecords} (and `Model.createMany`).\n */\nexport type CreateManyOptions = {\n  /**\n   * Number of rows processed per chunk.\n   *\n   * @default 500 ({@link DEFAULT_CREATE_MANY_BATCH_SIZE})\n   */\n  batchSize?: number;\n\n  /**\n   * Route each chunk through the driver's native multi-row insert\n   * (`insertMany`) instead of per-row `save()`.\n   *\n   * **Tradeoff:** the bulk path is 10–100× faster for large arrays but\n   * SKIPS the per-row lifecycle: `saving` / `creating` / `created` / `saved`\n   * events, instance hooks, and sync operations are NOT emitted. Casts,\n   * timestamps, defaults and id-generation that the writer normally applies\n   * ARE still applied (the rows are prepped through the same writer pipeline),\n   * so persisted columns match the default path.\n   *\n   * @default false\n   */\n  bulk?: boolean;\n};\n\nexport async function saveModel<TModel extends Model>(\n  model: TModel,\n  options?: WriterOptions & { merge?: Partial<ModelSchema> },\n): Promise<TModel> {\n  if (options?.merge) {\n    model.merge(options.merge);\n  }\n  const writer = new DatabaseWriter(model);\n  await writer.save(options);\n  return model;\n}\n\nexport async function createRecord<\n  TModel extends Model,\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\n>(ModelClass: ChildModel<TModel>, data: Partial<TSchema>): Promise<TModel> {\n  const model = new ModelClass(data);\n  await model.save();\n  return model;\n}\n\n/**\n * Split an array into sequential chunks of at most `size` elements.\n *\n * @param items - The array to split.\n * @param size - Maximum chunk length (callers pass a value `>= 1`).\n * @returns An array of chunks preserving the original order.\n */\nfunction chunkArray<TItem>(items: TItem[], size: number): TItem[][] {\n  const chunks: TItem[][] = [];\n\n  for (let index = 0; index < items.length; index += size) {\n    chunks.push(items.slice(index, index + size));\n  }\n\n  return chunks;\n}\n\n/**\n * Create many records, chunking the work so a huge array can't overwhelm the\n * driver.\n *\n * Two strategies are available via `options.bulk`:\n *\n * - **Default (`bulk` falsy):** each row is persisted through `save()`, so\n *   model hooks, lifecycle events, casts and generated ids are all preserved.\n *   Rows are processed in sequential chunks of `batchSize`, each chunk running\n *   under a single `Promise.all`, so an array of millions of rows can't open\n *   millions of concurrent inserts at once.\n *\n * - **Bulk (`bulk: true`):** each chunk is routed to the driver's native\n *   multi-row insert (`insertMany`) for 10–100× throughput. This SKIPS the\n *   per-row save lifecycle (no `saving` / `creating` / `created` / `saved`\n *   events, hooks, or sync). Rows are still prepped through the writer\n *   pipeline (validation, casting, timestamps, defaults, id-generation) so the\n *   persisted columns match the default path, and the values returned by the\n *   driver (generated `_id`, timestamps, SQL `RETURNING *`) are merged back\n *   onto the returned models.\n *\n * Both strategies return the created model instances (an empty array is a\n * no-op that never touches the driver).\n *\n * @param ModelClass - The model class to create records for.\n * @param data - The rows to insert.\n * @param options - Chunking / bulk options.\n * @returns The created model instances.\n *\n * @example\n * ```typescript\n * // Default: per-row save(), chunked in batches of 500\n * const users = await User.createMany(rows);\n *\n * // Bulk: one multi-row INSERT per 1000-row chunk (skips per-row hooks)\n * const users = await User.createMany(rows, { bulk: true, batchSize: 1000 });\n * ```\n */\nexport async function createManyRecords<\n  TModel extends Model,\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\n>(\n  ModelClass: ChildModel<TModel>,\n  data: Partial<TSchema>[],\n  options: CreateManyOptions = {},\n): Promise<TModel[]> {\n  if (data.length === 0) {\n    return [];\n  }\n\n  const batchSize =\n    options.batchSize && options.batchSize > 0\n      ? options.batchSize\n      : DEFAULT_CREATE_MANY_BATCH_SIZE;\n\n  const chunks = chunkArray(data, batchSize);\n\n  if (options.bulk === true) {\n    return await createManyBulk(ModelClass, chunks);\n  }\n\n  const created: TModel[] = [];\n\n  for (const chunk of chunks) {\n    const models = chunk.map((item) => new ModelClass(item)) as TModel[];\n\n    // Reserve one contiguous id block for the whole chunk (1 counter op instead\n    // of N), pre-seeding each id-less model so its per-row save() no-ops id-gen.\n    await assignIdBlock(ModelClass, models);\n\n    const chunkModels = await Promise.all(\n      models.map(async (model) => {\n        await model.save();\n        return model;\n      }),\n    );\n\n    created.push(...chunkModels);\n  }\n\n  return created;\n}\n\n/**\n * Reserve a single contiguous id block for one chunk and pre-assign the ids to\n * the models that don't already carry one, so the per-row writer's id\n * generation no-ops (its `model.get(\"id\")` guard short-circuits). This turns N\n * per-row counter round-trips into ONE per chunk.\n *\n * Falls back to per-row generation (a no-op here) when:\n * - the model disables auto-generation (`autoGenerateId === false`) — e.g. SQL,\n *   which uses native `SERIAL`;\n * - the data source's id generator has no batch API (`generateNextIds`) — the\n *   optional contract member is feature-detected;\n * - the model uses a random initial id / increment — a random stride can't form\n *   a contiguous block, so those models keep per-row generation.\n *\n * Only models WITHOUT a caller-supplied id consume a block slot, so a chunk\n * mixing supplied and auto ids allocates exactly the right number (no gaps).\n *\n * @param ModelClass - The model class being inserted.\n * @param models - The freshly-constructed (unsaved) models for one chunk.\n */\nasync function assignIdBlock<TModel extends Model>(\n  ModelClass: ChildModel<TModel>,\n  models: TModel[],\n): Promise<void> {\n  if (!ModelClass.autoGenerateId || ModelClass.randomInitialId || ModelClass.randomIncrement) {\n    return;\n  }\n\n  const idGenerator = ModelClass.getDataSource().idGenerator;\n\n  if (!idGenerator || typeof idGenerator.generateNextIds !== \"function\") {\n    return;\n  }\n\n  const idLessModels = models.filter((model) => !model.get(\"id\"));\n\n  if (idLessModels.length === 0) {\n    return;\n  }\n\n  const ids = await idGenerator.generateNextIds({\n    table: ModelClass.table,\n    initialId: ModelClass.initialId || 1,\n    incrementIdBy: ModelClass.incrementIdBy || 1,\n    count: idLessModels.length,\n  });\n\n  // Enforce the contract at this pluggable, feature-detected boundary: a\n  // non-conforming generator returning the wrong count would otherwise set\n  // `id = undefined` on the unmatched rows, the per-row writer would silently\n  // re-generate single ids, and the reserved block would no longer match what\n  // is persisted. Fail loud instead of corrupting the sequence.\n  if (ids.length !== idLessModels.length) {\n    throw new Error(\n      `generateNextIds returned ${ids.length} id(s) for ${idLessModels.length} row(s) on ` +\n        `\"${ModelClass.table}\" — a batch id generator must return exactly the requested count.`,\n    );\n  }\n\n  idLessModels.forEach((model, index) => {\n    model.set(\"id\", ids[index]);\n  });\n}\n\n/**\n * Bulk variant of {@link createManyRecords}: prep each row through the writer\n * pipeline (validation, casting, timestamps, defaults, id-generation) without\n * touching the database, then flush each chunk with a single\n * `driver.insertMany` call.\n *\n * The writer reuse goes through `DatabaseWriter.prepareForInsert()`, the same\n * pipeline `save()` uses for an insert, so the shared driver is never mutated\n * and concurrent `save()` calls are unaffected.\n *\n * @param ModelClass - The model class to create records for.\n * @param chunks - Pre-chunked rows.\n * @returns The created model instances with driver-returned values merged in.\n */\nasync function createManyBulk<\n  TModel extends Model,\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\n>(ModelClass: ChildModel<TModel>, chunks: Partial<TSchema>[][]): Promise<TModel[]> {\n  const dataSource = ModelClass.getDataSource();\n  const driver = dataSource.driver;\n  const table = ModelClass.table;\n\n  const created: TModel[] = [];\n\n  {\n    for (const chunk of chunks) {\n      const models = chunk.map((item) => new ModelClass(item)) as TModel[];\n\n      // Reserve one contiguous id block for the whole chunk (1 counter op\n      // instead of N), pre-seeding each id-less model so the per-row writer's\n      // id generation no-ops.\n      await assignIdBlock(ModelClass, models);\n\n      // Prep every model through the real writer pipeline. The captured\n      // `insert` keeps this off the wire while still mutating each model's\n      // data with casts/timestamps/defaults/generated ids.\n      const preparedDocuments = await Promise.all(\n        models.map(async (model) => {\n          const document = await new DatabaseWriter(model).prepareForInsert({\n            skipEvents: true,\n            skipSync: true,\n          });\n          return { ...document } as Record<string, unknown>;\n        }),\n      );\n\n      const results = await driver.insertMany(table, preparedDocuments);\n\n      // Merge driver-returned values (generated _id, timestamps, RETURNING *)\n      // back onto each model so the returned instances reflect persisted state.\n      models.forEach((model, index) => {\n        const result = results[index] as InsertResult | Record<string, unknown> | undefined;\n\n        if (result) {\n          const returnedDocument =\n            \"document\" in (result as Record<string, unknown>)\n              ? (result as InsertResult).document\n              : result;\n\n          // Driver-returned identity (generated _id / RETURNING *) — merged\n          // through the framework-internal path so it is not treated as mass\n          // assignment on a model the writer has already marked persisted.\n          mergeDriverFields(model, returnedDocument as Record<string, unknown>);\n        }\n\n        model.dirtyTracker.reset();\n        model.isNew = false;\n      });\n\n      created.push(...models);\n    }\n  }\n\n  return created;\n}\n\nexport async function findOrCreateRecord<\n  TModel extends Model,\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\n>(\n  ModelClass: ChildModel<TModel>,\n  filter: Partial<TSchema>,\n  data: Partial<TSchema>,\n): Promise<TModel> {\n  const existing = await ModelClass.first(filter as Record<string, unknown>);\n\n  if (existing) {\n    return existing;\n  }\n\n  return await createRecord(ModelClass, { ...filter, ...data } as Partial<TSchema>);\n}\n\nexport async function upsertRecord<\n  TModel extends Model,\n  TSchema extends ModelSchema = TModel extends Model<infer S> ? S : ModelSchema,\n>(\n  ModelClass: ChildModel<TModel>,\n  filter: Partial<TSchema>,\n  data: Partial<TSchema>,\n  options?: Record<string, unknown>,\n): Promise<TModel> {\n  const driver = ModelClass.getDriver();\n  const safeFilter = sanitizeFilter(filter as Record<string, unknown>);\n  const mergedData = { ...safeFilter, ...data } as Record<string, unknown>;\n\n  const tempModel = new ModelClass(mergedData as Partial<TSchema>);\n  tempModel.isNew = true;\n\n  // One `saving` run against the model itself, so listener changes (slug,\n  // createdBy, ...) land in the data that is written.\n  await emitModelEvent(tempModel, \"saving\", {\n    isInsert: true,\n    options,\n    mode: \"upsert\",\n  });\n\n  // Validation, casting and Mongo id generation, same as `create()`.\n  await new DatabaseWriter(tempModel).prepareForUpsert();\n\n  const setData: Record<string, unknown> = { ...tempModel.data };\n  const setOnInsert: Record<string, unknown> = {};\n  const now = new Date();\n\n  // Identity and creation time belong to the insert only; an existing row\n  // keeps its own.\n  for (const key of new Set([\"id\", \"_id\", ModelClass.primaryKey])) {\n    if (key in setData) {\n      setOnInsert[key] = setData[key];\n      delete setData[key];\n    }\n  }\n\n  const createdAtColumn = ModelClass.createdAtColumn;\n  if (createdAtColumn) {\n    setOnInsert[createdAtColumn] = setData[createdAtColumn] ?? now;\n    delete setData[createdAtColumn];\n  }\n\n  const updatedAtColumn = ModelClass.updatedAtColumn;\n  if (updatedAtColumn) {\n    setData[updatedAtColumn] = now;\n  }\n\n  const result = await driver.findOneAndUpdate(\n    ModelClass.table,\n    safeFilter,\n    { $set: setData, $setOnInsert: setOnInsert },\n    { ...options, upsert: true, returnDocument: \"after\" },\n  );\n\n  const model = ModelClass.hydrate(result as Record<string, unknown>) as TModel;\n  model.dirtyTracker.reset();\n\n  await emitModelEvent(model, \"saved\", { filter: safeFilter, data: result, options, mode: \"upsert\" });\n\n  return model;\n}\n"],"mappings":"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"}

package/esm/query-builder/query-builder.mjs

@@ -1185,7 +1185,7 @@ var QueryBuilder = class QueryBuilder {
 	}
 	/** Raw GROUP BY expression. */
 	groupByRaw(expression, bindings) {
-		this.addOperation("groupBy", {
+		this.addOperation("groupByRaw", {
 			expression,
 			bindings: bindings ?? []
 		});