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

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

@@ -0,0 +1,57 @@
+import { type MetadataType } from '../seedSchema';
+export type ItemStorageFileTarget = {
+    /** The item's seedUid, else its seedLocalId: the file is `<seedId><extension>`. */
+    seedId: string;
+    /** The property's `storage.path` (e.g. `/html`); `files` when unset. */
+    localStorageDir?: string | null;
+    /** The property's `storage.extension` (e.g. `.html`). */
+    filenameSuffix?: string | null;
+    /** An existing file name to write to instead (the row's refResolvedValue). */
+    fileName?: string | null;
+};
+/** Absolute path of the file {@link writeItemStorageFile} writes for `target`. */
+export declare const getItemStorageFilePath: (target: ItemStorageFileTarget) => string;
+/**
+ * Write an ItemStorage property's content to its local file, where saveItemStorage, reads, publish
+ * (resolveItemStorageChildFile) and download all look for it. Returns what the metadata row records:
+ * `refResolvedValue` (the file name) and `localStorageDir` (with a leading slash).
+ *
+ * Callers that also update the file's metadata row hold {@link withItemStorageFileLock} around
+ * both, so another writer of the same file can't land in between.
+ */
+export declare const writeItemStorageFile: (target: ItemStorageFileTarget, content: string | Blob | ArrayBuffer) => Promise<{
+    fileName: string;
+    filePath: string;
+    localStorageDir: string;
+}>;
+/**
+ * Lock name for one ItemStorage file: `seed:item-storage:<absolute file path>`. The path starts
+ * with the files root, which also names the database (`<filesDir>/db/seed.db`), so the name is
+ * per database as well as per file.
+ */
+export declare const itemStorageFileLockName: (filePath: string) => string;
+/**
+ * Runs `fn` holding the lock of one ItemStorage file, across tabs (Web Locks) and within this JS
+ * realm (an in-process queue where Web Locks are missing, e.g. Node < 24.5; see `withTabLock`).
+ *
+ * Writers of a local draft's file (saveItemStorage, convertVerbatimItemStorageRow, createNewItem)
+ * hold it across "read the row → write the file → update the row", so the file and the row end
+ * with the same writer's content. See docs/MULTI_TAB.md.
+ *
+ * Lock ordering: this lock is always the innermost. It may be taken while holding a broader lock
+ * (`seed:item-storage-migration:<db>`, `seed:publish:<seedLocalId>`), never the other way round,
+ * and no other lock (nor a second file lock) is requested while it is held. Keep the section to
+ * local DB and file I/O: no network. Not re-entrant.
+ */
+export declare function withItemStorageFileLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Runs `fn` with a fresh read of metadata row `localId`, holding the lock of the file that row's
+ * content goes to. `fileOf` names that file (absolute path) for a row, or returns undefined when
+ * there is nothing to write (then `fn` isn't called and the result is undefined).
+ *
+ * The file depends on the row, so the row is read once to pick the lock and again once it is held;
+ * if the row now points at another file (another writer changed it meanwhile), the lock is
+ * released and taken again for that file.
+ */
+export declare function withLockedItemStorageRow<T>(localId: string, fileOf: (row: MetadataType) => string | undefined, fn: (row: MetadataType, filePath: string) => Promise<T>): Promise<T | undefined>;
+//# sourceMappingURL=itemStorageFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"itemStorageFile.d.ts","sourceRoot":"","sources":["../../../src/helpers/itemStorageFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAK1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,qBAAqB,KAAG,MAIpE,CAAA;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,qBAAqB,EAC7B,SAAS,MAAM,GAAG,IAAI,GAAG,WAAW,KACnC,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAOzE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,MAAyC,CAAA;AAEpG;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7F;AAcD;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,EACjD,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAgBxB"}

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

@@ -0,0 +1,7 @@
+/**
+ * `Promise.all(items.map(fn))` with at most `limit` calls in flight. Results keep the input order.
+ * Rejects with the first error (by time); after that no new calls start, though calls already in
+ * flight run to completion.
+ */
+export declare function mapWithConcurrency<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=mapWithConcurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapWithConcurrency.d.ts","sourceRoot":"","sources":["../../../src/helpers/mapWithConcurrency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAoBd"}

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

@@ -0,0 +1,43 @@
+/**
+ * File extension <-> MIME type, shared by the upload side (`getPublishUploads.ts`, which sets the
+ * `Content-Type` tag) and the download worker (`browser/workers/filesDownload.ts`, which picks the
+ * extension of a file saved under `files/`). The worker runs from a string and cannot import this
+ * module, so {@link MIME_TO_EXTENSION} is injected into its source as JSON.
+ */
+/**
+ * Lowercase extension (no dot) to MIME type. Includes the odd extensions the SDK itself produces:
+ * `saveImage` names a file `<id>.<subtype>` (e.g. `.svg+xml`, `.x-icon`), so subtypes appear here too.
+ */
+export declare const EXTENSION_TO_MIME: Readonly<Record<string, string>>;
+/**
+ * MIME type to the extension a downloaded file gets. One canonical extension per type (the
+ * first one listed here wins over {@link EXTENSION_TO_MIME}'s aliases), plus a few common
+ * non-canonical spellings a gateway may send.
+ */
+export declare const MIME_TO_EXTENSION: Readonly<Record<string, string>>;
+/**
+ * Content types that say nothing about the content. A Blob carrying one of these is treated as
+ * untyped.
+ */
+export declare const GENERIC_MIME_TYPES: readonly string[];
+/** Lowercase `type/subtype` without parameters; `undefined` when empty or generic. */
+export declare const normalizeMimeType: (mimeType: string | null | undefined) => string | undefined;
+/** MIME type for a path or file name by its extension, if it has a known one. */
+export declare const getMimeTypeFromPath: (filePathOrName: string) => string | undefined;
+/** Extension (no dot) for a MIME type, if it has a well-known one. */
+export declare const getExtensionForMimeType: (mimeType: string | null | undefined) => string | undefined;
+/**
+ * MIME type from the leading bytes, for formats with an unambiguous signature. Used when a local
+ * file has no (known) extension, e.g. a file seed named after its id.
+ */
+export declare const sniffMimeType: (bytes: Uint8Array) => string | undefined;
+/**
+ * Best MIME type for upload bytes: the source's own type (a Blob/File `type`) when it is specific,
+ * then the file name's extension, then the bytes' signature.
+ */
+export declare const resolveUploadMimeType: (params: {
+    sourceType?: string | null;
+    fileName?: string | null;
+    bytes?: Uint8Array;
+}) => string | undefined;
+//# sourceMappingURL=mimeTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mimeTypes.d.ts","sourceRoot":"","sources":["../../../src/helpers/mimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwE9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiC3D,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAI/C,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAIhF,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,GAAI,gBAAgB,MAAM,KAAG,MAAM,GAAG,SAKrE,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAGtF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,UAAU,KAAG,MAAM,GAAG,SA4B1D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,KAAG,MAAM,GAAG,SAG6C,CAAA"}

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

@@ -25,12 +25,28 @@ export declare function publisherIsInOwnedSet(publisher: string | null | undefin
  */
 export declare function isSeedRowOwned(row: SeedOwnershipRow, ownedAddresses: readonly string[]): boolean;
 /**
- * SQL for `addressFilter: 'owned' | 'watched'`. Empty list → no rows (`1=0`).
- * Compares `lower(publisher)` so checksummed rows match persisted lowercase owned.
+ * SQL for an address list on `publisher`. Empty list → no rows (`1=0`).
+ * Compares `lower(publisher)` so checksummed rows match persisted lowercase addresses.
+ * Used for `addressFilter: 'watched'`; `'owned'` uses {@link ownedSeedsSql}.
  */
 export declare function publisherInAddressListSql(column: typeof seeds.publisher, addresses: readonly string[]): SQL;
-/** Owned-list SQL on `seeds.publisher`. */
+/**
+ * @deprecated Matches `seeds.publisher` only. Use {@link ownedSeedsSql}, which agrees
+ * with {@link isSeedRowOwned} (empty owned → local unsealed drafts; attester fallback).
+ */
 export declare function ownedPublisherSql(ownedAddresses: readonly string[]): SQL;
+/** SQL form of {@link isPlaceholderUid}: null, `''`, `'NULL'`, or zero bytes32 (trimmed, any case). */
+export declare function placeholderUidSql(column: typeof seeds.uid): SQL;
+/** SQL form of {@link isLocalUnsealedDraft} on `seeds`. */
+export declare function localUnsealedDraftSql(): SQL;
+/**
+ * SQL for `addressFilter: 'owned'`: a row passes exactly when {@link isSeedRowOwned} is true.
+ * - Empty owned → local unsealed drafts (pre-connect authoring), not every row.
+ * - Owned set → `lower(trim(publisher))` in the set, or, when publisher is blank, the
+ *   `attestationRaw.attester` ({@link resolvePublisherFromSeedRow}). `json_valid` guards
+ *   `json_extract`, which throws on malformed JSON.
+ */
+export declare function ownedSeedsSql(ownedAddresses: readonly string[]): SQL;
 /**
  * Checks if the current user owns the item (publisher is in persisted owned addresses).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/helpers/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAoB,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAOxD,KAAK,QAAQ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AA6BD,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAWhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAMnE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,KAAK,CAAC,SAAS,EAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,GAAG,CAML;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAExE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF"}
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/helpers/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAQzE,KAAK,QAAQ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AA6BD,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAWhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAMnE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,KAAK,CAAC,SAAS,EAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,GAAG,CAML;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAExE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,GAAG,GAAG,CAO/D;AAKD,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,GAAG,CAM3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAUpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF"}

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

@@ -0,0 +1,16 @@
+/** Subdirectory of the files root that holds a storage seed's file, by its data type. */
+export declare const getStorageSubdirForDataType: (dataType: string | null | undefined) => "images" | "files" | "html" | "json";
+/** Absolute directory for a storage seed's file (`images/`, `files/`, `html/` or `json/` under the files root). */
+export declare const getStorageDirForDataType: (dataType: string | null | undefined) => string;
+/**
+ * Subdirectory (relative to the files root, no leading slash) for an ItemStorage property's file:
+ * its model's `storage.path` (`localStorageDir`), else `files`.
+ */
+export declare const getItemStorageSubdir: (localStorageDir: string | null | undefined) => string;
+/**
+ * File name a local save gives an ItemStorage property: `<seedUid or seedLocalId><extension>`
+ * (see saveItemStorage). Downloaded content is named after its transaction instead
+ * (`<txId><extension>`, see syncDbWithEas), which is what the metadata row's refResolvedValue says.
+ */
+export declare const getItemStorageLocalFileName: (seedId: string, filenameSuffix: string | null | undefined) => string;
+//# sourceMappingURL=storageDir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storageDir.d.ts","sourceRoot":"","sources":["../../../src/helpers/storageDir.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,eAAO,MAAM,2BAA2B,GACtC,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAClC,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAahC,CAAA;AAED,mHAAmH;AACnH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MACV,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,iBAAiB,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MACN,CAAA;AAE5E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,MAAM,EACd,gBAAgB,MAAM,GAAG,IAAI,GAAG,SAAS,KACxC,MAA4C,CAAA"}

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

@@ -20,11 +20,13 @@ export type TabMessage = {
     name: string;
     payload?: unknown;
 }
-/** OPFS paths another tab (or its workers) wrote. */
+/** OPFS paths another tab (or its workers) wrote or removed, coalesced (helpers/tabEvents.ts). */
  | {
     type: 'files-changed';
     paths: string[];
 };
+/** Identifies this tab (this page's SDK instance) in the messages it sends. */
+export declare const TAB_ID: string;
 /** Starts once per page; later calls (re-init) keep the first database. */
 export declare function startTabCoordination({ filesDir, mode }: {
     filesDir: string;
@@ -35,6 +37,8 @@ export declare function isLeaderTab(): boolean;
 export declare function whenLeaderTab(): Promise<void>;
 /** Sends to the other tabs of this database; a no-op when not coordinating. */
 export declare function postTabMessage(message: TabMessage): void;
+/** Whether postTabMessage reaches other tabs (a browser tab coordinating with Web Locks). */
+export declare function isPostingTabMessages(): boolean;
 export declare function onTabMessage(handler: (message: TabMessage) => void): () => void;
 /** `withTabLock` named for this database (`seed:<scope>:<db>`); runs `fn` directly before init. */
 export declare function withDbTabLock<T>(scope: string, fn: () => Promise<T>, options?: {

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

@@ -1 +1 @@
-{"version":3,"file":"tabCoordinator.d.ts","sourceRoot":"","sources":["../../../src/helpers/tabCoordinator.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,KAAK,CAAA;AAE/C,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE;AAC1D,4EAA4E;GAC1E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AACpD,qDAAqD;GACnD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAc9C,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAmB,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CA4BvH;AAWD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,iEAAiE;AACjE,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAExD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAG/E;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAElH;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,IAAI,IAAI,CAMnD"}
+{"version":3,"file":"tabCoordinator.d.ts","sourceRoot":"","sources":["../../../src/helpers/tabCoordinator.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,KAAK,CAAA;AAE/C,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE;AAC1D,4EAA4E;GAC1E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AACpD,kGAAkG;GAChG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAK9C,+EAA+E;AAC/E,eAAO,MAAM,MAAM,EAAE,MAGoD,CAAA;AAczE,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAmB,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CA+BvH;AAWD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,iEAAiE;AACjE,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAExD;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI,CAG/E;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAElH;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,IAAI,IAAI,CAMnD"}

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

@@ -13,8 +13,8 @@ export type CrossTabEventName = typeof EAS_SEED_DATA_SYNCED_TO_DB_EVENT | typeof
 /** Emits on this tab's event bus and in every other tab of this database. */
 export declare function emitAcrossTabs(name: CrossTabEventName, payload?: unknown): void;
 /**
- * A file saved through this tab's file system: emits `file-saved` here (as before) and tells other
- * tabs, whose caches don't see it.
+ * A file saved through this tab's file system: emits `file-saved` here. Other tabs hear about it
+ * from the file system itself (see queueFilesChangedNotice), once the write has reached OPFS.
  */
 export declare function notifyFileSaved(filePath: string): void;
 /**
@@ -22,6 +22,27 @@ export declare function notifyFileSaved(filePath: string): void;
  * FILES_CHANGED_EVENT, and tells other tabs to do the same.
  */
 export declare function notifyFilesWrittenOutsideCache(paths: string[]): Promise<void>;
+/**
+ * How long changed paths gather before one `files-changed` message goes out. Counted from the
+ * first queued path, so a steady stream of writes still sends once per window, never later.
+ */
+export declare const FILES_CHANGED_FLUSH_MS = 25;
+/** Keeps a message for a huge batch (a bulk download) from being one giant structured clone. */
+export declare const FILES_CHANGED_MAX_PATHS = 500;
+/**
+ * Tells other tabs that these absolute ZenFS paths changed in OPFS, so they drop and re-read their
+ * cached copies (the sync API's in-memory copy in particular). The browser file system calls this
+ * for every file it writes, truncates or removes (`TolerantWebAccessFS.onOpfsChange`, wired in
+ * `BrowserFileManager.initializeFileSystem`), after the change reached OPFS. Paths are coalesced
+ * for FILES_CHANGED_FLUSH_MS, so bulk writes (migrations, schema processing, downloads) send a few
+ * messages rather than one per write.
+ *
+ * Defense in depth only: a tab that misses a message still sees the change on its next async
+ * stat() (see TolerantWebAccessFS.stat). A no-op unless this tab coordinates with others.
+ */
+export declare function queueFilesChangedNotice(paths: Iterable<string>): void;
+/** Sends the queued paths now (page hide, tests). */
+export declare function flushFilesChangedNotices(): void;
 /** Applies other tabs' events and file changes in this tab. */
 export declare function listenForOtherTabsEvents(): void;
 //# sourceMappingURL=tabEvents.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tabEvents.d.ts","sourceRoot":"","sources":["../../../src/helpers/tabEvents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACvF,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AAMtE;;;;;GAKG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAG,kBAA2B,CAAA;AAE9D,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GACzB,OAAO,gCAAgC,GACvC,OAAO,yBAAyB,GAChC,OAAO,0BAA0B,CAAA;AAErC,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAO/E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGtD;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnF;AAyBD,+DAA+D;AAC/D,wBAAgB,wBAAwB,IAAI,IAAI,CAoB/C"}
+{"version":3,"file":"tabEvents.d.ts","sourceRoot":"","sources":["../../../src/helpers/tabEvents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AACvF,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AAMtE;;;;;GAKG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAG,kBAA2B,CAAA;AAE9D,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GACzB,OAAO,gCAAgC,GACvC,OAAO,yBAAyB,GAChC,OAAO,0BAA0B,CAAA;AAErC,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAO/E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnF;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC,gGAAgG;AAChG,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAM1C;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAUrE;AAED,qDAAqD;AACrD,wBAAgB,wBAAwB,IAAI,IAAI,CAS/C;AAyBD,+DAA+D;AAC/D,wBAAgB,wBAAwB,IAAI,IAAI,CAqB/C"}