@statezero/core 0.2.60 → 0.2.62

package/dist/adaptors/vue/components/StateZeroDebugPanel.js

@@ -2932,11 +2932,11 @@ class Ce {
     const r = async ({ ast: i, modelClass: l, canonical_id: a }) => {
       const c = {
         ...i,
-        type: "list"
+        type: "read"
       };
       return (await V(
         e,
-        "list",
+        "read",
         c,
         null,
         // operationId
@@ -3441,15 +3441,15 @@ class hr {
    * @template T  The model type of the QuerySet
    * @param {QuerySet<T>} qs
    *   The QuerySet to execute.
-   * @param {string} [op="list"]
-   *   The operation to perform. Defaults to `"list"`, but could be overridden for other list‑style endpoints.
+   * @param {string} [op="read"]
+   *   The operation to perform. Defaults to `"read"`, but could be overridden for other list‑style endpoints.
    * @param {Object} [args={}]
    *   Additional arguments to pass through to the underlying API call (e.g. filters, pagination).
    * @returns {LiveThenable<import('./makeLiveThenable').Result<T[]>>}
    *   A live‑thenable wrapping an array of primary‑key values for the fetched models. The live part remains
    *   synchronized with the in‑memory store.
    */
-  static executeList(e, t = "list", s = {}) {
+  static executeList(e, t = "read", s = {}) {
     const r = x.getEntity(e), o = V(e, t, s).then((i) => {
       const { data: l, included: a } = i.data;
       we(j, a, e.ModelClass, e);
@@ -3762,7 +3762,7 @@ class hr {
    * @param {Object} args - Additional arguments for the operation.
    * @returns {Promise<any>} The operation result.
    */
-  static execute(e, t = "list", s = {}) {
+  static execute(e, t = "read", s = {}) {
     if (e._remoteOnly)
       return this.executeRemote(e, t, s);
     switch (t) {
@@ -3793,7 +3793,7 @@ class hr {
         return this.executeAgg(e, t, s);
       case "exists":
         return this.executeExists(e, t, s);
-      case "list":
+      case "read":
         return this.executeList(e, t, s);
     }
     throw new Error(`Invalid operation type: ${t}`);
@@ -3806,7 +3806,7 @@ class hr {
    * @param {Object} args - Additional arguments for the operation.
    * @returns {Promise<any>} The raw API response data.
    */
-  static executeRemote(e, t = "list", s = {}) {
+  static executeRemote(e, t = "read", s = {}) {
     return V(e, t, s);
   }
 }

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.
      *
@@ -207,10 +218,10 @@ export class Manager {
      * @returns {Promise<any>} The query result.
      */
     execute(ast) {
-        const { op, args, ...buildOutput } = ast;
+        const { type, args, ...buildOutput } = ast;
         const qs = new this.QuerySetClass(this.ModelClass, { serializerOptions: buildOutput.serializerOptions || {} });
         qs._prebuiltAST = { ...buildOutput, serializerOptions: buildOutput.serializerOptions || {} };
-        return QueryExecutor.execute(qs, op, args || {});
+        return QueryExecutor.execute(qs, type, args || {});
     }
     /**
      * Applies a search to the QuerySet using the specified search query and fields.

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/queryExecutor.d.ts

@@ -38,8 +38,8 @@ export class QueryExecutor {
      * @template T  The model type of the QuerySet
      * @param {QuerySet<T>} qs
      *   The QuerySet to execute.
-     * @param {string} [op="list"]
-     *   The operation to perform. Defaults to `"list"`, but could be overridden for other list‑style endpoints.
+     * @param {string} [op="read"]
+     *   The operation to perform. Defaults to `"read"`, but could be overridden for other list‑style endpoints.
      * @param {Object} [args={}]
      *   Additional arguments to pass through to the underlying API call (e.g. filters, pagination).
      * @returns {LiveThenable<import('./makeLiveThenable').Result<T[]>>}

package/dist/flavours/django/queryExecutor.js

@@ -78,15 +78,15 @@ export class QueryExecutor {
      * @template T  The model type of the QuerySet
      * @param {QuerySet<T>} qs
      *   The QuerySet to execute.
-     * @param {string} [op="list"]
-     *   The operation to perform. Defaults to `"list"`, but could be overridden for other list‑style endpoints.
+     * @param {string} [op="read"]
+     *   The operation to perform. Defaults to `"read"`, but could be overridden for other list‑style endpoints.
      * @param {Object} [args={}]
      *   Additional arguments to pass through to the underlying API call (e.g. filters, pagination).
      * @returns {LiveThenable<import('./makeLiveThenable').Result<T[]>>}
      *   A live‑thenable wrapping an array of primary‑key values for the fetched models. The live part remains
      *   synchronized with the in‑memory store.
      */
-    static executeList(qs, op = "list", args = {}) {
+    static executeList(qs, op = "read", args = {}) {
         const live = querysetStoreRegistry.getEntity(qs);
         const promise = makeApiCall(qs, op, args).then((resp) => {
             const { data, included } = resp.data;
@@ -538,7 +538,7 @@ export class QueryExecutor {
      * @param {Object} args - Additional arguments for the operation.
      * @returns {Promise<any>} The operation result.
      */
-    static execute(querySet, operationType = "list", args = {}) {
+    static execute(querySet, operationType = "read", args = {}) {
         if (querySet._remoteOnly) {
             return this.executeRemote(querySet, operationType, args);
         }
@@ -571,7 +571,7 @@ export class QueryExecutor {
                 return this.executeAgg(querySet, operationType, args);
             case "exists":
                 return this.executeExists(querySet, operationType, args);
-            case "list":
+            case "read":
                 return this.executeList(querySet, operationType, args);
         }
         throw new Error(`Invalid operation type: ${operationType}`);
@@ -584,7 +584,7 @@ export class QueryExecutor {
      * @param {Object} args - Additional arguments for the operation.
      * @returns {Promise<any>} The raw API response data.
      */
-    static executeRemote(querySet, operationType = "list", args = {}) {
+    static executeRemote(querySet, operationType = "read", args = {}) {
         return makeApiCall(querySet, operationType, args);
     }
 }

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

@@ -2,7 +2,7 @@
  * A compiled AST that can be serialized and later executed via Model.execute().
  *
  * @typedef {Object} CompiledAST
- * @property {string} op - The operation type (e.g. 'list', 'get', 'create').
+ * @property {string} type - The operation type (e.g. 'read', 'get', 'create').
  * @property {Object} args - Operation-specific arguments.
  * @property {Object|null} filter - The filter AST node.
  * @property {Object|null} search - The search configuration.
@@ -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.
      *
@@ -335,9 +345,9 @@ export class QuerySet<T> {
  */
 export type CompiledAST = {
     /**
-     * - The operation type (e.g. 'list', 'get', 'create').
+     * - The operation type (e.g. 'read', 'get', 'create').
      */
-    op: string;
+    type: string;
     /**
      * - Operation-specific arguments.
      */

package/dist/flavours/django/querySet.js

@@ -11,7 +11,7 @@ const clone = rfdc();
  * A compiled AST that can be serialized and later executed via Model.execute().
  *
  * @typedef {Object} CompiledAST
- * @property {string} op - The operation type (e.g. 'list', 'get', 'create').
+ * @property {string} type - The operation type (e.g. 'read', 'get', 'create').
  * @property {Object} args - Operation-specific arguments.
  * @property {Object|null} filter - The filter AST node.
  * @property {Object|null} search - The search configuration.
@@ -666,11 +666,11 @@ export class QuerySet {
      * @returns {CompiledAST} The compiled AST.
      */
     _compile(op, args = {}) {
-        return { op, args, ...this.build() };
+        return { type: op, args, ...this.build() };
     }
     get compile() {
         return {
-            fetch: (args) => this._compile('list', args),
+            fetch: (args) => this._compile('read', args),
             get: (args) => this._compile('get', args),
             first: (args) => this._compile('first', args),
             last: (args) => this._compile('last', args),
@@ -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);
@@ -759,7 +788,7 @@ export class QuerySet {
             ...querySet._getConfig(),
             materialized: true,
         }, this);
-        return QueryExecutor.execute(materializedQs, "list");
+        return QueryExecutor.execute(materializedQs, "read");
     }
     /**
      * Implements the async iterator protocol so that you can iterate over the QuerySet.

package/dist/syncEngine/registries/querysetStoreRegistry.js

@@ -182,9 +182,9 @@ export class QuerysetStoreRegistry {
             // queryset back to the registry / store
             const payload = {
                 ...ast,
-                type: 'list'
+                type: 'read'
             };
-            const response = await makeApiCall(queryset, 'list', payload, null, // operationId
+            const response = await makeApiCall(queryset, 'read', payload, null, // operationId
             null, // beforeExit
             canonical_id, // canonical_id for caching
             { namespace: 'sync', timeout: 30000 } // Sync ops on separate queue

package/package.json

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