@zenith-open/zenithcms-types 0.1.0 → 1.0.0-beta.10

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,32 @@
+# @zenith-open/zenithcms-types
+
+The single source of truth for the Zenith CMS ecosystem architecture.
+
+## Overview
+
+This package exposes the underlying Zod interfaces and TypeScript contracts utilized by both the backend engine (`core`), the Database Adapters (`db-mongodb`, `db-postgres`), and the frontend SPA (`admin`). 
+
+By isolating all core typings into a standalone package, Zenith guarantees absolute parity between schema declaration (the backend contract) and schema consumption (the frontend UI).
+
+## Installation
+
+```bash
+pnpm add -D @zenith-open/zenithcms-types
+```
+
+## Usage
+
+When developing plugins or creating custom endpoints, always rely on the strongly typed interfaces exported by this package.
+
+```typescript
+import type { CMSConfig, CollectionSchema, Field, ZenithPlugin, PluginContext } from '@zenith-open/zenithcms-types'
+
+const myPlugin: ZenithPlugin = {
+  id: 'my-custom-plugin',
+  name: 'Enhancements',
+  version: '1.0.0',
+  apply: (config: CMSConfig) => {
+    return config;
+  }
+}
+```

package/dist/database.d.ts

@@ -14,21 +14,26 @@ export interface DatabaseAdapter {
     registerCollection(config: CollectionConfig): Promise<void>;
     /** Lists all existing collections/tables in the database */
     getExistingCollections(): Promise<string[]>;
-    find<T = unknown>(collection: string, query: Record<string, unknown>, options?: FindOptions): Promise<T[]>;
-    findOne<T = unknown>(collection: string, query: Record<string, unknown>, options?: BaseOptions): Promise<T | null>;
-    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>;
-    updateMany(collection: string, query: Record<string, unknown>, data: unknown, options?: BaseOptions): Promise<number>;
+    /** Escape hatch for bypassing the Adapter AST and executing vendor-specific queries natively */
+    getNativeClient<T = any>(): T;
+    /** Escape hatch for executing raw DDL/SQL queries directly */
+    executeRaw(query: string, params?: any[]): Promise<any>;
+    find<T = any>(collection: string, query: ZenithQueryAST, options?: FindOptions): Promise<T[]>;
+    findOne<T = any>(collection: string, query: ZenithQueryAST, options?: BaseOptions): Promise<T | null>;
+    findMany<T = any>(collection: string, ids: string[], options?: BaseOptions): Promise<T[]>;
+    create<T = any>(collection: string, data: Partial<T>, options?: BaseOptions): Promise<T>;
+    update<T = any>(collection: string, id: string, data: Partial<T>, options?: BaseOptions): Promise<T | null>;
+    updateMany(collection: string, query: ZenithQueryAST, data: any, options?: BaseOptions): Promise<number>;
     delete(collection: string, id: string, options?: BaseOptions): Promise<boolean>;
-    deleteMany(collection: string, query: Record<string, unknown>, options?: BaseOptions): Promise<number>;
-    count(collection: string, query: Record<string, unknown>): Promise<number>;
-    aggregate<T = unknown>(collection: string, pipeline: unknown[], options?: BaseOptions): Promise<T[]>;
+    deleteMany(collection: string, query: ZenithQueryAST, options?: BaseOptions): Promise<number>;
+    count(collection: string, query: ZenithQueryAST): Promise<number>;
+    aggregate<T = any>(collection: string, pipeline: any[], options?: BaseOptions): Promise<T[]>;
     /**
      * Atomically finds a single document and updates it, returning either
      * the original (returnDocument: 'before') or updated (returnDocument: 'after') document.
      * Returns null if no document matches the query.
      */
-    findOneAndUpdate<T = unknown>(collection: string, query: Record<string, unknown>, update: Record<string, unknown>, options?: BaseOptions & {
+    findOneAndUpdate<T = any>(collection: string, query: ZenithQueryAST, update: Record<string, any>, options?: BaseOptions & {
         returnDocument?: 'before' | 'after';
     }): Promise<T | null>;
     /**
@@ -36,7 +41,7 @@ export interface DatabaseAdapter {
      * If the adapter does not support transactions (e.g. standalone Mongo),
      * this will execute the function without a transaction context.
      */
-    transaction<T>(fn: (session: unknown) => Promise<T>): Promise<T>;
+    transaction<T>(fn: (session: any) => Promise<T>): Promise<T>;
     createAuditLog(data: AuditLogData, options?: BaseOptions): Promise<void>;
     createVersion(data: VersionData, options?: BaseOptions): Promise<void>;
     getVersions(collection: string, documentId: string): Promise<VersionData[]>;
@@ -47,7 +52,7 @@ export interface DatabaseAdapter {
      * Each adapter translates this into its native search primitive
      * (MongoDB $regex/$text, Postgres ILIKE/pg_trgm).
      */
-    search<T = unknown>(collection: string, query: string, fields: string[], limit?: number, options?: BaseOptions): Promise<T[]>;
+    search<T = any>(collection: string, query: string, fields: string[], limit?: number, options?: BaseOptions): Promise<T[]>;
 }
 export interface BaseOptions {
     session?: unknown;
@@ -61,6 +66,7 @@ export interface FindOptions extends BaseOptions {
     limit?: number;
     select?: string | string[];
     populate?: string | string[];
+    cursor?: string;
 }
 export interface AuditLogData {
     userId: string;
@@ -109,3 +115,27 @@ export interface WebhookDeliveryRecord {
     responseStatus?: number;
     timestamp: Date | string;
 }
+/**
+ * ZenithQueryAST Formal Specification
+ * ───────────────────────────────────
+ * Standardized cross-database query language.
+ * Currently mimics MongoDB syntax due to historical reasons,
+ * but formally documents it so adapters (e.g. Postgres) know exactly what to parse.
+ */
+export type ZenithQueryAST = {
+    $and?: ZenithQueryAST[];
+    $or?: ZenithQueryAST[];
+    [field: string]: any | {
+        $eq?: any;
+        $ne?: any;
+        $in?: any[];
+        $nin?: any[];
+        $gt?: number | Date | string;
+        $gte?: number | Date | string;
+        $lt?: number | Date | string;
+        $lte?: number | Date | string;
+        $exists?: boolean;
+        $regex?: string | RegExp;
+        $options?: string;
+    };
+};

package/dist/generated.d.ts

@@ -4,11 +4,20 @@
  * DO NOT MODIFY MANUALLY.
  */
 export interface ZenithDocument {
-    _id: string;
+    id: string;
     createdAt: string;
     updatedAt: string;
     status?: 'draft' | 'published' | 'archived' | string;
 }
+export interface ExternalUsers extends ZenithDocument {
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+export interface Media extends ZenithDocument {
+    alt: string;
+    url: string;
+}
 export interface Authors extends ZenithDocument {
     name: string;
     avatar?: {
@@ -19,17 +28,16 @@ export interface Authors extends ZenithDocument {
 }
 export interface Posts extends ZenithDocument {
     title: string;
-    coverImage?: {
-        url: string;
-        alt?: string;
-    };
-    content?: string;
+    slug: string;
+    content: string;
     publishedAt?: string | Date;
-    author?: Record<string, unknown>;
+    authors?: Users | null;
+    categories?: Categories | null;
+    status?: ('draft' | 'published');
 }
 export interface Categories extends ZenithDocument {
     title: string;
-    slug: string;
+    description?: string;
 }
 export interface Products extends ZenithDocument {
     name: string;
@@ -71,16 +79,25 @@ export interface Pages extends ZenithDocument {
         blockType: 'undefined';
     })[];
 }
-export interface AuditTarget1781217670604 extends ZenithDocument {
-    title: string;
+export interface ZRoles extends ZenithDocument {
+    roleName: string;
+    roleType: string;
+    description?: string;
+    isSystem: boolean;
+    permissions: Record<string, any>;
 }
-export interface Media extends ZenithDocument {
-    name?: string;
-    url?: string;
-    alt?: string;
-    folder?: string;
-    mimetype?: string;
-    size?: number;
+export interface ZApiKeys extends ZenithDocument {
+    name: string;
+    key: string;
+    role: string;
+    expiresAt?: string | Date;
+    revoked?: boolean;
+    lastUsed?: string | Date;
+    allowedCollections?: Record<string, any>;
+}
+export interface Users extends ZenithDocument {
+    name: string;
+    role: ('admin' | 'editor' | 'user');
 }
 export interface SiteSettings extends ZenithDocument {
     siteName: string;
@@ -115,13 +132,16 @@ export interface SiteSettings extends ZenithDocument {
     }[];
 }
 export interface ZenithCollections {
+    'external_users': ExternalUsers;
+    'media': Media;
     'authors': Authors;
     'posts': Posts;
     'categories': Categories;
     'products': Products;
     'pages': Pages;
-    'audit-target-1781217670604': AuditTarget1781217670604;
-    'media': Media;
+    'z_roles': ZRoles;
+    'z_api_keys': ZApiKeys;
+    'users': Users;
     'site-settings': SiteSettings;
 }
 /**

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  * Uses Discriminated Unions for robust field-level validation and IntelliSense.
  */
 import type React from 'react';
+export * from './generated';
 export interface ZenithDocument {
     _id?: string;
     id?: string;
@@ -181,6 +182,24 @@ export interface CollectionConfig {
         plural: string;
     };
     fields: FieldConfig[];
+    federation?: {
+        enabled: boolean;
+        provider: 'rest' | 'graphql' | 'custom';
+        endpoint: string;
+        headers?: Record<string, string>;
+        methods?: {
+            find?: string;
+            findById?: string;
+            create?: string;
+            update?: string;
+            delete?: string;
+        };
+        mapping?: {
+            id?: string;
+            results?: string;
+            total?: string;
+        };
+    };
     drafts?: boolean;
     seo?: boolean;
     timestamps?: boolean;
@@ -217,6 +236,11 @@ export interface CollectionConfig {
         }) => unknown | Promise<unknown>;
         afterError?: (error: Error, data: unknown, user: unknown) => void | Promise<void>;
     };
+    endpoints?: Array<{
+        path: string;
+        method: 'get' | 'post' | 'put' | 'patch' | 'delete';
+        handler: (req: any, res: any, next: any) => void | Promise<void>;
+    }>;
     access?: {
         /** Return false to deny, or an object to merge as query constraints (Row-Level Security). */
         read?: (user: unknown, context?: {
@@ -244,11 +268,6 @@ export interface CollectionConfig {
         icon?: string;
         previewUrl?: string | ((doc: unknown) => string);
     };
-    endpoints?: {
-        path: string;
-        method: 'get' | 'post' | 'put' | 'delete' | 'patch';
-        handler: (req: unknown, res: unknown) => void | Promise<void>;
-    }[];
 }
 export type GlobalConfig = CollectionConfig;
 export interface ZenithPlugin {
@@ -292,6 +311,19 @@ export interface ZenithPlugin {
      * Called at engine bootstrap for each enabled plugin.
      */
     apply: (config: CMSConfig, pluginConfig?: Record<string, unknown>) => CMSConfig | void;
+    /**
+     * Express sub-router for this plugin.
+     * It will be mounted automatically at `/api/v1/plugins/{plugin.id}`
+     */
+    router?: (app: any) => void;
+    /** Custom collection-level hooks provided by this plugin */
+    hooks?: {
+        [collectionSlug: string]: CollectionConfig['hooks'];
+    };
+    /** Paths to custom React admin UI components (e.g. custom field UIs) */
+    adminComponents?: {
+        [fieldType: string]: string;
+    };
     /** Called after all plugins are applied, before routes are mounted */
     onInit?: (ctx: PluginContext) => void | Promise<void>;
     /** Called after the engine is fully started and listening */
@@ -348,6 +380,11 @@ export interface CMSConfig {
     cors?: {
         origins: string[];
     };
+    endpoints?: Array<{
+        path: string;
+        method: 'get' | 'post' | 'put' | 'patch' | 'delete';
+        handler: (req: any, res: any, next: any) => void | Promise<void>;
+    }>;
 }
 export * from './generated';
 export * from './database';

package/dist/index.js

@@ -5,5 +5,6 @@
  * Uses Discriminated Unions for robust field-level validation and IntelliSense.
  */
 export * from './generated';
+export * from './generated';
 export * from './database';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmXH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,aAAa,CAAA;AAkZ3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/package.json

@@ -1,16 +1,22 @@
-{
-  "name": "@zenith-open/zenithcms-types",
-  "version": "0.1.0",
-  "publishConfig": {
-    "access": "public"
-  },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "lint": "echo 'Lint bypassed for types'"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0"
-  }
-}
+{
+  "name": "@zenith-open/zenithcms-types",
+  "version": "1.0.0-beta.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "react": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "echo 'Lint bypassed for types'"
+  }
+}

package/src/database.d.ts

@@ -1,84 +0,0 @@
-import { CollectionConfig } from './index';
-/**
- * Zenith Database Adapter Contract
- * ────────────────────────────────
- * Hardened interface for database agnostic operations.
- * Use generics <T> to ensure type safety in higher level services.
- */
-export interface DatabaseAdapter {
-    name: string;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    getHealth(): 'ok' | 'connecting' | 'disconnected' | 'error';
-    /** Syncs the provided collection config with the physical DB schema */
-    registerCollection(config: CollectionConfig): Promise<void>;
-    /** Lists all existing collections/tables in the database */
-    getExistingCollections(): Promise<string[]>;
-    find<T = unknown>(collection: string, query: Record<string, unknown>, options?: FindOptions): Promise<T[]>;
-    findOne<T = unknown>(collection: string, query: Record<string, unknown>, options?: BaseOptions): Promise<T | null>;
-    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>;
-    updateMany(collection: string, query: Record<string, unknown>, data: unknown, options?: BaseOptions): Promise<number>;
-    delete(collection: string, id: string, options?: BaseOptions): Promise<boolean>;
-    deleteMany(collection: string, query: Record<string, unknown>, options?: BaseOptions): Promise<number>;
-    count(collection: string, query: Record<string, unknown>): Promise<number>;
-    aggregate<T = unknown>(collection: string, pipeline: unknown[]): Promise<T[]>;
-    /**
-     * Executes multiple operations in a transaction.
-     * If the adapter does not support transactions (e.g. standalone Mongo),
-     * this will execute the function without a transaction context.
-     */
-    transaction<T>(fn: (session: unknown) => Promise<T>): Promise<T>;
-    createAuditLog(data: AuditLogData): Promise<void>;
-    createVersion(data: VersionData): Promise<void>;
-    getVersions(collection: string, documentId: string): Promise<VersionData[]>;
-    createWebhookDelivery(data: WebhookDeliveryData): Promise<void>;
-    /**
-     * Full-text / pattern search across specified fields in a collection.
-     * Each adapter translates this into its native search primitive
-     * (MongoDB $regex/$text, Postgres ILIKE/pg_trgm).
-     */
-    search<T = unknown>(collection: string, query: string, fields: string[], limit?: number, options?: BaseOptions): Promise<T[]>;
-}
-export interface BaseOptions {
-    session?: unknown;
-    tenantId?: string;
-    siteId?: string;
-}
-export interface FindOptions extends BaseOptions {
-    sort?: string | Record<string, unknown>;
-    skip?: number;
-    limit?: number;
-    select?: string | string[];
-    populate?: string | string[];
-}
-export interface AuditLogData {
-    userId: string;
-    userEmail: string;
-    action: string;
-    collectionName: string;
-    documentId?: string;
-    changes?: unknown;
-    ip?: string;
-    userAgent?: string;
-    timestamp?: Date;
-}
-export interface VersionData {
-    collectionName: string;
-    collectionSlug: string;
-    documentId: string;
-    snapshot: unknown;
-    delta?: unknown;
-    createdBy: string;
-    timestamp: Date;
-}
-export interface WebhookDeliveryData {
-    collectionSlug?: string;
-    event: string;
-    url: string;
-    payload?: unknown;
-    success: boolean;
-    responseStatus?: number;
-    timestamp?: Date;
-}
-

package/src/database.js

@@ -1 +0,0 @@
-// Database types module (interfaces only)

package/src/database.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["database.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAA;AAgIvB,MAAM,OAAO,mBAAmB;IAGV;IAFZ,YAAY,CAAS;IAE7B,YAAoB,cAA+B;QAA/B,mBAAc,GAAd,cAAc,CAAiB;QACjD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;IAC3D,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,UAAkB,EAClB,KAA8B,EAC9B,OAAqB;QAErB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC5E,oEAAoE;gBACpE,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;gBAC/E,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,WAAW,UAAU,CAAC,CAAA;gBAC5D,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,cAAc,GAAG,IAAI,CAAC,cAAqB,CAAA;oBACjD,MAAM,QAAQ,GAAG,CAAC,OAAO,cAAc,CAAC,WAAW,KAAK,UAAU,CAAC;wBACjE,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC;wBACrC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAA;oBACrB,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAA;oBACvD,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;gBAC5D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAI,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACtE,CAAC;IAEM,KAAK,CAAC,MAAM,CAAc,UAAkB,EAAE,IAAgB,EAAE,OAAqB;QAC1F,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC5E,oEAAoE;gBACpE,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAA;gBAC/E,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,WAAW,UAAU,CAAC,CAAA;gBAC/D,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,cAAc,GAAG,IAAI,CAAC,cAAqB,CAAA;oBACjD,MAAM,QAAQ,GAAG,CAAC,OAAO,cAAc,CAAC,WAAW,KAAK,UAAU,CAAC;wBACjE,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC;wBACrC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAA;oBACrB,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAA;oBACvD,OAAO,MAAM,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBAC5D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2CAA2C;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAI,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;IACvE,CAAC;CACF"}

package/src/database.ts

@@ -1,164 +0,0 @@
-import { CollectionConfig } from './index'
-
-/**
- * Zenith Database Adapter Contract
- * ────────────────────────────────
- * Hardened interface for database agnostic operations.
- * Use generics <T> to ensure type safety in higher level services.
- */
-export interface DatabaseAdapter {
-  name: string
-
-  // ── Initialization ────────────────────────────────────────────────────────
-  connect(): Promise<void>
-  disconnect(): Promise<void>
-  getHealth(): 'ok' | 'connecting' | 'disconnected' | 'error'
-
-  // ── Schema Management ─────────────────────────────────────────────────────
-  /** Syncs the provided collection config with the physical DB schema */
-  registerCollection(config: CollectionConfig): Promise<void>
-  
-  /** Lists all existing collections/tables in the database */
-  getExistingCollections(): Promise<string[]>
-
-  // ── CRUD Operations ───────────────────────────────────────────────────────
-  find<T = unknown>(
-    collection: string,
-    query: Record<string, unknown>,
-    options?: FindOptions
-  ): Promise<T[]>
-  findOne<T = unknown>(
-    collection: string,
-    query: Record<string, unknown>,
-    options?: BaseOptions
-  ): Promise<T | null>
-  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>
-  updateMany(
-    collection: string,
-    query: Record<string, unknown>,
-    data: unknown,
-    options?: BaseOptions
-  ): Promise<number>
-  delete(collection: string, id: string, options?: BaseOptions): Promise<boolean>
-  deleteMany(
-    collection: string,
-    query: Record<string, unknown>,
-    options?: BaseOptions
-  ): Promise<number>
-
-  // ── Advanced Operations ───────────────────────────────────────────────────
-  count(collection: string, query: Record<string, unknown>): Promise<number>
-  aggregate<T = unknown>(collection: string, pipeline: unknown[], options?: BaseOptions): Promise<T[]>
-
-  /**
-   * Atomically finds a single document and updates it, returning either
-   * the original (returnDocument: 'before') or updated (returnDocument: 'after') document.
-   * Returns null if no document matches the query.
-   */
-  findOneAndUpdate<T = unknown>(
-    collection: string,
-    query: Record<string, unknown>,
-    update: Record<string, unknown>,
-    options?: BaseOptions & { returnDocument?: 'before' | 'after' }
-  ): Promise<T | null>
-
-  /**
-   * Executes multiple operations in a transaction.
-   * If the adapter does not support transactions (e.g. standalone Mongo),
-   * this will execute the function without a transaction context.
-   */
-  transaction<T>(fn: (session: unknown) => Promise<T>): Promise<T>
-
-  // ── Zenith Engine Features ────────────────────────────────────────────────
-  createAuditLog(data: AuditLogData, options?: BaseOptions): Promise<void>
-  createVersion(data: VersionData, options?: BaseOptions): Promise<void>
-  getVersions(collection: string, documentId: string): Promise<VersionData[]>
-  createWebhookDelivery(data: WebhookDeliveryData): Promise<void>
-  getWebhookDeliveries(webhookId: string, limit?: number): Promise<WebhookDeliveryRecord[]>
-
-  /**
-   * Full-text / pattern search across specified fields in a collection.
-   * Each adapter translates this into its native search primitive
-   * (MongoDB $regex/$text, Postgres ILIKE/pg_trgm).
-   */
-  search<T = unknown>(
-    collection: string,
-    query: string,
-    fields: string[],
-    limit?: number,
-    options?: BaseOptions
-  ): Promise<T[]>
-}
-
-export interface BaseOptions {
-  session?: unknown
-  tenantId?: string
-  siteId?: string
-  expectedVersion?: number
-}
-
-export interface FindOptions extends BaseOptions {
-  sort?: string | Record<string, unknown>
-  skip?: number
-  limit?: number
-  select?: string | string[]
-  populate?: string | string[]
-}
-
-export interface AuditLogData {
-  userId: string
-  userEmail: string
-  userName?: string
-  action: string
-  collectionName: string
-  documentId?: string
-  changes?: unknown
-  ip?: string
-  userAgent?: string
-  timestamp?: Date
-  status?: 'success' | 'failed'
-  resource?: string
-  siteId?: string
-  hash?: string
-  previousHash?: string
-}
-
-export interface VersionData {
-  collectionName: string
-  collectionSlug: string
-  documentId: string
-  snapshot: unknown
-  delta?: unknown
-  createdBy: string
-  timestamp: Date
-}
-
-export interface WebhookDeliveryData {
-  webhookId?: string
-  collectionSlug?: string
-  event: string
-  url: string
-  payload?: unknown
-  success: boolean
-  responseStatus?: number
-  timestamp?: Date
-}
-
-export interface WebhookDeliveryRecord {
-  id: string
-  webhookId?: string
-  collectionSlug?: string
-  event: string
-  url: string
-  payload?: unknown
-  success: boolean
-  responseStatus?: number
-  timestamp: Date | string
-}
-