@rljson/db 0.0.11 → 0.0.13

package/dist/README.trouble.md

@@ -6,9 +6,58 @@
 
 ## Table of contents <!-- omit in toc -->
 
+- [Tree INSERT operations failing with empty results](#tree-insert-operations-failing-with-empty-results)
 - [Vscode Windows: Debugging is not working](#vscode-windows-debugging-is-not-working)
 - [GitHub actions: Cannot find module @rollup/rollup-linux-x64-gnu](#github-actions-cannot-find-module-rolluprollup-linux-x64-gnu)
 
+## Tree INSERT operations failing with empty results
+
+Date: 2026-01-28
+
+### Symptoms
+
+- Tree INSERT operations complete without errors
+- GET queries after INSERT return empty results or only root node
+- Cell length is 1 instead of expected count
+- Navigation stops at root level
+
+### Root Cause
+
+The `treeFromObject` function from `@rljson/rljson` v0.0.74+ creates an explicit root node with `id='root'` at the end of the tree array. When inserting an already-isolated subtree (from `isolate()`), this created a double-root structure:
+
+```
+Auto-root (id='root')
+  └─ User-root (id='root')
+       └─ actual data nodes
+```
+
+When `TreeController` navigates the tree, it stops at the first node with `id='root'` (the auto-root), which has no meaningful data.
+
+### Solution
+
+✅ **Fixed in current version**: The `db.ts` file now calls `treeFromObject` with `skipRootCreation: true` parameter:
+
+```typescript
+const trees = treeFromObject(treeObject, true);
+```
+
+This prevents the automatic root wrapper from being created during INSERT operations.
+
+### Verification
+
+Run the tree INSERT tests:
+
+```bash
+pnpm test --run --grep "insert on tree"
+```
+
+All tree INSERT tests should pass:
+
+- "insert on tree root node"
+- "insert on tree deeper leaf"
+- "insert on tree simple branch"
+- "insert new child on branch"
+
 ## Vscode Windows: Debugging is not working
 
 Date: 2025-03-08

package/dist/controller/controller.d.ts

@@ -20,7 +20,7 @@ export type ControllerChildProperty = {
  * @property {ControllerRunFn<N>} insert - Function to execute a command on the table.
  * @property {() => Promise<void>} init - Initializes the controller.
  * @property {() => Promise<T>} table - Retrieves the current state of the table.
- * @property {(where: string | { [column: string]: JsonValue }) => Promise<Rljson>} get - Fetches data from the table based on a condition.
+ * @property {(where: string | { [column: string]: JsonValue }, filter: Json | undefined, path: string | undefined) => Promise<Rljson>} get - Fetches data from the table based on a condition.
  * @property {(where: string | Json, filter?: Json) => Promise<Array<{ tableKey: TableKey; ref: Ref }>>} getChildRefs - Retrieves references to child entries in related tables based on a condition.
  * @param {string | Json }} where - The condition to filter the data.
  * @returns {Promise<Json[] | null>} A promise that resolves to an array of JSON objects or null if no data is found.
@@ -30,7 +30,7 @@ export interface Controller<T extends TableType, C extends JsonValue, N extends
     insert: ControllerRunFn<N, C>;
     init(): Promise<void>;
     table(): Promise<T>;
-    get(where: string | Json, filter?: Json): Promise<Rljson>;
+    get(where: string | Json, filter?: Json, path?: string): Promise<Rljson>;
     getChildRefs(where: string | Json, filter?: Json): Promise<ControllerChildProperty[]>;
     filterRow(row: Json, key: string, value: JsonValue): Promise<boolean>;
     contentType(): ContentType;

package/dist/controller/tree-controller.d.ts

@@ -0,0 +1,18 @@
+import { Json } from '@rljson/json';
+import { InsertCommand, InsertHistoryRow, Ref, Rljson, TableKey, Tree, TreesTable } from '@rljson/rljson';
+import { Core } from '../core.ts';
+import { Cell } from '../db.ts';
+import { BaseController } from './base-controller.ts';
+import { Controller, ControllerChildProperty } from './controller.ts';
+export declare class TreeController<N extends string, C extends Tree> extends BaseController<TreesTable, C> implements Controller<TreesTable, C, N> {
+    protected readonly _core: Core;
+    protected readonly _tableKey: TableKey;
+    constructor(_core: Core, _tableKey: TableKey);
+    init(): Promise<void>;
+    insert(command: InsertCommand, value: Tree, origin?: Ref): Promise<InsertHistoryRow<any>[]>;
+    get(where: string | Json, filter?: Json, path?: string): Promise<Rljson>;
+    buildTreeFromTrees(trees: Tree[]): Promise<Json>;
+    buildCellsFromTree(trees: Tree[]): Promise<Cell[]>;
+    getChildRefs(where: string | Json, filter?: Json): Promise<ControllerChildProperty[]>;
+    filterRow(): Promise<boolean>;
+}

package/dist/db.d.ts

@@ -131,12 +131,6 @@ export declare class Db {
      * @throws {Error} If the InsertHistory table does not exist
      */
     private _writeInsertHistory;
-    /**
-     * Add a head revision for a cake
-     * @param cakeKey - The cake table key
-     * @param cakeRef - The cake reference
-     */
-    addHeadRevision(cakeKey: string, cakeRef: Ref): Promise<InsertHistoryRow<string>[]>;
     /**
      * Add a multiEdit
      * @param cakeKey - The cake table key