@seedprotocol/sdk 0.7.0 → 0.7.1

package/dist/main.js

@@ -1,33 +1,32 @@
 import 'reflect-metadata';
-export { M as Model } from './index-DtfjeuxC.js';
-import { s as normalizePublisher, k as isDataType, M as ModelPropertyDataTypes, n as normalizeDataType } from './db-BJZN0a0a.js';
-export { A as AmbiguousModelError, o as eventEmitter, z as getAddressesForItemsFilter, C as normalizeAddressConfig, E as normalizeAddressList, u as normalizeHexAddress } from './db-BJZN0a0a.js';
-export { getPropertySchema } from './property-D2Nnsmm1.js';
-import { n as normalizeRelationPropertyValue, r as resolveSeedIdsFromRefString, b as getArweaveUrlForTransaction } from './tabEvents-DYI2GU7i.js';
-export { A as ADDRESSES_PERSISTED_EVENT, F as FILES_CHANGED_EVENT, L as LOCAL_COPIES_REMOVED_EVENT, T as TabLockTimeoutError, c as classifyMediaRef, d as closestImageSize, f as ensureImageLocal, g as getCorrectId, h as getFeedItemStringField, j as isLeaderTab, i as isPublishedSeedRef, k as normalizeArweaveTxIdForEnsure, l as normalizeFeedItemFields, p as parseAddressesPersistedPayload, m as resolveMediaRef, w as whenLeaderTab } from './tabEvents-DYI2GU7i.js';
-import { g as getContentHash } from './ClientManager-DLleL_2e.js';
-export { E as EAS_CHAIN_ID_APP_STATE_KEY, a as assertLocalDbChain, c as claimUnpublishedDrafts, C as client, d as createLocalQueryDataSource, e as createSchema, f as easSyncActor, h as getClient, j as getPublishedSeedRecord, k as getSchemaNameFromId, i as importJsonSchema, m as isSeedQueryLocalSourceRegistered, n as listSchemas, o as loadAllSchemasFromDb, p as mergeEasSyncRequestIntents, r as readJsonImportFile, q as readSchema, u as registerSeedQueryLocalSource, v as requestEasSyncFromAddressChange, x as requestEasSyncFromEventBus, y as requestEasSyncFromModelsInit, z as sendEasSyncClientRequest, A as startEasSyncActor, s as syncSchemaFromSource, t as transformImportToSchemaFile, B as unregisterSeedQueryLocalSource } from './ClientManager-DLleL_2e.js';
-import { i as isVersionRevoked, q as compareMetadataRowsLatestFirst, t as isPublishedMetadataRow, h as getLatestPublishedVersionRow, p as parseListPropertyValueFromStorage, I as Item, j as waitForEntityIdle } from './Item-zBFWQDU9.js';
-export { C as ClientManagerState, d as ItemProperty, e as ItemPropertySaveValidationError, M as METADATA_LATEST_FIRST_ORDER_SQL, u as MachineIds, x as createNewItem, y as getEasSchemaForItemProperty, b as getGetAdditionalSyncAddresses, z as getGetPublisherForNewSeeds, A as getMetadataLatest, B as getRevokeExecutor, D as getUploadExecutor, E as getVersionData, F as isItemOwned, G as isLocalUnsealedDraft, H as isSeedRowOwned, l as listRelationEasPropertyName, J as ownedPublisherSql, K as pickLatestMetadataRowPerProperty, L as propertyMachine, N as publisherInAddressListSql, O as publisherIsInOwnedSet, P as setAdditionalSyncAddresses, Q as setGetPublisherForNewSeeds, R as setRevokeExecutor, S as setUploadExecutor } from './Item-zBFWQDU9.js';
-import { B as BaseDb, v as versions, r as seeds, b as metadata, h as htmlEmbeddedImageCoPublish, Z as ZERO_BYTES32, a as BaseFileManager, C as INTERNAL_STORAGE_MODEL_FILE_IDS, y as INTERNAL_PROPERTY_NAMES } from './BasePathResolver-ndE8XTpw.js';
-export { E as EAS_SEED_DATA_SYNCED_TO_DB_EVENT, A as INTERNAL_DATA_TYPES, D as ImageSize, F as SEED_PROTOCOL_SCHEMA_NAME, G as SeedModels, H as VERSION_SCHEMA_DEF, V as VERSION_SCHEMA_UID, J as VERSION_SCHEMA_UID_OPTIMISM_SEPOLIA, c as appState, d as arweaveL1FinalizeJobs, f as easSyncProcesses, i as modelSchemas, j as modelUids, m as models, p as properties, o as propertyUids, q as publishProcesses, s as schemas, u as uploadProcesses } from './BasePathResolver-ndE8XTpw.js';
+export { M as Model } from './index-Y-yYyRBf.js';
+import { s as normalizePublisher, k as isDataType, M as ModelPropertyDataTypes, n as normalizeDataType } from './db-Lw0KVZmc.js';
+export { A as AmbiguousModelError, m as eventEmitter, z as getAddressesForItemsFilter, C as normalizeAddressConfig, E as normalizeAddressList, u as normalizeHexAddress } from './db-Lw0KVZmc.js';
+export { getPropertySchema } from './property-ByaiSyUK.js';
+import { n as normalizeRelationPropertyValue, r as resolveSeedIdsFromRefString, b as getArweaveUrlForTransaction } from './tabEvents-C6NXS6Jl.js';
+export { A as ADDRESSES_PERSISTED_EVENT, F as FILES_CHANGED_EVENT, L as LOCAL_COPIES_REMOVED_EVENT, T as TabLockTimeoutError, c as classifyMediaRef, d as closestImageSize, f as ensureImageLocal, g as getCorrectId, h as getFeedItemStringField, j as isLeaderTab, i as isPublishedSeedRef, k as normalizeArweaveTxIdForEnsure, l as normalizeFeedItemFields, p as parseAddressesPersistedPayload, m as resolveMediaRef, w as whenLeaderTab } from './tabEvents-C6NXS6Jl.js';
+import { g as getContentHash } from './ClientManager-DngaZdw6.js';
+export { E as EAS_CHAIN_ID_APP_STATE_KEY, a as assertLocalDbChain, c as claimUnpublishedDrafts, C as client, d as createLocalQueryDataSource, e as createSchema, f as easSyncActor, h as getClient, j as getPublishedSeedRecord, k as getSchemaNameFromId, i as importJsonSchema, m as isSeedQueryLocalSourceRegistered, n as listSchemas, o as loadAllSchemasFromDb, p as mergeEasSyncRequestIntents, r as readJsonImportFile, q as readSchema, u as registerSeedQueryLocalSource, v as requestEasSyncFromAddressChange, x as requestEasSyncFromEventBus, y as requestEasSyncFromModelsInit, z as sendEasSyncClientRequest, A as startEasSyncActor, s as syncSchemaFromSource, t as transformImportToSchemaFile, B as unregisterSeedQueryLocalSource } from './ClientManager-DngaZdw6.js';
+import { i as isVersionRevoked, q as compareMetadataRowsLatestFirst, t as isPublishedMetadataRow, b as getLatestPublishedVersionRow, p as parseListPropertyValueFromStorage, I as Item, j as waitForEntityIdle } from './Item-ZUAmf943.js';
+export { C as ClientManagerState, f as ItemProperty, h as ItemPropertySaveValidationError, M as METADATA_LATEST_FIRST_ORDER_SQL, u as MachineIds, x as createNewItem, y as getEasSchemaForItemProperty, e as getGetAdditionalSyncAddresses, z as getGetPublisherForNewSeeds, A as getMetadataLatest, B as getRevokeExecutor, D as getUploadExecutor, E as getVersionData, F as isItemOwned, G as isLocalUnsealedDraft, H as isSeedRowOwned, l as listRelationEasPropertyName, J as ownedPublisherSql, K as pickLatestMetadataRowPerProperty, L as propertyMachine, N as publisherInAddressListSql, O as publisherIsInOwnedSet, P as setAdditionalSyncAddresses, Q as setGetPublisherForNewSeeds, R as setRevokeExecutor, S as setUploadExecutor } from './Item-ZUAmf943.js';
+import { B as BaseDb, v as versions, r as seeds, m as metadata, h as htmlEmbeddedImageCoPublish, a as BaseFileManager, C as INTERNAL_STORAGE_MODEL_FILE_IDS, I as INTERNAL_PROPERTY_NAMES, Z as ZERO_BYTES32 } from './BasePathResolver-DRT09oVv.js';
+export { E as EAS_SEED_DATA_SYNCED_TO_DB_EVENT, x as INTERNAL_DATA_TYPES, D as ImageSize, F as SEED_PROTOCOL_SCHEMA_NAME, G as SeedModels, H as VERSION_SCHEMA_DEF, V as VERSION_SCHEMA_UID, J as VERSION_SCHEMA_UID_OPTIMISM_SEPOLIA, b as appState, c as arweaveL1FinalizeJobs, e as easSyncProcesses, g as modelSchemas, i as modelUids, j as models, p as properties, o as propertyUids, q as publishProcesses, s as schemas, u as uploadProcesses } from './BasePathResolver-DRT09oVv.js';
 import { eq, desc, and, or, isNotNull, ne } from 'drizzle-orm';
 import { isPlaceholderUid, isValidEasAttestationUid, normalizeBytes32Hex } from '@seedprotocol/eas';
 export { EAS_CHAIN_DEPLOYMENTS, BaseEasClient as EasClient, getCanonicalItemPropertiesFromEas, getEasChainDeployment, getEasEndpoint, getEasReadChainId, getEasSchemaUidBySchemaName, getItemPropertiesFromEas, getItemVersionsFromEas, getSeedsBySchemaName, getSeedsFromSchemaUids, isPlaceholderUid, isValidEasAttestationUid, normalizeBytes32Hex, pickLatestPropertyAttestationsByRefAndSchema, setSchemaUidForModel, setSchemaUidForSchemaDefinition, withExcludeRevokedFilter } from '@seedprotocol/eas';
 import { generateId } from './generateId-BopUwD8F.js';
-export { S as Schema, d as deleteModelFromSchema, a as deletePropertyFromModel, r as renameModelProperty, s as schemaMachine, u as updateModelProperties } from './Schema-DOhlrQ-N.js';
+export { S as Schema, d as deleteModelFromSchema, a as deletePropertyFromModel, r as renameModelProperty, s as schemaMachine, u as updateModelProperties } from './Schema-D-Ud-XYw.js';
 export { F as FileSystemLockedError } from './errors-CrBxGWah.js';
-export { M as MODEL_AMBIGUOUS_EVENT } from './resolveModelForSyncedSeed-DQK6JfXS.js';
-export { ModelProperty } from './ModelProperty-lth9L37R.js';
-export { getModelSchemasFromEas } from './eas-B0hsMLqt.js';
+export { M as MODEL_AMBIGUOUS_EVENT } from './resolveModelForSyncedSeed-B0tco3zG.js';
+export { ModelProperty } from './ModelProperty-6llK4MTH.js';
+export { getModelSchemasFromEas } from './eas-CQ-Smzk2.js';
 export { BaseArweaveClient, DEFAULT_ARWEAVE_GATEWAYS, DEFAULT_ARWEAVE_GRAPHQL_URL, DEFAULT_ARWEAVE_HOST, DEFAULT_GATEWAY_SIDECAR_HOST, DEFAULT_GATEWAY_SIDECAR_PORT, DEFAULT_SEED_FEED_HYPER_KEY, DEFAULT_SEED_GATEWAY_HYPER_KEY, SEED_RSS_IMAGE_RELATION_FIELD_KEYS, ensureReadGatewaySelected, fetchArweaveRawFromBaseUrl, fetchArweaveRawTextAcrossGateways, getArweaveReadBaseUrls, getArweaveUploadStatus, getDefaultArweaveReadGatewayHostsOrdered, getLastHealthyReadGatewayHost, getPreferredArweaveReadBaseUrls, getReadGatewayHostsForConfig, getResolvedArweaveReadBaseUrls, getResolvedSeedGatewayEndpoints, getUploadApiArweaveDataUrl, getUploadApiArweaveStatusUrl, getUploadPipelineTransactionStatus, invalidateReadGatewayCache, invalidateSidecarProbeCache, isArweaveL1AnchoringComplete, isEasAttestationExplorerUrl, isGatewayHostCircuitOpen, isKnownArweaveGatewayHostname, isReadGatewayKnownHealthy, mergePrimaryHostWithDefaults, normalizeGatewayHostKey, normalizeUploadApiBaseUrl, queryArweaveGatewayTransaction, queryArweaveGatewayTransactionWithFallback, recordGatewayHostFailure, recordGatewayHostSuccess, resetArweaveReadGatewayForTests, resolveSeedGatewayEndpoints, resolveSeedRssImageRelationFromItem, resolveSeedRssImageRelationRef, seedGatewayConfigFromClientContext, seedGatewayConfigFromSeedConfig, setPreferredArweaveReadBaseUrls, setResolvedSeedGatewayEndpoints } from '@seedprotocol/arweave';
-export { u as updateSeedRevokedAt } from './updateSeedRevokedAt-B58ORbY3.js';
-import { g as getSegmentedItemProperties } from './getSegmentedItemProperties-C2EJ2G0N.js';
-import { i as isSeedRevoked, f as findRelatedSeedRow, a as isUnpublishedSeed, h as htmlPropertyNameForHtmlSeed, r as relatedModelNameFromDef } from './getPublishPayload-H032DHC7.js';
-export { P as PublishValidationFailedError, R as RELATED_ITEM_UNPUBLISHED_CODE, b as RelatedItemUnpublishedError, c as resolvePublishPayloadValues, v as validateItemForPublish } from './getPublishPayload-H032DHC7.js';
+export { u as updateSeedRevokedAt } from './updateSeedRevokedAt-CYwgVNlM.js';
+import { a as getSegmentedItemProperties, g as getPublishDraftGraph, i as isSeedRevoked, f as findRelatedSeedRow, b as isUnpublishedSeed, h as htmlPropertyNameForHtmlSeed, r as relatedModelNameFromDef } from './publishDraftGraph-BRm6Pq3Q.js';
+export { P as PublishValidationFailedError, R as RELATED_ITEM_UNPUBLISHED_CODE, a as RelatedItemUnpublishedError, r as resolvePublishPayloadValues, v as validateItemForPublish } from './getPublishPayload-76_KfB5Y.js';
 import 'pluralize';
-export { itemHasPublishUploadCandidates } from './getPublishUploads-CR66RlGJ.js';
-import { parseFragment, serialize } from 'parse5';
+export { itemHasPublishUploadCandidates } from './getPublishUploads-CqgMBD8f.js';
+import { parseFragment } from 'parse5';
 import 'js-yaml';
 import 'fs';
 import 'xstate';
@@ -43,7 +42,7 @@ import '@seedprotocol/query';
 import 'drizzle-orm/sqlite-core';
 import '@noble/hashes/sha3';
 import '@noble/hashes/utils';
-import './SchemaValidationService-DDKr5piy.js';
+import './SchemaValidationService-IoS7JquP.js';
 import '@sinclair/typebox/value';
 import '@ethereum-attestation-service/eas-sdk';
 
@@ -531,7 +530,7 @@ async function getRelatedItemsForPublish(item, visited = new Set()) {
     visited.add(seedLocalId);
     const result = [];
     const { itemRelationProperties, itemImageProperties, itemListProperties } = await getSegmentedItemProperties(item);
-    const getItemMod = await import('./getItem-DEh4WfHG.js');
+    const getItemMod = await import('./getItem-CSfSok9f.js');
     const { getItem } = getItemMod;
     const processRelationOrImage = async (prop) => {
         const snapshot = prop.getService().getSnapshot();
@@ -550,7 +549,7 @@ async function getRelatedItemsForPublish(item, visited = new Set()) {
         if (!value && prop.propertyName && isStorageSeed) {
             const ctx = context;
             if (ctx.seedLocalId || ctx.seedUid) {
-                const _mod_0 = await import('./Item-zBFWQDU9.js');
+                const _mod_0 = await import('./Item-ZUAmf943.js');
                 const _ns_0 = _mod_0.Y;
                 const { getPropertyData } = _ns_0;
                 const meta = await getPropertyData({
@@ -645,15 +644,6 @@ function getAttr(node, name) {
     const a = node.attrs?.find((x) => x.name === name);
     return a?.value;
 }
-function setAttr(node, name, value) {
-    if (!node.attrs)
-        node.attrs = [];
-    const i = node.attrs.findIndex((x) => x.name === name);
-    if (i >= 0)
-        node.attrs[i].value = value;
-    else
-        node.attrs.push({ name, value });
-}
 /**
  * Walk fragment tree; collect unique data:image base64 URIs with limits.
  */
@@ -712,21 +702,39 @@ async function extractDataUriImagesFromHtml(html) {
         await walk(c);
     return found;
 }
+function escapeAttributeValue(value) {
+    return value.replace(/&/g, '&').replace(/"/g, '"');
+}
 /**
- * Replace `data:image/...` src values with Arweave URLs using upload results keyed by image seed local id.
+ * Rewrite attribute values of `html` by splicing each new value into the original string: every
+ * byte other than the rewritten attributes stays as written. Re-serializing the parsed tree would
+ * not round-trip (parse5 drops the newline the parser eats after `<pre>`/`<textarea>`/`<listing>`,
+ * a fragment parse drops doctype/html/head/body, and quoting, case and line endings are normalized),
+ * and sealed Html must not change with the serializer.
+ *
+ * `rewrite` gets each attribute's (entity-decoded) value and returns its new value, or undefined to
+ * leave it. A rewritten attribute is written as `name="value"`.
  */
-function replaceDataUrisInParsedHtml(html, replacements) {
-    if (replacements.size === 0)
-        return html;
-    const fragment = parseFragment(html);
+function rewriteHtmlAttributes(html, rewrite) {
+    const fragment = parseFragment(html, { sourceCodeLocationInfo: true });
+    const edits = [];
     const walk = (node) => {
         if (node.nodeName === '#text' || node.nodeName === '#comment')
             return;
         const el = node;
-        if (el.tagName === 'img') {
-            const src = getAttr(el, 'src')?.trim();
-            if (src && replacements.has(src)) {
-                setAttr(el, 'src', replacements.get(src));
+        if (el.attrs?.length) {
+            for (const attr of el.attrs) {
+                if (attr.prefix)
+                    continue;
+                const next = rewrite(el, attr.name, attr.value);
+                const location = el.sourceCodeLocation?.attrs?.[attr.name];
+                if (next === undefined || !location)
+                    continue;
+                edits.push({
+                    start: location.startOffset,
+                    end: location.endOffset,
+                    text: `${attr.name}="${escapeAttributeValue(next)}"`,
+                });
             }
         }
         const parent = el;
@@ -737,7 +745,114 @@ function replaceDataUrisInParsedHtml(html, replacements) {
     };
     for (const c of fragment.childNodes)
         walk(c);
-    return serialize(fragment);
+    let out = html;
+    for (const edit of edits.sort((a, b) => b.start - a.start)) {
+        out = out.slice(0, edit.start) + edit.text + out.slice(edit.end);
+    }
+    return out;
+}
+/**
+ * Replace `data:image/...` `<img src>` values with Arweave URLs (keyed by data URI). Only those
+ * `src` attributes change; the rest of the Html is kept byte for byte.
+ */
+function replaceDataUrisInParsedHtml(html, replacements) {
+    if (replacements.size === 0)
+        return html;
+    return rewriteHtmlAttributes(html, (el, attrName, value) => {
+        if (el.tagName !== 'img' || attrName !== 'src')
+            return undefined;
+        return replacements.get(value.trim());
+    });
+}
+/**
+ * `seed:property/<propertyName>` in Html stands for the Arweave URL of the same item's
+ * `<propertyName>` storage property (Image, File or Json). Publish uploads that property first,
+ * then rewrites the placeholder to its gateway URL before the Html is uploaded, so Html can show a
+ * file published alongside it without embedding it (e.g. `<img class="u-featured"
+ * src="seed:property/featureImage">`).
+ */
+const SEED_PROPERTY_REF_PREFIX = 'seed:property/';
+const SEED_PROPERTY_REF = /^seed:property\/([A-Za-z_$][A-Za-z0-9_$]*)$/;
+/** Attributes whose whole (trimmed) value may be a `seed:property/` placeholder. */
+const SEED_PROPERTY_REF_ATTRIBUTES = new Set(['src', 'href', 'poster']);
+const seedPropertyRefName = (attrName, value) => SEED_PROPERTY_REF_ATTRIBUTES.has(attrName) ? SEED_PROPERTY_REF.exec(value.trim())?.[1] : undefined;
+/** A `seed:property/` placeholder that names no usable property, or whose upload is unknown. */
+class HtmlSeedPropertyRefError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HtmlSeedPropertyRefError';
+    }
+}
+/** Property names referenced by `seed:property/<name>` placeholders in `html`, each once. */
+function findSeedPropertyRefsInHtml(html) {
+    if (!html.includes(SEED_PROPERTY_REF_PREFIX))
+        return [];
+    const names = new Set();
+    rewriteHtmlAttributes(html, (_el, attrName, value) => {
+        const name = seedPropertyRefName(attrName, value);
+        if (name)
+            names.add(name);
+        return undefined;
+    });
+    return [...names];
+}
+/** Replace `seed:property/<name>` placeholders with `urlByPropertyName.get(name)`; other bytes are kept. */
+function replaceSeedPropertyRefsInHtml(html, urlByPropertyName) {
+    if (urlByPropertyName.size === 0)
+        return html;
+    return rewriteHtmlAttributes(html, (_el, attrName, value) => {
+        const name = seedPropertyRefName(attrName, value);
+        return name ? urlByPropertyName.get(name) : undefined;
+    });
+}
+const SEED_PROPERTY_REF_DATA_TYPES = [
+    ModelPropertyDataTypes.Image,
+    ModelPropertyDataTypes.File,
+    ModelPropertyDataTypes.Json,
+];
+/**
+ * The storage property of `item` a `seed:property/<name>` placeholder names, and the seed it holds.
+ * Html properties are refused: an Html seed may itself be deferred to after the rewrite.
+ */
+function resolveSeedPropertyRefTarget(item, propertyName) {
+    const property = item.properties.find((p) => p.propertyName === propertyName || p.propertyName === `${propertyName}Id`);
+    const def = property?.propertyDef;
+    if (!property || !def) {
+        throw new HtmlSeedPropertyRefError(`Html references ${SEED_PROPERTY_REF_PREFIX}${propertyName}, but ${item.modelName} has no property ${propertyName}`);
+    }
+    const dataType = normalizeDataTypeLocal(def.dataType);
+    const storageType = dataType === ModelPropertyDataTypes.Relation ? normalizeDataTypeLocal(def.refValueType) : dataType;
+    if (!SEED_PROPERTY_REF_DATA_TYPES.includes(storageType)) {
+        throw new HtmlSeedPropertyRefError(`Html references ${SEED_PROPERTY_REF_PREFIX}${propertyName}, but ${propertyName} is ${def.dataType}; ` +
+            `only Image, File and Json properties can be referenced`);
+    }
+    const snap = property.getService().getSnapshot();
+    const ctx = 'context' in snap ? snap.context : null;
+    const ids = resolveSeedIdsFromRefString(normalizeRelationPropertyValue(ctx?.propertyValue) ?? '');
+    if (!ids.seedLocalId && !ids.seedUid) {
+        throw new HtmlSeedPropertyRefError(`Html references ${SEED_PROPERTY_REF_PREFIX}${propertyName}, but ${propertyName} has no value`);
+    }
+    return ids;
+}
+const ARWEAVE_TX_ID = /^[a-z0-9_-]{43}$/i;
+/**
+ * The Arweave tx of the storage seed a placeholder names: uploaded in this publish's phase 1, or,
+ * when not uploaded now, the transaction it was published with (its storageTransactionId).
+ */
+async function resolveSeedPropertyRefTxId(item, propertyName, txBySeedLocalId) {
+    const { seedLocalId, seedUid } = resolveSeedPropertyRefTarget(item, propertyName);
+    const uploaded = seedLocalId ? txBySeedLocalId.get(seedLocalId) : undefined;
+    if (uploaded)
+        return uploaded;
+    const storageItem = await Item.find({ seedLocalId, seedUid });
+    const st = storageItem?.internalProperties['storageTransactionId'] ??
+        storageItem?.allProperties['storageTransactionId'];
+    const stSnap = st?.getService().getSnapshot();
+    const stValue = stSnap && 'context' in stSnap ? stSnap.context.propertyValue : undefined;
+    if (typeof stValue === 'string' && ARWEAVE_TX_ID.test(stValue.trim()))
+        return stValue.trim();
+    throw new HtmlSeedPropertyRefError(`Html references ${SEED_PROPERTY_REF_PREFIX}${propertyName}, but ${propertyName} was not uploaded ` +
+        `in this publish and has no published transaction`);
 }
 async function deleteCoPublishRowsForParent(appDb, parentSeedLocalId) {
     if (!appDb)
@@ -781,31 +896,16 @@ async function prepareHtmlEmbeddedImagesForPublish(item, publishPolicy) {
     return { deferredHtmlSeedLocalIds: [...deferred] };
 }
 /**
- * Draft items (no seed uid yet) that a publish of `item` publishes with it: the targets of its
- * relation properties, one level deep, as getPublishPayload and getPublishUploads walk them.
- * Html-embedded images of these items are co-published with `item` like its own.
+ * Draft items (no seed uid yet) that a publish of `item` publishes with it: every draft reachable
+ * through relation and list properties, as getPublishPayload and getPublishUploads walk them
+ * (publishDraftGraph.ts). Html-embedded images of these items are co-published with `item` like its own.
  */
 async function getRelatedDraftsCoPublishedWith(item) {
-    const { itemRelationProperties } = await getSegmentedItemProperties(item);
-    const out = [];
-    const seen = new Set([item.seedLocalId]);
-    for (const relationProperty of itemRelationProperties) {
-        if (relationProperty.uid)
-            continue;
-        const snap = relationProperty.getService().getSnapshot();
-        const value = 'context' in snap ? snap.context.propertyValue : undefined;
-        const { seedLocalId, seedUid } = resolveSeedIdsFromRefString(normalizeRelationPropertyValue(value) ?? '');
-        if (!seedLocalId && !seedUid)
-            continue;
-        const related = await Item.find({ seedLocalId, seedUid });
-        if (!related?.seedLocalId || seen.has(related.seedLocalId))
-            continue;
-        if (related.seedUid && related.seedUid !== ZERO_BYTES32)
-            continue;
-        seen.add(related.seedLocalId);
-        out.push(related);
-    }
-    return out;
+    const _mod_1 = await import('./publishDraftGraph-BRm6Pq3Q.js');
+    const _ns_1 = _mod_1.p;
+    const { getPublishDraftGraph } = _ns_1;
+    const { drafts } = await getPublishDraftGraph(item);
+    return drafts.map((d) => d.item);
 }
 async function prepareHtmlEmbeddedImagesOfItem(appDb, item, publishPolicy, deferred) {
     await deleteCoPublishRowsForParent(appDb, item.seedLocalId);
@@ -813,9 +913,6 @@ async function prepareHtmlEmbeddedImagesOfItem(appDb, item, publishPolicy, defer
         const def = p.propertyDef;
         if (!def || normalizeDataTypeLocal(def.dataType) !== ModelPropertyDataTypes.Html)
             continue;
-        const policy = resolveEffectiveHtmlEmbeddedDataUriPolicy(def, publishPolicy);
-        if (policy !== 'materialize')
-            continue;
         const snap = p.getService().getSnapshot();
         const ctx = 'context' in snap ? snap.context : null;
         const htmlSeedLocalId = typeof ctx?.propertyValue === 'string' ? ctx.propertyValue : '';
@@ -846,15 +943,17 @@ async function prepareHtmlEmbeddedImagesOfItem(appDb, item, publishPolicy, defer
                 html = new TextDecoder('utf-8', { fatal: false }).decode(new Uint8Array(v.buffer, v.byteOffset, v.byteLength));
             }
         }
-        let extracted;
-        try {
-            extracted = await extractDataUriImagesFromHtml(html);
-        }
-        catch (e) {
-            if (e instanceof HtmlEmbeddedDataUriLimitError)
-                throw e;
-            throw e;
-        }
+        // seed:property/ placeholders are filled in after phase 1 whatever the data URI policy. A
+        // placeholder naming no usable property fails here, before anything is uploaded.
+        const refs = findSeedPropertyRefsInHtml(html);
+        for (const name of refs)
+            resolveSeedPropertyRefTarget(item, name);
+        if (refs.length > 0)
+            deferred.add(htmlSeedLocalId.trim());
+        const policy = resolveEffectiveHtmlEmbeddedDataUriPolicy(def, publishPolicy);
+        if (policy !== 'materialize')
+            continue;
+        const extracted = await extractDataUriImagesFromHtml(html);
         if (extracted.length === 0)
             continue;
         deferred.add(htmlSeedLocalId.trim());
@@ -877,70 +976,73 @@ function normalizeDataTypeLocal(dt) {
     return dt.charAt(0).toUpperCase() + dt.slice(1).toLowerCase();
 }
 /**
- * After phase-1 uploads, rewrite Html files on disk: data URI → Arweave gateway URL.
+ * After phase-1 uploads, rewrite Html files on disk: data URI → Arweave gateway URL, and
+ * `seed:property/<name>` → the gateway URL of that property's upload.
+ *
+ * `deferredHtmlSeedLocalIds` (from {@link prepareHtmlEmbeddedImagesForPublish}) limits the rewrite to
+ * the Html held back from phase 1; without it, every Html of the item and its co-published drafts is
+ * considered.
  */
-async function rewriteHtmlEmbeddedImagesOnDisk(parentSeedLocalId, uploadedTransactions) {
+async function rewriteHtmlEmbeddedImagesOnDisk(parentSeedLocalId, uploadedTransactions, deferredHtmlSeedLocalIds) {
     const appDb = BaseDb.getAppDb();
     if (!appDb)
         return;
     const parentItem = await Item.find({ seedLocalId: parentSeedLocalId });
     if (!parentItem)
         return;
-    const txByImageSeed = new Map();
+    const txBySeedLocalId = new Map();
     for (const u of uploadedTransactions) {
         if (u.seedLocalId && u.txId) {
-            txByImageSeed.set(u.seedLocalId.trim(), u.txId.trim());
+            txBySeedLocalId.set(u.seedLocalId.trim(), u.txId.trim());
         }
     }
+    const deferred = deferredHtmlSeedLocalIds
+        ? new Set(deferredHtmlSeedLocalIds.map((id) => id.trim()))
+        : undefined;
     // The parent's Html and that of the draft items published with it (see prepareHtmlEmbeddedImagesForPublish).
     for (const item of [parentItem, ...(await getRelatedDraftsCoPublishedWith(parentItem))]) {
-        await rewriteHtmlEmbeddedImagesOfItem(appDb, item, txByImageSeed);
+        await rewriteHtmlEmbeddedImagesOfItem(appDb, item, txBySeedLocalId, deferred);
     }
 }
-async function rewriteHtmlEmbeddedImagesOfItem(appDb, parentItem, txByImageSeed) {
+async function rewriteHtmlEmbeddedImagesOfItem(appDb, parentItem, txBySeedLocalId, deferred) {
     const rows = await appDb
         .select()
         .from(htmlEmbeddedImageCoPublish)
         .where(eq(htmlEmbeddedImageCoPublish.parentSeedLocalId, parentItem.seedLocalId));
-    if (rows.length === 0)
-        return;
-    const htmlSeedIds = new Set(rows.map((r) => String(r.htmlSeedLocalId).trim()));
-    const refByHtmlSeed = new Map();
-    if (parentItem) {
-        for (const p of parentItem.properties) {
-            const def = p.propertyDef;
-            if (!def || normalizeDataTypeLocal(def.dataType) !== ModelPropertyDataTypes.Html)
-                continue;
-            const snap = p.getService().getSnapshot();
-            const ctx = 'context' in snap ? snap.context : null;
-            const pv = typeof ctx?.propertyValue === 'string' ? ctx.propertyValue.trim() : '';
-            const refResolved = ctx?.refResolvedValue;
-            if (pv && refResolved)
-                refByHtmlSeed.set(pv, refResolved);
-        }
-    }
-    for (const htmlSeedLocalId of htmlSeedIds) {
-        const refResolved = refByHtmlSeed.get(String(htmlSeedLocalId));
-        if (!refResolved)
+    for (const p of parentItem.properties) {
+        const def = p.propertyDef;
+        if (!def || normalizeDataTypeLocal(def.dataType) !== ModelPropertyDataTypes.Html)
             continue;
+        const snap = p.getService().getSnapshot();
+        const ctx = 'context' in snap ? snap.context : null;
+        const htmlSeedLocalId = typeof ctx?.propertyValue === 'string' ? ctx.propertyValue.trim() : '';
+        const refResolved = ctx?.refResolvedValue;
+        if (!htmlSeedLocalId || !refResolved)
+            continue;
+        if (deferred && !deferred.has(htmlSeedLocalId))
+            continue;
+        const htmlRows = rows.filter((r) => String(r.htmlSeedLocalId).trim() === htmlSeedLocalId);
         const filePath = `${BaseFileManager.getFilesPath('html')}/${refResolved}`;
         if (!(await BaseFileManager.pathExists(filePath)))
             continue;
         const html = await BaseFileManager.readFileAsString(filePath);
         const replacements = new Map();
-        for (const r of rows) {
-            if (String(r.htmlSeedLocalId).trim() !== htmlSeedLocalId)
-                continue;
-            const txId = txByImageSeed.get(r.imageSeedLocalId.trim());
+        for (const r of htmlRows) {
+            const txId = txBySeedLocalId.get(r.imageSeedLocalId.trim());
             if (!txId)
                 continue;
             const dataUri = await findDataUriForStableKey(html, r.stableKey);
             if (dataUri)
                 replacements.set(dataUri, getArweaveUrlForTransaction(txId));
         }
-        if (replacements.size === 0)
+        const urlByPropertyName = new Map();
+        for (const name of findSeedPropertyRefsInHtml(html)) {
+            const txId = await resolveSeedPropertyRefTxId(parentItem, name, txBySeedLocalId);
+            urlByPropertyName.set(name, getArweaveUrlForTransaction(txId));
+        }
+        const newHtml = replaceSeedPropertyRefsInHtml(replaceDataUrisInParsedHtml(html, replacements), urlByPropertyName);
+        if (newHtml === html)
             continue;
-        const newHtml = replaceDataUrisInParsedHtml(html, replacements);
         try {
             await BaseFileManager.saveFile(filePath, newHtml);
         }
@@ -948,19 +1050,10 @@ async function rewriteHtmlEmbeddedImagesOfItem(appDb, parentItem, txByImageSeed)
             const fs = await BaseFileManager.getFs();
             fs.writeFileSync(filePath, newHtml);
         }
-        if (parentItem) {
-            for (const p of parentItem.properties) {
-                const snap = p.getService().getSnapshot();
-                const ctx = 'context' in snap ? snap.context : null;
-                const pv = typeof ctx?.propertyValue === 'string' ? ctx.propertyValue.trim() : '';
-                if (pv === htmlSeedLocalId) {
-                    p.getService().send({
-                        type: 'updateContext',
-                        renderValue: newHtml,
-                    });
-                }
-            }
-        }
+        p.getService().send({
+            type: 'updateContext',
+            renderValue: newHtml,
+        });
     }
 }
 async function findDataUriForStableKey(html, stableKey) {
@@ -1127,7 +1220,7 @@ async function loadRelatedItem(value) {
     const { seedLocalId, seedUid } = resolveSeedIdsFromRefString(normalized);
     if (!seedLocalId && !seedUid)
         return undefined;
-    const { getItem } = await import('./getItem-DEh4WfHG.js');
+    const { getItem } = await import('./getItem-CSfSok9f.js');
     try {
         return await getItem({ seedLocalId, seedUid });
     }
@@ -1144,25 +1237,6 @@ async function relatedIfUnpublished(prop) {
         return undefined;
     return related;
 }
-async function unpublishedListItems(listProperty) {
-    const context = propertyContext(listProperty);
-    if (!context)
-        return [];
-    let value = context.propertyValue;
-    if (!value)
-        return [];
-    if (typeof value === 'string') {
-        value = parseListPropertyValueFromStorage(value);
-    }
-    const arr = Array.isArray(value) ? value : [];
-    const out = [];
-    for (const seedId of arr) {
-        const related = await loadRelatedItem(seedId);
-        if (related && isZeroUid(related.seedUid))
-            out.push(related);
-    }
-    return out;
-}
 /** Seed refs held by a relation/image property (one) or a list property (each member). */
 function seedRefsOf(prop, isList) {
     const context = propertyContext(prop);
@@ -1180,7 +1254,7 @@ function seedRefsOf(prop, isList) {
     return ref ? [ref] : [];
 }
 /** Like getPublishPayload: attested refs to revoked seeds block the publish. */
-async function collectUnpublishedRelatedItems(props, isList, forceFullSnapshot, out) {
+async function collectUnpublishedRelatedItems(props, isList, forceFullSnapshot, out, backReferences) {
     for (const prop of props) {
         if (!shouldAttestProperty(prop, forceFullSnapshot))
             continue;
@@ -1189,6 +1263,10 @@ async function collectUnpublishedRelatedItems(props, isList, forceFullSnapshot,
             if (!seedLocalId && !seedUid)
                 continue;
             const row = await findRelatedSeedRow({ seedLocalId, seedUid });
+            // A back reference to a seed this publish creates (e.g. a revoked root published again) is
+            // left for a later publish, not attested (publishDraftGraph.ts)
+            if (row && backReferences?.get(prop)?.has(row.seedLocalId))
+                continue;
             if (!isUnpublishedSeed(row))
                 continue;
             if (out.some((r) => r.propertyName === prop.propertyName && r.seedLocalId === row.seedLocalId)) {
@@ -1229,7 +1307,7 @@ async function collectUnpublishedEmbeddedImages(item, out) {
         }
     }
 }
-async function appendCoPublishImages(item, acc, seen, visited, forceFullSnapshot, publishMode) {
+async function appendCoPublishImages(item, acc, seen, visited, forceFullSnapshot, publishMode, graph) {
     const appDb = BaseDb.getAppDb();
     if (!appDb)
         return;
@@ -1238,9 +1316,9 @@ async function appendCoPublishImages(item, acc, seen, visited, forceFullSnapshot
         .from(htmlEmbeddedImageCoPublish)
         .where(eq(htmlEmbeddedImageCoPublish.parentSeedLocalId, item.seedLocalId));
     for (const row of rows) {
-        const _mod_1 = await import('./Item-zBFWQDU9.js');
-        const _ns_1 = _mod_1.Z;
-        const { Item } = _ns_1;
+        const _mod_2 = await import('./Item-ZUAmf943.js');
+        const _ns_2 = _mod_2.Z;
+        const { Item } = _ns_2;
         const imageItem = await Item.find({
             seedLocalId: row.imageSeedLocalId,
             modelName: 'Image',
@@ -1257,10 +1335,10 @@ async function appendCoPublishImages(item, acc, seen, visited, forceFullSnapshot
         if (dataUriBytes != null && dataUriBytes > 0) {
             await addUpload(acc, seen, `seed:${imageItem.seedLocalId}`, dataUriBytes);
         }
-        await summarizeItem(imageItem, publishMode, forceFullSnapshot, acc, seen, visited);
+        await summarizeItem(imageItem, publishMode, forceFullSnapshot, acc, seen, visited, graph);
     }
 }
-async function summarizeItem(item, publishMode, forceFullSnapshot, acc, seenUploads, visited) {
+async function summarizeItem(item, publishMode, forceFullSnapshot, acc, seenUploads, visited, graph) {
     const seedLocalId = item.seedLocalId;
     if (!seedLocalId || visited.has(seedLocalId))
         return;
@@ -1272,20 +1350,20 @@ async function summarizeItem(item, publishMode, forceFullSnapshot, acc, seenUplo
         acc.newVersionCount += 1;
     const { itemBasicProperties, itemRelationProperties, itemListProperties, itemUploadProperties, itemImageProperties, } = await getSegmentedItemProperties(item);
     await collectUploadBytes(item, itemUploadProperties, itemImageProperties, undefined, acc, seenUploads);
-    await collectUnpublishedRelatedItems([...itemRelationProperties, ...itemImageProperties], false, forceFullSnapshot, acc.unpublishedRelatedItems);
-    await collectUnpublishedRelatedItems(itemListProperties, true, forceFullSnapshot, acc.unpublishedRelatedItems);
+    await collectUnpublishedRelatedItems([...itemRelationProperties, ...itemImageProperties], false, forceFullSnapshot, acc.unpublishedRelatedItems, graph.backReferences);
+    await collectUnpublishedRelatedItems(itemListProperties, true, forceFullSnapshot, acc.unpublishedRelatedItems, graph.backReferences);
+    // Draft Image/File/Html/Json items its storage relations point at. Draft model items its relations
+    // and lists reach are summarized by summarizePublishWork from the publish's draft graph.
+    const storageProperties = new Set(itemImageProperties);
     for (const rel of itemRelationProperties) {
+        if (!storageProperties.has(rel))
+            continue;
         const related = await relatedIfUnpublished(rel);
         if (related) {
-            await summarizeItem(related, publishMode, forceFullSnapshot, acc, seenUploads, visited);
-        }
-    }
-    for (const listProperty of itemListProperties) {
-        for (const related of await unpublishedListItems(listProperty)) {
-            await summarizeItem(related, publishMode, forceFullSnapshot, acc, seenUploads, visited);
+            await summarizeItem(related, publishMode, forceFullSnapshot, acc, seenUploads, visited, graph);
         }
     }
-    await appendCoPublishImages(item, acc, seenUploads, visited, forceFullSnapshot, publishMode);
+    await appendCoPublishImages(item, acc, seenUploads, visited, forceFullSnapshot, publishMode, graph);
     const attestable = [
         ...itemBasicProperties,
         ...itemRelationProperties,
@@ -1299,6 +1377,9 @@ async function summarizeItem(item, publishMode, forceFullSnapshot, acc, seenUplo
         if (seenProps.has(key))
             continue;
         seenProps.add(key);
+        // A ref back to an item this publish creates is left for a later publish (publishDraftGraph.ts).
+        if (graph.deferredProperties.has(prop))
+            continue;
         if (shouldAttestProperty(prop, forceFullSnapshot))
             acc.attestationCount += 1;
     }
@@ -1313,25 +1394,10 @@ const publishForcesFullSnapshot = async (item, publishMode) => {
     const republishRevokedSeed = !isZeroUid(item.seedUid) && (await isSeedRevoked(item.seedLocalId));
     return { republishRevokedSeed, forceFullSnapshot: publishMode === 'new_version' || republishRevokedSeed };
 };
-async function collectUnpublishedRelatedItemsDeep(item, forceFullSnapshot, out, visited) {
-    const seedLocalId = item.seedLocalId;
-    if (!seedLocalId || visited.has(seedLocalId))
-        return;
-    visited.add(seedLocalId);
+async function collectUnpublishedRelatedItemsOf(item, forceFullSnapshot, out, backReferences) {
     const { itemRelationProperties, itemListProperties, itemImageProperties } = await getSegmentedItemProperties(item);
-    await collectUnpublishedRelatedItems([...itemRelationProperties, ...itemImageProperties], false, forceFullSnapshot, out);
-    await collectUnpublishedRelatedItems(itemListProperties, true, forceFullSnapshot, out);
-    // Unpublished drafts the publish carries along are checked too.
-    for (const rel of itemRelationProperties) {
-        const related = await relatedIfUnpublished(rel);
-        if (related)
-            await collectUnpublishedRelatedItemsDeep(related, forceFullSnapshot, out, visited);
-    }
-    for (const listProperty of itemListProperties) {
-        for (const related of await unpublishedListItems(listProperty)) {
-            await collectUnpublishedRelatedItemsDeep(related, forceFullSnapshot, out, visited);
-        }
-    }
+    await collectUnpublishedRelatedItems([...itemRelationProperties, ...itemImageProperties], false, forceFullSnapshot, out, backReferences);
+    await collectUnpublishedRelatedItems(itemListProperties, true, forceFullSnapshot, out, backReferences);
 }
 /**
  * References a publish of `item` would attest to items whose seed was unpublished (revoked), the
@@ -1341,7 +1407,11 @@ async function collectUnpublishedRelatedItemsDeep(item, forceFullSnapshot, out,
 const getUnpublishedRelatedItems = async (item, options) => {
     const { forceFullSnapshot } = await publishForcesFullSnapshot(item, options?.publishMode ?? 'patch');
     const out = [];
-    await collectUnpublishedRelatedItemsDeep(item, forceFullSnapshot, out, new Set());
+    // The item and every draft its publish carries along (publishDraftGraph.ts).
+    const { drafts, backReferences } = await getPublishDraftGraph(item, { forceFullSnapshot });
+    for (const owner of [item, ...drafts.map((d) => d.item)]) {
+        await collectUnpublishedRelatedItemsOf(owner, forceFullSnapshot, out, backReferences);
+    }
     await collectUnpublishedEmbeddedImages(item, out);
     return out;
 };
@@ -1358,7 +1428,13 @@ const summarizePublishWork = async (item, options) => {
         uploadBytes: 0,
         unpublishedRelatedItems: [],
     };
-    await summarizeItem(item, publishMode, forceFullSnapshot, acc, new Set(), new Set());
+    const graph = await getPublishDraftGraph(item, { forceFullSnapshot });
+    const { drafts } = graph;
+    const seenUploads = new Set();
+    const visited = new Set();
+    for (const owner of [item, ...drafts.map((d) => d.item)]) {
+        await summarizeItem(owner, publishMode, forceFullSnapshot, acc, seenUploads, visited, graph);
+    }
     await collectUnpublishedEmbeddedImages(item, acc.unpublishedRelatedItems);
     // summarizeItem counts the root as an existing seed (it has a seedUid).
     if (republishRevokedSeed)
@@ -1366,5 +1442,5 @@ const summarizePublishWork = async (item, options) => {
     return acc;
 };
 
-export { BaseDb, BaseFileManager, BaseFileManager as FileManager, HTML_EMBEDDED_MAX_IMAGES_PER_DOC, HTML_EMBEDDED_MAX_IMAGE_BYTES, HTML_EMBEDDED_MAX_TOTAL_BYTES, HtmlEmbeddedDataUriLimitError, Item, ModelPropertyDataTypes, applyArweaveL1TransactionIdLocal, applyPropertyAttestationUidsFromPublish, clearHtmlEmbeddedImageCoPublishRows, compareMetadataRowsLatestFirst, estimateDataUriByteLength, extractDataUriImagesFromHtml, generateId, getArweaveUrlForTransaction, getAttesterForSeed, getMetadataAttestationUidsForSeedUid, getPublishPendingDiff, getRelatedItemsForPublish, getSeedPublishState, getSegmentedItemProperties, getUnpublishedRelatedItems, getVersionsForSeedUid, htmlEmbeddedImageCoPublish, isDataType, metadata, normalizeDataType, normalizePublisher, normalizeRelationPropertyValue, prepareHtmlEmbeddedImagesForPublish, replaceDataUrisInParsedHtml, resolveEffectiveHtmlEmbeddedDataUriPolicy, resolveSeedIdsFromRefString, rewriteHtmlEmbeddedImagesOnDisk, seeds, shouldAttestProperty, summarizePublishWork, updateVersionUid, versions, waitForEntityIdle };
+export { BaseDb, BaseFileManager, BaseFileManager as FileManager, HTML_EMBEDDED_MAX_IMAGES_PER_DOC, HTML_EMBEDDED_MAX_IMAGE_BYTES, HTML_EMBEDDED_MAX_TOTAL_BYTES, HtmlEmbeddedDataUriLimitError, HtmlSeedPropertyRefError, Item, ModelPropertyDataTypes, SEED_PROPERTY_REF_PREFIX, applyArweaveL1TransactionIdLocal, applyPropertyAttestationUidsFromPublish, clearHtmlEmbeddedImageCoPublishRows, compareMetadataRowsLatestFirst, estimateDataUriByteLength, extractDataUriImagesFromHtml, findSeedPropertyRefsInHtml, generateId, getArweaveUrlForTransaction, getAttesterForSeed, getMetadataAttestationUidsForSeedUid, getPublishDraftGraph, getPublishPendingDiff, getRelatedItemsForPublish, getSeedPublishState, getSegmentedItemProperties, getUnpublishedRelatedItems, getVersionsForSeedUid, htmlEmbeddedImageCoPublish, isDataType, metadata, normalizeDataType, normalizePublisher, normalizeRelationPropertyValue, prepareHtmlEmbeddedImagesForPublish, replaceDataUrisInParsedHtml, replaceSeedPropertyRefsInHtml, resolveEffectiveHtmlEmbeddedDataUriPolicy, resolveSeedIdsFromRefString, rewriteHtmlEmbeddedImagesOnDisk, seeds, shouldAttestProperty, summarizePublishWork, updateVersionUid, versions, waitForEntityIdle };
 //# sourceMappingURL=main.js.map