@contember/bindx 0.1.0

package/dist/selection/types.d.ts

@@ -0,0 +1,238 @@
+import type { AnyBrand } from '../brand/ComponentBrand.js';
+import type { EntityWhere, EntityOrderBy } from './queryTypes.js';
+/**
+ * Symbol used to store selection metadata on builder objects
+ */
+export declare const SELECTION_META: unique symbol;
+/**
+ * Options for has-many relation selection with typed filter/orderBy
+ *
+ * @typeParam TItem - The related entity type (array item type)
+ * @typeParam TAlias - Optional alias for the field
+ */
+export interface HasManyOptions<TItem = unknown, TAlias extends string = string> {
+    as?: TAlias;
+    filter?: EntityWhere<TItem>;
+    orderBy?: readonly EntityOrderBy<TItem>[];
+    limit?: number;
+    offset?: number;
+    totalCount?: boolean;
+}
+/**
+ * Metadata for a selected field (runtime)
+ */
+export interface SelectionFieldMeta {
+    /** Original field name in the entity */
+    fieldName: string;
+    /** Alias (output key) - defaults to fieldName */
+    alias: string;
+    /** Full path to this field (for JSX components) */
+    path: string[];
+    /** Whether this is a relation (has nested fields) */
+    isRelation: boolean;
+    /** Whether this is an array/has-many relation */
+    isArray: boolean;
+    /** For relations: nested selection metadata */
+    nested?: SelectionMeta;
+    /** For has-many: additional parameters */
+    hasManyParams?: {
+        filter?: unknown;
+        orderBy?: unknown;
+        limit?: number;
+        offset?: number;
+        totalCount?: boolean;
+    };
+}
+/**
+ * Runtime metadata for a complete selection
+ */
+export interface SelectionMeta {
+    fields: Map<string, SelectionFieldMeta>;
+}
+/**
+ * A fragment defined with the fluent builder
+ *
+ * @typeParam TModel - The entity model type
+ * @typeParam TResult - The selected fields result type
+ * @typeParam TBrand - Component brand type for validation (defaults to AnyBrand)
+ */
+export interface FluentFragment<TModel, TResult, TBrand extends AnyBrand = AnyBrand> {
+    /** Runtime metadata */
+    readonly __meta: SelectionMeta;
+    /** Type brand for result type */
+    readonly __resultType: TResult;
+    /** Type brand for model type */
+    readonly __modelType: TModel;
+    /** Marker for type checking */
+    readonly __isFragment: true;
+    /** Component brand for type-level tracking */
+    readonly __brand?: TBrand;
+    /** Runtime brand symbols for validation */
+    readonly __brands?: Set<symbol>;
+    /** Runtime roles for validation */
+    readonly __roles?: readonly string[];
+}
+/**
+ * Scalar method on selection builder - selects a scalar field
+ */
+export interface ScalarMethod<TEntity, K extends keyof TEntity, TSelected extends object, THasManyParams extends object> {
+    /** Select field with original name */
+    (): SelectionBuilder<TEntity, TSelected & Pick<TEntity, K>, THasManyParams>;
+    /** Select field with alias */
+    <TAlias extends string>(options: {
+        as: TAlias;
+    }): SelectionBuilder<TEntity, TSelected & {
+        [P in TAlias]: TEntity[K];
+    }, THasManyParams>;
+}
+/**
+ * Has-one method on selection builder - selects a relation to single entity
+ */
+export interface HasOneMethod<TEntity, K extends keyof TEntity, TRelated, TSelected extends object, THasManyParams extends object> {
+    /** Select with inline callback */
+    <TNestedSelected extends object>(selector: (builder: SelectionBuilder<TRelated>) => SelectionBuilder<TRelated, TNestedSelected, object>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: TNestedSelected;
+    }, THasManyParams>;
+    /** Select with fragment */
+    <TFragmentResult extends object>(fragment: FluentFragment<TRelated, TFragmentResult>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: TFragmentResult;
+    }, THasManyParams>;
+    /** Select with multiple fragments (merged) - result type is intersection of all fragment result types */
+    <T1 extends object, T2 extends object>(fragment1: FluentFragment<TRelated, T1>, fragment2: FluentFragment<TRelated, T2>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: T1 & T2;
+    }, THasManyParams>;
+    /** Select with three fragments (merged) */
+    <T1 extends object, T2 extends object, T3 extends object>(fragment1: FluentFragment<TRelated, T1>, fragment2: FluentFragment<TRelated, T2>, fragment3: FluentFragment<TRelated, T3>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: T1 & T2 & T3;
+    }, THasManyParams>;
+    /** Select with alias and callback */
+    <TAlias extends string, TNestedSelected extends object>(options: {
+        as: TAlias;
+    }, selector: (builder: SelectionBuilder<TRelated>) => SelectionBuilder<TRelated, TNestedSelected, object>): SelectionBuilder<TEntity, TSelected & {
+        [P in TAlias]: TNestedSelected;
+    }, THasManyParams>;
+    /** Select with alias and fragment */
+    <TAlias extends string, TFragmentResult extends object>(options: {
+        as: TAlias;
+    }, fragment: FluentFragment<TRelated, TFragmentResult>): SelectionBuilder<TEntity, TSelected & {
+        [P in TAlias]: TFragmentResult;
+    }, THasManyParams>;
+    /** Select with alias and two fragments (merged) */
+    <TAlias extends string, T1 extends object, T2 extends object>(options: {
+        as: TAlias;
+    }, fragment1: FluentFragment<TRelated, T1>, fragment2: FluentFragment<TRelated, T2>): SelectionBuilder<TEntity, TSelected & {
+        [P in TAlias]: T1 & T2;
+    }, THasManyParams>;
+    /** Select with alias and three fragments (merged) */
+    <TAlias extends string, T1 extends object, T2 extends object, T3 extends object>(options: {
+        as: TAlias;
+    }, fragment1: FluentFragment<TRelated, T1>, fragment2: FluentFragment<TRelated, T2>, fragment3: FluentFragment<TRelated, T3>): SelectionBuilder<TEntity, TSelected & {
+        [P in TAlias]: T1 & T2 & T3;
+    }, THasManyParams>;
+}
+/**
+ * Resolve alias from options or fall back to field name
+ */
+type ResolveAlias<K, TOptions> = TOptions extends {
+    as: infer A extends string;
+} ? A : K & string;
+/**
+ * Has-many method on selection builder - selects a relation to multiple entities
+ */
+export interface HasManyMethod<TEntity, K extends keyof TEntity, TItem, TSelected extends object, THasManyParams extends object> {
+    /** Select with inline callback (no options) */
+    <TNestedSelected extends object>(selector: (builder: SelectionBuilder<TItem>) => SelectionBuilder<TItem, TNestedSelected, object>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: TNestedSelected[];
+    }, THasManyParams & {
+        [P in K & string]: object;
+    }>;
+    /** Select with fragment (no options) */
+    <TFragmentResult extends object>(fragment: FluentFragment<TItem, TFragmentResult>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: TFragmentResult[];
+    }, THasManyParams & {
+        [P in K & string]: object;
+    }>;
+    /** Select with two fragments (merged, no options) */
+    <T1 extends object, T2 extends object>(fragment1: FluentFragment<TItem, T1>, fragment2: FluentFragment<TItem, T2>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: (T1 & T2)[];
+    }, THasManyParams & {
+        [P in K & string]: object;
+    }>;
+    /** Select with three fragments (merged, no options) */
+    <T1 extends object, T2 extends object, T3 extends object>(fragment1: FluentFragment<TItem, T1>, fragment2: FluentFragment<TItem, T2>, fragment3: FluentFragment<TItem, T3>): SelectionBuilder<TEntity, TSelected & {
+        [P in K & string]: (T1 & T2 & T3)[];
+    }, THasManyParams & {
+        [P in K & string]: object;
+    }>;
+    /** Select with options and callback */
+    <TOptions extends HasManyOptions<TItem>, TNestedSelected extends object>(options: TOptions, selector: (builder: SelectionBuilder<TItem>) => SelectionBuilder<TItem, TNestedSelected, object>): SelectionBuilder<TEntity, TSelected & {
+        [P in ResolveAlias<K, TOptions>]: TNestedSelected[];
+    }, THasManyParams & {
+        [P in ResolveAlias<K, TOptions>]: TOptions;
+    }>;
+    /** Select with options and fragment */
+    <TOptions extends HasManyOptions<TItem>, TFragmentResult extends object>(options: TOptions, fragment: FluentFragment<TItem, TFragmentResult>): SelectionBuilder<TEntity, TSelected & {
+        [P in ResolveAlias<K, TOptions>]: TFragmentResult[];
+    }, THasManyParams & {
+        [P in ResolveAlias<K, TOptions>]: TOptions;
+    }>;
+    /** Select with options and two fragments (merged) */
+    <TOptions extends HasManyOptions<TItem>, T1 extends object, T2 extends object>(options: TOptions, fragment1: FluentFragment<TItem, T1>, fragment2: FluentFragment<TItem, T2>): SelectionBuilder<TEntity, TSelected & {
+        [P in ResolveAlias<K, TOptions>]: (T1 & T2)[];
+    }, THasManyParams & {
+        [P in ResolveAlias<K, TOptions>]: TOptions;
+    }>;
+    /** Select with options and three fragments (merged) */
+    <TOptions extends HasManyOptions<TItem>, T1 extends object, T2 extends object, T3 extends object>(options: TOptions, fragment1: FluentFragment<TItem, T1>, fragment2: FluentFragment<TItem, T2>, fragment3: FluentFragment<TItem, T3>): SelectionBuilder<TEntity, TSelected & {
+        [P in ResolveAlias<K, TOptions>]: (T1 & T2 & T3)[];
+    }, THasManyParams & {
+        [P in ResolveAlias<K, TOptions>]: TOptions;
+    }>;
+}
+/**
+ * Maps entity fields to their corresponding builder methods
+ */
+type SelectionBuilderMethods<TEntity, TSelected extends object, THasManyParams extends object> = {
+    [K in keyof TEntity]-?: TEntity[K] extends Array<infer U> ? HasManyMethod<TEntity, K, U, TSelected, THasManyParams> : NonNullable<TEntity[K]> extends object ? HasOneMethod<TEntity, K, NonNullable<TEntity[K]>, TSelected, THasManyParams> : ScalarMethod<TEntity, K, TSelected, THasManyParams>;
+};
+/**
+ * The main fluent selection builder interface.
+ *
+ * @typeParam TEntity - The entity type being selected from
+ * @typeParam TSelected - Accumulated type of selected fields (grows with each selection)
+ * @typeParam THasManyParams - Record tracking has-many parameters for alias consistency
+ *
+ * @example
+ * ```ts
+ * // Select scalar fields
+ * e.id().title().content()
+ * // Type: { id: string, title: string, content: string }
+ *
+ * // Select with alias
+ * e.title({ as: 'headline' })
+ * // Type: { headline: string }
+ *
+ * // Select has-one relation
+ * e.author(a => a.name().email())
+ * // Type: { author: { name: string, email: string } }
+ *
+ * // Select has-many with options
+ * e.tags({ filter: { active: true } }, t => t.name())
+ * // Type: { tags: { name: string }[] }
+ * ```
+ */
+export type SelectionBuilder<TEntity, TSelected extends object = object, THasManyParams extends object = object> = SelectionBuilderMethods<TEntity, TSelected, THasManyParams> & {
+    [SELECTION_META]: SelectionMeta;
+    /** Type brand for the selected result */
+    readonly __selected: TSelected;
+};
+/**
+ * Extracts the selected type from a SelectionBuilder
+ */
+export type InferSelection<T> = T extends SelectionBuilder<infer _E, infer S, infer _P> ? S : never;
+/**
+ * Type for the fluent definer function used in useEntity/useEntityList
+ */
+export type FluentDefiner<TModel, TResult extends object> = (builder: SelectionBuilder<TModel>) => SelectionBuilder<TModel, TResult, object>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/selection/types.d.ts.map

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

package/dist/store/DirtyTracker.d.ts

@@ -0,0 +1,26 @@
+import type { EntitySnapshotStore } from './EntitySnapshotStore.js';
+import type { EntityMetaStore } from './EntityMetaStore.js';
+import type { RelationStore } from './RelationStore.js';
+interface DirtyEntity {
+    entityType: string;
+    entityId: string;
+    changeType: 'create' | 'update' | 'delete';
+}
+/**
+ * Tracks dirty state across entities by comparing current data to server data.
+ *
+ * Receives shared references to SnapshotStore internals so it can read
+ * entity snapshots, metadata, and relation state without duplicating storage.
+ */
+export declare class DirtyTracker {
+    private readonly entitySnapshots;
+    private readonly meta;
+    private readonly relations;
+    constructor(entitySnapshots: EntitySnapshotStore, meta: EntityMetaStore, relations: RelationStore);
+    getAllDirtyEntities(): DirtyEntity[];
+    getDirtyFields(entityType: string, entityId: string): string[];
+    getDirtyRelations(entityType: string, entityId: string): string[];
+    private isEntityDirty;
+}
+export {};
+//# sourceMappingURL=DirtyTracker.d.ts.map

package/dist/store/DirtyTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirtyTracker.d.ts","sourceRoot":"","sources":["../../src/store/DirtyTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGvD,UAAU,WAAW;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;CAC1C;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,eAAe,EAAE,mBAAmB,EACpC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,aAAa;IAG1C,mBAAmB,IAAI,WAAW,EAAE;IA+BpC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IA6B9D,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAKjE,OAAO,CAAC,aAAa;CAUrB"}

package/dist/store/EntityMetaStore.d.ts

@@ -0,0 +1,52 @@
+import type { LoadStatus } from './snapshots.js';
+import type { FieldError } from '../errors/types.js';
+/**
+ * Entity load state tracking.
+ */
+export interface EntityLoadState {
+    status: LoadStatus;
+    error?: FieldError;
+}
+/**
+ * Entity metadata for mutation generation.
+ */
+export interface EntityMeta {
+    /** Whether the entity exists on the server */
+    existsOnServer: boolean;
+    /** Whether the entity is scheduled for deletion */
+    isScheduledForDeletion: boolean;
+}
+/**
+ * Manages entity metadata, load states, persisting status, and temp ID mapping.
+ *
+ * Keys are pre-computed composite strings (e.g., "entityType:id").
+ * Follows the same pattern as ErrorStore and RelationStore.
+ */
+export declare class EntityMetaStore {
+    /** Load states keyed by "entityType:id" */
+    private readonly loadStates;
+    /** Entity metadata keyed by "entityType:id" */
+    private readonly entityMetas;
+    /** Persisting status keyed by "entityType:id" */
+    private readonly persistingEntities;
+    /** Mapping from temp ID to persisted ID (keyed by "entityType:tempId") */
+    private readonly tempToPersistedId;
+    getLoadState(key: string): EntityLoadState | undefined;
+    setLoadState(key: string, status: LoadStatus, error?: FieldError): void;
+    clearLoadState(key: string): void;
+    getEntityMeta(key: string): EntityMeta | undefined;
+    setExistsOnServer(key: string, existsOnServer: boolean): void;
+    existsOnServer(key: string): boolean;
+    scheduleForDeletion(key: string): void;
+    unscheduleForDeletion(key: string): void;
+    isScheduledForDeletion(key: string): boolean;
+    isPersisting(key: string): boolean;
+    setPersisting(key: string, isPersisting: boolean): void;
+    mapTempIdToPersistedId(key: string, persistedId: string): void;
+    getPersistedId(key: string, id: string): string | null;
+    isNewEntity(key: string, id: string): boolean;
+    exportMetas(keys: string[]): Map<string, EntityMeta>;
+    importMetas(metas: Map<string, EntityMeta>): void;
+    clear(): void;
+}
+//# sourceMappingURL=EntityMetaStore.d.ts.map

package/dist/store/EntityMetaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMetaStore.d.ts","sourceRoot":"","sources":["../../src/store/EntityMetaStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,UAAU,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAA;IACvB,mDAAmD;IACnD,sBAAsB,EAAE,OAAO,CAAA;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC3B,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAEhE,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAE5D,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IAEvD,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAI9D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAItD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI;IAIvE,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMjC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI;IAK7D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtC,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxC,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAM5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIlC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI;IAUvD,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAK9D,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMtD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ7C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAWpD,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;IAMjD,KAAK,IAAI,IAAI;CAMb"}

package/dist/store/EntitySnapshotStore.d.ts

@@ -0,0 +1,63 @@
+import { type EntitySnapshot } from './snapshots.js';
+/**
+ * Manages entity snapshots — core CRUD for immutable entity data.
+ *
+ * Entity snapshots are keyed by composite strings (e.g., "entityType:id").
+ * All snapshots are immutable (frozen) objects. Mutations create new snapshot instances.
+ *
+ * Follows the same sub-store pattern as ErrorStore, RelationStore, etc.
+ * SnapshotStore delegates entity snapshot operations here.
+ */
+export declare class EntitySnapshotStore {
+    private readonly snapshots;
+    get(key: string): EntitySnapshot | undefined;
+    has(key: string): boolean;
+    /**
+     * Sets entity data, merging with existing data if present.
+     * Returns the new snapshot. Does NOT handle notification or meta updates.
+     */
+    setData<T extends object>(key: string, id: string, entityType: string, data: T, isServerData: boolean): EntitySnapshot<T>;
+    /**
+     * Updates specific fields on an existing entity snapshot.
+     * Returns the new snapshot, or undefined if entity doesn't exist.
+     */
+    updateFields<T extends object>(key: string, updates: Partial<T>): EntitySnapshot<T> | undefined;
+    /**
+     * Sets a nested field value on an existing entity snapshot.
+     * Returns true if the snapshot was updated, false if entity doesn't exist.
+     */
+    setFieldValue(key: string, fieldPath: string[], value: unknown): boolean;
+    /**
+     * Commits current data as server data (serverData = data).
+     */
+    commit(key: string): void;
+    /**
+     * Resets data to server data (data = serverData).
+     */
+    reset(key: string): void;
+    /**
+     * Removes an entity snapshot.
+     */
+    remove(key: string): void;
+    /**
+     * Bumps the version of an entity snapshot without changing data.
+     * Used by SubscriptionManager when child entities change.
+     */
+    bumpVersion(key: string): void;
+    /**
+     * Commits specific fields by copying their current values to server data.
+     */
+    commitFields(key: string, fieldNames: string[]): void;
+    /**
+     * Exports snapshots for the given keys.
+     */
+    exportSnapshots(keys: string[]): Map<string, EntitySnapshot>;
+    /**
+     * Imports snapshots, overwriting any existing entries.
+     * Returns the set of keys that were imported.
+     */
+    importSnapshots(snapshots: Map<string, EntitySnapshot>): Set<string>;
+    keys(): IterableIterator<string>;
+    clear(): void;
+}
+//# sourceMappingURL=EntitySnapshotStore.d.ts.map

package/dist/store/EntitySnapshotStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntitySnapshotStore.d.ts","sourceRoot":"","sources":["../../src/store/EntitySnapshotStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAE9D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;OAGG;IACH,OAAO,CAAC,CAAC,SAAS,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,EACP,YAAY,EAAE,OAAO,GACnB,cAAc,CAAC,CAAC,CAAC;IAuBpB;;;OAGG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,EAC5B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS;IAiBhC;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAiBxE;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAezB;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAexB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAe9B;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAyBrD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAW5D;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IASpE,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIhC,KAAK,IAAI,IAAI;CAGb"}

package/dist/store/ErrorStore.d.ts

@@ -0,0 +1,82 @@
+import type { FieldError } from '../errors/types.js';
+/**
+ * Manages error state for fields, entities, and relations.
+ *
+ * Errors are keyed by composite strings:
+ * - Field errors: "entityType:id:fieldName"
+ * - Entity errors: "entityType:id"
+ * - Relation errors: "entityType:id:relationName"
+ */
+export declare class ErrorStore {
+    /** Field errors keyed by "entityType:id:fieldName" */
+    private readonly fieldErrors;
+    /** Entity-level errors keyed by "entityType:id" */
+    private readonly entityErrors;
+    /** Relation errors keyed by "entityType:id:relationName" */
+    private readonly relationErrors;
+    /**
+     * Gets field errors for a specific field.
+     */
+    getFieldErrors(fieldKey: string): readonly FieldError[];
+    /**
+     * Adds an error to a field.
+     */
+    addFieldError(fieldKey: string, error: FieldError): void;
+    /**
+     * Clears field errors, optionally filtering by source.
+     */
+    clearFieldErrors(fieldKey: string, source?: 'client' | 'server'): void;
+    /**
+     * Clears non-sticky client errors for a field.
+     * Called when field value changes.
+     * Returns true if any errors were removed.
+     */
+    clearNonStickyFieldErrors(fieldKey: string): boolean;
+    /**
+     * Gets entity-level errors.
+     */
+    getEntityErrors(entityKey: string): readonly FieldError[];
+    /**
+     * Adds an entity-level error.
+     */
+    addEntityError(entityKey: string, error: FieldError): void;
+    /**
+     * Clears entity-level errors, optionally filtering by source.
+     */
+    clearEntityErrors(entityKey: string, source?: 'client' | 'server'): void;
+    /**
+     * Gets relation errors.
+     */
+    getRelationErrors(relationKey: string): readonly FieldError[];
+    /**
+     * Adds a relation error.
+     */
+    addRelationError(relationKey: string, error: FieldError): void;
+    /**
+     * Clears relation errors, optionally filtering by source.
+     */
+    clearRelationErrors(relationKey: string, source?: 'client' | 'server'): void;
+    /**
+     * Clears all server errors for an entity (entity-level, fields, and relations).
+     * Called before persist to clear stale server errors.
+     */
+    clearAllServerErrors(entityKey: string, keyPrefix: string): void;
+    /**
+     * Clears all errors for an entity (entity-level, fields, and relations).
+     */
+    clearAllErrors(entityKey: string, keyPrefix: string): void;
+    /**
+     * Checks if an entity has any client errors (entity-level, fields, or relations).
+     * Used to block persist when validation errors exist.
+     */
+    hasClientErrors(entityKey: string, keyPrefix: string): boolean;
+    /**
+     * Checks if an entity has any errors at all.
+     */
+    hasAnyErrors(entityKey: string, keyPrefix: string): boolean;
+    /**
+     * Clears all error data.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=ErrorStore.d.ts.map

package/dist/store/ErrorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorStore.d.ts","sourceRoot":"","sources":["../../src/store/ErrorStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGhE;;;;;;;GAOG;AACH,qBAAa,UAAU;IACtB,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAE5D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAE7D,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAI/D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAIvD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAMxD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAgBtE;;;;OAIG;IACH,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAiBpD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAIzD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAM1D;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAkBxE;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAI7D;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAM9D;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAkB5E;;;OAGG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBhE;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB1D;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAqB9D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAqB3D;;OAEG;IACH,KAAK,IAAI,IAAI;CAKb"}