@statezero/core 0.2.55 → 0.2.58

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

@@ -927,9 +927,10 @@ class fe extends Error {
    * @param {string} code - The error code.
    * @param {IErrorDetail|Object|string} detail - The error details.
    * @param {number} status - The HTTP status code.
+   * @param {Object} [data={}] - Additional structured data from the server.
    */
-  constructor(e, t, s, r) {
-    super(e), this.name = "StateZeroError", this.code = t, this.detail = s, this.status = r, Object.setPrototypeOf(this, new.target.prototype), As(this);
+  constructor(e, t, s, r, o = {}) {
+    super(e), this.name = "StateZeroError", this.code = t, this.detail = s, this.status = r, this.data = o, Object.setPrototypeOf(this, new.target.prototype), As(this);
   }
   /**
    * Returns a full error message including the detail.
@@ -1029,7 +1030,7 @@ class U extends fe {
   }
 }
 function Fs(n) {
-  const { status: e, type: t, detail: s } = n;
+  const { status: e, type: t, detail: s, data: r } = n;
   if (t === void 0 && s === "Invalid token.")
     return new lt(s, 403);
   switch (t) {
@@ -1054,7 +1055,13 @@ function Fs(n) {
     case "ValueError":
       return new $e(s, e);
     default:
-      return e === 400 ? new $e(s, e) : e === 403 ? new lt(s, e) : e === 404 ? new It(s, e) : e === 409 ? new Nt(s, e) : new fe("Unknown error", "unknown", s, e);
+      return e === 400 ? new $e(s, e) : e === 403 ? new lt(s, e) : e === 404 ? new It(s, e) : e === 409 ? new Nt(s, e) : new fe(
+        s || "Unknown error",
+        t || "unknown",
+        s,
+        e,
+        r || {}
+      );
   }
 }
 const xt = {
@@ -2673,8 +2680,8 @@ class ar {
   _hasRecentOps(e) {
     const t = e.operations, s = this.lastSync ?? this._createdAt;
     for (let r = t.length - 1; r >= 0; r--)
-      if (t[r].status !== C.REJECTED)
-        return t[r].status !== C.CONFIRMED ? !0 : t[r].timestamp >= s;
+      if (t[r].status !== C.REJECTED && (t[r].status !== C.CONFIRMED || t[r].timestamp >= s))
+        return !0;
     return !1;
   }
   /** Build set of PKs from ops newer than lastSync. Only used for no-offset querysets. */

package/dist/cli/commands/syncModels.js

@@ -248,7 +248,7 @@ const TS_DECLARATION_TEMPLATE = `/**
 
 import { Model, Manager } from '{{modulePath}}';
 import { StringOperators, NumberOperators, BooleanOperators, DateOperators } from '{{modulePath}}';
-import { QuerySet, LiveQuerySet, LiveQuerySetOptions, MetricResult, ResultTuple, SerializerOptions, NestedPaths } from '{{modulePath}}';
+import { QuerySet, LiveQuerySet, LiveQuerySetOptions, MetricResult, ResultTuple, SerializerOptions, NestedPaths, CompiledAST } from '{{modulePath}}';
 
 // Re-export the real Manager for runtime use
 import { Manager as RuntimeManager } from '{{modulePath}}';
@@ -387,6 +387,26 @@ export declare class {{className}}QuerySet extends QuerySet<any> {
   delete(): Promise<[number, Record<string, number>]>;
   exists(): Promise<boolean>;
   fetch(serializerOptions?: SerializerOptions): Promise<{{className}}[]>;
+
+  // Compile
+  get compile(): {
+    fetch(args?: Record<string, any>): CompiledAST;
+    get(args?: Record<string, any>): CompiledAST;
+    first(args?: Record<string, any>): CompiledAST;
+    last(args?: Record<string, any>): CompiledAST;
+    count(args?: Record<string, any>): CompiledAST;
+    sum(args?: Record<string, any>): CompiledAST;
+    avg(args?: Record<string, any>): CompiledAST;
+    min(args?: Record<string, any>): CompiledAST;
+    max(args?: Record<string, any>): CompiledAST;
+    exists(args?: Record<string, any>): CompiledAST;
+    create(args?: Record<string, any>): CompiledAST;
+    bulkCreate(args?: Record<string, any>): CompiledAST;
+    update(args?: Record<string, any>): CompiledAST;
+    delete(args?: Record<string, any>): CompiledAST;
+    getOrCreate(args?: Record<string, any>): CompiledAST;
+    updateOrCreate(args?: Record<string, any>): CompiledAST;
+  };
 }
 
 /**
@@ -400,6 +420,7 @@ export declare class {{className}}Manager extends Manager {
   get(filters?: {{className}}FilterData, serializerOptions?: SerializerOptions): Promise<{{className}}>;
   create(data: {{className}}CreateData): Promise<{{className}}>;
   delete(): Promise<[number, Record<string, number>]>;
+  execute(ast: CompiledAST): Promise<any>;
 }
 
 /**
@@ -471,6 +492,7 @@ export declare class {{className}} extends Model implements {{interfaceName}} {
 
   constructor(data: Partial<{{interfaceName}}>);
   serialize(): Partial<{{interfaceName}}>;
+  static execute(ast: CompiledAST): Promise<any>;
 }
 
 /**

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

@@ -28,11 +28,13 @@ export class StateZeroError extends Error {
      * @param {string} code - The error code.
      * @param {IErrorDetail|Object|string} detail - The error details.
      * @param {number} status - The HTTP status code.
+     * @param {Object} [data={}] - Additional structured data from the server.
      */
-    constructor(message: string, code: string, detail: IErrorDetail | Object | string, status: number);
+    constructor(message: string, code: string, detail: IErrorDetail | Object | string, status: number, data?: Object);
     code: string;
     detail: string | Object | IErrorDetail;
     status: number;
+    data: Object;
     /**
      * Returns a full error message including the detail.
      *

package/dist/flavours/django/errors.js

@@ -21,13 +21,15 @@ export class StateZeroError extends Error {
      * @param {string} code - The error code.
      * @param {IErrorDetail|Object|string} detail - The error details.
      * @param {number} status - The HTTP status code.
+     * @param {Object} [data={}] - Additional structured data from the server.
      */
-    constructor(message, code, detail, status) {
+    constructor(message, code, detail, status, data = {}) {
         super(message);
         this.name = "StateZeroError";
         this.code = code;
         this.detail = detail;
         this.status = status;
+        this.data = data;
         Object.setPrototypeOf(this, new.target.prototype);
         emitError(this);
     }
@@ -169,7 +171,7 @@ export class ConfigError extends StateZeroError {
  * @returns {StateZeroError} An instance of a StateZeroError subclass.
  */
 export function parseStateZeroError(errorResponse) {
-    const { status, type, detail } = errorResponse;
+    const { status, type, detail, data } = errorResponse;
     // Handle undefined type/status case (like in permission denied)
     if (type === undefined && detail === 'Invalid token.') {
         return new PermissionDenied(detail, 403);
@@ -209,6 +211,6 @@ export function parseStateZeroError(errorResponse) {
             else if (status === 409) {
                 return new ConflictError(detail, status);
             }
-            return new StateZeroError("Unknown error", "unknown", detail, status);
+            return new StateZeroError(detail || "Unknown error", type || "unknown", detail, status, data || {});
     }
 }

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

@@ -157,6 +157,13 @@ export class Manager {
      * and a boolean indicating whether it was created.
      */
     updateOrCreate(lookupFields: any, defaults?: Object): Promise<ResultTuple>;
+    /**
+     * Executes a pre-compiled AST through the standard QueryExecutor path.
+     *
+     * @param {import('./querySet.js').CompiledAST} ast - A compiled AST from QuerySet.compile()
+     * @returns {Promise<any>} The query result.
+     */
+    execute(ast: import("./querySet.js").CompiledAST): Promise<any>;
     /**
      * Applies a search to the QuerySet using the specified search query and fields.
      *

package/dist/flavours/django/manager.js

@@ -200,6 +200,18 @@ export class Manager {
     async updateOrCreate(lookupFields, defaults = {}) {
         return this.newQuerySet().updateOrCreate(lookupFields, defaults);
     }
+    /**
+     * Executes a pre-compiled AST through the standard QueryExecutor path.
+     *
+     * @param {import('./querySet.js').CompiledAST} ast - A compiled AST from QuerySet.compile()
+     * @returns {Promise<any>} The query result.
+     */
+    execute(ast) {
+        const { op, 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 || {});
+    }
     /**
      * Applies a search to the QuerySet using the specified search query and fields.
      *

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

@@ -47,6 +47,13 @@ export class Model {
      * @returns {Promise<boolean>} Promise that resolves to true if valid, throws error if invalid
      */
     static validate(data: Object, validateType?: string, partial?: boolean): Promise<boolean>;
+    /**
+     * Executes a pre-compiled AST through the standard QueryExecutor path.
+     *
+     * @param {import('./querySet.js').CompiledAST} ast - A compiled AST from QuerySet.compile()
+     * @returns {Promise<any>} The query result.
+     */
+    static execute(ast: import("./querySet.js").CompiledAST): Promise<any>;
     /**
      * 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

@@ -313,6 +313,15 @@ export class Model {
             throw new Error(`Validation failed: ${error.message}`);
         }
     }
+    /**
+     * Executes a pre-compiled AST through the standard QueryExecutor path.
+     *
+     * @param {import('./querySet.js').CompiledAST} ast - A compiled AST from QuerySet.compile()
+     * @returns {Promise<any>} The query result.
+     */
+    static execute(ast) {
+        return this.objects.execute(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

@@ -1,3 +1,15 @@
+/**
+ * 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 {Object} args - Operation-specific arguments.
+ * @property {Object|null} filter - The filter AST node.
+ * @property {Object|null} search - The search configuration.
+ * @property {Array} aggregations - Aggregation operations.
+ * @property {Array<string>} [orderBy] - Ordering fields.
+ * @property {Object} serializerOptions - Serializer options.
+ */
 /**
  * A QuerySet provides a fluent API for constructing and executing queries.
  *
@@ -273,9 +285,30 @@ export class QuerySet<T> {
     /**
      * Builds the final query object to be sent to the backend (simple jsonable object format).
      *
-     * @returns {Object} The final query object.
-     */
-    build(): Object;
+     * @param {string} op - The operation type.
+     * @param {Object} [args={}] - Operation-specific arguments.
+     * @returns {CompiledAST} The compiled AST.
+     */
+    _compile(op: string, args?: Object): CompiledAST;
+    get compile(): {
+        fetch: (args: any) => CompiledAST;
+        get: (args: any) => CompiledAST;
+        first: (args: any) => CompiledAST;
+        last: (args: any) => CompiledAST;
+        count: (args: any) => CompiledAST;
+        sum: (args: any) => CompiledAST;
+        avg: (args: any) => CompiledAST;
+        min: (args: any) => CompiledAST;
+        max: (args: any) => CompiledAST;
+        exists: (args: any) => CompiledAST;
+        create: (args: any) => CompiledAST;
+        bulkCreate: (args: any) => CompiledAST;
+        update: (args: any) => CompiledAST;
+        delete: (args: any) => CompiledAST;
+        getOrCreate: (args: any) => CompiledAST;
+        updateOrCreate: (args: any) => CompiledAST;
+    };
+    build(): any;
     /**
      * Returns the current configuration of the QuerySet.
      *
@@ -297,5 +330,38 @@ export class QuerySet<T> {
      */
     [Symbol.asyncIterator](): AsyncIterator<T>;
 }
+/**
+ * A compiled AST that can be serialized and later executed via Model.execute().
+ */
+export type CompiledAST = {
+    /**
+     * - The operation type (e.g. 'list', 'get', 'create').
+     */
+    op: string;
+    /**
+     * - Operation-specific arguments.
+     */
+    args: Object;
+    /**
+     * - The filter AST node.
+     */
+    filter: Object | null;
+    /**
+     * - The search configuration.
+     */
+    search: Object | null;
+    /**
+     * - Aggregation operations.
+     */
+    aggregations: any[];
+    /**
+     * - Ordering fields.
+     */
+    orderBy?: string[] | undefined;
+    /**
+     * - Serializer options.
+     */
+    serializerOptions: Object;
+};
 import { ModelSerializer } from "./serializers.js";
 import { Model } from "./model.js";

package/dist/flavours/django/querySet.js

@@ -7,6 +7,18 @@ import { v7 } from "uuid";
 import hash from "object-hash";
 import rfdc from "rfdc";
 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 {Object} args - Operation-specific arguments.
+ * @property {Object|null} filter - The filter AST node.
+ * @property {Object|null} search - The search configuration.
+ * @property {Array} aggregations - Aggregation operations.
+ * @property {Array<string>} [orderBy] - Ordering fields.
+ * @property {Object} serializerOptions - Serializer options.
+ */
 /**
  * A QuerySet provides a fluent API for constructing and executing queries.
  *
@@ -649,9 +661,36 @@ export class QuerySet {
     /**
      * Builds the final query object to be sent to the backend (simple jsonable object format).
      *
-     * @returns {Object} The final query object.
+     * @param {string} op - The operation type.
+     * @param {Object} [args={}] - Operation-specific arguments.
+     * @returns {CompiledAST} The compiled AST.
      */
+    _compile(op, args = {}) {
+        return { op, args, ...this.build() };
+    }
+    get compile() {
+        return {
+            fetch: (args) => this._compile('list', args),
+            get: (args) => this._compile('get', args),
+            first: (args) => this._compile('first', args),
+            last: (args) => this._compile('last', args),
+            count: (args) => this._compile('count', args),
+            sum: (args) => this._compile('sum', args),
+            avg: (args) => this._compile('avg', args),
+            min: (args) => this._compile('min', args),
+            max: (args) => this._compile('max', args),
+            exists: (args) => this._compile('exists', args),
+            create: (args) => this._compile('create', args),
+            bulkCreate: (args) => this._compile('bulk_create', args),
+            update: (args) => this._compile('update', args),
+            delete: (args) => this._compile('delete', args),
+            getOrCreate: (args) => this._compile('get_or_create', args),
+            updateOrCreate: (args) => this._compile('update_or_create', args),
+        };
+    }
     build() {
+        if (this._prebuiltAST)
+            return clone(this._prebuiltAST);
         let searchData = null;
         const nonSearchNodes = [];
         for (const node of this.nodes) {

package/dist/models/backend1/django_app/author.schema.json

@@ -5,33 +5,33 @@
     "plural_title": "Authors",
     "primary_key_field": "id",
     "filterable_fields": [
-        "metadata",
-        "rating",
-        "name",
-        "created_at",
         "salary",
-        "email",
+        "is_active",
         "slug",
-        "bio",
-        "website",
+        "name",
+        "rating",
         "uuid",
+        "bio",
+        "birth_date",
+        "email",
         "age",
+        "created_at",
         "id",
-        "is_active",
-        "birth_date"
+        "website",
+        "metadata"
     ],
     "searchable_fields": [
         "bio",
-        "name",
-        "email"
+        "email",
+        "name"
     ],
     "ordering_fields": [
-        "rating",
-        "name",
-        "created_at",
         "salary",
+        "name",
+        "rating",
+        "birth_date",
         "age",
-        "birth_date"
+        "created_at"
     ],
     "properties": {
         "id": {
@@ -235,7 +235,7 @@
             "format": null,
             "max_length": 32,
             "choices": null,
-            "default": "5782fd03-d9b2-4d2c-9d50-e46a4beca539",
+            "default": "79fc79e3-5653-4c96-8419-a5a18616bc2e",
             "validators": [],
             "max_digits": null,
             "decimal_places": null,

package/dist/models/backend1/django_app/book.schema.json

@@ -5,31 +5,31 @@
     "plural_title": "Books",
     "primary_key_field": "id",
     "filterable_fields": [
-        "weight",
         "last_updated",
-        "metadata",
+        "description",
+        "publish_date",
         "pages",
-        "author",
-        "price",
         "title",
         "isbn",
-        "is_published",
+        "price",
         "id",
-        "publish_date",
-        "description"
+        "weight",
+        "author",
+        "metadata",
+        "is_published"
     ],
     "searchable_fields": [
-        "isbn",
         "title",
+        "isbn",
         "description"
     ],
     "ordering_fields": [
-        "weight",
         "last_updated",
+        "publish_date",
         "pages",
-        "price",
         "title",
-        "publish_date"
+        "price",
+        "weight"
     ],
     "properties": {
         "id": {

package/dist/models/backend1/django_app/composeditem.schema.json

@@ -5,11 +5,11 @@
     "plural_title": "Composed Items",
     "primary_key_field": "id",
     "filterable_fields": [
-        "secret",
         "name",
-        "value",
         "owner",
-        "id"
+        "secret",
+        "id",
+        "value"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/comprehensivemodel.schema.json

@@ -5,8 +5,8 @@
     "plural_title": "Comprehensive Models",
     "primary_key_field": "id",
     "filterable_fields": [
-        "int_field",
-        "char_field"
+        "char_field",
+        "int_field"
     ],
     "searchable_fields": [
         "char_field",
@@ -105,7 +105,7 @@
             "format": "date-time",
             "max_length": null,
             "choices": null,
-            "default": "2026-02-23T18:47:00.073642+00:00",
+            "default": "2026-02-28T23:13:32.583653+00:00",
             "validators": [],
             "max_digits": null,
             "decimal_places": null,

package/dist/models/backend1/django_app/dailyrate.schema.json

@@ -5,16 +5,16 @@
     "plural_title": "Daily Rates",
     "primary_key_field": "id",
     "filterable_fields": [
-        "min_stay_arrival",
-        "price",
-        "rate_plan",
-        "min_stay_through",
-        "stop_sell",
         "closed_to_arrival",
-        "max_stay",
+        "min_stay_through",
+        "min_stay_arrival",
+        "closed_to_departure",
         "date",
+        "max_stay",
+        "price",
         "id",
-        "closed_to_departure"
+        "stop_sell",
+        "rate_plan"
     ],
     "searchable_fields": [],
     "ordering_fields": [

package/dist/models/backend1/django_app/errortestcompoundunique.schema.json

@@ -5,18 +5,18 @@
     "plural_title": "Error Test Compound Uniques",
     "primary_key_field": "id",
     "filterable_fields": [
+        "rank",
         "label",
         "id",
-        "group",
-        "rank"
+        "group"
     ],
     "searchable_fields": [
         "label",
         "group"
     ],
     "ordering_fields": [
-        "group",
-        "rank"
+        "rank",
+        "group"
     ],
     "properties": {
         "id": {

package/dist/models/backend1/django_app/errortestonetoonemodel.schema.json

@@ -5,9 +5,9 @@
     "plural_title": "Error Test One To One Models",
     "primary_key_field": "id",
     "filterable_fields": [
-        "note",
+        "parent",
         "id",
-        "parent"
+        "note"
     ],
     "searchable_fields": [],
     "ordering_fields": [],

package/dist/models/backend1/django_app/errortestprotectedchild.schema.json

@@ -5,9 +5,9 @@
     "plural_title": "Error Test Protected Childs",
     "primary_key_field": "id",
     "filterable_fields": [
+        "parent",
         "id",
-        "name",
-        "parent"
+        "name"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/errortestuniquemodel.schema.json

@@ -5,8 +5,8 @@
     "plural_title": "Error Test Unique Models",
     "primary_key_field": "id",
     "filterable_fields": [
-        "label",
         "id",
+        "label",
         "code"
     ],
     "searchable_fields": [

package/dist/models/backend1/django_app/excludeditem.schema.json

@@ -6,9 +6,9 @@
     "primary_key_field": "id",
     "filterable_fields": [
         "value",
-        "secret",
         "id",
-        "name"
+        "name",
+        "secret"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/hfchild.schema.json

@@ -5,9 +5,9 @@
     "plural_title": "Hf Childs",
     "primary_key_field": "id",
     "filterable_fields": [
+        "parent",
         "id",
-        "name",
-        "parent"
+        "name"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/hfparent.schema.json

@@ -6,9 +6,9 @@
     "primary_key_field": "id",
     "filterable_fields": [
         "value",
-        "secret",
         "id",
-        "name"
+        "name",
+        "secret"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/index.js

@@ -38,3 +38,5 @@ export * from './errortestuniquemodel';
 export * from './errortestonetoonemodel';
 export * from './errortestcompoundunique';
 export * from './updateonlyitem';
+export * from './uuiduser';
+export * from './uuidmessage';

package/dist/models/backend1/django_app/m2mdepthtestlevel1.schema.json

@@ -6,8 +6,8 @@
     "primary_key_field": "id",
     "filterable_fields": [
         "level2s",
-        "id",
-        "name"
+        "name",
+        "id"
     ],
     "searchable_fields": [
         "name"

package/dist/models/backend1/django_app/m2mdepthtestlevel2.schema.json

@@ -5,9 +5,9 @@
     "plural_title": "M2M Depth Test Level2S",
     "primary_key_field": "id",
     "filterable_fields": [
+        "level3s",
         "id",
-        "name",
-        "level3s"
+        "name"
     ],
     "searchable_fields": [
         "name"