@rebasepro/client-postgresql 0.4.0 → 0.6.0

package/README.md

@@ -1,106 +1,74 @@
-# @rebasepro/postgresql
+# @rebasepro/client-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.
+PostgreSQL data source client for Rebase — connects the Rebase admin panel to a PostgreSQL backend via WebSocket.
 
 ## Installation
 
 ```bash
-npm install @rebasepro/postgresql @rebasepro/core
+pnpm add @rebasepro/client-postgresql
 ```
 
-## Usage
+**Peer dependencies:** `react >= 19.0.0`, `react-dom >= 19.0.0`
 
-### Basic Setup with React Hook
+## What This Package Does
 
-```typescript
-import { usePostgresDataSource } from "@rebasepro/postgresql";
-import { Rebase } from "@rebasepro/core";
+This package provides a `DataDriver` implementation that bridges Rebase's data layer to a PostgreSQL backend through `@rebasepro/client`'s WebSocket client. It supports full CRUD, realtime collection/entity listeners, unique field validation, entity counting, and admin operations (SQL execution, branch management, table introspection).
 
-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"
-        }
-    });
+## Key Exports
 
-    return (
-        <Rebase
-            dataSource={dataSource}
-            collections={collections}
-            // ... other props
-        />
-    );
-}
-```
+| Export | Type | Description |
+|---|---|---|
+| `usePostgresClientDriver` | Hook | Creates a `PostgresDataDriver` from a `RebaseWebSocketClient` |
+| `PostgresDataDriverConfig` | Type | Config object: `{ wsClient: RebaseWebSocketClient }` |
+| `PostgresDataDriver` | Type | Extends `DataDriver` with a `client` reference and `admin` methods |
 
-### Creating Data Source Directly
+### `PostgresDataDriver` Methods
 
-```typescript
-import { createPostgresDataSource } from "@rebasepro/postgresql";
+| Method | Description |
+|---|---|
+| `fetchCollection(props)` | Fetch a list of entities with filtering, sorting, pagination, and search |
+| `fetchEntity(props)` | Fetch a single entity by path and ID |
+| `saveEntity(props)` | Create or update an entity |
+| `deleteEntity(props)` | Delete an entity |
+| `checkUniqueField(path, name, value, entityId?, collection?)` | Check if a field value is unique |
+| `countEntities(props)` | Count entities matching filter criteria |
+| `listenCollection(props)` | Subscribe to realtime collection updates. Returns an unsubscribe function |
+| `listenEntity(props)` | Subscribe to realtime entity updates. Returns an unsubscribe function |
+| `isFilterCombinationValid()` | Always returns `true` — PostgreSQL supports complex filter combinations |
 
-const dataSource = createPostgresDataSource({
-    baseUrl: "http://localhost:3001",
-    websocketUrl: "ws://localhost:3001"
-});
-```
+### Admin Methods (`driver.admin`)
 
-## Features
+| Method | Description |
+|---|---|
+| `executeSql(sql, options?)` | Execute raw SQL. Options: `{ database?, role? }` |
+| `fetchAvailableDatabases()` | List available databases |
+| `fetchAvailableRoles()` | List available roles |
+| `fetchCurrentDatabase()` | Get the current database name |
+| `fetchUnmappedTables(mappedPaths?)` | Find tables not yet mapped to collections |
+| `fetchTableMetadata(tableName)` | Get column/constraint metadata for a table |
+| `createBranch(name, options?)` | Create a database branch. Options: `{ source? }` |
+| `deleteBranch(name)` | Delete a database branch |
+| `listBranches()` | List all branches |
 
-- **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
+## Quick Start
 
-## API
+```tsx
+import { usePostgresClientDriver } from "@rebasepro/client-postgresql";
+import { RebaseWebSocketClient } from "@rebasepro/client";
 
-### Configuration
+const wsClient = new RebaseWebSocketClient({ url: "ws://localhost:4100" });
 
-```typescript
-interface PostgresDataSourceConfig {
-    baseUrl: string;           // Backend server URL
-    websocketUrl?: string;     // WebSocket URL (optional)
-    headers?: Record<string, string>; // Custom headers (optional)
+function App() {
+    const driver = usePostgresClientDriver({ wsClient });
+
+    // Pass to your Rebase app as the data driver
+    return (
+        <Rebase driver={driver} /* ...other props */ />
+    );
 }
 ```
 
-### 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
+## Related Packages
 
-MIT
+- `@rebasepro/client` — Provides `RebaseWebSocketClient` used for communication
+- `@rebasepro/types` — Shared types (`DataDriver`, `Entity`, `EntityCollection`, etc.)

package/dist/index.es.js

@@ -1,165 +1,119 @@
-import { c } from "react-compiler-runtime";
+import { useMemo } from "react";
+//#region src/usePostgresClientDriver.ts
 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;
-      },
-      admin: {
-        executeSql(sql, options) {
-          return client.executeSql(sql, options);
-        },
-        fetchAvailableDatabases() {
-          return client.fetchAvailableDatabases();
-        },
-        fetchAvailableRoles() {
-          return client.fetchAvailableRoles();
-        },
-        fetchCurrentDatabase() {
-          return client.fetchCurrentDatabase();
-        },
-        fetchUnmappedTables(mappedPaths) {
-          return client.fetchUnmappedTables(mappedPaths);
-        },
-        fetchTableMetadata(tableName) {
-          return client.fetchTableMetadata(tableName);
-        },
-        createBranch(name_0, options_0) {
-          return client.createBranch(name_0, options_0);
-        },
-        deleteBranch(name_1) {
-          return client.deleteBranch(name_1);
-        },
-        listBranches() {
-          return client.listBranches();
-        }
-      }
-    };
-    $[0] = client;
-    $[1] = t1;
-  } else {
-    t1 = $[1];
-  }
-  t0 = t1;
-  return t0;
+	const client = config.wsClient;
+	return useMemo(() => {
+		if (!client) throw new Error("RebaseWebSocketClient must be provided in config.wsClient");
+		return {
+			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) {
+				const { path, entityId, databaseId } = props;
+				return client.fetchEntity({
+					path,
+					entityId,
+					databaseId
+				});
+			},
+			async saveEntity(props) {
+				return client.saveEntity({
+					path: props.path,
+					values: props.values,
+					entityId: props.entityId,
+					previousValues: props.previousValues,
+					status: props.status
+				});
+			},
+			async deleteEntity(props) {
+				const { entity } = props;
+				return client.deleteEntity({ entity });
+			},
+			async checkUniqueField(path, name, value, entityId, collection) {
+				return client.checkUniqueField(path, name, value, entityId, collection);
+			},
+			async countEntities(props) {
+				const { path, filter, limit, startAfter, orderBy, searchString, order } = props;
+				return client.countEntities({
+					path,
+					filter,
+					limit,
+					startAfter,
+					orderBy,
+					searchString,
+					order
+				});
+			},
+			listenCollection(props) {
+				const { path, filter, limit, startAfter, orderBy, searchString, order, onUpdate, onError } = props;
+				return client.listenCollection({
+					path,
+					filter,
+					limit,
+					startAfter,
+					orderBy,
+					searchString,
+					order
+				}, (entities) => props.onUpdate(entities), props.onError);
+			},
+			listenEntity(props) {
+				const { path, entityId, databaseId, onUpdate, onError } = props;
+				return client.listenEntity({
+					path,
+					entityId,
+					databaseId
+				}, (entity) => {
+					props.onUpdate(entity);
+				}, props.onError);
+			},
+			isFilterCombinationValid() {
+				return true;
+			},
+			admin: {
+				executeSql(sql, options) {
+					return client.executeSql(sql, options);
+				},
+				fetchAvailableDatabases() {
+					return client.fetchAvailableDatabases();
+				},
+				fetchAvailableRoles() {
+					return client.fetchAvailableRoles();
+				},
+				fetchCurrentDatabase() {
+					return client.fetchCurrentDatabase();
+				},
+				fetchUnmappedTables(mappedPaths) {
+					return client.fetchUnmappedTables(mappedPaths);
+				},
+				fetchTableMetadata(tableName) {
+					return client.fetchTableMetadata(tableName);
+				},
+				createBranch(name, options) {
+					return client.createBranch(name, options);
+				},
+				deleteBranch(name) {
+					return client.deleteBranch(name);
+				},
+				listBranches() {
+					return client.listBranches();
+				}
+			}
+		};
+	}, [client]);
 }
-export {
-  usePostgresClientDriver
-};
-//# sourceMappingURL=index.es.js.map
+//#endregion
+export { usePostgresClientDriver };
+
+//# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +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    BranchInfo\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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder }) 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,\nentityId,\ndatabaseId }) 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: unknown, 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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder });\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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder },\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,\nentityId,\ndatabaseId },\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        admin: {\n            executeSql(sql: string, options?: { database?: string; role?: string }): Promise<Record<string, unknown>[]> {\n                return client.executeSql(sql, options);\n            },\n            fetchAvailableDatabases(): Promise<string[]> {\n                return client.fetchAvailableDatabases();\n            },\n            fetchAvailableRoles(): Promise<string[]> {\n                return client.fetchAvailableRoles();\n            },\n            fetchCurrentDatabase(): Promise<string | undefined> {\n                return client.fetchCurrentDatabase();\n            },\n            fetchUnmappedTables(mappedPaths?: string[]): Promise<string[]> {\n                return client.fetchUnmappedTables(mappedPaths);\n            },\n            fetchTableMetadata(tableName: string): Promise<unknown> {\n                return client.fetchTableMetadata(tableName);\n            },\n            createBranch(name: string, options?: { source?: string }): Promise<BranchInfo> {\n                return client.createBranch(name, options);\n            },\n            deleteBranch(name: string): Promise<void> {\n                return client.deleteBranch(name);\n            },\n            listBranches(): Promise<BranchInfo[]> {\n                return client.listBranches();\n            }\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","admin","executeSql","sql","options","fetchAvailableDatabases","fetchAvailableRoles","fetchCurrentDatabase","fetchUnmappedTables","mappedPaths","fetchTableMetadata","tableName","createBranch","name_0","options_0","deleteBranch","name_1","listBranches"],"mappings":"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"}
+{"version":3,"file":"index.es.js","names":[],"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    BranchInfo\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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder }) 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,\nentityId,\ndatabaseId }) 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: unknown, 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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder });\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,\nfilter,\nlimit,\nstartAfter,\norderBy,\nsearchString,\norder },\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,\nentityId,\ndatabaseId },\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        admin: {\n            executeSql(sql: string, options?: { database?: string; role?: string }): Promise<Record<string, unknown>[]> {\n                return client.executeSql(sql, options);\n            },\n            fetchAvailableDatabases(): Promise<string[]> {\n                return client.fetchAvailableDatabases();\n            },\n            fetchAvailableRoles(): Promise<string[]> {\n                return client.fetchAvailableRoles();\n            },\n            fetchCurrentDatabase(): Promise<string | undefined> {\n                return client.fetchCurrentDatabase();\n            },\n            fetchUnmappedTables(mappedPaths?: string[]): Promise<string[]> {\n                return client.fetchUnmappedTables(mappedPaths);\n            },\n            fetchTableMetadata(tableName: string): Promise<unknown> {\n                return client.fetchTableMetadata(tableName);\n            },\n            createBranch(name: string, options?: { source?: string }): Promise<BranchInfo> {\n                return client.createBranch(name, options);\n            },\n            deleteBranch(name: string): Promise<void> {\n                return client.deleteBranch(name);\n            },\n            listBranches(): Promise<BranchInfo[]> {\n                return client.listBranches();\n            }\n        }\n    } as PostgresDataDriver;\n    }, [client]);\n\n}\n"],"mappings":";;AAyBA,SAAgB,wBAAwB,QAAsD;CAC1F,MAAM,SAAS,OAAO;CAEtB,OAAO,cAAc;EACjB,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,2DAA2D;EAExF,OAAO;GAEP,KAAK;GAEL,MAAM;GAEN;GAEA,MAAM,gBAA+C,OAAsD;IAEvG,MAAM,EAAE,MAAM,QAAQ,OAAO,YAAY,SAAS,cAAc,UAAU;IAC1E,OAAO,OAAO,gBAAgB;KAAE;KAC5C;KACA;KACA;KACA;KACA;KACA;IAAM,CAAC;GACC;GAEA,MAAM,YAA2C,OAA4D;IACzG,MAAM,EAAE,MAAM,UAAU,eAAe;IACvC,OAAO,OAAO,YAAY;KAAE;KACxC;KACA;IAAW,CAAC;GACJ;GAEA,MAAM,WAA0C,OAA+C;IAC3F,OAAO,OAAO,WAAW;KACrB,MAAM,MAAM;KACZ,QAAQ,MAAM;KACd,UAAU,MAAM;KAChB,gBAAgB,MAAM;KACtB,QAAQ,MAAM;IAClB,CAAC;GACL;GAEA,MAAM,aAA4C,OAA4C;IAC1F,MAAM,EAAE,WAAW;IACnB,OAAO,OAAO,aAAa,EAAE,OAAO,CAAC;GACzC;GAEA,MAAM,iBAAiB,MAAc,MAAc,OAAgB,UAAmB,YAAiD;IACnI,OAAO,OAAO,iBAAiB,MAAM,MAAM,OAAO,UAAU,UAAU;GAC1E;GAEA,MAAM,cAA6C,OAAiD;IAChG,MAAM,EAAE,MAAM,QAAQ,OAAO,YAAY,SAAS,cAAc,UAAU;IAC1E,OAAO,OAAO,cAAc;KAAE;KAC1C;KACA;KACA;KACA;KACA;KACA;IAAM,CAAC;GACC;GAEA,iBAAgD,OAA6C;IACzF,MAAM,EAAE,MAAM,QAAQ,OAAO,YAAY,SAAS,cAAc,OAAO,UAAU,YAAY;IAC7F,OAAO,OAAO,iBACV;KAAE;KAClB;KACA;KACA;KACA;KACA;KACA;IAAM,IACW,aAAuB,MAAM,SAAS,QAAuB,GAC9D,MAAM,OACV;GACJ;GAEA,aAA4C,OAAyC;IACjF,MAAM,EAAE,MAAM,UAAU,YAAY,UAAU,YAAY;IAC1D,OAAO,OAAO,aACV;KAAE;KAClB;KACA;IAAW,IACM,WAA0B;KACvB,MAAM,SAAS,MAA0B;IAC7C,GACA,MAAM,OACV;GACJ;GAEA,2BAAoC;IAChC,OAAO;GACX;GAEA,OAAO;IACH,WAAW,KAAa,SAAoF;KACxG,OAAO,OAAO,WAAW,KAAK,OAAO;IACzC;IACA,0BAA6C;KACzC,OAAO,OAAO,wBAAwB;IAC1C;IACA,sBAAyC;KACrC,OAAO,OAAO,oBAAoB;IACtC;IACA,uBAAoD;KAChD,OAAO,OAAO,qBAAqB;IACvC;IACA,oBAAoB,aAA2C;KAC3D,OAAO,OAAO,oBAAoB,WAAW;IACjD;IACA,mBAAmB,WAAqC;KACpD,OAAO,OAAO,mBAAmB,SAAS;IAC9C;IACA,aAAa,MAAc,SAAoD;KAC3E,OAAO,OAAO,aAAa,MAAM,OAAO;IAC5C;IACA,aAAa,MAA6B;KACtC,OAAO,OAAO,aAAa,IAAI;IACnC;IACA,eAAsC;KAClC,OAAO,OAAO,aAAa;IAC/B;GACJ;EACJ;CACA,GAAG,CAAC,MAAM,CAAC;AAEf"}