@classytic/mongokit 3.5.5 → 3.6.0

package/dist/query/primitives/coercion.d.mts

@@ -1,2 +1,2 @@
-import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-01tEHsKF.mjs";
+import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-B19MD38s.mjs";
 export { FieldType, SchemaPathsLike, buildFieldTypeMap, coerceFieldValue, coerceHeuristic, coerceToType, normalizeMongooseType };

package/dist/query/primitives/coercion.mjs

@@ -1,3 +1,4 @@
+import { n as isObjectIdInstance } from "../../id-resolution-LZ-cCwR5.mjs";
 import mongoose from "mongoose";
 //#region src/query/primitives/coercion.ts
 /**
@@ -39,10 +40,10 @@ function normalizeMongooseType(schemaType) {
 		case "Number": return "number";
 		case "Boolean": return "boolean";
 		case "Date": return "date";
-		case "ObjectID":
-		case "ObjectId": return "objectid";
 		case "Mixed": return "mixed";
-		default: return null;
+		default:
+			if (isObjectIdInstance(raw)) return "objectid";
+			return null;
 	}
 }
 /**

package/dist/query/primitives/indexes.d.mts

@@ -1,2 +1,2 @@
-import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-CiIT-Zli.mjs";
+import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-qIBCZ3mY.mjs";
 export { IndexableSchema, SchemaIndexes, extractSchemaIndexes };

package/dist/{types-CWUL0yiw.d.mts → types-DiQfDesD.d.mts}

@@ -928,6 +928,17 @@ interface RepositoryContext {
   softDeleted?: boolean;
   /** Include soft-deleted documents in queries */
   includeDeleted?: boolean;
+  /**
+   * Caller-requested delete semantics, read by softDeletePlugin.
+   *
+   * - `undefined` (default) — plugin decides: soft if wired, hard otherwise.
+   * - `'hard'` — bypass soft-delete and physically remove the document.
+   *   All policy hooks (multi-tenant scope, audit trails, cache invalidation)
+   *   still fire; only the soft-delete interception is skipped.
+   * - `'soft'` — reserved. Currently treated as default since softDeletePlugin
+   *   is the only source of soft semantics.
+   */
+  deleteMode?: 'hard' | 'soft';
   /** Skip cache for this operation */
   skipCache?: boolean;
   /** Custom TTL for this operation (seconds) */
@@ -982,7 +993,7 @@ interface RepositoryInstance {
   [key: string]: unknown;
 }
 /** Repository operation names */
-type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'getById' | 'getByQuery' | 'getOne' | 'getAll' | 'findAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'lookupPopulate' | 'bulkWrite';
+type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'restore' | 'getById' | 'getByQuery' | 'getOne' | 'getAll' | 'findAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'lookupPopulate' | 'bulkWrite';
 /** Event lifecycle phases */
 type EventPhase = 'before' | 'after' | 'error';
 /** Repository event names (generated from template literals) */
@@ -1263,8 +1274,23 @@ interface CacheStats {
 }
 /** Cascade relation definition */
 interface CascadeRelation {
-  /** Model name to cascade delete to */
-  model: string;
+  /**
+   * Preferred: a Repository instance for the target collection. When present,
+   * cascade routes deletes through `repo.delete` / `repo.deleteMany`, so the
+   * target's `before:delete` / `before:deleteMany` hooks fire — meaning
+   * multi-tenant scoping, audit logging, cache invalidation, and the target's
+   * own soft-delete plugin (with its configured `deletedField`) all run
+   * correctly. Strongly recommended for any target that has policy plugins.
+   */
+  repo?: RepositoryInstance;
+  /**
+   * Legacy: a Mongoose model name. When set without `repo`, cascade writes
+   * directly via `RelatedModel.updateMany` / `RelatedModel.deleteMany`. This
+   * path bypasses the target's hooks — it will NOT enforce tenant scoping,
+   * fire audit events, or honor a custom `deletedField`. Only safe for
+   * trivial targets with no policy plugins. Prefer `repo` for new code.
+   */
+  model?: string;
   /** Foreign key field in the related model that references the deleted document */
   foreignKey: string;
   /** Whether to use soft delete if available (default: follows parent behavior) */

package/dist/utils/index.d.mts

@@ -1,5 +1,5 @@
-import { Z as PopulateSpec, pt as SortSpec, st as SelectSpec } from "../types-CWUL0yiw.mjs";
-import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "../mongooseToJsonSchema-BlDfbg_0.mjs";
+import { Z as PopulateSpec, pt as SortSpec, st as SelectSpec } from "../types-DiQfDesD.mjs";
+import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "../mongooseToJsonSchema-D2YjHo7W.mjs";
 
 //#region src/utils/cache-keys.d.ts
 /**
@@ -89,4 +89,61 @@ declare function modelPattern(prefix: string, model: string): string;
  */
 declare function listPattern(prefix: string, model: string): string;
 //#endregion
-export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, byIdKey, byQueryKey, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSystemManagedFields, isFieldUpdateAllowed, listPattern, listQueryKey, modelPattern, validateUpdateBody, versionKey };
+//#region src/utils/id-resolution.d.ts
+/**
+ * ID Resolution Primitive
+ *
+ * Pure functions for detecting a Mongoose schema's _id type and validating
+ * id values against it. Used by Repository.getById to decide whether to
+ * run ObjectId validation (for ObjectId schemas) or skip it (for String /
+ * Number / UUID schemas).
+ *
+ * Also usable standalone — Arc controllers, custom repositories, migration
+ * scripts, or test harnesses can import these directly to make the same
+ * decision without depending on Repository.
+ *
+ * Design: no `this`, no Model, no DB calls. Only reads `schema.paths._id.instance`.
+ */
+/** Normalized _id type — covers the common Mongoose _id declarations */
+type IdType = 'objectid' | 'string' | 'number' | 'uuid' | 'unknown';
+/**
+ * Check if a Mongoose SchemaType `instance` string is an ObjectId variant.
+ * Mongoose 9.x uses `'ObjectId'`, older versions use `'ObjectID'`. This
+ * is the single source of truth — use it instead of inline
+ * `instance === 'ObjectId' || instance === 'ObjectID'` checks.
+ */
+declare function isObjectIdInstance(instance: string | undefined): boolean;
+/** Minimal structural type for schema introspection (decoupled from Mongoose version) */
+interface SchemaLike {
+  paths?: Record<string, {
+    instance?: string;
+  }>;
+}
+/**
+ * Detect the _id path type from a Mongoose schema.
+ *
+ * Returns 'objectid' as the safe default when:
+ *   - No schema is provided (mock models, test harnesses)
+ *   - The schema has no `paths._id` (auto-generated ObjectId)
+ *   - The instance string is unrecognized
+ *
+ * This safe-default means existing callers that don't set _id explicitly
+ * get the same ObjectId validation they always had — the behavioral change
+ * is strictly opt-in via schema declaration.
+ */
+declare function getSchemaIdType(schema?: SchemaLike | null): IdType;
+/**
+ * Validate an id value against a known _id type — WITHOUT hitting the DB.
+ *
+ * Returns `true` when the value is structurally valid for the given type.
+ * Returns `false` when it's definitely invalid (Repository should return
+ * 404 / null immediately rather than wasting a round-trip).
+ *
+ * For `'string'` and `'unknown'` types, validation is intentionally
+ * permissive: any truthy, non-empty value is accepted. The DB is the
+ * authority for whether the document exists — we only reject values that
+ * are structurally impossible (null, undefined, empty string).
+ */
+declare function isValidIdForType(id: unknown, idType: IdType): boolean;
+//#endregion
+export { type IdType, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, byIdKey, byQueryKey, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSchemaIdType, getSystemManagedFields, isFieldUpdateAllowed, isObjectIdInstance, isValidIdForType, listPattern, listQueryKey, modelPattern, validateUpdateBody, versionKey };

package/dist/utils/index.mjs

@@ -1,4 +1,5 @@
 import { r as configureLogger, t as createError } from "../error-Bpbi_NKo.mjs";
-import { a as byIdKey, c as listQueryKey, i as getMongooseProjection, l as modelPattern, n as filterResponseData, o as byQueryKey, r as getFieldsForUser, s as listPattern, t as createFieldPreset, u as versionKey } from "../field-selection-reyDRzXf.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-DpjhFfaO.mjs";
-export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, byIdKey, byQueryKey, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSystemManagedFields, isFieldUpdateAllowed, listPattern, listQueryKey, modelPattern, validateUpdateBody, versionKey };
+import { n as isObjectIdInstance, r as isValidIdForType, t as getSchemaIdType } from "../id-resolution-LZ-cCwR5.mjs";
+import { a as byIdKey, c as listQueryKey, i as getMongooseProjection, l as modelPattern, n as filterResponseData, o as byQueryKey, r as getFieldsForUser, s as listPattern, t as createFieldPreset, u as versionKey } from "../field-selection-C5o7jyyA.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-8Cyu3NFJ.mjs";
+export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, byIdKey, byQueryKey, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getImmutableFields, getMongooseProjection, getSchemaIdType, getSystemManagedFields, isFieldUpdateAllowed, isObjectIdInstance, isValidIdForType, listPattern, listQueryKey, modelPattern, validateUpdateBody, versionKey };