@zenith-open/zenithcms-db-postgres 0.1.0 → 1.0.0-beta.1

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-postgres
+
+The officially supported PostgreSQL persistence adapter for Zenith CMS, utilizing the Drizzle ORM layer.
+
+## Overview
+
+Zenith CMS decouples business logic from database interactions via the `DatabaseAdapter` interface. This package implements that interface using Drizzle ORM, automatically mapping your `cms.config.ts` into strongly typed, highly optimized PostgreSQL tables.
+
+## Installation
+
+```bash
+pnpm add @zenith-open/zenithcms-db-postgres
+```
+
+## Usage
+
+When booting the `ZenithEngine`, pass an instance of the `PostgresAdapter`.
+
+```typescript
+import { ZenithEngine } from '@zenith-open/zenithcms-core'
+import { PostgresAdapter } from '@zenith-open/zenithcms-db-postgres'
+import config from './cms.config'
+
+const engine = new ZenithEngine({
+  config,
+  adapter: new PostgresAdapter({ uri: process.env.POSTGRES_URI }),
+  port: 3000
+})
+
+engine.start()
+```

package/dist/PostgresDrizzleAdapter.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>;
-}
 import { NodePgDatabase } from 'drizzle-orm/node-postgres';
 /**
  * PostgreSQL Database Adapter with Drizzle ORM
@@ -47,6 +28,8 @@ export declare class PostgresDrizzleAdapter implements DatabaseAdapter {
      */
     runWithTenantContext<T>(siteId: string | undefined, operation: (tx: any) => Promise<T>): Promise<T>;
     registerTenant(tenantId: string, tenantConnectionString: string): Promise<void>;
+    getNativeClient<T = any>(): T;
+    executeRaw(query: string, params?: any[]): Promise<any>;
     private getDbClient;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
@@ -66,6 +49,7 @@ export declare class PostgresDrizzleAdapter implements DatabaseAdapter {
     private mapAstToDrizzle;
     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?: FindOptions): Promise<T[]>;
     /**
      * Builds a Drizzle select query, optionally scoped to a subset of columns.
      * When options.select is populated, only those columns are fetched (plus
@@ -86,7 +70,7 @@ export declare class PostgresDrizzleAdapter implements DatabaseAdapter {
     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>, options?: BaseOptions): Promise<number>;
-    aggregate<T = unknown>(collection: string, pipeline: unknown[], options?: BaseOptions): Promise<T[]>;
+    aggregate(_collection: string, _pipeline: any[], _options?: BaseOptions): Promise<any[]>;
     transaction<T>(fn: (session: unknown) => Promise<T>): Promise<T>;
     createAuditLog(data: AuditLogData, options?: BaseOptions): Promise<void>;
     createVersion(data: VersionData, options?: BaseOptions): Promise<void>;