@zenith-open/zenithcms-db-mongodb 0.1.0 → 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aman T Shekar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,31 @@
+# @zenith-open/zenithcms-db-mongodb
+
+The officially supported MongoDB persistence adapter for Zenith CMS.
+
+## Overview
+
+Zenith CMS decouples business logic from database interactions via the `DatabaseAdapter` interface. This package implements that interface using Mongoose, dynamically translating your `cms.config.ts` into native Mongoose Schemas.
+
+## Installation
+
+```bash
+pnpm add @zenith-open/zenithcms-db-mongodb
+```
+
+## Usage
+
+When booting the `ZenithEngine`, pass an instance of the `MongooseAdapter`.
+
+```typescript
+import { ZenithEngine } from '@zenith-open/zenithcms-core'
+import { MongooseAdapter } from '@zenith-open/zenithcms-db-mongodb'
+import config from './cms.config'
+
+const engine = new ZenithEngine({
+  config,
+  adapter: new MongooseAdapter({ uri: process.env.MONGODB_URI }),
+  port: 3000
+})
+
+engine.start()
+```

package/dist/MongooseAdapter.d.ts

@@ -1,23 +1,4 @@
 import { CollectionConfig, DatabaseAdapter, FindOptions, BaseOptions, AuditLogData, VersionData, WebhookDeliveryData, WebhookDeliveryRecord } from '@zenith-open/zenithcms-types';
-export interface CacheLayer {
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, collection: string): Promise<void>;
-    invalidate(collection: string): Promise<void>;
-}
-export declare class LocalCacheLayer implements CacheLayer {
-    private cache;
-    constructor();
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, collection: string): Promise<void>;
-    invalidate(collection: string): Promise<void>;
-}
-export declare class RedisCacheLayer implements CacheLayer {
-    private redis;
-    constructor(redisUrl: string);
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, collection: string): Promise<void>;
-    invalidate(collection: string): Promise<void>;
-}
 /**
  * Mongoose Database Adapter — Hardened Edition
  * ──────────────────────────────────────────
@@ -29,7 +10,14 @@ export declare class MongooseAdapter implements DatabaseAdapter {
     name: string;
     private models;
     private cache;
+    private consecutiveFailures;
+    private circuitBreakerCooldown;
+    private readonly CIRCUIT_BREAKER_THRESHOLD;
+    private readonly CIRCUIT_BREAKER_RESET_TIMEOUT_MS;
+    private _withCircuitBreaker;
     constructor(uri: string);
+    getNativeClient<T = any>(): T;
+    executeRaw(query: string, params?: any[]): Promise<any>;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     getHealth(): 'ok' | 'connecting' | 'disconnected' | 'error';
@@ -40,6 +28,7 @@ export declare class MongooseAdapter implements DatabaseAdapter {
     private _getCacheKey;
     find<T = unknown>(collection: string, query: Record<string, unknown>, options?: FindOptions): Promise<T[]>;
     findOne<T = unknown>(collection: string, query: Record<string, unknown>, options?: FindOptions): Promise<T | null>;
+    findMany<T = unknown>(collection: string, ids: string[], options?: BaseOptions): Promise<T[]>;
     private _invalidateCache;
     create<T = unknown>(collection: string, data: Partial<T>, options?: BaseOptions): Promise<T>;
     update<T = unknown>(collection: string, id: string, data: Partial<T>, options?: BaseOptions): Promise<T | null>;