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

package/dist/{resolveModelForSyncedSeed-DFr4COc4.js → resolveModelForSyncedSeed-DHOq_FGs.js}

@@ -1,5 +1,5 @@
 import debug from 'debug';
-import { H as AmbiguousModelError, I as eventEmitter } from './index-DpgQMIRq.js';
+import { H as AmbiguousModelError, I as eventEmitter } from './index-CI0NFf4B.js';
 
 const logger = debug('seedSdk:db:read:resolveModelForSyncedSeed');
 /** Emitted when background work skips a seed whose model name exists in several schemas. */
@@ -43,4 +43,4 @@ const skipSeedOnAmbiguousModel = async (seed, context, work) => {
 };
 
 export { MODEL_AMBIGUOUS_EVENT as M, resolveModelForSyncedSeed as r, skipSeedOnAmbiguousModel as s };
-//# sourceMappingURL=resolveModelForSyncedSeed-DFr4COc4.js.map
+//# sourceMappingURL=resolveModelForSyncedSeed-DHOq_FGs.js.map

package/dist/{resolveModelForSyncedSeed-DFr4COc4.js.map → resolveModelForSyncedSeed-DHOq_FGs.js.map}

@@ -1 +1 @@
-{"version":3,"file":"resolveModelForSyncedSeed-DFr4COc4.js","sources":["../../src/db/read/resolveModelForSyncedSeed.ts"],"sourcesContent":["import debug from 'debug'\nimport { eventEmitter } from '@/eventBus'\nimport { AmbiguousModelError } from '@/Model/errors'\n\nconst logger = debug('seedSdk:db:read:resolveModelForSyncedSeed')\n\n/** Emitted when background work skips a seed whose model name exists in several schemas. */\nexport const MODEL_AMBIGUOUS_EVENT = 'model:ambiguous' as const\n\nexport type ModelAmbiguousEventPayload = {\n  modelName: string\n  schemaNames: string[]\n  seedLocalId?: string\n  seedUid?: string\n  /** What was being done when the seed was skipped (e.g. 'easSync.metadata'). */\n  context: string\n}\n\nexport type SyncedSeedInfo = {\n  seedUid?: string | null\n  seedLocalId?: string | null\n  /** seeds.type as synced from EAS (the EAS schema name, i.e. snake_case model name). */\n  modelType?: string | null\n  /** EAS schema UID of the seed attestation. */\n  schemaUid?: string | null\n}\n\n/**\n * Seam for matching an EAS-synced seed to a local model (its schemaFileId).\n *\n * EAS identifies a seed's model only by name (`bytes32 <model_name>`), so when several local schemas\n * define a model with that name the seed alone can't say which one it is. The original plan was to\n * match by the seed's properties and metadata; docs/adr/0006-schema-scoped-seeds.md replaced it.\n *\n * TODO(eas-synced-seed-model-resolution): not implemented yet. Returns undefined, so callers fall\n * back to the name, which throws AmbiguousModelError when the name is ambiguous.\n */\nexport const resolveModelForSyncedSeed = async (_seed: SyncedSeedInfo): Promise<string | undefined> => {\n  return undefined\n}\n\n/**\n * Run background work for one seed; if it hits an ambiguous model name, log, emit\n * MODEL_AMBIGUOUS_EVENT and return undefined (skip) instead of failing the whole job. Loading the\n * item directly still throws, so the problem surfaces where the app touches it.\n */\nexport const skipSeedOnAmbiguousModel = async <T>(\n  seed: { seedLocalId?: string | null; seedUid?: string | null },\n  context: string,\n  work: () => Promise<T>,\n): Promise<T | undefined> => {\n  try {\n    return await work()\n  } catch (error) {\n    if (!(error instanceof AmbiguousModelError)) throw error\n    logger(`Skipping seed ${seed.seedLocalId ?? seed.seedUid} in ${context}: ${error.message}`)\n    const payload: ModelAmbiguousEventPayload = {\n      modelName: error.modelName,\n      schemaNames: error.schemaNames,\n      seedLocalId: seed.seedLocalId ?? undefined,\n      seedUid: seed.seedUid ?? undefined,\n      context,\n    }\n    eventEmitter.emit(MODEL_AMBIGUOUS_EVENT, payload)\n    return undefined\n  }\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,MAAM,GAAG,KAAK,CAAC,2CAA2C,CAAC;AAEjE;AACO,MAAM,qBAAqB,GAAG;AAoBrC;;;;;;;;;AASG;MACU,yBAAyB,GAAG,OAAO,KAAqB,KAAiC;AACpG,IAAA,OAAO,SAAS;AAClB;AAEA;;;;AAIG;AACI,MAAM,wBAAwB,GAAG,OACtC,IAA8D,EAC9D,OAAe,EACf,IAAsB,KACI;AAC1B,IAAA,IAAI;QACF,OAAO,MAAM,IAAI,EAAE;IACrB;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,IAAI,EAAE,KAAK,YAAY,mBAAmB,CAAC;AAAE,YAAA,MAAM,KAAK;AACxD,QAAA,MAAM,CAAC,CAAA,cAAA,EAAiB,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAA,IAAA,EAAO,OAAO,CAAA,EAAA,EAAK,KAAK,CAAC,OAAO,CAAA,CAAE,CAAC;AAC3F,QAAA,MAAM,OAAO,GAA+B;YAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;AAC9B,YAAA,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;AAC1C,YAAA,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;YAClC,OAAO;SACR;AACD,QAAA,YAAY,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;AACjD,QAAA,OAAO,SAAS;IAClB;AACF;;"}
+{"version":3,"file":"resolveModelForSyncedSeed-DHOq_FGs.js","sources":["../../src/db/read/resolveModelForSyncedSeed.ts"],"sourcesContent":["import debug from 'debug'\nimport { eventEmitter } from '@/eventBus'\nimport { AmbiguousModelError } from '@/Model/errors'\n\nconst logger = debug('seedSdk:db:read:resolveModelForSyncedSeed')\n\n/** Emitted when background work skips a seed whose model name exists in several schemas. */\nexport const MODEL_AMBIGUOUS_EVENT = 'model:ambiguous' as const\n\nexport type ModelAmbiguousEventPayload = {\n  modelName: string\n  schemaNames: string[]\n  seedLocalId?: string\n  seedUid?: string\n  /** What was being done when the seed was skipped (e.g. 'easSync.metadata'). */\n  context: string\n}\n\nexport type SyncedSeedInfo = {\n  seedUid?: string | null\n  seedLocalId?: string | null\n  /** seeds.type as synced from EAS (the EAS schema name, i.e. snake_case model name). */\n  modelType?: string | null\n  /** EAS schema UID of the seed attestation. */\n  schemaUid?: string | null\n}\n\n/**\n * Seam for matching an EAS-synced seed to a local model (its schemaFileId).\n *\n * EAS identifies a seed's model only by name (`bytes32 <model_name>`), so when several local schemas\n * define a model with that name the seed alone can't say which one it is. The original plan was to\n * match by the seed's properties and metadata; docs/adr/0006-schema-scoped-seeds.md replaced it.\n *\n * TODO(eas-synced-seed-model-resolution): not implemented yet. Returns undefined, so callers fall\n * back to the name, which throws AmbiguousModelError when the name is ambiguous.\n */\nexport const resolveModelForSyncedSeed = async (_seed: SyncedSeedInfo): Promise<string | undefined> => {\n  return undefined\n}\n\n/**\n * Run background work for one seed; if it hits an ambiguous model name, log, emit\n * MODEL_AMBIGUOUS_EVENT and return undefined (skip) instead of failing the whole job. Loading the\n * item directly still throws, so the problem surfaces where the app touches it.\n */\nexport const skipSeedOnAmbiguousModel = async <T>(\n  seed: { seedLocalId?: string | null; seedUid?: string | null },\n  context: string,\n  work: () => Promise<T>,\n): Promise<T | undefined> => {\n  try {\n    return await work()\n  } catch (error) {\n    if (!(error instanceof AmbiguousModelError)) throw error\n    logger(`Skipping seed ${seed.seedLocalId ?? seed.seedUid} in ${context}: ${error.message}`)\n    const payload: ModelAmbiguousEventPayload = {\n      modelName: error.modelName,\n      schemaNames: error.schemaNames,\n      seedLocalId: seed.seedLocalId ?? undefined,\n      seedUid: seed.seedUid ?? undefined,\n      context,\n    }\n    eventEmitter.emit(MODEL_AMBIGUOUS_EVENT, payload)\n    return undefined\n  }\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,MAAM,GAAG,KAAK,CAAC,2CAA2C,CAAC;AAEjE;AACO,MAAM,qBAAqB,GAAG;AAoBrC;;;;;;;;;AASG;MACU,yBAAyB,GAAG,OAAO,KAAqB,KAAiC;AACpG,IAAA,OAAO,SAAS;AAClB;AAEA;;;;AAIG;AACI,MAAM,wBAAwB,GAAG,OACtC,IAA8D,EAC9D,OAAe,EACf,IAAsB,KACI;AAC1B,IAAA,IAAI;QACF,OAAO,MAAM,IAAI,EAAE;IACrB;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,IAAI,EAAE,KAAK,YAAY,mBAAmB,CAAC;AAAE,YAAA,MAAM,KAAK;AACxD,QAAA,MAAM,CAAC,CAAA,cAAA,EAAiB,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAA,IAAA,EAAO,OAAO,CAAA,EAAA,EAAK,KAAK,CAAC,OAAO,CAAA,CAAE,CAAC;AAC3F,QAAA,MAAM,OAAO,GAA+B;YAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;AAC9B,YAAA,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS;AAC1C,YAAA,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;YAClC,OAAO;SACR;AACD,QAAA,YAAY,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;AACjD,QAAA,OAAO,SAAS;IAClB;AACF;;"}

package/dist/seedSchema/PendingWriteSchema.ts

@@ -0,0 +1,57 @@
+import { index, int, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core'
+import { InferInsertModel, InferSelectModel } from 'drizzle-orm'
+
+/**
+ * The item write outbox (ADR 0019): one row per edit to an item, appended when the value is
+ * assigned and applied to `seeds`, `versions` and `metadata` by the leader tab's drainer.
+ */
+export const pendingWrites = sqliteTable(
+  'pending_writes',
+  {
+    id: int('id').primaryKey({ autoIncrement: true }),
+    /** Unique per op; the drainer and `save()` refer to an op by it. */
+    opId: text('op_id').notNull(),
+    /** Ops that apply together in one transaction (Item.create's seed, version and metadata rows). */
+    groupId: text('group_id'),
+    seedLocalId: text('seed_local_id').notNull(),
+    /** Null for ops on the seed itself (`create`, `delete`). */
+    propertyName: text('property_name'),
+    /** `create` | `set` | `delete` | `storage` */
+    kind: text('kind').notNull(),
+    /** JSON-encoded value. */
+    value: text('value'),
+    /** A staged file a `storage` op's value was written to, moved into place when it applies. */
+    valueRef: text('value_ref'),
+    /** The stored metadata row the edit was made against, to detect a synced row written since. */
+    baseRowId: text('base_row_id'),
+    baseUid: text('base_uid'),
+    createdAt: int('created_at').notNull(),
+    /** The tab that appended the op. */
+    tabId: text('tab_id'),
+    /** `pending` | `applied` | `superseded` | `failed`. An op is claimed and applied in one transaction. */
+    status: text('status').notNull(),
+    error: text('error'),
+    /** The name of the error that failed the op (`OwnershipError`, say), so a waiter can tell why. */
+    errorName: text('error_name'),
+    attempts: int('attempts').notNull().default(0),
+    appliedAt: int('applied_at'),
+    /** JSON the applier recorded when the op applied (for a `set`: the metadata row written). */
+    result: text('result'),
+    /** JSON: the synced value this op was applied over, when there was one (ADR 0019). */
+    conflict: text('conflict'),
+    conflictResolvedAt: int('conflict_resolved_at'),
+  },
+  (table) => ({
+    opIdUnique: uniqueIndex('pending_writes_op_id_unique').on(table.opId),
+    /** The drainer's order: per property, oldest first, among one status. */
+    drainOrder: index('pending_writes_drain_order').on(
+      table.status,
+      table.seedLocalId,
+      table.propertyName,
+      table.createdAt,
+    ),
+  }),
+)
+
+export type PendingWriteType = InferSelectModel<typeof pendingWrites>
+export type NewPendingWrite = InferInsertModel<typeof pendingWrites>

package/dist/seedSchema/index.ts

@@ -13,3 +13,4 @@ export * from './UploadProcessSchema'
 export * from './ArweaveL1FinalizeSchema'
 export * from './EasSyncProcessSchema'
 export * from './HtmlEmbeddedImageCoPublishSchema'
+export * from './PendingWriteSchema'

package/dist/src/Item/Item.d.ts

@@ -21,6 +21,24 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
     private static findItemInstanceCacheEntryById;
     private static collectInstanceCacheKeysForInstance;
     private static registerItemInInstanceCache;
+    /**
+     * Wraps a new instance in its reactive proxy: tracked names read from and write to the actor's
+     * context, and the model's property names (`item.title`, or `item.html` for `htmlId`) read and
+     * write their ItemProperty's value.
+     */
+    private static wrapInProxy;
+    /**
+     * The ItemProperty a model property name reads and writes on the item: by its name, or by its
+     * storage name (`html` finds `htmlId` and the other way round). Internal names don't resolve.
+     */
+    private _findPropertyInstance;
+    /** Every name `_findPropertyInstance` resolves: the stored names and their schema names. */
+    private _propertyInstanceNames;
+    /**
+     * Writes an assigned seed uid to the item's seed row, so later loads and getPublishPayload see it.
+     * Writes run one after another per item, so the last assignment is the one that stays.
+     */
+    private _persistSeedUid;
     /**
      * Sets a tracked context property from the proxy. Setting `seedUid` to a different uid means a
      * new seed attestation (publishing again after unpublish): the revocation belonged to the old
@@ -34,6 +52,11 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
      * `propertyInstances` is merged (an item with a version but no property instances yet).
      */
     private static isItemSnapshotReadyForRead;
+    /**
+     * The cached Item for a seedLocalId or seedUid, in any state, without taking a hold. For SDK code
+     * that reads or messages the item and doesn't hand it to a caller.
+     */
+    static peek(id: string | null | undefined): Item<any> | undefined;
     /**
      * The cached Item for a seedLocalId or seedUid when it can be read right now: idle and hydrated,
      * so at least what `Item.find()` would wait for. Otherwise undefined. Unlike `getById`, it takes
@@ -49,7 +72,11 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
     static create<_T extends ModelValues<ModelSchema>>(props: Partial<ItemData> & {
         modelInstance?: import('../Model/Model').Model;
     }, options?: ItemCreateOptions): Promise<Item<any>>;
-    /** Stops a just-created item and deletes what create wrote (see discardNewDraft). */
+    /**
+     * Stops a just-created item and deletes what create wrote: a `discard` outbox op (ADR 0019),
+     * applied after the item's other pending ops, hard-deletes the draft and the storage seeds its
+     * rows point at; their files go once it has applied.
+     */
     private static discardCreatedItem;
     /**
      * Run each File/Image/Html/ItemStorage initial value through its ItemProperty save pipeline (sequentially, to
@@ -91,6 +118,11 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
         modelFileId?: string;
         /** ... or the schema that defines it. */
         schemaName?: string;
+        /**
+         * Stops building items once aborted and rejects with the signal's reason. Items already
+         * built stay loaded.
+         */
+        signal?: AbortSignal;
     }): Promise<Item<any>[]>;
     /**
      * After EAS sync writes metadata for the latest version, merge new property instances and
@@ -99,12 +131,6 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
      */
     static rehydrateCachedItemsFromDbAfterEasSync(): Promise<void>;
     protected _createPropertyInstance(props: Partial<CreatePropertyInstanceProps>): void;
-    /**
-     * Defines a property accessor on this Item that delegates get/set to the
-     * ItemProperty in context.propertyInstances at access time (so the correct
-     * instance is used after loadOrCreateItemSuccess merges DB-backed instances).
-     */
-    protected _definePropertyAccessor(propertyName: string): void;
     /** Same as `item.publish(options)`; requires @seedprotocol/publish. */
     /** Keys Item.create accepts besides the model's properties. */
     private static readonly CREATE_METADATA_KEYS;
@@ -118,6 +144,11 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
     static publish(item: IItem<any>, options?: ItemPublishOptions): Promise<void>;
     subscribe: (callback: (itemProps: any) => void) => Subscription;
     getService: () => ActorRefFrom<typeof itemMachineSingle>;
+    /**
+     * The item's unresolved conflicts, one per property: local edits that were kept over a value
+     * sync wrote while they were pending (ADR 0019). Each property's is also on `property.conflict`.
+     */
+    conflicts: () => Promise<import("../outbox/conflicts").PropertyConflict[]>;
     getEditedProperties: () => Promise<PropertyData[]>;
     unpublish: () => Promise<void>;
     /**

package/dist/src/Item/Item.d.ts.map

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

package/dist/src/Item/service/itemMachineSingle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"itemMachineSingle.d.ts","sourceRoot":"","sources":["../../../../src/Item/service/itemMachineSingle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAI5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAG/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAqM5B,CAAA"}
+{"version":3,"file":"itemMachineSingle.d.ts","sourceRoot":"","sources":["../../../../src/Item/service/itemMachineSingle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAI5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAG/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAuM5B,CAAA"}

package/dist/src/ItemProperty/ItemProperty.d.ts

@@ -20,6 +20,13 @@ type ItemPropertyFindProps = {
     /** When metadata has no modelType, callers (e.g. Item) can pass modelName so ItemProperty.create can succeed */
     modelName?: string;
 };
+type ItemPropertyHoldOption = {
+    /**
+     * @internal false for SDK code that hands the instance to an owner that takes its own hold (an
+     * Item's property map): no hold is taken, and a new instance is cached with none.
+     */
+    hold?: false;
+};
 export declare class ItemProperty<PropertyType> implements IItemProperty<PropertyType> {
     protected static instanceCache: Map<string, {
         instance: ItemProperty<any>;
@@ -34,6 +41,8 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
     protected _dataType: string | undefined;
     /** Set while the value setter resolves a missing schema before sending `save`; save() awaits it. */
     protected _pendingSchemaSave: Promise<boolean> | undefined;
+    /** What showed before the first `showValue` since the last save; that save rolls back to it. */
+    protected _unsavedBefore: PropertyValueSnapshot | undefined;
     protected _schemaUid: string | undefined;
     /** Name passed to the constructor; the public name if the machine later moves to a List-of-relation storage name. */
     protected readonly _constructedPropertyName: string | undefined;
@@ -49,13 +58,22 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
      * receives the update and refreshes its propertyRecordSchema.
      */
     private _setupPropertySchemaLiveQuery;
+    /**
+     * The cached instance for this item and property, or a new one. Takes a hold on it: release it
+     * with `unload()`. An Item holds the properties in its own map and releases them when it unloads.
+     */
     static create(props: Partial<CreatePropertyInstanceProps>, options: {
         waitForReady: false;
-    }): ItemProperty<any> | undefined;
+    } & ItemPropertyHoldOption): ItemProperty<any> | undefined;
     static create(props: Partial<CreatePropertyInstanceProps>, options?: {
         waitForReady?: true;
         readyTimeout?: number;
-    }): Promise<ItemProperty<any> | undefined>;
+    } & ItemPropertyHoldOption): Promise<ItemProperty<any> | undefined>;
+    /**
+     * Wraps a new instance in its reactive proxy: tracked names read from and write to the actor's
+     * context, and assigning `value` also sends it to the actor before the setter runs.
+     */
+    private static wrapInProxy;
     /**
      * The cached ItemProperty when it can be read right now (idle, not saving), the state
      * `ItemProperty.find()` waits for. Otherwise undefined. Unlike `find`, it takes no cache hold, so
@@ -66,13 +84,15 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
         seedLocalId?: string;
         seedUid?: string;
     }): ItemProperty<any> | undefined;
-    static find({ propertyName, seedLocalId, seedUid, modelName: modelNameOption, waitForReady, readyTimeout, }: ItemPropertyFindProps & {
+    /** Takes a hold on the instance it returns: release it with `unload()`. */
+    static find({ propertyName, seedLocalId, seedUid, modelName: modelNameOption, waitForReady, readyTimeout, hold, }: ItemPropertyFindProps & {
         waitForReady?: boolean;
         readyTimeout?: number;
-    }): Promise<ItemProperty<any> | undefined>;
+    } & ItemPropertyHoldOption): Promise<ItemProperty<any> | undefined>;
     /**
      * Get all ItemProperty instances for an item.
      * Loads property data via getItemProperties, creates instances via create, optionally waits for idle.
+     * Takes a hold on each instance, as `create` does.
      */
     static all(params: {
         seedLocalId?: string;
@@ -80,10 +100,25 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
     }, options?: {
         waitForReady?: boolean;
         readyTimeout?: number;
-    }): Promise<ItemProperty<any>[]>;
+    } & ItemPropertyHoldOption): Promise<ItemProperty<any>[]>;
     find: typeof ItemProperty.find;
+    /**
+     * @internal Takes one more hold on a cached, running instance, released with `unload()`. False
+     * (and no hold) when the instance isn't cached or was stopped.
+     */
+    static retain(instance: IItemProperty<any>): boolean;
+    /**
+     * Stops an item's cached properties that nobody holds. Internal lookups cache a property without
+     * a hold for the item to take; one that finished after the item stopped (a liveQuery handler's
+     * find, say) never got that hold and would otherwise keep running. Called when the item stops.
+     */
+    static unloadUnheldForItem(seedIds: Array<string | null | undefined>): void;
     static cacheKey(seedLocalIdOrUid: string, propertyName: string): string;
-    /** Clears instance cache for an item (for test isolation when run in group). */
+    /**
+     * Drops an item's properties from the instance cache, under every key they're cached by. A dropped
+     * instance someone still holds keeps running but is detached: it doesn't re-key itself into the
+     * cache when its context changes, so the next lookup creates a fresh instance.
+     */
     static clearInstanceCacheForItem(seedLocalIdOrUid: string): void;
     getService(): import("xstate").ActorRef<import("xstate").MachineSnapshot<PropertyMachineContext, import("xstate").AnyEventObject, {
         [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../types").FromCallbackInput<PropertyMachineContext>, import("xstate").EventObject> | import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../types").FromCallbackInput<PropertyMachineContext, import("xstate").EventObject>, import("xstate").EventObject> | import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../types").FromCallbackInput<PropertyMachineContext, import("../types").SaveValueToDbEvent>, import("xstate").EventObject>> | undefined;
@@ -133,22 +168,43 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
     /** Validation errors from last failed save (enum, pattern, minLength, maxLength). Cleared when the next save starts. */
     get saveValidationErrors(): import('../Schema/validation').ValidationError[];
     get alias(): string | undefined;
+    /**
+     * The unresolved conflict between this property's last local edit and a value sync wrote while
+     * the edit was pending (ADR 0019): the local edit was kept, and `remoteValue` is what sync wrote.
+     * Null when there is none. Cleared by the next edit or `resolveConflict`.
+     */
+    get conflict(): import('../outbox/conflicts').PropertyConflict | null;
+    /**
+     * Settles `conflict`. `'local'` keeps the local edit. `'remote'` drops the local draft, so the
+     * synced value shows again (and publish has nothing to send for this property).
+     */
+    resolveConflict(choice: 'local' | 'remote'): Promise<void>;
     get value(): any;
     set value(value: any);
     /**
      * Shows `value` at once and saves it; `await property.save()` to wait for the result. Unlike
      * assigning `property.value`, it saves even when `value` is already in context.
      *
-     * @param options.before - The values to restore if the save is refused or fails. Defaults to the
-     *   current context; pass it when you already put `value` into context (a debounced input, say),
-     *   so a refusal still rolls back to what was there before.
+     * @param options.before - The values to restore if the save is refused or fails. Defaults to what
+     *   showed before the first `showValue` since the last save, else the current context.
      */
     setValue(value: any, options?: {
         before?: PropertyValueSnapshot;
     }): void;
+    /**
+     * Shows `value` without saving it, for input that saves later (a debounced text field). The next
+     * `setValue` or assignment saves, and if that save is refused or fails, the property goes back to
+     * what showed before the first `showValue`.
+     */
+    showValue(value: any): void;
     get published(): boolean;
     subscribe(callback: Partial<Subscriber<any>>): Subscription;
     save(): Promise<void>;
+    /**
+     * Every cache key holding this instance: its item's local id and seed uid, and the name it had
+     * before a rename (List of relation). They share one entry.
+     */
+    private _cacheKeys;
     unload(): void;
     /**
      * Destroy the item property: remove from caches, delete its metadata rows (every version of
@@ -156,6 +212,7 @@ export declare class ItemProperty<PropertyType> implements IItemProperty<Propert
      * Throws OwnershipError if none of the client's addresses own the item.
      */
     destroy(): Promise<void>;
+    private _destroyRows;
 }
 export {};
 //# sourceMappingURL=ItemProperty.d.ts.map

package/dist/src/ItemProperty/ItemProperty.d.ts.map

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

package/dist/src/ItemProperty/service/actors/hydrateFromDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrateFromDb.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/hydrateFromDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAMlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAkBzD,eAAO,MAAM,aAAa,uHAwUxB,CAAA"}
+{"version":3,"file":"hydrateFromDb.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/hydrateFromDb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAMlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAkBzD,eAAO,MAAM,aAAa,uHAqVxB,CAAA"}

package/dist/src/ItemProperty/service/actors/loadOrCreateProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadOrCreateProperty.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/loadOrCreateProperty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AA0BzD,eAAO,MAAM,oBAAoB,0GA8Y/B,CAAA"}
+{"version":3,"file":"loadOrCreateProperty.d.ts","sourceRoot":"","sources":["../../../../../src/ItemProperty/service/actors/loadOrCreateProperty.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AA0BzD,eAAO,MAAM,oBAAoB,0GAqZ/B,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/analyzeInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyzeInput.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/analyzeInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAqBzB,eAAO,MAAM,YAAY,8HA0OvB,CAAA"}
+{"version":3,"file":"analyzeInput.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/analyzeInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAczB,eAAO,MAAM,YAAY,8HAyPvB,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/saveFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveFile.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAazB;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB9G;AAED,eAAO,MAAM,QAAQ,8HAuMnB,CAAA"}
+{"version":3,"file":"saveFile.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAYzB;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB9G;AAED,eAAO,MAAM,QAAQ,8HAqMnB,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/saveHtml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveHtml.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveHtml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAYzB,eAAO,MAAM,QAAQ,8HAiJnB,CAAA"}
+{"version":3,"file":"saveHtml.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveHtml.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAWzB,eAAO,MAAM,QAAQ,8HA8InB,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/saveImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveImage.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveImage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAwBzB,eAAO,MAAM,SAAS,8HAyOpB,CAAA"}
+{"version":3,"file":"saveImage.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveImage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAuBzB,eAAO,MAAM,SAAS,8HAyOpB,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/saveItemStorage.d.ts

@@ -1,5 +1,10 @@
 import { EventObject } from 'xstate';
 import { FromCallbackInput } from '../../../../types/machines';
 import { PropertyMachineContext, SaveValueToDbEvent } from '../../../../types/property';
+/**
+ * Saves an ItemStorage value: the content goes to a staging file, and an outbox op (ADR 0019) moves
+ * it into the item's file and points the property's local draft row at it (see
+ * applyItemStorageValue for which row).
+ */
 export declare const saveItemStorage: import("xstate").CallbackActorLogic<EventObject, FromCallbackInput<PropertyMachineContext, SaveValueToDbEvent>, EventObject>;
 //# sourceMappingURL=saveItemStorage.d.ts.map

package/dist/src/ItemProperty/service/actors/saveValueToDb/saveItemStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saveItemStorage.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveItemStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAsBzB,eAAO,MAAM,eAAe,8HAsM1B,CAAA"}
+{"version":3,"file":"saveItemStorage.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/saveItemStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAEL,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAWzB;;;;GAIG;AACH,eAAO,MAAM,eAAe,8HA6F1B,CAAA"}

package/dist/src/ItemProperty/service/actors/saveValueToDb/storageValue.d.ts

@@ -0,0 +1,22 @@
+import type { PropertyMachineContext } from '../../../../types/property';
+import type { ItemStorageValueOp, StorageValueOp, SetPropertyValueResult } from '../../../../outbox/itemAppliers';
+import type { PropertyWriteTicket } from '../../../../helpers/propertyWriteTickets';
+/**
+ * Writes a storage value (Html, File, Image, ItemStorage) through the outbox (ADR 0019) and waits
+ * until it is applied. The value's file (or staged file) is already written. Skipped (the context
+ * is left alone) when a newer value of the property superseded it; that value's save sets the
+ * context instead, as is a save that a newer save of the property (in this tab) started after:
+ * its file is deleted and nothing is appended. `result` is what the op's applier returned.
+ */
+export declare function writeStorageValue<Result extends SetPropertyValueResult = SetPropertyValueResult>(item: {
+    seedLocalId?: string | null;
+    seedUid?: string | null;
+    propertyName: string;
+}, value: StorageValueOp | ItemStorageValueOp, ticket: PropertyWriteTicket | undefined): Promise<{
+    skipped: true;
+} | {
+    skipped: false;
+    row: Partial<PropertyMachineContext>;
+    result: Result | undefined;
+}>;
+//# sourceMappingURL=storageValue.d.ts.map

package/dist/src/ItemProperty/service/actors/saveValueToDb/storageValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageValue.d.ts","sourceRoot":"","sources":["../../../../../../src/ItemProperty/service/actors/saveValueToDb/storageValue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGvG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAczE;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EACpG,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACpF,KAAK,EAAE,cAAc,GAAG,kBAAkB,EAC1C,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACtC,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA0BnH"}

package/dist/src/ItemProperty/service/propertyMachine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"propertyMachine.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/propertyMachine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AA6DpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAuT1B,CAAA"}
+{"version":3,"file":"propertyMachine.d.ts","sourceRoot":"","sources":["../../../../src/ItemProperty/service/propertyMachine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AA6DpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAyT1B,CAAA"}

package/dist/src/Model/Model.d.ts

@@ -86,6 +86,8 @@ export declare class Model {
         waitForReady: false;
         /** @internal Schema import: see the implementation signature */
         persistedBy?: Promise<unknown>;
+        /** @internal SDK lookups pass false: see the implementation signature */
+        hold?: false;
     }): Model;
     static create(modelName: string, schemaNameOrSchema: string | any, options?: {
         id?: string;
@@ -96,24 +98,58 @@ export declare class Model {
         registerWithSchema?: boolean;
         waitForReady?: true;
         readyTimeout?: number;
+        /** @internal SDK lookups pass false: see the implementation signature */
+        hold?: false;
     }): Promise<Model>;
     /**
-     * Get Model instance by modelFileId (O(1) lookup)
+     * Get Model instance by modelFileId (O(1) lookup). Takes a hold on the instance; release it with
+     * `unload()`.
      */
     static getById(modelFileId: string): Model | undefined;
     /**
-     * Get Model instance by name (O(1) lookup via name→ID mapping)
+     * Models their schema holds, by modelFileId. A schema's first load of a model takes one hold for
+     * the schema, and the schema's last unload releases it (releaseSchemaHolds), so a user's unload
+     * can't drop a model out of `schema.models` while the schema is loaded.
+     */
+    private static schemaHeldModelIds;
+    /**
+     * @internal For a Schema loading its models: true when this load should take the schema's hold
+     * on the model (pass no `hold` option), false when the schema already holds it (pass
+     * `hold: false`). After a true, call `dropSchemaHold` if the load returns no model.
+     */
+    static takeSchemaHold(modelFileId: string | undefined): boolean;
+    /** @internal The load `takeSchemaHold` approved found no model: there is no hold to release. */
+    static dropSchemaHold(modelFileId: string): void;
+    /** @internal A Schema's last unload: releases its hold on each of its models. */
+    static releaseSchemaHolds(schemaName: string): void;
+    /**
+     * The cached Model with this modelFileId, without taking a hold. For SDK code that reads the
+     * model and doesn't hand it to a caller; callers that keep it use `getById`, `find` or `create`.
+     */
+    static peek(modelFileId: string): Model | undefined;
+    /**
+     * Get Model instance by name (O(1) lookup via name→ID mapping). Takes a hold on the instance;
+     * release it with `unload()`.
      *
      * @param modelName - The name of the model
      * @param schemaName - The schema name (optional, will query DB if not provided)
      * @returns The Model instance if found, undefined otherwise
      */
     static getByName(modelName: string, schemaName?: string): Model | undefined;
-    /** The one cached Model whose name matches, or AmbiguousModelError if models from several schemas do. */
+    /**
+     * `getByName` without taking a hold. Without `schemaName` it searches every cached schema and
+     * throws AmbiguousModelError when models from several schemas share the name; callers that know
+     * the schema or model id should use Model.resolve() instead.
+     */
+    static peekByName(modelName: string, schemaName?: string): Model | undefined;
+    /**
+     * The one cached Model whose name matches (no hold taken), or AmbiguousModelError if models from
+     * several schemas do.
+     */
     private static _getUniqueCachedModel;
     /**
      * Resolve a cached Model from the most specific scope available: modelFileId (Model.id), then
-     * schemaName + modelName, then modelName alone.
+     * schemaName + modelName, then modelName alone. Takes no hold.
      */
     static resolve(modelName: string | undefined, scope?: {
         modelFileId?: string | null;
@@ -123,17 +159,17 @@ export declare class Model {
      * Find Model by modelType (an EAS model name, as seeds.type stores it). Matched as ADR 0008
      * matches EAS names: `new_model` finds "New model", and `htmlpage` (an older SDK's name) finds
      * "HTMLPage", unless HTMLPage's nameMatch (ADR 0009) is `exact`. Only the tightest matching tier
-     * counts; matches in several schemas are ambiguous.
+     * counts; matches in several schemas are ambiguous. Takes no hold.
      */
     static findByModelType(modelType: string): Model | undefined;
     /**
-     * Get all Model instances for a schema from cache only (synchronous).
+     * Get all Model instances for a schema from cache only (synchronous). Takes no holds.
      * Includes models created at runtime via Model.create() that may not yet be in schema context.
      */
     static getCachedInstancesForSchema(schemaName: string): Model[];
     /**
      * Async Model.resolve(): exact cache hit by modelFileId or schemaName+modelName, else the DB row for
-     * that scope (instantiating the Model), and only then the name-only fallback.
+     * that scope (instantiating the Model), and only then the name-only fallback. Takes no hold.
      */
     static resolveAsync(modelName: string | undefined, scope?: {
         modelFileId?: string | null;
@@ -145,7 +181,7 @@ export declare class Model {
      *
      * @param modelName - The name of the model
      * @param schemaName - Optional schema name (will query DB if not provided)
-     * @returns The Model instance if found, undefined otherwise
+     * @returns The Model instance if found, undefined otherwise. Takes a hold unless `hold: false`.
      */
     static getByNameAsync(modelName: string, schemaName?: string, options?: {
         /**
@@ -153,6 +189,8 @@ export declare class Model {
          * schema since then makes this return undefined instead of re-creating the model. Defaults to now.
          */
         evictionEpoch?: number;
+        /** @internal `hold: false` as for `create` */
+        hold?: false;
     }): Promise<Model | undefined>;
     /**
      * Create or get Model instance by modelFileId
@@ -168,6 +206,8 @@ export declare class Model {
          * of re-creating the model. Defaults to now.
          */
         evictionEpoch?: number;
+        /** @internal `hold: false` as for `create` */
+        hold?: false;
     }): Promise<Model | undefined>;
     /**
      * Find Model instance by modelFileId, modelName/schemaName, or both
@@ -194,7 +234,8 @@ export declare class Model {
      * Get all Model instances, optionally filtered by schema.
      * When DB is available, loads from DB via getModelsData; otherwise returns from cache.
      * With waitForReady, waits for each model to be ready (idle, with any properties from Model.create
-     * created) and leaves out models that error or time out.
+     * created) and leaves out models that error or time out. Takes no holds: a caller that keeps a
+     * model uses `Model.find` or `Model.create`.
      */
     static all(schemaName?: string, options?: {
         waitForReady?: boolean;