@tanstack/db/dist/esm/proxy.d.ts

A reactive client store for building super fast apps on sync

/**
 * A utility for creating a proxy that captures changes to an object
 * and provides a way to retrieve those changes.
 */
interface ChangeParent {
    tracker: ChangeTracker<Record<string | symbol, unknown>>;
    prop: string | symbol;
    retainIdentity?: boolean;
}
interface ChangeTracker<T extends object> {
    valueCopies: WeakMap<object, unknown>;
    originalObject: T;
    modified: boolean;
    copy_: T;
    assigned_: Record<string | symbol, boolean>;
    parent?: ChangeParent;
    target: T;
}
/**
 * Creates a proxy that tracks changes to the target object
 *
 * @param target The object to proxy
 * @param parent Optional parent information
 * @returns An object containing the proxy and a function to get the changes
 */
export declare function createChangeProxy<T extends Record<string | symbol, any | undefined>>(target: T, parent?: ChangeParent): {
    proxy: T;
    getChanges: () => Record<string | symbol, any>;
};
/**
 * Creates proxies for an array of objects and tracks changes to each
 *
 * @param targets Array of objects to proxy
 * @returns An object containing the array of proxies and a function to get all changes
 */
export declare function createArrayChangeProxy<T extends object>(targets: Array<T>): {
    proxies: Array<T>;
    getChanges: () => Array<Record<string | symbol, unknown>>;
};
/**
 * Creates a proxy for an object, passes it to a callback function,
 * and returns the changes made by the callback
 *
 * @param target The object to proxy
 * @param callback Function that receives the proxy and can make changes to it
 * @returns The changes made to the object
 */
export declare function withChangeTracking<T extends object>(target: T, callback: (proxy: T) => void): Record<string | symbol, unknown>;
/**
 * Creates proxies for an array of objects, passes them to a callback function,
 * and returns the changes made by the callback for each object
 *
 * @param targets Array of objects to proxy
 * @param callback Function that receives the proxies and can make changes to them
 * @returns Array of changes made to each object
 */
export declare function withArrayChangeTracking<T extends object>(targets: Array<T>, callback: (proxies: Array<T>) => void): Array<Record<string | symbol, unknown>>;
export {};