@seedprotocol/sdk 0.7.3-next.613.g79a8dfd → 0.7.3

package/dist/src/client/clientManagerMachine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientManagerMachine.d.ts","sourceRoot":"","sources":["../../../src/client/clientManagerMachine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAStE,OAAO,EAAuB,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AA+GxF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAgBkC,MAAM;;;;;;;;;;;;;;;;+BA8MvE,CAAA"}
+{"version":3,"file":"clientManagerMachine.d.ts","sourceRoot":"","sources":["../../../src/client/clientManagerMachine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAStE,OAAO,EAAuB,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAgHxF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAgBkC,MAAM;;;;;;;;;;;;;;;;+BAoNvE,CAAA"}

package/dist/src/db/migrateLegacyItemStorageRows.d.ts

@@ -0,0 +1,57 @@
+/** appState key recording that legacy ItemStorage rows have been written to their files. */
+export declare const LEGACY_ITEM_STORAGE_MIGRATION_KEY = "legacyItemStorageFiles:v1";
+/** Runs in a row that left rows unconverted because a file write failed, before giving up. */
+export declare const LEGACY_ITEM_STORAGE_MIGRATION_MAX_ATTEMPTS = 3;
+export type LegacyItemStorageMigrationMarker = {
+    status: 'done' | 'retry';
+    attempts: number;
+    converted: number;
+    failed: number;
+    at: number;
+};
+export type LegacyItemStorageMigrationResult = {
+    /** True when the marker said the migration had already run (nothing was checked). */
+    alreadyDone: boolean;
+    /** Legacy rows found (local drafts of ItemStorage properties holding their content verbatim). */
+    candidates: number;
+    converted: number;
+    /** Rows left as they were because writing the file or updating the row failed. */
+    failed: number;
+    /** Rows not converted on purpose: an older row of their property, or one that changed meanwhile. */
+    skipped: number;
+};
+/**
+ * One-time data migration: writes the content of legacy ItemStorage draft rows to their files.
+ *
+ * Before Item.create / createNewItem saved ItemStorage values through the save pipeline, a value
+ * given at creation was stored verbatim in metadata.property_value with no file. Publish converts
+ * such a row lazily (resolveItemStorageChildFile); this converts them all up front, with the same
+ * code ({@link convertVerbatimItemStorageRow}), so every ItemStorage draft has the shape a save
+ * gives it: the content in `<seedUid or seedLocalId><extension>`, the row holding
+ * refResolvedValue / localStorageDir / refValueType 'file' and no property_value.
+ *
+ * Only local drafts (no uid, not derived from an attestation) of properties whose properties row
+ * says `storage_type = 'ItemStorage'` are touched, and of those only the newest row of each
+ * seed's property: that is the row reads show and saves write to, and older rows sharing the one
+ * file name would overwrite it with older content. Published and synced rows are never changed.
+ *
+ * A row that fails is logged and left as it was (publish still converts it). The run is recorded
+ * in appState under {@link LEGACY_ITEM_STORAGE_MIGRATION_KEY}; a run with failed rows is retried
+ * on the next start, up to {@link LEGACY_ITEM_STORAGE_MIGRATION_MAX_ATTEMPTS} runs. Safe to run
+ * again regardless: a converted row no longer matches.
+ *
+ * @param options.force run even when the marker says it is done
+ */
+export declare function migrateLegacyItemStorageRows(options?: {
+    force?: boolean;
+}): Promise<LegacyItemStorageMigrationResult>;
+/**
+ * Starts {@link migrateLegacyItemStorageRows} in the background once client init has finished
+ * (the properties table then holds the current storage settings). It runs in the leader tab only
+ * (docs/MULTI_TAB.md), under a `seed:item-storage-migration:<db>` lock in case several tabs lead
+ * (`multiTab: 'off'`); a tab that isn't leader runs it if it takes over. Never throws.
+ */
+export declare function startLegacyItemStorageMigration(): void;
+/** Resolves when a background run started by {@link startLegacyItemStorageMigration} has finished (at once if none is running). */
+export declare function whenLegacyItemStorageMigrationSettled(): Promise<void>;
+//# sourceMappingURL=migrateLegacyItemStorageRows.d.ts.map

package/dist/src/db/migrateLegacyItemStorageRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateLegacyItemStorageRows.d.ts","sourceRoot":"","sources":["../../../src/db/migrateLegacyItemStorageRows.ts"],"names":[],"mappings":"AAcA,4FAA4F;AAC5F,eAAO,MAAM,iCAAiC,8BAA8B,CAAA;AAE5E,8FAA8F;AAC9F,eAAO,MAAM,0CAA0C,IAAI,CAAA;AAE3D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,qFAAqF;IACrF,WAAW,EAAE,OAAO,CAAA;IACpB,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAA;IACd,oGAAoG;IACpG,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAuFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,gCAAgC,CAAC,CAoF3C;AAkBD;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAWtD;AAED,mIAAmI;AACnI,wBAAgB,qCAAqC,IAAI,OAAO,CAAC,IAAI,CAAC,CAErE"}

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

@@ -0,0 +1,13 @@
+/**
+ * Where the download worker saves each child of a composite upload, by transaction id then child
+ * (property) name: a path relative to the files root.
+ *
+ * The paths come from the ItemStorage rows sync derives from a `storage_transaction_id`
+ * attestation (see `createMetadataRecordsForStorageTransactionId`): property value = the
+ * transaction id, `refResolvedValue` = `<txId><extension>`, `localStorageDir` = the model's storage
+ * directory. Those rows are what hydration reads, so a child saved here is found as that property's
+ * file. Transactions with no such rows are left out; the worker then falls back to the legacy
+ * html / json layout.
+ */
+export declare const getCompositeChildPaths: (transactionIds: string[]) => Promise<Record<string, Record<string, string>>>;
+//# sourceMappingURL=getCompositeChildPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCompositeChildPaths.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getCompositeChildPaths.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,gBAAgB,MAAM,EAAE,KACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkChD,CAAA"}

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,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"}
+{"version":3,"file":"getItems.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAclC,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,YAqG1B,CAAA"}

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

@@ -1,4 +1,4 @@
-import { AttestationRequest, AttestationRequestData } from '@ethereum-attestation-service/eas-sdk';
+import type { AttestationRequest, AttestationRequestData } from '@ethereum-attestation-service/eas-sdk';
 import { IItemProperty } from '../../interfaces';
 import { IItem } from '../../interfaces';
 import { PublishValidationFailedError, type PublishValidationError, type UnpublishedRelatedItem } from './publishErrors';

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":"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"}
+{"version":3,"file":"getPublishPayload.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishPayload.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,uCAAuC,CAAA;AAuB9C,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;AAiED,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,CAsH7B,CAAA"}

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

@@ -1,6 +1,8 @@
 import { IItem, IItemProperty } from '../../interfaces';
 import type { ArweaveTransaction, TransactionTag } from '../../types/arweave';
-import { PublishUpload } from '../../types/publish';
+import type { PublishUpload, PublishUploadData } from '../../types/publish';
+/** L1 transactions {@link getPublishUploads} creates at once (each asks the gateway for price and anchor). */
+export declare const CREATE_TRANSACTION_CONCURRENCY = 4;
 /** Optional tags merged into each Arweave tx after Content-SHA-256 / Content-Type. */
 export type GetPublishUploadsOptions = {
     arweaveUploadTags?: TransactionTag[];
@@ -20,11 +22,38 @@ export type UploadProperty = {
     itemProperty: IItemProperty<any>;
     childProperties: IItemProperty<any>[];
 };
+/**
+ * Local file of one ItemStorage child of a composite upload. Tries, in order: the property's
+ * localStoragePath (context set by save / hydration / the live query), its newest metadata row's
+ * refResolvedValue + localStorageDir, then (for a local draft whose propertyValue is the content
+ * itself, as rows made before Item.create saved ItemStorage values) that content written to its
+ * file, then (for a local draft, or no row) the name
+ * saveItemStorage gives a new file (`<seedUid or seedLocalId><extension>` in the model's storage
+ * directory). A published or derived row is never swapped for a local file of another name: that
+ * file would be older content.
+ *
+ * `missingLocalEdit` lists the paths tried when nothing exists although the newest row is a saved
+ * local edit (no attestation uid, not derived from one, refResolvedValue set by saveItemStorage):
+ * that edit's file should be there. A published or derived row without a file (e.g. content not
+ * downloaded, or a property the composite never had) is skipped as before.
+ */
+export declare const resolveItemStorageChildFile: (childProperty: IItemProperty<any>) => Promise<{
+    filePath?: string;
+    missingLocalEdit?: string[];
+}>;
 /** 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).
+ * Upload data for a publish of `item`: its own, and that of every draft item the publish carries
+ * along (reachable through relation and list properties, see publishDraftGraph.ts). Raw bytes plus
+ * Content-SHA-256 / Content-Type / configured tags; no Arweave transaction is created, so this
+ * does not touch the network. The bundler path in `@seedprotocol/publish` signs these as
+ * DataItems; {@link getPublishUploads} turns them into L1 transactions.
+ */
+export declare const getPublishUploadData: (item: IItem<any>, uploads?: PublishUploadData[], relatedItemProperty?: IItemProperty<any>, options?: GetPublishUploadsOptions) => Promise<PublishUploadData[]>;
+/**
+ * Arweave L1 transactions for a publish of `item`: {@link getPublishUploadData}, each made into an
+ * unsigned transaction carrying the same tags.
  */
 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;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"}
+{"version":3,"file":"getPublishUploads.d.ts","sourceRoot":"","sources":["../../../../src/db/read/getPublishUploads.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAkBvE,8GAA8G;AAC9G,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/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;AAoBD,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,CAQ5B,CAAA;AA8KD,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,CAAA;IAChC,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAA;CACtC,CAAA;AAsDD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,GACtC,eAAe,aAAa,CAAC,GAAG,CAAC,KAChC,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAmD5D,CAAA;AAsID,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;AAoND;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,iBAAiB,EAAO,EACjC,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,KACjC,OAAO,CAAC,iBAAiB,EAAE,CAa7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAS,aAAa,EAAO,EAC7B,sBAAsB,aAAa,CAAC,GAAG,CAAC,EACxC,UAAU,wBAAwB,KACjC,OAAO,CAAC,aAAa,EAAE,CAczB,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"summarizePublishWork.d.ts","sourceRoot":"","sources":["../../../../src/db/read/summarizePublishWork.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAKnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAQrE,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,uBAAuB,EAAE,sBAAsB,EAAE,CAAA;CAClD,CAAA;AAiBD,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAuCD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EACxB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAcT;AAuWD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAU,2BAA2B,KACpC,OAAO,CAAC,sBAAsB,EAAE,CAUlC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAU,2BAA2B,KACpC,OAAO,CAAC,kBAAkB,CAwB5B,CAAA"}
+{"version":3,"file":"summarizePublishWork.d.ts","sourceRoot":"","sources":["../../../../src/db/read/summarizePublishWork.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAKnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAQrE,YAAY,EAAE,WAAW,EAAE,CAAA;AAE3B,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,uBAAuB,EAAE,sBAAsB,EAAE,CAAA;CAClD,CAAA;AAiBD,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE;AAuCD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EACxB,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAcT;AAyVD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAU,2BAA2B,KACpC,OAAO,CAAC,sBAAsB,EAAE,CAUlC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,MAAM,KAAK,CAAC,GAAG,CAAC,EAChB,UAAU,2BAA2B,KACpC,OAAO,CAAC,kBAAkB,CAwB5B,CAAA"}

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

@@ -2,6 +2,8 @@ export type ClaimUnpublishedDraftsResult = {
     seeds: number;
     versions: number;
     metadata: number;
+    /** Local ids of the claimed seeds, so loaded Items can take the new publisher. */
+    seedLocalIds: string[];
 };
 /**
  * Stamp local seeds/versions/metadata that have no publisher and no real uid.

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

@@ -1 +1 @@
-{"version":3,"file":"claimUnpublishedDrafts.d.ts","sourceRoot":"","sources":["../../../../src/db/write/claimUnpublishedDrafts.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAQD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC,CAmDvC"}
+{"version":3,"file":"claimUnpublishedDrafts.d.ts","sourceRoot":"","sources":["../../../../src/db/write/claimUnpublishedDrafts.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AASD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC,CAoDvC"}

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

@@ -0,0 +1,44 @@
+import { type MetadataType } from '../../seedSchema';
+type VerbatimRowFields = Pick<MetadataType, 'uid' | 'derivedFromUid' | 'refResolvedValue' | 'propertyValue'>;
+/**
+ * A legacy ItemStorage draft row: a local edit (no attestation uid, not derived from one) that holds
+ * the content itself in property_value, with no file reference. Item.create / createNewItem stored
+ * ItemStorage values like this before they went through the save pipeline.
+ */
+export declare const isVerbatimItemStorageDraftRow: (row: VerbatimRowFields) => boolean;
+export type ItemStorageRowStorage = {
+    /** The property's `storage.path` (e.g. `/html`); the row's own localStorageDir, else `files`, when unset. */
+    localStorageDir?: string | null;
+    /** The property's `storage.extension` (e.g. `.html`). */
+    filenameSuffix?: string | null;
+    /** Seed id to name the file after; the row's seedUid, else its seedLocalId, when unset. */
+    seedId?: string | null;
+};
+export type ConvertedItemStorageRow = {
+    fileName: string;
+    filePath: string;
+    localStorageDir: string;
+    /** The content now in the file (the row's former property_value). */
+    content: string;
+};
+/**
+ * Convert one legacy ItemStorage draft row (see {@link isVerbatimItemStorageDraftRow}) into the
+ * shape saveItemStorage gives a row: the content goes to the file a save would write
+ * (`<seedUid or seedLocalId><extension>` in the property's storage directory), and the row records
+ * `refResolvedValue`, `localStorageDir` and `refValueType: 'file'` with property_value cleared.
+ * Used by publish (resolveItemStorageChildFile) and the one-time migration (migrateLegacyItemStorageRows).
+ *
+ * Reading the row, writing the file and updating the row happen under the file's lock
+ * ({@link withItemStorageFileLock}), which saveItemStorage holds too: a save in this or another tab
+ * either finishes before (the row, read again once the lock is held, is no longer legacy and is
+ * left alone) or starts after (and overwrites the file and row with its content). Without the lock
+ * a save landing between the read and the file write would have its file overwritten with the old
+ * content. The row update also stays conditional on the row being unchanged, for writers that
+ * don't take the lock (a tab still running an older SDK).
+ *
+ * Returns undefined when there was nothing to convert. Throws when the file can't be written; the
+ * row is then unchanged.
+ */
+export declare const convertVerbatimItemStorageRow: (localId: string, storage?: ItemStorageRowStorage) => Promise<ConvertedItemStorageRow | undefined>;
+export {};
+//# sourceMappingURL=convertVerbatimItemStorageRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convertVerbatimItemStorageRow.d.ts","sourceRoot":"","sources":["../../../../src/db/write/convertVerbatimItemStorageRow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAO1D,KAAK,iBAAiB,GAAG,IAAI,CAC3B,YAAY,EACZ,KAAK,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CAChE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,KAAK,iBAAiB,KAAG,OAK7C,CAAA;AAE1B,MAAM,MAAM,qBAAqB,GAAG;IAClC,6GAA6G;IAC7G,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,UAAS,qBAA0B,KAClC,OAAO,CAAC,uBAAuB,GAAG,SAAS,CA+C7C,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"createNewItem.d.ts","sourceRoot":"","sources":["../../../../src/db/write/createNewItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AASrC,KAAK,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,6CAIjC,kBAAkB,KAAG,OAAO,CAAC,uBAAuB,CAkDtD,CAAA"}
+{"version":3,"file":"createNewItem.d.ts","sourceRoot":"","sources":["../../../../src/db/write/createNewItem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAcrC,KAAK,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,6CAIjC,kBAAkB,KAAG,OAAO,CAAC,uBAAuB,CAiFtD,CAAA"}

package/dist/src/eventBus.d.ts

@@ -8,6 +8,11 @@ declare class SeedEventEmitter {
     off(event: EventKey, listener: Listener): this;
     removeListener(event: EventKey, listener: Listener): this;
     removeAllListeners(event?: EventKey): this;
+    /**
+     * Calls every listener. A listener that throws is logged and skipped: the others still
+     * run, and the error never reaches the SDK code that emitted the event (which may be
+     * midway through a save).
+     */
     emit(event: EventKey, ...args: any[]): boolean;
 }
 declare const eventEmitter: SeedEventEmitter;

package/dist/src/eventBus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../src/eventBus.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAC/B,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;AAExC,cAAM,gBAAgB;IACpB,OAAO,CAAC,SAAS,CAAqC;IAEtD,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAO7C,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAItD,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ/C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ9C,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIzD,kBAAkB,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI;IAS1C,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO;CAQ/C;AAED,QAAA,MAAM,YAAY,kBAAyB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../src/eventBus.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAC/B,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;AAExC,cAAM,gBAAgB;IACpB,OAAO,CAAC,SAAS,CAAqC;IAEtD,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAO7C,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAItD,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ/C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ9C,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIzD,kBAAkB,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI;IAS1C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO;CAY/C;AAED,QAAA,MAAM,YAAY,kBAAyB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,CAAA"}

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":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAkSnC,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"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../../src/events/files/download.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAgVnC,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,kBA0E9D,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/helpers/FileManager/BaseFileManager.d.ts

@@ -1,4 +1,4 @@
-import type { DownloadAllFilesParams, DownloadSingleFileParams, IFileManager, ResizeAllImagesParams, ResizeImageParams } from './IFileManager';
+import type { DownloadAllFilesParams, DownloadAllFilesResult, DownloadSingleFileParams, IFileManager, ResizeAllImagesParams, ResizeImageParams } from './IFileManager';
 export declare abstract class BaseFileManager {
     private static fileSystemInitialized;
     private static initializing;
@@ -23,8 +23,8 @@ export declare abstract class BaseFileManager {
      */
     static getFilesPath(...subpaths: string[]): string;
     static getContentUrlFromPath(path: string): Promise<string | undefined>;
-    static downloadAllFiles({ transactionIds, arweaveHost, arweaveBaseUrls, excludedTransactions, }: DownloadAllFilesParams): Promise<void>;
-    static downloadFileByTransactionId({ transactionId, arweaveHost, arweaveBaseUrls, excludedTransactions, }: DownloadSingleFileParams): Promise<void>;
+    static downloadAllFiles(params: DownloadAllFilesParams): Promise<DownloadAllFilesResult | void>;
+    static downloadFileByTransactionId({ transactionId, arweaveHost, arweaveBaseUrls, excludedTransactions, expectedContentHash, compositeChildPaths, }: DownloadSingleFileParams): Promise<DownloadAllFilesResult | 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":"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"}
+{"version":3,"file":"BaseFileManager.d.ts","sourceRoot":"","sources":["../../../../src/helpers/FileManager/BaseFileManager.ts"],"names":[],"mappings":"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"}

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

@@ -4,6 +4,26 @@ export type DownloadAllFilesParams = {
     /** Ordered read gateways (scheme + host + path) tried before `arweaveHost`; see `getArweaveReadBaseUrls`. */
     arweaveBaseUrls?: string[];
     excludedTransactions: Set<string>;
+    /**
+     * Content-SHA-256 tag values by transaction id. A download with one is saved only when its bytes
+     * match (SHA-256, or SHA3-256 for uploads from SDK 0.7.2 and earlier); see `contentSha256TagMatches`.
+     */
+    expectedContentHashes?: Record<string, string>;
+    /**
+     * Where each child of a composite upload is saved, by transaction id then child (property) name:
+     * a path relative to the files root, the one the SDK reads that ItemStorage property from. See
+     * `getCompositeChildPaths`. Children without one use the legacy html / json layout.
+     */
+    compositeChildPaths?: Record<string, Record<string, string>>;
+};
+/** What a browser download run did, by transaction id. */
+export type DownloadAllFilesResult = {
+    /** Bytes matched the expected Content-SHA-256 and were saved. */
+    verifiedTransactionIds: string[];
+    /** No gateway served bytes matching the expected Content-SHA-256; nothing was saved. */
+    hashMismatchTransactionIds: string[];
+    /** Saving failed (e.g. an OPFS write error). */
+    failedTransactionIds: string[];
 };
 export type DownloadSingleFileParams = {
     transactionId: string;
@@ -11,6 +31,10 @@ export type DownloadSingleFileParams = {
     /** Ordered read gateways (scheme + host + path) tried before `arweaveHost`; see `getArweaveReadBaseUrls`. */
     arweaveBaseUrls?: string[];
     excludedTransactions: Set<string>;
+    /** Content-SHA-256 tag value to verify the download against; see {@link DownloadAllFilesParams}. */
+    expectedContentHash?: string;
+    /** Where this transaction's composite children go, by child name; see {@link DownloadAllFilesParams}. */
+    compositeChildPaths?: Record<string, string>;
 };
 export type ResizeAllImagesParams = {
     width: number;
@@ -24,7 +48,7 @@ export type ResizeImageParams = {
 export interface IFileManager {
     initializeFileSystem(workingDir?: string): Promise<void>;
     getContentUrlFromPath(path: string): Promise<string | undefined>;
-    downloadAllFiles(params: DownloadAllFilesParams): Promise<void>;
+    downloadAllFiles(params: DownloadAllFilesParams): Promise<DownloadAllFilesResult | void>;
     resizeImage(params: ResizeImageParams): Promise<void>;
     resizeAllImages(params: ResizeAllImagesParams): Promise<void>;
     pathExists(filePath: string): Promise<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"IFileManager.d.ts","sourceRoot":"","sources":["../../../../src/helpers/FileManager/IFileManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IFileManager.d.ts","sourceRoot":"","sources":["../../../../src/helpers/FileManager/IFileManager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,33 @@
+import type { TransactionTag } from '../types/arweave';
+/**
+ * Tag every Seed upload carries with the hex digest of its data. Producers: the SDK's
+ * `getPublishUploadData` / `getPublishUploads` (and through them both the L1 transaction path and
+ * the bundler / DataItem path in `@seedprotocol/publish`). Consumer: the files download
+ * (`events/files/download.ts` and the download worker), which verifies downloaded bytes against it
+ * and copies a verified value into `metadata.content_hash`.
+ */
+export declare const CONTENT_SHA256_TAG = "Content-SHA-256";
+export declare const CONTENT_TYPE_TAG = "Content-Type";
+/**
+ * Lowercase hex SHA-256 of `data`: the value of the {@link CONTENT_SHA256_TAG} tag.
+ *
+ * Uses @noble/hashes rather than WebCrypto so it also works outside secure contexts (WebCrypto's
+ * `crypto.subtle` is missing on plain-http origins); the digest is the same.
+ *
+ * In SDK 0.7.2 and earlier the L1 transaction path (`getPublishUploads`) wrote SHA3-256 under this tag name
+ * while the bundler path wrote SHA-256. Uploads from that path still carry SHA3-256 digests; use
+ * {@link contentSha256TagMatches} to check a tag value against bytes.
+ */
+export declare const getContentSha256: (data: Uint8Array) => string;
+/**
+ * True when `tagValue` (a {@link CONTENT_SHA256_TAG} value read from Arweave) is the digest of
+ * `data`. Accepts SHA-256 and, for uploads made by SDK 0.7.2 and earlier through the L1 transaction path,
+ * SHA3-256.
+ */
+export declare const contentSha256TagMatches: (data: Uint8Array, tagValue: string) => boolean;
+/**
+ * Tags for one upload, in the order every upload uses: content hash, content type, then any
+ * configured extra tags (e.g. App-Name from `arweaveUploadTags`).
+ */
+export declare const buildArweaveContentTags: (contentHash: string | undefined, contentType: string | undefined, extra?: TransactionTag[]) => TransactionTag[];
+//# sourceMappingURL=arweaveContentTags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arweaveContentTags.d.ts","sourceRoot":"","sources":["../../../src/helpers/arweaveContentTags.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,oBAAoB,CAAA;AACnD,eAAO,MAAM,gBAAgB,iBAAiB,CAAA;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,UAAU,KAAG,MAAkC,CAAA;AAEtF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,MAAM,UAAU,EAAE,UAAU,MAAM,KAAG,OAI5E,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,MAAM,GAAG,SAAS,EAC/B,aAAa,MAAM,GAAG,SAAS,EAC/B,QAAQ,cAAc,EAAE,KACvB,cAAc,EAMhB,CAAA"}

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

@@ -0,0 +1,12 @@
+/**
+ * Lets helpers/db tell cached ModelProperty instances that their rows changed, without importing
+ * ModelProperty (helpers/db -> ModelProperty is a circular import, and a dynamic import of it can hang
+ * during init). ModelProperty registers its refresher when it loads; until then nothing is cached,
+ * so there is nothing to refresh.
+ */
+type CachedPropertyRefresher = (propertyFileIds: string[]) => Promise<void>;
+export declare function setCachedPropertyRefresher(fn: CachedPropertyRefresher): void;
+/** Give cached ModelProperty instances of these properties their rows' current values. */
+export declare function refreshCachedProperties(propertyFileIds: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=cachedPropertyRefresh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cachedPropertyRefresh.d.ts","sourceRoot":"","sources":["../../../src/helpers/cachedPropertyRefresh.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,KAAK,uBAAuB,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAI3E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,uBAAuB,GAAG,IAAI,CAE5E;AAED,0FAA0F;AAC1F,wBAAsB,uBAAuB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF"}

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

@@ -0,0 +1,28 @@
+/**
+ * Composite uploads: several ItemStorage files of one item in a single Arweave transaction.
+ *
+ * Producer: `getPublishUploads.ts` (`processUploadPropertyData`), for an item with a
+ * `storageTransactionId` property and ItemStorage properties (e.g. a Post's `html` and `json`).
+ * Consumer: the download worker (`browser/workers/filesDownload.ts`), which keeps its own copy of
+ * {@link decodeCompositeUpload} because it runs from a string; a test keeps the two in step.
+ *
+ * Format (unchanged for text children, so composites already on Arweave still read):
+ *
+ *   ===FILE_SEPARATOR===<name>===FILE_SEPARATOR===<utf-8 text>   (repeated per child)
+ *
+ * A child that is not valid UTF-8 text (or whose text contains the separator) is written as
+ * base64 under the name `<name>;base64`. Composites written before this suffix existed converted
+ * every child to text, which corrupted binary children; those bytes cannot be recovered.
+ */
+export declare const COMPOSITE_SEPARATOR = "===FILE_SEPARATOR===";
+export declare const COMPOSITE_BASE64_SUFFIX = ";base64";
+export type CompositeChild = {
+    name: string;
+    bytes: Uint8Array;
+};
+export declare const encodeCompositeUpload: (children: CompositeChild[]) => Uint8Array;
+/** True when `bytes` start with the composite separator (checked on bytes, before any text heuristics). */
+export declare const isCompositeUpload: (bytes: Uint8Array) => boolean;
+/** Children of a composite, or `undefined` when `bytes` are not a well-formed composite. */
+export declare const decodeCompositeUpload: (bytes: Uint8Array) => CompositeChild[] | undefined;
+//# sourceMappingURL=compositeUpload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compositeUpload.d.ts","sourceRoot":"","sources":["../../../src/helpers/compositeUpload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,yBAAyB,CAAA;AACzD,eAAO,MAAM,uBAAuB,YAAY,CAAA;AAEhD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAA;AAkChE,eAAO,MAAM,qBAAqB,GAAI,UAAU,cAAc,EAAE,KAAG,UAUlE,CAAA;AAID,2GAA2G;AAC3G,eAAO,MAAM,iBAAiB,GAAI,OAAO,UAAU,KAAG,OACqC,CAAA;AAE3F,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,GAAI,OAAO,UAAU,KAAG,cAAc,EAAE,GAAG,SAkB5E,CAAA"}

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

@@ -84,6 +84,9 @@ export declare const addModelsToDb: (models: ModelDefinitions, schema?: SchemaTy
     schemaFileId?: string;
     modelFileIds?: Map<string, string>;
     propertyFileIds?: Map<string, Map<string, string>>;
+    propertyDefinitions?: Map<string, {
+        [propertyName: string]: any;
+    }>;
 }) => Promise<void>;
 /**
  * Loads models from the database for a given schema by querying the model_schemas join table.

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

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/helpers/db.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/helpers/db.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+type EasSdk = typeof import('@ethereum-attestation-service/eas-sdk');
+/**
+ * Load eas-sdk on first use instead of at SDK import time.
+ *
+ * On Node this loads eas-sdk's CommonJS build. Its ESM build (2.9.1+) does
+ * `import { isEqual } from 'lodash'`, which Node rejects because lodash is
+ * CommonJS, so a static import made `import '@seedprotocol/sdk'` fail unless the
+ * app ran with `--import @seedprotocol/sdk/node-eas-lodash`.
+ *
+ * `process.getBuiltinModule` (Node 20.16+, 22.3+) keeps `node:module` out of the
+ * import graph, so browser bundlers never see it. Bundlers resolve the
+ * `import()` branch, and handle lodash there themselves.
+ */
+export declare function loadEasSdk(): Promise<EasSdk>;
+export {};
+//# sourceMappingURL=easSdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"easSdk.d.ts","sourceRoot":"","sources":["../../../src/helpers/easSdk.ts"],"names":[],"mappings":"AAEA,KAAK,MAAM,GAAG,cAAc,uCAAuC,CAAC,CAAA;AAIpE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAkB5C"}

package/dist/src/helpers/entity/detachRowsBeforeDelete.d.ts

@@ -0,0 +1,16 @@
+import type { BaseDb } from '../../db/Db/BaseDb';
+type AppDb = NonNullable<ReturnType<typeof BaseDb.getAppDb>>;
+/**
+ * Before deleting property rows: unlink stored item values (metadata.property_id → NULL; the
+ * values stay, keyed by property name) and drop the properties' EAS uid mappings. Without this,
+ * Node (libsql enforces foreign keys) fails the delete as soon as an item has a value, and the
+ * browser leaves rows pointing at deleted ids.
+ */
+export declare function detachPropertyRows(db: AppDb, propertyIds: readonly number[]): Promise<void>;
+/**
+ * Before deleting model rows: detach their properties' rows (as above), drop the models' EAS
+ * uid mappings, and clear relation properties elsewhere that point at them (ref_model_id).
+ */
+export declare function detachModelRows(db: AppDb, modelIds: readonly number[]): Promise<void>;
+export {};
+//# sourceMappingURL=detachRowsBeforeDelete.d.ts.map

package/dist/src/helpers/entity/detachRowsBeforeDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detachRowsBeforeDelete.d.ts","sourceRoot":"","sources":["../../../../src/helpers/entity/detachRowsBeforeDelete.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAG5C,KAAK,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AAE5D;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3F"}

package/dist/src/helpers/entity/entityDestroy.d.ts

@@ -35,6 +35,8 @@ export interface RunDestroyLifecycleConfig<T extends object> {
 /**
  * Run the service event sequence and stop the service:
  * destroyStarted -> doDestroy -> (destroyError on failure) -> stop.
+ * A doDestroy failure is recorded on the service (destroyError) and rethrown, so destroy()
+ * rejects instead of resolving with the rows still in the DB.
  * Event names must match what the entity machines expect.
  */
 export declare function runDestroyLifecycle<T extends object>(instance: T, config: RunDestroyLifecycleConfig<T>): Promise<void>;

package/dist/src/helpers/entity/entityDestroy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entityDestroy.d.ts","sourceRoot":"","sources":["../../../../src/helpers/entity/entityDestroy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,+BAA+B,CAAC,CAAC,SAAS,MAAM;IAC/D,aAAa,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACzF,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAA;CACjC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EACxD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,+BAA+B,CAAC,CAAC,CAAC,GACzC,IAAI,CAiBN;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,MAAM;IAC3D,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC9B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,IAAI,CAcN;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,MAAM;IACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK;QAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IAC9E,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EACxD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"entityDestroy.d.ts","sourceRoot":"","sources":["../../../../src/helpers/entity/entityDestroy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,+BAA+B,CAAC,CAAC,SAAS,MAAM;IAC/D,aAAa,EAAE,OAAO,CAAC,CAAC,EAAE;QAAE,qBAAqB,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACzF,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAA;CACjC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EACxD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,+BAA+B,CAAC,CAAC,CAAC,GACzC,IAAI,CAiBN;AAED,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,MAAM;IAC3D,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,CAAA;IACvC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC9B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;CACzC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,IAAI,CAcN;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,MAAM;IACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK;QAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IAC9E,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EACxD,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAef"}