@seedprotocol/sdk 0.4.20 → 0.4.22

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

@@ -14,9 +14,9 @@ export type GetPublishPendingDiffResult = {
     lastVersionPublishedAt: number | null;
 };
 /**
- * Lists properties with unpublished local edits (latest metadata row has no `uid`).
- * Compares to the previous row with a `uid` for the same `property_name` when present.
- * Use for pre-publish summaries and “what changed” UI.
+ * 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
+ * draft vs onchain for the whole seed; use `getSeedPublishState` for that.
  */
 export declare function getPublishPendingDiff(arg: {
     seedLocalId?: string;

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;AAEzC,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,CAkFtC"}
+{"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"}

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

@@ -4,6 +4,16 @@ import { PublishUpload } from '../../types/publish';
 /** Optional tags merged into each Arweave tx after Content-SHA-256 / Content-Type. */
 export type GetPublishUploadsOptions = {
     arweaveUploadTags?: TransactionTag[];
+    /**
+     * Html storage seed local ids to skip (phase 1 of two-phase embedded-image publish).
+     */
+    deferHtmlStorageSeedLocalIds?: string[];
+    /**
+     * When set, only Html storage seeds in this list are included (phase 2). Non-Html storage uploads are omitted.
+     */
+    onlyHtmlStorageSeedLocalIds?: string[];
+    /** When true, do not recurse into relation properties (phase 2 must not re-upload related items). */
+    skipRelationRecursion?: boolean;
 };
 export declare const prepareArweaveTransaction: (data: string | Uint8Array, contentHash: string | undefined, contentType?: string, additionalTags?: TransactionTag[]) => Promise<ArweaveTransaction>;
 export type UploadProperty = {

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":"AAQA,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;AAI/C,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAA;CACrC,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;AAkFD,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,CAoDlB;AAgID,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,aAAa,EAAO,EAC7B,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,6BA8DnC,CAAA"}
+{"version":3,"file":"getPublishUploads.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishUploads.ts"],"names":[],"mappings":"AAQA,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,CAoDlB;AAgID,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,aAAa,EAAO,EAC7B,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,6BAmEnC,CAAA"}

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

@@ -0,0 +1,21 @@
+import type { IItem } from '../../interfaces';
+export type SeedPublishState = {
+    /** `onchain` when any local row carries a valid EAS attestation UID for this seed. */
+    status: 'draft' | 'onchain';
+    seedAttestationUid: string | null;
+    versionAttestationUid: string | null;
+    /** Prefer seed UID for EAS Scan; else version or a metadata property attestation UID. */
+    explorerUid: string | null;
+    /** Best-effort max attestation time (ms) from seed, version, or metadata rows. */
+    lastAttestedAtMs: 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.
+ * Not the same as “no unpublished edits”; see `getPublishPendingDiff` for per-property head rows.
+ */
+export declare function getSeedPublishState(arg: {
+    seedLocalId?: string;
+    seedUid?: string;
+} | IItem<any>): Promise<SeedPublishState>;
+//# sourceMappingURL=getSeedPublishState.d.ts.map

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

@@ -0,0 +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"}

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

@@ -1,2 +1,9 @@
+/**
+ * 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.
+ *
+ * For `publishedVersionUid` / `publishedVersionLocalId` on list rows, see `getItemsData`
+ * (batched resolution aligned with `getLatestPublishedVersionRow`).
+ */
 export declare const getVersionData: () => any;
 //# sourceMappingURL=versionData.d.ts.map

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,eAAO,MAAM,cAAc,WAmB1B,CAAA"}
+{"version":3,"file":"versionData.d.ts","sourceRoot":"","sources":["../../../../../src/db/read/subqueries/versionData.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WA6D1B,CAAA"}

package/dist/src/db/write/applyPropertyAttestationUidsFromPublish.d.ts

@@ -0,0 +1,17 @@
+export type PropertyAttestationApplyPair = {
+    schemaUid: string;
+    attestationUid: string;
+    /** When set, only consider metadata rows with this property_name (disambiguate shared schemas). */
+    propertyName?: string | null;
+};
+/**
+ * After property attestations succeed, write EAS UIDs onto the latest placeholder metadata row
+ * per schema (and optional property name) so getPublishPendingDiff stays aligned with on-chain state.
+ */
+export declare function applyPropertyAttestationUidsFromPublish(params: {
+    seedLocalId: string;
+    attestationCreatedAtMs: number | null;
+    pairs: PropertyAttestationApplyPair[];
+    versionUid?: string | null;
+}): Promise<void>;
+//# sourceMappingURL=applyPropertyAttestationUidsFromPublish.d.ts.map

package/dist/src/db/write/applyPropertyAttestationUidsFromPublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyPropertyAttestationUidsFromPublish.d.ts","sourceRoot":"","sources":["../../../../src/db/write/applyPropertyAttestationUidsFromPublish.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,mGAAmG;IACnG,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B,CAAA;AAED;;;GAGG;AACH,wBAAsB,uCAAuC,CAAC,MAAM,EAAE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,KAAK,EAAE,4BAA4B,EAAE,CAAA;IACrC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDhB"}

package/dist/src/db/write/easSyncProcess.d.ts

@@ -0,0 +1,12 @@
+export type EasSyncRequestSource = 'event_bus' | 'address_change' | 'client_api' | 'models_init';
+export declare function insertEasSyncProcessRow(params: {
+    requestPayload: Record<string, unknown>;
+    persistedSnapshot: Record<string, unknown>;
+}): Promise<number>;
+export declare function finalizeEasSyncProcessRow(id: number, params: {
+    status: 'completed' | 'failed';
+    errorMessage?: string;
+    errorDetails?: string;
+    persistedSnapshot: Record<string, unknown>;
+}): Promise<void>;
+//# sourceMappingURL=easSyncProcess.d.ts.map

package/dist/src/db/write/easSyncProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easSyncProcess.d.ts","sourceRoot":"","sources":["../../../../src/db/write/easSyncProcess.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAA;AAEhG,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB;AAED,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IACN,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC3C,GACA,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/src/db/write/updateItemPropertyValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateItemPropertyValue.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateItemPropertyValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,YAAY,EAAE,MAAM,cAAc,CAAA;AAUrD,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,4BAA4B,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,uBAAuB,GAAG,CAAC,KAAK,EAAE,4BAA4B,KAAK,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAA;AAE1H,eAAO,MAAM,uBAAuB,EAAE,uBA+PrC,CAAA"}
+{"version":3,"file":"updateItemPropertyValue.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateItemPropertyValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,YAAY,EAAE,MAAM,cAAc,CAAA;AAUrD,KAAK,6BAA6B,GAAG;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,4BAA4B,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG;IAC1D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,KAAK,uBAAuB,GAAG,CAAC,KAAK,EAAE,4BAA4B,KAAK,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAA;AAE1H,eAAO,MAAM,uBAAuB,EAAE,uBAmQrC,CAAA"}

package/dist/src/db/write/updateSeedUid.d.ts

@@ -2,11 +2,13 @@ type UpdateSeedUidProps = {
     seedLocalId: string;
     seedUid: string;
     publisher?: string;
+    /** Unix ms when the seed attestation was created (EAS / chain time). */
+    attestationCreatedAt?: number;
 };
 /**
  * Updates seedUid and optionally publisher. Publisher is immutable once set:
  * we never overwrite an existing publisher (set at creation or from attestation).
  */
-export declare const updateSeedUid: ({ seedLocalId, seedUid, publisher, }: UpdateSeedUidProps) => Promise<void>;
+export declare const updateSeedUid: ({ seedLocalId, seedUid, publisher, attestationCreatedAt, }: UpdateSeedUidProps) => Promise<void>;
 export {};
 //# sourceMappingURL=updateSeedUid.d.ts.map

package/dist/src/db/write/updateSeedUid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateSeedUid.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateSeedUid.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAU,sCAIjC,kBAAkB,KAAG,OAAO,CAAC,IAAI,CA2BnC,CAAA"}
+{"version":3,"file":"updateSeedUid.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateSeedUid.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAU,4DAKjC,kBAAkB,KAAG,OAAO,CAAC,IAAI,CA4BnC,CAAA"}

package/dist/src/db/write/updateVersionUid.d.ts

@@ -2,12 +2,14 @@ type UpdateVersionUidProps = {
     seedLocalId: string;
     versionUid: string;
     publisher?: string;
+    /** Unix ms when the version attestation was created (EAS / chain time). */
+    attestationCreatedAt?: number;
 };
 /**
  * Updates the version record with the attestation UID after a Version attestation is created.
  * Targets the version without a uid yet (the one being published).
  * Publisher is immutable once set: we never overwrite an existing publisher.
  */
-export declare const updateVersionUid: ({ seedLocalId, versionUid, publisher, }: UpdateVersionUidProps) => Promise<void>;
+export declare const updateVersionUid: ({ seedLocalId, versionUid, publisher, attestationCreatedAt, }: UpdateVersionUidProps) => Promise<void>;
 export {};
 //# sourceMappingURL=updateVersionUid.d.ts.map

package/dist/src/db/write/updateVersionUid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateVersionUid.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateVersionUid.ts"],"names":[],"mappings":"AAIA,KAAK,qBAAqB,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAKD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,yCAIpC,qBAAqB,KAAG,OAAO,CAAC,IAAI,CA8BtC,CAAA"}
+{"version":3,"file":"updateVersionUid.d.ts","sourceRoot":"","sources":["../../../../src/db/write/updateVersionUid.ts"],"names":[],"mappings":"AAKA,KAAK,qBAAqB,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAU,+DAKpC,qBAAqB,KAAG,OAAO,CAAC,IAAI,CAiCtC,CAAA"}

package/dist/src/events/files/download.d.ts

@@ -4,6 +4,10 @@ type DownloadAllFilesRequestHandlerProps = {
     eventId: string;
 };
 export declare const downloadAllFilesRequestHandler: ({ endpoints, eventId, }: DownloadAllFilesRequestHandlerProps) => Promise<void>;
-export declare const downloadAllFilesBinaryRequestHandler: () => Promise<never[] | undefined>;
+export declare const downloadAllFilesBinaryRequestHandler: (addressesHintOrPayload?: string[] | {
+    endpoints?: Endpoints;
+}) => Promise<void>;
+export declare const downloadTransactionIdWithDedupe: (transactionId: string) => Promise<boolean>;
+export declare const scheduleBulkFilesDownloadFromEasSync: (addressesHint?: string[]) => void;
 export {};
 //# sourceMappingURL=download.d.ts.map

package/dist/src/events/files/download.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/events/files/download.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAcnC,KAAK,mCAAmC,GAAG;IACzC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAU,yBAGlD,mCAAmC,kBAUrC,CAAA;AAED,eAAO,MAAM,oCAAoC,oCAsLhD,CAAA"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/events/files/download.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAqSnC,KAAK,mCAAmC,GAAG;IACzC,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAU,yBAGlD,mCAAmC,kBAUrC,CAAA;AAED,eAAO,MAAM,oCAAoC,GAC/C,yBAAyB,MAAM,EAAE,GAAG;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,kBAyE9D,CAAA;AAED,eAAO,MAAM,+BAA+B,GAAU,eAAe,MAAM,KAAG,OAAO,CAAC,OAAO,CAuB5F,CAAA;AAQD,eAAO,MAAM,oCAAoC,GAAI,gBAAgB,MAAM,EAAE,KAAG,IAK/E,CAAA"}

package/dist/src/events/item/easSyncManager.d.ts

@@ -0,0 +1,71 @@
+import { MachineIds } from '../../client/constants';
+import { type EasSyncRequestSource } from '../../db/write/easSyncProcess';
+import type { SyncFromEasOptions } from './syncDbWithEas';
+export type EasSyncRequestEvent = {
+    type: 'REQUEST';
+    correlationId: string;
+    options?: SyncFromEasOptions;
+    source: EasSyncRequestSource;
+};
+export type EasSyncMachineContext = {
+    runOptions: SyncFromEasOptions;
+    activeCorrelationIds: string[];
+    activePrimarySource: EasSyncRequestSource;
+    pendingMergedOptions: SyncFromEasOptions | undefined;
+    pendingCorrelationIds: string[];
+    pendingPrimarySource: EasSyncRequestSource | null;
+    lastFinishedCorrelationIds: string[] | null;
+    lastFinishedStatus: 'success' | 'failed' | null;
+    lastFinishedError: string | null;
+};
+export declare const easSyncMachine: import("xstate").StateMachine<EasSyncMachineContext, EasSyncRequestEvent, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+        options: SyncFromEasOptions;
+        requestPayload: Record<string, unknown>;
+        runningSnapshot: Record<string, unknown>;
+    }, import("xstate").EventObject>> | undefined;
+}, {
+    src: "runEasSync";
+    logic: import("xstate").PromiseActorLogic<void, {
+        options: SyncFromEasOptions;
+        requestPayload: Record<string, unknown>;
+        runningSnapshot: Record<string, unknown>;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+}, never, never, never, "idle" | "running" | "afterRun", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: MachineIds.EAS_SYNC_MANAGER;
+    states: {
+        readonly idle: {};
+        readonly running: {};
+        readonly afterRun: {};
+    };
+}>;
+export declare const easSyncActor: import("xstate").Actor<import("xstate").StateMachine<EasSyncMachineContext, EasSyncRequestEvent, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+        options: SyncFromEasOptions;
+        requestPayload: Record<string, unknown>;
+        runningSnapshot: Record<string, unknown>;
+    }, import("xstate").EventObject>> | undefined;
+}, {
+    src: "runEasSync";
+    logic: import("xstate").PromiseActorLogic<void, {
+        options: SyncFromEasOptions;
+        requestPayload: Record<string, unknown>;
+        runningSnapshot: Record<string, unknown>;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+}, never, never, never, "idle" | "running" | "afterRun", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: MachineIds.EAS_SYNC_MANAGER;
+    states: {
+        readonly idle: {};
+        readonly running: {};
+        readonly afterRun: {};
+    };
+}>>;
+export declare function startEasSyncActor(): void;
+export declare function requestEasSyncFromEventBus(): void;
+export declare function requestEasSyncFromAddressChange(addresses: string[]): void;
+export declare function requestEasSyncFromModelsInit(): void;
+export declare function sendEasSyncClientRequest(correlationId: string, options?: SyncFromEasOptions): void;
+export type { EasSyncRequestSource } from '../../db/write/easSyncProcess';
+//# sourceMappingURL=easSyncManager.d.ts.map

package/dist/src/events/item/easSyncManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easSyncManager.d.ts","sourceRoot":"","sources":["../../../../src/events/item/easSyncManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAKrE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,SAAS,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,oBAAoB,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,mBAAmB,EAAE,oBAAoB,CAAA;IACzC,oBAAoB,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACpD,qBAAqB,EAAE,MAAM,EAAE,CAAA;IAC/B,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACjD,0BAA0B,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC3C,kBAAkB,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAA;IAC/C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC,CAAA;AAqED,eAAO,MAAM,cAAc;;iBAnDZ,kBAAkB;wBACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;iBAF/B,kBAAkB;wBACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;EA2K5C,CAAA;AAEF,eAAO,MAAM,YAAY;;iBA/KV,kBAAkB;wBACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;iBAF/B,kBAAkB;wBACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;GA6KS,CAAA;AAIvD,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAUD,wBAAgB,0BAA0B,IAAI,IAAI,CAOjD;AAED,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAQzE;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAOnD;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI,CAQN;AAED,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/src/events/item/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/events/item/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,YAGtC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/events/item/index.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,0BAA0B,YAItC,CAAA"}

package/dist/src/events/item/mergeEasSyncOptions.d.ts

@@ -0,0 +1,7 @@
+import type { SyncFromEasOptions } from './syncDbWithEas';
+/**
+ * Merge multiple EAS sync intents: full sync (no concrete address list) wins;
+ * otherwise union addresses (first-seen casing).
+ */
+export declare function mergeEasSyncRequestIntents(parts: (SyncFromEasOptions | undefined | null)[]): SyncFromEasOptions;
+//# sourceMappingURL=mergeEasSyncOptions.d.ts.map

package/dist/src/events/item/mergeEasSyncOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeEasSyncOptions.d.ts","sourceRoot":"","sources":["../../../../src/events/item/mergeEasSyncOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAErE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,CAAC,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAC/C,kBAAkB,CA0BpB"}

package/dist/src/events/item/syncDbWithEas.d.ts

@@ -1,4 +1,3 @@
-import { DebouncedFunc } from 'lodash-es';
 export type SyncFromEasOptions = {
     /** Override addresses to sync. Default: owned + watched from DB. */
     addresses?: string[];
@@ -9,6 +8,4 @@ export type SyncFromEasOptions = {
  * Uses owned + watched addresses from DB when addresses are not provided.
  */
 export declare const runSyncFromEas: (options?: SyncFromEasOptions) => Promise<void>;
-declare const syncDbWithEasHandler: DebouncedFunc<any>;
-export { syncDbWithEasHandler };
 //# sourceMappingURL=syncDbWithEas.d.ts.map

package/dist/src/events/item/syncDbWithEas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncDbWithEas.d.ts","sourceRoot":"","sources":["../../../../src/events/item/syncDbWithEas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAuB,MAAM,WAAW,CAAA;AAqnBzE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAiG/E,CAAA;AAED,QAAA,MAAM,oBAAoB,EAAE,aAAa,CAAC,GAAG,CAS5C,CAAA;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"syncDbWithEas.d.ts","sourceRoot":"","sources":["../../../../src/events/item/syncDbWithEas.ts"],"names":[],"mappings":"AA0nBA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,kBAAkB,KAAG,OAAO,CAAC,IAAI,CA0G/E,CAAA"}

package/dist/src/helpers/ArweaveClient/BaseArweaveClient.d.ts

@@ -28,6 +28,23 @@ export declare abstract class BaseArweaveClient {
      * @param host - e.g. 'arweave.net', 'https://arweave.net', or 'http://localhost:1984'
      */
     static setHost(host: string): void;
+    /**
+     * When true, read-path gateway probing does not change the host ({@link setHost}).
+     */
+    static isReadGatewayLocked(): boolean;
+    /**
+     * @internal Clears env override suppression after probing (for test isolation).
+     */
+    static resetReadGatewaySelectionStateForTests(): void;
+    /**
+     * Sets the preferred read gateway without locking. Production env host still takes precedence until a probe applies a host.
+     * Used for seed `arweaveDomain`.
+     */
+    static setPreferredReadGateway(host: string): void;
+    /**
+     * Applies a gateway chosen by read-path health probing so {@link getHost} uses it instead of env override.
+     */
+    static applyProbedReadGateway(host: string): void;
     /**
      * Get the GraphQL endpoint URL
      * @returns The full GraphQL endpoint URL

package/dist/src/helpers/ArweaveClient/BaseArweaveClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseArweaveClient.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/BaseArweaveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACzB,MAAM,iBAAiB,CAAA;AAmBxB,8BAAsB,iBAAiB;IACrC,MAAM,CAAC,aAAa,EAAE,OAAO,iBAAiB,CAAA;IAE9C,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,OAAO,iBAAiB;IAI/D;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAiBrE;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAK3B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlC;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI/C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAQlD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAQxC;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9E;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;IAI/B;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3E;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,GAAG,CAAC;IAQf;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7E"}
+{"version":3,"file":"BaseArweaveClient.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/BaseArweaveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACzB,MAAM,iBAAiB,CAAA;AAqBxB,8BAAsB,iBAAiB;IACrC,MAAM,CAAC,aAAa,EAAE,OAAO,iBAAiB,CAAA;IAE9C,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,OAAO,iBAAiB;IAI/D;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAiBrE;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAK3B;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACH,MAAM,CAAC,sCAAsC,IAAI,IAAI;IAIrD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOlD;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQjD;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI/C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAQlD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,IAAI,aAAa;IAQxC;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9E;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;IAI/B;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAI3E;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,GAAG,CAAC;IAQf;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG7E"}

package/dist/src/helpers/ArweaveClient/arweaveL1UploadApi.d.ts

@@ -43,4 +43,10 @@ export declare function getArweaveUploadStatus(uploadApiBaseUrl: string, dataIte
  * Queries an Arweave gateway GraphQL API for transaction + bundle info.
  */
 export declare function queryArweaveGatewayTransaction(graphqlUrl: string, dataItemId: string, init?: Pick<RequestInit, 'signal'>): Promise<ArweaveGatewayTransactionQueryResult | null>;
+/**
+ * Resolves GraphQL against the first healthy gateway (GET /info probe per host), then runs
+ * {@link queryArweaveGatewayTransaction}. Host order: optional `graphqlUrl` hostname first, then
+ * {@link getDefaultArweaveReadGatewayHostsOrdered}.
+ */
+export declare function queryArweaveGatewayTransactionWithFallback(graphqlUrl: string | undefined, dataItemId: string, init?: Pick<RequestInit, 'signal'>): Promise<ArweaveGatewayTransactionQueryResult | null>;
 //# sourceMappingURL=arweaveL1UploadApi.d.ts.map

package/dist/src/helpers/ArweaveClient/arweaveL1UploadApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arweaveL1UploadApi.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/arweaveL1UploadApi.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,EAAE,CAAC,EAAE;QACH,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAA;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAA;QACjC,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAChC,CAAA;CACF;AAED,MAAM,WAAW,oCAAoC;IACnD,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAiBD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAMzF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAY7C;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GACjC,OAAO,CAAC,oCAAoC,GAAG,IAAI,CAAC,CAuDtD"}
+{"version":3,"file":"arweaveL1UploadApi.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/arweaveL1UploadApi.ts"],"names":[],"mappings":"AAOA,yEAAyE;AACzE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,EAAE,CAAC,EAAE;QACH,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,qBAAqB,CAAC,EAAE,MAAM,CAAA;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAA;QACjC,qBAAqB,CAAC,EAAE,OAAO,CAAA;KAChC,CAAA;CACF;AAED,MAAM,WAAW,oCAAoC;IACnD,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAiBD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAMzF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAY7C;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GACjC,OAAO,CAAC,oCAAoC,GAAG,IAAI,CAAC,CAuDtD;AAED;;;;GAIG;AACH,wBAAsB,0CAA0C,CAC9D,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GACjC,OAAO,CAAC,oCAAoC,GAAG,IAAI,CAAC,CA+BtD"}

package/dist/src/helpers/ArweaveClient/selectReadGateway.d.ts

@@ -0,0 +1,16 @@
+/** Clears cached read gateway (e.g. after tests or to force a fresh probe). */
+export declare function invalidateReadGatewayCache(): void;
+/** Clears probe cache, env override suppression, and preferred host (for tests). */
+export declare function resetArweaveReadGatewayForTests(): void;
+/**
+ * GET /info with timeout. Treat 2xx + JSON object as healthy.
+ */
+export declare function probeGateway(baseUrl: string, signal?: AbortSignal): Promise<boolean>;
+export declare function selectFirstHealthyReadGateway(hosts: string[], protocol?: 'http' | 'https', signal?: AbortSignal): Promise<string | null>;
+/**
+ * Probes gateways in order and applies the first healthy host via {@link BaseArweaveClient.applyProbedReadGateway}.
+ * No-op when the read gateway is locked ({@link BaseArweaveClient.setHost}).
+ * Uses a short TTL cache to avoid probing on every read.
+ */
+export declare function ensureReadGatewaySelected(signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=selectReadGateway.d.ts.map

package/dist/src/helpers/ArweaveClient/selectReadGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectReadGateway.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/selectReadGateway.ts"],"names":[],"mappings":"AAaA,+EAA+E;AAC/E,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD;AAED,oFAAoF;AACpF,wBAAgB,+BAA+B,IAAI,IAAI,CAMtD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B1F;AAED,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,GAAE,MAAM,GAAG,OAAiB,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAQD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCrF"}

package/dist/src/helpers/ArweaveClient/uploadApiVerification.d.ts

@@ -11,9 +11,13 @@ export declare function normalizeUploadApiBaseUrl(baseUrl: string): string;
  * @param txOrDataItemId - Arweave tx id or bundler data item id
  */
 export declare function getUploadApiArweaveDataUrl(baseUrl: string, txOrDataItemId: string): string;
+export type GetUploadPipelineTransactionStatusOptions = {
+    /** Abort the request after this many ms (upload API hung / unreachable). Default 45s. */
+    timeoutMs?: number;
+};
 /**
  * Presence check against the upload API data route (same semantics as
  * {@link BaseArweaveClient.getTransactionStatus} for gateways: 200 = present, 404 = missing).
  */
-export declare function getUploadPipelineTransactionStatus(uploadApiBaseUrl: string, txOrDataItemId: string): Promise<TransactionStatus>;
+export declare function getUploadPipelineTransactionStatus(uploadApiBaseUrl: string, txOrDataItemId: string, options?: GetUploadPipelineTransactionStatusOptions): Promise<TransactionStatus>;
 //# sourceMappingURL=uploadApiVerification.d.ts.map

package/dist/src/helpers/ArweaveClient/uploadApiVerification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploadApiVerification.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/uploadApiVerification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAsB5B"}
+{"version":3,"file":"uploadApiVerification.d.ts","sourceRoot":"","sources":["../../../../src/helpers/ArweaveClient/uploadApiVerification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAI1F;AAID,MAAM,MAAM,yCAAyC,GAAG;IACtD,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,yCAAyC,GAClD,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}

package/dist/src/helpers/FileManager/BaseFileManager.d.ts

@@ -15,6 +15,7 @@ export declare abstract class BaseFileManager {
     static getFilesPath(...subpaths: string[]): string;
     static getContentUrlFromPath(path: string): Promise<string | undefined>;
     static downloadAllFiles({ transactionIds, arweaveHost, excludedTransactions, }: DownloadAllFilesParams): Promise<void>;
+    static downloadFileByTransactionId({ transactionId, arweaveHost, excludedTransactions, }: DownloadSingleFileParams): Promise<void>;
     static resizeImage({ filePath, width, height }: ResizeImageParams): Promise<void>;
     static resizeAllImages({ width, height }: ResizeAllImagesParams): Promise<void>;
     static pathExists(filePath: string): Promise<boolean>;

package/dist/src/helpers/FileManager/BaseFileManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseFileManager.d.ts","sourceRoot":"","sources":["../../../../src/helpers/FileManager/BaseFileManager.ts"],"names":[],"mappings":"AAAA,8BAAsB,eAAe;IACnC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAQ;IAC5C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAQ;IACnC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoB;IAE7C,MAAM,CAAC,aAAa,EAAE,OAAO,eAAe,CAAA;IAE5C,MAAM,CAAC,gBAAgB,CAAE,aAAa,EAAE,OAAO,eAAe;WAUjD,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrE,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAMlD,MAAM,CAAC,qBAAqB,CAAE,IAAI,EAAE,MAAM,GAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIzE,MAAM,CAAC,gBAAgB,CAAE,EACE,cAAc,EACd,WAAW,EACX,oBAAoB,GACrB,EAAE,sBAAsB,GAAI,OAAO,CAAC,IAAI,CAAC;IAInE,MAAM,CAAC,WAAW,CAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAI,OAAO,CAAC,IAAI,CAAC;IAInF,MAAM,CAAC,eAAe,CAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAI,OAAO,CAAC,IAAI,CAAC;IAIjF,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhD;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1C,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAI/C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAI/C,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAI/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI;WAIpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;WAI9B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;WAI1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAInD,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAsBlC,MAAM,CAAC,SAAS,IAAI,GAAG;IAcvB,MAAM,CAAC,aAAa,IAAI,GAAG;IAI3B,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGrD"}
+{"version":3,"file":"BaseFileManager.d.ts","sourceRoot":"","sources":["../../../../src/helpers/FileManager/BaseFileManager.ts"],"names":[],"mappings":"AAAA,8BAAsB,eAAe;IACnC,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAQ;IAC5C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAQ;IACnC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoB;IAE7C,MAAM,CAAC,aAAa,EAAE,OAAO,eAAe,CAAA;IAE5C,MAAM,CAAC,gBAAgB,CAAE,aAAa,EAAE,OAAO,eAAe;WAUjD,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrE,MAAM,CAAC,aAAa,IAAI,MAAM;IAO9B;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAMlD,MAAM,CAAC,qBAAqB,CAAE,IAAI,EAAE,MAAM,GAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIzE,MAAM,CAAC,gBAAgB,CAAE,EACE,cAAc,EACd,WAAW,EACX,oBAAoB,GACrB,EAAE,sBAAsB,GAAI,OAAO,CAAC,IAAI,CAAC;IAInE,MAAM,CAAC,2BAA2B,CAAC,EACjC,aAAa,EACb,WAAW,EACX,oBAAoB,GACrB,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,MAAM,CAAC,WAAW,CAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAI,OAAO,CAAC,IAAI,CAAC;IAInF,MAAM,CAAC,eAAe,CAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAI,OAAO,CAAC,IAAI,CAAC;IAIjF,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhD;;;OAGG;IACH,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1C,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAI/C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAI/C,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAI/F,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI;WAIpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;WAI9B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;WAI1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAInD,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAsBlC,MAAM,CAAC,SAAS,IAAI,GAAG;IAcvB,MAAM,CAAC,aAAa,IAAI,GAAG;IAI3B,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGrD"}

package/dist/src/helpers/compareMetadataRowsLatestFirst.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Canonical "latest metadata row first" ordering. Must stay in sync with SQL that uses:
+ * `ORDER BY COALESCE(attestation_created_at, created_at) DESC, local_id DESC`
+ */
+export type MetadataRecencyRow = {
+    attestationCreatedAt?: number | null;
+    createdAt?: number | null;
+    localId?: string | null;
+};
+export declare function metadataLatestFirstSortKey(row: MetadataRecencyRow): {
+    t: number;
+    localId: string;
+};
+/** Sort comparator: larger time first; on tie, larger localId (lexicographic) first. */
+export declare function compareMetadataRowsLatestFirst(a: MetadataRecencyRow, b: MetadataRecencyRow): number;
+//# sourceMappingURL=compareMetadataRowsLatestFirst.d.ts.map

package/dist/src/helpers/compareMetadataRowsLatestFirst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareMetadataRowsLatestFirst.d.ts","sourceRoot":"","sources":["../../../src/helpers/compareMetadataRowsLatestFirst.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,kBAAkB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKlG;AAED,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAKnG"}

package/dist/src/helpers/constants.d.ts

@@ -41,6 +41,8 @@ export declare const INTERNAL_DATA_TYPES: {
         eas: string;
     };
 };
+/** Full property names ending in `Id` that must not be stripped to a “base” name for `allProperties` keys. */
+export declare const PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP: Set<string>;
 export declare const INTERNAL_PROPERTY_NAMES: string[];
 export declare const VERSION_SCHEMA_UID_OPTIMISM_SEPOLIA = "0x13c0fd59d69dbce40501a41f8b37768d26dd2e2bb0cad64615334d84f7b9bdf6";
 export declare const defaultAttestationData: AttestationRequestData;
@@ -60,12 +62,27 @@ export declare enum SeedModels {
 }
 export declare const SEED_PROTOCOL_SCHEMA_NAME = "Seed Protocol";
 export declare const INTERNAL_SCHEMA_IDS: readonly ["SEEDPROTOCOL"];
-/** Default Arweave gateway host used across all packages */
-export declare const DEFAULT_ARWEAVE_HOST = "arweave.net";
+/** Default Arweave gateway host used across all packages (first in {@link DEFAULT_ARWEAVE_GATEWAYS}) */
+export declare const DEFAULT_ARWEAVE_HOST = "ar.seedprotocol.io";
 /** Default Arweave gateway GraphQL endpoint (transaction / block queries). */
-export declare const DEFAULT_ARWEAVE_GRAPHQL_URL = "https://arweave.net/graphql";
-/** Default Arweave gateways for fallback / metadata fetching (ordered by preference) */
-export declare const DEFAULT_ARWEAVE_GATEWAYS: readonly ["arweave.net", "ar-io.net"];
+export declare const DEFAULT_ARWEAVE_GRAPHQL_URL = "https://ar.seedprotocol.io/graphql";
+/**
+ * Default Arweave gateways for read fallback / metadata fetching (ordered by preference).
+ * Override order with `ARWEAVE_READ_GATEWAYS` or `NEXT_PUBLIC_ARWEAVE_READ_GATEWAYS` (comma-separated hosts).
+ */
+export declare const DEFAULT_ARWEAVE_GATEWAYS: readonly ["ar.seedprotocol.io", "arweave.net", "arweave.dev", "g8way.io", "permagate.io", "zigza.xyz"];
+/** Ordered gateway hostnames for reads: env list if set, otherwise {@link DEFAULT_ARWEAVE_GATEWAYS}. */
+export declare function getDefaultArweaveReadGatewayHostsOrdered(): string[];
+/**
+ * Deduped host list: primary first, then each default not already present (case-insensitive).
+ */
+export declare function mergePrimaryHostWithDefaults(primary: string, defaults: readonly string[]): string[];
+/**
+ * True if `hostname` looks like a public Arweave gateway used in stored URLs (hydration / RSS).
+ */
+export declare function isKnownArweaveGatewayHostname(hostname: string): boolean;
+/** Fired after `syncDbWithEas` persists EAS seeds/versions/metadata to SQLite (see `Item.rehydrateCachedItemsFromDbAfterEasSync`). */
+export declare const EAS_SEED_DATA_SYNCED_TO_DB_EVENT: "easSeedDataSyncedToDb";
 /**
  * Check if a schema is an internal SDK schema that should not be created in app files
  */

package/dist/src/helpers/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/helpers/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACvB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,YAAY,QAAc,CAAA;AACvC,eAAO,MAAM,UAAU,OAAO,CAAA;AAC9B,eAAO,MAAM,YAAY,uEAAuE,CAAA;AAGhG,eAAO,MAAM,UAAU,eAAe,CAAA;AAEtC,eAAO,MAAM,gBAAgB,mBAAmB,CAAA;AAEhD,eAAO,MAAM,qBAAqB,UAAkC,CAAA;AAEpE,eAAO,MAAM,SAAS,mBAAmB,CAAA;AAEzC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAA;AAED,eAAO,MAAM,uBAAuB,UA8BnC,CAAA;AAED,eAAO,MAAM,mCAAmC,uEACsB,CAAA;AAEtE,eAAO,MAAM,sBAAsB,EAAE,sBAOpC,CAAA;AAED,oBAAY,SAAS;IACnB,WAAW,MAAM;IACjB,KAAK,MAAM;IACX,MAAM,OAAO;IACb,KAAK,OAAO;IACZ,WAAW,OAAO;CACnB;AAED,eAAO,MAAM,sBAAsB,gEAAgE,CAAA;AAEnG,eAAO,MAAM,2BAA2B,iDAAiD,CAAA;AAEzF,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAGD,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AACxD,eAAO,MAAM,mBAAmB,2BAA4B,CAAA;AAE5D,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,gBAAgB,CAAA;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,gCAAgC,CAAA;AAExE,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,uCAAwC,CAAA;AAE7E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/E"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/helpers/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACvB,MAAM,uCAAuC,CAAA;AAI9C,eAAO,MAAM,YAAY,QAAc,CAAA;AACvC,eAAO,MAAM,UAAU,OAAO,CAAA;AAC9B,eAAO,MAAM,YAAY,uEAAuE,CAAA;AAGhG,eAAO,MAAM,UAAU,eAAe,CAAA;AAEtC,eAAO,MAAM,gBAAgB,mBAAmB,CAAA;AAEhD,eAAO,MAAM,qBAAqB,UAAkC,CAAA;AAEpE,eAAO,MAAM,SAAS,mBAAmB,CAAA;AAEzC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC/B,CAAA;AAED,8GAA8G;AAC9G,eAAO,MAAM,0CAA0C,aAA4C,CAAA;AAEnG,eAAO,MAAM,uBAAuB,UA8BnC,CAAA;AAED,eAAO,MAAM,mCAAmC,uEACsB,CAAA;AAEtE,eAAO,MAAM,sBAAsB,EAAE,sBAOpC,CAAA;AAED,oBAAY,SAAS;IACnB,WAAW,MAAM;IACjB,KAAK,MAAM;IACX,MAAM,OAAO;IACb,KAAK,OAAO;IACZ,WAAW,OAAO;CACnB;AAED,eAAO,MAAM,sBAAsB,gEAAgE,CAAA;AAEnG,eAAO,MAAM,2BAA2B,iDAAiD,CAAA;AAEzF,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAGD,eAAO,MAAM,yBAAyB,kBAAkB,CAAA;AACxD,eAAO,MAAM,mBAAmB,2BAA4B,CAAA;AAE5D,wGAAwG;AACxG,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AAExD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,uCAA4C,CAAA;AAEpF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wGAA0G,CAAA;AAI/I,wGAAwG;AACxG,wBAAgB,wCAAwC,IAAI,MAAM,EAAE,CAWnE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAenG;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUvE;AAED,sIAAsI;AACtI,eAAO,MAAM,gCAAgC,EAAG,uBAAgC,CAAA;AAEhF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/E"}

package/dist/src/helpers/easUid.d.ts

@@ -0,0 +1,13 @@
+/**
+ * True when the value is not a real EAS attestation UID stored in SQLite
+ * (missing, empty, legacy 'NULL' sentinel, or zero bytes32).
+ */
+export declare function isPlaceholderUid(value: string | null | undefined): boolean;
+/**
+ * Strict EAS attestation UID: 0x-prefixed 32-byte hex (case-insensitive 0x / hex body).
+ * Excludes placeholders and ZERO_BYTES32.
+ */
+export declare function isValidEasAttestationUid(value: string | null | undefined): boolean;
+/** Normalize bytes32 hex strings for case-insensitive comparison (schema UIDs, etc.). */
+export declare function normalizeBytes32Hex(value: string | null | undefined): string;
+//# sourceMappingURL=easUid.d.ts.map

package/dist/src/helpers/easUid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easUid.d.ts","sourceRoot":"","sources":["../../../src/helpers/easUid.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAO1E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAOlF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAM5E"}

package/dist/src/helpers/environment.d.ts

@@ -18,5 +18,10 @@ export declare const isElectronRenderer: () => boolean;
  * @returns true if running in Electron main process, false otherwise
  */
 export declare const isElectronMain: () => boolean;
+/**
+ * True where OPFS-backed Arweave file downloads should run: normal browsers and
+ * Electron renderer. {@link isBrowser} is false for every Electron build (including renderer).
+ */
+export declare const supportsOpfsFileDownloads: () => boolean;
 export declare const getEnvironment: () => string;
 //# sourceMappingURL=environment.d.ts.map

package/dist/src/helpers/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/helpers/environment.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,QAAO,OAMzB,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,OAE5B,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,OAEhC,CAAA;AAED,eAAO,MAAM,UAAU,QAAO,OAE7B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAoBrC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,OAwBjC,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,MAcjC,CAAA"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/helpers/environment.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,QAAO,OAMzB,CAAA;AAED,eAAO,MAAM,SAAS,QAAO,OAE5B,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,OAEhC,CAAA;AAED,eAAO,MAAM,UAAU,QAAO,OAE7B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAO,OAoBrC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,OAwBjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAO,OAE5C,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,MAcjC,CAAA"}