/** One stored document, as the owning plugin sees it. */
export interface PluginDocument<T> {
    /** The plugin's own stable identifier for this document. */
    key: string;
    data: T;
    updatedAt: string | Date;
}
export interface PluginStore<T> {
    items: PluginDocument<T>[];
    isLoading: boolean;
    isError: unknown;
    /** One document by key, or undefined. */
    get: (key: string) => PluginDocument<T> | undefined;
    /** Create or replace a document. Keyed writes are upserts, not appends. */
    put: (key: string, data: T) => Promise<void>;
    remove: (key: string) => Promise<void>;
}
/**
 * Storage a plugin owns, without a change to CDT's database.
 *
 * Scoped by organization (from the session, server-side), by plugin (from the plugin
 * scope, never a parameter, so no plugin can name another's namespace) and by
 * collection, which the plugin picks. `key` is the plugin's own identifier — use
 * something durable like an IFC GlobalId, since writing the same key replaces.
 *
 * ```tsx
 * const spaces = usePluginStore<{ programme: string; capacity: number }>('spaces')
 * await spaces.put(globalId, { programme: 'Office', capacity: 4 })
 * ```
 *
 * Core never inspects `data`, so `T` is a declaration rather than a guarantee —
 * read defensively if an older version of the plugin wrote a different shape.
 */
export declare function usePluginStore<T = unknown>(collection: string): PluginStore<T>;
//# sourceMappingURL=store.d.ts.map