@classytic/mongokit 3.12.0 → 3.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.12.0",
+  "version": "3.13.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -32,6 +32,14 @@
       "types": "./dist/ai/index.d.mts",
       "default": "./dist/ai/index.mjs"
     },
+    "./adapter": {
+      "types": "./dist/adapter/index.d.mts",
+      "default": "./dist/adapter/index.mjs"
+    },
+    "./better-auth": {
+      "types": "./dist/better-auth/index.d.mts",
+      "default": "./dist/better-auth/index.mjs"
+    },
     "./query/primitives/geo": {
       "types": "./dist/query/primitives/geo.d.mts",
       "default": "./dist/query/primitives/geo.mjs"
@@ -93,9 +101,15 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.3.0",
+    "@classytic/repo-core": ">=0.4.0",
+    "better-auth": ">=1.6.0",
     "mongoose": ">=9.4.1"
   },
+  "peerDependenciesMeta": {
+    "better-auth": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=22"
   },
@@ -127,13 +141,16 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
+    "@better-auth/api-key": "^1.6.9",
+    "@better-auth/mongo-adapter": "^1.6.9",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.3.0",
+    "@classytic/repo-core": "^0.4.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
+    "better-auth": "^1.6.9",
     "dotenv": "^17.4.2",
     "knip": "^6.3.0",
     "mongodb-memory-server": "^10.4.3",

package/dist/field-selection-dI0m4RBs.mjs

@@ -1,221 +0,0 @@
-//#region src/utils/cache-keys.ts
-/**
-* Simple hash function for query parameters
-* Using djb2 algorithm - fast and good distribution
-*/
-function hashString(str) {
-	let hash = 5381;
-	for (let i = 0; i < str.length; i++) hash = (hash << 5) + hash ^ str.charCodeAt(i);
-	return (hash >>> 0).toString(16);
-}
-/**
-* Normalize and stringify an object for hashing
-* Ensures deterministic key generation regardless of property order
-*/
-function stableStringify(obj) {
-	if (obj === null || obj === void 0) return "";
-	if (typeof obj !== "object") return String(obj);
-	if (Array.isArray(obj)) return `[${obj.map(stableStringify).join(",")}]`;
-	return `{${Object.keys(obj).sort().map((key) => `${key}:${stableStringify(obj[key])}`).join(",")}}`;
-}
-/**
-* Generate cache key for getById operations
-*
-* Includes select/populate/lean in the key so different query shapes
-* (e.g., plain vs populated, lean vs hydrated) never collide.
-*
-* Format: {prefix}:id:{model}:{documentId} (no options)
-* Format: {prefix}:id:{model}:{documentId}:{optionsHash} (with options)
-*
-* @example
-* byIdKey('mk', 'User', '507f1f77bcf86cd799439011')
-* // => 'mk:id:User:507f1f77bcf86cd799439011'
-* byIdKey('mk', 'User', '507f1f77bcf86cd799439011', { select: 'name email' })
-* // => 'mk:id:User:507f1f77bcf86cd799439011:a1b2c3d4'
-*/
-function byIdKey(prefix, model, id, options) {
-	const base = `${prefix}:id:${model}:${id}`;
-	if (!options || options.select == null && options.populate == null && options.lean == null) return base;
-	return `${base}:${hashString(stableStringify({
-		s: options.select,
-		p: options.populate,
-		l: options.lean
-	}))}`;
-}
-/**
-* Generate cache key for single-document queries
-*
-* Format: {prefix}:one:{model}:{queryHash}
-*
-* @example
-* byQueryKey('mk', 'User', { email: 'john@example.com' })
-* // => 'mk:one:User:a1b2c3d4'
-*/
-function byQueryKey(prefix, model, version, query, options) {
-	return `${prefix}:one:${model}:${version}:${hashString(stableStringify({
-		q: query,
-		s: options?.select,
-		p: options?.populate
-	}))}`;
-}
-/**
-* Generate cache key for paginated list queries
-*
-* Format: {prefix}:list:{model}:{version}:{queryHash}
-*
-* The version component enables efficient bulk invalidation:
-* - On any mutation, bump the version
-* - All list cache keys become invalid without scanning/deleting each
-*
-* @example
-* listQueryKey('mk', 'User', 1, { filters: { status: 'active' }, page: 1, limit: 20 })
-* // => 'mk:list:User:1:e5f6g7h8'
-*/
-function listQueryKey(prefix, model, version, params) {
-	return `${prefix}:list:${model}:${version}:${hashString(stableStringify({
-		f: params.filters,
-		s: params.sort,
-		pg: params.page,
-		lm: params.limit,
-		af: params.after,
-		sl: params.select,
-		pp: params.populate,
-		sr: params.search,
-		md: params.mode,
-		ln: params.lean,
-		rp: params.readPreference,
-		hn: params.hint,
-		mt: params.maxTimeMS,
-		cs: params.countStrategy
-	}))}`;
-}
-/**
-* Generate cache key for collection version tag
-*
-* Format: {prefix}:ver:{model}
-*
-* Used to track mutation version for list invalidation
-*/
-function versionKey(prefix, model) {
-	return `${prefix}:ver:${model}`;
-}
-/**
-* Generate pattern for clearing all cache keys for a model
-*
-* Format: {prefix}:*:{model}:*
-*
-* @example
-* modelPattern('mk', 'User')
-* // => 'mk:*:User:*'
-*/
-function modelPattern(prefix, model) {
-	return `${prefix}:*:${model}:*`;
-}
-/**
-* Generate pattern for clearing all list cache keys for a model
-*
-* Format: {prefix}:list:{model}:*
-*/
-function listPattern(prefix, model) {
-	return `${prefix}:list:${model}:*`;
-}
-//#endregion
-//#region src/utils/field-selection.ts
-/**
-* Get allowed fields for a user based on their context
-*
-* @param user - User object from request.user (or null for public)
-* @param preset - Field preset configuration
-* @returns Array of allowed field names
-*
-* @example
-* const fields = getFieldsForUser(request.user, {
-*   public: ['id', 'name', 'price'],
-*   authenticated: ['description', 'features'],
-*   admin: ['createdAt', 'internalNotes']
-* });
-*/
-function getFieldsForUser(user, preset) {
-	if (!preset) throw new Error("Field preset is required");
-	const fields = [...preset.public || []];
-	if (user) {
-		fields.push(...preset.authenticated || []);
-		const roles = Array.isArray(user.roles) ? user.roles : user.roles ? [user.roles] : [];
-		if (roles.includes("admin") || roles.includes("superadmin")) fields.push(...preset.admin || []);
-	}
-	return [...new Set(fields)];
-}
-/**
-* Get Mongoose projection string for query .select()
-*
-* @param user - User object from request.user
-* @param preset - Field preset configuration
-* @returns Space-separated field names for Mongoose .select()
-*
-* @example
-* const projection = getMongooseProjection(request.user, fieldPresets.gymPlans);
-* const plans = await GymPlan.find({ organizationId }).select(projection).lean();
-*/
-function getMongooseProjection(user, preset) {
-	return getFieldsForUser(user, preset).join(" ");
-}
-/**
-* Filter a single object to include only allowed fields
-*/
-function filterObject(obj, allowedFields) {
-	if (!obj || typeof obj !== "object" || Array.isArray(obj)) return obj;
-	const filtered = {};
-	for (const field of allowedFields) if (field in obj) filtered[field] = obj[field];
-	return filtered;
-}
-/**
-* Filter response data to include only allowed fields
-*
-* Use this for complex responses where Mongoose projections aren't applicable:
-* - Aggregation pipeline results
-* - Data from multiple sources
-* - Custom computed fields
-*
-* For simple DB queries, prefer getMongooseProjection() (10x faster)
-*
-* @param data - Data to filter
-* @param preset - Field preset configuration
-* @param user - User object from request.user
-* @returns Filtered data
-*
-* @example
-* const stats = await calculateComplexStats();
-* const filtered = filterResponseData(stats, fieldPresets.dashboard, request.user);
-* return reply.send(filtered);
-*/
-function filterResponseData(data, preset, user = null) {
-	const allowedFields = getFieldsForUser(user, preset);
-	if (Array.isArray(data)) return data.map((item) => filterObject(item, allowedFields));
-	return filterObject(data, allowedFields);
-}
-/**
-* Helper to create field presets (module-level)
-*
-* Each module should define its own field preset in its own directory.
-* This keeps modules independent and self-contained.
-*
-* @param config - Field configuration
-* @returns Field preset
-*
-* @example
-* // In modules/gym-plan/gym-plan.fields.ts
-* export const gymPlanFieldPreset = createFieldPreset({
-*   public: ['id', 'name', 'price'],
-*   authenticated: ['features', 'description'],
-*   admin: ['createdAt', 'updatedAt', 'internalNotes']
-* });
-*/
-function createFieldPreset(config) {
-	return {
-		public: config.public || [],
-		authenticated: config.authenticated || [],
-		admin: config.admin || []
-	};
-}
-//#endregion
-export { byIdKey as a, listQueryKey as c, getMongooseProjection as i, modelPattern as l, filterResponseData as n, byQueryKey as o, getFieldsForUser as r, listPattern as s, createFieldPreset as t, versionKey as u };