@rljson/db 0.0.6 → 0.0.8

package/dist/db.d.ts

@@ -1,11 +1,25 @@
 import { Io } from '@rljson/io';
-import { Json } from '@rljson/json';
-import { Insert, InsertHistoryRow, InsertHistoryTimeId, Ref, Rljson, Route } from '@rljson/rljson';
-import { Controller, ControllerRefs } from './controller/controller.ts';
+import { Json, JsonValue } from '@rljson/json';
+import { InsertHistoryRow, InsertHistoryTimeId, Ref, Rljson, Route, SliceId, TableType } from '@rljson/rljson';
+import { Controller, ControllerChildProperty, ControllerRefs } from './controller/controller.ts';
 import { Core } from './core.ts';
 import { Join } from './join/join.ts';
 import { ColumnSelection } from './join/selection/column-selection.ts';
 import { Notify } from './notify.ts';
+export type Cell = {
+    route: Route;
+    value: JsonValue[] | null;
+    row: JsonValue[] | null;
+    path: Array<Array<string | number>>;
+};
+export type Container = {
+    rljson: Rljson;
+    tree: Json;
+    cell: Cell[];
+};
+export type ContainerWithControllers = Container & {
+    controllers: Record<string, Controller<any, any, any>>;
+};
 /**
  * Access Rljson data
  */
@@ -29,11 +43,24 @@ export declare class Db {
      * Get data from a route with optional filtering
      * @param route - The route to get data from
      * @param where - Optional filter to apply to the data
+     * @param filter - Optional filter to apply to child entries in related tables
+     * @param sliceIds - Optional slice IDs to filter the data
      * @returns An array of Rljson objects matching the route and filter
      * @throws {Error} If the route is not valid or if any controller cannot be created
      */
-    get(route: Route, where: string | Json): Promise<Rljson>;
-    _get(route: Route, where: string | Json, controllers: Record<string, Controller<any, any>>, segmentLevel?: number): Promise<Rljson>;
+    get(route: Route, where: string | Json, filter?: ControllerChildProperty[], sliceIds?: SliceId[]): Promise<ContainerWithControllers>;
+    /**
+     * Resolves the route and returns corresponding data for any segment of the route,
+     * matching recursive filters and where clauses
+     *
+     * @param route - The route to get data from
+     * @param where - The recursive filtering key/value pairs to apply to the data
+     * @param controllers - The controllers to use for fetching data
+     * @param filter - Optional filter to apply to the data at the current route segment
+     * @param sliceIds - Optional slice IDs to filter the data at the current route segment
+     * @returns - An Rljson object matching the route and filters
+     */
+    _get(route: Route, where: string | Json, controllers: Record<string, Controller<any, any, any>>, filter?: ControllerChildProperty[], sliceIds?: SliceId[], routeAccumulator?: Route): Promise<Container>;
     /**
      * Get the reference (hash) of a route segment, considering default refs and insertHistory refs
      * @param segment - The route segment to get the reference for
@@ -45,20 +72,17 @@ export declare class Db {
      * @param rljson - The Rljson to join data for
      */
     join(columnSelection: ColumnSelection, cakeKey: string, cakeRef: Ref): Promise<Join>;
-    /**
-     * Fetches data for the given ColumnSelection
-     * @param columnSelection - The ColumnSelection to fetch data for
-     */
-    private _getBaseDataForColumnSelection;
+    private _resolveSliceIds;
     /**
      * Runs an Insert by executing the appropriate controller(s) based on the Insert's route
      * @param Insert - The Insert to run
      * @returns The result of the Insert as an InsertHistoryRow
      * @throws {Error} If the Insert is not valid or if any controller cannot be created
      */
-    insert(insert: Insert<any>, options?: {
+    insert(route: Route, tree: Json, options?: {
         skipNotification?: boolean;
-    }): Promise<InsertHistoryRow<any>>;
+        skipHistory?: boolean;
+    }): Promise<InsertHistoryRow<any>[]>;
     /**
      * Recursively runs controllers based on the route of the Insert
      * @param insert - The Insert to run
@@ -80,19 +104,6 @@ export declare class Db {
      * @param callback - The callback to be unregistered
      */
     unregisterObserver(route: Route, callback: (InsertHistoryRow: InsertHistoryRow<any>) => void): void;
-    /**
-     * Resolves an Insert by returning the run functions of all controllers involved in the Insert's route
-     * @param Insert - The Insert to resolve
-     * @returns A record of controller run functions, keyed by table name
-     * @throws {Error} If the route is not valid or if any controller cannot be created
-     */
-    private _resolveInsert;
-    /**
-     * Returns the keys of child refs in a value based on a route
-     * @param value - The value to check
-     * @returns An array of keys of child refs in the value
-     */
-    private _childKeys;
     /**
      * Get a controller for a specific table
      * @param tableKey - The key of the table to get the controller for
@@ -100,8 +111,8 @@ export declare class Db {
      * @returns A controller for the specified table
      * @throws {Error} If the table does not exist or if the table type is not supported
      */
-    getController(tableKey: string, refs?: ControllerRefs): Promise<Controller<any, string>>;
-    private _indexedControllers;
+    getController(tableKey: string, refs?: ControllerRefs): Promise<Controller<TableType, any, string>>;
+    indexedControllers(route: Route): Promise<Record<string, Controller<any, any, any>>>;
     /**
      * Adds an InsertHistory row to the InsertHistory table of a table
      * @param table - The table the Insert was made on
@@ -166,5 +177,5 @@ export declare class Db {
     /**
      * Get the current cache of the Db instance
      */
-    get cache(): Map<string, Rljson>;
+    get cache(): Map<string, Container>;
 }