@classytic/mongokit 3.17.0 → 3.18.0

package/README.md

@@ -17,7 +17,7 @@ Requirements:
 
 - Node.js `>=22`
 - Mongoose `>=9.4.1`
-- `@classytic/repo-core >=0.6.0`
+- `@classytic/repo-core >=0.7.0`
 
 ## Quick Start
 
@@ -237,6 +237,7 @@ Supports common URL operators such as `_gt`, `_gte`, `_lt`, `_lte`, `_in`, `_nin
 | `mongoOperationsPlugin` | Hook-routed Mongo update helpers |
 | `aggregateHelpersPlugin` | Common aggregation helpers |
 | `subdocumentPlugin` | Nested array document helpers |
+| `changeLogPlugin` | Durable per-doc change feed (`@classytic/repo-core/sync`) for offline-first pull/push and replicas |
 
 Import only the plugins you use.
 

package/dist/plugins/index.d.mts

@@ -1,2 +1,18 @@
+import { G as Plugin } from "../types-CU3SEDbD.mjs";
 import { $ as AuditEntry, B as IdGenerator, C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, F as MultiTenantOptions, G as getNextSequence, H as SequentialIdOptions, J as CacheAdapter, K as prefixedId, L as multiTenantPlugin, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, Q as cachePlugin, R as CustomIdOptions, S as LeaseMethods, T as fieldFilterPlugin, U as customIdPlugin, V as PrefixedIdOptions, W as dateSequentialId, X as RepositoryCacheHandle, Y as CacheOptions, Z as RepositoryCachePluginOptions, _ as observabilityPlugin, a as uniqueField, at as AuditTrailQuery, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, et as AuditOperation, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, it as AuditTrailOptions, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, nt as AuditQueryResult, o as validationChainPlugin, ot as auditTrailPlugin, p as SoftDeleteMethods, q as sequentialId, r as immutableField, rt as AuditTrailMethods, s as timestampPlugin, t as autoInject, tt as AuditQueryOptions, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as DateSequentialIdOptions } from "../validation-chain.plugin-BpMfy18N.mjs";
-export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type LeaseMethods, type LeasePluginOptions, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, 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, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+import { ChangeLogStore } from "@classytic/repo-core/sync";
+
+//#region src/plugins/change-log.plugin.d.ts
+interface ChangeLogPluginOptions {
+  /** Durable feed implementing the repo-core/sync contract. */
+  store: ChangeLogStore;
+  /** Logical scope for entries (resource name a client subscribes to). */
+  scope: string;
+  /** Tenant partition field on docs/context. Default `organizationId`. */
+  tenantField?: string;
+  /** Monotonic per-doc version field. Default `version` (kernel convention). */
+  versionField?: string;
+}
+declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
+//#endregion
+export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type LeaseMethods, type LeasePluginOptions, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,2 +1,72 @@
 import { A as auditLogPlugin, C as getNextSequence, D as batchOperationsPlugin, E as cachePlugin, O as AuditTrailQuery, S as dateSequentialId, T as sequentialId, _ as softDeletePlugin, a as uniqueField, b as methodRegistryPlugin, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, g as timestampPlugin, h as aggregateHelpersPlugin, i as requireField, k as auditTrailPlugin, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin, w as prefixedId, x as customIdPlugin, y as multiTenantPlugin } from "../validation-chain.plugin-DJtC0KJ-.mjs";
-export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+//#region src/plugins/change-log.plugin.ts
+const PLUGIN_NAME = "changeLog";
+function isSkipped(context) {
+	const list = context.skipPlugins;
+	return Array.isArray(list) && list.includes(PLUGIN_NAME);
+}
+function changeLogPlugin(options) {
+	const { store, scope, tenantField = "organizationId", versionField = "version" } = options;
+	const toRecord = (doc) => {
+		if (!doc || typeof doc !== "object") return null;
+		const d = doc;
+		return typeof d.toObject === "function" ? d.toObject() : doc;
+	};
+	const versionOf = (doc) => {
+		const v = doc[versionField] ?? doc.__v;
+		if (typeof v === "number") return v;
+		const updatedAt = doc.updatedAt;
+		return updatedAt instanceof Date ? updatedAt.getTime() : 0;
+	};
+	const tenantOf = (doc, context) => {
+		const raw = doc[tenantField] ?? context.organizationId;
+		return raw === void 0 || raw === null ? void 0 : String(raw);
+	};
+	const capture = async (op, doc, context) => {
+		const record = toRecord(doc);
+		if (!record || record._id === void 0) return;
+		const tenantId = tenantOf(record, context);
+		await store.append({
+			scope,
+			docId: String(record._id),
+			op,
+			version: versionOf(record),
+			...op === "upsert" ? { doc: record } : {},
+			...tenantId !== void 0 ? { tenantId } : {}
+		}, context.session !== void 0 ? { session: context.session } : void 0);
+	};
+	return {
+		name: PLUGIN_NAME,
+		apply(repo) {
+			repo.on("after:create", async ({ context, result }) => {
+				if (isSkipped(context) || !result) return;
+				await capture("upsert", result, context);
+			});
+			repo.on("after:createMany", async ({ context, result }) => {
+				if (isSkipped(context) || !Array.isArray(result)) return;
+				for (const doc of result) await capture("upsert", doc, context);
+			});
+			repo.on("after:update", async ({ context, result }) => {
+				if (isSkipped(context) || !result) return;
+				await capture("upsert", result, context);
+			});
+			repo.on("after:delete", async ({ context, result }) => {
+				if (isSkipped(context) || !result) return;
+				const summary = result;
+				const ctxId = context.id;
+				const docId = summary.id ?? ctxId;
+				if (docId === void 0 || docId === null) return;
+				const tenantRaw = context.organizationId;
+				await store.append({
+					scope,
+					docId: String(docId),
+					op: "delete",
+					version: 0,
+					...tenantRaw !== void 0 && tenantRaw !== null ? { tenantId: String(tenantRaw) } : {}
+				}, context.session !== void 0 ? { session: context.session } : void 0);
+			});
+		}
+	};
+}
+//#endregion
+export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.17.0",
+  "version": "3.18.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -105,7 +105,7 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.6.0",
+    "@classytic/repo-core": ">=0.7.0",
     "better-auth": ">=1.6.0",
     "mongoose": ">=9.4.1"
   },
@@ -117,6 +117,9 @@
   "engines": {
     "node": ">=22"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
@@ -138,7 +141,7 @@
     "publish:dry": "npm publish --dry-run --access public",
     "publish:npm": "npm publish --access public",
     "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
-    "release": "npm run push -- main && npm run release:tag && npm publish",
+    "release": "npm run push -- main && npm run release:tag && npm publish --access public",
     "release:patch": "npm version patch && npm run release",
     "release:minor": "npm version minor && npm run release",
     "release:major": "npm version major && npm run release"
@@ -149,7 +152,7 @@
     "@better-auth/mongo-adapter": "^1.6.22",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "0.6.0",
+    "@classytic/repo-core": "^0.7.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.4",
     "ajv": "^8.18.0",
@@ -157,6 +160,7 @@
     "better-auth": "^1.6.22",
     "dotenv": "^17.4.2",
     "knip": "^6.3.0",
+    "mongodb": "7.2.0",
     "mongodb-memory-server": "^10.4.3",
     "mongoose": "^9.4.1",
     "publint": "^0.3.18",