@statezero/core 0.2.38 → 0.2.40

package/dist/models/default/django_app/rateplan.js

@@ -0,0 +1,69 @@
+/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ */
+import { Model, Manager, QuerySet, getModelClass } from '../../../../src';
+import { wrapReactiveModel } from '../../../../src';
+import schemaData from './rateplan.schema.json';
+/**
+ * Model-specific QuerySet implementation
+ */
+export class RatePlanQuerySet extends QuerySet {
+}
+/**
+ * Model-specific Manager implementation
+ */
+export class RatePlanManager extends Manager {
+    constructor(ModelClass) {
+        super(ModelClass, RatePlanQuerySet);
+    }
+    newQuerySet() {
+        return new RatePlanQuerySet(this.ModelClass);
+    }
+}
+/**
+ * Implementation of the RatePlan model
+ */
+export class RatePlan extends Model {
+    constructor(data) {
+        RatePlan.validateFields(data);
+        super(data);
+        // Define getters and setters for all fields
+        this._defineProperties();
+        return wrapReactiveModel(this);
+    }
+    /**
+     * Define property getters and setters for all model fields
+     * @private
+     */
+    _defineProperties() {
+        // For each field, define a property that gets/sets from internal storage
+        RatePlan.fields.forEach(field => {
+            Object.defineProperty(this, field, {
+                get: function () {
+                    return this.getField(field);
+                },
+                set: function (value) {
+                    this.setField(field, value);
+                },
+                enumerable: true, // Make sure fields are enumerable for serialization
+                configurable: true
+            });
+        });
+        // Add a special read-only getter for the repr field
+        Object.defineProperty(this, 'repr', {
+            get: function () {
+                return this.getField('repr');
+            },
+            enumerable: true, // Make sure repr is enumerable
+            configurable: true
+        });
+    }
+}
+// Bind this model to its backend
+RatePlan.configKey = 'default';
+RatePlan.modelName = 'django_app.rateplan';
+RatePlan.primaryKeyField = 'id';
+RatePlan.objects = new RatePlanManager(RatePlan);
+RatePlan.fields = ['id', 'name'];
+RatePlan.schema = schemaData;
+RatePlan.relationshipFields = new Map([]);

package/dist/models/default/django_app/rateplan.schema.json

@@ -0,0 +1,70 @@
+{
+    "model_name": "django_app.rateplan",
+    "title": "Rate Plan",
+    "class_name": "RatePlan",
+    "plural_title": "Rate Plans",
+    "primary_key_field": "id",
+    "filterable_fields": [
+        "id",
+        "name"
+    ],
+    "searchable_fields": [
+        "name"
+    ],
+    "ordering_fields": [
+        "name"
+    ],
+    "properties": {
+        "id": {
+            "type": "integer",
+            "title": "Id",
+            "required": true,
+            "description": null,
+            "nullable": false,
+            "format": "id",
+            "max_length": null,
+            "choices": null,
+            "default": null,
+            "validators": [],
+            "max_digits": null,
+            "decimal_places": null,
+            "read_only": true,
+            "ref": null
+        },
+        "name": {
+            "type": "string",
+            "title": "Name",
+            "required": true,
+            "description": null,
+            "nullable": false,
+            "format": null,
+            "max_length": 100,
+            "choices": null,
+            "default": null,
+            "validators": [],
+            "max_digits": null,
+            "decimal_places": null,
+            "read_only": false,
+            "ref": null
+        }
+    },
+    "relationships": {},
+    "default_ordering": null,
+    "definitions": {
+        "MoneyField": {
+            "type": "object",
+            "properties": {
+                "amount": {
+                    "type": "number"
+                },
+                "currency": {
+                    "type": "string"
+                }
+            }
+        }
+    },
+    "datetime_format": "iso-8601",
+    "date_format": "iso-8601",
+    "time_format": "iso-8601",
+    "display": null
+}

package/dist/models/default/django_app/restrictedfieldrelatedmodel.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Model-specific QuerySet implementation
+ */
+export class RestrictedFieldRelatedModelQuerySet {
+}
+/**
+ * Model-specific Manager implementation
+ */
+export class RestrictedFieldRelatedModelManager {
+    constructor(ModelClass: any);
+    newQuerySet(): RestrictedFieldRelatedModelQuerySet;
+}
+/**
+ * Implementation of the RestrictedFieldRelatedModel model
+ */
+export class RestrictedFieldRelatedModel {
+    static configKey: string;
+    static modelName: string;
+    static primaryKeyField: string;
+    static objects: RestrictedFieldRelatedModelManager;
+    static fields: string[];
+    static schema: {
+        model_name: string;
+        title: string;
+        class_name: string;
+        plural_title: string;
+        primary_key_field: string;
+        filterable_fields: string[];
+        searchable_fields: string[];
+        ordering_fields: string[];
+        properties: {
+            id: {
+                type: string;
+                title: string;
+                required: boolean;
+                description: null;
+                nullable: boolean;
+                format: string;
+                max_length: null;
+                choices: null;
+                default: null;
+                validators: never[];
+                max_digits: null;
+                decimal_places: null;
+                read_only: boolean;
+                ref: null;
+            };
+            name: {
+                type: string;
+                title: string;
+                required: boolean;
+                description: null;
+                nullable: boolean;
+                format: null;
+                max_length: number;
+                choices: null;
+                default: null;
+                validators: never[];
+                max_digits: null;
+                decimal_places: null;
+                read_only: boolean;
+                ref: null;
+            };
+            admin_only_field: {
+                type: string;
+                title: string;
+                required: boolean;
+                description: null;
+                nullable: boolean;
+                format: null;
+                max_length: number;
+                choices: null;
+                default: string;
+                validators: never[];
+                max_digits: null;
+                decimal_places: null;
+                read_only: boolean;
+                ref: null;
+            };
+        };
+        relationships: {};
+        default_ordering: null;
+        definitions: {
+            MoneyField: {
+                type: string;
+                properties: {
+                    amount: {
+                        type: string;
+                    };
+                    currency: {
+                        type: string;
+                    };
+                };
+            };
+        };
+        datetime_format: string;
+        date_format: string;
+        time_format: string;
+        display: null;
+    };
+    static relationshipFields: Map<any, any>;
+    constructor(data: any);
+    /**
+     * Define property getters and setters for all model fields
+     * @private
+     */
+    private _defineProperties;
+}

package/dist/models/default/django_app/restrictedfieldrelatedmodel.js

@@ -0,0 +1,69 @@
+/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ */
+import { Model, Manager, QuerySet, getModelClass } from '../../../../src';
+import { wrapReactiveModel } from '../../../../src';
+import schemaData from './restrictedfieldrelatedmodel.schema.json';
+/**
+ * Model-specific QuerySet implementation
+ */
+export class RestrictedFieldRelatedModelQuerySet extends QuerySet {
+}
+/**
+ * Model-specific Manager implementation
+ */
+export class RestrictedFieldRelatedModelManager extends Manager {
+    constructor(ModelClass) {
+        super(ModelClass, RestrictedFieldRelatedModelQuerySet);
+    }
+    newQuerySet() {
+        return new RestrictedFieldRelatedModelQuerySet(this.ModelClass);
+    }
+}
+/**
+ * Implementation of the RestrictedFieldRelatedModel model
+ */
+export class RestrictedFieldRelatedModel extends Model {
+    constructor(data) {
+        RestrictedFieldRelatedModel.validateFields(data);
+        super(data);
+        // Define getters and setters for all fields
+        this._defineProperties();
+        return wrapReactiveModel(this);
+    }
+    /**
+     * Define property getters and setters for all model fields
+     * @private
+     */
+    _defineProperties() {
+        // For each field, define a property that gets/sets from internal storage
+        RestrictedFieldRelatedModel.fields.forEach(field => {
+            Object.defineProperty(this, field, {
+                get: function () {
+                    return this.getField(field);
+                },
+                set: function (value) {
+                    this.setField(field, value);
+                },
+                enumerable: true, // Make sure fields are enumerable for serialization
+                configurable: true
+            });
+        });
+        // Add a special read-only getter for the repr field
+        Object.defineProperty(this, 'repr', {
+            get: function () {
+                return this.getField('repr');
+            },
+            enumerable: true, // Make sure repr is enumerable
+            configurable: true
+        });
+    }
+}
+// Bind this model to its backend
+RestrictedFieldRelatedModel.configKey = 'default';
+RestrictedFieldRelatedModel.modelName = 'django_app.restrictedfieldrelatedmodel';
+RestrictedFieldRelatedModel.primaryKeyField = 'id';
+RestrictedFieldRelatedModel.objects = new RestrictedFieldRelatedModelManager(RestrictedFieldRelatedModel);
+RestrictedFieldRelatedModel.fields = ['id', 'name', 'admin_only_field'];
+RestrictedFieldRelatedModel.schema = schemaData;
+RestrictedFieldRelatedModel.relationshipFields = new Map([]);

package/dist/models/default/django_app/restrictedfieldrelatedmodel.schema.json

@@ -0,0 +1,87 @@
+{
+    "model_name": "django_app.restrictedfieldrelatedmodel",
+    "title": "Restricted Field Related Model",
+    "class_name": "RestrictedFieldRelatedModel",
+    "plural_title": "Restricted Field Related Models",
+    "primary_key_field": "id",
+    "filterable_fields": [
+        "id",
+        "admin_only_field",
+        "name"
+    ],
+    "searchable_fields": [
+        "name"
+    ],
+    "ordering_fields": [
+        "name"
+    ],
+    "properties": {
+        "id": {
+            "type": "integer",
+            "title": "Id",
+            "required": true,
+            "description": null,
+            "nullable": false,
+            "format": "id",
+            "max_length": null,
+            "choices": null,
+            "default": null,
+            "validators": [],
+            "max_digits": null,
+            "decimal_places": null,
+            "read_only": true,
+            "ref": null
+        },
+        "name": {
+            "type": "string",
+            "title": "Name",
+            "required": true,
+            "description": null,
+            "nullable": false,
+            "format": null,
+            "max_length": 100,
+            "choices": null,
+            "default": null,
+            "validators": [],
+            "max_digits": null,
+            "decimal_places": null,
+            "read_only": false,
+            "ref": null
+        },
+        "admin_only_field": {
+            "type": "string",
+            "title": "Admin only field",
+            "required": false,
+            "description": null,
+            "nullable": false,
+            "format": null,
+            "max_length": 100,
+            "choices": null,
+            "default": "",
+            "validators": [],
+            "max_digits": null,
+            "decimal_places": null,
+            "read_only": false,
+            "ref": null
+        }
+    },
+    "relationships": {},
+    "default_ordering": null,
+    "definitions": {
+        "MoneyField": {
+            "type": "object",
+            "properties": {
+                "amount": {
+                    "type": "number"
+                },
+                "currency": {
+                    "type": "string"
+                }
+            }
+        }
+    },
+    "datetime_format": "iso-8601",
+    "date_format": "iso-8601",
+    "time_format": "iso-8601",
+    "display": null
+}

package/dist/models/default/fileobject.d.ts

@@ -0,0 +1,4 @@
+export class defaultFileObject {
+    static configKey: string;
+}
+export const FileObject: typeof defaultFileObject;

package/dist/models/default/fileobject.js

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * Backend-specific FileObject class for default
+ */
+import { FileObject as BaseFileObject } from '../../../src';
+export class defaultFileObject extends BaseFileObject {
+}
+defaultFileObject.configKey = 'default';
+export const FileObject = defaultFileObject;

package/dist/models/default/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./fileobject.js";
+export * from "./django_app/index.js";

package/dist/models/default/index.js

@@ -0,0 +1,2 @@
+export * from './fileobject.js';
+export * from './django_app/index.js';

package/dist/models/index.d.ts

@@ -0,0 +1 @@
+export * from "./default/index.js";

package/dist/models/index.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated. Do not make direct changes to the file.
+ * Re-exports from the 'default' backend for backwards compatibility.
+ */
+export * from './default/index.js';

package/dist/react-entry.d.ts

@@ -0,0 +1,2 @@
+export { useQueryset };
+import { useQueryset } from './adaptors/react/index.js';

package/dist/react-entry.js

@@ -0,0 +1,2 @@
+import { useQueryset } from './adaptors/react/index.js';
+export { useQueryset };

package/dist/reactiveAdaptor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Set the global reactivity adapters.
+ * @param {Function} modelAdapterFn - A function that takes a model and returns its reactive version.
+ * @param {Function} querySetAdapterFn - A function that takes a queryset and returns its reactive version.
+ */
+export function setAdapters(modelAdapterFn: Function, querySetAdapterFn: Function, metricAdaptorFn: any): void;
+/**
+ * Wrap a model with the configured reactivity adapter.
+ * @param {Object} model - The model to wrap.
+ * @returns {Object} The reactive model.
+ */
+export function wrapReactiveModel(model: Object): Object;
+/**
+ * Wrap a queryset with the configured reactivity adapter.
+ * @param {Object} querySet - The queryset to wrap.
+ * @returns {Object} The reactive queryset.
+ */
+export function wrapReactiveQuerySet(querySet: Object): Object;
+/**
+ * Wrap a metric with the configured reactivity adaptor.
+ * @param {Object} LiveMetric - the metric to wrap.
+ * @returns {Object} The reactive metric
+ */
+export function wrapReactiveMetric(liveMetric: any): Object;

package/dist/reactiveAdaptor.js

@@ -0,0 +1,38 @@
+// Global singleton for reactivity adapters
+let modelAdapter = null;
+let querySetAdapter = null;
+let metricAdaptor = null;
+/**
+ * Set the global reactivity adapters.
+ * @param {Function} modelAdapterFn - A function that takes a model and returns its reactive version.
+ * @param {Function} querySetAdapterFn - A function that takes a queryset and returns its reactive version.
+ */
+export function setAdapters(modelAdapterFn, querySetAdapterFn, metricAdaptorFn) {
+    modelAdapter = modelAdapterFn;
+    querySetAdapter = querySetAdapterFn;
+    metricAdaptor = metricAdaptorFn;
+}
+/**
+ * Wrap a model with the configured reactivity adapter.
+ * @param {Object} model - The model to wrap.
+ * @returns {Object} The reactive model.
+ */
+export function wrapReactiveModel(model) {
+    return modelAdapter ? modelAdapter(model) : model;
+}
+/**
+ * Wrap a queryset with the configured reactivity adapter.
+ * @param {Object} querySet - The queryset to wrap.
+ * @returns {Object} The reactive queryset.
+ */
+export function wrapReactiveQuerySet(querySet) {
+    return querySetAdapter ? querySetAdapter(querySet) : querySet;
+}
+/**
+ * Wrap a metric with the configured reactivity adaptor.
+ * @param {Object} LiveMetric - the metric to wrap.
+ * @returns {Object} The reactive metric
+ */
+export function wrapReactiveMetric(liveMetric) {
+    return metricAdaptor ? metricAdaptor(liveMetric) : liveMetric;
+}

package/dist/reset.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Register an adapter's reset function
+ * @param {Function} resetFn - Function to call during StateZero reset
+ */
+export function registerAdapterReset(resetFn: Function): void;
+/**
+ * Unregister an adapter's reset function
+ * @param {Function} resetFn - Function to remove
+ */
+export function unregisterAdapterReset(resetFn: Function): void;
+/**
+ * Reset StateZero completely - clears all data and reconnects with fresh auth.
+ * Call this after login to ensure clean authenticated state.
+ */
+export function resetStateZero(): Promise<void>;

package/dist/reset.js

@@ -0,0 +1,97 @@
+// src/reset.js
+import { getConfig, initializeEventReceiver } from "./config.js";
+import { operationRegistry } from "./syncEngine/stores/operation.js";
+import { querysetStoreRegistry } from "./syncEngine/registries/querysetStoreRegistry.js";
+import { modelStoreRegistry } from "./syncEngine/registries/modelStoreRegistry.js";
+import { metricRegistry } from "./syncEngine/registries/metricRegistry.js";
+import { syncManager } from "./syncEngine/sync.js";
+import { getEventReceiver } from "./core/eventReceivers.js";
+import { modelEventEmitter, querysetEventEmitter, metricEventEmitter, } from "./syncEngine/stores/reactivity.js";
+import { tempPkMap } from "./flavours/django/tempPk.js";
+// Registry for adapter reset functions
+const adapterResetFunctions = new Set();
+/**
+ * Register an adapter's reset function
+ * @param {Function} resetFn - Function to call during StateZero reset
+ */
+export function registerAdapterReset(resetFn) {
+    if (typeof resetFn === "function") {
+        adapterResetFunctions.add(resetFn);
+    }
+}
+/**
+ * Unregister an adapter's reset function
+ * @param {Function} resetFn - Function to remove
+ */
+export function unregisterAdapterReset(resetFn) {
+    adapterResetFunctions.delete(resetFn);
+}
+/**
+ * Reset StateZero completely - clears all data and reconnects with fresh auth.
+ * Call this after login to ensure clean authenticated state.
+ */
+export async function resetStateZero() {
+    console.log("🔄 StateZero: Resetting...");
+    try {
+        // 1. Clear ALL operations first
+        operationRegistry.clear();
+        // 2. Clear temporary PK mappings
+        tempPkMap.clear();
+        // 3. Clear all registries and their stores
+        querysetStoreRegistry.clear();
+        modelStoreRegistry.clear();
+        metricRegistry.clear();
+        // 4. Clear all event emitters (reactivity events)
+        modelEventEmitter.all.clear();
+        querysetEventEmitter.all.clear();
+        metricEventEmitter.all.clear();
+        // 5. Clear SyncManager's internal state
+        syncManager.followedModels.clear();
+        syncManager.followedQuerysets.clear();
+        if (syncManager.periodicSyncTimer) {
+            clearInterval(syncManager.periodicSyncTimer);
+            syncManager.periodicSyncTimer = null;
+        }
+        // 6. Call all registered adapter reset functions
+        adapterResetFunctions.forEach((resetFn) => {
+            try {
+                resetFn();
+            }
+            catch (error) {
+                console.warn("Adapter reset function failed:", error);
+            }
+        });
+        // 7. Disconnect and reconnect all event receivers with fresh auth
+        const cfg = getConfig();
+        const reconnectPromises = Object.keys(cfg.backendConfigs).map(async (backendKey) => {
+            const currentReceiver = getEventReceiver(backendKey);
+            if (currentReceiver) {
+                // Store subscriptions before disconnecting
+                const existingSubscriptions = Array.from(currentReceiver.channels.keys());
+                // Completely disconnect
+                currentReceiver.disconnect();
+                // Create fresh receiver with updated auth headers
+                const newReceiver = initializeEventReceiver(backendKey);
+                if (newReceiver) {
+                    // Restore subscriptions
+                    existingSubscriptions.forEach((ns) => newReceiver.subscribe(ns));
+                    // Reconnect to sync manager
+                    newReceiver.addModelEventHandler(syncManager.handleEvent.bind(syncManager));
+                }
+            }
+        });
+        // Wait for all reconnections to complete
+        await Promise.all(reconnectPromises);
+        // 8. Reinitialize the sync manager completely
+        syncManager.initialize();
+        // 9. Reset the registries' internal sync manager references
+        querysetStoreRegistry.setSyncManager(syncManager);
+        modelStoreRegistry.setSyncManager(syncManager);
+        metricRegistry.setSyncManager(syncManager);
+        console.log("✅ StateZero reset complete - everything cleared");
+    }
+    catch (error) {
+        console.error("❌ StateZero reset failed:", error);
+        throw error; // Re-throw so caller knows reset failed
+    }
+}

package/dist/setup.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Initialize StateZero with the provided configuration
+ *
+ * @param {Object} config - StateZero configuration object
+ * @param {Function} getModelClass - Model class getter function from model-registry.js
+ * @param {Object} adapters - Adapter objects for the framework
+ * @param {Function} adapters.ModelAdaptor - Model adapter
+ * @param {Function} adapters.QuerySetAdaptor - QuerySet adapter
+ * @param {Function} adapters.MetricAdaptor - Metric adapter
+ */
+export function setupStateZero(config: Object, getModelClass: Function, adapters: {
+    ModelAdaptor: Function;
+    QuerySetAdaptor: Function;
+    MetricAdaptor: Function;
+}): void;

package/dist/setup.js

@@ -0,0 +1,33 @@
+import { configInstance } from "./config.js";
+import { setAdapters } from "./reactiveAdaptor.js";
+import { syncManager } from "./syncEngine/sync.js";
+import { initEventHandler } from "./syncEngine/stores/operationEventHandlers.js";
+import { querysetStoreRegistry } from "./syncEngine/registries/querysetStoreRegistry.js";
+import { modelStoreRegistry } from "./syncEngine/registries/modelStoreRegistry.js";
+import { metricRegistry } from "./syncEngine/registries/metricRegistry.js";
+/**
+ * Initialize StateZero with the provided configuration
+ *
+ * @param {Object} config - StateZero configuration object
+ * @param {Function} getModelClass - Model class getter function from model-registry.js
+ * @param {Object} adapters - Adapter objects for the framework
+ * @param {Function} adapters.ModelAdaptor - Model adapter
+ * @param {Function} adapters.QuerySetAdaptor - QuerySet adapter
+ * @param {Function} adapters.MetricAdaptor - Metric adapter
+ */
+export function setupStateZero(config, getModelClass, adapters) {
+    // Initialize StateZero configuration
+    configInstance.setConfig(config);
+    configInstance.registerModelGetter(getModelClass);
+    setAdapters(adapters.ModelAdaptor, adapters.QuerySetAdaptor, adapters.MetricAdaptor);
+    initEventHandler();
+    syncManager.initialize();
+    // Expose registries and sync manager for devtools de
+    if (typeof window !== "undefined") {
+        window.__STATEZERO_DEVTOOLS__ = {
+            querysetStoreRegistry,
+            modelStoreRegistry,
+            metricRegistry,
+        };
+    }
+}