@statezero/core 0.2.37 → 0.2.38

package/dist/adaptors/vue/composables.js

@@ -1,44 +0,0 @@
-import { computed, getCurrentInstance, onBeforeUnmount } from 'vue';
-import { querysetStoreRegistry } from '../../syncEngine/registries/querysetStoreRegistry.js';
-import { metricRegistry } from '../../syncEngine/registries/metricRegistry.js';
-import { syncManager } from '../../syncEngine/sync.js';
-import { registerAdapterReset } from '../../reset.js';
-import { v7 } from 'uuid';
-syncManager.followAllQuerysets = false;
-export const querysets = new Map(); // Map of composableId -> queryset
-function updateSyncManager() {
-    // Get unique querysets from all active composables
-    const uniqueQuerysets = new Set(querysets.values());
-    syncManager.followedQuerysets = uniqueQuerysets;
-}
-export function useQueryset(querysetFactory) {
-    const instance = getCurrentInstance();
-    if (!instance) {
-        throw new Error('useQueryset must be called within a component setup function');
-    }
-    const composableId = v7();
-    let lastQueryset = null;
-    onBeforeUnmount(() => {
-        querysets.delete(composableId);
-        updateSyncManager();
-    });
-    return computed(() => {
-        const result = querysetFactory();
-        const original = result?.original || result;
-        const queryset = original?.queryset || original;
-        // Only update if queryset actually changed
-        if (lastQueryset !== queryset) {
-            querysets.set(composableId, queryset);
-            updateSyncManager();
-            lastQueryset = queryset;
-        }
-        return result;
-    });
-}
-registerAdapterReset(() => {
-    querysets.clear();
-    // Reset syncManager back to following all querysets since no composables are active
-    syncManager.followAllQuerysets = true;
-    syncManager.followedQuerysets.clear();
-    console.log("Vue composables state cleared");
-});

package/dist/adaptors/vue/index.d.ts

@@ -1,3 +0,0 @@
-export { useQueryset, querysets } from "./composables.js";
-export { ModelAdaptor, QuerySetAdaptor, MetricAdaptor } from "./reactivity.js";
-export { LayoutRenderer, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from "./components/index.js";

package/dist/adaptors/vue/index.js

@@ -1,4 +0,0 @@
-export { useQueryset, querysets } from './composables.js';
-export { ModelAdaptor, QuerySetAdaptor, MetricAdaptor } from './reactivity.js';
-// Layout components
-export { LayoutRenderer, AlertElement, LabelElement, DividerElement, DisplayElement, GroupElement, TabsElement, ErrorBlock, createDefaultComponents } from './components/index.js';

package/dist/adaptors/vue/reactivity.d.ts

@@ -1,18 +0,0 @@
-/**
- * Adapts a model instance to a Vue reactive object by directly wrapping
- * the instance and incrementing an internal version on relevant events.
- *
- * @param {Object} modelInstance - An instance of a model class with static modelName and primaryKeyField
- * @param {Function} [reactivityFn=reactive] - Which Vue reactivity function to use (reactive or ref)
- * @returns {import('vue').Reactive|import('vue').Ref} The reactive model instance, augmented with __version
- */
-export function ModelAdaptor(modelInstance: Object, reactivityFn?: Function): any | import("vue").Ref;
-/**
- * Adapts a queryset to a Vue reactive object and sets up event handling for queryset updates
- *
- * @param {Object} liveQuerySet - A LiveQueryset instance
- * @param {Function} [reactivityFn=reactive] - Which Vue reactivity function to use (reactive or ref)
- * @returns {import('vue').Reactive|import('vue').Ref} The reactive queryset
- */
-export function QuerySetAdaptor(liveQuerySet: Object, reactivityFn?: Function): any | import("vue").Ref;
-export function MetricAdaptor(metric: any): any;

package/dist/adaptors/vue/reactivity.js

@@ -1,132 +0,0 @@
-import { reactive, ref, nextTick } from "vue";
-import { modelEventEmitter, querysetEventEmitter, metricEventEmitter } from "../../syncEngine/stores/reactivity.js";
-import { initEventHandler } from "../../syncEngine/stores/operationEventHandlers.js";
-import { isEqual, isNil } from 'lodash-es';
-import hash from 'object-hash';
-import { registerAdapterReset } from "../../reset.js";
-initEventHandler();
-const wrappedQuerysetCache = new Map();
-const wrappedMetricCache = new Map();
-/**
- * Adapts a model instance to a Vue reactive object by directly wrapping
- * the instance and incrementing an internal version on relevant events.
- *
- * @param {Object} modelInstance - An instance of a model class with static modelName and primaryKeyField
- * @param {Function} [reactivityFn=reactive] - Which Vue reactivity function to use (reactive or ref)
- * @returns {import('vue').Reactive|import('vue').Ref} The reactive model instance, augmented with __version
- */
-export function ModelAdaptor(modelInstance, reactivityFn = reactive) {
-    const modelClass = modelInstance.constructor;
-    const modelName = modelClass.modelName;
-    const configKey = modelClass.configKey;
-    const pkField = modelClass.primaryKeyField;
-    // Make the model instance reactive using the specified function
-    const wrapper = reactivityFn(modelInstance);
-    const eventName = `${configKey}::${modelName}::render`;
-    // Handler bumps version to trigger Vue reactivity when this instance updates
-    const renderHandler = (eventData) => {
-        const isRef = reactivityFn === ref;
-        const model = isRef ? wrapper.value : wrapper;
-        const modelPk = model[pkField];
-        // Check if this model's pk is in the event's pks array
-        if (eventData.pks && eventData.pks.includes(modelPk)) {
-            if (isRef) {
-                wrapper.value.touch();
-            }
-            else {
-                wrapper.touch();
-            }
-        }
-    };
-    // Subscribe to model events indefinitely
-    modelEventEmitter.on(eventName, renderHandler);
-    return wrapper;
-}
-/**
- * Adapts a queryset to a Vue reactive object and sets up event handling for queryset updates
- *
- * @param {Object} liveQuerySet - A LiveQueryset instance
- * @param {Function} [reactivityFn=reactive] - Which Vue reactivity function to use (reactive or ref)
- * @returns {import('vue').Reactive|import('vue').Ref} The reactive queryset
- */
-export function QuerySetAdaptor(liveQuerySet, reactivityFn = reactive) {
-    const queryset = liveQuerySet?.queryset;
-    const modelName = queryset?.ModelClass?.modelName;
-    const configKey = queryset?.ModelClass?.configKey;
-    if (isNil(queryset) || isNil(modelName)) {
-        throw new Error(`liveQuerySet ${JSON.stringify(liveQuerySet)} had null qs: ${queryset} or model: ${modelName}`);
-    }
-    // Use the semantic key if available
-    const cacheKey = queryset.semanticKey;
-    // Check the cache first
-    if (cacheKey && wrappedQuerysetCache.has(cacheKey)) {
-        return wrappedQuerysetCache.get(cacheKey);
-    }
-    const querysetAst = queryset.build();
-    // Make the queryset reactive using the specified function
-    const wrapper = reactivityFn([...liveQuerySet]);
-    wrapper.original = liveQuerySet;
-    const eventName = `${configKey}::${modelName}::queryset::render`;
-    // Handler bumps version to trigger Vue reactivity when this queryset updates
-    const renderHandler = (eventData) => {
-        if (eventData && eventData.ast && isEqual(querysetAst, eventData.ast)) {
-            if (reactivityFn === ref) {
-                wrapper.value = [...liveQuerySet];
-            }
-            else {
-                wrapper.splice(0, wrapper.length);
-                wrapper.push(...liveQuerySet);
-            }
-        }
-    };
-    // Subscribe to queryset events indefinitely
-    querysetEventEmitter.on(eventName, renderHandler);
-    /* Dont delete the innocuous looking queryset.length check. There is some weird interaction
-    with vue, where when we load an empty queryset from the cache, the reactivity completely breaks.
-    I wasted over 2 days on this bug, and it won't show up in the e2e tests because it just impacts the
-    vue reactivity. If this causes performance issues, and needs to be refactored. Make sure you understand
-    the vue reactivity interaction correctly and find a different way to fix the broken reactivity for empty querysets */
-    if (cacheKey && liveQuerySet && liveQuerySet.length > 0) {
-        wrappedQuerysetCache.set(cacheKey, wrapper);
-    }
-    return wrapper;
-}
-export function MetricAdaptor(metric) {
-    const queryset = metric.queryset;
-    const modelName = queryset?.ModelClass?.modelName;
-    const configKey = queryset?.ModelClass?.configKey;
-    const querysetAst = queryset.build();
-    // Create a cache key based on metric properties
-    // This combines model, metric type, field, and the queryset AST hash to ensure uniqueness
-    const cacheKey = `${configKey}::${modelName}::${metric.metricType}::${metric.field}::${hash(querysetAst)}`;
-    // Check the cache first
-    if (cacheKey && wrappedMetricCache.has(cacheKey)) {
-        return wrappedMetricCache.get(cacheKey);
-    }
-    // Create a reactive reference with the initial value
-    const wrapper = ref(metric.value);
-    wrapper.original = metric;
-    // Single handler for metric render events
-    const metricRenderHandler = (eventData) => {
-        // Only update if this event is for our metric
-        if (eventData.metricType === metric.metricType &&
-            eventData.ModelClass === metric.queryset.ModelClass &&
-            eventData.field === metric.field &&
-            eventData.ast === hash(querysetAst) &&
-            eventData.valueChanged === true) {
-            // Update the wrapper value with the latest metric value
-            wrapper.value = metric.value;
-        }
-    };
-    // Only listen for metric render events
-    metricEventEmitter.on('metric::render', metricRenderHandler);
-    // Store in cache
-    if (cacheKey) {
-        wrappedMetricCache.set(cacheKey, wrapper);
-    }
-    return wrapper;
-}
-registerAdapterReset(() => {
-    wrappedQuerysetCache.clear();
-    wrappedMetricCache.clear();
-});

package/dist/cli/commands/sync.d.ts

@@ -1,6 +0,0 @@
-/**
- * Executes a full synchronization, running sync-models first,
- * followed by sync-actions.
- * @param {object} args - Command-line arguments, passed from yargs.
- */
-export function sync(args?: object): Promise<void>;

package/dist/cli/commands/sync.js

@@ -1,30 +0,0 @@
-import { generateSchema } from "./syncModels.js";
-import { generateActions } from "./syncActions.js";
-/**
- * Executes a full synchronization, running sync-models first,
- * followed by sync-actions.
- * @param {object} args - Command-line arguments, passed from yargs.
- */
-export async function sync(args = {}) {
-    try {
-        console.log("🚀 Starting full synchronization...");
-        // --- Step 1: Synchronize Models ---
-        console.log("\n----- Running Model Synchronization -----");
-        // Pass args down, as generateSchema expects an object
-        await generateSchema(args);
-        console.log("----- Model Synchronization Complete -----\n");
-        // --- Step 2: Synchronize Actions ---
-        console.log("----- Running Action Synchronization -----");
-        // generateActions does not require args based on its definition
-        await generateActions();
-        console.log("----- Action Synchronization Complete -----\n");
-        console.log("✅ Full synchronization finished successfully!");
-    }
-    catch (error) {
-        console.error("\n❌ A critical error occurred during full synchronization:", error.message);
-        if (process.env.DEBUG) {
-            console.error("Stack trace:", error.stack);
-        }
-        process.exit(1);
-    }
-}

package/dist/cli/commands/syncActions.d.ts

@@ -1,46 +0,0 @@
-/**
- * CLI entry point.
- */
-export function generateActions(): Promise<void>;
-export type ActionProperty = {
-    type: string;
-    format?: string | undefined;
-    required?: boolean | undefined;
-    nullable?: boolean | undefined;
-    default?: any;
-    choices?: string[] | undefined;
-    min_length?: number | undefined;
-    max_length?: number | undefined;
-    min_value?: number | undefined;
-    max_value?: number | undefined;
-    items?: ActionProperty | undefined;
-    properties?: {
-        [x: string]: ActionProperty;
-    } | undefined;
-    description?: string | undefined;
-};
-export type ActionDefinition = {
-    action_name: string;
-    title: string;
-    class_name: string;
-    /**
-     * - The application group for the action.
-     */
-    app: string | null;
-    /**
-     * - The action's documentation string.
-     */
-    docstring: string | null;
-    input_properties: {
-        [x: string]: ActionProperty;
-    };
-    response_properties: {
-        [x: string]: ActionProperty;
-    };
-    permissions: string[];
-};
-export type BackendConfig = {
-    NAME: string;
-    API_URL: string;
-    GENERATED_ACTIONS_DIR: string;
-};