@seedprotocol/sdk 0.6.10 → 0.7.1

package/dist/src/db/read/batchLatestPublishedVersionBySeedLocalIds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batchLatestPublishedVersionBySeedLocalIds.d.ts","sourceRoot":"","sources":["../../../../src/db/read/batchLatestPublishedVersionBySeedLocalIds.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,uBAAuB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE7E;;;GAGG;AACH,wBAAsB,yCAAyC,CAC7D,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAuC/C"}
+{"version":3,"file":"batchLatestPublishedVersionBySeedLocalIds.d.ts","sourceRoot":"","sources":["../../../../src/db/read/batchLatestPublishedVersionBySeedLocalIds.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,uBAAuB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE7E;;;GAGG;AACH,wBAAsB,yCAAyC,CAC7D,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAmD/C"}

package/dist/src/db/read/getItemData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getItemData.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItemData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAY,MAAM,SAAS,CAAA;AAiB/C;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,WA0KzB,CAAA"}
+{"version":3,"file":"getItemData.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItemData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAY,MAAM,SAAS,CAAA;AAkB/C;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,WAsLzB,CAAA"}

package/dist/src/db/read/getItemProperties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getItemProperties.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItemProperties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgB,MAAM,SAAS,CAAA;AAOzD,eAAO,MAAM,iBAAiB,EAAE,iBAgD/B,CAAA"}
+{"version":3,"file":"getItemProperties.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItemProperties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAgB,MAAM,SAAS,CAAA;AAOzD,eAAO,MAAM,iBAAiB,EAAE,iBAkC/B,CAAA"}

package/dist/src/db/read/getItems.d.ts

@@ -1,6 +1,10 @@
 import { ItemData } from '../../types';
 type GetItemsDataProps = {
     modelName?: string;
+    /** Restrict to items of one model (seeds.model_file_id), by its Model.id ... */
+    modelFileId?: string;
+    /** ... or by the schema that defines `modelName`. */
+    schemaName?: string;
     deleted?: boolean;
     includeEas?: boolean;
     addressFilter?: 'owned' | 'watched' | 'all';
@@ -11,9 +15,10 @@ type GetItemsData = (props: GetItemsDataProps) => Promise<ItemData[]>;
  *
  * - `includeEas: false` (default): drafts only — `seeds.uid` is null, empty, legacy `'NULL'`, or zero-bytes32.
  *   On-chain seeds (real EAS seed UID) require `includeEas: true`.
- * - `latestVersionUid` / `latestVersionLocalId`: head version **row** by `created_at` (may be unattested).
+ * - `latestVersionUid` / `latestVersionLocalId`: head version **row** by `created_at` (may be unattested),
+ *   skipping revoked versions; null when every version is revoked.
  * - `publishedVersionUid` / `publishedVersionLocalId`: filled in a second batched read (same rules as
- *   `getLatestPublishedVersionRow`).
+ *   `getLatestPublishedVersionRow`: attested and not revoked).
  */
 export declare const getItemsData: GetItemsData;
 export {};

package/dist/src/db/read/getItems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getItems.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAWlC,KAAK,iBAAiB,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;CAC5C,CAAA;AAED,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,YAgG1B,CAAA"}
+{"version":3,"file":"getItems.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAWlC,KAAK,iBAAiB,GAAG;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;CAC5C,CAAA;AAED,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;AAErE;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,EAAE,YA4G1B,CAAA"}

package/dist/src/db/read/getLatestPublishedVersionRow.d.ts

@@ -5,7 +5,8 @@ export type PublishedVersionRow = {
 };
 /**
  * Latest version row for the seed (by createdAt) whose uid is a real EAS attestation id.
- * Skips legacy 'NULL' / ZERO_BYTES32 placeholders and non-bytes32 strings.
+ * Skips legacy 'NULL' / ZERO_BYTES32 placeholders, non-bytes32 strings, and revoked versions
+ * (`revoked_at` set): after a full unpublish the seed has no published version.
  */
 export declare function getLatestPublishedVersionRow(seedLocalId: string): Promise<PublishedVersionRow | null>;
 //# sourceMappingURL=getLatestPublishedVersionRow.d.ts.map

package/dist/src/db/read/getLatestPublishedVersionRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getLatestPublishedVersionRow.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getLatestPublishedVersionRow.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAwBrC"}
+{"version":3,"file":"getLatestPublishedVersionRow.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getLatestPublishedVersionRow.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAwBrC"}

package/dist/src/db/read/getLatestVersionRow.d.ts

@@ -0,0 +1,13 @@
+export type LatestVersionRow = {
+    localId: string | null;
+    uid: string | null;
+    createdAt: number | null;
+    attestationCreatedAt: number | null;
+};
+/**
+ * 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.
+ */
+export declare function getLatestVersionRow(seedLocalId: string): Promise<LatestVersionRow | null>;
+//# sourceMappingURL=getLatestVersionRow.d.ts.map

package/dist/src/db/read/getLatestVersionRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestVersionRow.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getLatestVersionRow.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAiB/F"}

package/dist/src/db/read/getModelSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getModelSchemas.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getModelSchemas.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,KAAK,qBAAqB,GAAG;IAC3B,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnD,YAAY,EAAE,WAAW,EAAE,CAAA;CAC5B,CAAA;AAED,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAE3D,eAAO,MAAM,eAAe,EAAE,eAoD7B,CAAA"}
+{"version":3,"file":"getModelSchemas.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getModelSchemas.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,KAAK,qBAAqB,GAAG;IAC3B,yBAAyB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnD,YAAY,EAAE,WAAW,EAAE,CAAA;CAC5B,CAAA;AAED,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAE3D,eAAO,MAAM,eAAe,EAAE,eAqD7B,CAAA"}

package/dist/src/db/read/getPropertyData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPropertyData.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPropertyData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAItC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAQnD,eAAO,MAAM,eAAe,GAAU,oDAKnC,sBAAsB,KAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CA4D3D,CAAA"}
+{"version":3,"file":"getPropertyData.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPropertyData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAItC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AASnD,eAAO,MAAM,eAAe,GAAU,oDAKnC,sBAAsB,KAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAyD3D,CAAA"}

package/dist/src/db/read/getPublishPayload.d.ts

@@ -1,13 +1,26 @@
 import { AttestationRequest, AttestationRequestData } from '@ethereum-attestation-service/eas-sdk';
+import { IItemProperty } from '../../interfaces';
 import { IItem } from '../../interfaces';
-import type { ValidationError } from '../../Schema/validation';
-/** Validation error collected during publish payload building. */
-export type PublishValidationError = Pick<ValidationError, 'field' | 'message'> & {
-    code?: string;
-};
+import { PublishValidationFailedError, type PublishValidationError, type UnpublishedRelatedItem } from './publishErrors';
+export { PublishValidationFailedError, type PublishValidationError };
 /** Context for collecting validation errors instead of throwing on first error. */
 export type PublishValidationContext = {
     errors: PublishValidationError[];
+    /** Refs to seeds whose attestation was revoked; publish stops with RelatedItemUnpublishedError. */
+    unpublishedRelatedItems?: UnpublishedRelatedItem[];
+    /**
+     * Relation/list/image refs (local id, or a republished seed's old uid) to seeds that are
+     * published and live, mapped to their current uid: the parent attests that uid.
+     */
+    relatedRefUids?: Map<string, string>;
+    /**
+     * Items getting a new seed in this publish whose payload is still being built (the root when it
+     * gets a new seed, and the related drafts being walked). A ref to one of them is a cycle back
+     * edge: see publishDraftGraph.ts.
+     */
+    newSeedsInProgress?: Set<string>;
+    /** Properties left out of this publish because they point back at an item in progress. */
+    deferredProperties?: Set<IItemProperty<any>>;
 };
 /** `patch` (default): new property attestations on the current Version. `new_version`: new Version attestation + attest all properties. */
 export type PublishMode = 'patch' | 'new_version';
@@ -42,11 +55,6 @@ type UploadedTransaction = {
     versionLocalId?: string;
     itemPropertyName?: string;
 };
-/** Error thrown when publish validation fails. Includes all validation errors for user to fix. */
-export declare class PublishValidationFailedError extends Error {
-    readonly validationErrors: PublishValidationError[];
-    constructor(message: string, validationErrors: PublishValidationError[]);
-}
 export declare const getPublishPayload: (item: IItem<any>, uploadedTransactions: UploadedTransaction[], options?: GetPublishPayloadOptions) => Promise<MultiPublishPayload>;
 export type ValidateItemForPublishResult = {
     isValid: boolean;
@@ -64,5 +72,4 @@ export declare const validateItemForPublish: (item: IItem<any>, uploadedTransact
  * Returns an updated multiPayload with re-encoded attestations where resolution was applied.
  */
 export declare const resolvePublishPayloadValues: (multiPayload: MultiPublishPayload, resolvedUids: ResolvedSeedUids) => Promise<MultiPublishPayload>;
-export {};
 //# sourceMappingURL=getPublishPayload.d.ts.map

package/dist/src/db/read/getPublishPayload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPublishPayload.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishPayload.ts"],"names":[],"mappings":"AASA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEvB,MAAM,uCAAuC,CAAA;AA0B9C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAIpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAS1D,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG,mFAAmF;AACnF,MAAM,MAAM,wBAAwB,GAAG;IAAE,MAAM,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAAA;AAE3E,2IAA2I;AAC3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAA;AAEjD,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAgpCD,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG;QACtD,IAAI,EAAE,sBAAsB,EAAE,CAAA;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,sBAAsB,CAAC,EAAE,MAAM,CAAA;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;KACjC,CAAC,EAAE,CAAA;IACJ,kBAAkB,EAAE,GAAG,EAAE,CAAA;CAC1B,CAAA;AAED,KAAK,mBAAmB,GAAG,cAAc,EAAE,CAAA;AAiF3C,8HAA8H;AAC9H,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAoFD,kGAAkG;AAClG,qBAAa,4BAA6B,SAAQ,KAAK;aAGnC,gBAAgB,EAAE,sBAAsB,EAAE;gBAD1D,OAAO,EAAE,MAAM,EACC,gBAAgB,EAAE,sBAAsB,EAAE;CAK7D;AAED,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,sBAAsB,mBAAmB,EAAE,EAC3C,UAAU,wBAAwB,KACjC,OAAO,CAAC,mBAAmB,CA+M7B,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,sBAAsB,EAAE,CAAA;CACjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,uBAAsB,mBAAmB,EAAO,EAChD,UAAU,wBAAwB,KACjC,OAAO,CAAC,4BAA4B,CAUtC,CAAA;AAsKD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,mBAAmB,EACjC,cAAc,gBAAgB,KAC7B,OAAO,CAAC,mBAAmB,CAqH7B,CAAA"}
+{"version":3,"file":"getPublishPayload.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishPayload.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EAEvB,MAAM,uCAAuC,CAAA;AAsB9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAM5C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAYpC,OAAO,EACL,4BAA4B,EAE5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAA;AAUhC,OAAO,EAAE,4BAA4B,EAAE,KAAK,sBAAsB,EAAE,CAAA;AAEpE,mFAAmF;AACnF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,sBAAsB,EAAE,CAAA;IAChC,mGAAmG;IACnG,uBAAuB,CAAC,EAAE,sBAAsB,EAAE,CAAA;IAClD;;;OAGG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAChC,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;CAC7C,CAAA;AAyDD,2IAA2I;AAC3I,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAA;AAEjD,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AA6xCD,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG;QACtD,IAAI,EAAE,sBAAsB,EAAE,CAAA;QAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,sBAAsB,CAAC,EAAE,MAAM,CAAA;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;KACjC,CAAC,EAAE,CAAA;IACJ,kBAAkB,EAAE,GAAG,EAAE,CAAA;CAC1B,CAAA;AAED,KAAK,mBAAmB,GAAG,cAAc,EAAE,CAAA;AAiF3C,8HAA8H;AAC9H,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAoFD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,sBAAsB,mBAAmB,EAAE,EAC3C,UAAU,wBAAwB,KACjC,OAAO,CAAC,mBAAmB,CA4N7B,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,sBAAsB,EAAE,CAAA;CACjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,uBAAsB,mBAAmB,EAAO,EAChD,UAAU,wBAAwB,KACjC,OAAO,CAAC,4BAA4B,CAUtC,CAAA;AAsKD;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,mBAAmB,EACjC,cAAc,gBAAgB,KAC7B,OAAO,CAAC,mBAAmB,CAqH7B,CAAA"}

package/dist/src/db/read/getPublishPendingDiff.d.ts

@@ -15,7 +15,8 @@ export type GetPublishPendingDiffResult = {
 };
 /**
  * Per property: the **latest** metadata row (by `attestationCreatedAt` / `createdAt`) lacks a valid
- * EAS attestation `uid` — local edit or missing post-publish UID backfill. **Not** equivalent to
+ * EAS attestation `uid` — local edit or missing post-publish UID backfill. Rows sync derived for
+ * ItemStorage properties (`derivedFromUid` set) count as published. **Not** equivalent to
  * draft vs onchain for the whole seed; use `getSeedPublishState` for that.
  */
 export declare function getPublishPendingDiff(arg: {

package/dist/src/db/read/getPublishPendingDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPublishPendingDiff.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishPendingDiff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAKzC,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kFAAkF;IAClF,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,qEAAqE;IACrE,iBAAiB,EAAE,0BAA0B,EAAE,CAAA;IAC/C,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;CACtC,CAAA;AAeD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAC3D,OAAO,CAAC,2BAA2B,CAAC,CAsEtC"}
+{"version":3,"file":"getPublishPendingDiff.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishPendingDiff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAKzC,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kFAAkF;IAClF,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,qEAAqE;IACrE,iBAAiB,EAAE,0BAA0B,EAAE,CAAA;IAC/C,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;CACtC,CAAA;AAeD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAC3D,OAAO,CAAC,2BAA2B,CAAC,CAqEtC"}

package/dist/src/db/read/getPublishUploads.d.ts

@@ -20,6 +20,11 @@ export type UploadProperty = {
     itemProperty: IItemProperty<any>;
     childProperties: IItemProperty<any>[];
 };
+/** Same walk as getPublishUploads: the item and the draft items its publish carries along. */
 export declare function itemHasPublishUploadCandidates(item: IItem<any>, relatedItemProperty?: IItemProperty<any>): Promise<boolean>;
+/**
+ * Arweave uploads for a publish of `item`: its own, and those of every draft item the publish
+ * carries along (reachable through relation and list properties, see publishDraftGraph.ts).
+ */
 export declare const getPublishUploads: (item: IItem<any>, uploads?: PublishUpload[], relatedItemProperty?: IItemProperty<any>, options?: GetPublishUploadsOptions) => Promise<PublishUpload[]>;
 //# sourceMappingURL=getPublishUploads.d.ts.map

package/dist/src/db/read/getPublishUploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPublishUploads.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishUploads.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAQ/C,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAA;IACpC;;OAEG;IACH,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAA;IACvC;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAA;IACtC,qGAAqG;IACrG,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AA2BD,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,GAAG,UAAU,EACzB,aAAa,MAAM,GAAG,SAAS,EAC/B,cAAc,MAAM,EACpB,iBAAiB,cAAc,EAAE,KAChC,OAAO,CAAC,kBAAkB,CAmB5B,CAAA;AAwKD,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;IAChC,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CACtC,CAAA;AAyFD,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAChB,mBAAmB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GACvC,OAAO,CAAC,OAAO,CAAC,CAsDlB;AAgID,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,aAAa,EAAO,EAC7B,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,6BAqEnC,CAAA"}
+{"version":3,"file":"getPublishUploads.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishUploads.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAS/C,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAA;IACpC;;OAEG;IACH,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAA;IACvC;;OAEG;IACH,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAA;IACtC,qGAAqG;IACrG,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AA2BD,eAAO,MAAM,yBAAyB,GACpC,MAAM,MAAM,GAAG,UAAU,EACzB,aAAa,MAAM,GAAG,SAAS,EAC/B,cAAc,MAAM,EACpB,iBAAiB,cAAc,EAAE,KAChC,OAAO,CAAC,kBAAkB,CAmB5B,CAAA;AAwKD,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;IAChC,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CACtC,CAAA;AAwJD,8FAA8F;AAC9F,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAChB,mBAAmB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GACvC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAyND;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,aAAa,EAAO,EAC7B,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,6BAcnC,CAAA"}

package/dist/src/db/read/getSchemaUidForModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSchemaUidForModel.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getSchemaUidForModel.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,KAChB,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAgDnC,CAAA"}
+{"version":3,"file":"getSchemaUidForModel.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getSchemaUidForModel.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,KAChB,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAmDnC,CAAA"}

package/dist/src/db/read/getSeedPublishState.d.ts

@@ -1,6 +1,9 @@
 import type { IItem } from '../../interfaces';
 export type SeedPublishState = {
-    /** `onchain` when any local row carries a valid EAS attestation UID for this seed. */
+    /**
+     * `onchain` when any local row carries a valid EAS attestation UID for this seed, revoked ones
+     * included (they stay on-chain). Check `revokedAt` to tell an unpublished seed apart.
+     */
     status: 'draft' | 'onchain';
     seedAttestationUid: string | null;
     versionAttestationUid: string | null;
@@ -8,10 +11,13 @@ export type SeedPublishState = {
     explorerUid: string | null;
     /** Best-effort max attestation time (ms) from seed, version, or metadata rows. */
     lastAttestedAtMs: number | null;
+    /** Unix seconds when the seed attestation was revoked (`item.unpublish()` or EAS sync), else null. */
+    revokedAt: number | null;
 };
 /**
  * Whether the seed has **any** on-chain anchor in local SQLite: valid EAS UID on the seed row,
- * on the newest **published** version row (`getLatestPublishedVersionRow`), or on **any** metadata row.
+ * on the newest **published** version row (`getLatestPublishedVersionRow`, which skips revoked
+ * versions), or on **any** metadata row.
  * Not the same as “no unpublished edits”; see `getPublishPendingDiff` for per-property head rows.
  */
 export declare function getSeedPublishState(arg: {

package/dist/src/db/read/getSeedPublishState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getSeedPublishState.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getSeedPublishState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sFAAsF;IACtF,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,yFAAyF;IACzF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC,CAAA;AAuBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAC3D,OAAO,CAAC,gBAAgB,CAAC,CAkE3B"}
+{"version":3,"file":"getSeedPublishState.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getSeedPublishState.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,yFAAyF;IACzF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,kFAAkF;IAClF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,sGAAsG;IACtG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAuBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAC3D,OAAO,CAAC,gBAAgB,CAAC,CAoE3B"}

package/dist/src/db/read/isSeedRevoked.d.ts

@@ -0,0 +1,7 @@
+/**
+ * True when the item's seed attestation was revoked (`seeds.revoked_at` set, by unpublish or EAS
+ * sync). Such a seed can't take new versions: publishing again creates a new seed attestation
+ * (see "Republishing" in docs/ATTESTATION_REVOCATION.md).
+ */
+export declare const isSeedRevoked: (seedLocalId: string | undefined) => Promise<boolean>;
+//# sourceMappingURL=isSeedRevoked.d.ts.map

package/dist/src/db/read/isSeedRevoked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSeedRevoked.d.ts","sourceRoot":"","sources":["../../../../src/db/read/isSeedRevoked.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAU,aAAa,MAAM,GAAG,SAAS,KAAG,OAAO,CAAC,OAAO,CAUpF,CAAA"}

package/dist/src/db/read/publishDraftGraph.d.ts

@@ -0,0 +1,57 @@
+import type { IItem, IItemProperty } from '../../interfaces';
+/**
+ * The draft items a publish of an item carries along, and how it walks to them.
+ *
+ * A publish attests the item and every draft item (no seed uid yet) reachable from it through
+ * relation and list-of-relation properties, each with its full property set. Already-published
+ * targets are referenced by their current uid and not walked into; revoked ones stop the publish
+ * (RelatedItemUnpublishedError). getPublishPayload, getPublishUploads, getPublishUploadData (publish
+ * package), summarizePublishWork and the Html-embedded image co-publish all walk this graph in the
+ * same order: depth first, properties in item order (relations, then lists), list members in order.
+ *
+ * Cycles: an item can only attest the uid of a seed published before it in the same publish, so a
+ * ref back to an item still being walked (an ancestor that gets a new seed in this publish) can't be
+ * attested. Such a property is deferred: left out of this publish (it keeps no uid, so the next
+ * publish of its item attests it, with the target's uid). For A ↔ B reached from A, A attests B's
+ * uid and B's relation to A is deferred.
+ */
+/** Relation properties that point at model items (not Image/File/Html/Json storage seeds). */
+export declare function draftWalkProperties(segmented: {
+    itemRelationProperties: IItemProperty<any>[];
+    itemImageProperties: IItemProperty<any>[];
+    itemListProperties: IItemProperty<any>[];
+}): {
+    relationProperties: IItemProperty<any>[];
+    listProperties: IItemProperty<any>[];
+};
+/** Seed refs held by a relation property (one) or a list property (each member). */
+export declare function propertySeedRefs(prop: IItemProperty<any>, isList: boolean): string[];
+/** The item gets a new seed attestation in this publish: a draft, or a revoked seed published again. */
+export declare function getsNewSeed(item: IItem<any>): Promise<boolean>;
+/** Local seed id a ref points at (also for a republished seed's old uid), or undefined. */
+export declare function resolveRefSeedLocalId(ref: string): Promise<string | undefined>;
+export type PublishDraftGraphNode = {
+    item: IItem<any>;
+    /** The relation or list property the walk first reached the item through. */
+    via: IItemProperty<any>;
+    viaList: boolean;
+};
+export type PublishDraftGraph = {
+    /** Draft items reachable from the root (root excluded), in the order the walk finishes them. */
+    drafts: PublishDraftGraphNode[];
+    /** Properties pointing back at an item still being walked; left out of this publish. */
+    deferredProperties: Set<IItemProperty<any>>;
+    /** For each deferred property, the seeds (local ids) of its back references. */
+    backReferences: Map<IItemProperty<any>, Set<string>>;
+};
+export type GetPublishDraftGraphOptions = {
+    /** `new_version` / republish: properties that already have a uid are attested (and walked) again. */
+    forceFullSnapshot?: boolean;
+    /**
+     * Throw like getPublishUploads always did when a relation holds an invalid value or a local id
+     * with no local item. Otherwise such refs are skipped (getPublishPayload reports them).
+     */
+    strict?: boolean;
+};
+export declare function getPublishDraftGraph(root: IItem<any>, options?: GetPublishDraftGraphOptions): Promise<PublishDraftGraph>;
+//# sourceMappingURL=publishDraftGraph.d.ts.map

package/dist/src/db/read/publishDraftGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishDraftGraph.d.ts","sourceRoot":"","sources":["../../../../src/db/read/publishDraftGraph.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIxD;;;;;;;;;;;;;;;GAeG;AAEH,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,SAAS,EAAE;IAC7C,sBAAsB,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IAC5C,mBAAmB,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;IACzC,kBAAkB,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CACzC,GAAG;IAAE,kBAAkB,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;IAAC,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CAAE,CAMrF;AASD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAsBpF;AAID,wGAAwG;AACxG,wBAAsB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE;AAED,2FAA2F;AAC3F,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKpF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAChB,6EAA6E;IAC7E,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gGAAgG;IAChG,MAAM,EAAE,qBAAqB,EAAE,CAAA;IAC/B,wFAAwF;IACxF,kBAAkB,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3C,gFAAgF;IAChF,cAAc,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAmBD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAChB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAyE5B"}

package/dist/src/db/read/publishErrors.d.ts

@@ -0,0 +1,37 @@
+import type { ValidationError } from '../../Schema/validation';
+/** Validation error collected during publish payload building. */
+export type PublishValidationError = Pick<ValidationError, 'field' | 'message'> & {
+    code?: string;
+};
+/** Error thrown when publish validation fails. Includes all validation errors for user to fix. */
+export declare class PublishValidationFailedError extends Error {
+    readonly validationErrors: PublishValidationError[];
+    constructor(message: string, validationErrors: PublishValidationError[]);
+}
+/** Validation error code for a relation, list member or image/file ref to an unpublished seed. */
+export declare const RELATED_ITEM_UNPUBLISHED_CODE = "related_item_unpublished";
+/** A seed a publish would reference although its seed attestation was revoked (unpublished). */
+export type UnpublishedRelatedItem = {
+    /** The referring property on the item being published (or on an item published with it). */
+    propertyName: string;
+    /** Model of the referenced item (e.g. `Author`, `Image`). */
+    modelName: string;
+    seedLocalId: string;
+    /** The revoked seed uid the reference would attest. */
+    seedUid: string;
+};
+export declare const describeUnpublishedRelatedItem: (r: UnpublishedRelatedItem) => string;
+/**
+ * Thrown before anything is uploaded or attested when the item references items whose seed was
+ * unpublished: the parent would attest a revoked seed uid. Republish those items (which gives
+ * them a new seed uid) or remove the references, then publish again.
+ * See docs/ATTESTATION_REVOCATION.md ("Republishing").
+ *
+ * A PublishValidationFailedError, so validateItemForPublish and the publish package's checking
+ * step report it as validation errors (code `related_item_unpublished`, one per reference).
+ */
+export declare class RelatedItemUnpublishedError extends PublishValidationFailedError {
+    readonly unpublishedRelatedItems: UnpublishedRelatedItem[];
+    constructor(unpublishedRelatedItems: UnpublishedRelatedItem[], otherValidationErrors?: PublishValidationError[]);
+}
+//# sourceMappingURL=publishErrors.d.ts.map

package/dist/src/db/read/publishErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishErrors.d.ts","sourceRoot":"","sources":["../../../../src/db/read/publishErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnG,kGAAkG;AAClG,qBAAa,4BAA6B,SAAQ,KAAK;aAGnC,gBAAgB,EAAE,sBAAsB,EAAE;gBAD1D,OAAO,EAAE,MAAM,EACC,gBAAgB,EAAE,sBAAsB,EAAE;CAK7D;AAED,kGAAkG;AAClG,eAAO,MAAM,6BAA6B,6BAA6B,CAAA;AAEvE,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAAG;IACnC,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAA;IACpB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAI,GAAG,sBAAsB,KAAG,MACC,CAAA;AAE5E;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,SAAQ,4BAA4B;IAC3E,QAAQ,CAAC,uBAAuB,EAAE,sBAAsB,EAAE,CAAA;gBAGxD,uBAAuB,EAAE,sBAAsB,EAAE,EACjD,qBAAqB,GAAE,sBAAsB,EAAO;CAoBvD"}

package/dist/src/db/read/resolveModelForSyncedSeed.d.ts

@@ -0,0 +1,39 @@
+/** Emitted when background work skips a seed whose model name exists in several schemas. */
+export declare const MODEL_AMBIGUOUS_EVENT: "model:ambiguous";
+export type ModelAmbiguousEventPayload = {
+    modelName: string;
+    schemaNames: string[];
+    seedLocalId?: string;
+    seedUid?: string;
+    /** What was being done when the seed was skipped (e.g. 'easSync.metadata'). */
+    context: string;
+};
+export type SyncedSeedInfo = {
+    seedUid?: string | null;
+    seedLocalId?: string | null;
+    /** seeds.type as synced from EAS (the EAS schema name, i.e. snake_case model name). */
+    modelType?: string | null;
+    /** EAS schema UID of the seed attestation. */
+    schemaUid?: string | null;
+};
+/**
+ * Seam for matching an EAS-synced seed to a local model (its schemaFileId).
+ *
+ * EAS identifies a seed's model only by name (`bytes32 <model_name>`), so when several local schemas
+ * define a model with that name the seed alone can't say which one it is. The plan is to match by
+ * the seed's properties and metadata (see docs/EAS_SYNCED_SEED_MODEL_RESOLUTION.md).
+ *
+ * TODO(eas-synced-seed-model-resolution): not implemented yet. Returns undefined, so callers fall
+ * back to the name, which throws AmbiguousModelError when the name is ambiguous.
+ */
+export declare const resolveModelForSyncedSeed: (_seed: SyncedSeedInfo) => Promise<string | undefined>;
+/**
+ * Run background work for one seed; if it hits an ambiguous model name, log, emit
+ * MODEL_AMBIGUOUS_EVENT and return undefined (skip) instead of failing the whole job. Loading the
+ * item directly still throws, so the problem surfaces where the app touches it.
+ */
+export declare const skipSeedOnAmbiguousModel: <T>(seed: {
+    seedLocalId?: string | null;
+    seedUid?: string | null;
+}, context: string, work: () => Promise<T>) => Promise<T | undefined>;
+//# sourceMappingURL=resolveModelForSyncedSeed.d.ts.map

package/dist/src/db/read/resolveModelForSyncedSeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveModelForSyncedSeed.d.ts","sourceRoot":"","sources":["../../../../src/db/read/resolveModelForSyncedSeed.ts"],"names":[],"mappings":"AAMA,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAG,iBAA0B,CAAA;AAE/D,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAU,OAAO,cAAc,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAEjG,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAU,CAAC,EAC9C,MAAM;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC9D,SAAS,MAAM,EACf,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,KACrB,OAAO,CAAC,CAAC,GAAG,SAAS,CAgBvB,CAAA"}

package/dist/src/db/read/resolveModelRecord.d.ts

@@ -0,0 +1,69 @@
+import { BaseDb } from '../Db/BaseDb';
+/**
+ * What is known about which model an item, property or lookup belongs to. Model names are only
+ * unique within a schema, so a bare name is ambiguous once two schemas define the same model.
+ */
+export type ModelScope = {
+    /** The model's schemaFileId (= Model.id, seeds.model_file_id). Most specific. */
+    modelFileId?: string | null;
+    /** The models row id (e.g. properties.model_id). */
+    modelId?: number | null;
+    schemaName?: string | null;
+    schemaId?: number | null;
+};
+export type ResolvedModelRecord = {
+    id: number;
+    name: string;
+    schemaFileId: string | null;
+};
+type Db = ReturnType<typeof BaseDb.getAppDb>;
+/**
+ * Resolve a models row from a model name plus whatever scope is known, most specific first:
+ * modelFileId, modelId, then schemaId/schemaName + name, then the name alone. The name alone is
+ * only accepted when it is unambiguous; otherwise this throws AmbiguousModelError.
+ */
+export declare const resolveModelRecord: (modelName: string | undefined | null, scope?: ModelScope, db?: Db | undefined) => Promise<ResolvedModelRecord | undefined>;
+/**
+ * resolveModelRecord for a model name **or** an EAS model type (snake_case model name, what sync
+ * stores in seeds.type): "New model" resolves from `new_model`. Scope and ambiguity behave as in
+ * resolveModelRecord: modelFileId/modelId first, then the schema, then the name(s) alone, which throws
+ * AmbiguousModelError when models in several schemas match.
+ */
+export declare const resolveModelRecordByNameOrType: (nameOrType: string | undefined | null, scope?: ModelScope, db?: Db | undefined) => Promise<ResolvedModelRecord | undefined>;
+/**
+ * Work out which model (schemaFileId) an item belongs to from whatever is at hand: an explicit
+ * modelFileId, the seed's model_file_id, or a metadata row's property_id → properties.model_id.
+ */
+export declare const resolveItemModelFileId: (hints: {
+    modelFileId?: string | null;
+    seedLocalId?: string | null;
+    seedUid?: string | null;
+    propertyId?: number | null;
+}, db?: Db | undefined) => Promise<string | undefined>;
+type ItemScopeContext = {
+    modelFileId?: string;
+    schemaName?: string;
+    seedLocalId?: string;
+    seedUid?: string;
+    propertyId?: number;
+};
+/** ModelScope for an Item (or ItemProperty) instance: its recorded modelFileId (context or seed row) and schemaName. */
+export declare const getItemModelScope: (item: {
+    seedLocalId?: string;
+    seedUid?: string;
+    getService?: () => {
+        getSnapshot: () => {
+            context?: ItemScopeContext;
+        };
+    };
+}) => Promise<{
+    modelFileId?: string;
+    schemaName?: string;
+}>;
+/**
+ * Resolve a ref (e.g. a Relation's target model) by name from the schema(s) its owning model belongs
+ * to, so "Tag" means the owner schema's Tag rather than any Tag. Falls back to resolveModelRecord.
+ */
+export declare const resolveRefModelRecord: (refModelName: string | undefined | null, owner: ModelScope, db?: Db | undefined) => Promise<ResolvedModelRecord | undefined>;
+export {};
+//# sourceMappingURL=resolveModelRecord.d.ts.map

package/dist/src/db/read/resolveModelRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveModelRecord.d.ts","sourceRoot":"","sources":["../../../../src/db/read/resolveModelRecord.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AASvC;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAGD,KAAK,EAAE,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AAQ5C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,WAAW,MAAM,GAAG,SAAS,GAAG,IAAI,EACpC,QAAO,UAAe,EACtB,KAAI,EAAE,GAAG,SAA6B,KACrC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAoCzC,CAAA;AA8CD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GACzC,YAAY,MAAM,GAAG,SAAS,GAAG,IAAI,EACrC,QAAO,UAAe,EACtB,KAAI,EAAE,GAAG,SAA6B,KACrC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CA4BzC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO;IACL,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,EACD,KAAI,EAAE,GAAG,SAA6B,KACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAqB5B,CAAA;AAED,KAAK,gBAAgB,GAAG;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wHAAwH;AACxH,eAAO,MAAM,iBAAiB,GAAU,MAAM;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM;QAAE,WAAW,EAAE,MAAM;YAAE,OAAO,CAAC,EAAE,gBAAgB,CAAA;SAAE,CAAA;KAAE,CAAA;CACzE,KAAG,OAAO,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAcxD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,MAAM,GAAG,SAAS,GAAG,IAAI,EACvC,OAAO,UAAU,EACjB,KAAI,EAAE,GAAG,SAA6B,KACrC,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAyBzC,CAAA"}

package/dist/src/db/read/resolveRelatedSeedRef.d.ts

@@ -0,0 +1,34 @@
+import type { IItem } from '../../interfaces';
+export type RelatedSeedRow = {
+    seedLocalId: string;
+    /** The seed's current uid (null while it was never published). */
+    seedUid: string | null;
+    revokedAt: number | null;
+    type: string | null;
+};
+/**
+ * The local seed row a relation/list/image ref points at, by local id or uid. A uid that is no
+ * seed's current uid can be the old uid of a seed that was unpublished and published again (a new
+ * seed attestation, same local seed): its old version rows still record it, so it resolves to that
+ * seed. Null when nothing local matches (e.g. a published uid with no local copy).
+ */
+export declare const findRelatedSeedRow: ({ seedLocalId, seedUid, }: {
+    seedLocalId?: string;
+    seedUid?: string;
+}) => Promise<RelatedSeedRow | null>;
+/** The seed is attested and its attestation is live. */
+export declare const isLivePublishedSeed: (row: RelatedSeedRow | null) => row is RelatedSeedRow & {
+    seedUid: string;
+};
+/** The seed was attested and that attestation was revoked (unpublished). */
+export declare const isUnpublishedSeed: (row: RelatedSeedRow | null) => row is RelatedSeedRow & {
+    seedUid: string;
+};
+/** Model a relation/list/image property points at, from its definition. */
+export declare function relatedModelNameFromDef(propertyDef: unknown): string | undefined;
+/**
+ * Name of the item's Html property whose value is the Html seed `htmlSeedLocalId`: the property
+ * that refers to the images embedded in that Html (htmlEmbeddedImageCoPublish rows).
+ */
+export declare function htmlPropertyNameForHtmlSeed(item: IItem<any>, htmlSeedLocalId: string): string;
+//# sourceMappingURL=resolveRelatedSeedRef.d.ts.map

package/dist/src/db/read/resolveRelatedSeedRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRelatedSeedRef.d.ts","sourceRoot":"","sources":["../../../../src/db/read/resolveRelatedSeedRef.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AASD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,2BAGtC;IACD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAsBhC,CAAA;AAED,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,GAAI,KAAK,cAAc,GAAG,IAAI,KAAG,GAAG,IAAI,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CACtB,CAAA;AAEpF,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,GAAI,KAAK,cAAc,GAAG,IAAI,KAAG,GAAG,IAAI,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CACrB,CAAA;AAEnF,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQhF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAS7F"}

package/dist/src/db/read/subqueries/liveVersion.d.ts

@@ -0,0 +1,12 @@
+import { type SQL } from 'drizzle-orm';
+/**
+ * True when a version row's attestation was revoked (`versions.revoked_at` set). 0 counts as
+ * "not revoked", like `seeds.revoked_at`.
+ */
+export declare const isVersionRevoked: (revokedAt: number | null | undefined) => boolean;
+/**
+ * SQL filter for version rows that are not revoked. "Latest version" and "latest published
+ * version" reads only consider these rows (see docs/ATTESTATION_REVOCATION.md).
+ */
+export declare const versionNotRevoked: () => SQL;
+//# sourceMappingURL=liveVersion.d.ts.map

package/dist/src/db/read/subqueries/liveVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveVersion.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/liveVersion.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAClC,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,GAC6B,CAAA"}

package/dist/src/db/read/subqueries/metadataLatest.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Metadata rows of a seed numbered per property_name in reader order (`rowNum = 1` is the value to
+ * show): live rows before revoked ones, then newest first. See `compareMetadataRowsLatestFirst`.
+ */
 export declare const getMetadataLatest: ({ seedLocalId, seedUid }: {
     seedLocalId?: string;
     seedUid?: string;

package/dist/src/db/read/subqueries/metadataLatest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadataLatest.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/metadataLatest.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,GAAI,0BAAwB;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,QAiCjG,CAAA"}
+{"version":3,"file":"metadataLatest.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/metadataLatest.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,0BAAwB;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,QAiCjG,CAAA"}

package/dist/src/db/read/subqueries/versionData.d.ts

@@ -1,6 +1,11 @@
 /**
- * Per-seed aggregates (all versions) plus the latest version row by
- * (created_at DESC, local_id DESC) via max(created_at) then max(local_id) tie-break.
+ * Per-seed version aggregates plus the latest version row by (created_at DESC, local_id DESC) via
+ * max(created_at) then max(local_id) tie-break.
+ *
+ * Revoked versions (`revoked_at` set) are never the latest version and don't count toward
+ * `lastVersionPublishedAt`. `versionsCount` and `lastLocalUpdateAt` still cover every version row,
+ * so a fully unpublished seed (every version revoked) keeps its row here, with null
+ * `latestVersionUid` / `latestVersionLocalId` / `lastVersionPublishedAt`.
  *
  * For `publishedVersionUid` / `publishedVersionLocalId` on list rows, see `getItemsData`
  * (batched resolution aligned with `getLatestPublishedVersionRow`).

package/dist/src/db/read/subqueries/versionData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versionData.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/versionData.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WA6D1B,CAAA"}
+{"version":3,"file":"versionData.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/versionData.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,WAsE1B,CAAA"}

package/dist/src/db/read/summarizePublishWork.d.ts

@@ -1,5 +1,6 @@
 import { IItem, IItemProperty } from '../../interfaces';
 import type { PublishMode } from './getPublishPayload';
+import type { UnpublishedRelatedItem } from './publishErrors';
 export type { PublishMode };
 export type SummarizePublishWorkOptions = {
     publishMode?: PublishMode;
@@ -12,13 +13,20 @@ export type PublishWorkSummary = {
     attestationCount: number;
     uploadCount: number;
     uploadBytes: number;
+    /**
+     * References the publish would attest to items whose seed was unpublished. When non-empty,
+     * publishing fails with RelatedItemUnpublishedError before anything is sent.
+     */
+    unpublishedRelatedItems: UnpublishedRelatedItem[];
 };
 /** Decoded byte length of a data-URI, or null if the string is not a base64 data URI. */
 export declare function estimateDataUriByteLength(dataUri: string): number | null;
 export declare function shouldAttestProperty(prop: IItemProperty<any>, forceFullSnapshot: boolean): boolean;
 /**
- * Local measurement of what a publish would do: seed/version/attestation counts
- * and Arweave upload byte totals. Does not hit the network or create transactions.
+ * References a publish of `item` would attest to items whose seed was unpublished (revoked), the
+ * same ones getPublishPayload rejects with RelatedItemUnpublishedError. Local reads only: the
+ * publish package checks this before registering schemas or uploading anything.
  */
+export declare const getUnpublishedRelatedItems: (item: IItem<any>, options?: SummarizePublishWorkOptions) => Promise<UnpublishedRelatedItem[]>;
 export declare const summarizePublishWork: (item: IItem<any>, options?: SummarizePublishWorkOptions) => Promise<PublishWorkSummary>;
 //# sourceMappingURL=summarizePublishWork.d.ts.map