@seedprotocol/sdk 0.4.7 → 0.4.9

package/dist/ModelProperty-B9Z2DRxI.js

@@ -0,0 +1,1731 @@
+import { fromCallback, setup, assign, createActor } from 'xstate';
+import 'reflect-metadata';
+import { j as BaseDb, af as writeProcessMachine, u as models, v as properties, M as Model, r as modelPropertiesToObject, a0 as schemas, U as modelSchemas, n as normalizeDataType, ag as generateId, ah as waitForEntityIdle, ai as createReactiveProxy, aj as findEntity, C as BaseFileManager, ak as forceRemoveFromCaches, al as runDestroyLifecycle, am as getModelIdByFileId, an as getModelId } from './index-j8WN8W6V.js';
+import 'pluralize';
+import { eq, and } from 'drizzle-orm';
+import debug from 'debug';
+import { S as Schema } from './Schema-D1-HjT8z.js';
+import 'drizzle-orm/sqlite-core';
+import 'nanoid';
+import 'nanoid-dictionary';
+import 'ethers';
+import 'rxjs';
+import 'lodash-es';
+import 'drizzle-orm/casing';
+import 'eventemitter3';
+import 'arweave';
+import '@sinclair/typebox';
+import './SchemaValidationService-CIXKzSpb.js';
+import '@sinclair/typebox/value';
+
+const logger$3 = debug('seedSdk:modelProperty:actors:saveToSchema');
+/**
+ * Get schema name from model
+ * This function finds which schema contains the given model
+ * Exported so it can be reused by ModelProperty for setting schema name
+ */
+async function getSchemaNameFromModel(modelName) {
+    // Get the latest schema files and find which one contains this model
+    const _mod_0 = await import('./index-j8WN8W6V.js');
+    const _ns_0 = _mod_0.aZ;
+    const schemaHelpersMod = _ns_0;
+    const { listLatestSchemaFiles } = schemaHelpersMod;
+    const latestSchemas = await listLatestSchemaFiles();
+    for (const schema of latestSchemas) {
+        try {
+            const _mod_1 = await import('./index-j8WN8W6V.js');
+            const _ns_1 = _mod_1.aX;
+            const fileManagerMod = _ns_1;
+            const { BaseFileManager } = fileManagerMod;
+            const content = await BaseFileManager.readFileAsString(schema.filePath);
+            const schemaFile = JSON.parse(content);
+            if (schemaFile.models && schemaFile.models[modelName]) {
+                return schema.name;
+            }
+        }
+        catch (error) {
+            logger$3('Error reading schema file:', error);
+            continue;
+        }
+    }
+    return undefined;
+}
+const saveToSchema = fromCallback(({ sendBack, input: { context } }) => {
+    const _saveToSchema = async () => {
+        // Use dynamic import to break circular dependency
+        const validationServiceMod = await import('./SchemaValidationService-CIXKzSpb.js');
+        const { SchemaValidationService } = validationServiceMod;
+        const validationService = new SchemaValidationService();
+        // Validate property structure before saving
+        const validationResult = validationService.validatePropertyStructure(context);
+        if (!validationResult.isValid) {
+            throw new Error(`Property validation failed: ${validationResult.errors.map(e => e.message).join(', ')}`);
+        }
+        // Validate required fields
+        if (!context.name) {
+            throw new Error('Property name is required');
+        }
+        if (!context.dataType) {
+            throw new Error('Data type is required');
+        }
+        if (!context.modelName) {
+            throw new Error(`Model not found for modelId: ${context.modelId}`);
+        }
+        // Persist to database only - schema file is updated only when user calls Schema.saveNewVersion()
+        const _mod_2 = await import('./index-j8WN8W6V.js');
+        const _ns_2 = _mod_2.aY;
+        const dbMod = _ns_2;
+        const { savePropertyToDb } = dbMod;
+        await savePropertyToDb(context);
+        // Mark schema as draft so user knows to save
+        const schemaName = context._schemaName ?? (await getSchemaNameFromModel(context.modelName));
+        if (schemaName) {
+            const _mod_3 = await import('./Schema-D1-HjT8z.js');
+            const _ns_3 = _mod_3.b;
+            const schemaMod = _ns_3;
+            const { Schema } = schemaMod;
+            const schema = Schema.create(schemaName, { waitForReady: false });
+            schema.getService().send({
+                type: 'markAsDraft',
+                propertyKey: `${context.modelName}:${context.name}`,
+            });
+        }
+        logger$3(`Successfully saved property ${context.modelName}:${context.name} to database`);
+    };
+    _saveToSchema().then(() => {
+        sendBack({ type: 'saveToSchemaSuccess' });
+    }).catch((error) => {
+        logger$3('Error saving to schema:', error);
+        sendBack({ type: 'saveToSchemaError', error });
+    });
+    return () => {
+        // Cleanup function (optional)
+    };
+});
+
+const logger$2 = debug('seedSdk:modelProperty:actors:compareAndMarkDraft');
+const compareAndMarkDraft = fromCallback(({ sendBack, input: { context } }) => {
+    const _compareAndMarkDraft = async () => {
+        // Fill modelName/dataType from _originalValues when missing, then from DB by schemaFileId
+        let fullContext = {
+            ...context,
+            modelName: context.modelName ?? context._originalValues?.modelName,
+            dataType: context.dataType ?? context._originalValues?.dataType,
+        };
+        const schemaFileIdForResolve = fullContext._propertyFileId || (typeof fullContext.id === 'string' ? fullContext.id : undefined);
+        if (schemaFileIdForResolve && (fullContext.modelName === undefined || fullContext.dataType === undefined)) {
+            try {
+                const _mod_4 = await import('./index-j8WN8W6V.js');
+                const _ns_4 = _mod_4.aY;
+                const dbMod = _ns_4;
+                const { getPropertyModelNameAndDataType, getModelNameByModelId } = dbMod;
+                let fromDb;
+                for (let attempt = 0; attempt < 6; attempt++) {
+                    fromDb = await getPropertyModelNameAndDataType(schemaFileIdForResolve);
+                    if (fromDb)
+                        break;
+                    if (attempt < 5)
+                        await new Promise((r) => setTimeout(r, 40));
+                }
+                if (fromDb) {
+                    fullContext = {
+                        ...fullContext,
+                        modelName: fullContext.modelName ?? fromDb.modelName,
+                        dataType: fullContext.dataType ?? fromDb.dataType,
+                    };
+                }
+                if (fullContext.modelName === undefined && schemaFileIdForResolve) {
+                    const mod = await Promise.resolve().then(function () { return ModelProperty$1; });
+                    const ModelProperty = mod?.ModelProperty ?? mod?.default;
+                    const pendingModelId = ModelProperty?.getPendingModelId?.(schemaFileIdForResolve);
+                    if (pendingModelId != null) {
+                        const modelName = await getModelNameByModelId(pendingModelId);
+                        if (modelName) {
+                            fullContext = { ...fullContext, modelName };
+                        }
+                    }
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        const schemaFileId = fullContext._propertyFileId || (typeof fullContext.id === 'string' ? fullContext.id : undefined);
+        // If _originalValues is not set, we still need to save to database if the property exists
+        // This handles the case where the name is changed before _originalValues is initialized
+        if (!fullContext._originalValues) {
+            logger$2('No original values to compare against');
+            logger$2(`[compareAndMarkDraft] Context: modelName=${fullContext.modelName}, name=${fullContext.name}, id=${fullContext.id}, _propertyFileId=${fullContext._propertyFileId}`);
+            // If we have a name and modelName, try to save to database anyway
+            // This ensures name changes are persisted even if _originalValues isn't initialized yet
+            // We need either schemaFileId (id or _propertyFileId) to find the property in the database
+            if (fullContext.modelName && fullContext.name && schemaFileId) {
+                logger$2(`[compareAndMarkDraft] _originalValues not set, but saving to database anyway for property ${context.modelName}:${context.name} (schemaFileId: ${schemaFileId})`);
+                try {
+                    const _mod_5 = await import('./index-j8WN8W6V.js');
+                    const _ns_5 = _mod_5.aY;
+                    const dbMod = _ns_5;
+                    const { savePropertyToDb } = dbMod;
+                    // Ensure _propertyFileId is set for savePropertyToDb to find the property
+                    const contextWithFileId = {
+                        ...fullContext,
+                        _propertyFileId: schemaFileId,
+                    };
+                    await savePropertyToDb(contextWithFileId);
+                    logger$2(`[compareAndMarkDraft] Successfully saved property ${fullContext.modelName}:${fullContext.name} to database (no _originalValues)`);
+                }
+                catch (error) {
+                    logger$2(`[compareAndMarkDraft] Error saving property to database (no _originalValues): ${error}`);
+                    // Don't throw - this is a best-effort save, but log the error for debugging
+                    console.error(`[compareAndMarkDraft] Failed to save property ${fullContext.modelName}:${fullContext.name}:`, error);
+                }
+            }
+            else {
+                logger$2(`[compareAndMarkDraft] Cannot save property ${fullContext.modelName}:${fullContext.name} - missing required fields (schemaFileId: ${schemaFileId})`);
+            }
+            return;
+        }
+        logger$2(`[compareAndMarkDraft] Comparing: context.name=${fullContext.name}, _originalValues.name=${fullContext._originalValues?.name}`);
+        // Compare current values with original
+        // Only compare property fields, not internal fields
+        const propertyFields = ['name', 'dataType', 'ref', 'refModelName', 'refModelId', 'refValueType', 'storageType', 'localStorageDir', 'filenameSuffix', 'modelName', 'modelId'];
+        const hasChanges = propertyFields.some(key => {
+            const currentValue = fullContext[key];
+            const originalValue = fullContext._originalValues?.[key];
+            // Handle name changes specifically
+            if (key === 'name') {
+                const nameChanged = currentValue !== originalValue;
+                if (nameChanged) {
+                    logger$2(`[compareAndMarkDraft] Name change detected: "${originalValue}" -> "${currentValue}"`);
+                }
+                return nameChanged;
+            }
+            // Handle ref fields - compare by name
+            if (key === 'ref' || key === 'refModelName') {
+                const currentRef = fullContext.refModelName || fullContext.ref;
+                const originalRef = fullContext._originalValues?.refModelName || fullContext._originalValues?.ref;
+                // Both undefined/null means no ref, so they're the same
+                if (!currentRef && !originalRef)
+                    return false;
+                return currentRef !== originalRef;
+            }
+            // For other fields, compare values (handling undefined/null)
+            if (currentValue === undefined && originalValue === undefined)
+                return false;
+            if (currentValue === null && originalValue === null)
+                return false;
+            if (currentValue === undefined && originalValue === null)
+                return false;
+            if (currentValue === null && originalValue === undefined)
+                return false;
+            return currentValue !== originalValue;
+        });
+        if (hasChanges) {
+            logger$2(`Property ${fullContext.modelName}:${fullContext.name} has changes, marking as edited`);
+            logger$2(`[compareAndMarkDraft] Context when saving: id=${fullContext.id}, _propertyFileId=${fullContext._propertyFileId}, name=${fullContext.name}, _originalValues.name=${fullContext._originalValues?.name}`);
+            // Use dynamic import to break circular dependency
+            const _mod_6 = await import('./index-j8WN8W6V.js');
+            const _ns_6 = _mod_6.aY;
+            const dbMod = _ns_6;
+            const { savePropertyToDb } = dbMod;
+            // Save to database (but not JSON file) - always save to DB when there are changes
+            try {
+                await savePropertyToDb(fullContext);
+                logger$2(`[compareAndMarkDraft] Successfully saved property ${fullContext.modelName}:${fullContext.name} to database`);
+            }
+            catch (error) {
+                logger$2(`[compareAndMarkDraft] Error saving property to database: ${error}`);
+                throw error;
+            }
+            // Mark schema as draft if schema name is available
+            if (fullContext._schemaName) {
+                // Get the Schema instance and mark it as draft
+                const _mod_7 = await import('./Schema-D1-HjT8z.js');
+                const _ns_7 = _mod_7.b;
+                const schemaMod = _ns_7;
+                const { Schema } = schemaMod;
+                const schema = Schema.create(fullContext._schemaName, {
+                    waitForReady: false,
+                });
+                // Send event to Schema machine to mark as draft
+                schema.getService().send({
+                    type: 'markAsDraft',
+                    propertyKey: `${fullContext.modelName}:${fullContext.name}`,
+                });
+            }
+        }
+        else {
+            // No changes - clear edited flag in database and context
+            logger$2(`Property ${fullContext.modelName}:${fullContext.name} has no changes`);
+            // Clear isEdited flag in database
+            try {
+                const _mod_8 = await import('./index-ajj6SHkh.js');
+                const _ns_8 = _mod_8.s;
+                const seedSchemaMod = _ns_8;
+                const { properties: propertiesTable, models: modelsTable } = seedSchemaMod;
+                const drizzleMod = await import('drizzle-orm');
+                const { eq, and } = drizzleMod;
+                const db = BaseDb.getAppDb();
+                if (db && fullContext.modelName && fullContext.name) {
+                    // Find model by name
+                    const modelRecords = await db
+                        .select({ id: modelsTable.id })
+                        .from(modelsTable)
+                        .where(eq(modelsTable.name, fullContext.modelName))
+                        .limit(1);
+                    if (modelRecords.length > 0) {
+                        // Find property by name and modelId
+                        const propertyRecords = await db
+                            .select({ id: propertiesTable.id })
+                            .from(propertiesTable)
+                            .where(and(eq(propertiesTable.name, fullContext.name), eq(propertiesTable.modelId, modelRecords[0].id)))
+                            .limit(1);
+                        if (propertyRecords.length > 0) {
+                            // Clear isEdited flag in database
+                            await db
+                                .update(propertiesTable)
+                                .set({ isEdited: false })
+                                .where(eq(propertiesTable.id, propertyRecords[0].id));
+                            logger$2(`Cleared isEdited flag in database for property ${fullContext.modelName}:${fullContext.name}`);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                logger$2(`Error clearing isEdited flag in database: ${error}`);
+            }
+            sendBack({
+                type: 'clearEdited',
+            });
+        }
+    };
+    _compareAndMarkDraft().then(() => {
+        sendBack({ type: 'compareAndMarkDraftSuccess' });
+    }).catch((error) => {
+        logger$2('Error comparing and marking draft:', error);
+        sendBack({ type: 'compareAndMarkDraftError', error });
+    });
+    return () => {
+        // Cleanup function (optional)
+    };
+});
+
+const logger$1 = debug('seedSdk:modelProperty:actors:validateProperty');
+const validateProperty = fromCallback(({ sendBack, input: { context } }) => {
+    const _validateProperty = async () => {
+        // Use full context for validation: fill modelName/dataType from _originalValues when missing, then
+        // from DB by schemaFileId (context.id) so just-created renames don't fail structure validation.
+        let fullContext = {
+            ...context,
+            modelName: context.modelName ?? context._originalValues?.modelName,
+            dataType: context.dataType ?? context._originalValues?.dataType,
+        };
+        const schemaFileId = typeof context.id === 'string' ? context.id : undefined;
+        if (schemaFileId && (fullContext.modelName === undefined || fullContext.dataType === undefined)) {
+            // Brief wait so trackPendingWrite from ModelProperty.create() has time to run (it's in setTimeout(0))
+            await new Promise((r) => setTimeout(r, 60));
+            try {
+                const _mod_9 = await import('./index-j8WN8W6V.js');
+                const _ns_9 = _mod_9.aY;
+                const dbMod = _ns_9;
+                const { getPropertyModelNameAndDataType, getModelNameByModelId } = dbMod;
+                // Try pending write first (property row may not exist yet)
+                if (fullContext.modelName === undefined && schemaFileId) {
+                    const mod = await Promise.resolve().then(function () { return ModelProperty$1; });
+                    const ModelProperty = mod?.ModelProperty ?? mod?.default;
+                    const pendingModelId = ModelProperty?.getPendingModelId?.(schemaFileId);
+                    if (pendingModelId != null) {
+                        const modelName = await getModelNameByModelId(pendingModelId);
+                        if (modelName) {
+                            fullContext = { ...fullContext, modelName };
+                        }
+                    }
+                }
+                // Then DB property lookup with retry (catches row after initial write)
+                let fromDb;
+                for (let attempt = 0; attempt < 6; attempt++) {
+                    fromDb = await getPropertyModelNameAndDataType(schemaFileId);
+                    if (fromDb)
+                        break;
+                    if (attempt < 5)
+                        await new Promise((r) => setTimeout(r, 40));
+                }
+                if (fromDb) {
+                    fullContext = {
+                        ...fullContext,
+                        modelName: fullContext.modelName ?? fromDb.modelName,
+                        dataType: fullContext.dataType ?? fromDb.dataType,
+                    };
+                }
+                // If still no modelName, try pending write again (may have been set during retries)
+                if (fullContext.modelName === undefined && schemaFileId) {
+                    const mod = await Promise.resolve().then(function () { return ModelProperty$1; });
+                    const ModelProperty = mod?.ModelProperty ?? mod?.default;
+                    const pendingModelId = ModelProperty?.getPendingModelId?.(schemaFileId);
+                    if (pendingModelId != null) {
+                        const modelName = await getModelNameByModelId(pendingModelId);
+                        if (modelName) {
+                            fullContext = { ...fullContext, modelName };
+                        }
+                    }
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+        // Last resort for structure validation: TProperty requires dataType; allow name+id to pass if we have schemaFileId
+        if (fullContext.dataType === undefined && (fullContext.modelName !== undefined || schemaFileId)) {
+            fullContext = { ...fullContext, dataType: (fullContext.dataType ?? context._originalValues?.dataType) || 'Text' };
+        }
+        // Use dynamic imports to break circular dependencies
+        const validationServiceMod = await import('./SchemaValidationService-CIXKzSpb.js');
+        const { SchemaValidationService } = validationServiceMod;
+        const validationService = new SchemaValidationService();
+        const _mod_10 = await import('./Schema-D1-HjT8z.js');
+        const _ns_10 = _mod_10.b;
+        const schemaMod = _ns_10;
+        const { Schema } = schemaMod;
+        // Validate property structure
+        const structureResult = validationService.validatePropertyStructure(fullContext);
+        if (!structureResult.isValid) {
+            sendBack({ type: 'validationError', errors: structureResult.errors });
+            return;
+        }
+        // If we have schema name and model name, validate against schema
+        if (fullContext._schemaName && fullContext.modelName) {
+            try {
+                const schema = Schema.create(fullContext._schemaName, {
+                    waitForReady: false,
+                });
+                const schemaSnapshot = schema.getService().getSnapshot();
+                const schemaStatus = schemaSnapshot.value;
+                // Only validate against schema if it's loaded (in idle state)
+                // If still loading, skip schema validation and only do structure validation
+                if (schemaStatus === 'idle') {
+                    const schemaContext = schemaSnapshot.context;
+                    // Check if models are actually loaded
+                    if (schemaContext.models && Object.keys(schemaContext.models).length > 0) {
+                        // If property name has changed, validate against the original name (from schema file)
+                        // This handles the case where a property is renamed - the schema file still has the old name
+                        const propertyNameToValidate = fullContext._originalValues?.name && fullContext._originalValues.name !== fullContext.name
+                            ? fullContext._originalValues.name
+                            : fullContext.name || '';
+                        const schemaResult = validationService.validateProperty(schemaContext, fullContext.modelName, propertyNameToValidate, fullContext);
+                        if (!schemaResult.isValid) {
+                            // If property was renamed, some validation errors are expected (like property_not_found, missing_type)
+                            // Only fail if it's a critical error that's not related to the rename
+                            const isRenamed = fullContext._originalValues?.name && fullContext._originalValues.name !== fullContext.name;
+                            const criticalErrors = schemaResult.errors.filter(err => {
+                                // Allow property_not_found and missing_type errors when property is renamed
+                                if (isRenamed && (err.code === 'property_not_found' || err.code === 'missing_type')) {
+                                    return false; // Not critical
+                                }
+                                // For non-renamed properties, only allow property_not_found if we're validating with the same name
+                                if (err.code === 'property_not_found' && propertyNameToValidate === fullContext.name) {
+                                    return false; // Not critical
+                                }
+                                return true; // Critical error
+                            });
+                            if (criticalErrors.length > 0) {
+                                sendBack({ type: 'validationError', errors: criticalErrors });
+                                return;
+                            }
+                            // Continue with validation - rename-related errors are acceptable
+                        }
+                    }
+                    else {
+                        logger$1('Schema models not loaded yet, skipping schema validation');
+                        // Continue with structure validation only
+                    }
+                }
+                else {
+                    logger$1(`Schema is in ${schemaStatus} state, skipping schema validation`);
+                    // Continue with structure validation only
+                }
+            }
+            catch (error) {
+                logger$1('Error validating property against schema:', error);
+                // Continue with structure validation only
+            }
+        }
+        // All validations passed
+        sendBack({ type: 'validationSuccess', errors: [] });
+    };
+    _validateProperty().catch((error) => {
+        logger$1('Error in validateProperty:', error);
+        sendBack({
+            type: 'validationError',
+            errors: [{
+                    field: 'property',
+                    message: error instanceof Error ? error.message : 'Unknown validation error',
+                    code: 'validation_exception',
+                    severity: 'error',
+                }],
+        });
+    });
+    return () => {
+        // Cleanup function (optional)
+    };
+});
+
+const modelPropertyMachine = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+    },
+    actors: {
+        saveToSchema,
+        compareAndMarkDraft,
+        validateProperty,
+        writeProcessMachine,
+    },
+    guards: {
+        isPropertyValid: ({ context }) => {
+            const valid = !context._validationErrors || context._validationErrors.length === 0;
+            return valid;
+        },
+        hasValidationErrors: ({ context }) => {
+            return !!context._validationErrors && context._validationErrors.length > 0;
+        },
+    },
+    actions: {
+        assignValidationErrors: assign(({ context, event }) => {
+            if (event.type === 'validationError') {
+                return {
+                    ...context,
+                    _validationErrors: event.errors,
+                };
+            }
+            return context;
+        }),
+    },
+}).createMachine({
+    id: 'modelProperty',
+    initial: 'idle',
+    context: ({ input }) => {
+        const context = input;
+        return context;
+    },
+    on: {
+        updateContext: {
+            actions: assign(({ context, event }) => {
+                const newContext = Object.assign({}, context);
+                // Check if this is only updating internal fields
+                const onlyInternalFields = Object.keys(event).every((key) => {
+                    return key === 'type' || key.startsWith('_');
+                });
+                // Update the context with new values
+                for (let i = 0; i < Object.keys(event).length; i++) {
+                    const key = Object.keys(event)[i];
+                    if (key === 'type') {
+                        continue;
+                    }
+                    let value = event[key];
+                    // Convert null to undefined for optional fields (TypeBox validation expects undefined, not null)
+                    // This is especially important for refValueType, refModelId, etc.
+                    if (value === null && (key === 'refValueType' || key === 'refModelId' || key === 'ref' || key === 'refModelName')) {
+                        value = undefined;
+                    }
+                    newContext[key] = value;
+                }
+                // Preserve modelName and dataType from context or _originalValues so validation and savePropertyToDb
+                // never run with missing required/needed fields (e.g. when a just-created property is renamed before
+                // the full context is available from the creator).
+                if (newContext.modelName === undefined && context._originalValues?.modelName !== undefined) {
+                    newContext.modelName = context._originalValues.modelName;
+                }
+                if (newContext.dataType === undefined && context._originalValues?.dataType !== undefined) {
+                    newContext.dataType = context._originalValues.dataType;
+                }
+                // Compare with original values and set _isEdited flag (only for non-internal updates)
+                if (!onlyInternalFields && context._originalValues) {
+                    const hasChanges = Object.keys(event).some((key) => {
+                        if (key === 'type' || key.startsWith('_'))
+                            return false;
+                        return newContext[key] !== context._originalValues?.[key];
+                    });
+                    newContext._isEdited = hasChanges;
+                }
+                // Clear validation errors on context update (will be re-validated if needed)
+                newContext._validationErrors = undefined;
+                // Convert null to undefined for optional fields (TypeBox validation expects undefined, not null)
+                // This is especially important for refValueType, refModelId, etc.
+                const optionalFields = ['refValueType', 'refModelId', 'ref', 'refModelName'];
+                for (const field of optionalFields) {
+                    if (newContext[field] === null) {
+                        newContext[field] = undefined;
+                    }
+                }
+                return newContext;
+            }),
+            // Only trigger validation and compareAndMarkDraft if we're updating non-internal fields
+            guard: ({ event }) => {
+                const shouldTransition = !Object.keys(event).every((key) => {
+                    return key === 'type' || key.startsWith('_');
+                });
+                return shouldTransition;
+            },
+            target: '.validating',
+        },
+        validateProperty: {
+            target: '.validating',
+        },
+        validationSuccess: {
+            actions: assign(({ context, event }) => ({
+                ...context,
+                _validationErrors: [],
+            })),
+        },
+        validationError: {
+            actions: 'assignValidationErrors',
+            // Note: State-specific transitions are handled in child states
+            // This root handler ensures errors are always assigned to context
+        },
+        initializeOriginalValues: {
+            actions: assign(({ context, event }) => ({
+                ...context,
+                _originalValues: event.originalValues,
+                _schemaName: event.schemaName,
+                _isEdited: event.isEdited ?? false,
+                _validationErrors: undefined,
+            })),
+        },
+        clearEdited: {
+            actions: assign(({ context }) => ({
+                ...context,
+                _isEdited: false,
+                _originalValues: { ...context },
+            })),
+        },
+        setSchemaName: {
+            actions: assign(({ context, event }) => ({
+                ...context,
+                _schemaName: event.schemaName,
+            })),
+        },
+        destroyStarted: {
+            actions: assign({ _destroyInProgress: true, _destroyError: null }),
+        },
+        destroyDone: {
+            actions: assign({ _destroyInProgress: false }),
+        },
+        destroyError: {
+            actions: assign(({ event }) => ({
+                _destroyInProgress: false,
+                _destroyError: event.error instanceof Error
+                    ? { message: event.error.message, name: event.error.name }
+                    : { message: String(event.error) },
+            })),
+        },
+        clearDestroyError: {
+            actions: assign({ _destroyError: null }),
+        },
+    },
+    states: {
+        idle: {
+            on: {
+                saveToSchema: { target: 'saveToSchema' },
+                validateProperty: {
+                    target: 'validating',
+                },
+                requestWrite: {
+                    actions: ({ context, event }) => {
+                        if (context.writeProcess) {
+                            context.writeProcess.send({
+                                type: 'startWrite',
+                                data: event.data,
+                            });
+                        }
+                    },
+                },
+            },
+            entry: assign({
+                writeProcess: ({ spawn, context }) => {
+                    // Spawn writeProcess if we have id (schemaFileId)
+                    // New properties will have id generated
+                    const entityId = context.id;
+                    if (!context.writeProcess && entityId) {
+                        return spawn(writeProcessMachine, {
+                            input: {
+                                entityType: 'modelProperty',
+                                entityId: String(entityId),
+                                entityData: context,
+                            },
+                        });
+                    }
+                    return context.writeProcess;
+                },
+            }),
+        },
+        validating: {
+            on: {
+                saveToSchema: { target: 'saveToSchema' },
+                validationSuccess: {
+                    target: 'compareAndMarkDraft',
+                    actions: assign(({ context }) => ({
+                        ...context,
+                        _validationErrors: [],
+                    })),
+                },
+                // validationError: Uses root handler for assignment, but needs state-specific transition
+                validationError: {
+                    target: 'idle',
+                    actions: 'assignValidationErrors',
+                },
+            },
+            invoke: {
+                src: 'validateProperty',
+                input: ({ context }) => ({ context }),
+            },
+        },
+        compareAndMarkDraft: {
+            on: {
+                saveToSchema: { target: 'saveToSchema' },
+                compareAndMarkDraftSuccess: {
+                    target: 'idle',
+                },
+                compareAndMarkDraftError: {
+                    target: 'idle',
+                },
+            },
+            invoke: {
+                src: 'compareAndMarkDraft',
+                input: ({ context }) => ({ context }),
+            },
+        },
+        saveToSchema: {
+            always: {
+                guard: 'isPropertyValid',
+                target: '.saving',
+            },
+            initial: 'saving',
+            on: {
+                // Apply updateContext but do not re-invoke saveToSchema actor (avoids infinite loop).
+                // Context is updated; in-flight save completes with original context.
+                updateContext: [
+                    {
+                        guard: ({ context, event }) => {
+                            const onlyInternal = Object.keys(event).every((k) => k === 'type' || k.startsWith('_'));
+                            return !onlyInternal && event.name !== undefined && event.name !== context.name;
+                        },
+                        actions: assign(({ context, event }) => {
+                            const newContext = Object.assign({}, context);
+                            const onlyInternalFields = Object.keys(event).every((key) => key === 'type' || key.startsWith('_'));
+                            for (const key of Object.keys(event)) {
+                                if (key === 'type')
+                                    continue;
+                                let value = event[key];
+                                if (value === null && ['refValueType', 'refModelId', 'ref', 'refModelName'].includes(key))
+                                    value = undefined;
+                                newContext[key] = value;
+                            }
+                            if (newContext.modelName === undefined && context._originalValues?.modelName !== undefined) {
+                                newContext.modelName = context._originalValues.modelName;
+                            }
+                            if (newContext.dataType === undefined && context._originalValues?.dataType !== undefined) {
+                                newContext.dataType = context._originalValues.dataType;
+                            }
+                            if (!onlyInternalFields && context._originalValues) {
+                                const hasChanges = Object.keys(event).some((key) => {
+                                    if (key === 'type' || key.startsWith('_'))
+                                        return false;
+                                    return newContext[key] !== context._originalValues?.[key];
+                                });
+                                newContext._isEdited = hasChanges;
+                            }
+                            newContext._validationErrors = undefined;
+                            return newContext;
+                        }),
+                    },
+                    {
+                        actions: assign(({ context, event }) => {
+                            const newContext = Object.assign({}, context);
+                            const onlyInternalFields = Object.keys(event).every((key) => key === 'type' || key.startsWith('_'));
+                            for (const key of Object.keys(event)) {
+                                if (key === 'type')
+                                    continue;
+                                let value = event[key];
+                                if (value === null && ['refValueType', 'refModelId', 'ref', 'refModelName'].includes(key))
+                                    value = undefined;
+                                newContext[key] = value;
+                            }
+                            if (newContext.modelName === undefined && context._originalValues?.modelName !== undefined) {
+                                newContext.modelName = context._originalValues.modelName;
+                            }
+                            if (newContext.dataType === undefined && context._originalValues?.dataType !== undefined) {
+                                newContext.dataType = context._originalValues.dataType;
+                            }
+                            if (!onlyInternalFields && context._originalValues) {
+                                const hasChanges = Object.keys(event).some((key) => {
+                                    if (key === 'type' || key.startsWith('_'))
+                                        return false;
+                                    return newContext[key] !== context._originalValues?.[key];
+                                });
+                                newContext._isEdited = hasChanges;
+                            }
+                            newContext._validationErrors = undefined;
+                            return newContext;
+                        }),
+                    },
+                ],
+                // validationError: Uses root handler for assignment, but needs state-specific transition
+                validationError: {
+                    target: 'idle',
+                    actions: 'assignValidationErrors',
+                },
+            },
+            states: {
+                saving: {
+                    on: {
+                        saveToSchemaSuccess: {
+                            target: '#modelProperty.idle',
+                        },
+                        saveToSchemaError: {
+                            target: '#modelProperty.idle',
+                        },
+                    },
+                    invoke: {
+                        src: 'saveToSchema',
+                        input: ({ context }) => ({ context }),
+                    },
+                },
+            },
+        },
+    },
+});
+
+/**
+ * Returns property rows for a model identified by modelFileId (model's schemaFileId).
+ * Resolves modelFileId -> modelId via models table, then selects all properties where modelId = ?.
+ * Each row includes schemaFileId for use with ModelProperty.createById(schemaFileId).
+ */
+const getModelPropertiesData = async (modelFileId) => {
+    const appDb = BaseDb.getAppDb();
+    if (!appDb || !modelFileId) {
+        return [];
+    }
+    const modelRows = await appDb
+        .select({ id: models.id })
+        .from(models)
+        .where(eq(models.schemaFileId, modelFileId))
+        .limit(1);
+    if (modelRows.length === 0) {
+        return [];
+    }
+    const modelId = modelRows[0].id;
+    const rows = await appDb
+        .select()
+        .from(properties)
+        .where(eq(properties.modelId, modelId));
+    return rows;
+};
+
+const logger = debug('seedSdk:modelProperty:ModelProperty');
+// Define the property keys from TProperty
+const TPropertyKeys = [
+    'id',
+    'name',
+    'dataType',
+    'ref',
+    'modelId',
+    'refModelId',
+    'refValueType',
+    'storageType',
+    'localStorageDir',
+    'filenameSuffix',
+    'modelName',
+    'refModelName',
+];
+class ModelProperty {
+    constructor(property) {
+        // id is now the schemaFileId (string), _dbId is the database integer ID
+        // Preserve _propertyFileId if it exists in the property object (from getPropertySchema)
+        // Convert null to undefined for optional fields (TypeBox validation expects undefined, not null)
+        const serviceInput = {
+            ...property,
+            _propertyFileId: property._propertyFileId || property.id,
+            refValueType: property.refValueType ?? undefined,
+            refModelId: property.refModelId ?? undefined,
+            ref: property.ref ?? undefined,
+            refModelName: property.refModelName ?? undefined,
+        };
+        this._service = createActor(modelPropertyMachine, {
+            input: serviceInput,
+        });
+        this._service.start();
+        // Initialize original values from the input property
+        this._initializeOriginalValues(property);
+        // Note: Property getters/setters are now handled by the Proxy in create()
+    }
+    /**
+     * Initialize original values and schema name for tracking changes
+     * This is called asynchronously after construction
+     * If the property was loaded from the database and differs from the schema file,
+     * it will be marked as edited.
+     */
+    _initializeOriginalValues(property) {
+        // Resolve refModelId if ref/refModelName is provided but refModelId is missing
+        const refModelName = property.refModelName || property.ref;
+        if (refModelName && !property.refModelId) {
+            // Resolve refModelId asynchronously and update context
+            this._resolveRefModelId(refModelName).then((refModelId) => {
+                if (refModelId) {
+                    // Update the context with the resolved refModelId
+                    this._service.send({
+                        type: 'updateContext',
+                        refModelId,
+                    });
+                }
+            }).catch(() => {
+                // Ignore errors - model might not exist yet
+            });
+        }
+        // Get schema file values to use as "original" values
+        // This allows us to detect if the property was edited (DB value differs from schema file)
+        this._getSchemaFileValues(property).then((schemaFileValues) => {
+            // Use schema file values as original (not the current property values)
+            // This way, if current values differ from schema file, _isEdited will be true
+            const originalValues = schemaFileValues || {};
+            // Compare current property values with schema file values to determine if edited
+            // Only compare schema-relevant fields, not database-specific fields like id, modelId
+            let isEdited = false;
+            if (schemaFileValues) {
+                // Fields that are schema-relevant and should be compared
+                const schemaRelevantFields = [
+                    'dataType',
+                    'ref',
+                    'refModelName',
+                    'refValueType',
+                    'storageType',
+                    'localStorageDir',
+                    'filenameSuffix',
+                ];
+                // Check if any schema-relevant field differs between current property and schema file
+                isEdited = schemaRelevantFields.some((key) => {
+                    const currentValue = property[key];
+                    const originalValue = schemaFileValues[key];
+                    // Handle ref fields - compare by name
+                    if (key === 'ref' || key === 'refModelName') {
+                        const currentRef = property.refModelName || property.ref;
+                        const originalRef = schemaFileValues.refModelName || schemaFileValues.ref;
+                        // Both undefined/null means no ref, so they're the same
+                        if (!currentRef && !originalRef)
+                            return false;
+                        return currentRef !== originalRef;
+                    }
+                    // For other fields, compare values (handling undefined/null)
+                    if (currentValue === undefined && originalValue === undefined)
+                        return false;
+                    if (currentValue === null && originalValue === null)
+                        return false;
+                    if (currentValue === undefined && originalValue === null)
+                        return false;
+                    if (currentValue === null && originalValue === undefined)
+                        return false;
+                    return currentValue !== originalValue;
+                });
+            }
+            else {
+                // No schema file values found - this is a runtime-created property
+                // Use current property as original, but mark as edited since it hasn't been exported to file
+                TPropertyKeys.forEach((key) => {
+                    if (property[key] !== undefined) {
+                        originalValues[key] = property[key];
+                    }
+                });
+                // For runtime-created properties, set isEdited = true initially
+                isEdited = true;
+            }
+            // Initialize with original values, including isEdited flag
+            // Load isEdited from database if property exists in DB (async, fire-and-forget)
+            this._loadIsEditedFromDb(property, isEdited).then((isEditedFromDb) => {
+                this._service.send({
+                    type: 'initializeOriginalValues',
+                    originalValues,
+                    schemaName: undefined, // Will be set later if needed
+                    isEdited: isEditedFromDb,
+                });
+            }).catch(() => {
+                // If we can't load from DB, use computed isEdited value
+                this._service.send({
+                    type: 'initializeOriginalValues',
+                    originalValues,
+                    schemaName: undefined, // Will be set later if needed
+                    isEdited,
+                });
+            });
+        }).catch(() => {
+            // If we can't get schema file values, use current property as original
+            const originalValues = {};
+            TPropertyKeys.forEach((key) => {
+                if (property[key] !== undefined) {
+                    originalValues[key] = property[key];
+                }
+            });
+            this._service.send({
+                type: 'initializeOriginalValues',
+                originalValues,
+                schemaName: undefined,
+            });
+        });
+        // Get schema name from model asynchronously (fire-and-forget)
+        if (property.modelName) {
+            this._setSchemaName(property.modelName).catch(() => {
+                // If we can't get schema name, that's okay - it will be set later if needed
+            });
+        }
+    }
+    /**
+     * Load isEdited flag from database if property exists in DB
+     * @param property - The property data
+     * @param fallbackIsEdited - Fallback value if property doesn't exist in DB
+     * @returns The isEdited flag from database or fallback value
+     */
+    async _loadIsEditedFromDb(property, fallbackIsEdited) {
+        if (!property.modelName || !property.name) {
+            return fallbackIsEdited;
+        }
+        try {
+            const db = BaseDb.getAppDb();
+            if (!db) {
+                return fallbackIsEdited;
+            }
+            // Find model by name
+            const modelRecords = await db
+                .select({ id: models.id })
+                .from(models)
+                .where(eq(models.name, property.modelName))
+                .limit(1);
+            if (modelRecords.length === 0) {
+                return fallbackIsEdited;
+            }
+            // Find property by name and modelId
+            const propertyRecords = await db
+                .select({ isEdited: properties.isEdited })
+                .from(properties)
+                .where(and(eq(properties.name, property.name), eq(properties.modelId, modelRecords[0].id)))
+                .limit(1);
+            if (propertyRecords.length > 0) {
+                return propertyRecords[0].isEdited ?? false;
+            }
+        }
+        catch (error) {
+            // Ignore errors - use fallback value
+        }
+        return fallbackIsEdited;
+    }
+    /**
+     * Resolve refModelId from refModelName by querying the database
+     * @param refModelName - The name of the referenced model
+     * @returns The database ID of the referenced model, or undefined if not found
+     */
+    async _resolveRefModelId(refModelName) {
+        if (!refModelName) {
+            return undefined;
+        }
+        try {
+            const db = BaseDb.getAppDb();
+            if (!db) {
+                return undefined;
+            }
+            const refModelRecords = await db
+                .select()
+                .from(models)
+                .where(eq(models.name, refModelName))
+                .limit(1);
+            if (refModelRecords.length > 0 && refModelRecords[0].id) {
+                return refModelRecords[0].id;
+            }
+        }
+        catch (error) {
+            // Ignore errors - model might not exist yet or database not available
+            logger(`Error resolving refModelId for model "${refModelName}":`, error);
+        }
+        return undefined;
+    }
+    /**
+     * Get schema file values for this property to use as "original" values
+     * This allows comparison with database values to detect edits
+     */
+    async _getSchemaFileValues(property) {
+        if (!property.modelName || !property.name) {
+            return undefined;
+        }
+        try {
+            const model = await Model.getByNameAsync(property.modelName);
+            if (!model || !model.properties || model.properties.length === 0) {
+                return undefined;
+            }
+            const schema = modelPropertiesToObject(model.properties);
+            // Get the schema file value for this property
+            const schemaFileValue = schema[property.name];
+            if (!schemaFileValue) {
+                return undefined;
+            }
+            // Return schema file values as original values
+            const originalValues = {
+                name: property.name,
+                modelName: property.modelName,
+                dataType: schemaFileValue.dataType,
+                storageType: schemaFileValue.storageType,
+                localStorageDir: schemaFileValue.localStorageDir,
+                filenameSuffix: schemaFileValue.filenameSuffix,
+            };
+            // Handle ref fields
+            if (schemaFileValue.ref) {
+                originalValues.ref = schemaFileValue.ref;
+                originalValues.refModelName = schemaFileValue.ref;
+                // Try to get refModelId from database
+                const refModelId = await this._resolveRefModelId(schemaFileValue.ref);
+                if (refModelId) {
+                    originalValues.refModelId = refModelId;
+                }
+            }
+            if (schemaFileValue.refValueType) {
+                originalValues.refValueType = schemaFileValue.refValueType;
+            }
+            return originalValues;
+        }
+        catch (error) {
+            return undefined;
+        }
+    }
+    /**
+     * Set the schema name for this property by looking it up from the model
+     * Tries database first (more reliable), then falls back to schema files
+     */
+    async _setSchemaName(modelName) {
+        try {
+            let schemaName;
+            // Try to get schema name from database first (more reliable)
+            if (this.modelId) {
+                try {
+                    const db = BaseDb.getAppDb();
+                    if (db) {
+                        const modelSchemaRecords = await db
+                            .select({
+                            schemaName: schemas.name,
+                        })
+                            .from(modelSchemas)
+                            .innerJoin(schemas, eq(modelSchemas.schemaId, schemas.id))
+                            .innerJoin(models, eq(modelSchemas.modelId, models.id))
+                            .where(eq(models.id, this.modelId))
+                            .limit(1);
+                        if (modelSchemaRecords.length > 0) {
+                            schemaName = modelSchemaRecords[0].schemaName;
+                        }
+                    }
+                }
+                catch (error) {
+                    // Database lookup failed, continue to file-based lookup
+                }
+            }
+            // Fall back to schema file lookup if database didn't work
+            if (!schemaName) {
+                schemaName = await getSchemaNameFromModel(modelName);
+            }
+            if (schemaName) {
+                // Update the context with the schema name using dedicated event
+                this._service.send({
+                    type: 'setSchemaName',
+                    schemaName,
+                });
+            }
+        }
+        catch (error) {
+            // If we can't get schema name, that's okay - it will be set later if needed
+        }
+    }
+    /**
+     * Manually set the schema name for this property
+     * Useful when you know the schema name from context (e.g., when working with Schema instances)
+     */
+    setSchemaName(schemaName) {
+        this._service.send({
+            type: 'setSchemaName',
+            schemaName,
+        });
+    }
+    static create(property, options) {
+        if (!property) {
+            throw new Error('Property is required');
+        }
+        const waitForReady = options?.waitForReady !== false;
+        const readyTimeout = options?.readyTimeout ?? 5000;
+        const schemaName = options?.schemaName;
+        // Handle 'type' field from JSON schema format - convert to 'dataType'
+        // Normalize to PascalCase so lowercase values from JSON (e.g. 'text') work
+        const propertyWithId = { ...property };
+        const rawType = propertyWithId.dataType ?? propertyWithId.type;
+        if (rawType) {
+            propertyWithId.dataType = normalizeDataType(rawType);
+        }
+        // Ensure id (schemaFileId) is set correctly
+        // Priority: _propertyFileId > id (if string) > generate new
+        // If id is a number (old format), use _propertyFileId instead
+        if (typeof propertyWithId.id === 'number') {
+            // id is a database integer ID, not schemaFileId - use _propertyFileId if available
+            if (propertyWithId._propertyFileId) {
+                propertyWithId.id = propertyWithId._propertyFileId;
+            }
+            else {
+                // Fallback: generate new schemaFileId (shouldn't happen, but safety)
+                propertyWithId.id = generateId();
+                logger(`ModelProperty.create: id was a number, generated new schemaFileId "${propertyWithId.id}" for property "${property.name}"`);
+            }
+        }
+        else if (!propertyWithId.id && propertyWithId._propertyFileId) {
+            // id is not set but _propertyFileId is available - use it
+            propertyWithId.id = propertyWithId._propertyFileId;
+        }
+        else if (!propertyWithId.id) {
+            // Generate id (schemaFileId) if not provided (for new properties)
+            // This ensures new properties can trigger write process
+            propertyWithId.id = generateId();
+            logger(`ModelProperty.create: Generated new id (schemaFileId) "${propertyWithId.id}" for property "${property.name}"`);
+        }
+        // Create cache key from modelName and name, or use id
+        const cacheKey = propertyWithId.modelName && propertyWithId.name
+            ? `${propertyWithId.modelName}:${propertyWithId.name}`
+            : propertyWithId.id
+                ? `id:${propertyWithId.id}`
+                : propertyWithId.name || 'unnamed';
+        // Check if instance exists in cache
+        if (this.instanceCache.has(cacheKey)) {
+            const { instance, refCount } = this.instanceCache.get(cacheKey);
+            const cachedContext = instance._getSnapshotContext();
+            // Update cached instance if new property data has fields that the cached instance doesn't have
+            // This handles cases where the property was created without ref initially, but now we have ref from schema
+            const needsUpdate = {};
+            if (propertyWithId.ref && !cachedContext.ref) {
+                needsUpdate.ref = propertyWithId.ref;
+            }
+            if (propertyWithId.refModelName && !cachedContext.refModelName) {
+                needsUpdate.refModelName = propertyWithId.refModelName;
+            }
+            if (propertyWithId.refModelId && !cachedContext.refModelId) {
+                needsUpdate.refModelId = propertyWithId.refModelId;
+            }
+            if (Object.keys(needsUpdate).length > 0) {
+                instance._service.send({
+                    type: 'updateContext',
+                    ...needsUpdate,
+                });
+            }
+            this.instanceCache.set(cacheKey, {
+                instance,
+                refCount: refCount + 1,
+            });
+            if (!waitForReady)
+                return instance;
+            return waitForEntityIdle(instance, { timeout: readyTimeout }).then(() => instance);
+        }
+        const newInstance = new this(propertyWithId);
+        // Set schema name before async operations so getModelId can resolve the correct model
+        if (schemaName) {
+            newInstance._service.send({
+                type: 'setSchemaName',
+                schemaName,
+            });
+        }
+        // Wrap instance in Proxy for reactive property access
+        const proxiedInstance = createReactiveProxy({
+            instance: newInstance,
+            service: newInstance._service,
+            trackedProperties: TPropertyKeys,
+            getContext: (instance) => {
+                const context = instance._getSnapshotContext();
+                return context;
+            },
+            sendUpdate: (instance, prop, value) => {
+                const currentContext = instance._getSnapshotContext();
+                if (currentContext[prop] === value)
+                    return; // No-op, avoid triggering machine
+                instance._service.send({
+                    type: 'updateContext',
+                    [prop]: value,
+                });
+            },
+        });
+        this.instanceCache.set(cacheKey, {
+            instance: proxiedInstance,
+            refCount: 1,
+        });
+        // Trigger write process if property has modelId (or modelName) and id (schemaFileId)
+        // Wait for service to be ready (idle state) and have writeProcess spawned
+        const propertyFileId = propertyWithId.id; // id is now the schemaFileId (string)
+        const hasModelId = propertyWithId.modelId || propertyWithId.modelName;
+        if (hasModelId && propertyFileId) {
+            // Wait for writeProcess to be spawned (it's spawned in idle state entry action)
+            // Retry a few times if writeProcess isn't available yet
+            let retries = 0;
+            const maxRetries = 10;
+            const checkAndSend = async () => {
+                const service = proxiedInstance.getService();
+                const snapshot = service.getSnapshot();
+                if (snapshot.value === 'idle' && snapshot.context.writeProcess) {
+                    const writeProcess = snapshot.context.writeProcess;
+                    // Resolve dbModelId - convert from string (modelFileId) to number (database ID) if needed
+                    let resolvedModelId = undefined;
+                    if (propertyWithId.modelId) {
+                        if (typeof propertyWithId.modelId === 'number') {
+                            resolvedModelId = propertyWithId.modelId;
+                        }
+                        else if (typeof propertyWithId.modelId === 'string') {
+                            // modelId is a string (modelFileId), need to convert to database ID
+                            try {
+                                resolvedModelId = await getModelIdByFileId(propertyWithId.modelId);
+                                logger(`Converted modelFileId "${propertyWithId.modelId}" to database modelId: ${resolvedModelId}`);
+                            }
+                            catch (error) {
+                                logger(`Failed to convert modelFileId "${propertyWithId.modelId}" to database ID: ${error}`);
+                                console.error(`[ModelProperty.create] Failed to convert modelFileId: ${error}`);
+                            }
+                        }
+                    }
+                    // If we still don't have a modelId, try to resolve it from modelName
+                    if (!resolvedModelId && propertyWithId.modelName) {
+                        try {
+                            // Get schemaName from context if available
+                            const schemaName = snapshot.context._schemaName;
+                            resolvedModelId = await getModelId(propertyWithId.modelName, schemaName);
+                            logger(`Resolved modelId for model "${propertyWithId.modelName}": ${resolvedModelId}`);
+                        }
+                        catch (error) {
+                            logger(`Failed to resolve modelId for model "${propertyWithId.modelName}": ${error}`);
+                            console.error(`[ModelProperty.create] Failed to resolve modelId: ${error}`);
+                        }
+                    }
+                    if (!resolvedModelId) {
+                        logger(`ERROR: Cannot write property "${property.name}" - no modelId available`);
+                        console.error(`[ModelProperty.create] ERROR: Cannot write property "${property.name}" - no modelId available. modelId: ${propertyWithId.modelId}, modelName: ${propertyWithId.modelName}`);
+                        // Don't clear pending write here - it might resolve later
+                        return;
+                    }
+                    // Track pending write now that we have the resolved modelId
+                    this.trackPendingWrite(propertyFileId, resolvedModelId);
+                    logger(`Triggering write process for property "${property.name}" (modelId: ${resolvedModelId}, propertyFileId: ${propertyFileId})`);
+                    // Check current write state
+                    const currentWriteState = writeProcess.getSnapshot();
+                    if (currentWriteState.value === 'success') {
+                        // Write already succeeded, clear pending write immediately
+                        this.clearPendingWrite(propertyFileId, 'success');
+                    }
+                    else {
+                        // Set up subscription to catch future state changes
+                        const writeSubscription = writeProcess.subscribe((writeSnapshot) => {
+                            if (writeSnapshot.value === 'success') {
+                                writeSubscription.unsubscribe();
+                                logger(`[writeProcess subscription] Write succeeded for property "${property.name}" (propertyFileId: ${propertyFileId})`);
+                                // Clear pending write on success
+                                this.clearPendingWrite(propertyFileId, 'success');
+                            }
+                            else if (writeSnapshot.value === 'error') {
+                                writeSubscription.unsubscribe();
+                                const errorContext = writeSnapshot.context;
+                                logger(`Write process failed for property "${property.name}" (propertyFileId: ${propertyFileId}): ${errorContext.error?.message || 'Unknown error'}`);
+                                logger(`Write process error details:`, errorContext.error);
+                                // Mark pending write as error
+                                this.clearPendingWrite(propertyFileId, 'error');
+                            }
+                        });
+                    }
+                    const propertyData = {
+                        modelId: resolvedModelId,
+                        name: property.name,
+                        dataType: property.dataType,
+                        refModelId: property.refModelId,
+                        refValueType: property.refValueType,
+                        storageType: property.storageType,
+                        localStorageDir: property.localStorageDir,
+                        filenameSuffix: property.filenameSuffix,
+                    };
+                    service.send({
+                        type: 'requestWrite',
+                        data: propertyData,
+                    });
+                }
+                else if (retries < maxRetries) {
+                    retries++;
+                    setTimeout(checkAndSend, 50); // Retry after 50ms
+                }
+                else {
+                    logger(`ERROR: writeProcess not available after ${maxRetries} retries for property "${property.name}" (propertyFileId: ${propertyFileId})`);
+                    console.error(`[ModelProperty.create] ERROR: writeProcess not available after ${maxRetries} retries for property "${property.name}" (propertyFileId: ${propertyFileId})`);
+                    // Mark as error if we couldn't even start the write process
+                    this.clearPendingWrite(propertyFileId, 'error');
+                }
+            };
+            // Start checking after a short delay to allow state machine to initialize
+            setTimeout(checkAndSend, 0);
+        }
+        if (!waitForReady)
+            return proxiedInstance;
+        return waitForEntityIdle(proxiedInstance, { timeout: readyTimeout }).then(() => proxiedInstance);
+    }
+    /**
+     * Get ModelProperty instance by propertyFileId from static cache
+     */
+    static getById(propertyFileId) {
+        if (!propertyFileId)
+            return undefined;
+        // Search through cache to find by propertyFileId
+        // Cache key might be "modelName:propertyName" or "id:propertyId"
+        for (const [cacheKey, { instance }] of this.instanceCache.entries()) {
+            const context = instance._getSnapshotContext();
+            // id is now the schemaFileId (string)
+            if (context.id === propertyFileId) {
+                return instance;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Create or get ModelProperty instance by propertyFileId
+     * Queries the database to find the property if not cached
+     */
+    static async createById(propertyFileId) {
+        if (!propertyFileId) {
+            return undefined;
+        }
+        // First, check if we have an instance cached
+        const cachedInstance = this.getById(propertyFileId);
+        if (cachedInstance) {
+            return cachedInstance;
+        }
+        // Query database to get property data from ID
+        const db = BaseDb.getAppDb();
+        if (!db) {
+            return undefined;
+        }
+        await db
+            .select()
+            .from(properties)
+            .limit(100);
+        const propertyRecords = await db
+            .select()
+            .from(properties)
+            .where(eq(properties.schemaFileId, propertyFileId))
+            .limit(1);
+        if (propertyRecords.length === 0) {
+            return undefined;
+        }
+        const propertyRecord = propertyRecords[0];
+        // Get model name
+        const modelRecords = await db
+            .select({ name: models.name })
+            .from(models)
+            .where(eq(models.id, propertyRecord.modelId))
+            .limit(1);
+        if (modelRecords.length === 0) {
+            return undefined;
+        }
+        const modelName = modelRecords[0].name;
+        // Build property data
+        // id is now the schemaFileId (string), _dbId is the database integer ID
+        const propertyData = {
+            id: propertyFileId, // schemaFileId (string) - public ID
+            _dbId: propertyRecord.id ?? undefined, // Database integer ID - internal only
+            name: propertyRecord.name,
+            dataType: propertyRecord.dataType,
+            modelId: propertyRecord.modelId,
+            modelName,
+            refModelId: propertyRecord.refModelId || undefined,
+            refValueType: propertyRecord.refValueType ? propertyRecord.refValueType : undefined,
+        };
+        // Load isEdited from database
+        const isEditedFromDb = propertyRecord.isEdited ?? false;
+        // Get ref model name if applicable
+        if (propertyRecord.refModelId) {
+            const refModelRecords = await db
+                .select({ name: models.name })
+                .from(models)
+                .where(eq(models.id, propertyRecord.refModelId))
+                .limit(1);
+            if (refModelRecords.length > 0) {
+                propertyData.refModelName = refModelRecords[0].name;
+                propertyData.ref = refModelRecords[0].name;
+            }
+        }
+        // Create ModelProperty instance (sync for createById so we can send updateContext)
+        const instance = this.create(propertyData, { waitForReady: false });
+        // Set isEdited from database after creation
+        if (isEditedFromDb) {
+            instance._service.send({
+                type: 'updateContext',
+                _isEdited: true,
+            });
+        }
+        return instance;
+    }
+    /**
+     * Find ModelProperty instance by propertyFileId
+     * Waits for the property to be fully loaded (idle state) by default
+     * @param options - Find options including propertyFileId and wait configuration
+     * @returns ModelProperty instance if found, undefined otherwise
+     */
+    static async find({ propertyFileId, waitForReady = true, readyTimeout = 5000, }) {
+        if (!propertyFileId) {
+            return undefined;
+        }
+        return await findEntity({
+            getById: (id) => ModelProperty.getById(id),
+            createById: (id) => ModelProperty.createById(id),
+        }, { id: propertyFileId }, {
+            waitForReady,
+            readyTimeout,
+        });
+    }
+    /**
+     * Get all ModelProperty instances for a model.
+     * Loads property rows from DB for the given modelFileId, creates instances via createById, optionally waits for idle.
+     */
+    static async all(modelFileId, options) {
+        const { waitForReady = false, readyTimeout = 5000 } = options ?? {};
+        if (!modelFileId) {
+            return [];
+        }
+        const rows = await getModelPropertiesData(modelFileId);
+        const instances = [];
+        for (const row of rows) {
+            if (row.schemaFileId) {
+                const instance = await this.createById(row.schemaFileId);
+                if (instance) {
+                    instances.push(instance);
+                }
+            }
+        }
+        if (waitForReady && instances.length > 0) {
+            await Promise.all(instances.map((p) => waitForEntityIdle(p, {
+                timeout: readyTimeout,
+            })));
+        }
+        return instances;
+    }
+    /**
+     * Track a pending write for a property
+     */
+    static trackPendingWrite(propertyFileId, modelId) {
+        this.pendingWrites.set(propertyFileId, {
+            propertyFileId,
+            modelId,
+            status: 'pending',
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Clear or update pending write status
+     */
+    static clearPendingWrite(propertyFileId, status = 'success') {
+        const write = this.pendingWrites.get(propertyFileId);
+        if (write) {
+            if (status === 'success') {
+                // Remove successful writes from pendingWrites
+                this.pendingWrites.delete(propertyFileId);
+                logger(`Cleared pending write for property "${propertyFileId}" (status: success)`);
+            }
+            else {
+                // Update status to error but keep in map (for debugging/retry purposes)
+                write.status = 'error';
+                this.pendingWrites.set(propertyFileId, write);
+                logger(`Marked pending write as error for property "${propertyFileId}"`);
+            }
+        }
+    }
+    /**
+     * Get all pending property IDs for a model
+     */
+    static getPendingPropertyIds(modelId) {
+        return Array.from(this.pendingWrites.entries())
+            .filter(([_, write]) => write.modelId === modelId && write.status !== 'error')
+            .map(([propertyFileId]) => propertyFileId);
+    }
+    /**
+     * Get modelId for a property that has a pending write (row may not be in DB yet).
+     * Used to resolve modelName when validating a just-created property rename.
+     */
+    static getPendingModelId(propertyFileId) {
+        return this.pendingWrites.get(propertyFileId)?.modelId;
+    }
+    getService() {
+        return this._service;
+    }
+    _getSnapshot() {
+        return this._service.getSnapshot();
+    }
+    _getSnapshotContext() {
+        return this._getSnapshot().context;
+    }
+    get path() {
+        const workingDir = BaseFileManager.getWorkingDir();
+        if (!this.localStorageDir || !this.name || !this.filenameSuffix) {
+            return undefined;
+        }
+        return `${workingDir}/${this.localStorageDir}/${this.name}${this.filenameSuffix || ''}`;
+    }
+    get status() {
+        return this._getSnapshot().value;
+    }
+    get isEdited() {
+        const context = this._getSnapshotContext();
+        // First check in-memory state
+        if (context._isEdited !== undefined) {
+            return context._isEdited;
+        }
+        // Fall back to reading from database if we have _dbId
+        if (context._dbId) {
+            // Load from database asynchronously (fire-and-forget for now)
+            // For synchronous getter, we'll need to cache it or make it async
+            // For now, return false if not in context
+            return false;
+        }
+        return false;
+    }
+    get validationErrors() {
+        return this._getSnapshotContext()._validationErrors || [];
+    }
+    get isValid() {
+        const errors = this.validationErrors;
+        return errors.length === 0;
+    }
+    /**
+     * Validate the property
+     * @returns Validation result
+     */
+    async validate() {
+        return new Promise((resolve) => {
+            let resolved = false;
+            const subscription = this._service.subscribe((snapshot) => {
+                const state = snapshot.value;
+                // Wait for validation to complete (idle state after validating)
+                if (state === 'idle' && !resolved) {
+                    resolved = true;
+                    subscription.unsubscribe();
+                    const errors = snapshot.context._validationErrors || [];
+                    resolve({
+                        isValid: errors.length === 0,
+                        errors,
+                    });
+                }
+            });
+            this._service.send({ type: 'validateProperty' });
+            // Timeout fallback
+            setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    subscription.unsubscribe();
+                    const errors = this._getSnapshotContext()._validationErrors || [];
+                    resolve({
+                        isValid: errors.length === 0,
+                        errors,
+                    });
+                }
+            }, 5000);
+        });
+    }
+    save() {
+        const snapshot = this._service.getSnapshot();
+        const isAlreadySaving = typeof snapshot.value === 'object' && snapshot.value !== null && 'saveToSchema' in snapshot.value;
+        if (isAlreadySaving) {
+            return;
+        }
+        const context = snapshot.context;
+        if (!context._isEdited)
+            return; // No changes to persist
+        // Validation will happen automatically in the machine before saving
+        this._service.send({
+            type: 'saveToSchema',
+        });
+    }
+    /**
+     * Reload property from database
+     * This refreshes the actor context with the latest data from the database
+     * Note: ModelProperty doesn't have a dedicated load actor, so this will
+     * re-initialize from the current property data
+     */
+    async reload() {
+        // ModelProperty doesn't have a separate load mechanism
+        // It's loaded as part of the Model/Schema
+        // This method is provided for API consistency
+        // To actually reload, you'd need to reload the parent Model or Schema
+        logger('ModelProperty.reload() called - ModelProperty is loaded as part of Model/Schema. Reload the parent Model or Schema instead.');
+        // No-op for now, but could be enhanced to reload from DB if needed
+    }
+    unload() {
+        // ModelProperty doesn't have liveQuery subscriptions or complex cache management
+        // Just stop the service
+        try {
+            this._service.stop();
+        }
+        catch (error) {
+            // Service might already be stopped
+        }
+    }
+    /**
+     * Destroy the model property: remove from caches, delete from database, update Schema context, stop service.
+     */
+    async destroy() {
+        const context = this._getSnapshotContext();
+        const cacheKey = context.modelName && context.name
+            ? `${context.modelName}:${context.name}`
+            : (context.id ?? '');
+        if (!cacheKey)
+            return;
+        forceRemoveFromCaches(this, {
+            getCacheKeys: () => [cacheKey],
+            caches: [ModelProperty.instanceCache],
+        });
+        await runDestroyLifecycle(this, {
+            getService: (instance) => instance._service,
+            doDestroy: async () => {
+                const db = BaseDb.getAppDb();
+                const schemaName = context._schemaName;
+                const modelName = context.modelName;
+                const propertyName = context.name;
+                if (!modelName || !propertyName)
+                    return;
+                if (db && schemaName) {
+                    const propertyRecords = await db
+                        .select({ propertyId: properties.id })
+                        .from(properties)
+                        .innerJoin(models, eq(properties.modelId, models.id))
+                        .innerJoin(modelSchemas, eq(models.id, modelSchemas.modelId))
+                        .innerJoin(schemas, eq(modelSchemas.schemaId, schemas.id))
+                        .where(and(eq(schemas.name, schemaName), eq(models.name, modelName), eq(properties.name, propertyName)))
+                        .limit(1);
+                    if (propertyRecords.length > 0 && propertyRecords[0].propertyId != null) {
+                        await db
+                            .delete(properties)
+                            .where(eq(properties.id, propertyRecords[0].propertyId));
+                    }
+                }
+                if (schemaName) {
+                    const schema = Schema.create(schemaName, { waitForReady: false });
+                    const snapshot = schema.getService().getSnapshot();
+                    const schemaContext = snapshot.context;
+                    if (schemaContext.models?.[modelName]?.properties?.[propertyName]) {
+                        const updatedModels = { ...schemaContext.models };
+                        const updatedProperties = { ...updatedModels[modelName].properties };
+                        delete updatedProperties[propertyName];
+                        updatedModels[modelName] = { ...updatedModels[modelName], properties: updatedProperties };
+                        schema.getService().send({ type: 'updateContext', models: updatedModels });
+                        schema.getService().send({ type: 'markAsDraft', propertyKey: `property:${modelName}:${propertyName}` });
+                    }
+                }
+            },
+        });
+    }
+}
+ModelProperty.instanceCache = new Map();
+// Pending writes tracking
+ModelProperty.pendingWrites = new Map();
+
+var ModelProperty$1 = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    ModelProperty: ModelProperty
+});
+
+export { ModelProperty };
+//# sourceMappingURL=ModelProperty-B9Z2DRxI.js.map