@statezero/core 0.2.60 → 0.2.61

package/dist/flavours/django/manager.d.ts

@@ -157,6 +157,15 @@ export class Manager {
      * and a boolean indicating whether it was created.
      */
     updateOrCreate(lookupFields: any, defaults?: Object): Promise<ResultTuple>;
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * The returned QuerySet can be further chained with .filter(),
+     * .exclude(), .orderBy(), .search() before executing.
+     *
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    hydrate(ast: Object): QuerySet<any>;
     /**
      * Executes a pre-compiled AST through the standard QueryExecutor path.
      *

package/dist/flavours/django/manager.js

@@ -200,6 +200,17 @@ export class Manager {
     async updateOrCreate(lookupFields, defaults = {}) {
         return this.newQuerySet().updateOrCreate(lookupFields, defaults);
     }
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * The returned QuerySet can be further chained with .filter(),
+     * .exclude(), .orderBy(), .search() before executing.
+     *
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    hydrate(ast) {
+        return this.QuerySetClass.hydrate(ast, this.ModelClass);
+    }
     /**
      * Executes a pre-compiled AST through the standard QueryExecutor path.
      *

package/dist/flavours/django/model.d.ts

@@ -54,6 +54,12 @@ export class Model {
      * @returns {Promise<any>} The query result.
      */
     static execute(ast: import("./querySet.js").CompiledAST): Promise<any>;
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    static hydrate(ast: Object): QuerySet;
     /**
      * Get field permissions for the current user (cached on the class)
      * @param {boolean} refresh - Force refresh the cached permissions

package/dist/flavours/django/model.js

@@ -322,6 +322,14 @@ export class Model {
     static execute(ast) {
         return this.objects.execute(ast);
     }
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    static hydrate(ast) {
+        return this.objects.hydrate(ast);
+    }
     /**
      * Get field permissions for the current user (cached on the class)
      * @param {boolean} refresh - Force refresh the cached permissions

package/dist/flavours/django/querySet.d.ts

@@ -16,6 +16,16 @@
  * @template T
  */
 export class QuerySet<T> {
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * The returned QuerySet can be further chained with .filter(),
+     * .exclude(), .orderBy(), .search() before executing.
+     *
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @param {Function} ModelClass - The model constructor.
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    static hydrate(ast: Object, ModelClass: Function): QuerySet<any>;
     /**
      * Creates a new QuerySet.
      *

package/dist/flavours/django/querySet.js

@@ -688,6 +688,35 @@ export class QuerySet {
             updateOrCreate: (args) => this._compile('update_or_create', args),
         };
     }
+    /**
+     * Reconstructs a QuerySet builder from a compiled AST dict.
+     * The returned QuerySet can be further chained with .filter(),
+     * .exclude(), .orderBy(), .search() before executing.
+     *
+     * @param {Object} ast - A compiled AST (from build() or compile()).
+     * @param {Function} ModelClass - The model constructor.
+     * @returns {QuerySet} A new QuerySet that can be chained further.
+     */
+    static hydrate(ast, ModelClass) {
+        const nodes = [];
+        // Restore filter tree as a single pre-built node
+        if (ast.filter) {
+            nodes.push(ast.filter);
+        }
+        // Restore search as a search node
+        if (ast.search) {
+            nodes.push({
+                type: "search",
+                searchQuery: ast.search.searchQuery,
+                searchFields: ast.search.searchFields,
+            });
+        }
+        return new QuerySet(ModelClass, {
+            nodes,
+            orderBy: ast.orderBy ? [...ast.orderBy] : undefined,
+            aggregations: ast.aggregations ? [...ast.aggregations] : [],
+        });
+    }
     build() {
         if (this._prebuiltAST)
             return clone(this._prebuiltAST);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statezero/core",
-  "version": "0.2.60",
+  "version": "0.2.61",
   "type": "module",
   "module": "ESNext",
   "description": "The type-safe frontend client for StateZero - connect directly to your backend models with zero boilerplate",