@contember/bindx 0.1.0

package/dist/store/RelationStore.d.ts

@@ -0,0 +1,175 @@
+import type { HasOneRelationState } from '../handles/types.js';
+import type { EntitySnapshot } from './snapshots.js';
+/**
+ * Removal type for has-many items
+ */
+export type HasManyRemovalType = 'disconnect' | 'delete';
+/**
+ * Has-many list state stored in SnapshotStore
+ */
+export interface StoredHasManyState {
+    /** IDs of items from server */
+    serverIds: Set<string>;
+    /** Explicit ordered list of item IDs, null means use default order (serverIds + plannedConnections) */
+    orderedIds: string[] | null;
+    /** Planned removals (disconnect or delete) keyed by entity ID */
+    plannedRemovals: Map<string, HasManyRemovalType>;
+    /** Planned connections (IDs to add to the list) */
+    plannedConnections: Set<string>;
+    /** Entity IDs created via add() - tracked for proper remove() semantics and mutation generation */
+    createdEntities: Set<string>;
+    version: number;
+}
+/**
+ * Relation state stored in SnapshotStore
+ */
+export interface StoredRelationState {
+    currentId: string | null;
+    serverId: string | null;
+    state: HasOneRelationState;
+    serverState: HasOneRelationState;
+    placeholderData: Record<string, unknown>;
+    version: number;
+}
+/**
+ * Manages has-one and has-many relation state.
+ *
+ * Relation keys use the format "parentType:parentId:fieldName".
+ * Notification is handled by callers via callback returns.
+ */
+export declare class RelationStore {
+    /** Relation states keyed by "parentType:parentId:fieldName" */
+    private readonly relationStates;
+    /** Has-many list states keyed by "parentType:parentId:fieldName" */
+    private readonly hasManyStates;
+    /**
+     * Gets or creates relation state.
+     */
+    getOrCreateRelation(key: string, initial: Omit<StoredRelationState, 'version'>): StoredRelationState;
+    /**
+     * Gets relation state.
+     */
+    getRelation(key: string): StoredRelationState | undefined;
+    /**
+     * Updates relation state.
+     * If the relation state doesn't exist, creates it using entity snapshot for server data.
+     */
+    setRelation(key: string, updates: Partial<Omit<StoredRelationState, 'version'>>, entitySnapshot: EntitySnapshot | undefined, fieldName: string): void;
+    /**
+     * Commits relation state (server = current).
+     */
+    commitRelation(key: string): void;
+    /**
+     * Resets relation to server state.
+     */
+    resetRelation(key: string): void;
+    /**
+     * Gets or creates has-many list state.
+     */
+    getOrCreateHasMany(key: string, serverIds?: string[]): StoredHasManyState;
+    /**
+     * Gets has-many list state.
+     */
+    getHasMany(key: string): StoredHasManyState | undefined;
+    /**
+     * Sets server IDs for a has-many relation.
+     */
+    setHasManyServerIds(key: string, serverIds: string[]): void;
+    /**
+     * Plans a removal for a has-many item.
+     */
+    planHasManyRemoval(key: string, itemId: string, type: HasManyRemovalType): void;
+    /**
+     * Cancels a planned removal for a has-many item.
+     */
+    cancelHasManyRemoval(key: string, itemId: string): void;
+    /**
+     * Plans a connection for a has-many item.
+     */
+    planHasManyConnection(key: string, itemId: string): void;
+    /**
+     * Cancels a planned connection for a has-many item.
+     */
+    cancelHasManyConnection(key: string, itemId: string): void;
+    /**
+     * Commits has-many state after successful persist.
+     */
+    commitHasMany(key: string, newServerIds: string[]): void;
+    /**
+     * Resets has-many state to server state (clears planned operations).
+     */
+    resetHasMany(key: string): void;
+    /**
+     * Adds a newly created entity to a has-many relation.
+     * Used by HasManyListHandle.add() for inline entity creation.
+     */
+    addToHasMany(key: string, itemId: string): void;
+    /**
+     * Removes an entity from a has-many relation.
+     * For newly created entities (via add()), cancels the connection.
+     * For existing server entities, plans a disconnect.
+     * Returns the key if a removal was planned (caller should notify), or null if handled inline.
+     */
+    removeFromHasMany(key: string, itemId: string): 'planned_removal' | 'cancelled_connection' | null;
+    /**
+     * Moves an item within a has-many relation from one index to another.
+     */
+    moveInHasMany(key: string, fromIndex: number, toIndex: number): void;
+    /**
+     * Gets the ordered list of item IDs for a has-many relation.
+     */
+    getHasManyOrderedIds(key: string): string[];
+    /**
+     * Restores a has-many state from a captured snapshot.
+     * Used in pessimistic mode after successful server confirmation.
+     */
+    restoreHasManyState(key: string, state: StoredHasManyState): void;
+    /**
+     * Commits all relations (hasOne and hasMany) for an entity.
+     */
+    commitAllRelations(keyPrefix: string): void;
+    /**
+     * Resets all relations (hasOne and hasMany) for an entity to server state.
+     */
+    resetAllRelations(keyPrefix: string): void;
+    /**
+     * Gets all relation states for an entity.
+     */
+    getAllRelationsForEntity(keyPrefix: string): Map<string, StoredRelationState>;
+    /**
+     * Gets all has-many states for an entity.
+     */
+    getAllHasManyForEntity(keyPrefix: string): Map<string, StoredHasManyState>;
+    /**
+     * Gets the list of dirty relations for an entity.
+     */
+    getDirtyRelations(keyPrefix: string): string[];
+    /**
+     * Exports relation states for given keys.
+     */
+    exportRelationStates(keys: string[]): Map<string, StoredRelationState>;
+    /**
+     * Exports has-many states for given keys.
+     */
+    exportHasManyStates(keys: string[]): Map<string, StoredHasManyState>;
+    /**
+     * Imports relation states from a snapshot.
+     * Returns the keys that were imported for notification.
+     */
+    importRelationStates(states: Map<string, StoredRelationState>): string[];
+    /**
+     * Imports has-many states from a snapshot.
+     * Returns the keys that were imported for notification.
+     */
+    importHasManyStates(states: Map<string, StoredHasManyState>): string[];
+    /**
+     * Clears all relation data.
+     */
+    clear(): void;
+}
+/**
+ * Computes the default ordered IDs for a has-many relation.
+ * Order is: serverIds (minus removals) + plannedConnections
+ */
+export declare function computeDefaultOrderedIds(state: StoredHasManyState): string[];
+//# sourceMappingURL=RelationStore.d.ts.map

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

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

package/dist/store/SnapshotStore.d.ts

@@ -0,0 +1,143 @@
+import type { EntitySnapshot, LoadStatus } from './snapshots.js';
+import type { FieldError } from '../errors/types.js';
+import { type SnapshotVersionBumper } from './SubscriptionManager.js';
+import { type HasManyRemovalType, type StoredHasManyState, type StoredRelationState } from './RelationStore.js';
+import { type EntityMeta } from './EntityMetaStore.js';
+export type { HasManyRemovalType, StoredHasManyState, StoredRelationState } from './RelationStore.js';
+export type { EntityMeta } from './EntityMetaStore.js';
+export { isTempId, isPlaceholderId, isPersistedId, generatePlaceholderId } from './entityId.js';
+type Subscriber = () => void;
+/**
+ * SnapshotStore manages immutable snapshots for React integration.
+ *
+ * Key design principles:
+ * - All data is stored as immutable, frozen objects
+ * - Changes create new snapshot instances (new references)
+ * - Provides subscribe/getSnapshot interface for useSyncExternalStore
+ * - Entity-level subscriptions for fine-grained reactivity
+ *
+ * Composed of:
+ * - EntitySnapshotStore — entity snapshot CRUD
+ * - SubscriptionManager — subscription tracking and notification
+ * - ErrorStore — field/entity/relation error tracking
+ * - RelationStore — has-one / has-many relation state management
+ * - EntityMetaStore — entity metadata, load state, persisting, temp ID mapping
+ * - TouchedStore — field touched state tracking
+ */
+export declare class SnapshotStore implements SnapshotVersionBumper {
+    private readonly entitySnapshots;
+    private readonly subscriptions;
+    private readonly errors;
+    private readonly relations;
+    private readonly meta;
+    private readonly touched;
+    private readonly dirtyTracker;
+    constructor();
+    private getEntityKey;
+    private getRelationKey;
+    bumpEntitySnapshotVersion(key: string): void;
+    private notifyEntitySubscribers;
+    private notifyRelationSubscribers;
+    getEntitySnapshot<T extends object>(entityType: string, id: string): EntitySnapshot<T> | undefined;
+    hasEntity(entityType: string, id: string): boolean;
+    setEntityData<T extends object>(entityType: string, id: string, data: T, isServerData?: boolean, skipNotify?: boolean): EntitySnapshot<T>;
+    updateEntityFields<T extends object>(entityType: string, id: string, updates: Partial<T>): EntitySnapshot<T> | undefined;
+    setFieldValue(entityType: string, id: string, fieldPath: string[], value: unknown): void;
+    commitEntity(entityType: string, id: string): void;
+    resetEntity(entityType: string, id: string): void;
+    removeEntity(entityType: string, id: string): void;
+    getLoadState(entityType: string, id: string): {
+        status: LoadStatus;
+        error?: FieldError;
+    } | undefined;
+    setLoadState(entityType: string, id: string, status: LoadStatus, error?: FieldError): void;
+    getEntityMeta(entityType: string, id: string): EntityMeta | undefined;
+    setExistsOnServer(entityType: string, id: string, existsOnServer: boolean): void;
+    existsOnServer(entityType: string, id: string): boolean;
+    scheduleForDeletion(entityType: string, id: string): void;
+    unscheduleForDeletion(entityType: string, id: string): void;
+    isScheduledForDeletion(entityType: string, id: string): boolean;
+    createEntity(entityType: string, initialData?: Record<string, unknown>): string;
+    mapTempIdToPersistedId(entityType: string, tempId: string, persistedId: string): void;
+    getPersistedId(entityType: string, id: string): string | null;
+    isNewEntity(entityType: string, id: string): boolean;
+    getOrCreateHasMany(parentType: string, parentId: string, fieldName: string, serverIds?: string[], alias?: string): StoredHasManyState;
+    getHasMany(parentType: string, parentId: string, fieldName: string, alias?: string): StoredHasManyState | undefined;
+    setHasManyServerIds(parentType: string, parentId: string, fieldName: string, serverIds: string[], alias?: string): void;
+    planHasManyRemoval(parentType: string, parentId: string, fieldName: string, itemId: string, type: HasManyRemovalType, alias?: string): void;
+    cancelHasManyRemoval(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): void;
+    getHasManyPlannedRemovals(parentType: string, parentId: string, fieldName: string, alias?: string): Map<string, HasManyRemovalType> | undefined;
+    planHasManyConnection(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): void;
+    cancelHasManyConnection(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): void;
+    getHasManyPlannedConnections(parentType: string, parentId: string, fieldName: string, alias?: string): Set<string> | undefined;
+    commitHasMany(parentType: string, parentId: string, fieldName: string, newServerIds: string[], alias?: string): void;
+    resetHasMany(parentType: string, parentId: string, fieldName: string, alias?: string): void;
+    addToHasMany(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): void;
+    removeFromHasMany(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): void;
+    moveInHasMany(parentType: string, parentId: string, fieldName: string, fromIndex: number, toIndex: number, alias?: string): void;
+    getHasManyOrderedIds(parentType: string, parentId: string, fieldName: string, alias?: string): string[];
+    isHasManyItemCreated(parentType: string, parentId: string, fieldName: string, itemId: string, alias?: string): boolean;
+    getHasManyCreatedEntities(parentType: string, parentId: string, fieldName: string, alias?: string): Set<string> | undefined;
+    isPersisting(entityType: string, id: string): boolean;
+    setPersisting(entityType: string, id: string, isPersisting: boolean): void;
+    getFieldErrors(entityType: string, id: string, fieldName: string): readonly FieldError[];
+    addFieldError(entityType: string, id: string, fieldName: string, error: FieldError): void;
+    clearFieldErrors(entityType: string, id: string, fieldName: string, source?: 'client' | 'server'): void;
+    clearNonStickyFieldErrors(entityType: string, id: string, fieldName: string): void;
+    getEntityErrors(entityType: string, id: string): readonly FieldError[];
+    addEntityError(entityType: string, id: string, error: FieldError): void;
+    clearEntityErrors(entityType: string, id: string, source?: 'client' | 'server'): void;
+    getRelationErrors(entityType: string, id: string, relationName: string): readonly FieldError[];
+    addRelationError(entityType: string, id: string, relationName: string, error: FieldError): void;
+    clearRelationErrors(entityType: string, id: string, relationName: string, source?: 'client' | 'server'): void;
+    clearAllServerErrors(entityType: string, id: string): void;
+    clearAllErrors(entityType: string, id: string): void;
+    hasClientErrors(entityType: string, id: string): boolean;
+    hasAnyErrors(entityType: string, id: string): boolean;
+    isFieldTouched(entityType: string, id: string, fieldName: string): boolean;
+    setFieldTouched(entityType: string, id: string, fieldName: string, touched: boolean): void;
+    clearEntityTouchedState(entityType: string, id: string): void;
+    getOrCreateRelation(parentType: string, parentId: string, fieldName: string, initial: Omit<StoredRelationState, 'version'>): StoredRelationState;
+    getRelation(parentType: string, parentId: string, fieldName: string): StoredRelationState | undefined;
+    setRelation(parentType: string, parentId: string, fieldName: string, updates: Partial<Omit<StoredRelationState, 'version'>>): void;
+    commitRelation(parentType: string, parentId: string, fieldName: string): void;
+    resetRelation(parentType: string, parentId: string, fieldName: string): void;
+    commitAllRelations(entityType: string, entityId: string): void;
+    resetAllRelations(entityType: string, entityId: string): void;
+    getAllRelationsForEntity(entityType: string, entityId: string): Map<string, StoredRelationState>;
+    getAllHasManyForEntity(entityType: string, entityId: string): Map<string, StoredHasManyState>;
+    restoreHasManyState(parentType: string, parentId: string, fieldName: string, state: StoredHasManyState, alias?: string): void;
+    subscribeToEntity(entityType: string, id: string, callback: Subscriber): () => void;
+    subscribeToRelation(parentType: string, parentId: string, fieldName: string, callback: Subscriber): () => void;
+    subscribe(callback: Subscriber): () => void;
+    getVersion(): number;
+    notify(): void;
+    registerParentChild(parentType: string, parentId: string, childType: string, childId: string): void;
+    unregisterParentChild(parentType: string, parentId: string, childType: string, childId: string): void;
+    exportPartialSnapshot(keys: {
+        entityKeys: string[];
+        relationKeys: string[];
+        hasManyKeys: string[];
+    }): {
+        entitySnapshots: Map<string, EntitySnapshot>;
+        relationStates: Map<string, StoredRelationState>;
+        hasManyStates: Map<string, StoredHasManyState>;
+        entityMetas: Map<string, EntityMeta>;
+    };
+    importPartialSnapshot(snapshot: {
+        entitySnapshots: Map<string, EntitySnapshot>;
+        relationStates: Map<string, StoredRelationState>;
+        hasManyStates: Map<string, StoredHasManyState>;
+        entityMetas: Map<string, EntityMeta>;
+    }): void;
+    getAllDirtyEntities(): Array<{
+        entityType: string;
+        entityId: string;
+        changeType: 'create' | 'update' | 'delete';
+    }>;
+    getDirtyFields(entityType: string, entityId: string): string[];
+    getDirtyRelations(entityType: string, entityId: string): string[];
+    commitFields(entityType: string, entityId: string, fieldNames: string[]): void;
+    clear(): void;
+}
+//# sourceMappingURL=SnapshotStore.d.ts.map

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

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

package/dist/store/SubscriptionManager.d.ts

@@ -0,0 +1,90 @@
+type Subscriber = () => void;
+/**
+ * Callback interface for SubscriptionManager to request snapshot version bumps.
+ * This decouples notification logic from entity snapshot storage.
+ */
+export interface SnapshotVersionBumper {
+    bumpEntitySnapshotVersion(key: string): void;
+}
+/**
+ * Manages subscriptions for entity and relation changes.
+ *
+ * Provides:
+ * - Entity-level subscriptions
+ * - Relation-level subscriptions
+ * - Global subscriptions (any change)
+ * - Parent-child change propagation
+ * - Global version tracking for change detection
+ */
+export declare class SubscriptionManager {
+    /** Subscribers per entity key */
+    private readonly entitySubscribers;
+    /** Subscribers per relation key */
+    private readonly relationSubscribers;
+    /** Global subscribers (notified on any change) */
+    private readonly globalSubscribers;
+    /** Parent-child relationships: childKey -> Set of parentKeys */
+    private readonly childToParents;
+    /** Global version number for change detection */
+    private globalVersion;
+    /**
+     * Subscribe to changes on a specific entity.
+     * Returns unsubscribe function.
+     */
+    subscribeToEntity(key: string, callback: Subscriber): () => void;
+    /**
+     * Subscribe to changes on a specific relation.
+     * Returns unsubscribe function.
+     */
+    subscribeToRelation(key: string, callback: Subscriber): () => void;
+    /**
+     * Subscribe to all changes (global).
+     * Returns unsubscribe function.
+     */
+    subscribe(callback: Subscriber): () => void;
+    /**
+     * Gets the global version number for change detection.
+     */
+    getVersion(): number;
+    /**
+     * Triggers a global notification to all subscribers.
+     * Use when external state changes need to trigger re-renders.
+     */
+    notify(): void;
+    /**
+     * Registers a parent-child relationship for change propagation.
+     * When the child entity changes, parent entity subscribers will be notified.
+     */
+    registerParentChild(parentKey: string, childKey: string): void;
+    /**
+     * Unregisters a parent-child relationship.
+     */
+    unregisterParentChild(parentKey: string, childKey: string): void;
+    /**
+     * Notifies entity subscribers and propagates changes to parents.
+     * The bumper callback is used to bump parent entity snapshot versions.
+     */
+    notifyEntitySubscribers(key: string, bumper: SnapshotVersionBumper, notifiedKeys?: Set<string>): void;
+    /**
+     * Notifies relation subscribers and the parent entity's subscribers.
+     * The bumper callback is used to bump the parent entity snapshot version.
+     * The entityKey is the parent entity key derived from the relation key.
+     */
+    notifyRelationSubscribers(key: string, entityKey: string, bumper: SnapshotVersionBumper): void;
+    /**
+     * Notifies entity subscribers without propagation.
+     * Used during batch imports (e.g., undo/redo).
+     */
+    notifyEntityDirect(key: string): void;
+    /**
+     * Notifies relation subscribers without propagation.
+     * Used during batch imports (e.g., undo/redo).
+     */
+    notifyRelationDirect(key: string): void;
+    /**
+     * Bumps global version and notifies global subscribers.
+     */
+    notifyGlobal(): void;
+}
+export {};
+//# sourceMappingURL=SubscriptionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionManager.d.ts","sourceRoot":"","sources":["../../src/store/SubscriptionManager.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,MAAM,IAAI,CAAA;AAE5B;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5C;AAED;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC/B,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;IAEvE,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqC;IAEzE,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAE1D,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;IAEhE,iDAAiD;IACjD,OAAO,CAAC,aAAa,CAAI;IAEzB;;;OAGG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI;IAYhE;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI;IAYlE;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI;IAO3C;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACH,MAAM,IAAI,IAAI;IASd;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS9D;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYhE;;;OAGG;IACH,uBAAuB,CACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,qBAAqB,EAC7B,YAAY,GAAE,GAAG,CAAC,MAAM,CAAa,GACnC,IAAI;IAiCP;;;;OAIG;IACH,yBAAyB,CACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,GAC3B,IAAI;IA4BP;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASrC;;;OAGG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASvC;;OAEG;IACH,YAAY,IAAI,IAAI;CAMpB"}

package/dist/store/TouchedStore.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Manages touched state for entity fields.
+ *
+ * A field is "touched" when the user has interacted with it.
+ * Used for conditional error display (show errors only after user interaction).
+ *
+ * Keys are pre-computed composite strings (e.g., "entityType:id:fieldName").
+ */
+export declare class TouchedStore {
+    /** Touched state keyed by "entityType:id:fieldName" */
+    private readonly touchedFields;
+    isFieldTouched(key: string): boolean;
+    /**
+     * Sets the touched state for a field.
+     * Returns true if the state actually changed.
+     */
+    setFieldTouched(key: string, touched: boolean): boolean;
+    /**
+     * Clears all touched state for an entity.
+     */
+    clearForEntity(keyPrefix: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=TouchedStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TouchedStore.d.ts","sourceRoot":"","sources":["../../src/store/TouchedStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,YAAY;IACxB,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAOvD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAQvC,KAAK,IAAI,IAAI;CAGb"}

package/dist/store/entityId.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Entity ID type detection and generation utilities.
+ *
+ * IDs in Bindx can be:
+ * - Persisted: server-assigned UUIDs
+ * - Temporary: locally created, prefixed with "__temp_"
+ * - Placeholder: disconnected relation placeholders, prefixed with "__placeholder_"
+ */
+/**
+ * Checks if an ID is a temporary ID (created locally, not yet persisted).
+ */
+export declare function isTempId(id: string): boolean;
+/**
+ * Checks if an ID is a placeholder ID (disconnected relation placeholder).
+ */
+export declare function isPlaceholderId(id: string): boolean;
+/**
+ * Checks if an ID is a persisted/real ID from the server.
+ */
+export declare function isPersistedId(id: string): boolean;
+/**
+ * Generates a new placeholder ID.
+ */
+export declare function generatePlaceholderId(): string;
+/**
+ * Generates a new temporary ID.
+ */
+export declare function generateTempId(): string;
+//# sourceMappingURL=entityId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entityId.d.ts","sourceRoot":"","sources":["../../src/store/entityId.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/store/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":""}

package/dist/store/snapshots.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Immutable snapshot types for React integration.
+ * All snapshots are frozen objects that are replaced (not mutated) on changes.
+ */
+import type { HasOneRelationState } from '../handles/types.js';
+/**
+ * Status of a data load operation
+ */
+export type LoadStatus = 'idle' | 'loading' | 'success' | 'error' | 'not_found';
+/**
+ * Immutable snapshot of entity data stored in the IdentityMap.
+ * A new snapshot is created whenever the entity data changes.
+ */
+export interface EntitySnapshot<T extends object = object> {
+    /** Entity ID */
+    readonly id: string;
+    /** Entity type name */
+    readonly entityType: string;
+    /** Current (local) data - may differ from serverData if modified */
+    readonly data: Readonly<T>;
+    /** Data as received from server - used for dirty tracking and reset */
+    readonly serverData: Readonly<T>;
+    /** Version number - incremented on each change, used for comparison */
+    readonly version: number;
+}
+/**
+ * Immutable snapshot of a scalar field value.
+ */
+export interface FieldSnapshot<T = unknown> {
+    /** Current value */
+    readonly value: T | null;
+    /** Server value (for dirty tracking) */
+    readonly serverValue: T | null;
+    /** Whether the field has been modified */
+    readonly isDirty: boolean;
+}
+/**
+ * State information for a has-one relation.
+ */
+export interface HasOneRelationSnapshot<T extends object = object> {
+    /** Current relation state */
+    readonly state: HasOneRelationState;
+    /** Current referenced entity ID (null if disconnected) */
+    readonly entityId: string | null;
+    /** Server-side entity ID (for dirty tracking) */
+    readonly serverEntityId: string | null;
+    /** The related entity snapshot (if connected and loaded) */
+    readonly entity: EntitySnapshot<T> | null;
+    /** Whether the relation has been modified */
+    readonly isDirty: boolean;
+    /** Version for change detection */
+    readonly version: number;
+}
+/**
+ * Item in a has-many relation list.
+ */
+export interface HasManyItemSnapshot<T extends object = object> {
+    /** Unique key for React reconciliation */
+    readonly key: string;
+    /** The entity snapshot */
+    readonly entity: EntitySnapshot<T>;
+    /** Whether this item was added locally (not from server) */
+    readonly isNew: boolean;
+}
+/**
+ * Immutable snapshot of a has-many relation (entity list).
+ */
+export interface HasManySnapshot<T extends object = object> {
+    /** List items in current order */
+    readonly items: ReadonlyArray<HasManyItemSnapshot<T>>;
+    /** Keys of items that came from the server */
+    readonly serverItemKeys: ReadonlySet<string>;
+    /** Keys of items that were added locally */
+    readonly addedKeys: ReadonlySet<string>;
+    /** Keys of items that were removed locally */
+    readonly removedKeys: ReadonlySet<string>;
+    /** Whether the order has been changed */
+    readonly orderChanged: boolean;
+    /** Whether the list has any modifications */
+    readonly isDirty: boolean;
+    /** Version for change detection */
+    readonly version: number;
+}
+/**
+ * Loading state for an entity.
+ */
+export interface LoadingState {
+    readonly status: 'loading';
+    readonly id: string;
+}
+/**
+ * Error state for an entity.
+ */
+export interface ErrorState {
+    readonly status: 'error';
+    readonly id: string;
+    readonly error: Error;
+}
+/**
+ * Not found state for an entity.
+ */
+export interface NotFoundState {
+    readonly status: 'not_found';
+    readonly id: string;
+}
+/**
+ * Ready state with entity data.
+ */
+export interface ReadyState<T extends object = object> {
+    readonly status: 'ready';
+    readonly id: string;
+    readonly entityType: string;
+    readonly snapshot: EntitySnapshot<T>;
+}
+/**
+ * Union of all possible entity states.
+ */
+export type EntityState<T extends object = object> = LoadingState | ErrorState | NotFoundState | ReadyState<T>;
+/**
+ * Helper to check if state is ready
+ */
+export declare function isReadyState<T extends object>(state: EntityState<T>): state is ReadyState<T>;
+/**
+ * Helper to check if state is loading
+ */
+export declare function isLoadingState<T extends object>(state: EntityState<T>): state is LoadingState;
+/**
+ * Helper to check if state is error
+ */
+export declare function isErrorState<T extends object>(state: EntityState<T>): state is ErrorState;
+/**
+ * Creates an immutable entity snapshot from data.
+ */
+export declare function createEntitySnapshot<T extends object>(id: string, entityType: string, data: T, serverData: T, version: number): EntitySnapshot<T>;
+/**
+ * Creates a new entity snapshot with updated data.
+ * Returns a new frozen object with incremented version.
+ */
+export declare function updateEntitySnapshot<T extends object>(snapshot: EntitySnapshot<T>, updates: Partial<T>): EntitySnapshot<T>;
+/**
+ * Creates a field snapshot from entity snapshot.
+ */
+export declare function createFieldSnapshot<T>(value: T | null, serverValue: T | null): FieldSnapshot<T>;
+//# sourceMappingURL=snapshots.d.ts.map