@seedprotocol/sdk 0.7.7 → 0.7.8-next.1066.gac32194

package/dist/dist/{ClientManager-2GtDWHq6.d.ts → ClientManager-Dcju5x4k.d.ts}

@@ -1,133 +1,3 @@
-declare function requestEasSyncFromEventBus(): void;
-declare function requestEasSyncFromModelsInit(): void;
-declare namespace ClientManager {
-    function isInitialized(): any;
-    function getService(): import("xstate").Actor<import("xstate").StateMachine<{}, import("xstate").AnyEventObject, {
-        [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>> | undefined;
-    }, {
-        src: "platformClassesInit";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "fileSystemInit";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "dbInit";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "saveConfig";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "addModelsToStore";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "addModelsToDb";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "processSchemaFiles";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    } | {
-        src: "saveAppState";
-        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-        id: string | undefined;
-    }, {
-        type: "assignInitError";
-        params: import("xstate").NonReducibleUnknown;
-    }, never, never, {}, string, {}, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
-        id?: string | undefined | undefined;
-        states?: {} | undefined;
-    }, import("xstate").MetaObject>>;
-    function init(options: any): Promise<void>;
-    function setAddresses(addresses: any): Promise<void>;
-    function getAddresses(): Promise<{
-        owned: any;
-        watched: any;
-    }>;
-    function getOwnedAddresses(): Promise<any>;
-    function getWatchedAddresses(): Promise<any>;
-    function claimUnpublishedDrafts(publisher: any): Promise<{
-        seeds: any;
-        versions: number;
-        metadata: number;
-        seedLocalIds: any;
-    }>;
-    function removeLocalCopiesForAddresses(addresses: any): Promise<{
-        removedSeedLocalIds: any;
-        removedSeedUids: any;
-    }>;
-    function syncFromEas(options: any): Promise<void>;
-    function addModel(modelDef: any): Promise<void>;
-    function onReady(callback: any): () => void;
-    function stop(): void;
-    function unload(): void;
-}
-declare function sendEasSyncClientRequest(correlationId: any, options: any): void;
-/** appState key recording which EAS chain the local database holds attestations from. */
-declare const EAS_CHAIN_ID_APP_STATE_KEY: "easChainId";
-/**
- * Turns retries without an explicit `enabled` on or off; `undefined` restores the default.
- * Returns the previous setting, so a test can put it back.
- */
-declare function setRetriesWhenOnlineEnabled(enabled: any): any;
-declare function startEasSyncActor(): void;
-/** Unregister local query source (tests / client unload). */
-declare function unregisterSeedQueryLocalSource(): void;
-declare const INIT_CONFIG_CONFLICT_MESSAGE: string;
-/**
- * For callers of createModelsFromJson that write the models with addModelsToDb: pass `promise` as its
- * persistedBy and call `settle` once addModelsToDb has run or failed (in a finally). The new models wait
- * for it, then adopt the rows addModelsToDb wrote; any model it didn't write writes itself.
- */
-declare function createRowsWrittenSignal(): {
-    promise: Promise<any>;
-    settle: undefined;
-};
-/**
- * Convert JSON import schema to ModelDefinitions
- * @param importData - The JSON import data
- * @param modelFileIds - Optional map of model names to their file IDs from the JSON file
- * @param propertyFileIds - Optional map of model names to maps of property names to their file IDs from the JSON file
- * @param persistedBy - When the caller writes the models with addModelsToDb: a promise that settles once
- *   that has run (see createRowsWrittenSignal). New models then adopt those rows instead of writing them too.
- * @returns ModelDefinitions object with Model classes
- */
-declare function createModelsFromJson(importData: any, modelFileIds: any, propertyFileIds: any, persistedBy: any): Promise<{}>;
-/**
- * Get the latest version number for a schema by name
- * Only considers complete schema files (with $schema field)
- * @param name - The name of the schema
- * @returns The latest version number, or 0 if no schema found
- */
-declare function getLatestSchemaVersion(name: any): Promise<any>;
-/**
- * Convert a JSON model's properties to the schema property format Model.create and addModelsToDb take
- * @param modelName - The name of the model (for error messages)
- * @param modelDef - The JSON model definition
- * @param propertyFileIds - Optional map of property names to their file IDs from the JSON file
- */
-declare function jsonPropertiesToSchemaProperties(modelName: any, modelDef: any, propertyFileIds: any): {};
-declare var schema: Readonly<{
-    __proto__: null;
-    createSchema: (schema: any, schemaFileId: any) => Promise<void>;
-    deleteSchema: typeof deleteSchema;
-    filterLatestSchemas: typeof filterLatestSchemas;
-    findSchemaByName: typeof findSchemaByName;
-    getLatestSchemaVersion: typeof getLatestSchemaVersion;
-    getSchemaNameFromId: typeof getSchemaNameFromId;
-    listCompleteSchemaFiles: typeof listCompleteSchemaFiles;
-    listLatestSchemaFiles: typeof listLatestSchemaFiles;
-    listSchemaFiles: typeof listSchemaFiles;
-    loadAllSchemasFromDb: typeof loadAllSchemasFromDb;
-    migrateFileSchemasToDb: typeof migrateFileSchemasToDb;
-    readSchema: (name: any, version: any, schemaFileId: any) => Promise<any>;
-    updateSchema: typeof updateSchema;
-}>;
 declare var ClientManager$1: Readonly<{
     __proto__: null;
     CLIENT_ALREADY_STOPPED_WARNING: string;
@@ -174,6 +44,12 @@ declare var ClientManager$1: Readonly<{
             id?: string | undefined | undefined;
             states?: {} | undefined;
         }, import("xstate").MetaObject>>;
+        /**
+         * Calls `listener` with the clientManager actor when it changes: `init()` after `stop()`
+         * replaces the actor, and `stop()` ends the current one. Subscribe to the actor itself for its
+         * state changes. Returns a function that removes the listener.
+         */
+        subscribeService: (listener: any) => () => void;
         /**
          * Initialise the SDK. Calls made while an init is running share it. Once initialised, a
          * call with the same config resolves at once and applies any change in `addresses`; a
@@ -192,12 +68,7 @@ declare var ClientManager$1: Readonly<{
          * Sealed rows (real EAS uid or attestationRaw) are left unchanged.
          * Use after `setAddresses` on connect; `setPublishWallet` does this automatically.
          */
-        claimUnpublishedDrafts: (publisher: any) => Promise<{
-            seeds: any;
-            versions: number;
-            metadata: number;
-            seedLocalIds: any;
-        }>;
+        claimUnpublishedDrafts: (publisher: any) => Promise<any>;
         /**
          * Hard-delete local on-chain seed copies for the given publisher addresses.
          * Drafts (no uid / attestationRaw) are kept. Chain is untouched; reconnect can rehydrate via syncFromEas.
@@ -305,6 +176,12 @@ declare var ClientManager$1: Readonly<{
             id?: string | undefined | undefined;
             states?: {} | undefined;
         }, import("xstate").MetaObject>>;
+        /**
+         * Calls `listener` with the clientManager actor when it changes: `init()` after `stop()`
+         * replaces the actor, and `stop()` ends the current one. Subscribe to the actor itself for its
+         * state changes. Returns a function that removes the listener.
+         */
+        subscribeService: (listener: any) => () => void;
         /**
          * Initialise the SDK. Calls made while an init is running share it. Once initialised, a
          * call with the same config resolves at once and applies any change in `addresses`; a
@@ -323,12 +200,7 @@ declare var ClientManager$1: Readonly<{
          * Sealed rows (real EAS uid or attestationRaw) are left unchanged.
          * Use after `setAddresses` on connect; `setPublishWallet` does this automatically.
          */
-        claimUnpublishedDrafts: (publisher: any) => Promise<{
-            seeds: any;
-            versions: number;
-            metadata: number;
-            seedLocalIds: any;
-        }>;
+        claimUnpublishedDrafts: (publisher: any) => Promise<any>;
         /**
          * Hard-delete local on-chain seed copies for the given publisher addresses.
          * Drafts (no uid / attestationRaw) are kept. Chain is untouched; reconnect can rehydrate via syncFromEas.
@@ -352,6 +224,204 @@ declare var ClientManager$1: Readonly<{
         unload: () => void;
     };
 }>;
+/**
+ * Thin published-JSON helper: `getSeed` via the local (or auto) query source.
+ * Does not touch Item / drafts / liveQuery.
+ *
+ * Prefer this (or `@seedprotocol/query` `getSeed` / `queryBySchema`) for
+ * canonical published Seed JSON. Use `getItemData` / Item for draft-head authoring.
+ */
+declare function getPublishedSeedRecord(seedUid: any, options: any): Promise<import("@seedprotocol/query").GetSeedResult | null>;
+/**
+ * Extract the schema name from a schemaId string
+ * @param schemaId - Schema ID in the format `${schemaName}-${schemaVersion}`
+ * @returns The schema name, or null if the format is invalid
+ */
+declare function getSchemaNameFromId(schemaId: any): string | null;
+declare namespace ClientManager {
+    function isInitialized(): any;
+    function getService(): import("xstate").Actor<import("xstate").StateMachine<{}, import("xstate").AnyEventObject, {
+        [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>> | undefined;
+    }, {
+        src: "platformClassesInit";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "fileSystemInit";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "dbInit";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "saveConfig";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "addModelsToStore";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "addModelsToDb";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "processSchemaFiles";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    } | {
+        src: "saveAppState";
+        logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+        id: string | undefined;
+    }, {
+        type: "assignInitError";
+        params: import("xstate").NonReducibleUnknown;
+    }, never, never, {}, string, {}, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+        id?: string | undefined | undefined;
+        states?: {} | undefined;
+    }, import("xstate").MetaObject>>;
+    function subscribeService(listener: any): () => void;
+    function init(options: any): Promise<void>;
+    function setAddresses(addresses: any): Promise<void>;
+    function getAddresses(): Promise<{
+        owned: any;
+        watched: any;
+    }>;
+    function getOwnedAddresses(): Promise<any>;
+    function getWatchedAddresses(): Promise<any>;
+    function claimUnpublishedDrafts(publisher: any): Promise<any>;
+    function removeLocalCopiesForAddresses(addresses: any): Promise<{
+        removedSeedLocalIds: any;
+        removedSeedUids: any;
+    }>;
+    function syncFromEas(options: any): Promise<void>;
+    function addModel(modelDef: any): Promise<void>;
+    function onReady(callback: any): () => void;
+    function stop(): void;
+    function unload(): void;
+}
+declare function isSeedQueryLocalSourceRegistered(): boolean;
+/** appState key recording which EAS chain the local database holds attestations from. */
+declare const EAS_CHAIN_ID_APP_STATE_KEY: "easChainId";
+declare function listCompleteSchemaFiles(): Promise<{
+    name: any;
+    version: any;
+    filePath: any;
+    schemaFileId: any;
+}[]>;
+declare function loadAllSchemasFromDb(): Promise<({
+    schema: any;
+    isDraft: boolean;
+    source: string;
+    schemaRecordId: any;
+    filePath?: undefined;
+    dbMatchesFile?: undefined;
+} | {
+    schema: any;
+    isDraft: boolean;
+    source: string;
+    schemaRecordId: any;
+    filePath: any;
+    dbMatchesFile: boolean;
+} | {
+    schema: any;
+    isDraft: boolean;
+    source: string;
+    schemaRecordId: any;
+    filePath: any;
+    dbMatchesFile?: undefined;
+})[]>;
+/**
+ * Merge multiple EAS sync intents: full sync (no concrete address list) wins;
+ * otherwise union addresses (first-seen casing).
+ */
+declare function mergeEasSyncRequestIntents(parts: any): {
+    addresses?: undefined;
+} | {
+    addresses: any[];
+};
+declare const INIT_CONFIG_CONFLICT_MESSAGE: string;
+/**
+ * Read a schema file by name and version
+ * @param name - The name of the schema
+ * @param version - The version of the schema
+ * @param schemaFileId - Schema file ID (required)
+ * @returns The schema object, or null if not found
+ */
+declare function readSchema(name: any, version: any, schemaFileId: any): Promise<any>;
+/**
+ * Register the SDK SQLite/files adapter with `@seedprotocol/query`.
+ * Safe to call multiple times; re-registers with a fresh adapter instance.
+ * No-op when the app DB is not ready yet (unless `force`).
+ */
+declare function registerSeedQueryLocalSource(options: any): boolean;
+declare function requestEasSyncFromAddressChange(addresses: any): void;
+declare function requestEasSyncFromEventBus(): void;
+declare function requestEasSyncFromModelsInit(): void;
+declare function sendEasSyncClientRequest(correlationId: any, options: any): void;
+/**
+ * Turns retries without an explicit `enabled` on or off; `undefined` restores the default.
+ * Returns the previous setting, so a test can put it back.
+ */
+declare function setRetriesWhenOnlineEnabled(enabled: any): any;
+declare function startEasSyncActor(): void;
+/** A Relation value names a local seed that doesn't exist. */
+declare class RelationTargetError extends Error {
+    constructor(targets: any);
+    targets: any;
+}
+/** Unregister local query source (tests / client unload). */
+declare function unregisterSeedQueryLocalSource(): void;
+/**
+ * For callers of createModelsFromJson that write the models with addModelsToDb: pass `promise` as its
+ * persistedBy and call `settle` once addModelsToDb has run or failed (in a finally). The new models wait
+ * for it, then adopt the rows addModelsToDb wrote; any model it didn't write writes itself.
+ */
+declare function createRowsWrittenSignal(): {
+    promise: Promise<any>;
+    settle: undefined;
+};
+/**
+ * Convert JSON import schema to ModelDefinitions
+ * @param importData - The JSON import data
+ * @param modelFileIds - Optional map of model names to their file IDs from the JSON file
+ * @param propertyFileIds - Optional map of model names to maps of property names to their file IDs from the JSON file
+ * @param persistedBy - When the caller writes the models with addModelsToDb: a promise that settles once
+ *   that has run (see createRowsWrittenSignal). New models then adopt those rows instead of writing them too.
+ * @returns ModelDefinitions object with Model classes
+ */
+declare function createModelsFromJson(importData: any, modelFileIds: any, propertyFileIds: any, persistedBy: any): Promise<{}>;
+/**
+ * Get the latest version number for a schema by name
+ * Only considers complete schema files (with $schema field)
+ * @param name - The name of the schema
+ * @returns The latest version number, or 0 if no schema found
+ */
+declare function getLatestSchemaVersion(name: any): Promise<any>;
+/**
+ * Convert a JSON model's properties to the schema property format Model.create and addModelsToDb take
+ * @param modelName - The name of the model (for error messages)
+ * @param modelDef - The JSON model definition
+ * @param propertyFileIds - Optional map of property names to their file IDs from the JSON file
+ */
+declare function jsonPropertiesToSchemaProperties(modelName: any, modelDef: any, propertyFileIds: any): {};
+declare var schema: Readonly<{
+    __proto__: null;
+    createSchema: (schema: any, schemaFileId: any) => Promise<void>;
+    deleteSchema: typeof deleteSchema;
+    filterLatestSchemas: typeof filterLatestSchemas;
+    findSchemaByName: typeof findSchemaByName;
+    getLatestSchemaVersion: typeof getLatestSchemaVersion;
+    getSchemaNameFromId: typeof getSchemaNameFromId;
+    listCompleteSchemaFiles: typeof listCompleteSchemaFiles;
+    listLatestSchemaFiles: typeof listLatestSchemaFiles;
+    listSchemaFiles: typeof listSchemaFiles;
+    loadAllSchemasFromDb: typeof loadAllSchemasFromDb;
+    migrateFileSchemasToDb: typeof migrateFileSchemasToDb;
+    readSchema: (name: any, version: any, schemaFileId: any) => Promise<any>;
+    updateSchema: typeof updateSchema;
+}>;
 declare var SEEDPROTOCOL_Seed_Protocol_v1: Readonly<{
     __proto__: null;
     $schema: string;
@@ -569,6 +639,114 @@ declare var SEEDPROTOCOL_Seed_Protocol_v1: Readonly<{
     };
     version: number;
 }>;
+declare var conflicts: Readonly<{
+    __proto__: null;
+    findSetConflict: typeof findSetConflict;
+    getItemConflicts: typeof getItemConflicts;
+    getPropertyConflict: typeof getPropertyConflict;
+    keepLocalDraftsOverSyncedRows: typeof keepLocalDraftsOverSyncedRows;
+    markPropertyConflictsResolved: typeof markPropertyConflictsResolved;
+    recordPropertyEdit: typeof recordPropertyEdit;
+}>;
+declare var itemAppliers: Readonly<{
+    __proto__: null;
+    RelationTargetError: typeof RelationTargetError;
+    applyCreateItem: typeof applyCreateItem;
+    applyDelete: typeof applyDelete;
+    applyItemStorageValue: typeof applyItemStorageValue;
+    applyStorageValue: typeof applyStorageValue;
+    deleteFiles: typeof deleteFiles;
+    startItemOutbox: typeof startItemOutbox;
+    throwItemWriteError: typeof throwItemWriteError;
+}>;
+/** Writes a new item's rows on `db` (see CreateItemOp). */
+declare function applyCreateItem(seedLocalId: any, value: any, db: any): Promise<{
+    seedLocalId: any;
+    versionLocalId: string;
+}>;
+declare function applyDelete(op: any, value: any, db: any): Promise<{
+    filePaths: string[];
+}>;
+/**
+ * Writes an ItemStorage value on `db`: the edit goes into the property's current local draft, or a
+ * new one when there is none or a published row is newer (readers show the newest row). A synced
+ * or derived row is published content and is never written to.
+ */
+declare function applyItemStorageValue(seedLocalId: any, propertyName: any, op: any, db: any): Promise<{
+    localId: any;
+    uid: any;
+    schemaUid: any;
+    fileName: any;
+    localStorageDir: any;
+}>;
+/** Deletes files after the op that removed their rows applied; best-effort. */
+declare function deleteFiles(filePaths: any): Promise<void>;
+/**
+ * The appliers for item ops (ADR 0019). Every tab registers them at init: the leader applies ops
+ * that other tabs appended.
+ */
+/**
+ * Writes a storage value's rows on `db`. The property's row is looked up here, on `db`, rather than
+ * taken from the edit: two quick edits of a property that had no row would otherwise both create one.
+ */
+declare function applyStorageValue(seedLocalId: any, propertyName: any, value: any, db: any): Promise<{
+    localId: any;
+    uid: any;
+    schemaUid: any;
+} | null>;
+/** The property's unresolved conflict, if it has one. */
+declare function getPropertyConflict(seedLocalId: any, propertyName: any): Promise<any>;
+/** The item's unresolved conflicts, the newest per property. */
+declare function getItemConflicts(seedLocalId: any): Promise<any[]>;
+/**
+ * Get refValueType from a property object with case-insensitive key lookup.
+ */
+declare function getRefValueType(prop: any): string | undefined;
+declare function importJsonSchema(importFilePathOrContents: any, version?: number): Promise<any>;
+/**
+ * Sync a canonical schema from a file path or inlined object to the database.
+ * A stored schema file with the same id and version but different content is overwritten (with a
+ * warning) instead of reused, and models dropped from the schema are unlinked from it.
+ * Called automatically at init when config.schema is provided.
+ *
+ * @param source - File path (string) or complete SchemaFileFormat object
+ */
+declare function syncSchemaFromSource(source: any): Promise<void>;
+/**
+ * Transform import JSON format to full schema file format
+ * @param importData - The JSON import data
+ * @param version - The version number for the schema (defaults to 1)
+ * @returns The transformed schema file format
+ */
+declare function transformImportToSchemaFile(importData: any, version?: number): {
+    metadata: {
+        name: any;
+        createdAt: string;
+        updatedAt: string;
+    };
+    models: {};
+    enums: {};
+    migrations: {
+        version: number;
+        timestamp: string;
+        description: string;
+        changes: never[];
+    }[];
+    nameMatch?: any;
+    $schema: string;
+    version: number;
+    id: string;
+};
+/**
+ * Load an existing complete schema file and process its models
+ * This is used to load models from already-processed schema files into the store
+ * @param schemaFilePath - Path to the complete schema file (must have $schema field)
+ * @returns The file path of the schema
+ * @throws Error if file cannot be read, parsed, or is not a complete schema
+ */
+declare function loadSchemaFromFile(schemaFilePath: any): Promise<any>;
+/** Marks the property's conflicts resolved. */
+declare function markPropertyConflictsResolved(seedLocalId: any, propertyName: any): Promise<void>;
 declare function getContentHash(data: any): Promise<string>;
 /**
  * A legacy ItemStorage draft row: a local edit (no attestation uid, not derived from one) that holds
@@ -600,18 +778,38 @@ declare function convertVerbatimItemStorageRow(localId: any, storage?: {}): Prom
  * current chain on an empty DB; throws when the DB holds data from a different chain.
  */
 declare function assertLocalDbChain(): Promise<void>;
+/**
+ * Read and parse a JSON import file
+ * Supports two formats:
+ * 1. Minimal format: { name: string, models: {...} }
+ * 2. Complete schema format: { $schema: string, metadata: { name: string }, models: {...}, ... }
+ * @param filePath - Path to the JSON import file
+ * @returns The parsed JSON import data normalized to JsonImportSchema format
+ * @throws Error if file cannot be read or parsed
+ */
+declare function readJsonImportFile(filePath: any): Promise<{
+    models: any;
+    nameMatch?: any;
+    name: any;
+}>;
+/** Registers the item appliers and starts draining. Safe to call more than once. */
+declare function startItemOutbox(): void;
+/**
+ * Rethrows a failed item op's error as its caller expects it: OwnershipError when the drainer
+ * refused the op for ownership, else the OutboxOpFailedError as is.
+ */
+declare function throwItemWriteError(error: any): void;
 /**
  * Gives `publisher` to local drafts that belong to no wallet yet: seeds with no publisher, no real
  * uid and no attestationRaw, and those seeds' versions and property rows that are unsealed too.
  * Versions and property rows go only with their seed, so rows of a seed that already has a
  * publisher are never claimed. Sealed rows (real EAS uid or attestationRaw) are never touched.
+ *
+ * Pending Item.create ops with no publisher get it too, in the same transaction: the drainer applies
+ * an op's value as its claim reads it (ADR 0019), so a create applied before or after this one ends
+ * up claimed either way.
  */
-declare function claimUnpublishedDrafts(publisher: any): Promise<{
-    seeds: any;
-    versions: number;
-    metadata: number;
-    seedLocalIds: any;
-}>;
+declare function claimUnpublishedDrafts(publisher: any): Promise<any>;
 /**
  * SDK local QueryDataSource: published Seeds/Versions/metadata from SQLite.
  *
@@ -632,15 +830,10 @@ declare function createLocalQueryDataSource(): {
     readStorageBody(ref: any): Promise<any>;
 };
 /**
- * Get refValueType from a property object with case-insensitive key lookup.
- */
-declare function getRefValueType(prop: any): string | undefined;
-/**
- * Hard-delete the given seed local ids and related local rows (cascade).
- * Does not touch schemas, app_state, or chain.
+ * Wait until the read chain is known before syncing. Only waits when `@seedprotocol/publish`
+ * is loaded but `initPublish` has not run, and no chain is configured or recorded locally.
  */
-declare function hardDeleteLocalSeedsByLocalIds(seedLocalIds: any): Promise<void>;
-declare function importJsonSchema(importFilePathOrContents: any, version?: number): Promise<any>;
+declare function waitForEasReadChain(timeoutMs?: number): Promise<void>;
 /**
  * Create a new schema file
  * @param schema - The schema object to save
@@ -662,14 +855,6 @@ declare const easSyncActor: import("xstate").Actor<import("xstate").StateMachine
         readonly afterRun: {};
     };
 }, import("xstate").MetaObject>>;
-/**
- * Load an existing complete schema file and process its models
- * This is used to load models from already-processed schema files into the store
- * @param schemaFilePath - Path to the complete schema file (must have $schema field)
- * @returns The file path of the schema
- * @throws Error if file cannot be read, parsed, or is not a complete schema
- */
-declare function loadSchemaFromFile(schemaFilePath: any): Promise<any>;
 declare function getClient(): {
     isInitialized: () => any;
     getService: () => import("xstate").Actor<import("xstate").StateMachine<{}, import("xstate").AnyEventObject, {
@@ -713,6 +898,12 @@ declare function getClient(): {
         id?: string | undefined | undefined;
         states?: {} | undefined;
     }, import("xstate").MetaObject>>;
+    /**
+     * Calls `listener` with the clientManager actor when it changes: `init()` after `stop()`
+     * replaces the actor, and `stop()` ends the current one. Subscribe to the actor itself for its
+     * state changes. Returns a function that removes the listener.
+     */
+    subscribeService: (listener: any) => () => void;
     /**
      * Initialise the SDK. Calls made while an init is running share it. Once initialised, a
      * call with the same config resolves at once and applies any change in `addresses`; a
@@ -731,12 +922,7 @@ declare function getClient(): {
      * Sealed rows (real EAS uid or attestationRaw) are left unchanged.
      * Use after `setAddresses` on connect; `setPublishWallet` does this automatically.
      */
-    claimUnpublishedDrafts: (publisher: any) => Promise<{
-        seeds: any;
-        versions: number;
-        metadata: number;
-        seedLocalIds: any;
-    }>;
+    claimUnpublishedDrafts: (publisher: any) => Promise<any>;
     /**
      * Hard-delete local on-chain seed copies for the given publisher addresses.
      * Drafts (no uid / attestationRaw) are kept. Chain is untouched; reconnect can rehydrate via syncFromEas.
@@ -759,126 +945,6 @@ declare function getClient(): {
     stop: () => void;
     unload: () => void;
 };
-/**
- * Thin published-JSON helper: `getSeed` via the local (or auto) query source.
- * Does not touch Item / drafts / liveQuery.
- *
- * Prefer this (or `@seedprotocol/query` `getSeed` / `queryBySchema`) for
- * canonical published Seed JSON. Use `getItemData` / Item for draft-head authoring.
- */
-declare function getPublishedSeedRecord(seedUid: any, options: any): Promise<import("@seedprotocol/query").GetSeedResult | null>;
-/**
- * Extract the schema name from a schemaId string
- * @param schemaId - Schema ID in the format `${schemaName}-${schemaVersion}`
- * @returns The schema name, or null if the format is invalid
- */
-declare function getSchemaNameFromId(schemaId: any): string | null;
-declare function isSeedQueryLocalSourceRegistered(): boolean;
-declare function listCompleteSchemaFiles(): Promise<{
-    name: any;
-    version: any;
-    filePath: any;
-    schemaFileId: any;
-}[]>;
-/**
- * Read and parse a JSON import file
- * Supports two formats:
- * 1. Minimal format: { name: string, models: {...} }
- * 2. Complete schema format: { $schema: string, metadata: { name: string }, models: {...}, ... }
- * @param filePath - Path to the JSON import file
- * @returns The parsed JSON import data normalized to JsonImportSchema format
- * @throws Error if file cannot be read or parsed
- */
-declare function readJsonImportFile(filePath: any): Promise<{
-    models: any;
-    nameMatch?: any;
-    name: any;
-}>;
-/**
- * Sync a canonical schema from a file path or inlined object to the database.
- * A stored schema file with the same id and version but different content is overwritten (with a
- * warning) instead of reused, and models dropped from the schema are unlinked from it.
- * Called automatically at init when config.schema is provided.
- *
- * @param source - File path (string) or complete SchemaFileFormat object
- */
-declare function syncSchemaFromSource(source: any): Promise<void>;
-/**
- * Transform import JSON format to full schema file format
- * @param importData - The JSON import data
- * @param version - The version number for the schema (defaults to 1)
- * @returns The transformed schema file format
- */
-declare function transformImportToSchemaFile(importData: any, version?: number): {
-    metadata: {
-        name: any;
-        createdAt: string;
-        updatedAt: string;
-    };
-    models: {};
-    enums: {};
-    migrations: {
-        version: number;
-        timestamp: string;
-        description: string;
-        changes: never[];
-    }[];
-    nameMatch?: any;
-    $schema: string;
-    version: number;
-    id: string;
-};
-declare function loadAllSchemasFromDb(): Promise<({
-    schema: any;
-    isDraft: boolean;
-    source: string;
-    schemaRecordId: any;
-    filePath?: undefined;
-    dbMatchesFile?: undefined;
-} | {
-    schema: any;
-    isDraft: boolean;
-    source: string;
-    schemaRecordId: any;
-    filePath: any;
-    dbMatchesFile: boolean;
-} | {
-    schema: any;
-    isDraft: boolean;
-    source: string;
-    schemaRecordId: any;
-    filePath: any;
-    dbMatchesFile?: undefined;
-})[]>;
-/**
- * Merge multiple EAS sync intents: full sync (no concrete address list) wins;
- * otherwise union addresses (first-seen casing).
- */
-declare function mergeEasSyncRequestIntents(parts: any): {
-    addresses?: undefined;
-} | {
-    addresses: any[];
-};
-/**
- * Wait until the read chain is known before syncing. Only waits when `@seedprotocol/publish`
- * is loaded but `initPublish` has not run, and no chain is configured or recorded locally.
- */
-declare function waitForEasReadChain(timeoutMs?: number): Promise<void>;
-/**
- * Read a schema file by name and version
- * @param name - The name of the schema
- * @param version - The version of the schema
- * @param schemaFileId - Schema file ID (required)
- * @returns The schema object, or null if not found
- */
-declare function readSchema(name: any, version: any, schemaFileId: any): Promise<any>;
-/**
- * Register the SDK SQLite/files adapter with `@seedprotocol/query`.
- * Safe to call multiple times; re-registers with a fresh adapter instance.
- * No-op when the app DB is not ready yet (unless `force`).
- */
-declare function registerSeedQueryLocalSource(options: any): boolean;
-declare function requestEasSyncFromAddressChange(addresses: any): void;
 /**
  * Delete a schema file
  * @param name - The name of the schema
@@ -930,5 +996,40 @@ declare function migrateFileSchemasToDb(): Promise<number>;
  * @throws Error if schema doesn't exist
  */
 declare function updateSchema(schema: any, schemaFileId: any): Promise<void>;
-export { requestEasSyncFromEventBus as A, requestEasSyncFromModelsInit as B, ClientManager as C, sendEasSyncClientRequest as D, EAS_CHAIN_ID_APP_STATE_KEY as E, setRetriesWhenOnlineEnabled as F, startEasSyncActor as G, unregisterSeedQueryLocalSource as H, INIT_CONFIG_CONFLICT_MESSAGE as I, createRowsWrittenSignal as J, createModelsFromJson as K, getLatestSchemaVersion as L, jsonPropertiesToSchemaProperties as M, schema as N, ClientManager$1 as O, SEEDPROTOCOL_Seed_Protocol_v1 as S, getContentHash as a, isVerbatimItemStorageDraftRow as b, convertVerbatimItemStorageRow as c, assertLocalDbChain as d, claimUnpublishedDrafts as e, createLocalQueryDataSource as f, getRefValueType as g, hardDeleteLocalSeedsByLocalIds as h, importJsonSchema as i, createSchema as j, easSyncActor as k, loadSchemaFromFile as l, getClient as m, getPublishedSeedRecord as n, getSchemaNameFromId as o, isSeedQueryLocalSourceRegistered as p, listCompleteSchemaFiles as q, readJsonImportFile as r, syncSchemaFromSource as s, transformImportToSchemaFile as t, loadAllSchemasFromDb as u, mergeEasSyncRequestIntents as v, waitForEasReadChain as w, readSchema as x, registerSeedQueryLocalSource as y, requestEasSyncFromAddressChange as z };
-//# sourceMappingURL=ClientManager-2GtDWHq6.d.ts.map
+/**
+ * Conflicts between a local edit and a value sync wrote after it (ADR 0019). The local edit wins:
+ * a pending edit applies over the synced row as a new draft, and a draft already written stays the
+ * newest row. The conflict is recorded on an op row, so the app can show both values and let the
+ * user pick.
+ */
+/**
+ * The conflict a `set` op meets when it applies: sync wrote an attested row for the property after
+ * the edit was made, and its value differs from both the value the edit was made against and the
+ * edit's own. A row with the base row's uid (the same attestation synced again) is not a conflict,
+ * nor is a published row carrying the base value (a publish of the edit's base). Reads through `db`
+ * (the op's transaction).
+ */
+declare function findSetConflict(op: any, value: any, db: any): Promise<{
+    seedLocalId: any;
+    propertyName: any;
+    baseValue: any;
+    remoteValue: any;
+    localValue: any;
+    remoteUid: any;
+    opId: any;
+} | null>;
+/**
+ * The conflict rule for rows sync just inserted (`synced`) over a local draft already written: the
+ * draft stays the property's value. When a synced row is newer than the draft, the draft's time is
+ * moved just past it (readers take the newest row). A conflict is recorded, on an `applied` op row
+ * of its own, when the synced value differs from both the draft's and the attested value the draft
+ * replaced. Properties with a pending value op are left to the drainer, which applies the same rule.
+ */
+declare function keepLocalDraftsOverSyncedRows(synced: any): Promise<void>;
+/**
+ * Records `conflict` on the op that met it, and clears the property's earlier conflicts: a newer
+ * local edit settles them (it was made with the synced value in view, or overrides it again).
+ */
+declare function recordPropertyEdit(op: any, conflict: any, db: any): Promise<void>;
+export { ClientManager$1 as $, getPublishedSeedRecord as A, getSchemaNameFromId as B, ClientManager as C, isSeedQueryLocalSourceRegistered as D, EAS_CHAIN_ID_APP_STATE_KEY as E, listCompleteSchemaFiles as F, loadAllSchemasFromDb as G, mergeEasSyncRequestIntents as H, INIT_CONFIG_CONFLICT_MESSAGE as I, readSchema as J, registerSeedQueryLocalSource as K, requestEasSyncFromAddressChange as L, requestEasSyncFromEventBus as M, requestEasSyncFromModelsInit as N, sendEasSyncClientRequest as O, setRetriesWhenOnlineEnabled as P, startEasSyncActor as Q, RelationTargetError as R, unregisterSeedQueryLocalSource as S, createRowsWrittenSignal as T, createModelsFromJson as U, getLatestSchemaVersion as V, jsonPropertiesToSchemaProperties as W, schema as X, SEEDPROTOCOL_Seed_Protocol_v1 as Y, conflicts as Z, itemAppliers as _, applyCreateItem as a, applyDelete as b, applyItemStorageValue as c, deleteFiles as d, applyStorageValue as e, getPropertyConflict as f, getItemConflicts as g, getRefValueType as h, importJsonSchema as i, syncSchemaFromSource as j, transformImportToSchemaFile as k, loadSchemaFromFile as l, markPropertyConflictsResolved as m, getContentHash as n, isVerbatimItemStorageDraftRow as o, convertVerbatimItemStorageRow as p, assertLocalDbChain as q, readJsonImportFile as r, startItemOutbox as s, throwItemWriteError as t, claimUnpublishedDrafts as u, createLocalQueryDataSource as v, waitForEasReadChain as w, createSchema as x, easSyncActor as y, getClient as z };
+//# sourceMappingURL=ClientManager-Dcju5x4k.d.ts.map