@seedprotocol/sdk 0.7.0 → 0.7.2-next.593.gd5bd4ea

package/dist/{Item-zBFWQDU9.js → Item-B9Y4VuK1.js}

@@ -1,16 +1,15 @@
 import { waitFor, fromCallback, setup, assign, stateIn, createActor, isMachineSnapshot } from 'xstate';
-import { B as BaseDb, v as versions, b as metadata, r as seeds, s as schemas, m as models, i as modelSchemas, Z as ZERO_BYTES32, y as INTERNAL_PROPERTY_NAMES, a as BaseFileManager, D as ImageSize, p as properties, A as INTERNAL_DATA_TYPES, j as modelUids, C as INTERNAL_STORAGE_MODEL_FILE_IDS, P as PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP } from './BasePathResolver-ndE8XTpw.js';
+import { a as BaseDb, v as versions, m as metadata, r as seeds, s as schemas, j as models, g as modelSchemas, Z as ZERO_BYTES32, I as INTERNAL_PROPERTY_NAMES, B as BaseFileManager, D as ImageSize, p as properties, x as INTERNAL_DATA_TYPES, i as modelUids, C as INTERNAL_STORAGE_MODEL_FILE_IDS, P as PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP } from './BasePathResolver-BdxCSIzn.js';
 import { or, isNull, eq, max, count, and, getTableColumns, sql, desc, inArray, isNotNull, gt } from 'drizzle-orm';
 import pluralize from 'pluralize';
-import { n as normalizeDataType, W as getOwnedAddressesFromDb, E as normalizeAddressList, u as normalizeHexAddress, z as getAddressesForItemsFilter, k as isDataType, s as normalizePublisher, M as ModelPropertyDataTypes, q as resolveItemModelFileId, X as getPropertyIdForSchemaFileId, p as getPropertyIdForModelAndName, l as normalizePropertyRecordSchema, o as eventEmitter } from './db-BJZN0a0a.js';
+import { n as normalizeDataType, W as getOwnedAddressesFromDb, E as normalizeAddressList, u as normalizeHexAddress, z as getAddressesForItemsFilter, k as isDataType, s as normalizePublisher, M as ModelPropertyDataTypes, r as resolveItemModelFileId, X as getPropertyIdForSchemaFileId, o as getPropertyIdForModelAndName, l as normalizePropertyRecordSchema, m as eventEmitter } from './db-W1g29qsM.js';
 import debug from 'debug';
 import { BehaviorSubject } from 'rxjs';
 import { startCase, upperFirst, camelCase, orderBy } from 'lodash-es';
 import { toSnakeCase } from 'drizzle-orm/casing';
 import { isValidEasAttestationUid, isPlaceholderUid, BaseQueryClient, BaseEasClient, GET_SCHEMAS, getEasSchemaUidForSchemaDefinition, getSchemaUidForModelFromCache, cachedSchemaLookup, setSchemaUidForModel, getEasSchemaUidForExactDefinition } from '@seedprotocol/eas';
-import { t as toSnakeCase$1, G as getStorageTransactionIdForSeedUid, H as convertTxIdToImage, f as ensureImageLocal, I as downloadTransactionIdWithDedupe, J as getDataTypeFromString, K as getMimeType, M as notifyFileSaved, g as getCorrectId, a as isStorageSeedRef } from './tabEvents-DYI2GU7i.js';
+import { t as toSnakeCase$1, H as getStorageTransactionIdForSeedUid, I as convertTxIdToImage, h as ensureImageLocal, J as downloadTransactionIdWithDedupe, b as generateId, K as getDataTypeFromString, M as getMimeType, N as notifyFileSaved, g as getCorrectId, a as isStorageSeedRef } from './tabEvents-C9qUKx_z.js';
 import { fetchArweaveRawTextAcrossGateways } from '@seedprotocol/arweave';
-import { generateId } from './generateId-BopUwD8F.js';
 import { modelPropertiesToObject } from './model-DGMe-TTm.js';
 
 /**
@@ -709,8 +708,8 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
         const itemPropertyMod = await Promise.resolve().then(function () { return ItemProperty$1; });
         const { ItemProperty } = itemPropertyMod;
         const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
-        const _mod_0 = await import('./index-DtfjeuxC.js');
-        const _ns_0 = _mod_0.c;
+        const _mod_0 = await import('./index-DRXC5Mra.js');
+        const _ns_0 = _mod_0.f;
         const { Model } = _ns_0;
         // Resolve Model and build property schemas (use getByNameAsync for models not yet in cache)
         let propertySchemas = {};
@@ -727,7 +726,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             const schemaNameToTry = schemaName ?? model?.schemaName;
             if (schemaNameToTry) {
                 try {
-                    const _mod_1 = await import('./Schema-DOhlrQ-N.js');
+                    const _mod_1 = await import('./Schema-COsEXXaR.js');
                     const _ns_1 = _mod_1.b;
                     const { Schema } = _ns_1;
                     const schemaInstance = Schema.create(schemaNameToTry, { waitForReady: false });
@@ -743,7 +742,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
             if (Object.keys(propertySchemas).length === 0) {
                 try {
-                    const _mod_2 = await import('./ClientManager-DLleL_2e.js');
+                    const _mod_2 = await import('./ClientManager-ClCwwhwo.js');
                     const _ns_2 = _mod_2.G;
                     const { loadAllSchemasFromDb } = _ns_2;
                     const allSchemas = await loadAllSchemasFromDb();
@@ -764,10 +763,10 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
             if (Object.keys(propertySchemas).length === 0) {
                 try {
-                    const _mod_3 = await import('./ClientManager-DLleL_2e.js');
+                    const _mod_3 = await import('./ClientManager-ClCwwhwo.js');
                     const _ns_3 = _mod_3.G;
                     const { listCompleteSchemaFiles } = _ns_3;
-                    const _mod_4 = await import('./BasePathResolver-ndE8XTpw.js');
+                    const _mod_4 = await import('./BasePathResolver-BdxCSIzn.js');
                     const _ns_4 = _mod_4.O;
                     const { BaseFileManager } = _ns_4;
                     const schemaFiles = await listCompleteSchemaFiles();
@@ -788,7 +787,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
                 }
             }
             if (Object.keys(propertySchemas).length === 0) {
-                const schemaMod = await import('./index-6bJuv5Tt.js');
+                const schemaMod = await import('./index-Bev-hZF-.js');
                 const { ModelPropertyDataTypes } = schemaMod;
                 const KNOWN_MODEL_FALLBACKS = {
                     Post: {
@@ -805,7 +804,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
             }
         }
         // Fallbacks above may return schema-file shape ({ type, model, items }); normalize to dataType/ref/refValueType.
-        const { normalizePropertyRecordSchema } = await import('./property-D2Nnsmm1.js');
+        const { normalizePropertyRecordSchema } = await import('./property-BT1zDSkd.js');
         propertySchemas = Object.fromEntries(Object.entries(propertySchemas).map(([name, def]) => [name, normalizePropertyRecordSchema(def)]));
         // Collapse rows that map to the same instance key (e.g. authorIdentityIds + authors -> authors).
         // ItemProperty.create cache does not sync propertyValue on hit; processing order would otherwise
@@ -838,7 +837,7 @@ const createItemPropertyInstances = async (metadataRows, seedLocalId, seedUid, m
                 // Infer propertyRecordSchema from metadata when schema is missing (enables persistence)
                 let propSchema = propertySchemas[propertyName];
                 if (!propSchema && isRefTypeFromMeta) {
-                    const schemaMod = await import('./index-6bJuv5Tt.js');
+                    const schemaMod = await import('./index-Bev-hZF-.js');
                     const { ModelPropertyDataTypes } = schemaMod;
                     propSchema = {
                         dataType: refSeedType === 'html' ? ModelPropertyDataTypes.Html
@@ -1105,9 +1104,9 @@ const runPublish = fromCallback(({ sendBack, input: { context } }) => {
                 sendBack({ type: 'publishError', error: new Error(`Item not found for seedLocalId: ${seedLocalId}`) });
                 return;
             }
-            const getPublishUploadsMod = await import('./getPublishUploads-CR66RlGJ.js');
+            const getPublishUploadsMod = await import('./getPublishUploads-BGpDsrBp.js');
             const { getPublishUploads } = getPublishUploadsMod;
-            const _mod_5 = await import('./getPublishPayload-H032DHC7.js');
+            const _mod_5 = await import('./getPublishPayload-D5CQZd-y.js');
             const _ns_5 = _mod_5.g;
             const getPublishPayloadMod = _ns_5;
             const { getPublishPayload } = getPublishPayloadMod;
@@ -1808,7 +1807,7 @@ const getItemsData = async ({ modelName, modelFileId, schemaName, deleted, inclu
         conditions.push(eq(seeds.type, toSnakeCase(modelName)));
     }
     if (!modelFileId && schemaName && modelName) {
-        const _mod_6 = await import('./db-BJZN0a0a.js');
+        const _mod_6 = await import('./db-W1g29qsM.js');
         const _ns_6 = _mod_6.Y;
         const { resolveModelRecord } = _ns_6;
         modelFileId = (await resolveModelRecord(modelName, { schemaName }))?.schemaFileId ?? undefined;
@@ -1874,6 +1873,29 @@ const getItemsData = async ({ modelName, modelFileId, schemaName, deleted, inclu
     });
 };
 
+/**
+ * The seed's head version row: newest by (created_at DESC, local_id DESC), attested or not, skipping
+ * revoked versions. Null when the seed has no version or every version is revoked (a fully
+ * unpublished item). Same choice as `latestVersionLocalId` in the `getVersionData` subquery.
+ */
+async function getLatestVersionRow(seedLocalId) {
+    const appDb = BaseDb.getAppDb();
+    if (!appDb || !seedLocalId)
+        return null;
+    const rows = await appDb
+        .select({
+        localId: versions.localId,
+        uid: versions.uid,
+        createdAt: versions.createdAt,
+        attestationCreatedAt: versions.attestationCreatedAt,
+    })
+        .from(versions)
+        .where(and(eq(versions.seedLocalId, seedLocalId), versionNotRevoked()))
+        .orderBy(desc(versions.createdAt), desc(versions.localId))
+        .limit(1);
+    return rows[0] ?? null;
+}
+
 const logger$5 = debug('seedSdk:ItemProperty:service:actors:waitForDb');
 const waitForDb = fromCallback(({ sendBack }) => {
     // Check immediately first
@@ -2068,7 +2090,7 @@ const resolveRelatedValue = fromCallback(({ sendBack, input: { context } }) => {
     const { isRelation, propertyValue, propertyName, seedUid, propertyRecordSchema, populatedFromDb, schemaUid, } = context;
     const _resolveRelatedValue = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-6bJuv5Tt.js');
+        const schemaMod = await import('./index-Bev-hZF-.js');
         const { ModelPropertyDataTypes } = schemaMod;
         if (!propertyValue || !isRelation || populatedFromDb) {
             return;
@@ -2503,8 +2525,8 @@ async function readHtmlBodyFromChildStorageArweave(seedLocalId) {
         /* offline / bad tx id */
     }
     try {
-        const _mod_7 = await import('./tabEvents-DYI2GU7i.js');
-        const _ns_7 = _mod_7.N;
+        const _mod_7 = await import('./tabEvents-C9qUKx_z.js');
+        const _ns_7 = _mod_7.O;
         const { downloadTransactionIdWithDedupe } = _ns_7;
         await downloadTransactionIdWithDedupe(txId);
         const retryFp = BaseFileManager.getFilesPath('html', `${seedLocalId}.html`);
@@ -2564,7 +2586,7 @@ const hydrateFromDb = fromCallback(({ sendBack, input: { context } }) => {
     // to use dynamically imported ModelPropertyDataTypes
     const _hydrateFromDb = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-6bJuv5Tt.js');
+        const schemaMod = await import('./index-Bev-hZF-.js');
         const { ModelPropertyDataTypes } = schemaMod;
         const appDb = BaseDb.getAppDb();
         const whereClauses = [];
@@ -2843,11 +2865,11 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
             const modelNameForNew = context.modelName;
             if (modelNameForNew) {
                 try {
-                    const _mod_8 = await import('./index-DtfjeuxC.js');
-                    const _ns_8 = _mod_8.c;
+                    const _mod_8 = await import('./index-DRXC5Mra.js');
+                    const _ns_8 = _mod_8.f;
                     const { Model } = _ns_8;
                     const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
-                    const _mod_9 = await import('./db-BJZN0a0a.js');
+                    const _mod_9 = await import('./db-W1g29qsM.js');
                     const _ns_9 = _mod_9.Y;
                     const { resolveItemModelFileId } = _ns_9;
                     const normalizedModelName = upperFirst(camelCase(modelNameForNew));
@@ -2901,7 +2923,7 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
         // It ends up in the context below, and later lookups by name (Model.getByName) can't match it.
         const modelName = context.modelName || (metadataRecord.modelType ? upperFirst(camelCase(metadataRecord.modelType)) : undefined);
         // Model names are only unique per schema: pin lookups to the item's own model row.
-        const _mod_10 = await import('./db-BJZN0a0a.js');
+        const _mod_10 = await import('./db-W1g29qsM.js');
         const _ns_10 = _mod_10.Y;
         const { resolveItemModelFileId, resolveModelRecord } = _ns_10;
         const modelFileId = await resolveItemModelFileId({
@@ -2947,16 +2969,16 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
                         };
                         // Merge with schema from file/DB to get validation rules (enum, pattern, etc.) - properties table doesn't store these
                         try {
-                            const { getPropertySchema } = await import('./property-D2Nnsmm1.js');
+                            const { getPropertySchema } = await import('./property-BT1zDSkd.js');
                             let schemaFromFile = await getPropertySchema(normalizedModelName, propertyName, {
                                 modelFileId: modelRecord?.schemaFileId ?? modelFileId,
                             });
                             if (!schemaFromFile?.validation) {
                                 // Fallback: get validation from schemaData in database (Schema context may not be loaded yet)
-                                const _mod_11 = await import('./BasePathResolver-ndE8XTpw.js');
+                                const _mod_11 = await import('./BasePathResolver-BdxCSIzn.js');
                                 const _ns_11 = _mod_11.Q;
                                 const { schemas: schemasTable } = _ns_11;
-                                const _mod_12 = await import('./BasePathResolver-ndE8XTpw.js');
+                                const _mod_12 = await import('./BasePathResolver-BdxCSIzn.js');
                                 const _ns_12 = _mod_12.R;
                                 const { modelSchemas } = _ns_12;
                                 const modelSchemaRows = await db
@@ -2997,8 +3019,8 @@ const loadOrCreateProperty = fromCallback(({ sendBack, input: { context } }) =>
         }
         if (!propertyRecordSchema && modelName) {
             try {
-                const _mod_13 = await import('./index-DtfjeuxC.js');
-                const _ns_13 = _mod_13.c;
+                const _mod_13 = await import('./index-DRXC5Mra.js');
+                const _ns_13 = _mod_13.f;
                 const { Model } = _ns_13;
                 const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
                 const normalizedModelName = upperFirst(camelCase(modelName));
@@ -3374,9 +3396,9 @@ const analyzeInput = fromCallback(({ sendBack, input: { context, event } }) => {
     }
     const _analyzeInput = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-6bJuv5Tt.js');
+        const schemaMod = await import('./index-Bev-hZF-.js');
         const { ModelPropertyDataTypes } = schemaMod;
-        const { SchemaValidationService } = await import('./SchemaValidationService-DDKr5piy.js');
+        const { SchemaValidationService } = await import('./SchemaValidationService-DabGMzSE.js');
         let propertyName = propertyNameRaw;
         if (!propertyName) {
             throw new Error('propertyName is required');
@@ -3666,7 +3688,7 @@ const createMetadata = async (metadataValues, propertyRecordSchema, options) =>
         propertyRecordSchema?.validation &&
         metadataValues.propertyValue != null &&
         metadataValues.propertyValue !== '') {
-        const { SchemaValidationService } = await import('./SchemaValidationService-DDKr5piy.js');
+        const { SchemaValidationService } = await import('./SchemaValidationService-DabGMzSE.js');
         const validationService = new SchemaValidationService();
         const validationResult = validationService.validatePropertyValue(metadataValues.propertyValue, normalizeDataType(propertyRecordSchema.dataType), propertyRecordSchema.validation, propertyRecordSchema.refValueType
             ? normalizeDataType(String(propertyRecordSchema.refValueType))
@@ -4248,7 +4270,7 @@ const saveRelation = fromCallback(({ sendBack, input: { context, event } }) => {
     }
     const _saveRelation = async () => {
         // Use dynamic import to break circular dependency
-        const schemaMod = await import('./index-6bJuv5Tt.js');
+        const schemaMod = await import('./index-Bev-hZF-.js');
         const { ModelPropertyDataTypes } = schemaMod;
         if (!propertyNameRaw) {
             throw new Error('propertyName is required');
@@ -4812,10 +4834,10 @@ const getPropertyData = async ({ propertyName, seedLocalId, seedUid, modelName,
     let names = [...getMetadataPropertyNamesForQuery(propertyName)];
     if (modelName) {
         try {
-            const _mod_14 = await import('./index-DtfjeuxC.js');
-            const _ns_14 = _mod_14.c;
+            const _mod_14 = await import('./index-DRXC5Mra.js');
+            const _ns_14 = _mod_14.f;
             const { Model } = _ns_14;
-            const _mod_15 = await import('./db-BJZN0a0a.js');
+            const _mod_15 = await import('./db-W1g29qsM.js');
             const _ns_15 = _mod_15.Y;
             const { resolveItemModelFileId } = _ns_15;
             // Model names are only unique per schema: use the seed's own model when it is recorded.
@@ -5006,7 +5028,7 @@ const HTML_PROP_SEED_UID_RE = /^0x[a-fA-F0-9]{64}$/;
  */
 const resolvePropertyRecordSchemaFromSchemaData = async (modelName, propertyName, modelType, schemaName) => {
     try {
-        const _mod_16 = await import('./ClientManager-DLleL_2e.js');
+        const _mod_16 = await import('./ClientManager-ClCwwhwo.js');
         const _ns_16 = _mod_16.G;
         const { loadAllSchemasFromDb } = _ns_16;
         const allSchemas = await loadAllSchemasFromDb();
@@ -5060,11 +5082,11 @@ hints = {}) => {
         return undefined;
     }
     try {
-        const _mod_17 = await import('./index-DtfjeuxC.js');
-        const _ns_17 = _mod_17.c;
+        const _mod_17 = await import('./index-DRXC5Mra.js');
+        const _ns_17 = _mod_17.f;
         const { Model } = _ns_17;
         const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
-        const _mod_18 = await import('./db-BJZN0a0a.js');
+        const _mod_18 = await import('./db-W1g29qsM.js');
         const _ns_18 = _mod_18.Y;
         const { resolveItemModelFileId } = _ns_18;
         const modelFileId = await resolveItemModelFileId(hints);
@@ -5224,7 +5246,7 @@ class ItemProperty {
                 return;
             }
             // Use dynamic import to break circular dependency
-            const schemaMod = await import('./index-6bJuv5Tt.js');
+            const schemaMod = await import('./index-Bev-hZF-.js');
             const { ModelPropertyDataTypes } = schemaMod;
             const { context } = snapshot;
             const { propertyRecordSchema } = context;
@@ -5395,7 +5417,7 @@ class ItemProperty {
                 const normalizedRefValueType = normalizeDataType(propertyRecordSchema?.refValueType);
                 const propertyNames = getMetadataPropertyNamesForQuery(propertyName, normalizedDataType, normalizedRefValueType);
                 const propertyNameVariant = propertyNames.length > 1 ? propertyNames[1] : undefined;
-                const _mod_19 = await import('./index-B0LgJblD.js');
+                const _mod_19 = await import('./index-CSOQFAOn.js');
                 const _ns_19 = _mod_19.s;
                 const seedSchemaMod = _ns_19;
                 const { metadata } = seedSchemaMod;
@@ -5611,7 +5633,7 @@ class ItemProperty {
             const ctx = this._service.getSnapshot().context;
             let modelFileId;
             try {
-                const _mod_20 = await import('./db-BJZN0a0a.js');
+                const _mod_20 = await import('./db-W1g29qsM.js');
                 const _ns_20 = _mod_20.Y;
                 const { resolveItemModelFileId } = _ns_20;
                 modelFileId = await resolveItemModelFileId({
@@ -5889,6 +5911,29 @@ class ItemProperty {
             return result;
         return waitForEntityIdle(result, { timeout: readyTimeout }).then(() => result);
     }
+    /**
+     * 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
+     * React hooks can call it during render.
+     */
+    static peekReady({ propertyName, seedLocalId, seedUid, }) {
+        if (!propertyName)
+            return undefined;
+        // Same key order as find(), then the other id: instances are cached under both when both are known.
+        const keys = [seedUid, seedLocalId]
+            .filter((id) => typeof id === 'string' && id.length > 0)
+            .map((id) => this.cacheKey(id, propertyName));
+        for (const key of keys) {
+            const instance = this.instanceCache.get(key)?.instance;
+            if (!instance)
+                continue;
+            const snap = instance.getService().getSnapshot();
+            if (snap.status !== 'active' || snap.value !== 'idle' || snap.context?.isSaving)
+                return undefined;
+            return instance;
+        }
+        return undefined;
+    }
     static async find({ propertyName, seedLocalId, seedUid, modelName: modelNameOption, waitForReady = true, readyTimeout = 5000, }) {
         if ((!seedLocalId && !seedUid) || !propertyName) {
             return undefined;
@@ -5951,7 +5996,7 @@ class ItemProperty {
         const propertiesData = await getItemProperties({ seedLocalId, seedUid });
         const instances = [];
         const seenNormalized = new Set();
-        const _mod_21 = await import('./db-BJZN0a0a.js');
+        const _mod_21 = await import('./db-W1g29qsM.js');
         const _ns_21 = _mod_21.Y;
         const { resolveItemModelFileId } = _ns_21;
         const itemModelFileId = await resolveItemModelFileId({ seedLocalId, seedUid });
@@ -5969,8 +6014,8 @@ class ItemProperty {
             }
             else if (baseName) {
                 try {
-                    const _mod_22 = await import('./index-DtfjeuxC.js');
-                    const _ns_22 = _mod_22.c;
+                    const _mod_22 = await import('./index-DRXC5Mra.js');
+                    const _ns_22 = _mod_22.f;
                     const { Model } = _ns_22;
                     const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
                     const model = await Model.resolveAsync(modelName, { modelFileId });
@@ -5986,8 +6031,8 @@ class ItemProperty {
             }
             if (modelName && propertyName) {
                 try {
-                    const _mod_23 = await import('./index-DtfjeuxC.js');
-                    const _ns_23 = _mod_23.c;
+                    const _mod_23 = await import('./index-DRXC5Mra.js');
+                    const _ns_23 = _mod_23.f;
                     const { Model } = _ns_23;
                     const { modelPropertiesToObject } = await import('./model-DGMe-TTm.js');
                     const model = await Model.resolveAsync(modelName, { modelFileId });
@@ -6308,7 +6353,7 @@ class ItemProperty {
                 if (!propertyName || (!seedLocalId && !seedUid))
                     return;
                 if (db) {
-                    const _mod_24 = await import('./index-B0LgJblD.js');
+                    const _mod_24 = await import('./index-CSOQFAOn.js');
                     const _ns_24 = _mod_24.s;
                     const seedSchemaMod = _ns_24;
                     const { metadata } = seedSchemaMod;
@@ -6354,8 +6399,8 @@ const createNewItem = async ({ modelName, modelFileId, ...propertyData }) => {
     }
     const seedType = toSnakeCase(modelName);
     // Dynamic import to break circular dependency
-    const _mod_25 = await import('./index-DtfjeuxC.js');
-    const _ns_25 = _mod_25.c;
+    const _mod_25 = await import('./index-DRXC5Mra.js');
+    const _ns_25 = _mod_25.f;
     const modelMod = _ns_25;
     const { Model } = modelMod;
     const model = await Model.resolveAsync(modelName, { modelFileId });
@@ -6512,8 +6557,8 @@ const getModel = () => {
         // the fragile `import(...).then(n => n.X)` chunk-namespace pattern.
         if (!modelImportPromise) {
             modelImportPromise = (async () => {
-                const _mod_26 = await import('./index-DtfjeuxC.js');
-                const _ns_26 = _mod_26.c;
+                const _mod_26 = await import('./index-DRXC5Mra.js');
+                const _ns_26 = _mod_26.f;
                 const mod = _ns_26;
                 ModelClass = mod.Model;
                 return mod;
@@ -6616,7 +6661,6 @@ class Item {
             const revokedAt = Math.floor(Date.now() / 1000);
             // The executor stamps the revoked version rows; the latest version is now the newest one left
             // (a local draft) or none, never a revoked one.
-            const { getLatestVersionRow } = await import('./getLatestVersionRow-Brrl1AnW.js');
             const head = await getLatestVersionRow(this.seedLocalId);
             this._service.send({
                 type: 'updateContext',
@@ -6662,12 +6706,12 @@ class Item {
         };
         this.getPublishUploads = async (options) => {
             // Use dynamic import to break circular dependency
-            const getPublishUploadsMod = await import('./getPublishUploads-CR66RlGJ.js');
+            const getPublishUploadsMod = await import('./getPublishUploads-BGpDsrBp.js');
             const { getPublishUploads } = getPublishUploadsMod;
             return await getPublishUploads(this, [], undefined, options);
         };
         this.getPublishPayload = async (uploadedTransactions, options) => {
-            const _mod_27 = await import('./getPublishPayload-H032DHC7.js');
+            const _mod_27 = await import('./getPublishPayload-D5CQZd-y.js');
             const _ns_27 = _mod_27.g;
             const getPublishPayloadMod = _ns_27;
             const { getPublishPayload } = getPublishPayloadMod;
@@ -6686,7 +6730,6 @@ class Item {
                 });
                 // Publish has recorded the version it attested (updateVersionUid): reflect it here too, as
                 // the versions liveQuery does in the browser. After a republish this is the new version.
-                const { getLatestVersionRow } = await import('./getLatestVersionRow-Brrl1AnW.js');
                 const head = await getLatestVersionRow(seedLocalId);
                 if (head?.localId) {
                     this._service.send({
@@ -6942,6 +6985,38 @@ class Item {
             }
         }
     }
+    /**
+     * Idle, and not the shell the item machine can be in when it reaches `idle` before
+     * `propertyInstances` is merged (an item with a version but no property instances yet).
+     */
+    static isItemSnapshotReadyForRead(snap) {
+        if (!snap || !('value' in snap) || snap.value !== 'idle') {
+            return false;
+        }
+        const ctx = snap.context || {};
+        const versionsCount = ctx.versionsCount ?? 0;
+        const hasHeadVersion = !!ctx.latestVersionLocalId;
+        if (versionsCount === 0 && !hasHeadVersion) {
+            return true;
+        }
+        return (ctx.propertyInstances?.size ?? 0) > 0;
+    }
+    /**
+     * 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
+     * no cache hold, so React hooks can call it during render.
+     */
+    static peekReady(id) {
+        if (!id)
+            return undefined;
+        const instance = this.findItemInstanceCacheEntryById(id)?.instance;
+        if (!instance)
+            return undefined;
+        const snap = instance.getService().getSnapshot();
+        if (snap.status !== 'active')
+            return undefined;
+        return this.isItemSnapshotReadyForRead(snap) ? instance : undefined;
+    }
     /**
      * Item machine can reach `idle` before `propertyInstances` is merged (race) or while
      * child ItemProperty actors are still hydrating. useItems / Item.all must not return that shell.
@@ -6954,16 +7029,7 @@ class Item {
                 if ('value' in snap && snap.value === 'error') {
                     throw new Error('Entity failed to load');
                 }
-                if (!('value' in snap) || snap.value !== 'idle') {
-                    return false;
-                }
-                const ctx = snap.context || {};
-                const versionsCount = ctx.versionsCount ?? 0;
-                const hasHeadVersion = !!ctx.latestVersionLocalId;
-                if (versionsCount === 0 && !hasHeadVersion) {
-                    return true;
-                }
-                return (ctx.propertyInstances?.size ?? 0) > 0;
+                return Item.isItemSnapshotReadyForRead(snap);
             }, { timeout: readyTimeout });
         }
         catch (e) {
@@ -7180,7 +7246,7 @@ class Item {
         const db = BaseDb.getAppDb();
         if (db && props.modelName) {
             // Model names are only unique per schema: resolve the exact models row from the most specific scope.
-            const _mod_28 = await import('./db-BJZN0a0a.js');
+            const _mod_28 = await import('./db-W1g29qsM.js');
             const _ns_28 = _mod_28.Y;
             const { resolveModelRecord } = _ns_28;
             const modelRecord = await resolveModelRecord(props.modelName, {
@@ -7194,10 +7260,10 @@ class Item {
             // Scope the constructor's Model lookup to this model's schema (as getItemData does on reload),
             // so a same-named model cached from another schema can't supply the property set.
             if (modelRecord && !props.schemaName) {
-                const _mod_29 = await import('./BasePathResolver-ndE8XTpw.js');
+                const _mod_29 = await import('./BasePathResolver-BdxCSIzn.js');
                 const _ns_29 = _mod_29.R;
                 const { modelSchemas } = _ns_29;
-                const _mod_30 = await import('./BasePathResolver-ndE8XTpw.js');
+                const _mod_30 = await import('./BasePathResolver-BdxCSIzn.js');
                 const _ns_30 = _mod_30.Q;
                 const { schemas: schemasTable } = _ns_30;
                 const schemaRows = await db
@@ -7543,7 +7609,7 @@ class Item {
         if (!appDb || Item.instanceCache.size === 0) {
             return;
         }
-        const _mod_31 = await import('./index-B0LgJblD.js');
+        const _mod_31 = await import('./index-CSOQFAOn.js');
         const _ns_31 = _mod_31.s;
         const { metadata } = _ns_31;
         const { eq, and } = await import('drizzle-orm');
@@ -8002,7 +8068,7 @@ class Item {
                 itemActor.send(event);
             };
             try {
-                const _mod_32 = await import('./index-B0LgJblD.js');
+                const _mod_32 = await import('./index-CSOQFAOn.js');
                 const _ns_32 = _mod_32.s;
                 const seedSchemaMod = _ns_32;
                 const { seeds, versions, metadata } = seedSchemaMod;
@@ -8355,5 +8421,5 @@ var Item$1 = /*#__PURE__*/Object.freeze({
     Item: Item
 });
 
-export { getMetadataLatest as A, getRevokeExecutor as B, ClientManagerState as C, getUploadExecutor as D, getVersionData$1 as E, isItemOwned as F, isLocalUnsealedDraft as G, isSeedRowOwned as H, Item as I, ownedPublisherSql as J, pickLatestMetadataRowPerProperty as K, propertyMachine as L, METADATA_LATEST_FIRST_ORDER_SQL as M, publisherInAddressListSql as N, publisherIsInOwnedSet as O, setAdditionalSyncAddresses as P, setGetPublisherForNewSeeds as Q, setRevokeExecutor as R, setUploadExecutor as S, getInvariantSafePropertyDescriptor as T, clearDestroySubscriptions as U, unloadEntity as V, ClientManagerEvents as W, resolvePublisherFromSeedRow as X, getPropertyData$1 as Y, Item$1 as Z, rowsPerInsert as a, getGetAdditionalSyncAddresses as b, chunkValues as c, ItemProperty as d, ItemPropertySaveValidationError as e, getEasSchemaUidForModel as f, getItemData as g, getLatestPublishedVersionRow as h, isVersionRevoked as i, waitForEntityIdle as j, createReactiveProxy as k, listRelationEasPropertyName as l, findEntity as m, forceRemoveFromCaches as n, runDestroyLifecycle as o, parseListPropertyValueFromStorage as p, compareMetadataRowsLatestFirst as q, resolveStorageNameToSchemaName as r, selectInBatches as s, isPublishedMetadataRow as t, MachineIds as u, versionNotRevoked as v, writeInBatches as w, createNewItem as x, getEasSchemaForItemProperty as y, getGetPublisherForNewSeeds as z };
-//# sourceMappingURL=Item-zBFWQDU9.js.map
+export { getRevokeExecutor as A, getUploadExecutor as B, ClientManagerState as C, getVersionData$1 as D, isItemOwned as E, isLocalUnsealedDraft as F, isSeedRowOwned as G, ownedPublisherSql as H, Item as I, pickLatestMetadataRowPerProperty as J, propertyMachine as K, publisherInAddressListSql as L, METADATA_LATEST_FIRST_ORDER_SQL as M, publisherIsInOwnedSet as N, setAdditionalSyncAddresses as O, setGetPublisherForNewSeeds as P, setRevokeExecutor as Q, setUploadExecutor as R, getInvariantSafePropertyDescriptor as S, clearDestroySubscriptions as T, unloadEntity as U, ClientManagerEvents as V, resolvePublisherFromSeedRow as W, getPropertyData$1 as X, Item$1 as Y, getEasSchemaUidForModel as a, getLatestPublishedVersionRow as b, chunkValues as c, rowsPerInsert as d, getGetAdditionalSyncAddresses as e, ItemProperty as f, getItemData as g, ItemPropertySaveValidationError as h, isVersionRevoked as i, waitForEntityIdle as j, createReactiveProxy as k, listRelationEasPropertyName as l, findEntity as m, forceRemoveFromCaches as n, runDestroyLifecycle as o, parseListPropertyValueFromStorage as p, compareMetadataRowsLatestFirst as q, resolveStorageNameToSchemaName as r, selectInBatches as s, isPublishedMetadataRow as t, MachineIds as u, createNewItem as v, writeInBatches as w, getEasSchemaForItemProperty as x, getGetPublisherForNewSeeds as y, getMetadataLatest as z };
+//# sourceMappingURL=Item-B9Y4VuK1.js.map