@classytic/mongokit 3.7.0 → 3.10.0

package/dist/index.mjs

@@ -1,14 +1,14 @@
 import { r as warn, t as configureLogger } from "./logger-DJ7egMnd.mjs";
-import { y as LookupBuilder } from "./update-BDsQ3cdy.mjs";
-import { n as parseDuplicateKeyError, t as createError } from "./error-Lw9GEAro.mjs";
+import { b as LookupBuilder } from "./update-CWXfFC6O.mjs";
+import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-CzYwrfUP.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-CPmZv7Ds.mjs";
-import { A as AuditTrailQuery, C as cachePlugin, D as withTransaction, E as isTransactionUnsupported, M as auditLogPlugin, N as aggregateHelpersPlugin, O as AggregationBuilder, S as cascadePlugin, T as Repository, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, w as HOOK_PRIORITY, x as sequentialId, y as getNextSequence } from "./validation-chain.plugin-CEyJssZl.mjs";
+import { A as AuditTrailQuery, C as cachePlugin, D as withTransaction, E as isTransactionUnsupported, F as MUTATING_OPERATIONS, I as OP_REGISTRY, L as READ_OPERATIONS, M as auditLogPlugin, N as aggregateHelpersPlugin, O as AggregationBuilder, P as ALL_OPERATIONS, R as operationsByPolicyKey, S as cascadePlugin, T as Repository, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, w as HOOK_PRIORITY, x as sequentialId, y as getNextSequence } from "./validation-chain.plugin-Ccu6irtx.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-B93fLCcO.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-dI0m4RBs.mjs";
 import { buildFieldTypeMap, coerceFieldValue, coerceHeuristic } from "./query/primitives/coercion.mjs";
 import { extractSchemaIndexes } from "./query/primitives/indexes.mjs";
-import { a as isFieldUpdateAllowed, i as getSystemManagedFields, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-DUwXPStK.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-D1sdCOmj.mjs";
 //#region src/query/QueryParser.ts
 /**
 * Modern Query Parser
@@ -986,4 +986,4 @@ function createRepository(Model, plugins = [], paginationConfig = {}, options =
 }
 var src_default = Repository;
 //#endregion
-export { AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, PaginationEngine, QueryParser, Repository, actions_exports as actions, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, configureLogger, createError, createFieldPreset, createMemoryCache, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getNextSequence, getSystemManagedFields, immutableField, isFieldUpdateAllowed, isTransactionUnsupported, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, parseDuplicateKeyError, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validateUpdateBody, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, configureLogger, createError, createFieldPreset, createMemoryCache, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, immutableField, isDuplicateKeyError, isTransactionUnsupported, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin, withTransaction };

package/dist/{mongooseToJsonSchema-DUwXPStK.mjs → mongooseToJsonSchema-D1sdCOmj.mjs}

@@ -1,5 +1,6 @@
 import { n as isObjectIdInstance } from "./id-resolution-e4BT9zAV.mjs";
 import mongoose from "mongoose";
+import { applyFieldRules, collectFieldsToOmit } from "@classytic/repo-core/schema";
 //#region src/utils/memory-cache.ts
 /**
 * Creates an in-memory cache adapter
@@ -51,7 +52,7 @@ function createMemoryCache(maxEntries = 1e3) {
 				expiresAt: Date.now() + ttl * 1e3
 			});
 		},
-		async del(key) {
+		async delete(key) {
 			cache.delete(key);
 		},
 		async clear(pattern) {
@@ -68,25 +69,22 @@ function createMemoryCache(maxEntries = 1e3) {
 //#endregion
 //#region src/utils/mongooseToJsonSchema.ts
 /**
-* Mongoose to JSON Schema Converter with Field Rules
+* Mongoose → JSON Schema converter.
 *
-* Generates Fastify JSON schemas from Mongoose models with declarative field rules.
+* The **mongoose-specific** half of mongokit's CRUD-schema pipeline. Walks
+* `Model.schema.paths` (accurate type info, including subdocuments, arrays,
+* Maps, enums, length/min/max validators) and emits the four portable
+* `CrudSchemas` fragments defined at `@classytic/repo-core/schema`.
 *
-* Field Rules (options.fieldRules):
-* - immutable: Field cannot be updated (omitted from update schema)
-* - immutableAfterCreate: Alias for immutable
-* - systemManaged: System-only field (omitted from create/update)
-* - optional: Remove from required array
-*
-* Additional Options:
-* - strictAdditionalProperties: Set to true to add "additionalProperties: false" to schemas
-*   This makes Fastify reject unknown fields at validation level (default: false for backward compatibility)
-* - update.requireAtLeastOne: Set to true to add "minProperties: 1" to update schema
-*   This prevents empty update payloads (default: false)
+* Policy — `fieldRules` (immutable / systemManaged / optional) and the
+* `create.omitFields` / `update.omitFields` lists — lives in repo-core and
+* is shared across every kit. Every other kit (sqlitekit's
+* `drizzleToJsonSchema`, prismakit's `prismaToJsonSchema`, ...) reuses the
+* same helpers so a switch of storage backend is a one-line import swap.
 *
 * @example
 * buildCrudSchemasFromModel(Model, {
-*   strictAdditionalProperties: true, // Reject unknown fields
+*   strictAdditionalProperties: true,
 *   fieldRules: {
 *     organizationId: { immutable: true },
 *     status: { systemManaged: true },
@@ -94,9 +92,9 @@ function createMemoryCache(maxEntries = 1e3) {
 *   create: { omitFields: ['verifiedAt'] },
 *   update: {
 *     omitFields: ['customerId'],
-*     requireAtLeastOne: true // Reject empty updates
-*   }
-* })
+*     requireAtLeastOne: true,
+*   },
+* });
 */
 function isMongooseSchema(value) {
 	return value instanceof mongoose.Schema;
@@ -134,89 +132,6 @@ function buildCrudSchemasFromModel(mongooseModel, options = {}) {
 	return buildCrudSchemasFromMongooseSchema(mongooseModel.schema, options);
 }
 /**
-* Collect fields to omit from a generated schema based on field rules and
-* explicit omit lists. This is the single source of truth for "which fields
-* should NOT appear in the create/update body" — called by both the
-* path-based and tree-based schema builders.
-*/
-function collectFieldsToOmit(options, purpose) {
-	const result = new Set([
-		"createdAt",
-		"updatedAt",
-		"__v"
-	]);
-	const rules = options?.fieldRules || {};
-	for (const [field, rule] of Object.entries(rules)) {
-		if (rule.systemManaged) result.add(field);
-		if (purpose === "update" && (rule.immutable || rule.immutableAfterCreate)) result.add(field);
-	}
-	const explicit = purpose === "create" ? options?.create?.omitFields : options?.update?.omitFields;
-	if (explicit) for (const f of explicit) result.add(f);
-	return result;
-}
-/**
-* Apply omissions + optional-overrides to a built JSON schema in-place.
-* Removes properties and adjusts the `required` array.
-*/
-function applyFieldRules(schema, fieldsToOmit, options) {
-	for (const field of fieldsToOmit) {
-		if (schema.properties?.[field]) delete schema.properties[field];
-		if (schema.required) schema.required = schema.required.filter((k) => k !== field);
-	}
-	const rules = options?.fieldRules || {};
-	for (const [field, rule] of Object.entries(rules)) if (rule.optional && schema.required) schema.required = schema.required.filter((k) => k !== field);
-}
-/**
-* Get fields that are immutable (cannot be updated).
-* Delegates to `collectFieldsToOmit` internally.
-*/
-function getImmutableFields(options = {}) {
-	const immutable = [];
-	const rules = options?.fieldRules || {};
-	for (const [field, rule] of Object.entries(rules)) if (rule.immutable || rule.immutableAfterCreate) immutable.push(field);
-	for (const f of options?.update?.omitFields || []) if (!immutable.includes(f)) immutable.push(f);
-	return immutable;
-}
-/**
-* Get fields that are system-managed (cannot be set by users).
-*/
-function getSystemManagedFields(options = {}) {
-	const systemManaged = [];
-	const rules = options?.fieldRules || {};
-	for (const [field, rule] of Object.entries(rules)) if (rule.systemManaged) systemManaged.push(field);
-	return systemManaged;
-}
-/**
-* Check if field is allowed in update
-*/
-function isFieldUpdateAllowed(fieldName, options = {}) {
-	const immutableFields = getImmutableFields(options);
-	const systemManagedFields = getSystemManagedFields(options);
-	return !immutableFields.includes(fieldName) && !systemManagedFields.includes(fieldName);
-}
-/**
-* Validate update body against field rules
-*/
-function validateUpdateBody(body = {}, options = {}) {
-	const violations = [];
-	const immutableFields = getImmutableFields(options);
-	const systemManagedFields = getSystemManagedFields(options);
-	Object.keys(body).forEach((field) => {
-		if (immutableFields.includes(field)) violations.push({
-			field,
-			reason: "Field is immutable"
-		});
-		else if (systemManagedFields.includes(field)) violations.push({
-			field,
-			reason: "Field is system-managed"
-		});
-	});
-	return {
-		valid: violations.length === 0,
-		violations
-	};
-}
-/**
 * Build JSON schema from Mongoose schema.paths (accurate type information)
 */
 function buildJsonSchemaFromPaths(mongooseSchema, options) {
@@ -228,6 +143,9 @@ function buildJsonSchemaFromPaths(mongooseSchema, options) {
 		if (softRequiredSet.has(name)) return true;
 		return schemaType?.options?.softRequired === true;
 	};
+	const hasDefault = (schemaType) => {
+		return schemaType?.options?.default !== void 0;
+	};
 	const rootFields = /* @__PURE__ */ new Map();
 	for (const [path, schemaType] of Object.entries(paths)) {
 		if (path === "__v") continue;
@@ -246,7 +164,7 @@ function buildJsonSchemaFromPaths(mongooseSchema, options) {
 	for (const [rootField, fieldPaths] of rootFields.entries()) if (fieldPaths.length === 1 && fieldPaths[0].path === rootField) {
 		const schemaType = fieldPaths[0].schemaType;
 		properties[rootField] = schemaTypeToJsonSchema(schemaType, options);
-		if (schemaType.isRequired && !isSoftRequired(rootField, schemaType)) required.push(rootField);
+		if (schemaType.isRequired && !isSoftRequired(rootField, schemaType) && !hasDefault(schemaType)) required.push(rootField);
 	} else {
 		const nestedSchema = buildNestedJsonSchema(fieldPaths, rootField, options);
 		properties[rootField] = nestedSchema.schema;
@@ -631,4 +549,4 @@ function buildJsonSchemaForQuery(_tree, options) {
 	return basePagination;
 }
 //#endregion
-export { isFieldUpdateAllowed as a, getSystemManagedFields as i, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t };
+export { buildCrudSchemasFromMongooseSchema as n, createMemoryCache as r, buildCrudSchemasFromModel as t };

package/dist/{mongooseToJsonSchema-Du-UopRK.d.mts → mongooseToJsonSchema-t-MoVleF.d.mts}

@@ -1,5 +1,6 @@
-import { T as FieldPreset, _ as CrudSchemas, k as HttpError, ot as SchemaBuilderOptions, s as CacheAdapter, xt as ValidationResult, yt as UserContext } from "./types-BgdeBXI1.mjs";
+import { O as HttpError, _t as UserContext, s as CacheAdapter, w as FieldPreset } from "./types-BUS0Zj8y.mjs";
 import mongoose, { Schema } from "mongoose";
+import { CrudSchemas, SchemaBuilderOptions } from "@classytic/repo-core/schema";
 
 //#region src/utils/error.d.ts
 /**
@@ -15,6 +16,23 @@ import mongoose, { Schema } from "mongoose";
  * throw createError(403, 'Access denied');
  */
 declare function createError(status: number, message: string): HttpError;
+/**
+ * Boolean classifier: true when `err` is an authoritative MongoDB duplicate
+ * key error — and ONLY then. Used by arc's outbox / idempotency adapters to
+ * distinguish "write already landed (idempotent no-op)" from "transient DB
+ * error (must retry)".
+ *
+ * Deliberately narrow — matches only:
+ *   - `code === 11000`
+ *   - `codeName === 'DuplicateKey'`
+ *
+ * Does NOT match `err.name === 'MongoServerError'`, which is also true for
+ * WriteConflict (112), NotWritablePrimary (10107), ExceededTimeLimit, and
+ * every other server-side error. Treating those as duplicate keys would
+ * cause arc's outbox to silently swallow transactional retries and lose
+ * events.
+ */
+declare function isDuplicateKeyError(err: unknown): boolean;
 /** Options for parseDuplicateKeyError */
 interface ParseDuplicateKeyOptions {
   /**
@@ -161,22 +179,5 @@ declare function buildCrudSchemasFromMongooseSchema(mongooseSchema: Schema, opti
  * Build CRUD schemas from Mongoose model
  */
 declare function buildCrudSchemasFromModel(mongooseModel: mongoose.Model<unknown>, options?: SchemaBuilderOptions): CrudSchemas;
-/**
- * Get fields that are immutable (cannot be updated).
- * Delegates to `collectFieldsToOmit` internally.
- */
-declare function getImmutableFields(options?: SchemaBuilderOptions): string[];
-/**
- * Get fields that are system-managed (cannot be set by users).
- */
-declare function getSystemManagedFields(options?: SchemaBuilderOptions): string[];
-/**
- * Check if field is allowed in update
- */
-declare function isFieldUpdateAllowed(fieldName: string, options?: SchemaBuilderOptions): boolean;
-/**
- * Validate update body against field rules
- */
-declare function validateUpdateBody(body?: Record<string, unknown>, options?: SchemaBuilderOptions): ValidationResult;
 //#endregion
-export { isFieldUpdateAllowed as a, configureLogger as c, getFieldsForUser as d, getMongooseProjection as f, getSystemManagedFields as i, createFieldPreset as l, parseDuplicateKeyError as m, buildCrudSchemasFromMongooseSchema as n, validateUpdateBody as o, createError as p, getImmutableFields as r, createMemoryCache as s, buildCrudSchemasFromModel as t, filterResponseData as u };
+export { createFieldPreset as a, getMongooseProjection as c, parseDuplicateKeyError as d, configureLogger as i, createError as l, buildCrudSchemasFromMongooseSchema as n, filterResponseData as o, createMemoryCache as r, getFieldsForUser as s, buildCrudSchemasFromModel as t, isDuplicateKeyError as u };

package/dist/pagination/PaginationEngine.d.mts

@@ -1,4 +1,4 @@
-import { F as KeysetPaginationResult, G as PaginationConfig, H as OffsetPaginationOptions, P as KeysetPaginationOptions, U as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-BgdeBXI1.mjs";
+import { B as OffsetPaginationOptions, M as KeysetPaginationOptions, N as KeysetPaginationResult, U as PaginationConfig, V as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-BUS0Zj8y.mjs";
 import { Model } from "mongoose";
 
 //#region src/pagination/PaginationEngine.d.ts

package/dist/pagination/PaginationEngine.mjs

@@ -1,2 +1,2 @@
-import { t as PaginationEngine } from "../PaginationEngine-CPmZv7Ds.mjs";
+import { t as PaginationEngine } from "../PaginationEngine-B93fLCcO.mjs";
 export { PaginationEngine };

package/dist/plugins/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, S as MethodRegistryRepository, T as ElasticSearchOptions, U as AuditEntry, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "../validation-chain.plugin-Be9rG04B.mjs";
+import { $ as aggregateHelpersPlugin, A as PrefixedIdOptions, B as BatchOperationsMethods, C as methodRegistryPlugin, D as CustomIdOptions, E as elasticSearchPlugin, F as prefixedId, G as AuditQueryOptions, H as batchOperationsPlugin, I as sequentialId, J as AuditTrailOptions, K as AuditQueryResult, L as cascadePlugin, M as customIdPlugin, N as dateSequentialId, O as DateSequentialIdOptions, P as getNextSequence, Q as AggregateHelpersMethods, R as CacheMethods, S as MethodRegistryRepository, T as ElasticSearchOptions, U as AuditEntry, W as AuditOperation, X as auditTrailPlugin, Y as AuditTrailQuery, Z as auditLogPlugin, _ as observabilityPlugin, a as uniqueField, b as MongoOperationsMethods, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as SequentialIdOptions, k as IdGenerator, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, q as AuditTrailMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MultiTenantOptions, w as fieldFilterPlugin, x as mongoOperationsPlugin, y as multiTenantPlugin, z as cachePlugin } from "../validation-chain.plugin-JkipjuOR.mjs";
 export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheMethods, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,2 +1,2 @@
-import { A as AuditTrailQuery, C as cachePlugin, M as auditLogPlugin, N as aggregateHelpersPlugin, S as cascadePlugin, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, x as sequentialId, y as getNextSequence } from "../validation-chain.plugin-CEyJssZl.mjs";
+import { A as AuditTrailQuery, C as cachePlugin, M as auditLogPlugin, N as aggregateHelpersPlugin, S as cascadePlugin, _ as customIdPlugin, a as uniqueField, b as prefixedId, c as createTenantContext, d as observabilityPlugin, f as multiTenantPlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, j as auditTrailPlugin, k as batchOperationsPlugin, l as subdocumentPlugin, m as methodRegistryPlugin, n as blockIf, o as validationChainPlugin, p as mongoOperationsPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as softDeletePlugin, v as dateSequentialId, x as sequentialId, y as getNextSequence } from "../validation-chain.plugin-Ccu6irtx.mjs";
 export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/{types-BgdeBXI1.d.mts → types-BUS0Zj8y.d.mts}

@@ -1,5 +1,8 @@
 import * as _$mongoose from "mongoose";
 import { ClientSession, Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
+import * as _$_classytic_repo_core_repository0 from "@classytic/repo-core/repository";
+import { DeleteResult, LookupPopulateResult, UpdateManyResult } from "@classytic/repo-core/repository";
+import { ValidationResult } from "@classytic/repo-core/schema";
 
 //#region src/query/LookupBuilder.d.ts
 interface LookupOptions {
@@ -822,6 +825,31 @@ interface UpdateOptions extends OperationOptions {
   /** Array filters for positional operator $[<identifier>] updates */
   arrayFilters?: Record<string, unknown>[];
 }
+/**
+ * Options for atomic findOneAndUpdate (compare-and-set primitive).
+ *
+ * Designed for outbox/lock/semaphore patterns that need a single round-trip
+ * match-and-mutate. Goes through the full hook pipeline (multi-tenant scope,
+ * soft-delete, audit) the same way `update()` does.
+ */
+interface FindOneAndUpdateOptions extends OperationOptions {
+  /** Sort to disambiguate when filter matches multiple docs (e.g. FIFO claim). */
+  sort?: SortSpec;
+  /** Return doc state before or after the update. Default: 'after'. */
+  returnDocument?: 'before' | 'after';
+  /** Insert if no doc matches. Default: false. */
+  upsert?: boolean;
+  /** Array filters for positional `$[<identifier>]` updates. */
+  arrayFilters?: Record<string, unknown>[];
+  /** Allow aggregation-pipeline updates (array form). Default: false. */
+  updatePipeline?: boolean;
+  /** Run mongoose schema validators on the update. Default: true. */
+  runValidators?: boolean;
+  /** Collation for locale-aware string comparison. */
+  collation?: CollationOptions;
+  /** Maximum execution time in milliseconds. */
+  maxTimeMS?: number;
+}
 /** Aggregate operation options */
 interface AggregateOptions extends ReadOptions {
   /** Allow aggregation to use disk for large sorts/groups */
@@ -840,11 +868,30 @@ interface AggregateOptions extends ReadOptions {
   maxPipelineStages?: number;
 }
 /** Lookup populate options */
+/**
+ * Mongokit's `lookupPopulate` options — kit-native superset of the
+ * portable `LookupPopulateOptions` from repo-core. Widens two slots:
+ *
+ *   - `lookups`: accepts either the portable `LookupSpec[]` (works on
+ *     every kit) or mongokit's `LookupOptions[]` (adds `pipeline` /
+ *     `let` / `sanitize` for mongo-correlated joins).
+ *   - `select`: accepts mongoose's space-separated string form
+ *     (`'name email'`) in addition to the portable array / inclusion
+ *     map. Kept for arc + existing controller convenience.
+ *
+ * For cross-kit code: type the variable as
+ * `import('@classytic/repo-core/repository').LookupPopulateOptions<TDoc>`
+ * — every kit's `lookupPopulate` accepts that shape.
+ */
 interface LookupPopulateOptions extends ReadOptions {
   /** MongoDB query filters */
   filters?: Record<string, unknown>;
-  /** Lookup configurations for $lookup joins */
-  lookups: LookupOptions[];
+  /**
+   * Portable `LookupSpec[]` (cross-kit) or mongokit-native
+   * `LookupOptions[]` (with `pipeline` / `let` / `sanitize`). The
+   * portable shape is a structural subset, so callers can mix.
+   */
+  lookups: readonly _$_classytic_repo_core_repository0.LookupSpec[] | LookupOptions[];
   /** Sort specification */
   sort?: SortSpec | string;
   /** Page number (offset mode, 1-indexed) */
@@ -860,38 +907,13 @@ interface LookupPopulateOptions extends ReadOptions {
   /** Count strategy for offset pagination */
   countStrategy?: 'exact' | 'estimated' | 'none';
 }
-/** Lookup populate result */
-interface LookupPopulateResult<T = unknown> {
-  data: T[];
-  total: number;
-  page?: number;
-  limit: number;
-  next?: string | null;
-  hasMore?: boolean;
-}
-/** Delete result */
-interface DeleteResult {
-  success: boolean;
-  message: string;
-  id?: string;
-  soft?: boolean;
-  count?: number;
-}
-/** Update many result */
-interface UpdateManyResult {
-  matchedCount: number;
-  modifiedCount: number;
-}
-/** Validation result */
-interface ValidationResult {
-  valid: boolean;
-  violations?: Array<{
-    field: string;
-    reason: string;
-  }>;
-  message?: string;
-}
-/** Update with validation result */
+/**
+ * Union emitted by the validation-chain plugin. Keeps the violation shape
+ * from `ValidationResult` without re-exporting the type — consumers that
+ * need `ValidationResult`, `CrudSchemas`, `JsonSchema`, `SchemaBuilderOptions`,
+ * `FieldRule` or `FieldRules` import them straight from
+ * `@classytic/repo-core/schema`.
+ */
 type UpdateWithValidationResult<T> = {
   success: true;
   data: T;
@@ -1021,13 +1043,13 @@ interface RepositoryInstance {
   _buildContext(operation: string, options: Record<string, unknown> | object): Promise<RepositoryContext>;
   _handleError(error: Error): HttpError;
   update(id: string | ObjectId, data: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
-  aggregate(pipeline: PipelineStage[], options?: Record<string, unknown>): Promise<unknown[]>;
+  aggregatePipeline(pipeline: PipelineStage[], options?: Record<string, unknown>): Promise<unknown[]>;
   getByQuery(query: Record<string, unknown>, options?: Record<string, unknown>): Promise<unknown>;
   _executeQuery<T>(buildQuery: (Model: Model<any>) => Promise<T>): Promise<T>;
   [key: string]: unknown;
 }
 /** Repository operation names */
-type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'restore' | 'getById' | 'getByQuery' | 'getOne' | 'getAll' | 'findAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'lookupPopulate' | 'bulkWrite';
+type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'findOneAndUpdate' | 'delete' | 'deleteMany' | 'restore' | 'getById' | 'getByQuery' | 'getOne' | 'getAll' | 'findAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'aggregatePipeline' | 'aggregatePipelinePaginate' | 'lookupPopulate' | 'bulkWrite';
 /** Event lifecycle phases */
 type EventPhase = 'before' | 'after' | 'error';
 /** Repository event names (generated from template literals) */
@@ -1065,96 +1087,6 @@ interface FieldPreset {
   /** Additional fields for admins */
   admin?: string[];
 }
-/** Field rules for schema building */
-interface FieldRules {
-  [fieldName: string]: {
-    /** Field cannot be updated */immutable?: boolean; /** Alias for immutable */
-    immutableAfterCreate?: boolean; /** System-only field (omitted from create/update) */
-    systemManaged?: boolean; /** Remove from required array */
-    optional?: boolean;
-  };
-}
-/** Schema builder options */
-interface SchemaBuilderOptions {
-  /** Field rules for create/update */
-  fieldRules?: FieldRules;
-  /** Strict additional properties (default: false) */
-  strictAdditionalProperties?: boolean;
-  /** Date format: 'date' | 'datetime' */
-  dateAs?: 'date' | 'datetime';
-  /** Create schema options */
-  create?: {
-    /** Fields to omit from create schema */omitFields?: string[]; /** Override required status */
-    requiredOverrides?: Record<string, boolean>; /** Override optional status */
-    optionalOverrides?: Record<string, boolean>; /** Schema overrides */
-    schemaOverrides?: Record<string, unknown>;
-  };
-  /**
-   * Field names to mark as soft-required: they remain in the generated body
-   * schema's `properties` (still validated when present) but are excluded
-   * from the `required[]` array so the client may omit them.
-   *
-   * Combines with per-path `softRequired: true` Mongoose schema option.
-   * Use this when the Mongoose model is owned by an upstream package and
-   * you can't annotate the schema directly.
-   *
-   * The DB-level `required: true` invariant is unaffected — Mongoose still
-   * rejects null on save. This flag only affects HTTP body validation.
-   */
-  softRequiredFields?: string[];
-  /** Update schema options */
-  update?: {
-    /** Fields to omit from update schema */omitFields?: string[]; /** Require at least one field to be provided (default: false) */
-    requireAtLeastOne?: boolean;
-  };
-  /** Query schema options */
-  query?: {
-    /** Filterable fields */filterableFields?: Record<string, {
-      type: string;
-    } | unknown>;
-  };
-  /**
-   * Emit OpenAPI vendor extensions (`x-*` keywords like `x-ref` for populated
-   * ObjectId fields). Default: `false`.
-   *
-   * Why opt-in: Ajv's strict mode THROWS on any `x-*` keyword it doesn't
-   * recognize (`strict mode: unknown keyword: "x-ref"`). Consumers validating
-   * request bodies with Ajv strict need a keyword-clean schema; consumers
-   * generating OpenAPI documentation want the vendor extensions. Default is
-   * OFF so Ajv-strict-mode consumers are safe out of the box. Turn ON to
-   * include `x-ref` etc. in the output (typically when feeding the schema
-   * into a docgen tool like @fastify/swagger or redocly).
-   */
-  openApiExtensions?: boolean;
-}
-/** JSON Schema type */
-interface JsonSchema {
-  type: string;
-  properties?: Record<string, unknown>;
-  required?: string[];
-  additionalProperties?: boolean | unknown;
-  items?: unknown;
-  enum?: string[];
-  format?: string;
-  pattern?: string;
-  minProperties?: number;
-  maxProperties?: number;
-  minLength?: number;
-  maxLength?: number;
-  minimum?: number;
-  maximum?: number;
-}
-/** CRUD schemas result - framework-agnostic JSON schemas */
-interface CrudSchemas {
-  /** JSON Schema for create request body */
-  createBody: JsonSchema;
-  /** JSON Schema for update request body */
-  updateBody: JsonSchema;
-  /** JSON Schema for route params (id validation) */
-  params: JsonSchema;
-  /** JSON Schema for list/query parameters */
-  listQuery: JsonSchema;
-}
 /** Decoded cursor */
 interface DecodedCursor {
   /** Primary sort field value (rehydrated) — legacy compat */
@@ -1173,7 +1105,7 @@ interface ValidatorDefinition {
   /** Validator name */
   name: string;
   /** Operations to apply validator to */
-  operations?: Array<'create' | 'createMany' | 'update' | 'delete'>;
+  operations?: Array<'create' | 'createMany' | 'update' | 'findOneAndUpdate' | 'delete'>;
   /** Validation function */
   validate: (context: RepositoryContext, repo?: RepositoryInstance) => void | Promise<void>;
 }
@@ -1256,15 +1188,20 @@ interface MinMaxResult {
   max: unknown;
 }
 /**
- * Cache adapter interface - bring your own cache implementation
- * Works with Redis, Memcached, in-memory, or any key-value store
+ * Cache adapter interface — bring your own cache implementation.
+ * Works with Redis, Memcached, in-memory, or any key-value store.
+ *
+ * Shape is aligned with `@classytic/repo-core/cache#CacheAdapter` and arc's
+ * `CacheStore` so one adapter implementation satisfies every consumer. The
+ * `delete` method is named for consistency with `Map.delete` / `Set.delete` /
+ * `MinimalRepo.delete(id)` — your Redis wrapper translates to `redis.del`.
  *
  * @example Redis implementation:
  * ```typescript
  * const redisCache: CacheAdapter = {
  *   async get(key) { return JSON.parse(await redis.get(key) || 'null'); },
  *   async set(key, value, ttl) { await redis.setex(key, ttl, JSON.stringify(value)); },
- *   async del(key) { await redis.del(key); },
+ *   async delete(key) { await redis.del(key); },
  *   async clear(pattern) {
  *     const keys = await redis.keys(pattern || '*');
  *     if (keys.length) await redis.del(...keys);
@@ -1277,8 +1214,8 @@ interface CacheAdapter {
   get<T = unknown>(key: string): Promise<T | null>;
   /** Set value with TTL in seconds */
   set<T = unknown>(key: string, value: T, ttl: number): Promise<void>;
-  /** Delete single key */
-  del(key: string): Promise<void>;
+  /** Delete a single key. No-op when the key doesn't exist. */
+  delete(key: string): Promise<void>;
   /** Clear keys matching pattern (optional, used for bulk invalidation) */
   clear?(pattern?: string): Promise<void>;
 }
@@ -1525,4 +1462,4 @@ type AllPluginMethods<TDoc> = {
  */
 type WithPlugins<TDoc, TRepo extends RepositoryInstance = RepositoryInstance> = TRepo & AllPluginMethods<TDoc>;
 //#endregion
-export { ReadPreferenceType as $, InferDocument as A, LookupOptions as At, NonNullableFields as B, EventPayload as C, WithPlugins as Ct, GroupResult as D, IRequestContext as Dt, FieldRules as E, IControllerResponse as Et, KeysetPaginationResult as F, PaginationConfig as G, OffsetPaginationOptions as H, Logger as I, Plugin as J, PaginationResult as K, LookupPopulateOptions as L, JsonSchema as M, KeysOfType as N, HookMode as O, IResponseFormatter as Ot, KeysetPaginationOptions as P, ReadOptions as Q, LookupPopulateResult as R, EventHandlers as S, ValidatorDefinition as St, FieldPreset as T, IController as Tt, OffsetPaginationResult as U, ObjectId as V, OperationOptions as W, PluginType as X, PluginFunction as Y, PopulateSpec as Z, CrudSchemas as _, UpdateOptions as _t, AnyDocument as a, RequiredBy as at, DeleteResult as b, ValidationChainOptions as bt, CacheOperationOptions as c, SessionOptions as ct, CacheableOptions as d, SoftDeleteRepository as dt, RepositoryContext as et, CascadeOptions as f, SortDirection as ft, CreateOptions as g, UpdateManyResult as gt, CreateInput as h, UpdateInput as ht, AllPluginMethods as i, RepositoryOptions as it, InferRawDoc as j, HttpError as k, LookupBuilder as kt, CacheOptions as l, SoftDeleteFilterMode as lt, CollationOptions as m, Strict as mt, AggregatePaginationOptions as n, RepositoryInstance as nt, AnyModel as o, SchemaBuilderOptions as ot, CascadeRelation as p, SortSpec as pt, PartialBy as q, AggregatePaginationResult as r, RepositoryOperation as rt, CacheAdapter as s, SelectSpec as st, AggregateOptions as t, RepositoryEvent as tt, CacheStats as u, SoftDeleteOptions as ut, DecodedCursor as v, UpdateWithValidationResult as vt, EventPhase as w, WithTransactionOptions as wt, DocField as x, ValidationResult as xt, DeepPartial as y, UserContext as yt, MinMaxResult as z };
+export { RepositoryContext as $, InferRawDoc as A, OffsetPaginationOptions as B, EventPhase as C, IControllerResponse as Ct, HookMode as D, LookupOptions as Dt, GroupResult as E, LookupBuilder as Et, LookupPopulateOptions as F, PartialBy as G, OperationOptions as H, LookupPopulateResult as I, PluginType as J, Plugin as K, MinMaxResult as L, KeysetPaginationOptions as M, KeysetPaginationResult as N, HttpError as O, Logger as P, ReadPreferenceType as Q, NonNullableFields as R, EventPayload as S, IController as St, FindOneAndUpdateOptions as T, IResponseFormatter as Tt, PaginationConfig as U, OffsetPaginationResult as V, PaginationResult as W, PrioritizedHook as X, PopulateSpec as Y, ReadOptions as Z, DecodedCursor as _, UserContext as _t, AnyDocument as a, SelectSpec as at, DocField as b, WithPlugins as bt, CacheOperationOptions as c, SoftDeleteOptions as ct, CacheableOptions as d, SortSpec as dt, RepositoryEvent as et, CascadeOptions as f, Strict as ft, CreateOptions as g, UpdateWithValidationResult as gt, CreateInput as h, UpdateOptions as ht, AllPluginMethods as i, RequiredBy as it, KeysOfType as j, InferDocument as k, CacheOptions as l, SoftDeleteRepository as lt, CollationOptions as m, UpdateManyResult as mt, AggregatePaginationOptions as n, RepositoryOperation as nt, AnyModel as o, SessionOptions as ot, CascadeRelation as p, UpdateInput as pt, PluginFunction as q, AggregatePaginationResult as r, RepositoryOptions as rt, CacheAdapter as s, SoftDeleteFilterMode as st, AggregateOptions as t, RepositoryInstance as tt, CacheStats as u, SortDirection as ut, DeepPartial as v, ValidationChainOptions as vt, FieldPreset as w, IRequestContext as wt, EventHandlers as x, WithTransactionOptions as xt, DeleteResult as y, ValidatorDefinition as yt, ObjectId as z };