@rebasepro/client-postgresql 0.0.1-canary.4d4fb3e

package/LICENSE

@@ -0,0 +1,6 @@
+Source code in this repository is variously licensed under the Business Source
+License 1.1 (BSL), Apache version 2.0 and the MIT license. A copy of each
+license can be found in each one of the packages under the folder packages
+under a file called License. Source code in a given file is licensed under the
+BSL and the copyright belongs to Rebase Authors unless otherwise noted at the
+beginning of the file.

package/README.md

@@ -0,0 +1,106 @@
+# @rebasepro/postgresql
+
+PostgreSQL data source client for Rebase with real-time WebSocket connectivity.
+
+This package provides a complete client-side implementation for connecting Rebase applications to PostgreSQL backends, featuring real-time synchronization via WebSockets.
+
+## Installation
+
+```bash
+npm install @rebasepro/postgresql @rebasepro/core
+```
+
+## Usage
+
+### Basic Setup with React Hook
+
+```typescript
+import { usePostgresDataSource } from "@rebasepro/postgresql";
+import { Rebase } from "@rebasepro/core";
+
+function App() {
+    const dataSource = usePostgresDataSource({
+        baseUrl: "http://localhost:3001",
+        websocketUrl: "ws://localhost:3001", // Optional, will be inferred from baseUrl
+        headers: { // Optional
+            "Authorization": "Bearer your-token"
+        }
+    });
+
+    return (
+        <Rebase
+            dataSource={dataSource}
+            collections={collections}
+            // ... other props
+        />
+    );
+}
+```
+
+### Creating Data Source Directly
+
+```typescript
+import { createPostgresDataSource } from "@rebasepro/postgresql";
+
+const dataSource = createPostgresDataSource({
+    baseUrl: "http://localhost:3001",
+    websocketUrl: "ws://localhost:3001"
+});
+```
+
+## Features
+
+- **Real-time Synchronization**: WebSocket-based real-time updates for collections and entities
+- **Automatic Reconnection**: Built-in reconnection logic with exponential backoff
+- **Type Safety**: Full TypeScript support with Rebase core types
+- **Error Handling**: Comprehensive error handling with custom error types
+- **Connection Management**: Connection status monitoring and queue management
+
+## API
+
+### Configuration
+
+```typescript
+interface PostgresDataSourceConfig {
+    baseUrl: string;           // Backend server URL
+    websocketUrl?: string;     // WebSocket URL (optional)
+    headers?: Record<string, string>; // Custom headers (optional)
+}
+```
+
+### Methods
+
+The PostgreSQL data source implements all Rebase `DataSource` methods:
+
+- `fetchCollection<M>(props): Promise<Entity<M>[]>`
+- `fetchEntity<M>(props): Promise<Entity<M> | undefined>`
+- `saveEntity<M>(props): Promise<Entity<M>>`
+- `deleteEntity<M>(props): Promise<void>`
+- `checkUniqueField(...): Promise<boolean>`
+- `generateEntityId(...): string`
+- `countEntities<M>(props): Promise<number>`
+- `listenCollection<M>(props): () => void`
+- `listenEntity<M>(props): () => void`
+
+## Backend Requirements
+
+This client expects a WebSocket-enabled backend that handles the following message types:
+
+- `FETCH_COLLECTION`
+- `FETCH_ENTITY`
+- `SAVE_ENTITY`
+- `DELETE_ENTITY`
+- `CHECK_UNIQUE_FIELD`
+- `GENERATE_ENTITY_ID`
+- `COUNT_ENTITIES`
+- `subscribe_collection`
+- `subscribe_entity`
+- `unsubscribe`
+
+## Development
+
+This package is part of the Rebase monorepo. For development instructions, see the main repository README.
+
+## License
+
+MIT

package/dist/client-postgresql/src/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @rebasepro/client-postgresql
+ *
+ * PostgreSQL data source client for Rebase
+ * This package provides a WebSocket-based client for connecting Rebase applications
+ * to PostgreSQL backends with real-time synchronization capabilities.
+ */
+export * from "./usePostgresClientDriver";

package/dist/client-postgresql/src/usePostgresClientDriver.d.ts

@@ -0,0 +1,9 @@
+import { DataDriver } from "@rebasepro/types";
+import { RebaseWebSocketClient } from "@rebasepro/client";
+export interface PostgresDataDriverConfig {
+    wsClient?: RebaseWebSocketClient;
+}
+export interface PostgresDataDriver extends DataDriver {
+    client?: RebaseWebSocketClient;
+}
+export declare function usePostgresClientDriver(config: PostgresDataDriverConfig): PostgresDataDriver;

package/dist/index.es.js

@@ -0,0 +1,154 @@
+import { c } from "react-compiler-runtime";
+function usePostgresClientDriver(config) {
+  const $ = c(2);
+  const client = config.wsClient;
+  let t0;
+  if (!client) {
+    throw new Error("RebaseWebSocketClient must be provided in config.wsClient");
+  }
+  let t1;
+  if ($[0] !== client) {
+    t1 = {
+      key: "postgres",
+      name: "PostgreSQL",
+      client,
+      async fetchCollection(props) {
+        const {
+          path,
+          filter,
+          limit,
+          startAfter,
+          orderBy,
+          searchString,
+          order
+        } = props;
+        return client.fetchCollection({
+          path,
+          filter,
+          limit,
+          startAfter,
+          orderBy,
+          searchString,
+          order
+        });
+      },
+      async fetchEntity(props_0) {
+        const {
+          path: path_0,
+          entityId,
+          databaseId
+        } = props_0;
+        return client.fetchEntity({
+          path: path_0,
+          entityId,
+          databaseId
+        });
+      },
+      async saveEntity(props_1) {
+        return client.saveEntity({
+          path: props_1.path,
+          values: props_1.values,
+          entityId: props_1.entityId,
+          previousValues: props_1.previousValues,
+          status: props_1.status
+        });
+      },
+      async deleteEntity(props_2) {
+        const {
+          entity
+        } = props_2;
+        return client.deleteEntity({
+          entity
+        });
+      },
+      async checkUniqueField(path_1, name, value, entityId_0, collection) {
+        return client.checkUniqueField(path_1, name, value, entityId_0, collection);
+      },
+      async countEntities(props_3) {
+        const {
+          path: path_2,
+          filter: filter_0,
+          limit: limit_0,
+          startAfter: startAfter_0,
+          orderBy: orderBy_0,
+          searchString: searchString_0,
+          order: order_0
+        } = props_3;
+        return client.countEntities({
+          path: path_2,
+          filter: filter_0,
+          limit: limit_0,
+          startAfter: startAfter_0,
+          orderBy: orderBy_0,
+          searchString: searchString_0,
+          order: order_0
+        });
+      },
+      listenCollection(props_4) {
+        const {
+          path: path_3,
+          filter: filter_1,
+          limit: limit_1,
+          startAfter: startAfter_1,
+          orderBy: orderBy_1,
+          searchString: searchString_1,
+          order: order_1
+        } = props_4;
+        return client.listenCollection({
+          path: path_3,
+          filter: filter_1,
+          limit: limit_1,
+          startAfter: startAfter_1,
+          orderBy: orderBy_1,
+          searchString: searchString_1,
+          order: order_1
+        }, (entities) => props_4.onUpdate(entities), props_4.onError);
+      },
+      listenEntity(props_5) {
+        const {
+          path: path_4,
+          entityId: entityId_1,
+          databaseId: databaseId_0
+        } = props_5;
+        return client.listenEntity({
+          path: path_4,
+          entityId: entityId_1,
+          databaseId: databaseId_0
+        }, (entity_0) => {
+          props_5.onUpdate(entity_0);
+        }, props_5.onError);
+      },
+      isFilterCombinationValid() {
+        return true;
+      },
+      async executeSql(sql, options) {
+        return client.executeSql(sql, options);
+      },
+      async fetchAvailableDatabases() {
+        return client.fetchAvailableDatabases();
+      },
+      async fetchAvailableRoles() {
+        return client.fetchAvailableRoles();
+      },
+      async fetchCurrentDatabase() {
+        return client.fetchCurrentDatabase();
+      },
+      async fetchUnmappedTables(mappedPaths) {
+        return client.fetchUnmappedTables(mappedPaths);
+      },
+      async fetchTableMetadata(tableName) {
+        return client.fetchTableMetadata(tableName);
+      }
+    };
+    $[0] = client;
+    $[1] = t1;
+  } else {
+    t1 = $[1];
+  }
+  t0 = t1;
+  return t0;
+}
+export {
+  usePostgresClientDriver
+};
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.es.js","sources":["../src/usePostgresClientDriver.ts"],"sourcesContent":["import { useMemo, useEffect } from \"react\";\nimport {\n    DataDriver,\n    DeleteEntityProps,\n    Entity,\n    EntityCollection,\n    EntityReference, EntityRelation,\n    FetchCollectionProps,\n    FetchEntityProps,\n    ListenCollectionProps,\n    ListenEntityProps,\n    SaveEntityProps,\n    TableMetadata\n} from \"@rebasepro/types\";\nimport { RebaseWebSocketClient } from \"@rebasepro/client\";\n\nexport interface PostgresDataDriverConfig {\n    wsClient?: RebaseWebSocketClient;\n}\n\nexport interface PostgresDataDriver extends DataDriver {\n    client?: RebaseWebSocketClient;\n}\n\n\nexport function usePostgresClientDriver(config: PostgresDataDriverConfig): PostgresDataDriver {\n    const client = config.wsClient;\n\n    return useMemo(() => {\n        if (!client) throw new Error(\"RebaseWebSocketClient must be provided in config.wsClient\");\n        \n        return {\n\n        key: \"postgres\",\n\n        name: \"PostgreSQL\",\n\n        client,\n\n        async fetchCollection<M extends Record<string, any>>(props: FetchCollectionProps<M>): Promise<Entity<M>[]> {\n            // Pick only the fields the client needs, ignoring extra fields from the CMS layer\n            const { path, filter, limit, startAfter, orderBy, searchString, order } = props;\n            return client.fetchCollection({ path, filter, limit, startAfter, orderBy, searchString, order }) as Promise<Entity<M>[]>;\n        },\n\n        async fetchEntity<M extends Record<string, any>>(props: FetchEntityProps<M>): Promise<Entity<M> | undefined> {\n            const { path, entityId, databaseId } = props;\n            return client.fetchEntity({ path, entityId, databaseId }) as Promise<Entity<M> | undefined>;\n        },\n\n        async saveEntity<M extends Record<string, any>>(props: SaveEntityProps<M>): Promise<Entity<M>> {\n            return client.saveEntity({\n                path: props.path,\n                values: props.values,\n                entityId: props.entityId,\n                previousValues: props.previousValues,\n                status: props.status\n            }) as Promise<Entity<M>>;\n        },\n\n        async deleteEntity<M extends Record<string, any>>(props: DeleteEntityProps<M>): Promise<void> {\n            const { entity } = props;\n            return client.deleteEntity({ entity });\n        },\n\n        async checkUniqueField(path: string, name: string, value: any, entityId?: string, collection?: EntityCollection): Promise<boolean> {\n            return client.checkUniqueField(path, name, value, entityId, collection);\n        },\n\n        async countEntities<M extends Record<string, any>>(props: FetchCollectionProps<M>): Promise<number> {\n            const { path, filter, limit, startAfter, orderBy, searchString, order } = props;\n            return client.countEntities({ path, filter, limit, startAfter, orderBy, searchString, order });\n        },\n\n        listenCollection<M extends Record<string, any>>(props: ListenCollectionProps<M>): () => void {\n            const { path, filter, limit, startAfter, orderBy, searchString, order, onUpdate, onError } = props;\n            return client.listenCollection(\n                { path, filter, limit, startAfter, orderBy, searchString, order },\n                (entities: Entity[]) => props.onUpdate(entities as Entity<M>[]),\n                props.onError\n            );\n        },\n\n        listenEntity<M extends Record<string, any>>(props: ListenEntityProps<M>): () => void {\n            const { path, entityId, databaseId, onUpdate, onError } = props;\n            return client.listenEntity(\n                { path, entityId, databaseId },\n                (entity: Entity | null) => {\n                    props.onUpdate(entity as Entity<M> | null);\n                },\n                props.onError\n            );\n        },\n\n        isFilterCombinationValid(): boolean {\n            return true; // PostgreSQL supports complex filter combinations\n        },\n\n        async executeSql(sql: string, options?: { database?: string, role?: string }): Promise<any[]> {\n            return client.executeSql(sql, options);\n        },\n\n        async fetchAvailableDatabases(): Promise<string[]> {\n            return client.fetchAvailableDatabases();\n        },\n\n        async fetchAvailableRoles(): Promise<string[]> {\n            return client.fetchAvailableRoles();\n        },\n\n        async fetchCurrentDatabase(): Promise<string | undefined> {\n            return client.fetchCurrentDatabase();\n        },\n\n        async fetchUnmappedTables(mappedPaths?: string[]): Promise<string[]> {\n            return client.fetchUnmappedTables(mappedPaths);\n        },\n\n        async fetchTableMetadata(tableName: string): Promise<TableMetadata> {\n            return client.fetchTableMetadata(tableName);\n        }\n    } as PostgresDataDriver;\n    }, [client]);\n\n}\n"],"names":["usePostgresClientDriver","config","$","_c","client","wsClient","t0","Error","t1","key","name","fetchCollection","props","path","filter","limit","startAfter","orderBy","searchString","order","fetchEntity","props_0","path_0","entityId","databaseId","saveEntity","props_1","values","previousValues","status","deleteEntity","props_2","entity","checkUniqueField","path_1","value","entityId_0","collection","countEntities","props_3","path_2","filter_0","limit_0","startAfter_0","orderBy_0","searchString_0","order_0","listenCollection","props_4","path_3","filter_1","limit_1","startAfter_1","orderBy_1","searchString_1","order_1","entities","onUpdate","onError","listenEntity","props_5","path_4","entityId_1","databaseId_0","entity_0","isFilterCombinationValid","executeSql","sql","options","fetchAvailableDatabases","fetchAvailableRoles","fetchCurrentDatabase","fetchUnmappedTables","mappedPaths","fetchTableMetadata","tableName"],"mappings":"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"}

package/dist/index.umd.js

@@ -0,0 +1,157 @@
+(function(global, factory) {
+  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("react-compiler-runtime")) : typeof define === "function" && define.amd ? define(["exports", "react-compiler-runtime"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["Rebase PostgreSQL"] = {}, global.reactCompilerRuntime));
+})(this, function(exports2, reactCompilerRuntime) {
+  "use strict";
+  function usePostgresClientDriver(config) {
+    const $ = reactCompilerRuntime.c(2);
+    const client = config.wsClient;
+    let t0;
+    if (!client) {
+      throw new Error("RebaseWebSocketClient must be provided in config.wsClient");
+    }
+    let t1;
+    if ($[0] !== client) {
+      t1 = {
+        key: "postgres",
+        name: "PostgreSQL",
+        client,
+        async fetchCollection(props) {
+          const {
+            path,
+            filter,
+            limit,
+            startAfter,
+            orderBy,
+            searchString,
+            order
+          } = props;
+          return client.fetchCollection({
+            path,
+            filter,
+            limit,
+            startAfter,
+            orderBy,
+            searchString,
+            order
+          });
+        },
+        async fetchEntity(props_0) {
+          const {
+            path: path_0,
+            entityId,
+            databaseId
+          } = props_0;
+          return client.fetchEntity({
+            path: path_0,
+            entityId,
+            databaseId
+          });
+        },
+        async saveEntity(props_1) {
+          return client.saveEntity({
+            path: props_1.path,
+            values: props_1.values,
+            entityId: props_1.entityId,
+            previousValues: props_1.previousValues,
+            status: props_1.status
+          });
+        },
+        async deleteEntity(props_2) {
+          const {
+            entity
+          } = props_2;
+          return client.deleteEntity({
+            entity
+          });
+        },
+        async checkUniqueField(path_1, name, value, entityId_0, collection) {
+          return client.checkUniqueField(path_1, name, value, entityId_0, collection);
+        },
+        async countEntities(props_3) {
+          const {
+            path: path_2,
+            filter: filter_0,
+            limit: limit_0,
+            startAfter: startAfter_0,
+            orderBy: orderBy_0,
+            searchString: searchString_0,
+            order: order_0
+          } = props_3;
+          return client.countEntities({
+            path: path_2,
+            filter: filter_0,
+            limit: limit_0,
+            startAfter: startAfter_0,
+            orderBy: orderBy_0,
+            searchString: searchString_0,
+            order: order_0
+          });
+        },
+        listenCollection(props_4) {
+          const {
+            path: path_3,
+            filter: filter_1,
+            limit: limit_1,
+            startAfter: startAfter_1,
+            orderBy: orderBy_1,
+            searchString: searchString_1,
+            order: order_1
+          } = props_4;
+          return client.listenCollection({
+            path: path_3,
+            filter: filter_1,
+            limit: limit_1,
+            startAfter: startAfter_1,
+            orderBy: orderBy_1,
+            searchString: searchString_1,
+            order: order_1
+          }, (entities) => props_4.onUpdate(entities), props_4.onError);
+        },
+        listenEntity(props_5) {
+          const {
+            path: path_4,
+            entityId: entityId_1,
+            databaseId: databaseId_0
+          } = props_5;
+          return client.listenEntity({
+            path: path_4,
+            entityId: entityId_1,
+            databaseId: databaseId_0
+          }, (entity_0) => {
+            props_5.onUpdate(entity_0);
+          }, props_5.onError);
+        },
+        isFilterCombinationValid() {
+          return true;
+        },
+        async executeSql(sql, options) {
+          return client.executeSql(sql, options);
+        },
+        async fetchAvailableDatabases() {
+          return client.fetchAvailableDatabases();
+        },
+        async fetchAvailableRoles() {
+          return client.fetchAvailableRoles();
+        },
+        async fetchCurrentDatabase() {
+          return client.fetchCurrentDatabase();
+        },
+        async fetchUnmappedTables(mappedPaths) {
+          return client.fetchUnmappedTables(mappedPaths);
+        },
+        async fetchTableMetadata(tableName) {
+          return client.fetchTableMetadata(tableName);
+        }
+      };
+      $[0] = client;
+      $[1] = t1;
+    } else {
+      t1 = $[1];
+    }
+    t0 = t1;
+    return t0;
+  }
+  exports2.usePostgresClientDriver = usePostgresClientDriver;
+  Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
+});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/usePostgresClientDriver.ts"],"sourcesContent":["import { useMemo, useEffect } from \"react\";\nimport {\n    DataDriver,\n    DeleteEntityProps,\n    Entity,\n    EntityCollection,\n    EntityReference, EntityRelation,\n    FetchCollectionProps,\n    FetchEntityProps,\n    ListenCollectionProps,\n    ListenEntityProps,\n    SaveEntityProps,\n    TableMetadata\n} from \"@rebasepro/types\";\nimport { RebaseWebSocketClient } from \"@rebasepro/client\";\n\nexport interface PostgresDataDriverConfig {\n    wsClient?: RebaseWebSocketClient;\n}\n\nexport interface PostgresDataDriver extends DataDriver {\n    client?: RebaseWebSocketClient;\n}\n\n\nexport function usePostgresClientDriver(config: PostgresDataDriverConfig): PostgresDataDriver {\n    const client = config.wsClient;\n\n    return useMemo(() => {\n        if (!client) throw new Error(\"RebaseWebSocketClient must be provided in config.wsClient\");\n        \n        return {\n\n        key: \"postgres\",\n\n        name: \"PostgreSQL\",\n\n        client,\n\n        async fetchCollection<M extends Record<string, any>>(props: FetchCollectionProps<M>): Promise<Entity<M>[]> {\n            // Pick only the fields the client needs, ignoring extra fields from the CMS layer\n            const { path, filter, limit, startAfter, orderBy, searchString, order } = props;\n            return client.fetchCollection({ path, filter, limit, startAfter, orderBy, searchString, order }) as Promise<Entity<M>[]>;\n        },\n\n        async fetchEntity<M extends Record<string, any>>(props: FetchEntityProps<M>): Promise<Entity<M> | undefined> {\n            const { path, entityId, databaseId } = props;\n            return client.fetchEntity({ path, entityId, databaseId }) as Promise<Entity<M> | undefined>;\n        },\n\n        async saveEntity<M extends Record<string, any>>(props: SaveEntityProps<M>): Promise<Entity<M>> {\n            return client.saveEntity({\n                path: props.path,\n                values: props.values,\n                entityId: props.entityId,\n                previousValues: props.previousValues,\n                status: props.status\n            }) as Promise<Entity<M>>;\n        },\n\n        async deleteEntity<M extends Record<string, any>>(props: DeleteEntityProps<M>): Promise<void> {\n            const { entity } = props;\n            return client.deleteEntity({ entity });\n        },\n\n        async checkUniqueField(path: string, name: string, value: any, entityId?: string, collection?: EntityCollection): Promise<boolean> {\n            return client.checkUniqueField(path, name, value, entityId, collection);\n        },\n\n        async countEntities<M extends Record<string, any>>(props: FetchCollectionProps<M>): Promise<number> {\n            const { path, filter, limit, startAfter, orderBy, searchString, order } = props;\n            return client.countEntities({ path, filter, limit, startAfter, orderBy, searchString, order });\n        },\n\n        listenCollection<M extends Record<string, any>>(props: ListenCollectionProps<M>): () => void {\n            const { path, filter, limit, startAfter, orderBy, searchString, order, onUpdate, onError } = props;\n            return client.listenCollection(\n                { path, filter, limit, startAfter, orderBy, searchString, order },\n                (entities: Entity[]) => props.onUpdate(entities as Entity<M>[]),\n                props.onError\n            );\n        },\n\n        listenEntity<M extends Record<string, any>>(props: ListenEntityProps<M>): () => void {\n            const { path, entityId, databaseId, onUpdate, onError } = props;\n            return client.listenEntity(\n                { path, entityId, databaseId },\n                (entity: Entity | null) => {\n                    props.onUpdate(entity as Entity<M> | null);\n                },\n                props.onError\n            );\n        },\n\n        isFilterCombinationValid(): boolean {\n            return true; // PostgreSQL supports complex filter combinations\n        },\n\n        async executeSql(sql: string, options?: { database?: string, role?: string }): Promise<any[]> {\n            return client.executeSql(sql, options);\n        },\n\n        async fetchAvailableDatabases(): Promise<string[]> {\n            return client.fetchAvailableDatabases();\n        },\n\n        async fetchAvailableRoles(): Promise<string[]> {\n            return client.fetchAvailableRoles();\n        },\n\n        async fetchCurrentDatabase(): Promise<string | undefined> {\n            return client.fetchCurrentDatabase();\n        },\n\n        async fetchUnmappedTables(mappedPaths?: string[]): Promise<string[]> {\n            return client.fetchUnmappedTables(mappedPaths);\n        },\n\n        async fetchTableMetadata(tableName: string): Promise<TableMetadata> {\n            return client.fetchTableMetadata(tableName);\n        }\n    } as PostgresDataDriver;\n    }, [client]);\n\n}\n"],"names":["usePostgresClientDriver","config","$","_c","client","wsClient","t0","Error","t1","key","name","fetchCollection","props","path","filter","limit","startAfter","orderBy","searchString","order","fetchEntity","props_0","path_0","entityId","databaseId","saveEntity","props_1","values","previousValues","status","deleteEntity","props_2","entity","checkUniqueField","path_1","value","entityId_0","collection","countEntities","props_3","path_2","filter_0","limit_0","startAfter_0","orderBy_0","searchString_0","order_0","listenCollection","props_4","path_3","filter_1","limit_1","startAfter_1","orderBy_1","searchString_1","order_1","entities","onUpdate","onError","listenEntity","props_5","path_4","entityId_1","databaseId_0","entity_0","isFilterCombinationValid","executeSql","sql","options","fetchAvailableDatabases","fetchAvailableRoles","fetchCurrentDatabase","fetchUnmappedTables","mappedPaths","fetchTableMetadata","tableName"],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+export type AnalyticsController = {
+    /**
+     * Callback used to get analytics events from the CMS
+     */
+    onAnalyticsEvent?: (event: AnalyticsEvent, data?: object) => void;
+};
+export type AnalyticsEvent = "entity_click" | "entity_click_from_reference" | "reference_selection_clear" | "reference_selection_toggle" | "reference_selected_single" | "reference_selection_new_entity" | "edit_entity_clicked" | "entity_edited" | "new_entity_click" | "new_entity_saved" | "copy_entity_click" | "entity_copied" | "single_delete_dialog_open" | "multiple_delete_dialog_open" | "single_entity_deleted" | "multiple_entities_deleted" | "drawer_navigate_to_home" | "drawer_navigate_to_collection" | "drawer_navigate_to_view" | "home_navigate_to_collection" | "home_favorite_navigate_to_collection" | "home_navigate_to_view" | "home_navigate_to_admin_view" | "home_favorite_navigate_to_view" | "home_move_card" | "home_move_group" | "home_drop_new_group" | "collection_inline_editing" | "view_mode_changed" | "kanban_card_moved" | "kanban_column_reorder" | "kanban_property_changed" | "kanban_new_entity_in_column" | "kanban_backfill_order" | "card_view_entity_click" | "unmapped_event";

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

@@ -0,0 +1,117 @@
+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
+ * (e.g. password reset, registration, session management).
+ * @group Hooks and utilities
+ */
+export interface AuthCapabilities {
+    emailPasswordLogin?: boolean;
+    googleLogin?: boolean;
+    registration?: boolean;
+    passwordReset?: boolean;
+    sessionManagement?: boolean;
+    profileUpdate?: boolean;
+    emailVerification?: boolean;
+}
+/**
+ * Controller for retrieving the logged user or performing auth related operations.
+ * Note that if you are implementing your AuthController, you probably will want
+ * to do it as the result of a hook.
+ * @group Hooks and utilities
+ */
+export type AuthController<USER extends User = User, ExtraData = unknown> = {
+    /**
+     * The user currently logged in
+     * The values can be: the user object, null if they skipped login
+     */
+    user: USER | null;
+    /**
+     * Initial loading flag. It is used not to display the login screen
+     * when the app first loads, and it has not been checked whether the user
+     * is logged in or not.
+     */
+    initialLoading?: boolean;
+    /**
+     * Loading flag. It is used to display a loading screen when the user is
+     * logging in or out.
+     */
+    authLoading: boolean;
+    /**
+     * Sign out
+     */
+    signOut: () => Promise<void>;
+    /**
+     * Error initializing the authentication
+     */
+    authError?: unknown;
+    /**
+     * Error dispatched by the auth provider
+     */
+    authProviderError?: unknown;
+    /**
+     * You can use this method to retrieve the auth token for the current user.
+     */
+    getAuthToken: () => Promise<string>;
+    /**
+     * Has the user skipped the login process
+     */
+    loginSkipped: boolean;
+    extra: ExtraData;
+    setExtra: (extra: ExtraData) => void;
+    setUser?(user: USER | null): void;
+    setUserRoles?(roles: Role[]): void;
+    /**
+     * Capabilities advertised by the auth provider.
+     * UI components use this to feature-detect what the backend supports.
+     */
+    capabilities?: AuthCapabilities;
+};
+/**
+ * Extended auth controller with common optional auth methods.
+ * Backend implementations (Rebase backend, Firebase, Supabase, etc.)
+ * extend this with their own backend-specific extras.
+ * @group Hooks and utilities
+ */
+export interface AuthControllerExtended<USER extends User = User, ExtraData = unknown> extends AuthController<USER, ExtraData> {
+    /** Login with email and password */
+    emailPasswordLogin?(email: string, password: string): Promise<void>;
+    /** Login with a Google ID token or trigger Google popup */
+    googleLogin?(idToken: string): Promise<void>;
+    /** Register a new user */
+    register?(email: string, password: string, displayName?: string): Promise<void>;
+    /** Skip login (for anonymous access if enabled) */
+    skipLogin?(): void;
+    /** Request password reset email */
+    forgotPassword?(email: string): Promise<void>;
+    /** Reset password using a token */
+    resetPassword?(token: string, password: string): Promise<void>;
+    /** Change password for the authenticated user */
+    changePassword?(oldPassword: string, newPassword: string): Promise<void>;
+    /** 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

@@ -0,0 +1,58 @@
+import { User } from "../users";
+import { RebaseData } from "./data";
+/**
+ * Event type for authentication state changes
+ */
+export type AuthChangeEvent = 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED' | 'USER_UPDATED';
+/**
+ * Standard session interface representing an authenticated state
+ */
+export interface RebaseSession {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    user: User;
+}
+import { StorageSource } from "./storage";
+/**
+ * Unified Authentication Client Interface
+ * Pure functional SDK interface, decoupled from UI and React hooks
+ */
+export interface AuthClient {
+    /**
+     * Get the current user from the server or cache
+     */
+    getUser(): Promise<User | null>;
+    /**
+     * Get the currently active session
+     */
+    getSession(): RebaseSession | null;
+    /**
+     * Sign out the current user and clear local session
+     */
+    signOut(): Promise<void>;
+    /**
+     * Subscribe to authentication state changes
+     */
+    onAuthStateChange(callback: (event: AuthChangeEvent, session: RebaseSession | null) => void): () => void;
+    /**
+     * Manually refresh the session token
+     */
+    refreshSession(): Promise<RebaseSession>;
+    [key: string]: any;
+}
+/**
+ * Overarching abstraction that unites Data, Auth, and Storage.
+ * Adapters for Supabase or Firebase simply need to implement this interface.
+ */
+export interface RebaseClient<DB = any> {
+    /** Unified Data access layer */
+    data: RebaseData;
+    /** Unified Authentication layer */
+    auth: AuthClient;
+    /** Unified Storage layer */
+    storage?: StorageSource;
+    /** Optional admin panel specific tasks */
+    admin?: any;
+    [key: string]: any;
+}