@rebasepro/types 0.7.0 → 0.9.0

package/src/types/backend.ts

@@ -1,6 +1,6 @@
-import type { Entity } from "./entities";
-import type { EntityCollection, FilterValues, WhereFilterOp } from "./collections";
+import type { CollectionConfig, FilterValues, WhereFilterOp } from "./collections";
 import type { AuthAdapter } from "./auth_adapter";
+import type { HistoryConfig } from "../controllers/client";
 
 // =============================================================================
 // DATABASE CONNECTION INTERFACES
@@ -52,7 +52,7 @@ export interface FetchCollectionOptions<M extends Record<string, unknown> = Reco
     startAfter?: unknown;
     searchString?: string;
     databaseId?: string;
-    collection?: EntityCollection;
+    collection?: CollectionConfig;
 }
 
 /**
@@ -64,7 +64,7 @@ export interface SearchOptions<M extends Record<string, unknown> = Record<string
     order?: "desc" | "asc";
     limit?: number;
     databaseId?: string;
-    collection?: EntityCollection;
+    collection?: CollectionConfig;
 }
 
 /**
@@ -150,15 +150,15 @@ export type ConditionBuilderStatic<T = unknown> = {
  * - Relation resolution
  * - ID generation and conversion
  */
-export interface EntityRepository {
+export interface DataRepository {
     /**
      * Fetch a single entity by ID
      */
-    fetchEntity<M extends Record<string, unknown>>(
+    fetchOne<M extends Record<string, unknown>>(
         collectionPath: string,
-        entityId: string | number,
+        id: string | number,
         databaseId?: string
-    ): Promise<Entity<M> | undefined>;
+    ): Promise<Record<string, unknown> | undefined>;
 
     /**
      * Fetch a collection of entities with optional filtering, ordering, and pagination
@@ -166,41 +166,41 @@ export interface EntityRepository {
     fetchCollection<M extends Record<string, unknown>>(
         collectionPath: string,
         options?: FetchCollectionOptions<M>
-    ): Promise<Entity<M>[]>;
+    ): Promise<Record<string, unknown>[]>;
 
     /**
      * Search entities by text
      */
-    searchEntities<M extends Record<string, unknown>>(
+    searchRows<M extends Record<string, unknown>>(
         collectionPath: string,
         searchString: string,
         options?: SearchOptions<M>
-    ): Promise<Entity<M>[]>;
+    ): Promise<Record<string, unknown>[]>;
 
     /**
      * Count entities in a collection
      */
-    countEntities<M extends Record<string, unknown>>(
+    count<M extends Record<string, unknown>>(
         collectionPath: string,
         options?: CountOptions<M>
     ): Promise<number>;
 
     /**
-     * Save an entity (create or update)
+     * Save a entity (create or update)
      */
-    saveEntity<M extends Record<string, unknown>>(
+    save<M extends Record<string, unknown>>(
         collectionPath: string,
         values: Partial<M>,
-        entityId?: string | number,
+        id?: string | number,
         databaseId?: string
-    ): Promise<Entity<M>>;
+    ): Promise<Record<string, unknown>>;
 
     /**
-     * Delete an entity by ID
+     * Delete a entity by ID
      */
-    deleteEntity(
+    delete(
         collectionPath: string,
-        entityId: string | number,
+        id: string | number,
         databaseId?: string
     ): Promise<void>;
 
@@ -239,10 +239,10 @@ export interface CollectionSubscriptionConfig {
 /**
  * Configuration for subscribing to a single entity
  */
-export interface EntitySubscriptionConfig {
+export interface SingleSubscriptionConfig {
     clientId: string;
     path: string;
-    entityId: string | number;
+    id: string | number;
 }
 
 /**
@@ -256,16 +256,16 @@ export interface RealtimeProvider {
     subscribeToCollection(
         subscriptionId: string,
         config: CollectionSubscriptionConfig,
-        callback?: (entities: Entity[]) => void
+        callback?: (rows: Record<string, unknown>[]) => void
     ): void;
 
     /**
      * Subscribe to single entity changes
      */
-    subscribeToEntity(
+    subscribeToOne(
         subscriptionId: string,
-        config: EntitySubscriptionConfig,
-        callback?: (entity: Entity | null) => void
+        config: SingleSubscriptionConfig,
+        callback?: (row: Record<string, unknown> | null) => void
     ): void;
 
     /**
@@ -274,12 +274,12 @@ export interface RealtimeProvider {
     unsubscribe(subscriptionId: string): void;
 
     /**
-     * Notify all relevant subscribers of an entity update
+     * Notify all relevant subscribers of a entity update
      */
-    notifyEntityUpdate(
+    notifyUpdate(
         path: string,
-        entityId: string,
-        entity: Entity | null,
+        id: string,
+        row: Record<string, unknown> | null,
         databaseId?: string
     ): Promise<void>;
 
@@ -314,17 +314,22 @@ export interface CollectionRegistryInterface {
     /**
      * Register a collection
      */
-    register(collection: EntityCollection): void;
+    register(collection: CollectionConfig): void;
 
     /**
      * Get a collection by its path
      */
-    getCollectionByPath(path: string): EntityCollection | undefined;
+    getCollectionByPath(path: string): CollectionConfig | undefined;
 
     /**
      * Get all registered collections
      */
-    getCollections(): EntityCollection[];
+    getCollections(): CollectionConfig[];
+
+    /**
+     * Get the currently registered global callbacks, if any.
+     */
+    getGlobalCallbacks(): any | undefined;
 }
 
 // =============================================================================
@@ -341,7 +346,7 @@ export interface DataTransformer {
      */
     serializeToDatabase<M extends Record<string, unknown>>(
         entity: M,
-        collection: EntityCollection
+        collection: CollectionConfig
     ): Record<string, unknown>;
 
     /**
@@ -349,7 +354,7 @@ export interface DataTransformer {
      */
     deserializeFromDatabase<M extends Record<string, unknown>>(
         data: Record<string, unknown>,
-        collection: EntityCollection
+        collection: CollectionConfig
     ): Promise<M>;
 }
 
@@ -584,7 +589,7 @@ export interface BackendInstance extends BackendLifecycle {
     /**
      * Entity repository for CRUD operations
      */
-    entityRepository: EntityRepository;
+    entityRepository: DataRepository;
 
     /**
      * Realtime provider for subscriptions
@@ -692,7 +697,7 @@ export interface BackendBootstrapper {
      * Initialize history tables / services if this driver supports them.
      * Return undefined if history is not supported by this backend.
      */
-    initializeHistory?(config: unknown, driverResult: InitializedDriver): Promise<{ historyService: unknown } | undefined>;
+    initializeHistory?(config: HistoryConfig, driverResult: InitializedDriver): Promise<{ historyService: unknown } | undefined>;
 
     /**
      * Create a realtime provider for this driver.

package/src/types/builders.ts

@@ -1,10 +1,10 @@
 import type { AuthController } from "../controllers/auth";
 import type { RebaseData } from "../controllers/data";
 import type { User } from "../users";
-import type { EntityCollection } from "./collections";
+import type { CollectionConfig } from "./collections";
 import type { AppView } from "../controllers/navigation";
 
-export type EntityCollectionsBuilder<EC extends EntityCollection = EntityCollection> = (params: {
+export type CollectionConfigsBuilder<EC extends CollectionConfig = CollectionConfig> = (params: {
     user: User | null,
     authController: AuthController,
     data: RebaseData