@statezero/core 0.2.15 → 0.2.17

package/dist/core/eventReceivers.d.ts

@@ -71,7 +71,7 @@ export class PusherEventReceiver {
     constructor(options: PusherReceiverOptions, configKey: string);
     configKey: string;
     connectionTimeoutId: NodeJS.Timeout;
-    pusherClient: Pusher;
+    pusherClient: any;
     formatChannelName: (arg0: string) => string;
     namespaceResolver: NamespaceResolver;
     channels: Map<any, any>;
@@ -183,4 +183,3 @@ export type PusherReceiverOptions = {
      */
     namespaceResolver?: NamespaceResolver | undefined;
 };
-import Pusher from "pusher-js";

package/dist/core/eventReceivers.js

@@ -106,22 +106,22 @@ export class PusherEventReceiver {
      * @param {string} reason
      */
     _logConnectionError(reason) {
-        console.error(`%c
-████████████████████████████████████████████████████████████████
-█                                                              █
-█   PUSHER CONNECTION FAILED for backend: "${this.configKey}"  █
-█                                                              █
-████████████████████████████████████████████████████████████████
-%c
-Reason: ${reason}
-
-CRITICAL: Real-time updates from the server will NOT be received.
-This application will not reflect remote changes propagated via Pusher.
-
-Common causes:
-1. Incorrect 'appKey' or 'cluster' in the configuration.
-2. The 'authEndpoint' is unreachable or returning an error (check network tab).
-3. Network connectivity issues (firewall, offline).
+        console.error(`%c
+████████████████████████████████████████████████████████████████
+█                                                              █
+█   PUSHER CONNECTION FAILED for backend: "${this.configKey}"  █
+█                                                              █
+████████████████████████████████████████████████████████████████
+%c
+Reason: ${reason}
+
+CRITICAL: Real-time updates from the server will NOT be received.
+This application will not reflect remote changes propagated via Pusher.
+
+Common causes:
+1. Incorrect 'appKey' or 'cluster' in the configuration.
+2. The 'authEndpoint' is unreachable or returning an error (check network tab).
+3. Network connectivity issues (firewall, offline).
 4. Using an 'app_id' instead of the 'appKey'.`, "background-color: red; color: white; font-weight: bold; font-size: 16px; padding: 10px;", "color: red; font-size: 12px;");
     }
     /**

package/dist/flavours/django/f.js

@@ -1,4 +1,4 @@
-import { ValidationError } from './errors';
+import { ValidationError } from './errors.js';
 import * as math from 'mathjs';
 // Create a math instance
 const mathInstance = math.create();

package/dist/flavours/django/model.js

@@ -2,7 +2,7 @@ import { Manager } from "./manager.js";
 import { ValidationError } from "./errors.js";
 import { modelStoreRegistry } from "../../syncEngine/registries/modelStoreRegistry.js";
 import { isNil } from "lodash-es";
-import { QueryExecutor } from "./queryExecutor";
+import { QueryExecutor } from "./queryExecutor.js";
 import { wrapReactiveModel } from "../../reactiveAdaptor.js";
 import { DateParsingHelpers } from "./dates.js";
 import { FileObject } from './files.js';

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

@@ -70,4 +70,4 @@ export class OperationFactory {
      */
     static createUpdateOrCreateOperation(queryset: QuerySet, lookup?: Object, defaults?: Object, operationId?: string): Operation;
 }
-import { Operation } from '../../syncEngine/stores/operation';
+import { Operation } from '../../syncEngine/stores/operation.js';

package/dist/flavours/django/operationFactory.js

@@ -1,4 +1,4 @@
-import { Operation, Type, Status } from '../../syncEngine/stores/operation';
+import { Operation, Type, Status } from '../../syncEngine/stores/operation.js';
 import { v7 as uuid7 } from 'uuid';
 import { createTempPk } from './tempPk.js';
 import { getRequiredFields, pickRequiredFields, processQuery } from '../../filtering/localFiltering.js';

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

@@ -1,3 +1,12 @@
+/**
+ * Serializes an action payload based on the action's input schema.
+ * Automatically handles model instances (extracts PK), files, dates, etc.
+ *
+ * @param {Object} payload - The raw payload with potentially model instances
+ * @param {Object} inputProperties - The action's input_properties schema
+ * @returns {Object} Serialized payload ready for API transmission
+ */
+export function serializeActionPayload(payload: Object, inputProperties: Object): Object;
 export namespace fileFieldSerializer {
     function toInternal(value: any, context?: {}): any;
     function toLive(value: any, context?: {}): any;

package/dist/flavours/django/serializers.js

@@ -186,6 +186,37 @@ const serializers = {
         "many-to-many": m2mFieldSerializer,
     },
 };
+/**
+ * Serializes an action payload based on the action's input schema.
+ * Automatically handles model instances (extracts PK), files, dates, etc.
+ *
+ * @param {Object} payload - The raw payload with potentially model instances
+ * @param {Object} inputProperties - The action's input_properties schema
+ * @returns {Object} Serialized payload ready for API transmission
+ */
+export function serializeActionPayload(payload, inputProperties) {
+    if (!payload || !inputProperties)
+        return payload;
+    const serializedPayload = {};
+    for (const [field, value] of Object.entries(payload)) {
+        const fieldSchema = inputProperties[field];
+        if (!fieldSchema || value === undefined) {
+            serializedPayload[field] = value;
+            continue;
+        }
+        const { type, format } = fieldSchema;
+        // Check if we have a serializer for this type/format combo
+        const typeSerializers = serializers[type];
+        const serializer = typeSerializers?.[format];
+        if (serializer) {
+            serializedPayload[field] = serializer.toInternal(value, { field });
+        }
+        else {
+            serializedPayload[field] = value;
+        }
+    }
+    return serializedPayload;
+}
 export class ModelSerializer {
     constructor(modelClass) {
         this.modelClass = modelClass;

package/dist/index.d.ts

@@ -36,4 +36,5 @@ import { cleanupEventHandler } from "./syncEngine/stores/operationEventHandlers.
 import { setAdapters } from "./reactiveAdaptor.js";
 import { wrapReactiveModel } from "./reactiveAdaptor.js";
 import { wrapReactiveQuerySet } from "./reactiveAdaptor.js";
-export { EventType, PusherEventReceiver, setEventReceiver, getEventReceiver, setNamespaceResolver, setupStateZero, resetStateZero, FileObject, querysetStoreRegistry, modelStoreRegistry, metricRegistry, syncManager, Operation, operationRegistry, Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObjectsReturned, ASTValidationError, ConfigError, parseStateZeroError, QuerySet, Manager, ResultTuple, Model, setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet };
+import { serializeActionPayload } from "./flavours/django/serializers.js";
+export { EventType, PusherEventReceiver, setEventReceiver, getEventReceiver, setNamespaceResolver, setupStateZero, resetStateZero, FileObject, querysetStoreRegistry, modelStoreRegistry, metricRegistry, syncManager, Operation, operationRegistry, Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObjectsReturned, ASTValidationError, ConfigError, parseStateZeroError, QuerySet, Manager, ResultTuple, Model, setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, serializeActionPayload };

package/dist/index.js

@@ -13,6 +13,7 @@ import { QuerySet } from "./flavours/django/querySet.js";
 import { Manager } from "./flavours/django/manager.js";
 import { Model } from "./flavours/django/model.js";
 import { FileObject } from "./flavours/django/files.js";
+import { serializeActionPayload } from "./flavours/django/serializers.js";
 // Configuration
 import { setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, } from "./config.js";
 import { setAdapters, wrapReactiveModel, wrapReactiveQuerySet, } from "./reactiveAdaptor.js";
@@ -36,4 +37,6 @@ Q, StateZeroError, ValidationError, DoesNotExist, PermissionDenied, MultipleObje
 // Configuration
 setConfig, getConfig, setBackendConfig, initializeEventReceiver, configInstance, getModelClass, 
 // Reactivity framework integration
-initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, };
+initEventHandler, cleanupEventHandler, setAdapters, wrapReactiveModel, wrapReactiveQuerySet, 
+// Action utilities
+serializeActionPayload, };

package/dist/syncEngine/metrics/metricOptCalcs.js

@@ -4,7 +4,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _a, _MetricStrategyFactory_customStrategies, _MetricStrategyFactory_defaultStrategies, _MetricStrategyFactory_generateStrategyKey;
-import { Status, Type } from '../stores/operation';
+import { Status, Type } from '../stores/operation.js';
 import { isNil } from 'lodash-es';
 /**
  * Base class for metric calculation strategies with operations

package/dist/syncEngine/registries/metricRegistry.d.ts

@@ -7,7 +7,7 @@ export class LiveMetric {
     queryset: any;
     metricType: any;
     field: any;
-    get lqs(): import("./querysetStoreRegistry").LiveQueryset;
+    get lqs(): import("./querysetStoreRegistry.js").LiveQueryset;
     /**
      * Refresh the metric data from the database
      * Delegates to the underlying store's sync method

package/dist/syncEngine/registries/metricRegistry.js

@@ -1,7 +1,7 @@
-import { MetricStore } from '../stores/metricStore';
+import { MetricStore } from '../stores/metricStore.js';
 import { isNil, isEmpty } from 'lodash-es';
-import { querysetStoreRegistry } from './querysetStoreRegistry';
-import { QueryExecutor } from '../../flavours/django/queryExecutor';
+import { querysetStoreRegistry } from './querysetStoreRegistry.js';
+import { QueryExecutor } from '../../flavours/django/queryExecutor.js';
 import { wrapReactiveMetric } from '../../reactiveAdaptor.js';
 import hash from 'object-hash';
 /**

package/dist/syncEngine/stores/metricStore.d.ts

@@ -11,7 +11,7 @@ export class MetricStore {
     fetchFn: any;
     groundTruthValue: any;
     isSyncing: boolean;
-    strategy: import("../metrics/metricOptCalcs").MetricCalculationStrategy;
+    strategy: import("../metrics/metricOptCalcs.js").MetricCalculationStrategy;
     operations: any[];
     confirmedOps: Set<any>;
     metricCache: Cache;

package/dist/syncEngine/stores/metricStore.js

@@ -1,5 +1,5 @@
 import { Cache } from '../cache/cache.js';
-import { MetricStrategyFactory } from "../metrics/metricOptCalcs";
+import { MetricStrategyFactory } from "../metrics/metricOptCalcs.js";
 import hash from 'object-hash';
 import { isNil, isEmpty, isEqual } from 'lodash-es';
 import { metricEventEmitter } from './reactivity.js';

package/dist/syncEngine/stores/operation.d.ts

@@ -1,4 +1,4 @@
-export const operationEvents: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
+export const operationEvents: any;
 export namespace Status {
     let CREATED: string;
     let UPDATED: string;

package/dist/syncEngine/stores/operation.js

@@ -13,7 +13,7 @@ var _Operation__instances, _Operation__frozenInstances;
 import { MAX, v7 as uuidv7 } from "uuid";
 import { isNil } from 'lodash-es';
 import mitt from 'mitt';
-import { tempPkMap } from "../../flavours/django/tempPk";
+import { tempPkMap } from "../../flavours/django/tempPk.js";
 import { modelStoreRegistry } from "../registries/modelStoreRegistry.js";
 export const operationEvents = mitt();
 export const Status = {

package/dist/syncEngine/stores/reactivity.d.ts

@@ -1,3 +1,3 @@
-export const modelEventEmitter: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
-export const querysetEventEmitter: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
-export const metricEventEmitter: import("mitt").Emitter<Record<import("mitt").EventType, unknown>>;
+export const modelEventEmitter: any;
+export const querysetEventEmitter: any;
+export const metricEventEmitter: any;

package/dist/syncEngine/stores/utils.js

@@ -1,5 +1,5 @@
 import { isNil, isEqual } from 'lodash-es';
-import { filter } from '../../filtering/localFiltering';
+import { filter } from '../../filtering/localFiltering.js';
 /**
  * Guarantees an array of operations, is an array of operations. Handles
  * the basic failure case of a single operation.

package/dist/syncEngine/sync.d.ts

@@ -22,7 +22,8 @@ export class SyncManager {
     debounceMs: number;
     maxWaitMs: number;
     batchStartTime: number | null;
-    syncQueue: PQueue<import("p-queue/dist/priority-queue").default, import("p-queue").QueueAddOptions>;
+    /** @type {PQueue} */
+    syncQueue: PQueue;
     withTimeout(promise: any, ms: any): Promise<any>;
     /**
      * Initialize event handlers for all event receivers

package/dist/syncEngine/sync.js

@@ -1,13 +1,13 @@
-import { getAllEventReceivers } from "../core/eventReceivers";
-import { operationRegistry } from "./stores/operation";
-import { initializeAllEventReceivers } from "../config";
-import { getEventReceiver } from "../core/eventReceivers";
-import { querysetStoreRegistry, QuerysetStoreRegistry, } from "./registries/querysetStoreRegistry";
-import { modelStoreRegistry, ModelStoreRegistry, } from "./registries/modelStoreRegistry";
-import { metricRegistry, MetricRegistry } from "./registries/metricRegistry";
-import { getModelClass, getConfig } from "../config";
+import { getAllEventReceivers } from "../core/eventReceivers.js";
+import { operationRegistry } from "./stores/operation.js";
+import { initializeAllEventReceivers } from "../config.js";
+import { getEventReceiver } from "../core/eventReceivers.js";
+import { querysetStoreRegistry, QuerysetStoreRegistry, } from "./registries/querysetStoreRegistry.js";
+import { modelStoreRegistry, ModelStoreRegistry, } from "./registries/modelStoreRegistry.js";
+import { metricRegistry, MetricRegistry } from "./registries/metricRegistry.js";
+import { getModelClass, getConfig } from "../config.js";
 import { isNil } from "lodash-es";
-import { QuerysetStore } from "./stores/querysetStore";
+import { QuerysetStore } from "./stores/querysetStore.js";
 import PQueue from "p-queue";
 export class EventPayload {
     constructor(data) {
@@ -96,6 +96,7 @@ export class SyncManager {
         this.maxWaitMs = 2000; // Maximum time to hold events
         this.batchStartTime = null;
         // SyncQueue
+        /** @type {PQueue} */
         this.syncQueue = new PQueue({ concurrency: 1 });
     }
     withTimeout(promise, ms) {

package/package.json

@@ -1,126 +1,126 @@
-{
-  "name": "@statezero/core",
-  "version": "0.2.15",
-  "type": "module",
-  "module": "ESNext",
-  "description": "The type-safe frontend client for StateZero - connect directly to your backend models with zero boilerplate",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "statezero": "dist/cli/index.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    },
-    "./cli": {
-      "import": "./dist/cli/index.js",
-      "require": "./dist/cli/index.js"
-    },
-    "./react": {
-      "import": "./dist/react-entry.js",
-      "require": "./dist/react-entry.js"
-    },
-    "./vue": {
-      "import": "./dist/vue-entry.js",
-      "require": "./dist/vue-entry.js"
-    }
-  },
-  "scripts": {
-    "test": "vitest run --config=vitest.base.config.ts",
-    "test:e2e": "vitest run --config=vitest.sequential.config.ts tests/e2e",
-    "generate:test-apps": "ts-node scripts/generate-test-apps.js",
-    "test:adaptors": "playwright test tests/adaptors",
-    "test:coverage": "vitest run --coverage",
-    "build": "tsc",
-    "parse-queries": "node scripts/perfect-query-parser.js",
-    "sync": "node src/cli/index.js sync",
-    "sync:dev": "npx cross-env NODE_ENV=test npm run sync",
-    "sync-models": "node src/cli/index.js sync-models",
-    "sync-models:dev": "npx cross-env NODE_ENV=test npm run sync-models",
-    "sync-actions": "node src/cli/index.js sync-actions",
-    "sync-actions:dev": "npx cross-env NODE_ENV=test npm run sync-actions",
-    "clean": "npx rimraf dist",
-    "prepare": "npm run clean && npm run build",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-  "keywords": [
-    "typescript",
-    "orm",
-    "backend",
-    "frontend",
-    "database",
-    "sql",
-    "django",
-    "sqlalchemy",
-    "react",
-    "vue",
-    "svelte"
-  ],
-  "author": "Robert Herring <robert.herring@resipilot.com>",
-  "license": "SEE LICENSE IN LICENSE",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/state-zero/statezero-client.git"
-  },
-  "files": [
-    "dist",
-    "LICENSE",
-    "README.md"
-  ],
-  "homepage": "https://www.statezero.dev",
-  "dependencies": {
-    "axios": "^1.7.9",
-    "cli-progress": "^3.12.0",
-    "cosmiconfig": "^9.0.0",
-    "cosmiconfig-typescript-loader": "^6.1.0",
-    "date-fns": "^4.1.0",
-    "dotenv": "^16.4.7",
-    "fs-extra": "^11.3.0",
-    "graphlib": "^2.1.8",
-    "handlebars": "^4.7.8",
-    "idb": "^8.0.2",
-    "inquirer": "^12.4.2",
-    "lodash-es": "^4.17.21",
-    "luxon": "^3.6.1",
-    "mathjs": "^14.4.0",
-    "mitt": "^3.0.1",
-    "object-hash": "^3.0.0",
-    "openapi-typescript": "^6.7.1",
-    "p-queue": "^8.1.0",
-    "pusher-js": "^8.4.0",
-    "rfdc": "^1.4.1",
-    "sift": "^17.1.3",
-    "superjson": "^2.2.2",
-    "uuid": "^11.1.0",
-    "yargs": "^17.7.2",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.50.1",
-    "@types/cli-progress": "^3.11.6",
-    "@types/lodash-es": "^4.17.12",
-    "@types/node": "^22.13.1",
-    "@types/react": "^18.3.18",
-    "@types/yargs": "^17.0.32",
-    "@vitest/coverage-v8": "^3.0.5",
-    "fake-indexeddb": "^6.0.0",
-    "fast-glob": "^3.3.3",
-    "react": "^18.2.0",
-    "rimraf": "^5.0.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.7.3",
-    "vitest": "^3.0.5",
-    "vue": "^3.2.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "bugs": {
-    "url": "https://github.com/state-zero/statezero-client/issues"
-  },
-  "directories": {
-    "test": "tests"
-  }
-}
+{
+  "name": "@statezero/core",
+  "version": "0.2.17",
+  "type": "module",
+  "module": "ESNext",
+  "description": "The type-safe frontend client for StateZero - connect directly to your backend models with zero boilerplate",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "statezero": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./cli": {
+      "import": "./dist/cli/index.js",
+      "require": "./dist/cli/index.js"
+    },
+    "./react": {
+      "import": "./dist/react-entry.js",
+      "require": "./dist/react-entry.js"
+    },
+    "./vue": {
+      "import": "./dist/vue-entry.js",
+      "require": "./dist/vue-entry.js"
+    }
+  },
+  "scripts": {
+    "test": "vitest run --config=vitest.base.config.ts",
+    "test:e2e": "vitest run --config=vitest.sequential.config.ts tests/e2e",
+    "generate:test-apps": "ts-node scripts/generate-test-apps.js",
+    "test:adaptors": "playwright test tests/adaptors",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsc",
+    "parse-queries": "node scripts/perfect-query-parser.js",
+    "sync": "node src/cli/index.js sync",
+    "sync:dev": "npx cross-env NODE_ENV=test npm run sync",
+    "sync-models": "node src/cli/index.js sync-models",
+    "sync-models:dev": "npx cross-env NODE_ENV=test npm run sync-models",
+    "sync-actions": "node src/cli/index.js sync-actions",
+    "sync-actions:dev": "npx cross-env NODE_ENV=test npm run sync-actions",
+    "clean": "npx rimraf dist",
+    "prepare": "npm run clean && npm run build",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "typescript",
+    "orm",
+    "backend",
+    "frontend",
+    "database",
+    "sql",
+    "django",
+    "sqlalchemy",
+    "react",
+    "vue",
+    "svelte"
+  ],
+  "author": "Robert Herring <robert.herring@resipilot.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/state-zero/statezero-client.git"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "homepage": "https://www.statezero.dev",
+  "dependencies": {
+    "axios": "^1.7.9",
+    "cli-progress": "^3.12.0",
+    "cosmiconfig": "^9.0.0",
+    "cosmiconfig-typescript-loader": "^6.1.0",
+    "date-fns": "^4.1.0",
+    "dotenv": "^16.4.7",
+    "fs-extra": "^11.3.0",
+    "graphlib": "^2.1.8",
+    "handlebars": "^4.7.8",
+    "idb": "^8.0.2",
+    "inquirer": "^12.4.2",
+    "lodash-es": "^4.17.21",
+    "luxon": "^3.6.1",
+    "mathjs": "^14.4.0",
+    "mitt": "^3.0.1",
+    "object-hash": "^3.0.0",
+    "openapi-typescript": "^6.7.1",
+    "p-queue": "^8.1.0",
+    "pusher-js": "^8.4.0",
+    "rfdc": "^1.4.1",
+    "sift": "^17.1.3",
+    "superjson": "^2.2.2",
+    "uuid": "^11.1.0",
+    "yargs": "^17.7.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.1",
+    "@types/cli-progress": "^3.11.6",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^22.13.1",
+    "@types/react": "^18.3.18",
+    "@types/yargs": "^17.0.32",
+    "@vitest/coverage-v8": "^3.0.5",
+    "fake-indexeddb": "^6.0.0",
+    "fast-glob": "^3.3.3",
+    "react": "^18.2.0",
+    "rimraf": "^5.0.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5",
+    "vue": "^3.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/state-zero/statezero-client/issues"
+  },
+  "directories": {
+    "test": "tests"
+  }
+}