@seedprotocol/sdk 0.4.2 → 0.4.3

package/dist/ItemProperty/ItemProperty.d.ts

@@ -0,0 +1,93 @@
+import { ActorRefFrom, Subscription } from 'xstate';
+import { BehaviorSubject, Subscriber } from 'rxjs';
+import { Static } from '@sinclair/typebox';
+import { IItemProperty } from '@/interfaces/IItemProperty';
+import { CreatePropertyInstanceProps, PropertyMachineContext } from '@/types';
+import { propertyMachine } from './service/propertyMachine';
+import type { TProperty } from '@/Schema';
+type ItemPropertyService = ActorRefFrom<typeof propertyMachine>;
+type ItemPropertyFindProps = {
+    propertyName: string;
+    propertyLocalId?: string;
+    seedLocalId?: string;
+    seedUid?: string;
+};
+export declare class ItemProperty<PropertyType> implements IItemProperty<PropertyType> {
+    protected static instanceCache: Map<string, {
+        instance: ItemProperty<any>;
+        refCount: number;
+    }>;
+    protected readonly _service: ItemPropertyService;
+    protected _subject: BehaviorSubject<any>;
+    protected readonly _isRelation: boolean;
+    protected readonly _isList: boolean;
+    protected readonly _alias: string | undefined;
+    protected _subscription: Subscription;
+    protected _dataType: string | undefined;
+    protected _schemaUid: string | undefined;
+    constructor(initialValues: Partial<CreatePropertyInstanceProps>);
+    /**
+     * Set up liveQuery subscription to watch for metadata changes in the database
+     * This enables cross-instance synchronization (e.g., changes in other tabs/windows)
+     */
+    private _setupLiveQuerySubscription;
+    static create(props: Partial<CreatePropertyInstanceProps>): ItemProperty<any> | undefined;
+    static find({ propertyName, seedLocalId, seedUid, waitForReady, readyTimeout, }: ItemPropertyFindProps & {
+        waitForReady?: boolean;
+        readyTimeout?: number;
+    }): Promise<ItemProperty<any> | undefined>;
+    find: typeof ItemProperty.find;
+    static cacheKey(seedLocalIdOrUid: string, propertyName: string): string;
+    getService(): import("xstate").ActorRef<import("xstate").MachineSnapshot<PropertyMachineContext, import("xstate").AnyEventObject, {
+        [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("@/types").SaveValueToDbEvent>, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext>, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>> | undefined;
+    }, "error" | "idle" | "initializing" | "waitingForDb" | "loading" | "hydratingFromDb" | "resolvingRelatedValue" | "resolvingRemoteStorage" | {
+        saving: "analyzingInput" | "doneSaving" | "savingImage" | "savingRelation" | "savingItemStorage";
+    }, string, import("xstate").NonReducibleUnknown, import("xstate").MetaObject, {
+        id: "itemProperty";
+        states: {
+            readonly idle: {};
+            readonly waitingForDb: {};
+            readonly loading: {};
+            readonly error: {};
+            readonly hydratingFromDb: {};
+            readonly initializing: {};
+            readonly resolvingRelatedValue: {};
+            readonly resolvingRemoteStorage: {};
+            readonly saving: {
+                states: {
+                    readonly analyzingInput: {};
+                    readonly savingImage: {};
+                    readonly savingRelation: {};
+                    readonly savingItemStorage: {};
+                    readonly doneSaving: {};
+                };
+            };
+        };
+    }>, import("xstate").AnyEventObject, import("xstate").EventObject>;
+    private _getSnapshot;
+    private _getSnapshotContext;
+    get localId(): string;
+    get uid(): string;
+    get seedLocalId(): string;
+    get seedUid(): string;
+    get schemaUid(): string | undefined;
+    get propertyName(): string;
+    get modelName(): string;
+    get propertyDef(): Static<typeof TProperty> | undefined;
+    get localStorageDir(): string | void;
+    get refResolvedValue(): string | undefined;
+    get localStoragePath(): string | void;
+    get versionLocalId(): string | undefined;
+    get status(): "error" | "idle" | "initializing" | "waitingForDb" | "loading" | "hydratingFromDb" | "resolvingRelatedValue" | "resolvingRemoteStorage" | {
+        saving: "analyzingInput" | "doneSaving" | "savingImage" | "savingRelation" | "savingItemStorage";
+    };
+    get alias(): string | undefined;
+    get value(): any;
+    set value(value: any);
+    get published(): boolean;
+    subscribe(callback: Partial<Subscriber<any>>): Subscription;
+    save(): Promise<void>;
+    unload(): void;
+}
+export {};
+//# sourceMappingURL=ItemProperty.d.ts.map

package/dist/ItemProperty/ItemProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemProperty.d.ts","sourceRoot":"","sources":["../../src/ItemProperty/ItemProperty.ts"],"names":[],"mappings":"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"}

package/dist/ItemProperty/service/actors/hydrateFromDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateFromDb.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/hydrateFromDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAMlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAOzD,eAAO,MAAM,aAAa,uHAwQxB,CAAA"}

package/dist/ItemProperty/service/actors/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAMzD,eAAO,MAAM,UAAU,uHAqFrB,CAAA"}

package/dist/ItemProperty/service/actors/loadOrCreateProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadOrCreateProperty.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/loadOrCreateProperty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AASzD,eAAO,MAAM,oBAAoB,0GAoI/B,CAAA"}

package/dist/ItemProperty/service/actors/resolveRelatedValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRelatedValue.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/resolveRelatedValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAgB,QAAQ,CAAA;AAG5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAYzD,eAAO,MAAM,mBAAmB,uHAmM9B,CAAA"}

package/dist/ItemProperty/service/actors/resolveRemoteStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRemoteStorage.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/resolveRemoteStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAIzD,eAAO,MAAM,oBAAoB,uHAkF/B,CAAA"}

package/dist/ItemProperty/service/actors/saveValueToDb/analyzeInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeInput.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/saveValueToDb/analyzeInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAkBzB,eAAO,MAAM,YAAY,8HAqJvB,CAAA"}

package/dist/ItemProperty/service/actors/saveValueToDb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/saveValueToDb/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA"}

package/dist/ItemProperty/service/actors/saveValueToDb/saveImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveImage.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/saveValueToDb/saveImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAkDzB,eAAO,MAAM,SAAS,8HA+LpB,CAAA"}

package/dist/ItemProperty/service/actors/saveValueToDb/saveItemStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveItemStorage.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/saveValueToDb/saveItemStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AASzB,eAAO,MAAM,eAAe,8HAiJ1B,CAAA"}

package/dist/ItemProperty/service/actors/saveValueToDb/saveRelation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saveRelation.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/saveValueToDb/saveRelation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAKzB,eAAO,MAAM,YAAY,8HA4GvB,CAAA"}

package/dist/ItemProperty/service/actors/waitForDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForDb.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/actors/waitForDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAMnE,eAAO,MAAM,SAAS,0GAwCpB,CAAA"}

package/dist/ItemProperty/service/propertyMachine.d.ts

@@ -0,0 +1,68 @@
+import { PropertyMachineContext, SaveValueToDbEvent } from '@/types';
+export declare const propertyMachine: import("xstate").StateMachine<PropertyMachineContext, import("xstate").AnyEventObject, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext>, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>> | undefined;
+}, {
+    src: "saveRelation";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "saveImage";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "saveItemStorage";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "waitForDb";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "loadOrCreateProperty";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "hydrateFromDb";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "initialize";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "resolveRelatedValue";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "resolveRemoteStorage";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "analyzeInput";
+    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("@/types").FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, import("xstate").EventObject>;
+    id: string | undefined;
+}, never, never, never, "error" | "idle" | "initializing" | "waitingForDb" | "loading" | "hydratingFromDb" | "resolvingRelatedValue" | "resolvingRemoteStorage" | {
+    saving: "analyzingInput" | "doneSaving" | "savingImage" | "savingRelation" | "savingItemStorage";
+}, string, PropertyMachineContext, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "itemProperty";
+    states: {
+        readonly idle: {};
+        readonly waitingForDb: {};
+        readonly loading: {};
+        readonly error: {};
+        readonly hydratingFromDb: {};
+        readonly initializing: {};
+        readonly resolvingRelatedValue: {};
+        readonly resolvingRemoteStorage: {};
+        readonly saving: {
+            states: {
+                readonly analyzingInput: {};
+                readonly savingImage: {};
+                readonly savingRelation: {};
+                readonly savingItemStorage: {};
+                readonly doneSaving: {};
+            };
+        };
+    };
+}>;
+//# sourceMappingURL=propertyMachine.d.ts.map

package/dist/ItemProperty/service/propertyMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyMachine.d.ts","sourceRoot":"","sources":["../../../src/ItemProperty/service/propertyMachine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAgBpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0O1B,CAAA"}

package/dist/Model/Model.d.ts

@@ -0,0 +1,218 @@
+import { ActorRefFrom } from 'xstate';
+import { modelMachine, ModelMachineContext } from './service/modelMachine';
+import { Item } from '@/Item/Item';
+import { ItemData } from '@/types/item';
+type ModelService = ActorRefFrom<typeof modelMachine>;
+export declare class Model {
+    protected static instanceCacheById: Map<string, // modelFileId
+    {
+        instance: Model;
+        refCount: number;
+    }>;
+    protected static instanceCacheByName: Map<string, // "schemaName:modelName"
+    string>;
+    protected static instanceCache: Map<string, {
+        instance: Model;
+        refCount: number;
+    }>;
+    private static pendingWrites;
+    protected static savingModels: Set<string>;
+    private static cachedClientInitialized;
+    private static clientCheckTime;
+    private static readonly CLIENT_CHECK_CACHE_MS;
+    static trackPendingWrite(modelFileId: string, schemaId: number): void;
+    static getPendingModelIds(schemaId: number): string[];
+    protected readonly _service: ModelService;
+    modelName?: string;
+    schemaName?: string;
+    _properties?: any[];
+    constructor(modelName: string, schemaName: string, id?: string, // schemaFileId (string) - public ID
+    initialContext?: Pick<ModelMachineContext, '_pendingPropertyDefinitions'>);
+    /**
+     * Find a unique model name by checking for duplicates (case-insensitive) in the cache
+     * If duplicates are found, appends an incrementing number to make it unique
+     *
+     * @param modelName - The desired model name
+     * @param schemaName - The schema name
+     * @param skipAllChecks - If true, skip all duplicate checks and return original name (used when creating schema models to preserve original names)
+     * @returns A unique model name
+     */
+    static findUniqueModelName(modelName: string, schemaName: string, skipAllChecks?: boolean): string;
+    /**
+     * Create a new Model instance or return existing cached instance
+     *
+     * @param modelName - The name of the model
+     * @param schemaNameOrSchema - The schema name (string) or Schema instance
+     * @param options - Optional configuration (can be omitted to create model with empty properties):
+     *   - modelFileId: Pre-existing model file ID
+     *   - properties: Model properties definition (defaults to empty object if not provided)
+     *   - registerWithSchema: Whether to automatically register this model with its schema (default: true if schema instance provided)
+     *
+     * @example
+     * // Create model with empty properties
+     * const model = Model.create('MyModel', schema)
+     *
+     * @example
+     * // Create model with properties
+     * const model = Model.create('MyModel', schema, {
+     *   properties: { title: { dataType: 'String' } }
+     * })
+     */
+    static create(modelName: string, schemaNameOrSchema: string | any, // Schema type - using any to avoid circular dependency
+    options?: {
+        id?: string;
+        modelFileId?: string;
+        properties?: {
+            [propertyName: string]: any;
+        };
+        registerWithSchema?: boolean;
+    }): Model;
+    /**
+     * Get Model instance by modelFileId (O(1) lookup)
+     */
+    static getById(modelFileId: string): Model | undefined;
+    /**
+     * Get Model instance by name (O(1) lookup via name→ID mapping)
+     *
+     * @param modelName - The name of the model
+     * @param schemaName - The schema name (optional, will query DB if not provided)
+     * @returns The Model instance if found, undefined otherwise
+     */
+    static getByName(modelName: string, schemaName?: string): Model | undefined;
+    /**
+     * Get Model instance by name, querying database if not in cache
+     * This is an async version that can query the database when schemaName is not provided
+     *
+     * @param modelName - The name of the model
+     * @param schemaName - Optional schema name (will query DB if not provided)
+     * @returns The Model instance if found, undefined otherwise
+     */
+    static getByNameAsync(modelName: string, schemaName?: string): Promise<Model | undefined>;
+    /**
+     * Create or get Model instance by modelFileId
+     * Checks cache first, then database if not found
+     *
+     * @param modelFileId - The model file ID to look up
+     * @returns The Model instance if found, undefined otherwise
+     */
+    static createById(modelFileId: string): Promise<Model | undefined>;
+    /**
+     * Find Model instance by modelFileId, modelName/schemaName, or both
+     * Waits for the model to be fully loaded (idle state) by default
+     * @param options - Find options including lookup parameters and wait configuration
+     * @returns Model instance if found, undefined otherwise
+     */
+    static find({ modelFileId, modelName, schemaName, waitForReady, readyTimeout, }: {
+        modelFileId?: string;
+        modelName?: string;
+        schemaName?: string;
+        waitForReady?: boolean;
+        readyTimeout?: number;
+    }): Promise<Model | undefined>;
+    /**
+     * Get all Model instances for a schema by schemaFileId or schemaName
+     * Queries database for all models with the given schemaId/schemaName and returns Model instances
+     *
+     * @param schemaIdentifier - The schema file ID or schema name to get models for
+     * @returns Array of Model instances for the schema
+     */
+    static createBySchemaId(schemaIdentifier: string): Promise<Model[]>;
+    /**
+     * Get all Model instances currently in cache
+     *
+     * @returns Array of all cached Model instances
+     */
+    static getAll(): Model[];
+    /**
+     * Get all Model instances for a specific schema from cache
+     * For database-backed lookup, use createBySchemaId() instead
+     *
+     * @param schemaName - The schema name to filter by
+     * @returns Array of Model instances for the schema
+     */
+    static getAllBySchema(schemaName: string): Model[];
+    /**
+     * Update name index when model name changes
+     */
+    static updateNameIndex(oldName: string, newName: string, schemaName: string, modelFileId: string): void;
+    getService(): ModelService;
+    private _getSnapshot;
+    private _getSnapshotContext;
+    /**
+     * Check for conflicts between actor context and database
+     * @returns ConflictResult indicating if a conflict exists
+     */
+    private _checkForConflicts;
+    /**
+     * Saves model name changes to the database immediately (draft save)
+     * This is called when modelName is changed to persist the change immediately
+     * @param oldName - The old model name (if name changed)
+     * @param newName - The new model name
+     */
+    private _saveDraftToDb;
+    get status(): "error" | "idle" | "validating" | "loading" | "creatingProperties";
+    get validationErrors(): import("../Schema").ValidationError[];
+    get isValid(): boolean;
+    get isEdited(): boolean;
+    get id(): string | undefined;
+    get name(): string;
+    /**
+     * Returns ModelProperty instances for this model
+     * This is a computed property that reads from the service context
+     * Note: This is NOT reactive - use useModelProperties() hook for reactivity
+     */
+    get properties(): any[];
+    /**
+     * Validate the model
+     * @returns Validation result
+     */
+    validate(): Promise<{
+        isValid: boolean;
+        errors: any[];
+    }>;
+    /**
+     * Create a new item instance from this model
+     * Automatically injects the model name, so you don't need to pass it explicitly.
+     *
+     * @example
+     * const Post = Model.create('Post', schema)
+     * const post = await Post.create({ title: 'My Post', content: '...' })
+     *
+     * @param values - Item property values (modelName is automatically injected)
+     * @returns The created item instance
+     */
+    create(values: Partial<ItemData> & Record<string, any>): Promise<Item<any>>;
+    /**
+     * Reload model from database
+     * This refreshes the actor context with the latest data from the database
+     */
+    reload(): Promise<void>;
+    /**
+     * Unload the model instance and clean up resources
+     */
+    unload(): void;
+    /**
+     * Destroy the model instance completely
+     * - Removes instance from all caches (regardless of refCount)
+     * - Deletes model records from database (models, properties, model_schemas tables)
+     * - Removes model from Schema's models property and instance caches
+     * - Cleans up registered ModelProperty instances
+     * - Stops the model service
+     */
+    destroy(): Promise<void>;
+    /**
+     * Set up liveQuery subscription to watch for property changes in the database
+     * This enables cross-instance synchronization (e.g., changes in other tabs/windows)
+     */
+    private _setupLiveQuerySubscription;
+    /**
+     * Refresh property IDs from database (useful in Node.js where liveQuery isn't available)
+     */
+    private _refreshPropertiesFromDb;
+    /**
+     * Public method to refresh properties from database
+     */
+    refreshProperties(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=Model.d.ts.map

package/dist/Model/Model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/Model/Model.ts"],"names":[],"mappings":"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"}

package/dist/Model/index.d.ts

@@ -0,0 +1,26 @@
+export { Model } from './Model';
+export type { ModelMachineContext } from './service/modelMachine';
+export declare const TModelValues: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>;
+export declare const TModelSchema: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    _dbId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    dataType: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Text>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Number>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.List>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Relation>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Image>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Json>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.File>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Boolean>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Date>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Html>]>;
+    ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    modelId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    modelName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    refModelId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    refModelName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    refValueType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Text>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Number>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.List>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Relation>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Image>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Json>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.File>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Boolean>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Date>, import("@sinclair/typebox").TLiteral<import("..").ModelPropertyDataTypes.Html>]>>;
+    storageType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"ItemStorage">, import("@sinclair/typebox").TLiteral<"PropertyStorage">]>>;
+    localStorageDir: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    filenameSuffix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    validation: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        pattern: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        minLength: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        maxLength: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        enum: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
+        custom: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>;
+}>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/Model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Model/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAMjE,eAAO,MAAM,YAAY,4GAAyC,CAAA;AAClE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;GAAwC,CAAA"}

package/dist/Model/service/actors/createModelProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createModelProperties.d.ts","sourceRoot":"","sources":["../../../../src/Model/service/actors/createModelProperties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAKrD,eAAO,MAAM,qBAAqB;yBAEgC;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE;eA4GvF,CAAA"}

package/dist/Model/service/actors/loadOrCreateModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadOrCreateModel.d.ts","sourceRoot":"","sources":["../../../../src/Model/service/actors/loadOrCreateModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAgDrD,eAAO,MAAM,iBAAiB,uGA6Z5B,CAAA"}

package/dist/Model/service/actors/validateModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateModel.d.ts","sourceRoot":"","sources":["../../../../src/Model/service/actors/validateModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAarD,eAAO,MAAM,aAAa,uGAgIxB,CAAA"}