@rebasepro/server-postgresql 0.2.3 → 0.2.4

package/dist/server-postgresql/src/services/EntityFetchService.d.ts

@@ -1,6 +1,7 @@
 import { SQL } from "drizzle-orm";
 import { PgTable } from "drizzle-orm/pg-core";
 import { Entity, FilterValues } from "@rebasepro/types";
+import type { VectorSearchParams } from "@rebasepro/types";
 import { RelationService } from "./RelationService";
 import { DrizzleClient } from "../interfaces";
 import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
@@ -102,6 +103,7 @@ export declare class EntityFetchService {
         startAfter?: Record<string, unknown>;
         searchString?: string;
         databaseId?: string;
+        vectorSearch?: VectorSearchParams;
     }): Promise<Entity<M>[]>;
     /**
      * Fallback path used when db.query is unavailable.
@@ -123,6 +125,7 @@ export declare class EntityFetchService {
         startAfter?: Record<string, unknown>;
         searchString?: string;
         databaseId?: string;
+        vectorSearch?: VectorSearchParams;
     }): Promise<Entity<M>[]>;
     /**
      * Search entities by text
@@ -175,6 +178,7 @@ export declare class EntityFetchService {
         startAfter?: Record<string, unknown>;
         searchString?: string;
         databaseId?: string;
+        vectorSearch?: VectorSearchParams;
     }, include?: string[]): Promise<Record<string, unknown>[]>;
     /**
      * Fetch a single entity with optional relation includes for REST API.

package/dist/server-postgresql/src/services/entityService.d.ts

@@ -1,4 +1,5 @@
 import { Entity, FilterValues } from "@rebasepro/types";
+import type { VectorSearchParams } from "@rebasepro/types";
 import { EntityFetchService } from "./EntityFetchService";
 import { EntityPersistService } from "./EntityPersistService";
 import { RelationService } from "./RelationService";
@@ -42,6 +43,7 @@ export declare class EntityService implements EntityRepository {
         startAfter?: Record<string, unknown>;
         searchString?: string;
         databaseId?: string;
+        vectorSearch?: VectorSearchParams;
     }): Promise<Entity<M>[]>;
     /**
      * Search entities by text

package/dist/server-postgresql/src/services/realtimeService.d.ts

@@ -22,6 +22,10 @@ export declare class RealtimeService extends EventEmitter implements RealtimePro
     private db;
     private registry;
     private clients;
+    private channels;
+    private presence;
+    private presenceInterval?;
+    private static readonly PRESENCE_TIMEOUT_MS;
     private entityService;
     private _subscriptions;
     private subscriptionCallbacks;
@@ -152,6 +156,22 @@ export declare class RealtimeService extends EventEmitter implements RealtimePro
      * Returns ["posts", "posts/70"] for the example above
      */
     private getParentPaths;
+    /** Join a broadcast channel */
+    joinChannel(clientId: string, channel: string): void;
+    /** Leave a broadcast channel */
+    leaveChannel(clientId: string, channel: string): void;
+    /** Broadcast a message to all clients in a channel except sender */
+    broadcastToChannel(clientId: string, channel: string, event: string, payload: unknown): void;
+    /** Track presence in a channel */
+    trackPresence(clientId: string, channel: string, state: Record<string, unknown>): void;
+    /** Remove presence from a channel */
+    removePresence(clientId: string, channel: string): void;
+    /** Send full presence state to a specific client */
+    sendPresenceState(clientId: string, channel: string): void;
+    /** Broadcast presence diff (joins/leaves) to channel */
+    private broadcastPresenceDiff;
+    /** Periodic cleanup for stale presences */
+    private ensurePresenceCleanup;
     /**
      * Gracefully tear down all realtime resources.
      *

package/dist/server-postgresql/src/utils/drizzle-conditions.d.ts

@@ -108,6 +108,24 @@ export declare class DrizzleConditionBuilder {
      * Find the corresponding junction table for an inverse many-to-many relation
      */
     private static findCorrespondingJunctionTable;
+    /**
+     * Build vector similarity search expressions for pgvector.
+     *
+     * Returns:
+     * - `orderBy`: SQL expression to ORDER BY distance (ascending = closest first)
+     * - `filter`: optional WHERE clause for distance threshold
+     * - `distanceSelect`: SQL expression for selecting the distance as `_distance`
+     */
+    static buildVectorSearchConditions(table: PgTable<any>, vectorSearch: {
+        property: string;
+        vector: number[];
+        distance?: "cosine" | "l2" | "inner_product";
+        threshold?: number;
+    }): {
+        orderBy: SQL;
+        filter?: SQL;
+        distanceSelect: SQL;
+    };
 }
 /**
  * Alias for DrizzleConditionBuilder for consistent naming with other database implementations.

package/dist/types/src/controllers/auth.d.ts

@@ -1,6 +1,4 @@
-import { StorageSource } from "./storage";
 import { Role, User } from "../users";
-import { RebaseData } from "./data";
 /**
  * Capabilities advertised by an auth provider.
  * UI components use this to show/hide features dynamically
@@ -89,6 +87,8 @@ export interface AuthControllerExtended<USER extends User = User, ExtraData = un
         code: string;
         redirectUri: string;
     }) => Promise<void>;
+    /** Generic OAuth login — works with any provider. Posts payload to /auth/{providerId}. */
+    oauthLogin?: (providerId: string, payload: Record<string, unknown>) => Promise<void>;
     /** Register a new user */
     register?(email: string, password: string, displayName?: string): Promise<void>;
     /** Skip login (for anonymous access if enabled) */
@@ -102,25 +102,3 @@ export interface AuthControllerExtended<USER extends User = User, ExtraData = un
     /** Update user profile */
     updateProfile?(displayName?: string, photoURL?: string): Promise<USER>;
 }
-/**
- * Implement this function to allow access to specific users.
- * @group Hooks and utilities
- */
-export type Authenticator<USER extends User = User> = (props: {
-    /**
-     * Logged-in user or null
-     */
-    user: USER | null;
-    /**
-     * AuthController
-     */
-    authController: AuthController<USER>;
-    /**
-     * Unified data access API
-     */
-    data: RebaseData;
-    /**
-     * Used storage implementation
-     */
-    storageSource: StorageSource;
-}) => boolean | Promise<boolean>;

package/dist/types/src/controllers/client.d.ts

@@ -65,7 +65,6 @@ export interface AdminRole {
     name: string;
     isAdmin: boolean;
     defaultPermissions: Record<string, unknown> | null;
-    config: Record<string, unknown> | null;
 }
 /**
  * Client-side Admin API interface.
@@ -123,7 +122,6 @@ export interface AdminAPI {
         name: string;
         isAdmin?: boolean;
         defaultPermissions?: Record<string, unknown>;
-        config?: Record<string, unknown>;
     }): Promise<{
         role: AdminRole;
     }>;
@@ -131,7 +129,6 @@ export interface AdminAPI {
         name?: string;
         isAdmin?: boolean;
         defaultPermissions?: Record<string, unknown>;
-        config?: Record<string, unknown>;
     }): Promise<{
         role: AdminRole;
     }>;

package/dist/types/src/controllers/collection_registry.d.ts

@@ -4,7 +4,7 @@ import type { EntityReference } from "../types/entities";
  * Controller that provides access to the registered entity collections.
  * @group Models
  */
-export type CollectionRegistryController<DB = Record<string, unknown>, EC extends EntityCollection = EntityCollection<any>> = {
+export type CollectionRegistryController<DB = Record<string, unknown>, EC extends EntityCollection = EntityCollection> = {
     /**
      * List of the mapped collections in the CMS.
      * Each entry relates to a collection in the root database.

package/dist/types/src/controllers/data_driver.d.ts

@@ -17,6 +17,21 @@ export type ListenEntityProps<M extends Record<string, unknown> = Record<string,
     onUpdate: (entity: Entity<M> | null) => void;
     onError?: (error: Error) => void;
 };
+/**
+ * Configuration for vector similarity search queries.
+ * Vector search applies an ORDER BY distance expression and optionally
+ * filters results by a distance threshold.
+ */
+export interface VectorSearchParams {
+    /** Property name containing the vector column */
+    property: string;
+    /** Query vector to compare against */
+    vector: number[];
+    /** Distance function (default: "cosine") */
+    distance?: "cosine" | "l2" | "inner_product";
+    /** Only return results within this distance threshold */
+    threshold?: number;
+}
 /**
  * @internal
  */
@@ -30,6 +45,8 @@ export interface FetchCollectionProps<M extends Record<string, unknown> = Record
     orderBy?: string;
     searchString?: string;
     order?: "desc" | "asc";
+    /** Vector similarity search configuration */
+    vectorSearch?: VectorSearchParams;
 }
 /**
  * @internal
@@ -187,6 +204,7 @@ export interface RestFetchService {
         startAfter?: Record<string, unknown>;
         searchString?: string;
         databaseId?: string;
+        vectorSearch?: VectorSearchParams;
     }, include?: string[]): Promise<Record<string, unknown>[]>;
     /**
      * Fetch a single flattened entity with optional relation includes.

package/dist/types/src/controllers/registry.d.ts

@@ -4,6 +4,7 @@ import type { EntityCollectionsBuilder } from "../types/builders";
 import type { EntityCustomView } from "../types/entity_views";
 import type { EntityAction } from "../types/entity_actions";
 import type { AppView, NavigationGroupMapping } from "./navigation";
+import type { RebasePlugin } from "../types/plugins";
 /**
  * Options to enable the built-in collection editor.
  * When provided to `<RebaseCMS>`, the editor is auto-wired as a native feature.
@@ -19,12 +20,12 @@ export interface CollectionEditorOptions {
     /** Suggested base paths shown when creating new collections. */
     pathSuggestions?: string[];
 }
-export interface RebaseCMSConfig<EC extends EntityCollection = any> {
+export interface RebaseCMSConfig<EC extends EntityCollection = EntityCollection> {
     collections?: EC[] | EntityCollectionsBuilder<EC>;
     homePage?: ReactNode;
-    entityViews?: EntityCustomView<any>[];
+    entityViews?: EntityCustomView[];
     entityActions?: EntityAction[];
-    plugins?: any[];
+    plugins?: RebasePlugin[];
     /**
      * Centralized configuration for how collections and views are grouped
      * in the navigation sidebar and home page.
@@ -42,7 +43,7 @@ export interface RebaseCMSConfig<EC extends EntityCollection = any> {
     collectionEditor?: boolean | CollectionEditorOptions;
 }
 export interface RebaseStudioConfig {
-    tools?: ("sql" | "js" | "rls" | "schema" | "storage" | "cron" | "schema-visualizer" | "branches" | "api")[];
+    tools?: ("sql" | "js" | "rls" | "schema" | "storage" | "cron" | "schema-visualizer" | "branches" | "api" | "logs")[];
     homePage?: ReactNode;
     devViews?: AppView[];
 }

package/dist/types/src/rebase_context.d.ts

@@ -28,7 +28,7 @@ export type RebaseCallContext<USER extends User = User> = {
      * const { client } = props.context;
      * const result = await client.functions.invoke('extract-job', { url });
      */
-    client: RebaseClient<any>;
+    client: RebaseClient;
     /**
      * Unified data access — `context.data.products.create(...)`.
      * Access any collection as a dynamic property.

package/dist/types/src/types/auth_adapter.d.ts

@@ -133,7 +133,7 @@ export interface AuthUserData {
     displayName?: string | null;
     photoUrl?: string | null;
     emailVerified?: boolean;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     createdAt?: Date;
     updatedAt?: Date;
 }
@@ -146,7 +146,7 @@ export interface AuthCreateUserData {
     password?: string;
     displayName?: string;
     photoUrl?: string;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Role data exposed by the auth adapter.
@@ -168,7 +168,6 @@ export interface AuthRoleData {
         edit?: boolean;
         delete?: boolean;
     }> | null;
-    config?: Record<string, unknown> | null;
 }
 /**
  * Data for creating a role.
@@ -180,7 +179,6 @@ export interface AuthCreateRoleData {
     isAdmin?: boolean;
     defaultPermissions?: AuthRoleData["defaultPermissions"];
     collectionPermissions?: AuthRoleData["collectionPermissions"];
-    config?: AuthRoleData["config"];
 }
 /**
  * User management operations for the admin panel.

package/dist/types/src/types/collections.d.ts

@@ -589,10 +589,6 @@ export interface FilterPreset<Key extends string = string> {
      */
     sort?: [Key, "asc" | "desc"];
 }
-/**
- * @deprecated Use {@link FilterPreset} instead.
- */
-export type QuickFilter<Key extends string = string> = FilterPreset<Key>;
 /**
  * Used to indicate valid filter combinations (e.g. created in Firestore)
  * If the user selects a specific filter/sort combination, the CMS checks if it's

package/dist/types/src/types/component_ref.d.ts

@@ -37,7 +37,7 @@ export interface LazyComponentRef<P = unknown> {
  *
  * @group Types
  */
-export type ComponentRef<P = unknown> = React.ComponentType<P> | LazyComponentRef<P> | (() => Promise<{
+export type ComponentRef<P = any> = React.ComponentType<P> | LazyComponentRef<P> | (() => Promise<{
     default: React.ComponentType<P>;
 }>) | string;
 /**

package/dist/types/src/types/cron.d.ts

@@ -44,7 +44,7 @@ export interface CronJobContext {
     /** A simple logger scoped to this job run. */
     log: (...args: unknown[]) => void;
     /** The RebaseClient instance to interact with the database. */
-    client: RebaseClient<any>;
+    client: RebaseClient;
 }
 export type CronJobRunState = "idle" | "running" | "success" | "error" | "disabled";
 /**

package/dist/types/src/types/entity_views.d.ts

@@ -50,6 +50,7 @@ export interface FormContext<M extends Record<string, unknown> = Record<string,
 export type EntityCustomView<M extends Record<string, unknown> = Record<string, unknown>> = {
     key: string;
     name: string;
+    icon?: string | React.ReactNode;
     tabComponent?: React.ReactNode;
     includeActions?: boolean | "bottom";
     Builder?: ComponentRef<EntityCustomViewParams<M>>;

package/dist/types/src/types/export_import.d.ts

@@ -15,7 +15,7 @@ export interface ExportConfig<USER extends User = User> {
 export interface ExportMappingFunction<USER extends User = User> {
     key: string;
     builder: ({ entity, context }: {
-        entity: Entity<any>;
+        entity: Entity;
         context: RebaseContext<USER>;
     }) => Promise<string> | string;
 }

package/dist/types/src/types/formex.d.ts

@@ -1,5 +1,5 @@
 import React, { FormEvent } from "react";
-export type FormexController<T = any> = {
+export type FormexController<T = unknown> = {
     values: T;
     initialValues: T;
     setValues: (values: T) => void;
@@ -32,7 +32,7 @@ export type FormexController<T = any> = {
     canUndo: boolean;
     canRedo: boolean;
 };
-export type FormexResetProps<T = any> = {
+export type FormexResetProps<T = unknown> = {
     values?: T;
     submitCount?: number;
     errors?: Record<string, string>;

package/dist/types/src/types/properties.d.ts

@@ -104,8 +104,8 @@ export interface BaseUIConfig<CustomProps = unknown> {
     disabled?: boolean | PropertyDisabledConfig;
     widthPercentage?: number;
     customProps?: CustomProps;
-    Field?: ComponentRef<any>;
-    Preview?: ComponentRef<any>;
+    Field?: ComponentRef;
+    Preview?: ComponentRef;
 }
 export interface BaseProperty<CustomProps = unknown> {
     ui?: BaseUIConfig<CustomProps>;

package/dist/types/src/types/translations.d.ts

@@ -105,6 +105,12 @@ export interface RebaseTranslations {
     navigation_drawer: string;
     collapse: string;
     expand: string;
+    /** Tooltip for the language switcher in the drawer footer */
+    change_language?: string;
+    /** Tooltip for the theme toggle in the drawer footer */
+    toggle_theme?: string;
+    /** Aria label for the user menu trigger in the drawer footer */
+    user_menu?: string;
     error: string;
     error_uploading_file: string;
     error_deleting: string;
@@ -426,18 +432,28 @@ export interface RebaseTranslations {
     deleted: string;
     select_reference: string;
     select_references: string;
-    account_settings: string;
-    profile: string;
-    sessions: string;
-    display_name: string;
-    photo_url: string;
-    save_profile: string;
-    saving: string;
-    no_active_sessions: string;
-    revoking: string;
-    revoke_all_sessions: string;
-    unknown_device: string;
-    current: string;
+    account_settings?: string;
+    profile?: string;
+    sessions?: string;
+    security?: string;
+    change_password?: string;
+    current_password?: string;
+    new_password?: string;
+    confirm_password?: string;
+    password_changed?: string;
+    passwords_dont_match?: string;
+    password_too_short?: string;
+    password_change_not_available?: string;
+    changing_password?: string;
+    display_name?: string;
+    photo_url?: string;
+    save_profile?: string;
+    saving?: string;
+    no_active_sessions?: string;
+    revoking?: string;
+    revoke_all_sessions?: string;
+    unknown_device?: string;
+    current?: string;
     role_id: string;
     role_name: string;
     add_reference: string;

package/dist/types/src/types/user_management_delegate.d.ts

@@ -104,15 +104,17 @@ export interface UserManagementDelegate<USER extends User = User> {
      * If true, the UI will allow the user to create the default roles (admin, editor, viewer).
      */
     allowDefaultRolesCreation?: boolean;
-    /**
-     * Should collection config permissions be included?
-     */
-    includeCollectionConfigPermissions?: boolean;
     /**
      * Optionally define roles for a given user. This is useful when the roles
      * are coming from a separate provider than the one issuing the tokens.
      */
     defineRolesFor?: (user: USER) => Promise<Role[] | undefined> | Role[] | undefined;
+    /**
+     * Whether any admin users exist. Used by the bootstrap banner to decide
+     * whether to prompt.  Populated via a lightweight check (e.g. `limit=1`
+     * query) instead of loading all users.
+     */
+    hasAdminUsers?: boolean;
     /**
      * Optional function to bootstrap an admin user.
      * Often used when the database is empty.

package/dist/types/src/users/roles.d.ts

@@ -11,12 +11,4 @@ export type Role = {
      * If this flag is true, the user can perform any action
      */
     isAdmin?: boolean;
-    /**
-     * Permissions related to editing the collections
-     */
-    config?: {
-        createCollections?: boolean;
-        editCollections?: boolean | "own";
-        deleteCollections?: boolean | "own";
-    };
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rebasepro/server-postgresql",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "PostgreSQL data source backend implementation for Rebase with Drizzle ORM",
   "funding": {
     "url": "https://github.com/sponsors/rebaseco"
@@ -68,11 +68,11 @@
     "hono": "^4.12.21",
     "pg": "^8.21.0",
     "ws": "^8.20.1",
-    "@rebasepro/common": "0.2.3",
-    "@rebasepro/server-core": "0.2.3",
-    "@rebasepro/types": "0.2.3",
-    "@rebasepro/utils": "0.2.3",
-    "@rebasepro/sdk-generator": "0.2.3"
+    "@rebasepro/common": "0.2.4",
+    "@rebasepro/sdk-generator": "0.2.4",
+    "@rebasepro/types": "0.2.4",
+    "@rebasepro/server-core": "0.2.4",
+    "@rebasepro/utils": "0.2.4"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",

package/src/PostgresBackendDriver.ts

@@ -145,7 +145,8 @@ propertyCallbacks: undefined };
         startAfter,
         orderBy,
         searchString,
-        order
+        order,
+        vectorSearch
     }: FetchCollectionProps<M>): Promise<Entity<M>[]> {
 
         const entities = await this.entityService.fetchCollection<M>(path, {
@@ -156,7 +157,8 @@ propertyCallbacks: undefined };
             offset,
             startAfter: startAfter as Record<string, unknown> | undefined,
             databaseId: collection?.databaseId,
-            searchString
+            searchString,
+            vectorSearch
         });
 
         const { collection: resolvedCollection, callbacks, propertyCallbacks } = this.resolveCollectionCallbacks(collection, path);

package/src/PostgresBootstrapper.ts

@@ -25,7 +25,8 @@ import {
     createAuthRoutes,
     createAdminRoutes,
     requireAuth,
-    requireAdmin
+    requireAdmin,
+    logger
 // @ts-ignore
 } from "@rebasepro/server-core";
 import { ensureAuthTablesExist } from "./auth/ensure-tables";
@@ -50,6 +51,7 @@ import type { HonoEnv } from "@rebasepro/server-core";
  */
 export interface PostgresDriverInternals {
     db: NodePgDatabase<any>;
+    readDb?: NodePgDatabase<any>;
     registry: PostgresCollectionRegistry;
     realtimeService: RealtimeService;
     driver: PostgresBackendDriver;
@@ -83,7 +85,7 @@ export function createPostgresBootstrapper(pgConfig: PostgresDriverConfig): Back
             const registry = new PostgresCollectionRegistry();
             if (collections) {
                 registry.registerMultiple(collections);
-                console.log(`📋 [PostgresRegistry] Registered ${registry.getCollections().length} collections: [${registry.getCollections().map(c => c.slug).join(", ")}]`);
+                logger.info(`📋 [PostgresRegistry] Registered ${registry.getCollections().length} collections: [${registry.getCollections().map(c => c.slug).join(", ")}]`);
             }
 
             // Register tables
@@ -114,12 +116,26 @@ export function createPostgresBootstrapper(pgConfig: PostgresDriverConfig): Back
             try {
                 await schemaAwareDb.execute(sql`SELECT 1`);
             } catch (err) {
-                console.error("❌ Failed to connect to PostgreSQL:", err);
-                console.warn("⚠️ Continuing without initial database verification. Drizzle/PG will attempt to connect on subsequent queries.");
+                logger.error("❌ Failed to connect to PostgreSQL", { error: err });
+                logger.warn("⚠️ Continuing without initial database verification. Drizzle/PG will attempt to connect on subsequent queries.");
             }
 
             // Create services
             const realtimeService = new RealtimeService(schemaAwareDb, registry);
+
+            // Initialize read replica connection if configured
+            let readDb: import("drizzle-orm/node-postgres").NodePgDatabase<any> | undefined;
+            const readUrl = process.env.DATABASE_READ_URL;
+            if (readUrl && readUrl !== pgConfig.connectionString) {
+                try {
+                    const { createReadReplicaConnection } = await import("./connection");
+                    const readResources = createReadReplicaConnection(readUrl, mergedSchema);
+                    readDb = readResources.db;
+                    logger.info("📖 [PostgresBootstrapper] Read replica connection established");
+                } catch (err) {
+                    logger.warn("⚠️ Could not connect to read replica, falling back to primary for all queries", { error: err });
+                }
+            }
             const poolManager = pgConfig.adminConnectionString
                 ? new DatabasePoolManager(pgConfig.adminConnectionString)
                 : undefined;
@@ -131,21 +147,24 @@ export function createPostgresBootstrapper(pgConfig: PostgresDriverConfig): Back
                 try {
                     await driver.branchService.ensureBranchMetadataTable();
                 } catch (err) {
-                    console.warn("⚠️ Could not initialize branch metadata table:", err);
+                    logger.warn("⚠️ Could not initialize branch metadata table", { error: err });
                 }
             }
 
             // Enable cross-instance realtime (opt-in)
-            if (pgConfig.connectionString) {
+            // Prefer DATABASE_DIRECT_URL to bypass PgBouncer for LISTEN/NOTIFY
+            const directUrl = process.env.DATABASE_DIRECT_URL || pgConfig.connectionString;
+            if (directUrl) {
                 try {
-                    await realtimeService.startListening(pgConfig.connectionString);
+                    await realtimeService.startListening(directUrl);
                 } catch (err) {
-                    console.warn("⚠️ Cross-instance realtime could not be started:", err);
+                    logger.warn("⚠️ Cross-instance realtime could not be started", { error: err });
                 }
             }
 
             const internals: PostgresDriverInternals = {
                 db: schemaAwareDb,
+                readDb,
                 registry,
                 realtimeService,
                 driver,