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

package/dist/tabEvents-DguZpCCv.js

@@ -1,1580 +0,0 @@
-import debug from 'debug';
-import { B as BaseDb, m as metadata, t as BaseFileManager, a as appState, D as ImageSize, E as EAS_SEED_DATA_SYNCED_TO_DB_EVENT } from './BasePathResolver-CfSfMW5_.js';
-import { isEasAttestationExplorerUrl, BaseArweaveClient, ensureReadGatewaySelected, getArweaveReadBaseUrls, getTransactionTagsByIds } from '@seedprotocol/arweave';
-import { BaseQueryClient, BaseEasClient, GET_FILES_METADATA } from '@seedprotocol/eas';
-import { waitFor } from 'xstate';
-import 'pluralize';
-import { n as normalizeDataType, t as getAllAddressesFromDb, m as eventEmitter } from './db-D9K_f5cF.js';
-import { and, eq, isNotNull, inArray, or } from 'drizzle-orm';
-import { customAlphabet } from 'nanoid';
-import { alphanumeric } from 'nanoid-dictionary';
-import '@seedprotocol/query';
-import { sha256 } from '@noble/hashes/sha256';
-import { sha3_256 } from '@noble/hashes/sha3';
-import { bytesToHex } from '@noble/hashes/utils';
-import { throttle } from 'lodash-es';
-
-/** Same rules as getCorrectId in helpers/index (avoid barrel circular import). */
-function parseLocalIdOrUid(localIdOrUid) {
-    const id = { localId: undefined, uid: undefined };
-    if (!localIdOrUid)
-        return id;
-    if (localIdOrUid.length === 10) {
-        id.localId = localIdOrUid;
-    }
-    if (localIdOrUid.startsWith('0x') && localIdOrUid.length === 66) {
-        id.uid = localIdOrUid;
-    }
-    return id;
-}
-/** Relation/image refs may be string ids or `{ seedLocalId?, seedUid? }`. */
-function normalizeRelationPropertyValue(value) {
-    if (value == null)
-        return undefined;
-    if (typeof value === 'string') {
-        const t = value.trim();
-        return t !== '' ? t : undefined;
-    }
-    if (typeof value === 'object' && value !== null) {
-        const o = value;
-        if (typeof o.seedLocalId === 'string' && o.seedLocalId.trim() !== '') {
-            return o.seedLocalId.trim();
-        }
-        if (typeof o.seedUid === 'string' && o.seedUid.trim() !== '') {
-            return o.seedUid.trim();
-        }
-    }
-    return undefined;
-}
-/** getCorrectId only accepts 10-char local ids and 0x66 uids; local seed refs can be up to 21 chars. */
-const LOCAL_SEED_REF = /^[a-zA-Z0-9_-]{10,21}$/;
-/** Resolve seed ids from a single string (context propertyValue or DB row). */
-function resolveSeedIdsFromRefString(s) {
-    const fromCorrect = parseLocalIdOrUid(s);
-    if (fromCorrect.localId || fromCorrect.uid) {
-        return { seedLocalId: fromCorrect.localId, seedUid: fromCorrect.uid };
-    }
-    if (LOCAL_SEED_REF.test(s) && !s.startsWith('0x')) {
-        return { seedLocalId: s };
-    }
-    return {};
-}
-/**
- * True when a relation ref is an attested seed uid (0x…) rather than a local id. A uid only exists once
- * the seed is on EAS, so publish can attest the uid as-is when no local copy exists (e.g. a server
- * publishing on someone's behalf that only holds the uids it was given). Callers must not walk into it.
- */
-function isPublishedSeedRef(value) {
-    const ref = normalizeRelationPropertyValue(value);
-    if (!ref)
-        return false;
-    const { seedLocalId, seedUid } = resolveSeedIdsFromRefString(ref);
-    return !!seedUid && !seedLocalId;
-}
-/**
- * Storage seed local id (nanoid) or 0x uid. Stricter than resolveSeedIdsFromRefString, which accepts
- * any 10-char string (so a 10-char html snippet like "<p>raw</p>" would pass as a local id).
- */
-const STORAGE_SEED_REF = /^(?:[A-Za-z0-9_-]{10,21}|0x[0-9a-fA-F]{64})$/;
-/** True when a File/Image/Html value is already a storage seed reference rather than raw content. */
-function isStorageSeedRef(value) {
-    return typeof value === 'string' && STORAGE_SEED_REF.test(value.trim());
-}
-
-const seedUidToStorageTransactionId = new Map();
-const getStorageTransactionIdForSeedUid = async (seedUid) => {
-    if (seedUidToStorageTransactionId.has(seedUid)) {
-        return seedUidToStorageTransactionId.get(seedUid);
-    }
-    const appDb = BaseDb.getAppDb();
-    const results = (await appDb
-        .select({
-        storageTransactionId: metadata.propertyValue,
-    })
-        .from(metadata)
-        .where(and(eq(metadata.seedUid, seedUid), eq(metadata.propertyName, 'storageTransactionId'))));
-    if (!results || results.length === 0) {
-        return;
-    }
-    seedUidToStorageTransactionId.set(seedUid, results[0].storageTransactionId);
-    return results[0].storageTransactionId;
-};
-
-const logger$5 = debug('seedSdk:helpers:mediaRef');
-/** Typical Arweave transaction id: 43 URL-safe base64 characters. */
-const ARWEAVE_TX_ID = /^[a-zA-Z0-9_-]{43}$/;
-function trimOrEmpty(raw) {
-    if (raw == null)
-        return '';
-    return typeof raw === 'string' ? raw.trim() : String(raw).trim();
-}
-function coalesceStringField(item, key) {
-    const v = item[key];
-    if (v == null)
-        return '';
-    if (typeof v === 'string')
-        return v.trim();
-    if (typeof v === 'number' || typeof v === 'boolean')
-        return String(v);
-    return '';
-}
-/**
- * Try JSON relation payloads and plain relation id strings.
- */
-function unwrapRelationString(raw) {
-    const t = raw.trim();
-    if (!t)
-        return t;
-    try {
-        const parsed = JSON.parse(t);
-        const fromObj = normalizeRelationPropertyValue(parsed);
-        if (fromObj)
-            return fromObj;
-    }
-    catch {
-        // not JSON
-    }
-    return t;
-}
-/**
- * Pure, sync classification of a media-related string from feeds or XML.
- */
-function classifyMediaRef(raw, options) {
-    const s = trimOrEmpty(raw);
-    if (!s) {
-        return { kind: 'empty' };
-    }
-    const treatAs = options?.treatAs;
-    if (treatAs === 'url') {
-        return { kind: 'url', href: s };
-    }
-    if (treatAs === 'arweaveTx') {
-        return { kind: 'arweaveTxId', txId: s };
-    }
-    if (treatAs === 'seedUid') {
-        if (s.startsWith('0x') && s.length === 66) {
-            return { kind: 'seedUid', uid: s };
-        }
-        return { kind: 'unknown', raw: s };
-    }
-    if (s.startsWith('http://') || s.startsWith('https://') || s.startsWith('blob:') || s.startsWith('data:')) {
-        if (isEasAttestationExplorerUrl(s)) {
-            return { kind: 'nonMediaUrl', href: s };
-        }
-        return { kind: 'url', href: s };
-    }
-    const unwrapped = unwrapRelationString(s);
-    const ids = resolveSeedIdsFromRefString(unwrapped);
-    if (ids.seedUid) {
-        return { kind: 'seedUid', uid: ids.seedUid };
-    }
-    if (ids.seedLocalId) {
-        return { kind: 'seedLocalId', localId: ids.seedLocalId };
-    }
-    if (unwrapped.startsWith('0x') && unwrapped.length === 66) {
-        return { kind: 'seedUid', uid: unwrapped };
-    }
-    if (ARWEAVE_TX_ID.test(unwrapped) && !unwrapped.startsWith('0x')) {
-        return { kind: 'arweaveTxId', txId: unwrapped };
-    }
-    return { kind: 'unknown', raw: s };
-}
-/**
- * Same as convertTxIdToImage but local to this module to avoid circular imports with helpers/index.
- */
-async function tryLocalBlobUrlFromTxId(txId) {
-    const imageFilePath = BaseFileManager.getFilesPath('images', txId);
-    const fileExists = await BaseFileManager.pathExists(imageFilePath);
-    if (!fileExists) {
-        logger$5(`[tryLocalBlobUrlFromTxId] ${imageFilePath} does not exist`);
-        return undefined;
-    }
-    const buffer = await BaseFileManager.readFileAsBuffer(imageFilePath);
-    let arrayBuffer;
-    if (buffer instanceof Blob) {
-        arrayBuffer = await buffer.arrayBuffer();
-    }
-    else if (buffer instanceof ArrayBuffer) {
-        arrayBuffer = buffer;
-    }
-    else {
-        const sliced = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-        if (sliced instanceof SharedArrayBuffer) {
-            const uint8Array = new Uint8Array(sliced);
-            arrayBuffer = uint8Array.buffer.slice(0);
-        }
-        else {
-            arrayBuffer = sliced;
-        }
-    }
-    const uint = new Uint8Array(arrayBuffer);
-    const imageBlob = new Blob([uint]);
-    return URL.createObjectURL(imageBlob);
-}
-async function resolveTxId(txId) {
-    const local = await tryLocalBlobUrlFromTxId(txId);
-    if (local) {
-        return { status: 'ready', href: local, source: 'localBlob' };
-    }
-    return {
-        status: 'ready',
-        href: BaseArweaveClient.getRawUrl(txId),
-        source: 'gateway',
-    };
-}
-/**
- * Resolve a classified media reference to a display URL (https/blob/data), using local files when present.
- */
-async function resolveMediaRef(raw, options) {
-    const classification = classifyMediaRef(raw, options);
-    switch (classification.kind) {
-        case 'empty':
-            return { status: 'empty' };
-        case 'url':
-            return {
-                status: 'ready',
-                href: classification.href,
-                source: 'direct',
-            };
-        case 'nonMediaUrl':
-            return {
-                status: 'unresolved',
-                reason: 'non_media_url',
-                classification,
-            };
-        case 'seedLocalId':
-            return {
-                status: 'unresolved',
-                reason: 'seed_local_id_not_portable',
-                classification,
-            };
-        case 'unknown':
-            return {
-                status: 'unresolved',
-                reason: 'unknown_ref',
-                classification,
-            };
-        case 'arweaveTxId':
-            return resolveTxId(classification.txId);
-        case 'seedUid': {
-            const appDb = BaseDb.getAppDb();
-            if (!appDb) {
-                return {
-                    status: 'unresolved',
-                    reason: 'seed_uid_requires_app_db',
-                    classification,
-                };
-            }
-            const storageTransactionId = await getStorageTransactionIdForSeedUid(classification.uid);
-            if (!storageTransactionId) {
-                return {
-                    status: 'unresolved',
-                    reason: 'seed_uid_no_storage_transaction',
-                    classification,
-                };
-            }
-            return resolveTxId(storageTransactionId);
-        }
-        default:
-            return {
-                status: 'unresolved',
-                reason: 'unknown_ref',
-                classification,
-            };
-    }
-}
-/**
- * Read a string field from a parsed item, trying camelCase and snake_case keys.
- */
-function getFeedItemStringField(item, key) {
-    const direct = coalesceStringField(item, key);
-    if (direct)
-        return direct;
-    const snake = key.replace(/[A-Z]/g, (l) => `_${l.toLowerCase()}`);
-    if (snake !== key) {
-        const alt = coalesceStringField(item, snake);
-        if (alt)
-            return alt;
-    }
-    const parts = key.split('_');
-    if (parts.length > 1) {
-        const camel = parts[0] + parts.slice(1).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join('');
-        const alt2 = coalesceStringField(item, camel);
-        if (alt2)
-            return alt2;
-    }
-    return '';
-}
-/**
- * Apply a field manifest to a plain feed item: classify media/file fields; pass through html/text.
- */
-function normalizeFeedItemFields(item, manifest) {
-    const out = {};
-    for (const [fieldKey, descriptor] of Object.entries(manifest)) {
-        const raw = getFeedItemStringField(item, fieldKey);
-        if (!raw) {
-            out[fieldKey] = undefined;
-            continue;
-        }
-        if (descriptor.role === 'html') {
-            out[fieldKey] = { role: 'html', raw };
-            continue;
-        }
-        if (descriptor.role === 'text') {
-            out[fieldKey] = { role: 'text', raw };
-            continue;
-        }
-        const classification = classifyMediaRef(raw, { treatAs: descriptor.treatAs });
-        out[fieldKey] = {
-            role: descriptor.role,
-            raw,
-            classification,
-        };
-    }
-    return out;
-}
-
-const getMetadata = async (props) => {
-    const appDb = BaseDb.getAppDb();
-    let storageTransactionId;
-    if (props) {
-        storageTransactionId = props.storageTransactionId;
-    }
-    const whereClauses = [];
-    if (storageTransactionId) {
-        whereClauses.push(eq(metadata.propertyName, 'storageTransactionId'));
-        whereClauses.push(eq(metadata.propertyValue, storageTransactionId));
-    }
-    const metadataRows = await appDb
-        .select()
-        .from(metadata)
-        .where(and(...whereClauses));
-    if (!metadataRows || metadataRows.length === 0) {
-        return;
-    }
-    return metadataRows[0];
-};
-
-const saveMetadata = async (metadataRecord, metadataValues) => {
-    if (!metadataRecord.localId) {
-        return;
-    }
-    const appDb = BaseDb.getAppDb();
-    await appDb
-        .update(metadata)
-        .set({
-        ...metadataValues,
-        updatedAt: Date.now(),
-    })
-        .where(eq(metadata.localId, metadataRecord.localId));
-};
-
-const isNode = () => {
-    return (typeof process !== 'undefined' &&
-        process.versions != null &&
-        process.versions.node != null);
-};
-const isBrowser = () => {
-    return !isElectron() && typeof document !== 'undefined' && typeof window !== 'undefined';
-};
-const isElectron = () => {
-    return typeof process !== 'undefined' && process.versions != null && process.versions.electron != null;
-};
-/**
- * Detects if code is running in an Electron renderer process.
- *
- * Uses multiple detection methods for robustness:
- * 1. Checks process.type === 'renderer' (most reliable)
- * 2. Falls back to checking if Electron is present and window/document exist
- *
- * @returns true if running in Electron renderer process, false otherwise
- */
-const isElectronRenderer = () => {
-    // Method 1: Check process.type (most reliable - official Electron API)
-    if (typeof process !== 'undefined' &&
-        process.type === 'renderer') {
-        return true;
-    }
-    // Method 2: Fallback - Electron + browser-like environment
-    // Renderer processes have window/document, main process doesn't (in modern Electron)
-    if (isElectron() &&
-        typeof window !== 'undefined' &&
-        typeof document !== 'undefined') {
-        return true;
-    }
-    return false;
-};
-/**
- * True where OPFS-backed Arweave file downloads should run: normal browsers and
- * Electron renderer. {@link isBrowser} is false for every Electron build (including renderer).
- */
-const supportsOpfsFileDownloads = () => {
-    return isBrowser() || isElectronRenderer();
-};
-
-/**
- * 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`.
- */
-const CONTENT_SHA256_TAG = 'Content-SHA-256';
-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.
- */
-const getContentSha256 = (data) => bytesToHex(sha256(data));
-/**
- * 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.
- */
-const contentSha256TagMatches = (data, tagValue) => {
-    const expected = tagValue.trim().toLowerCase();
-    if (!expected)
-        return false;
-    return getContentSha256(data) === expected || bytesToHex(sha3_256(data)) === expected;
-};
-/**
- * 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`).
- */
-const buildArweaveContentTags = (contentHash, contentType, extra) => {
-    const tags = [];
-    if (contentHash)
-        tags.push({ name: CONTENT_SHA256_TAG, value: contentHash });
-    if (contentType)
-        tags.push({ name: CONTENT_TYPE_TAG, value: contentType });
-    if (extra?.length)
-        tags.push(...extra);
-    return tags;
-};
-
-/** Subdirectory of the files root that holds a storage seed's file, by its data type. */
-const getStorageSubdirForDataType = (dataType) => {
-    switch (normalizeDataType(dataType ?? undefined)) {
-        case 'Image':
-            return 'images';
-        case 'Html':
-            return 'html';
-        case 'Json':
-            return 'json';
-        case 'File':
-        default:
-            // Unknown types are generic files; `images/` is only for what the SDK knows is an image.
-            return 'files';
-    }
-};
-/** Absolute directory for a storage seed's file (`images/`, `files/`, `html/` or `json/` under the files root). */
-const getStorageDirForDataType = (dataType) => BaseFileManager.getFilesPath(getStorageSubdirForDataType(dataType));
-/**
- * Subdirectory (relative to the files root, no leading slash) for an ItemStorage property's file:
- * its model's `storage.path` (`localStorageDir`), else `files`.
- */
-const getItemStorageSubdir = (localStorageDir) => (localStorageDir ?? '').replace(/^\/+/, '').replace(/\/+$/, '') || 'files';
-/**
- * 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.
- */
-const getItemStorageLocalFileName = (seedId, filenameSuffix) => `${seedId}${filenameSuffix ?? ''}`;
-
-/** Rows per query: well under SQLite's bound-parameter limit. */
-const CHUNK_SIZE = 400;
-/**
- * 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.
- */
-const getCompositeChildPaths = async (transactionIds) => {
-    const out = {};
-    const appDb = BaseDb.getAppDb();
-    if (!appDb || transactionIds.length === 0)
-        return out;
-    for (let i = 0; i < transactionIds.length; i += CHUNK_SIZE) {
-        const chunk = transactionIds.slice(i, i + CHUNK_SIZE);
-        const rows = await appDb
-            .select({
-            transactionId: metadata.propertyValue,
-            propertyName: metadata.propertyName,
-            refResolvedValue: metadata.refResolvedValue,
-            localStorageDir: metadata.localStorageDir,
-        })
-            .from(metadata)
-            .where(and(isNotNull(metadata.derivedFromUid), isNotNull(metadata.refResolvedValue), inArray(metadata.propertyValue, chunk)));
-        for (const row of rows) {
-            const { transactionId, propertyName, refResolvedValue } = row;
-            if (!transactionId || !propertyName || !refResolvedValue)
-                continue;
-            // A file name, never a path: anything else is not where the SDK would look.
-            if (refResolvedValue.includes('/') || refResolvedValue.includes('\\'))
-                continue;
-            const byName = (out[transactionId] ?? (out[transactionId] = {}));
-            byName[propertyName] ?? (byName[propertyName] = `${getItemStorageSubdir(row.localStorageDir)}/${refResolvedValue}`);
-        }
-    }
-    return out;
-};
-
-const logger$4 = debug('seedSdk:files:download');
-const AUTO_BULK_DOWNLOAD_THROTTLE_MS = 10000;
-/** Avoid refetch-on-every-call: transient empty indexer responses were overwriting good cache (see trailing throttle ~10s after success). */
-const GET_FILES_METADATA_STALE_MS = 120000;
-let bulkDownloadInFlight = null;
-const lazyDownloadInFlightByTransactionId = new Map();
-// syncDbFiles helper - internal service removed, functionality moved here
-const syncDbFiles = async (endpoints) => {
-    // TODO: Implement syncDbFiles functionality if needed
-    // This was previously in @/services/internal/helpers
-    logger$4('[download] syncDbFiles called but not yet implemented');
-    return Promise.resolve();
-};
-const getAppDbReady = async () => {
-    if (!BaseDb.isAppDbReady()) {
-        // Wait for ClientManager to be ready (DB_INIT state or later)
-        const _mod_0 = await import('./ClientManager-C-QXqUK9.js');
-        const _ns_0 = _mod_0.J;
-        const clientManagerMod = _ns_0;
-        const { getClient } = clientManagerMod;
-        const clientManager = getClient();
-        const clientService = clientManager.getService();
-        await waitFor(clientService, (snapshot) => {
-            const state = snapshot.value;
-            return state === 'dbInit' ||
-                state === 'saveConfig' ||
-                state === 'processSchemaFiles' ||
-                state === 'addModelsToStore' ||
-                state === 'addModelsToDb' ||
-                state === 'idle';
-        }, { timeout: 30000 });
-    }
-    return BaseDb.getAppDb();
-};
-const getExcludedTransactions = async () => {
-    const appDb = await getAppDbReady();
-    if (!appDb) {
-        return new Set();
-    }
-    const excludedTransactionsQuery = await appDb
-        .select()
-        .from(appState)
-        .where(eq(appState.key, 'excludedTransactions'));
-    const excludedTransactions = new Set();
-    if (excludedTransactionsQuery && excludedTransactionsQuery.length === 1) {
-        const valueString = excludedTransactionsQuery[0].value;
-        if (valueString) {
-            const excludedTransactionsArray = JSON.parse(valueString);
-            for (const txId of excludedTransactionsArray) {
-                excludedTransactions.add(txId);
-            }
-        }
-    }
-    return excludedTransactions;
-};
-/** Arweave transaction ids are 43 chars in the URL-safe base64 alphabet. */
-const ARWEAVE_TX_ID_RE$1 = /^[a-z0-9_-]{43}$/i;
-const normalizeArweaveTxId = (raw) => {
-    if (raw == null || raw === '')
-        return undefined;
-    const t = String(raw).trim();
-    if (ARWEAVE_TX_ID_RE$1.test(t))
-        return t;
-    const m = t.match(/^([a-z0-9_-]{43})(?:\.[^/]+)?$/i);
-    if (m)
-        return m[1];
-    // Values may be full gateway URLs or paths; scan for the embedded tx id.
-    const embedded = t.match(/[a-z0-9_-]{43}/gi);
-    if (embedded) {
-        for (const candidate of embedded) {
-            if (ARWEAVE_TX_ID_RE$1.test(candidate))
-                return candidate;
-        }
-    }
-    return undefined;
-};
-const mergeAddressLists = (a, b) => {
-    const seen = new Set();
-    const out = [];
-    for (const addr of [...(a ?? []), ...(b ?? [])]) {
-        if (!addr || !addr.trim())
-            continue;
-        const k = addr.toLowerCase();
-        if (seen.has(k))
-            continue;
-        seen.add(k);
-        out.push(addr);
-    }
-    return out;
-};
-const collectTransactionIdsFromLocalMetadata = async () => {
-    const appDb = await getAppDbReady();
-    if (!appDb) {
-        return [];
-    }
-    const nameOr = or(eq(metadata.propertyName, 'storageTransactionId'), eq(metadata.propertyName, 'storage_transaction_id'), eq(metadata.propertyName, 'transactionId'));
-    const propRows = await appDb
-        .select({ propertyValue: metadata.propertyValue })
-        .from(metadata)
-        .where(and(nameOr, isNotNull(metadata.propertyValue)));
-    const refRows = await appDb
-        .select({ refResolvedValue: metadata.refResolvedValue })
-        .from(metadata)
-        .where(isNotNull(metadata.refResolvedValue));
-    const ids = new Set();
-    for (const row of propRows) {
-        const id = normalizeArweaveTxId(row.propertyValue ?? undefined);
-        if (id)
-            ids.add(id);
-    }
-    for (const row of refRows) {
-        const id = normalizeArweaveTxId(row.refResolvedValue ?? undefined);
-        if (id)
-            ids.add(id);
-    }
-    return Array.from(ids);
-};
-const parseTransactionIdsFromMetadata = (filesMetadata, excludedTransactions) => {
-    const transactionIds = [];
-    for (const fileMetadata of filesMetadata) {
-        // Validate and parse decodedDataJson
-        if (!fileMetadata.decodedDataJson || fileMetadata.decodedDataJson.trim() === '') {
-            console.warn('[events/files] [download] empty decodedDataJson for fileMetadata: ', fileMetadata.id);
-            continue;
-        }
-        let json;
-        try {
-            json = JSON.parse(fileMetadata.decodedDataJson);
-        }
-        catch (error) {
-            console.warn('[events/files] [download] failed to parse decodedDataJson for fileMetadata: ', fileMetadata.id, error);
-            continue;
-        }
-        if (!Array.isArray(json) || json.length === 0 || !json[0]?.value?.value) {
-            console.warn('[events/files] [download] invalid decodedDataJson structure for fileMetadata: ', fileMetadata.id);
-            continue;
-        }
-        const rawTx = json[0].value.value;
-        if (typeof rawTx !== 'string' || rawTx.trim().length === 0) {
-            continue;
-        }
-        const transactionId = normalizeArweaveTxId(rawTx.trim());
-        if (!transactionId) {
-            continue;
-        }
-        if (excludedTransactions.has(transactionId) || excludedTransactions.has(rawTx.trim())) {
-            continue;
-        }
-        transactionIds.push(transactionId);
-    }
-    return transactionIds;
-};
-/** Content-SHA-256 tag values for the transactions that have one, from one batched tag lookup (cached). */
-const getExpectedContentHashes = async (transactionIds) => {
-    const queryClient = BaseQueryClient.getQueryClient();
-    const tagsById = new Map();
-    const toFetch = [];
-    for (const transactionId of transactionIds) {
-        // Tags never change once a transaction is indexed, so a cached lookup stays good.
-        const cached = queryClient.getQueryData?.(['getTransactionTags', transactionId]);
-        if (cached)
-            tagsById.set(transactionId, cached);
-        else
-            toFetch.push(transactionId);
-    }
-    if (toFetch.length > 0) {
-        try {
-            const fetched = await getTransactionTagsByIds(toFetch, {
-                client: BaseArweaveClient.getArweaveClient(),
-                onError: (error) => logger$4('[download] transaction tags lookup failed', error),
-            });
-            for (const [transactionId, tags] of fetched) {
-                tagsById.set(transactionId, tags);
-                // Seed the per-transaction cache entry (the client interface has no setQueryData).
-                void queryClient
-                    .fetchQuery({ queryKey: ['getTransactionTags', transactionId], queryFn: async () => tags })
-                    .catch(() => { });
-            }
-        }
-        catch (error) {
-            logger$4('[download] transaction tags lookup failed', error);
-        }
-    }
-    const out = {};
-    for (const [transactionId, tags] of tagsById) {
-        const value = tags.find((tag) => tag.name === CONTENT_SHA256_TAG)?.value?.trim();
-        if (value)
-            out[transactionId] = value;
-    }
-    return out;
-};
-/** Store the (now verified) Content-SHA-256 of each downloaded transaction on its metadata row. */
-const recordVerifiedContentHashes = async (transactionIds, expectedContentHashes) => {
-    for (const transactionId of transactionIds) {
-        const contentHash = expectedContentHashes[transactionId];
-        if (!contentHash)
-            continue;
-        try {
-            const metadataRecord = await getMetadata({ storageTransactionId: transactionId });
-            if (metadataRecord) {
-                await saveMetadata(metadataRecord, { contentHash });
-            }
-        }
-        catch (error) {
-            logger$4(error);
-        }
-    }
-};
-const downloadTransactionIds = async (rawTransactionIds, options) => {
-    if (!supportsOpfsFileDownloads()) {
-        return false;
-    }
-    const transactionIds = Array.from(new Set(rawTransactionIds.filter((tx) => !!tx && tx.trim().length > 0)));
-    if (transactionIds.length === 0) {
-        return false;
-    }
-    const excludedTransactions = await getExcludedTransactions();
-    await ensureReadGatewaySelected();
-    // Browser: do not call getTransactionStatus() — many gateways (e.g. g8way.io) redirect or omit
-    // CORS headers, so fetch() fails and we would wrongly exclude txs. The OPFS worker fetch decides success.
-    const transactionIdsToDownload = transactionIds.filter((id) => !excludedTransactions.has(id));
-    if (transactionIdsToDownload.length === 0) {
-        return false;
-    }
-    // One batched lookup for every upload's Content-SHA-256 tag; downloads are verified against it.
-    // Missing tags (old uploads, or a just-published one not indexed yet) just mean no verification.
-    const expectedContentHashes = await getExpectedContentHashes(transactionIdsToDownload);
-    // Preferred gateways first: a just-published item is only on the gateway it was uploaded through.
-    const arweaveBaseUrls = getArweaveReadBaseUrls();
-    // Where each ItemStorage child of a composite goes (the worker cannot read the DB or the schema).
-    const compositeChildPaths = await getCompositeChildPaths(transactionIdsToDownload).catch((error) => {
-        logger$4('[download] composite child paths lookup failed', error);
-        return {};
-    });
-    let result;
-    if (transactionIdsToDownload.length === 1) {
-        const transactionId = transactionIdsToDownload[0];
-        result = await BaseFileManager.downloadFileByTransactionId({
-            transactionId,
-            arweaveHost: BaseArweaveClient.getBaseUrl(),
-            arweaveBaseUrls,
-            excludedTransactions,
-            expectedContentHash: expectedContentHashes[transactionId],
-            compositeChildPaths: compositeChildPaths[transactionId],
-        });
-    }
-    else {
-        result = await BaseFileManager.downloadAllFiles({
-            transactionIds: transactionIdsToDownload,
-            arweaveHost: BaseArweaveClient.getBaseUrl(),
-            arweaveBaseUrls,
-            excludedTransactions,
-            expectedContentHashes,
-            compositeChildPaths,
-        });
-    }
-    if (result) {
-        for (const transactionId of result.hashMismatchTransactionIds) {
-            // Not saved by the worker; left for a later run (a gateway may serve the right bytes then).
-            logger$4(`[download] ${transactionId}: downloaded bytes do not match Content-SHA-256; skipped`);
-        }
-        await recordVerifiedContentHashes(result.verifiedTransactionIds, expectedContentHashes);
-    }
-    if (options?.resizeAllImages !== false) {
-        await BaseFileManager.resizeAllImages({
-            width: 480,
-            height: 480,
-        });
-    }
-    return true;
-};
-const runBulkDownloadWithDedupe = async (transactionIds) => {
-    if (bulkDownloadInFlight) {
-        return bulkDownloadInFlight;
-    }
-    bulkDownloadInFlight = (async () => {
-        try {
-            await downloadTransactionIds(transactionIds, { resizeAllImages: true });
-        }
-        finally {
-            bulkDownloadInFlight = null;
-        }
-    })();
-    return bulkDownloadInFlight;
-};
-const downloadAllFilesRequestHandler = async ({ endpoints, eventId, }) => {
-    if (!supportsOpfsFileDownloads()) {
-        return;
-    }
-    await syncDbFiles();
-    eventEmitter.emit('fs.downloadAll.success', { eventId });
-    eventEmitter.emit('fs.downloadAllBinary.request', { endpoints });
-};
-const downloadAllFilesBinaryRequestHandler = async (addressesHintOrPayload) => {
-    if (!supportsOpfsFileDownloads()) {
-        return;
-    }
-    const addressesHint = Array.isArray(addressesHintOrPayload)
-        ? addressesHintOrPayload
-        : undefined;
-    let fromDb = [];
-    if (BaseDb.isAppDbReady()) {
-        fromDb = await getAllAddressesFromDb();
-    }
-    if (!BaseDb.isAppDbReady()) {
-        await getAppDbReady();
-        fromDb = await getAllAddressesFromDb();
-    }
-    const addresses = mergeAddressLists(addressesHint, fromDb);
-    if (!addresses || addresses.length === 0) {
-        return;
-    }
-    const queryClient = BaseQueryClient.getQueryClient();
-    const easClient = BaseEasClient.getEasClient();
-    const filesMetadataQueryKey = ['getFilesMetadata', ...addresses];
-    const fetchFilesMetadata = () => easClient.request(GET_FILES_METADATA, {
-        where: {
-            attester: {
-                in: addresses,
-            },
-            schema: {
-                is: {
-                    id: {
-                        equals: '0x55fdefb36fcbbaebeb7d6b41dc3a1a9666e4e42154267c889de064faa7ede517',
-                    },
-                },
-            },
-        },
-    });
-    let { filesMetadata } = await queryClient.fetchQuery({
-        queryKey: filesMetadataQueryKey,
-        queryFn: fetchFilesMetadata,
-        staleTime: GET_FILES_METADATA_STALE_MS,
-    });
-    if ((!Array.isArray(filesMetadata) || filesMetadata.length === 0) && addresses.length > 0) {
-        await queryClient.removeQueries({ queryKey: filesMetadataQueryKey });
-        ({ filesMetadata } = await queryClient.fetchQuery({
-            queryKey: filesMetadataQueryKey,
-            queryFn: fetchFilesMetadata,
-            staleTime: GET_FILES_METADATA_STALE_MS,
-        }));
-    }
-    const filesRoot = BaseFileManager.getWorkingDir();
-    await BaseFileManager.createDirIfNotExists(filesRoot);
-    await BaseFileManager.createDirIfNotExists(BaseFileManager.getFilesPath('html'));
-    await BaseFileManager.createDirIfNotExists(BaseFileManager.getFilesPath('json'));
-    await BaseFileManager.createDirIfNotExists(BaseFileManager.getFilesPath('images'));
-    await BaseFileManager.createDirIfNotExists(BaseFileManager.getFilesPath('files'));
-    const excludedTransactions = await getExcludedTransactions();
-    const fromEas = parseTransactionIdsFromMetadata(filesMetadata ?? [], excludedTransactions);
-    const fromLocal = await collectTransactionIdsFromLocalMetadata();
-    const transactionIds = Array.from(new Set([...fromEas, ...fromLocal]));
-    await runBulkDownloadWithDedupe(transactionIds);
-};
-const downloadTransactionIdWithDedupe = async (transactionId) => {
-    if (!supportsOpfsFileDownloads() || !transactionId || transactionId.trim().length === 0) {
-        return false;
-    }
-    const normalizedTxId = normalizeArweaveTxId(transactionId) ?? transactionId.trim();
-    const existing = lazyDownloadInFlightByTransactionId.get(normalizedTxId);
-    if (existing) {
-        return existing;
-    }
-    const inFlight = (async () => {
-        try {
-            const ok = await downloadTransactionIds([normalizedTxId], { resizeAllImages: false });
-            return ok;
-        }
-        finally {
-            lazyDownloadInFlightByTransactionId.delete(normalizedTxId);
-        }
-    })();
-    lazyDownloadInFlightByTransactionId.set(normalizedTxId, inFlight);
-    return inFlight;
-};
-const scheduleBulkFilesDownloadFromEasSyncThrottled = throttle((addressesHint) => {
-    void downloadAllFilesBinaryRequestHandler(addressesHint).catch((error) => {
-        logger$4('[scheduleBulkFilesDownloadFromEasSync] failed', error);
-    });
-}, AUTO_BULK_DOWNLOAD_THROTTLE_MS, { leading: true, trailing: false });
-const scheduleBulkFilesDownloadFromEasSync = (addressesHint) => {
-    if (!supportsOpfsFileDownloads()) {
-        return;
-    }
-    scheduleBulkFilesDownloadFromEasSyncThrottled(addressesHint);
-};
-
-var download = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    downloadAllFilesBinaryRequestHandler: downloadAllFilesBinaryRequestHandler,
-    downloadAllFilesRequestHandler: downloadAllFilesRequestHandler,
-    downloadTransactionIdWithDedupe: downloadTransactionIdWithDedupe,
-    scheduleBulkFilesDownloadFromEasSync: scheduleBulkFilesDownloadFromEasSync
-});
-
-const logger$3 = debug('seedSdk:helpers:ensureImageLocal');
-/** Arweave transaction ids are 43 chars in the URL-safe base64 alphabet. */
-const ARWEAVE_TX_ID_RE = /^[a-z0-9_-]{43}$/i;
-const IMAGE_SIZES = [
-    ImageSize.EXTRA_SMALL,
-    ImageSize.SMALL,
-    ImageSize.MEDIUM,
-    ImageSize.LARGE,
-    ImageSize.EXTRA_LARGE,
-];
-const inFlightByKey = new Map();
-const normalizeArweaveTxIdForEnsure = (raw) => {
-    if (raw == null || raw === '')
-        return undefined;
-    const t = String(raw).trim();
-    if (ARWEAVE_TX_ID_RE.test(t))
-        return t;
-    const m = t.match(/^([a-z0-9_-]{43})(?:\.[^/]+)?$/i);
-    if (m)
-        return m[1];
-    const embedded = t.match(/[a-z0-9_-]{43}/gi);
-    if (embedded) {
-        for (const candidate of embedded) {
-            if (ARWEAVE_TX_ID_RE.test(candidate))
-                return candidate;
-        }
-    }
-    return undefined;
-};
-const closestImageSize = (width) => {
-    let best = ImageSize.EXTRA_SMALL;
-    let bestDist = Math.abs(best - width);
-    for (const size of IMAGE_SIZES) {
-        const dist = Math.abs(size - width);
-        if (dist < bestDist) {
-            best = size;
-            bestDist = dist;
-        }
-    }
-    return best;
-};
-const mapRequestedWidthsToImageSizes = (widths) => {
-    const requested = widths && widths.length > 0 ? widths : [ImageSize.EXTRA_SMALL];
-    const unique = new Set();
-    for (const w of requested) {
-        if (typeof w !== 'number' || !Number.isFinite(w) || w <= 0)
-            continue;
-        unique.add(closestImageSize(w));
-    }
-    if (unique.size === 0) {
-        unique.add(ImageSize.EXTRA_SMALL);
-    }
-    return Array.from(unique).sort((a, b) => a - b);
-};
-const getBasename = (filePath) => {
-    const path = BaseFileManager.getPathModule();
-    return path.basename(filePath);
-};
-const getBasenameWithoutExtension = (fileName) => {
-    const match = fileName.match(/^(.*[\/\\])?([^\/\\]+?)(\.[^.\/\\]*)?$/);
-    return match?.[2] ?? fileName;
-};
-const resolveMatchingImagePath = async (needle) => {
-    const dirPath = BaseFileManager.getFilesPath('images');
-    const dirExists = await BaseFileManager.pathExists(dirPath);
-    if (!dirExists)
-        return undefined;
-    const fs = await BaseFileManager.getFs();
-    const path = BaseFileManager.getPathModule();
-    const files = await fs.promises.readdir(dirPath);
-    // Prefer exact basename match (files only); skip size dirs.
-    const exact = files.find((file) => path.basename(file) === needle);
-    if (exact) {
-        const candidate = BaseFileManager.getFilesPath('images', exact);
-        try {
-            const zenfs = await BaseFileManager.getFs();
-            const stat = await zenfs.promises.stat(candidate);
-            if (stat.isFile())
-                return candidate;
-        }
-        catch {
-            // fall through
-        }
-    }
-    const matchingFiles = files.filter((file) => {
-        const base = path.basename(file);
-        return base.includes(needle);
-    });
-    for (const file of matchingFiles) {
-        const candidate = BaseFileManager.getFilesPath('images', file);
-        try {
-            const zenfs = await BaseFileManager.getFs();
-            const stat = await zenfs.promises.stat(candidate);
-            if (stat.isFile())
-                return candidate;
-        }
-        catch {
-            continue;
-        }
-    }
-    return undefined;
-};
-const sizedVariantPath = (originalFilePath, size) => {
-    const path = BaseFileManager.getPathModule();
-    const dir = path.dirname(originalFilePath);
-    const base = getBasenameWithoutExtension(getBasename(originalFilePath));
-    return path.join(dir, String(size), `${base}.webp`);
-};
-const ensureKey = (txId, fileName, sizes) => {
-    const idPart = txId ?? fileName ?? '';
-    return `${idPart}|${sizes.join(',')}`;
-};
-const runEnsureImageLocal = async (params) => {
-    if (!supportsOpfsFileDownloads()) {
-        return { status: 'unsupported' };
-    }
-    const fileName = params.fileName?.trim() || undefined;
-    const txId = normalizeArweaveTxIdForEnsure(params.transactionId) ??
-        normalizeArweaveTxIdForEnsure(fileName);
-    if (!txId && !fileName) {
-        return { status: 'missing-id' };
-    }
-    const targetSizes = mapRequestedWidthsToImageSizes(params.widths);
-    const needles = [fileName, txId].filter((n) => typeof n === 'string' && n.length > 0);
-    try {
-        let filePath;
-        for (const needle of needles) {
-            filePath = await resolveMatchingImagePath(needle);
-            if (filePath)
-                break;
-        }
-        if (!filePath && txId) {
-            await downloadTransactionIdWithDedupe(txId);
-            for (const needle of needles) {
-                filePath = await resolveMatchingImagePath(needle);
-                if (filePath)
-                    break;
-            }
-            // Downloads store as bare tx id
-            if (!filePath) {
-                const direct = BaseFileManager.getFilesPath('images', txId);
-                if (await BaseFileManager.pathExists(direct)) {
-                    filePath = direct;
-                }
-            }
-        }
-        if (!filePath) {
-            return { status: 'failed' };
-        }
-        const createdWidths = [];
-        for (const size of targetSizes) {
-            const variantPath = sizedVariantPath(filePath, size);
-            const exists = await BaseFileManager.pathExists(variantPath);
-            if (exists)
-                continue;
-            await BaseFileManager.resizeImage({
-                filePath,
-                width: size,
-                height: size,
-            });
-            createdWidths.push(size);
-        }
-        return {
-            status: 'ready',
-            filePath,
-            createdWidths,
-        };
-    }
-    catch (error) {
-        logger$3('ensureImageLocal failed', error);
-        return { status: 'failed' };
-    }
-};
-/**
- * Ensure an image original exists in OPFS (downloading from Arweave if needed)
- * and create only the requested ImageSize variant(s) for that one file.
- */
-const ensureImageLocal = async (params) => {
-    if (!supportsOpfsFileDownloads()) {
-        return { status: 'unsupported' };
-    }
-    const fileName = params.fileName?.trim() || undefined;
-    const txId = normalizeArweaveTxIdForEnsure(params.transactionId) ??
-        normalizeArweaveTxIdForEnsure(fileName);
-    if (!txId && !fileName) {
-        return { status: 'missing-id' };
-    }
-    const targetSizes = mapRequestedWidthsToImageSizes(params.widths);
-    const key = ensureKey(txId, fileName, targetSizes);
-    const existing = inFlightByKey.get(key);
-    if (existing) {
-        return existing;
-    }
-    const inFlight = (async () => {
-        try {
-            return await runEnsureImageLocal({
-                transactionId: txId,
-                fileName,
-                widths: targetSizes,
-            });
-        }
-        finally {
-            inFlightByKey.delete(key);
-        }
-    })();
-    inFlightByKey.set(key, inFlight);
-    return inFlight;
-};
-
-const randomId = customAlphabet(alphanumeric, 10);
-/**
- * A 10-character local id. Never starts with "0x" (about 1 in 3,844 random ids would), so code that
- * tells local ids from EAS uids by that prefix can't mistake one for the other.
- */
-const generateId = () => {
-    let id = randomId();
-    while (id.startsWith('0x'))
-        id = randomId();
-    return id;
-};
-
-var generateId$1 = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    generateId: generateId
-});
-
-const logger$2 = debug('seedSdk:shared:helpers');
-const toSnakeCase = (str) => {
-    return str.replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();
-};
-const getMimeType = (base64) => {
-    if (!base64) {
-        return null;
-    }
-    const result = base64.match(/^data:([a-zA-Z0-9]+\/[a-zA-Z0-9-.+]+).*,/);
-    if (result && result.length > 1) {
-        return result[1];
-    }
-    else {
-        return null; // MIME type could not be determined
-    }
-};
-const getCorrectId = (localIdOrUid) => {
-    const id = {
-        localId: undefined,
-        uid: undefined,
-    };
-    if (!localIdOrUid) {
-        return id;
-    }
-    if (localIdOrUid.length === 10) {
-        id.localId = localIdOrUid;
-    }
-    if (localIdOrUid.startsWith('0x') && localIdOrUid.length === 66) {
-        id.uid = localIdOrUid;
-    }
-    return id;
-};
-const getDataTypeFromString = (data) => {
-    const nonImageBase64Regex = /^(?!data:image\/(?:jpeg|png|gif|bmp|webp);base64,)[A-Za-z0-9+/=]+$/;
-    if (nonImageBase64Regex.test(data)) {
-        return 'base64';
-    }
-    // Regular expression for base64 (simple version, checking for base64 format)
-    const imageBase64Regex = /^data:image\/[a-zA-Z]+;base64,[A-Za-z0-9+/]+={0,2}$/;
-    if (imageBase64Regex.test(data)) {
-        return 'imageBase64';
-    }
-    // Blob URLs are fetchable but session-scoped; recognize them as url type
-    if (data.startsWith('blob:')) {
-        return 'url';
-    }
-    // Regular expression for URL (simple version, checking for common URL format)
-    const urlRegex = /^(http:\/\/www\.|https:\/\/www\.|http:\/\/|https:\/\/)?[a-z0-9]+([\-\.]{1}[a-z0-9]+)*\.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$/;
-    if (urlRegex.test(data)) {
-        return 'url';
-    }
-    return null;
-};
-const convertTxIdToImage = async (txId) => {
-    const imageFilePath = BaseFileManager.getFilesPath('images', txId);
-    const fileExists = await BaseFileManager.pathExists(imageFilePath);
-    if (!fileExists) {
-        logger$2(`[ItemView] [updateImage] ${imageFilePath} does not exist`);
-        return;
-    }
-    const buffer = await BaseFileManager.readFileAsBuffer(imageFilePath);
-    // Convert Blob to ArrayBuffer if needed, or use Buffer directly
-    let arrayBuffer;
-    if (buffer instanceof Blob) {
-        arrayBuffer = await buffer.arrayBuffer();
-    }
-    else if (buffer instanceof ArrayBuffer) {
-        arrayBuffer = buffer;
-    }
-    else {
-        // Node.js Buffer
-        const sliced = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-        // Handle SharedArrayBuffer case by creating a new ArrayBuffer
-        if (sliced instanceof SharedArrayBuffer) {
-            const uint8Array = new Uint8Array(sliced);
-            arrayBuffer = uint8Array.buffer.slice(0);
-        }
-        else {
-            arrayBuffer = sliced;
-        }
-    }
-    const uint = new Uint8Array(arrayBuffer);
-    const imageBlob = new Blob([uint]);
-    return URL.createObjectURL(imageBlob);
-};
-/**
- * Constructs an Arweave URL for a storage transaction ID
- * @param storageTransactionId - The Arweave transaction ID
- * @returns The full URL to access the transaction data on Arweave (e.g., https://arweave.net/raw/{transactionId})
- * @deprecated Use BaseArweaveClient.getRawUrl() instead for better consistency and testability
- */
-const getArweaveUrlForTransaction = (storageTransactionId) => {
-    return BaseArweaveClient.getRawUrl(storageTransactionId);
-};
-
-/** Emitted by the client manager after `app_state.addresses` is written (post-`setAddresses`). */
-const ADDRESSES_PERSISTED_EVENT = 'addresses.persisted';
-/** Emitted after hard-deleting local on-chain seed copies for publisher addresses. */
-const LOCAL_COPIES_REMOVED_EVENT = 'localCopies.removed';
-function parseAddressesPersistedPayload(value) {
-    if (!value || typeof value !== 'object') {
-        return { owned: [], watched: [] };
-    }
-    const v = value;
-    const owned = Array.isArray(v.owned)
-        ? v.owned.filter((a) => typeof a === 'string')
-        : [];
-    const watched = Array.isArray(v.watched)
-        ? v.watched.filter((a) => typeof a === 'string')
-        : [];
-    return { owned, watched };
-}
-
-/**
- * Cross-tab exclusive sections, using the Web Locks API. All tabs of an origin share one SQLite
- * database and OPFS tree; the browser releases a tab's locks when it closes or crashes, so a lock
- * can't go stale. See docs/MULTI_TAB.md.
- *
- * Node has Web Locks from 24.5, scoped to the process. Where they're missing (older Node, old
- * browsers), sections still run one at a time within this JS realm (see `withProcessLock`), which
- * covers a single Node process but not other tabs or worker threads.
- * Not re-entrant: requesting a name the caller already holds waits forever, so take each lock
- * only at the outermost call site.
- */
-/** Long enough for a slow init in another tab; short enough that a hung tab doesn't block forever. */
-const TAB_LOCK_WAIT_TIMEOUT_MS = 60000;
-function seedDbLockName(scope, filesDir) {
-    return `seed:${scope}:${filesDir}/db/seed.db`;
-}
-/** `withTabLock` on the database under `filesDir`; runs `fn` directly when there's no `filesDir` yet. */
-function withSeedDbLock(scope, filesDir, fn) {
-    return filesDir ? withTabLock(seedDbLockName(scope, filesDir), fn) : fn();
-}
-class TabLockTimeoutError extends Error {
-    constructor(lockName, timeoutMs) {
-        super(`Timed out after ${timeoutMs}ms waiting for another tab to release "${lockName}".`);
-        this.lockName = lockName;
-        this.code = 'TAB_LOCK_TIMEOUT';
-        this.name = 'TabLockTimeoutError';
-    }
-}
-async function withTabLock(name, fn, { timeoutMs = TAB_LOCK_WAIT_TIMEOUT_MS } = {}) {
-    const locks = typeof navigator !== 'undefined' ? navigator.locks : undefined;
-    if (!locks)
-        return withProcessLock(name, fn, { timeoutMs });
-    try {
-        // The timeout bounds the wait only; once granted, fn runs to completion. Infinity waits for as
-        // long as the holder runs (it can't outlive its tab).
-        const signal = Number.isFinite(timeoutMs) ? AbortSignal.timeout(timeoutMs) : undefined;
-        return await locks.request(name, { mode: 'exclusive', signal }, fn);
-    }
-    catch (error) {
-        if (error?.name === 'TimeoutError') {
-            throw new TabLockTimeoutError(name, timeoutMs);
-        }
-        throw error;
-    }
-}
-/** Tail of each name's queue: resolves once every section queued so far has finished or given up. */
-const processLockTails = new Map();
-/**
- * The `withTabLock` fallback without Web Locks: an exclusive, first-come-first-served lock per name
- * within this JS realm. Like Web Locks, `timeoutMs` bounds the wait only, and a waiter that times
- * out doesn't let later waiters in before the current holder finishes.
- */
-async function withProcessLock(name, fn, { timeoutMs = TAB_LOCK_WAIT_TIMEOUT_MS } = {}) {
-    const previous = processLockTails.get(name) ?? Promise.resolve();
-    let release;
-    const done = new Promise((resolve) => (release = resolve));
-    const tail = previous.then(() => done);
-    processLockTails.set(name, tail);
-    void tail.then(() => {
-        if (processLockTails.get(name) === tail)
-            processLockTails.delete(name);
-    });
-    try {
-        await waitForTurn(previous, name, timeoutMs);
-    }
-    catch (error) {
-        release();
-        throw error;
-    }
-    try {
-        return await fn();
-    }
-    finally {
-        release();
-    }
-}
-function waitForTurn(previous, name, timeoutMs) {
-    if (!Number.isFinite(timeoutMs))
-        return previous;
-    let timer;
-    const timedOut = new Promise((_, reject) => {
-        timer = setTimeout(() => reject(new TabLockTimeoutError(name, timeoutMs)), timeoutMs);
-    });
-    return Promise.race([previous, timedOut]).finally(() => clearTimeout(timer));
-}
-
-const logger$1 = debug('seedSdk:helpers:tabCoordinator');
-/** Identifies this tab (this page's SDK instance) in the messages it sends. */
-const TAB_ID = typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
-    ? crypto.randomUUID()
-    : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
-let state;
-let leader = false;
-let leaderWaiters = [];
-const messageHandlers = new Set();
-/** Starts once per page; later calls (re-init) keep the first database. */
-function startTabCoordination({ filesDir, mode = 'coordinate' }) {
-    if (state)
-        return;
-    const locks = typeof navigator !== 'undefined' ? navigator.locks : undefined;
-    const dbKey = `${filesDir}/db/seed.db`;
-    const coordinating = mode === 'coordinate' && isBrowser() && !!locks && typeof BroadcastChannel !== 'undefined';
-    state = { dbKey, coordinating };
-    if (!coordinating) {
-        becomeLeader();
-        return;
-    }
-    const channel = new BroadcastChannel(`seed:tabs:${dbKey}`);
-    channel.onmessage = (event) => {
-        // A BroadcastChannel never hears itself, but another channel object in this page would (a
-        // second channel opened by a test, or the same module loaded twice): skip our own messages.
-        if (event.data?.from === TAB_ID)
-            return;
-        for (const handler of messageHandlers)
-            handler(event.data);
-    };
-    state.channel = channel;
-    const current = state;
-    void locks.request(`seed:leader:${dbKey}`, () => {
-        // Reset (tests) before the grant: hand the lock straight back.
-        if (state !== current)
-            return undefined;
-        becomeLeader();
-        // Held until the tab closes (or a test resets coordination).
-        return new Promise((release) => {
-            current.releaseLeadership = release;
-        });
-    });
-}
-function becomeLeader() {
-    if (leader)
-        return;
-    leader = true;
-    logger$1(`this tab leads ${state?.dbKey}`);
-    const waiters = leaderWaiters;
-    leaderWaiters = [];
-    for (const resolve of waiters)
-        resolve();
-}
-function isLeaderTab() {
-    return !state || leader;
-}
-/** Resolves when this tab leads (at once if it already does). */
-function whenLeaderTab() {
-    if (isLeaderTab())
-        return Promise.resolve();
-    return new Promise((resolve) => leaderWaiters.push(resolve));
-}
-/** Sends to the other tabs of this database; a no-op when not coordinating. */
-function postTabMessage(message) {
-    state?.channel?.postMessage({ ...message, from: TAB_ID });
-}
-/** Whether postTabMessage reaches other tabs (a browser tab coordinating with Web Locks). */
-function isPostingTabMessages() {
-    return !!state?.channel;
-}
-function onTabMessage(handler) {
-    messageHandlers.add(handler);
-    return () => messageHandlers.delete(handler);
-}
-/** `withTabLock` named for this database (`seed:<scope>:<db>`); runs `fn` directly before init. */
-function withDbTabLock(scope, fn, options) {
-    return state ? withTabLock(`seed:${scope}:${state.dbKey}`, fn, options) : fn();
-}
-
-const logger = debug('seedSdk:helpers:tabEvents');
-/**
- * Keeps other tabs current (docs/MULTI_TAB.md). The event bus is per tab, so events that mean "the
- * shared database or OPFS changed" are also posted to the other tabs, which refresh their caches
- * and emit the same event locally. Events are posted only where they originate, so a relayed event
- * is never relayed again.
- */
-/** Emitted with the changed paths when files change outside this tab's file-system cache. */
-const FILES_CHANGED_EVENT = 'fs.files.changed';
-/** Emits on this tab's event bus and in every other tab of this database. */
-function emitAcrossTabs(name, payload) {
-    if (payload === undefined) {
-        eventEmitter.emit(name);
-    }
-    else {
-        eventEmitter.emit(name, payload);
-    }
-    postTabMessage({ type: 'event', name, payload });
-}
-/**
- * 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.
- */
-function notifyFileSaved(filePath) {
-    eventEmitter.emit('file-saved', filePath);
-}
-/**
- * Files written straight to OPFS by a worker: refreshes this tab's file-system cache, emits
- * FILES_CHANGED_EVENT, and tells other tabs to do the same.
- */
-async function notifyFilesWrittenOutsideCache(paths) {
-    if (paths.length === 0)
-        return;
-    await BaseFileManager.invalidateCachedPaths(paths);
-    eventEmitter.emit(FILES_CHANGED_EVENT, paths);
-    queueFilesChangedNotice(paths);
-}
-/**
- * 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.
- */
-const FILES_CHANGED_FLUSH_MS = 25;
-/** Keeps a message for a huge batch (a bulk download) from being one giant structured clone. */
-const FILES_CHANGED_MAX_PATHS = 500;
-let pendingChangedPaths = new Set();
-let flushTimer;
-let flushOnPageHide = false;
-/**
- * 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.
- */
-function queueFilesChangedNotice(paths) {
-    if (!isPostingTabMessages())
-        return;
-    for (const path of paths)
-        pendingChangedPaths.add(path);
-    if (flushTimer !== undefined || pendingChangedPaths.size === 0)
-        return;
-    flushTimer = setTimeout(flushFilesChangedNotices, FILES_CHANGED_FLUSH_MS);
-    if (!flushOnPageHide && typeof addEventListener === 'function') {
-        flushOnPageHide = true;
-        // A tab closing inside the window still sends what it wrote.
-        addEventListener('pagehide', flushFilesChangedNotices);
-    }
-}
-/** Sends the queued paths now (page hide, tests). */
-function flushFilesChangedNotices() {
-    if (flushTimer !== undefined)
-        clearTimeout(flushTimer);
-    flushTimer = undefined;
-    if (pendingChangedPaths.size === 0)
-        return;
-    const paths = [...pendingChangedPaths];
-    pendingChangedPaths = new Set();
-    for (let i = 0; i < paths.length; i += FILES_CHANGED_MAX_PATHS) {
-        postTabMessage({ type: 'files-changed', paths: paths.slice(i, i + FILES_CHANGED_MAX_PATHS) });
-    }
-}
-/** Refreshes this tab's in-memory state for an event another tab emitted, before re-emitting it. */
-async function catchUpOn(name, payload) {
-    if (name === EAS_SEED_DATA_SYNCED_TO_DB_EVENT) {
-        const _mod_1 = await import('./Item-C7sUUu2B.js');
-        const _ns_1 = _mod_1.a2;
-        const { Item } = _ns_1;
-        await Item.rehydrateCachedItemsFromDbAfterEasSync();
-    }
-    else if (name === LOCAL_COPIES_REMOVED_EVENT) {
-        const { removedSeedLocalIds = [], removedSeedUids = [] } = (payload ?? {});
-        const _mod_2 = await import('./Item-C7sUUu2B.js');
-        const _ns_2 = _mod_2.a2;
-        const { Item } = _ns_2;
-        Item.dropCachedInstancesForSeedIds([...removedSeedLocalIds, ...removedSeedUids]);
-    }
-}
-const RELAYED_EVENTS = new Set([
-    EAS_SEED_DATA_SYNCED_TO_DB_EVENT,
-    ADDRESSES_PERSISTED_EVENT,
-    LOCAL_COPIES_REMOVED_EVENT,
-]);
-let listening = false;
-/** Applies other tabs' events and file changes in this tab. */
-function listenForOtherTabsEvents() {
-    if (listening)
-        return;
-    listening = true;
-    onTabMessage((message) => {
-        if (message.type === 'event' && RELAYED_EVENTS.has(message.name)) {
-            void catchUpOn(message.name, message.payload)
-                .catch((error) => logger(`catching up on ${message.name} failed`, error))
-                .then(() => {
-                if (message.payload === undefined) {
-                    eventEmitter.emit(message.name);
-                }
-                else {
-                    eventEmitter.emit(message.name, message.payload);
-                }
-            });
-        }
-        else if (message.type === 'files-changed') {
-            // Only refreshes caches: never writes, so never sends files-changed back.
-            void BaseFileManager.invalidateCachedPaths(message.paths)
-                .catch((error) => logger('refreshing changed files failed', error))
-                .then(() => eventEmitter.emit(FILES_CHANGED_EVENT, message.paths));
-        }
-    });
-}
-
-var tabEvents = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    FILES_CHANGED_EVENT: FILES_CHANGED_EVENT,
-    FILES_CHANGED_FLUSH_MS: FILES_CHANGED_FLUSH_MS,
-    FILES_CHANGED_MAX_PATHS: FILES_CHANGED_MAX_PATHS,
-    emitAcrossTabs: emitAcrossTabs,
-    flushFilesChangedNotices: flushFilesChangedNotices,
-    listenForOtherTabsEvents: listenForOtherTabsEvents,
-    notifyFileSaved: notifyFileSaved,
-    notifyFilesWrittenOutsideCache: notifyFilesWrittenOutsideCache,
-    queueFilesChangedNotice: queueFilesChangedNotice
-});
-
-export { ADDRESSES_PERSISTED_EVENT as A, whenLeaderTab as B, CONTENT_SHA256_TAG as C, withDbTabLock as D, notifyFilesWrittenOutsideCache as E, FILES_CHANGED_EVENT as F, withSeedDbLock as G, postTabMessage as H, onTabMessage as I, listenForOtherTabsEvents as J, isNode as K, LOCAL_COPIES_REMOVED_EVENT as L, isBrowser as M, startTabCoordination as N, downloadAllFilesRequestHandler as O, downloadAllFilesBinaryRequestHandler as P, getStorageTransactionIdForSeedUid as Q, convertTxIdToImage as R, downloadTransactionIdWithDedupe as S, TabLockTimeoutError as T, getDataTypeFromString as U, getMimeType as V, notifyFileSaved as W, withTabLock as X, download as Y, generateId$1 as Z, tabEvents as _, getItemStorageSubdir as a, buildArweaveContentTags as b, getItemStorageLocalFileName as c, getContentSha256 as d, getCorrectId as e, isStorageSeedRef as f, getStorageDirForDataType as g, emitAcrossTabs as h, isPublishedSeedRef as i, generateId as j, getArweaveUrlForTransaction as k, CONTENT_TYPE_TAG as l, classifyMediaRef as m, normalizeRelationPropertyValue as n, closestImageSize as o, contentSha256TagMatches as p, ensureImageLocal as q, resolveSeedIdsFromRefString as r, scheduleBulkFilesDownloadFromEasSync as s, toSnakeCase as t, getFeedItemStringField as u, isLeaderTab as v, normalizeArweaveTxIdForEnsure as w, normalizeFeedItemFields as x, parseAddressesPersistedPayload as y, resolveMediaRef as z };
-//# sourceMappingURL=tabEvents-DguZpCCv.js.map