@seedprotocol/sdk 0.7.9-next.1189.g5e63267 → 0.7.9

package/dist/readHtmlBodyForStorageSeed-D6KPtWoR.js

@@ -0,0 +1,110 @@
+import { w as BaseFileManager } from './BaseFileManager-BAlySv8w.js';
+import { fetchArweaveRawTextAcrossGateways } from '@seedprotocol/arweave';
+import 'debug';
+import 'drizzle-orm/sqlite-core';
+import 'drizzle-orm';
+
+/** Published storage seeds use `0x` + 64 hex; `saveHtml` still writes `html/{localId}.html`. */
+const SEED_UID_HEX_RE = /^0x[a-fA-F0-9]{64}$/;
+/** Arweave L1 transaction ids are 43 URL-safe base64 characters. */
+const ARWEAVE_TX_ID_IN_STRING_RE = /[a-z0-9_-]{43}/i;
+function extractArweaveTransactionId(raw) {
+    const t = raw.trim();
+    const embedded = t.match(ARWEAVE_TX_ID_IN_STRING_RE);
+    if (embedded && /^[a-z0-9_-]{43}$/i.test(embedded[0])) {
+        return embedded[0];
+    }
+    return t;
+}
+/**
+ * GET /raw/{txId} on each read gateway, preferred ones ({@link setPreferredArweaveReadBaseUrls})
+ * first. Avoids arweave.js /tx/.../offset which often 404s on arweave.net while another gateway
+ * (e.g. ar.seedprotocol.io, or the one the item was just uploaded through) still serves the data.
+ */
+async function fetchHtmlViaRawAcrossGateways(txId) {
+    const id = extractArweaveTransactionId(txId);
+    if (!id || SEED_UID_HEX_RE.test(id))
+        return undefined;
+    return fetchArweaveRawTextAcrossGateways(id);
+}
+/**
+ * Resolve the Html storage seed's `local_id` used for the `{localId}.html` file name.
+ * `propertyValue` on the parent Html property is either that local id or the seed uid after publish.
+ */
+async function resolveHtmlStorageSeedLocalId(propertyValue) {
+    const pv = String(propertyValue ?? '').trim();
+    if (!pv)
+        return undefined;
+    if (SEED_UID_HEX_RE.test(pv)) {
+        const _mod_0 = await import('./tabEvents-CaVmngqr.js');
+        const _ns_0 = _mod_0.bd;
+        const { findSeedRow } = _ns_0;
+        return (await findSeedRow({ uid: pv }))?.localId ?? undefined;
+    }
+    return pv;
+}
+/**
+ * When the local draft file is gone (new device, OPFS cleared, etc.), load HTML from the
+ * Html storage seed's published Arweave transaction id: a read gateway's `/raw`, then the Arweave
+ * client, then a download into `html/` (named after the seed or the transaction).
+ */
+async function readHtmlBodyFromChildStorageArweave(seedLocalId) {
+    const _mod_1 = await import('./Item-Bf4kWKpH.js');
+    const _ns_1 = _mod_1.b2;
+    const { storageSeedTransactionId } = _ns_1;
+    const txId = await storageSeedTransactionId({ seedLocalId });
+    if (!txId || SEED_UID_HEX_RE.test(txId))
+        return undefined;
+    const rawHtml = await fetchHtmlViaRawAcrossGateways(txId);
+    if (rawHtml)
+        return rawHtml;
+    try {
+        const { BaseArweaveClient } = await import('@seedprotocol/arweave');
+        const data = await BaseArweaveClient.getTransactionData(extractArweaveTransactionId(txId), {
+            string: true,
+        });
+        if (typeof data === 'string' && data.length > 0)
+            return data;
+    }
+    catch {
+        /* offline / bad tx id */
+    }
+    try {
+        const _mod_2 = await import('./tabEvents-CaVmngqr.js');
+        const _ns_2 = _mod_2.bj;
+        const { downloadTransactionIdWithDedupe } = _ns_2;
+        await downloadTransactionIdWithDedupe(txId);
+        const _mod_3 = await import('./tabEvents-CaVmngqr.js');
+        const _ns_3 = _mod_3.bk;
+        const { findFileInDir } = _ns_3;
+        const filePath = await findFileInDir('html', [`${seedLocalId}.html`, extractArweaveTransactionId(txId)]);
+        if (filePath)
+            return BaseFileManager.readFileAsString(filePath);
+    }
+    catch {
+        /* OPFS unsupported or download failed */
+    }
+    return undefined;
+}
+/** Read saved HTML body for a parent Html property whose `propertyValue` points at the Html storage seed. */
+async function readHtmlBodyForStorageSeedPropertyValue(propertyValue) {
+    const pv = String(propertyValue ?? '').trim();
+    if (!pv)
+        return undefined;
+    const localId = await resolveHtmlStorageSeedLocalId(propertyValue);
+    const fp = localId ? BaseFileManager.getFilesPath('html', `${localId}.html`) : '';
+    let fileExists = fp ? await BaseFileManager.pathExists(fp) : false;
+    // OPFS: file can appear shortly after create/download; avoid false "missing" before hitting Arweave.
+    if (!fileExists && fp) {
+        await BaseFileManager.waitForFileWithContent(fp, 100, 5000).catch(() => { });
+        fileExists = await BaseFileManager.pathExists(fp);
+    }
+    let body = fileExists && fp ? await BaseFileManager.readFileAsString(fp) : undefined;
+    if (!body && localId) {
+        body = await readHtmlBodyFromChildStorageArweave(localId);
+    }
+    return body;
+}
+
+export { readHtmlBodyForStorageSeedPropertyValue, resolveHtmlStorageSeedLocalId };
+//# sourceMappingURL=readHtmlBodyForStorageSeed-D6KPtWoR.js.map

package/dist/readHtmlBodyForStorageSeed-D6KPtWoR.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readHtmlBodyForStorageSeed-D6KPtWoR.js","sources":["../../src/helpers/readHtmlBodyForStorageSeed.ts"],"sourcesContent":["import { BaseFileManager } from '@/helpers/FileManager/BaseFileManager'\nimport { fetchArweaveRawTextAcrossGateways } from '@seedprotocol/arweave'\n\n/** Published storage seeds use `0x` + 64 hex; `saveHtml` still writes `html/{localId}.html`. */\nconst SEED_UID_HEX_RE = /^0x[a-fA-F0-9]{64}$/\n\n/** Arweave L1 transaction ids are 43 URL-safe base64 characters. */\nconst ARWEAVE_TX_ID_IN_STRING_RE = /[a-z0-9_-]{43}/i\n\nfunction extractArweaveTransactionId(raw: string): string {\n  const t = raw.trim()\n  const embedded = t.match(ARWEAVE_TX_ID_IN_STRING_RE)\n  if (embedded && /^[a-z0-9_-]{43}$/i.test(embedded[0])) {\n    return embedded[0]\n  }\n  return t\n}\n\n/**\n * GET /raw/{txId} on each read gateway, preferred ones ({@link setPreferredArweaveReadBaseUrls})\n * first. Avoids arweave.js /tx/.../offset which often 404s on arweave.net while another gateway\n * (e.g. ar.seedprotocol.io, or the one the item was just uploaded through) still serves the data.\n */\nasync function fetchHtmlViaRawAcrossGateways(txId: string): Promise<string | undefined> {\n  const id = extractArweaveTransactionId(txId)\n  if (!id || SEED_UID_HEX_RE.test(id)) return undefined\n  return fetchArweaveRawTextAcrossGateways(id)\n}\n\n/**\n * Resolve the Html storage seed's `local_id` used for the `{localId}.html` file name.\n * `propertyValue` on the parent Html property is either that local id or the seed uid after publish.\n */\nexport async function resolveHtmlStorageSeedLocalId(\n  propertyValue: string | null | undefined,\n): Promise<string | undefined> {\n  const pv = String(propertyValue ?? '').trim()\n  if (!pv) return undefined\n  if (SEED_UID_HEX_RE.test(pv)) {\n    const { findSeedRow } = await import('../db/read/findSeedRow')\n    return (await findSeedRow({ uid: pv }))?.localId ?? undefined\n  }\n  return pv\n}\n\n/**\n * When the local draft file is gone (new device, OPFS cleared, etc.), load HTML from the\n * Html storage seed's published Arweave transaction id: a read gateway's `/raw`, then the Arweave\n * client, then a download into `html/` (named after the seed or the transaction).\n */\nasync function readHtmlBodyFromChildStorageArweave(seedLocalId: string): Promise<string | undefined> {\n  const { storageSeedTransactionId } = await import('@/storageValue/resolve')\n  const txId = await storageSeedTransactionId({ seedLocalId })\n  if (!txId || SEED_UID_HEX_RE.test(txId)) return undefined\n\n  const rawHtml = await fetchHtmlViaRawAcrossGateways(txId)\n  if (rawHtml) return rawHtml\n\n  try {\n    const { BaseArweaveClient } = await import('@seedprotocol/arweave')\n    const data = await BaseArweaveClient.getTransactionData(extractArweaveTransactionId(txId), {\n      string: true,\n    })\n    if (typeof data === 'string' && data.length > 0) return data\n  } catch {\n    /* offline / bad tx id */\n  }\n\n  try {\n    const { downloadTransactionIdWithDedupe } = await import('../events/files/download')\n    await downloadTransactionIdWithDedupe(txId)\n    const { findFileInDir } = await import('@/storageValue/findFile')\n    const filePath = await findFileInDir('html', [`${seedLocalId}.html`, extractArweaveTransactionId(txId)])\n    if (filePath) return BaseFileManager.readFileAsString(filePath)\n  } catch {\n    /* OPFS unsupported or download failed */\n  }\n  return undefined\n}\n\n/** Read saved HTML body for a parent Html property whose `propertyValue` points at the Html storage seed. */\nexport async function readHtmlBodyForStorageSeedPropertyValue(\n  propertyValue: string | null | undefined,\n): Promise<string | undefined> {\n  const pv = String(propertyValue ?? '').trim()\n  if (!pv) return undefined\n  const localId = await resolveHtmlStorageSeedLocalId(propertyValue)\n  const fp = localId ? BaseFileManager.getFilesPath('html', `${localId}.html`) : ''\n  let fileExists = fp ? await BaseFileManager.pathExists(fp) : false\n  // OPFS: file can appear shortly after create/download; avoid false \"missing\" before hitting Arweave.\n  if (!fileExists && fp) {\n    await BaseFileManager.waitForFileWithContent(fp, 100, 5000).catch(() => {})\n    fileExists = await BaseFileManager.pathExists(fp)\n  }\n  let body = fileExists && fp ? await BaseFileManager.readFileAsString(fp) : undefined\n\n  if (!body && localId) {\n    body = await readHtmlBodyFromChildStorageArweave(localId)\n  }\n\n  return body\n}\n"],"names":[],"mappings":";;;;;;AAGA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAe,GAAG,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAqB;AAE7C,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA;AACA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAM,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CA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"}

package/dist/seedSchema/ModelSchema.ts

@@ -44,6 +44,10 @@ export const properties = sqliteTable(
     storageType: text('storage_type'), // 'ItemStorage' | 'PropertyStorage'
     localStorageDir: text('local_storage_dir'), // storage.path, e.g. '/html'
     filenameSuffix: text('filename_suffix'), // storage.extension, e.g. '.html'
+    // The whole definition as JSON: the schema file's property object, or a code-defined one
+    // (validation, htmlEmbeddedDataUriPolicy, description and any other field). The columns above
+    // win for the fields they hold. Read through helpers/propertyDefinition.
+    definition: text('definition'),
   },
   (table) => {
     return {

package/dist/seedSchema/ModelSchemaSchema.ts

@@ -1,4 +1,4 @@
-import { integer, sqliteTable } from 'drizzle-orm/sqlite-core';
+import { integer, sqliteTable, unique } from 'drizzle-orm/sqlite-core';
 import { InferSelectModel } from 'drizzle-orm';
 import { schemas } from './SchemaSchema';
 import { models } from './ModelSchema';
@@ -7,6 +7,9 @@ export const modelSchemas = sqliteTable('model_schemas', {
   id: integer('id').primaryKey({ autoIncrement: true }),
   modelId: integer('model_id').references(() => models.id),
   schemaId: integer('schema_id').references(() => schemas.id),
-})
+}, (table) => [
+  // One link per model and schema (migration 0029)
+  unique('model_schemas_model_id_schema_id_unique').on(table.modelId, table.schemaId),
+])
 
 export type ModelSchemaType = InferSelectModel<typeof modelSchemas>

package/dist/seedSchema/PendingWriteSchema.ts

@@ -20,7 +20,10 @@ export const pendingWrites = sqliteTable(
     kind: text('kind').notNull(),
     /** JSON-encoded value. */
     value: text('value'),
-    /** Unused: a storage op's staged path is in its JSON value. Kept until a migration drops it. */
+    /**
+     * A storage op's staged file: the assigned bytes, written by the tab that appended the op (an
+     * ItemStorage op's staged path is in its JSON value too).
+     */
     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'),

package/dist/seedSchema/SchemaSchema.ts

@@ -12,6 +12,9 @@ export const schemas = sqliteTable(
     schemaData: text('schema_data'), // Full JSON schema content (SchemaFileFormat as JSON string)
     isDraft: integer('is_draft', { mode: 'boolean' }), // true if schema is in draft/editing state, false if published to file
     isEdited: integer('is_edited', { mode: 'boolean' }), // true if schema has been edited locally, false if matches schema file
+    // Hash of the schema file applySchemaFile last wrote to the rows (with schema_file_id and
+    // version): a file with the same three is not applied again.
+    contentHash: text('content_hash'),
     createdAt: int('created_at'),
     updatedAt: int('updated_at'),
   },

package/dist/seedSchema/SeedSchema.ts

@@ -1,5 +1,6 @@
 import { InferSelectModel } from 'drizzle-orm'
-import { index, int, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+import { index, int, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core'
+import { attestedUidSql } from './attestedUid'
 
 export const seeds = sqliteTable(
   'seeds',
@@ -24,7 +25,12 @@ export const seeds = sqliteTable(
     _markedForDeletion: int('_marked_for_deletion'),
     revokedAt: int('revoked_at'),
   },
-  (table) => [index('seeds_uid_idx').on(table.uid), index('seeds_type_idx').on(table.type)],
+  (table) => [
+    index('seeds_uid_idx').on(table.uid),
+    index('seeds_type_idx').on(table.type),
+    // One row per attested seed uid (migration 0029). Drafts hold a placeholder uid and are left out.
+    uniqueIndex('seeds_attested_uid_unique').on(table.uid).where(attestedUidSql(table.uid)),
+  ],
   // {
   //   triggers: [
   //     sql<string>`CREATE TRIGGER IF NOT EXISTS seeds_created_at_trigger

package/dist/seedSchema/VersionSchema.ts

@@ -1,4 +1,5 @@
-import { index, int, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+import { index, int, sqliteTable, text, uniqueIndex } from 'drizzle-orm/sqlite-core'
+import { attestedUidSql } from './attestedUid'
 import { InferSelectModel } from 'drizzle-orm'
 
 export const versions = sqliteTable('versions', {
@@ -23,6 +24,10 @@ export const versions = sqliteTable('versions', {
    * unpublish time until sync confirms it). Null while live or unpublished.
    */
   revokedAt: int('revoked_at'),
-}, (table) => [index('versions_seed_local_id_idx').on(table.seedLocalId)])
+}, (table) => [
+  index('versions_seed_local_id_idx').on(table.seedLocalId),
+  // One row per attested version uid (migration 0029). Drafts hold a placeholder uid and are left out.
+  uniqueIndex('versions_attested_uid_unique').on(table.uid).where(attestedUidSql(table.uid)),
+])
 
 export type VersionsType = InferSelectModel<typeof versions>

package/dist/seedSchema/attestedUid.ts

@@ -0,0 +1,10 @@
+import { sql, type SQL } from 'drizzle-orm'
+import type { SQLiteColumn } from 'drizzle-orm/sqlite-core'
+
+/**
+ * True for a stored attestation uid, false for the placeholders a draft row holds (NULL, '',
+ * 'NULL', ZERO_BYTES32; see `isPlaceholderUid` in @seedprotocol/eas). The predicate of the partial
+ * unique indexes on `seeds.uid` and `versions.uid`.
+ */
+export const attestedUidSql = (column: SQLiteColumn): SQL =>
+  sql`${column} IS NOT NULL AND trim(${column}) NOT IN ('', 'NULL') AND lower(trim(${column})) != '0x0000000000000000000000000000000000000000000000000000000000000000'`

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

@@ -6,21 +6,25 @@ import type { ItemCreateOptions } from '../types';
 import type { ItemPublishOptions } from '../helpers/publishConfig';
 import { BehaviorSubject } from 'rxjs';
 import { ActorRefFrom, Subscription } from 'xstate';
+import { EntityCache } from '../helpers/entity/entityCache';
 export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T> {
-    protected static instanceCache: Map<string, {
-        instance: Item<any>;
-        refCount: number;
-    }>;
+    /** Cached under its seedLocalId and seed uid. */
+    static readonly cache: EntityCache<Item<any>>;
     protected _subscription: Subscription | undefined;
     protected readonly _storageTransactionId: string | undefined;
     protected _propertiesSubject: BehaviorSubject<Record<string, IItemProperty>>;
     protected readonly _service: ActorRefFrom<typeof itemMachineSingle>;
     constructor(initialValues: NewItemProps<T>);
-    /** Prefer local id so list rows (local + uid) resolve the same cache entry as early draft loads. */
-    private static findItemInstanceCacheEntryByProps;
-    private static findItemInstanceCacheEntryById;
-    private static collectInstanceCacheKeysForInstance;
-    private static registerItemInInstanceCache;
+    /**
+     * Cache a new item under its ids and keep its keys in step with them (a seed uid arrives on
+     * publish, moves on republish), then start its load.
+     */
+    private static cacheAndLoad;
+    /**
+     * Load the item's seed, version and property rows into its context, then wait for its
+     * properties to load (Html and File content included), so a ready item reads its values.
+     */
+    private static load;
     /**
      * 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
@@ -42,33 +46,20 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
     /**
      * 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
-     * one, so `revokedAt` is cleared, and the instance cache's uid alias moves to the new uid.
+     * one, so `revokedAt` is cleared (the cache's uid key follows the context: see cacheAndLoad).
      */
     private static sendTrackedPropertyUpdate;
-    /** Drops one holder's reference. Returns true while other holders still have the instance. */
-    private static releaseItemInstanceCacheHold;
-    /**
-     * 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).
-     */
-    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
-     * no cache hold, so React hooks can call it during render.
+     * The cached Item for a seedLocalId or seedUid when it can be read right now (loaded, with its
+     * properties: `status` ready), so 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: string | undefined): Item<any> | 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.
-     */
-    private static waitForItemInstanceReadyForRead;
-    private static itemCacheEntryLooksUnhydratedAfterIdle;
     static create<_T extends ModelValues<ModelSchema>>(props: Partial<ItemData> & {
         modelInstance?: import('../Model/Model').Model;
     }, options?: ItemCreateOptions): Promise<Item<any>>;
@@ -126,9 +117,9 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
         signal?: AbortSignal;
     }): Promise<Item<any>[]>;
     /**
-     * After EAS sync writes metadata for the latest version, merge new property instances and
-     * re-run DB hydration on cached Items. Item liveQuery watches seeds/versions, not metadata,
-     * and useItems may not invalidate when the seed set is unchanged.
+     * Node only (decision D3): after EAS sync, adds new property instances to cached Items and
+     * re-reads their idle properties. Node has no change feed, so this is how loaded items there see
+     * what sync wrote, including recorded conflicts. The browser's feed watches cover both.
      */
     static rehydrateCachedItemsFromDbAfterEasSync(): Promise<void>;
     protected _createPropertyInstance(props: Partial<CreatePropertyInstanceProps>): void;
@@ -167,6 +158,7 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
     getPublishUploads: (options?: import("../db/read/getPublishUploads").GetPublishUploadsOptions) => Promise<import("../types").PublishUpload[]>;
     getPublishPayload: (uploadedTransactions: any[], options?: import("../db/read/getPublishPayload").GetPublishPayloadOptions) => Promise<{
         localId: string;
+        versionLocalId?: string;
         seedIsRevocable: boolean;
         seedSchemaUid: string;
         seedUid: string;
@@ -176,13 +168,17 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
             data: import("@ethereum-attestation-service/eas-sdk").AttestationRequestData[];
             _propertyName?: string;
             _metadataLocalId?: string;
+            _attestedValue?: string;
             _propertyNameForSchema?: string;
             _schemaDef?: string;
             _unresolvedValue?: string;
             _easDataType?: string;
             _rawListIdsForResolve?: string[];
         })[];
-        propertiesToUpdate: any[];
+        propertiesToUpdate: {
+            publishLocalId: string;
+            propertySchemaUid: string;
+        }[];
     }[]>;
     persistSeedUid: (publisher?: string, attestationCreatedAtMs?: number) => Promise<void>;
     get serviceContext(): any;
@@ -191,6 +187,12 @@ export declare class Item<T extends ModelValues<ModelSchema>> implements IItem<T
      * Used by the reactive proxy to read tracked properties
      */
     _getSnapshotContext(): import("../types").ItemMachineContext<any>;
+    /** `loading` until the item and its properties are loaded, then `ready` or `error`. */
+    get status(): 'loading' | 'ready' | 'error';
+    /** Resolves once `status` is `ready`; rejects when the load failed or `timeout` ms pass. */
+    waitForReady(options?: {
+        timeout?: number;
+    }): Promise<void>;
     get seedLocalId(): string;
     get seedUid(): string | undefined;
     get schemaUid(): string | undefined;

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/loadItem.d.ts

@@ -0,0 +1,12 @@
+import { ItemMachineContext } from '../types/item';
+/** What a load sets on the item's context (applied by the machine's `loaded`). */
+export type LoadedItem = Record<string, unknown> & {
+    propertyInstances?: Map<string, any>;
+};
+/**
+ * Load an item from its seed row: version data, and its properties' instances from their current
+ * rows (plus one per model property without a row). An item whose seed has no row yet (created
+ * elsewhere) loads as new.
+ */
+export declare function loadItem(context: ItemMachineContext<any>): Promise<LoadedItem>;
+//# sourceMappingURL=loadItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadItem.d.ts","sourceRoot":"","sources":["../../../src/Item/loadItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAejD,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAAA;AAwM3F;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAkKpF"}

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

@@ -3,20 +3,12 @@ import { ItemMachineContext } from '../../types';
 import type { ItemPublishOptions } from '../../helpers/publishConfig';
 import type { IItem } from '../../interfaces/IItem';
 export declare const itemMachineSingle: import("xstate").StateMachine<ItemMachineContext<any>, import("xstate").AnyEventObject, {
-    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../../types").FromCallbackInput<ItemMachineContext<any>>, import("xstate").EventObject> | import("xstate").CallbackActorLogic<import("xstate").EventObject, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").CallbackActorLogic<import("xstate").EventObject, {
         context: ItemMachineContext<any>;
         item?: IItem<any>;
         options?: ItemPublishOptions;
     }, import("xstate").EventObject>> | undefined;
 }, {
-    src: "waitForDb";
-    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../../types").FromCallbackInput<ItemMachineContext<any>>, import("xstate").EventObject>;
-    id: string | undefined;
-} | {
-    src: "loadOrCreateItem";
-    logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, import("../../types").FromCallbackInput<ItemMachineContext<any>>, import("xstate").EventObject>;
-    id: string | undefined;
-} | {
     src: "runPublish";
     logic: import("xstate").CallbackActorLogic<import("xstate").EventObject, {
         context: ItemMachineContext<any>;
@@ -24,14 +16,11 @@ export declare const itemMachineSingle: import("xstate").StateMachine<ItemMachin
         options?: ItemPublishOptions;
     }, import("xstate").EventObject>;
     id: string | undefined;
-}, never, never, never, "error" | "idle" | "loading" | "waitingForDb" | "publishing", string, {}, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+}, never, never, never, "idle" | "publishing", string, {}, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
     id: MachineIds.ITEM;
     states: {
         readonly idle: {};
         readonly publishing: {};
-        readonly waitingForDb: {};
-        readonly loading: {};
-        readonly error: {};
     };
 }, import("xstate").MetaObject>;
 //# sourceMappingURL=itemMachineSingle.d.ts.map

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAuM5B,CAAA"}
+{"version":3,"file":"itemMachineSingle.d.ts","sourceRoot":"","sources":["../../../../src/Item/service/itemMachineSingle.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAG/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;+BAmK5B,CAAA"}