@anzusystems/common-admin 2.0.0-rc.4 → 2.0.0-rc.6

package/dist/domains/dam/uploadQueue/settlement/uploadSettlement.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadSettlement.js","names":["TICK_INTENT","createUploadSettlement","memory","createUploadSettleMemory","pollers","pending","unsubscribe","disposed","generations","lanes","laneOf","key","profile","configName","lane","laneOfQueue","queueKey","laneOfTarget","target","failureReported","error","scheduler","uploadSettlementRuntime","isDisposed","generationOf","trackedRows","tracked","queue","row","state","toRaw","UploadQueueItemStatus","isNull","youngestAgeMs","now","youngest","age","settle","createUploadSettle","enqueueRead","result","run","fetchCaches","namesOfQueue","countMiss","missesOfLeft","countsMissesOfLeft","countMissOfLeft","raw","misses","concernedRows","all","targets","intent","anyRowMatches","purpose","readSucceeded","rows","untold","readUnitsOf","byLicence","bySlotAsset","reader","byAsset","units","licenceId","assetIds","asset","options","from","batch","assetId","assets","slotRows","slotFiles","applyAssets","goesOn","startedAt","present","unit","applySlotFile","file","candidate","configNames","AssetFileProcessStatus","scheduleNamed","applySlotFiles","readQueue","generation","answers","index","failed","reportedFailure","answer","told","report","notice","mergeTarget","fileId","known","read","armNamed","delay","fireNamed","releaseWaiters","waiters","resolve","names","scheduleRead","delayMs","name","isUndefined","waiting","readNamed","retryNamed","UPLOAD_POLL_ERROR_LADDER_MS","attempt","warnAboutRead","namesOfRead","rowsOfRead","askedFor","left","exhausted","warned","entry","concerned","untracked","OUTCOME_ORDER","readTargetNow","readOneNow","one","outcomes","outcome","givenUp","askedOn","leftWithout","isFinalFileStatus","refreshAsset","settleKnownProcessed","settleKnownFailed","failReason","settleKnownDuplicate","originFileId","assetType","notify","event","UPLOAD_NOTIFY_METADATA_DELAY_MS","AssetFileFailReason","subscribe","visible","poller","unsubscribeAll","stop","pollerOf","createQueuePoller","queueOf","track","item","cancelUnneeded","leaving"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadSettlement.ts"],"sourcesContent":["import { toRaw } from 'vue'\nimport type { DocId, DocIdNullable, IntegerId } from '@/shared/types/common'\nimport type { AssetDetailItemDto, DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport {\n  AssetFileFailReason,\n  type AssetFileFailReasonType,\n  type AssetFileNullable,\n  AssetFileProcessStatus,\n} from '@/domains/dam/types/AssetFile'\nimport {\n  type UploadQueue,\n  type UploadQueueItem,\n  UploadQueueItemStatus,\n  type UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport { createQueuePoller, type QueuePoller } from '@/domains/dam/uploadQueue/settlement/uploadPoller'\nimport {\n  UPLOAD_NOTIFY_FILE_DELAY_MS,\n  UPLOAD_NOTIFY_METADATA_DELAY_MS,\n  UPLOAD_POLL_ERROR_LADDER_MS,\n  UPLOAD_POLL_MISSING_LIMIT,\n  UPLOAD_POLL_READ_FAILURE_LIMIT,\n  UPLOAD_POLL_SLOW_TEXT_AFTER_MS,\n  UPLOAD_READ_BATCH_LIMIT,\n} from '@/domains/dam/uploadQueue/settlement/uploadPollSchedule'\nimport {\n  createUploadSettle,\n  createUploadSettleMemory,\n  isFinalFileStatus,\n  type UploadReadIntent,\n  type UploadTrackState,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettle'\nimport { uploadSettlementRuntime } from '@/domains/dam/uploadQueue/settlement/uploadSettlementRuntime'\nimport type {\n  UploadReadOptions,\n  UploadRefreshOutcome,\n  UploadSettlement,\n  UploadSettlementEvent,\n  UploadSettlementProfile,\n  UploadSettlementTarget,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport { isNull, isUndefined } from '@/shared/utils/common'\n\ninterface TrackedRow {\n  queueKey: UploadQueueKey\n  queue: UploadQueue\n  row: UploadQueueItem\n  state: UploadTrackState\n  /** The asset the row is read by. A duplicate that becomes its original changes the one of the row. */\n  assetId: DocId\n}\n\n/** One request of a tick, and the tracked rows it asks about. */\ninterface ReadUnit {\n  rows: TrackedRow[]\n  /** `missing`: the one asset that was asked for by itself does not exist, which its reader was free to report. */\n  read(\n    options: UploadReadOptions\n  ): Promise<{ assets: AssetDetailItemDto[]; missing?: boolean } | { slotFiles: AssetFileNullable[] }>\n}\n\n/** The reads of one DAM, one after another, and whether a streak of their failures is being reported. */\ninterface ReadLane {\n  chain: Promise<void>\n  failing: boolean\n}\n\n/** A read of one asset an event asked for, waiting for its time. */\ninterface PendingNamedRead {\n  /** Of `pending`: the asset, and the configuration the read is for. */\n  key: string\n  assetId: DocId\n  /** The configuration whose rows the read is for (`configOf` of the profile); every queue's when left out. */\n  configName?: string\n  // By `fileId ?? ''`.\n  targets: Map<string, { fileId: DocIdNullable; intent: UploadReadIntent }>\n  dueAt: number\n  /** Failed tries in a row. */\n  failures: number\n  /** Tries in a row that found no asset. */\n  misses: number\n  /** A failure of its tries was written down: the next ones are not reported. */\n  told: boolean\n  timer: { handle: unknown } | null\n  waiters: Array<() => void>\n}\n\nconst TICK_INTENT: UploadReadIntent = { hint: null, metadata: true, early: false, seen: true }\n\n/**\n * The settlement of the rows of one store: which rows wait for the server, one coordinator of all the reads, and\n * what starts a read: the tick of a queue, a notification, the refresh of a row.\n */\nexport function createUploadSettlement(profile: UploadSettlementProfile): UploadSettlement {\n  const memory = createUploadSettleMemory()\n  const pollers = new Map<UploadQueueKey, QueuePoller>()\n  // One read of an asset waits at a time, and with the configurations of the queues one for each configuration.\n  const pending = new Map<string, PendingNamedRead>()\n  let unsubscribe: Array<() => void> = []\n  let disposed = false\n  // Raised when a queue is dropped: a tick that waited for its turn meanwhile is not for the queue that has the\n  // key now.\n  const generations = new Map<UploadQueueKey, number>()\n  // The poll and the notifications ask for as long as a row waits, and a reader is to report only the first of\n  // their requests that fails and is written down: `failing` of the lane from such a failure until a read answers,\n  // and beside it the `reported` of each tracked row, until a read brings its asset. A failure that was not written\n  // down (a timeout, 401, 403, as the readers say) has told nobody, and begins nothing.\n  // One read at a time in a lane: its reads have one order, and a later one never overtakes. With the configurations\n  // of the queues (`configOf`) a lane for each configuration, and one for the reads that name none: a slow DAM holds\n  // back no read of another, and the failures of each are a streak of their own. Without them, one lane for the\n  // whole store, as ever.\n  const lanes = new Map<string | undefined, ReadLane>()\n  const laneOf = (configName?: string) => {\n    const key = profile.configOf ? configName : undefined\n    let lane = lanes.get(key)\n    if (!lane) {\n      lane = { chain: Promise.resolve(), failing: false }\n      lanes.set(key, lane)\n    }\n    return lane\n  }\n  /** The lane of the reads of the queue. */\n  const laneOfQueue = (queueKey: UploadQueueKey) => laneOf(profile.configOf?.(queueKey))\n  /** The lane of the reads of a target: of the one configuration it names. */\n  const laneOfTarget = (target: UploadSettlementTarget) =>\n    laneOf(target.configNames?.length === 1 ? target.configNames[0] : undefined)\n  const failureReported = (error: unknown) => profile.readers.failureReported?.(error) ?? true\n\n  const scheduler = () => uploadSettlementRuntime.scheduler\n  // Asked anew after every wait: nothing is written, called or planned for a settlement that was disposed of.\n  const isDisposed = () => disposed\n  const generationOf = (queueKey: UploadQueueKey) => generations.get(queueKey) ?? 0\n\n  const trackedRows = (queueKey?: UploadQueueKey): TrackedRow[] => {\n    const tracked: TrackedRow[] = []\n    for (const [key, queue] of profile.queues()) {\n      if (queueKey !== undefined && key !== queueKey) continue\n      for (const row of queue.items) {\n        const state = memory.tracked.get(toRaw(row))\n        if (!state || state.queueKey !== key) continue\n        if (row.status === UploadQueueItemStatus.Stop || isNull(row.assetId)) continue\n        tracked.push({ queueKey: key, queue, row, state, assetId: row.assetId })\n      }\n    }\n    return tracked\n  }\n\n  const youngestAgeMs = (queueKey: UploadQueueKey) => {\n    const now = scheduler().now()\n    let youngest: number | null = null\n    for (const { state } of trackedRows(queueKey)) {\n      const age = now - state.eligibleSince\n      if (youngest === null || age < youngest) youngest = age\n    }\n    return youngest\n  }\n\n  const settle = createUploadSettle(profile, memory, {\n    // A queue that tracks nothing any more holds no timer.\n    onUntrack: (queueKey) => {\n      if (youngestAgeMs(queueKey) === null) pollers.get(queueKey)?.reschedule()\n    },\n    isDisposed,\n  })\n\n  const enqueueRead = <T>(lane: ReadLane, run: (startedAt: number) => Promise<T>): Promise<T> => {\n    const result = lane.chain.then(() => run(settle.startRead()))\n    lane.chain = result.then(\n      () => undefined,\n      () => undefined\n    )\n    return result\n  }\n\n  const fetchCaches = () => settle.fetchNames()\n\n  /** The configuration of the queue, as a target names it; nothing for a profile without `configOf`. */\n  const namesOfQueue = (queueKey: UploadQueueKey) => (profile.configOf ? [profile.configOf(queueKey)] : undefined)\n\n  /** Answers whether this miss was the one too many: the row is given up. */\n  const countMiss = (tracked: Pick<TrackedRow, 'queueKey' | 'row' | 'state'>) => {\n    tracked.state.misses++\n    if (tracked.state.misses < UPLOAD_POLL_MISSING_LIMIT) return false\n    settle.giveUpOnMissing(tracked)\n    return true\n  }\n\n  // A row left failed without the original of its duplicate, and an uploaded one still without its metadata, are\n  // no longer tracked, and a refresh may still help them. The reads that find no asset are counted for them here,\n  // across them all and until one answers: at the limit there is nothing a refresh could read, and the uploaded\n  // row fails. Answers as `countMiss` does.\n  const missesOfLeft = new WeakMap<UploadQueueItem, number>()\n  const countsMissesOfLeft = (row: UploadQueueItem) =>\n    memory.refreshMayHelp.has(toRaw(row)) || settle.awaitsMetadata(row)\n  const countMissOfLeft = ({ queueKey, row }: { queueKey: UploadQueueKey; row: UploadQueueItem }) => {\n    const raw = toRaw(row)\n    if (!countsMissesOfLeft(row)) return false\n    const misses = (missesOfLeft.get(raw) ?? 0) + 1\n    if (misses < UPLOAD_POLL_MISSING_LIMIT) {\n      missesOfLeft.set(raw, misses)\n      return false\n    }\n    missesOfLeft.delete(raw)\n    settle.giveUpOnMissing({ queueKey, row })\n    return true\n  }\n\n  /** The live rows a read of the asset would write into, for any of the given targets, of the configurations named. */\n  const concernedRows = (\n    assetId: DocId,\n    targets: Iterable<{ fileId: DocIdNullable; intent: Pick<UploadReadIntent, 'early'> }>,\n    configNames?: string[]\n  ) => {\n    const all = [...targets]\n    return settle.rows().filter(({ queueKey, row }) => {\n      if (row.status === UploadQueueItemStatus.Stop) return false\n      return all.some(({ fileId, intent }) => {\n        const target = { assetId, fileId, configNames }\n        return (\n          settle.concerns(queueKey, row, target, 'decorate') ||\n          (intent.early && settle.concerns(queueKey, row, target, 'metadata'))\n        )\n      })\n    })\n  }\n\n  const anyRowMatches = (target: UploadSettlementTarget, purpose: 'settle' | 'decorate' | 'metadata') =>\n    settle\n      .rows()\n      .some(\n        ({ queueKey, row }) =>\n          row.status !== UploadQueueItemStatus.Stop && settle.concerns(queueKey, row, target, purpose)\n      )\n\n  // A read brought the asset of these rows: the counts of the tracked ones start anew, and their warning goes.\n  const readSucceeded = (rows: Array<{ row: UploadQueueItem }>) => {\n    for (const { row } of rows) {\n      missesOfLeft.delete(toRaw(row))\n      const state = settle.trackStateOf(row)\n      if (!state) continue\n      state.misses = 0\n      state.readFailures = 0\n      state.reported = false\n      settle.noticeOf(row).readWarning = false\n      settle.syncNotice(row)\n    }\n  }\n\n  const untold = (rows: Array<{ row: UploadQueueItem }>) =>\n    rows.every(({ row }) => settle.trackStateOf(row)?.reported !== true)\n\n  // ---- the tick of a queue\n\n  const readUnitsOf = (rows: TrackedRow[]): ReadUnit[] => {\n    const byLicence = new Map<IntegerId, Map<DocId, TrackedRow[]>>()\n    const bySlotAsset = new Map<DocId, TrackedRow[]>()\n    for (const tracked of rows) {\n      const reader = settle.policyOf(tracked.row).reader\n      if (reader === 'none') continue\n      let byAsset = bySlotAsset\n      if (reader === 'asset') {\n        byAsset = byLicence.get(tracked.row.licenceId) ?? new Map<DocId, TrackedRow[]>()\n        byLicence.set(tracked.row.licenceId, byAsset)\n      }\n      byAsset.set(tracked.assetId, [...(byAsset.get(tracked.assetId) ?? []), tracked])\n    }\n\n    const units: ReadUnit[] = []\n    for (const [licenceId, byAsset] of byLicence) {\n      const assetIds = [...byAsset.keys()]\n      // One asset is asked for by itself, as a notification asks for it.\n      if (assetIds.length === 1) {\n        units.push({\n          rows: byAsset.get(assetIds[0]!)!,\n          read: async (options) => {\n            const asset = await profile.readers.asset(assetIds[0]!, options)\n            return { assets: asset ? [asset] : [], missing: asset === null }\n          },\n        })\n        continue\n      }\n      for (let from = 0; from < assetIds.length; from += UPLOAD_READ_BATCH_LIMIT) {\n        const batch = assetIds.slice(from, from + UPLOAD_READ_BATCH_LIMIT)\n        units.push({\n          rows: batch.flatMap((assetId) => byAsset.get(assetId)!),\n          read: async (options) => {\n            const assets = await profile.readers.assets(licenceId, batch, options)\n            // Not \"every asset is missing\".\n            if (!Array.isArray(assets)) throw new Error('uploadSettlement: unexpected asset list')\n            return { assets }\n          },\n        })\n      }\n    }\n    for (const [assetId, slotRows] of bySlotAsset) {\n      units.push({\n        rows: slotRows,\n        read: async (options) => {\n          if (!profile.readers.slotFiles) throw new Error('uploadSettlement: no reader of the slots')\n          const slotFiles = await profile.readers.slotFiles(assetId, options)\n          if (!Array.isArray(slotFiles)) throw new Error('uploadSettlement: unexpected slot list')\n          return { slotFiles }\n        },\n      })\n    }\n    return units\n  }\n\n  const applyAssets = async (\n    unit: ReadUnit,\n    assets: AssetDetailItemDto[],\n    startedAt: number,\n    goesOn: () => boolean,\n    configNames: string[] | undefined\n  ) => {\n    for (const asset of assets) {\n      if (!goesOn()) return\n      try {\n        await settle.applyAssetRead(\n          asset,\n          { assetId: asset.id, fileId: asset.mainFile?.id ?? null, configNames },\n          TICK_INTENT,\n          startedAt\n        )\n      } catch (error) {\n        // One asset that cannot be written is not the end of the tick: the others, and the counts and the texts of\n        // every row, go on.\n        console.error('uploadQueue: a read asset could not be written', error)\n      }\n    }\n    if (!goesOn()) return\n    const present = new Set(assets.map((asset) => asset.id))\n    for (const { state, assetId } of unit.rows) {\n      if (present.has(assetId)) {\n        state.misses = 0\n        state.reported = false\n      } else {\n        state.misses++\n      }\n    }\n  }\n\n  const applySlotFile = async (tracked: TrackedRow, slotFiles: AssetFileNullable[], startedAt: number) => {\n    const { row, state, assetId } = tracked\n    if (!settle.isLive(row) || row.status === UploadQueueItemStatus.Stop || settle.isStale(row, startedAt)) return\n    const file = slotFiles.find((candidate) => candidate?.id === row.fileId)\n    if (!file) {\n      state.misses++\n      return\n    }\n    state.misses = 0\n    state.reported = false\n    const configNames = namesOfQueue(tracked.queueKey)\n    const target = { assetId, fileId: row.fileId, configNames }\n    switch (file.fileAttributes?.status) {\n      case AssetFileProcessStatus.Processed:\n        settle.settleProcessedByEvent(target)\n        // The asset completes the row, and gives an open detail its main file. Not awaited: it waits for this\n        // very read to end.\n        void scheduleNamed(\n          assetId,\n          row.fileId,\n          { hint: 'processed', metadata: false, early: false, seen: true },\n          0,\n          configNames\n        )\n        break\n      case AssetFileProcessStatus.Failed:\n        settle.settleFailed(tracked, file.fileAttributes.failReason)\n        break\n      case AssetFileProcessStatus.Duplicate:\n        await settle.settleDuplicate(target, file.originAssetFile, row.assetType, (candidate) => {\n          return !settle.isStale(candidate, startedAt)\n        })\n        break\n    }\n  }\n\n  // The bulk read carries only the main file of an asset, so a slot row is read from the list of its asset's slots.\n  const applySlotFiles = async (\n    unit: ReadUnit,\n    slotFiles: AssetFileNullable[],\n    startedAt: number,\n    goesOn: () => boolean\n  ) => {\n    for (const tracked of unit.rows) {\n      if (!goesOn()) return\n      try {\n        await applySlotFile(tracked, slotFiles, startedAt)\n      } catch (error) {\n        console.error('uploadQueue: a read slot file could not be written', error)\n      }\n    }\n  }\n\n  const readQueue = async (queueKey: UploadQueueKey, generation: number, startedAt: number) => {\n    // Asked when the tick gets its turn and after every wait: it may have waited behind another read, and its\n    // queue may have been dropped meanwhile, with another one under the same key by now.\n    const goesOn = () => !isDisposed() && generationOf(queueKey) === generation\n    if (!goesOn()) return\n    const lane = laneOfQueue(queueKey)\n    const units = readUnitsOf(trackedRows(queueKey))\n    if (!units.length) return\n    // Each request is told whether a failure of it is the first of a streak: for every request of a tick that\n    // begins one, since they go out together.\n    const options = units.map((unit) => ({\n      report: !lane.failing && unit.rows.every(({ state }) => !state.reported),\n      queueKey,\n    }))\n    // The requests go out together; what they brought is written one after another.\n    const answers = await Promise.allSettled(units.map((unit, index) => unit.read(options[index]!)))\n    if (!goesOn()) return\n    let failed = 0\n    let reportedFailure = false\n    for (const [index, unit] of units.entries()) {\n      const answer = answers[index]!\n      const { report } = options[index]!\n      if (answer.status === 'rejected') {\n        failed++\n        const told = report && failureReported(answer.reason)\n        if (told) reportedFailure = true\n        unit.rows.forEach(({ state }) => {\n          state.readFailures++\n          if (told) state.reported = true\n        })\n        continue\n      }\n      unit.rows.forEach(({ state }) => (state.readFailures = 0))\n      if ('assets' in answer.value) {\n        // Into the rows of the configuration of the queue alone: another DAM may have an asset of that id.\n        await applyAssets(unit, answer.value.assets, startedAt, goesOn, namesOfQueue(queueKey))\n        // The reader has said so, when it was let: it is not let again for these rows.\n        if (answer.value.missing && report) unit.rows.forEach(({ state }) => (state.reported = true))\n      } else {\n        await applySlotFiles(unit, answer.value.slotFiles, startedAt, goesOn)\n      }\n      if (!goesOn()) return\n    }\n    // A request that answered ends the streak; one that failed and was written down begins it.\n    if (failed < units.length) lane.failing = false\n    else if (reportedFailure) lane.failing = true\n    fetchCaches()\n\n    const now = scheduler().now()\n    for (const tracked of trackedRows(queueKey)) {\n      const { row, state } = tracked\n      if (state.misses >= UPLOAD_POLL_MISSING_LIMIT) {\n        settle.giveUpOnMissing(tracked)\n        continue\n      }\n      const notice = settle.noticeOf(row)\n      if (state.readFailures >= UPLOAD_POLL_READ_FAILURE_LIMIT) notice.readWarning = true\n      else if (state.readFailures === 0) notice.readWarning = false\n      const waitsForServer = row.status === UploadQueueItemStatus.Processing && !state.clientFailed\n      if (waitsForServer && now - state.eligibleSince >= UPLOAD_POLL_SLOW_TEXT_AFTER_MS) notice.slow = true\n      settle.syncNotice(row)\n    }\n\n    // The poller takes this for a failed read and waits by its error ladder.\n    if (failed === units.length) throw new Error('uploadSettlement: the read of the queue failed')\n  }\n\n  // ---- reads a notification asks for\n\n  const mergeTarget = (read: PendingNamedRead, fileId: DocIdNullable, intent: UploadReadIntent) => {\n    const key = fileId ?? ''\n    const known = read.targets.get(key)?.intent\n    read.targets.set(key, {\n      fileId,\n      intent: known\n        ? {\n            hint: known.hint ?? intent.hint,\n            metadata: known.metadata || intent.metadata,\n            early: known.early || intent.early,\n            seen: known.seen || intent.seen,\n          }\n        : { ...intent },\n    })\n  }\n\n  const armNamed = (read: PendingNamedRead) => {\n    if (read.timer) scheduler().clearTimeout(read.timer.handle)\n    const delay = Math.max(0, read.dueAt - scheduler().now())\n    read.timer = { handle: scheduler().setTimeout(() => fireNamed(read), delay) }\n  }\n\n  const releaseWaiters = (read: PendingNamedRead) => {\n    const waiters = read.waiters\n    read.waiters = []\n    waiters.forEach((resolve) => resolve())\n  }\n\n  /**\n   * A read of the named asset in `delayMs`; joins the read of that asset that waits already. Of each configuration\n   * named, a read of its own for the rows of its queues; without one, a read for the rows of every queue.\n   */\n  const scheduleNamed = (\n    assetId: DocId,\n    fileId: DocIdNullable,\n    intent: UploadReadIntent,\n    delayMs: number,\n    configNames?: string[]\n  ) => {\n    const names = profile.configOf && configNames?.length ? [...new Set(configNames)] : [undefined]\n    return Promise.all(names.map((name) => scheduleRead(assetId, fileId, intent, delayMs, name))).then(() => undefined)\n  }\n\n  const scheduleRead = (\n    assetId: DocId,\n    fileId: DocIdNullable,\n    intent: UploadReadIntent,\n    delayMs: number,\n    configName: string | undefined\n  ) => {\n    const key = isUndefined(configName) ? assetId : `${configName}\\u0000${assetId}`\n    let read = pending.get(key)\n    if (!read) {\n      read = {\n        key,\n        assetId,\n        configName,\n        targets: new Map(),\n        dueAt: Infinity,\n        failures: 0,\n        misses: 0,\n        told: false,\n        timer: null,\n        waiters: [],\n      }\n      pending.set(key, read)\n    }\n    mergeTarget(read, fileId, intent)\n    read.dueAt = Math.min(read.dueAt, scheduler().now() + delayMs)\n    armNamed(read)\n    const waiting = read\n    return new Promise<void>((resolve) => waiting.waiters.push(resolve))\n  }\n\n  const fireNamed = (read: PendingNamedRead) => {\n    read.timer = null\n    if (pending.get(read.key) === read) pending.delete(read.key)\n    void enqueueRead(laneOf(read.configName), (startedAt) => readNamed(read, startedAt))\n  }\n\n  const retryNamed = (read: PendingNamedRead, attempt: number) => {\n    const delay = UPLOAD_POLL_ERROR_LADDER_MS[Math.min(attempt, UPLOAD_POLL_ERROR_LADDER_MS.length) - 1]!\n    const waiting = pending.get(read.key)\n    if (!waiting) {\n      read.dueAt = scheduler().now() + delay\n      pending.set(read.key, read)\n      armNamed(read)\n      return\n    }\n    // An event came while this read was on its way and waits in a read of its own: the retry joins it.\n    read.targets.forEach(({ fileId, intent }) => mergeTarget(waiting, fileId, intent))\n    waiting.failures = Math.max(waiting.failures, read.failures)\n    waiting.misses = Math.max(waiting.misses, read.misses)\n    waiting.told ||= read.told\n  }\n\n  const warnAboutRead = (rows: Array<{ row: UploadQueueItem }>) => {\n    for (const { row } of rows) {\n      settle.noticeOf(row).readWarning = true\n      settle.syncNotice(row)\n    }\n  }\n\n  /** The configurations a pending read names: its own, or none. */\n  const namesOfRead = (read: PendingNamedRead) => (isUndefined(read.configName) ? undefined : [read.configName])\n  /** The rows the pending read is for, as they are now. */\n  const rowsOfRead = (read: PendingNamedRead) => concernedRows(read.assetId, read.targets.values(), namesOfRead(read))\n\n  const readNamed = async (read: PendingNamedRead, startedAt: number) => {\n    try {\n      // The rows it was for have left their queues meanwhile: nothing to ask for.\n      const askedFor = rowsOfRead(read)\n      if (isDisposed() || !askedFor.length) return\n      const lane = laneOf(read.configName)\n      // Until one of its tries was written down, when no streak runs and none of its rows has had its trouble\n      // reported.\n      const report = !lane.failing && !read.told && read.misses === 0 && untold(askedFor)\n      let asset: AssetDetailItemDto | null\n      try {\n        asset = await profile.readers.asset(read.assetId, { report, queueKey: askedFor[0]!.queueKey })\n      } catch (error) {\n        if (isDisposed()) return\n        // Its rows left while it was on the wire: nobody waits for another try, and it begins no streak.\n        const left = rowsOfRead(read)\n        if (!left.length) return\n        read.failures++\n        const told = report && failureReported(error)\n        if (told) {\n          read.told = true\n          lane.failing = true\n        }\n        // The count of the read times its tries, and says when a row no tick asks about has waited in vain. A\n        // tracked row warns by its own count: ticks fail and succeed for it between the tries of this read.\n        const exhausted = read.failures >= UPLOAD_POLL_READ_FAILURE_LIMIT\n        const warned: Array<{ row: UploadQueueItem }> = []\n        for (const entry of left) {\n          const state = settle.trackStateOf(entry.row)\n          if (state) {\n            state.readFailures++\n            if (told) state.reported = true\n          }\n          if (state ? state.readFailures >= UPLOAD_POLL_READ_FAILURE_LIMIT : exhausted) warned.push(entry)\n        }\n        // Once exhausted, only the refresh of the row asks again.\n        if (!exhausted) retryNamed(read, read.failures)\n        warnAboutRead(warned)\n        return\n      }\n      if (isDisposed()) return\n      read.failures = 0\n      lane.failing = false\n      if (asset === null) {\n        read.misses++\n        const concerned = rowsOfRead(read)\n        const untracked = concerned.filter(({ row }) => !settle.trackStateOf(row))\n        for (const { queueKey, row } of concerned) {\n          const state = settle.trackStateOf(row)\n          if (!state) {\n            countMissOfLeft({ queueKey, row })\n            continue\n          }\n          if (report) state.reported = true\n          countMiss({ queueKey, row, state })\n        }\n        // Nobody is left to try again for.\n        if (!concerned.length) return\n        if (read.misses < UPLOAD_POLL_MISSING_LIMIT) retryNamed(read, read.misses)\n        // A row an event has settled is not flipped to failed; it only says its data could not be read. One still\n        // without its metadata has failed by its count above.\n        else warnAboutRead(untracked)\n        return\n      }\n      readSucceeded(rowsOfRead(read))\n      for (const { fileId, intent } of read.targets.values()) {\n        if (isDisposed()) return\n        await settle.applyAssetRead(\n          asset,\n          { assetId: read.assetId, fileId, configNames: namesOfRead(read) },\n          intent,\n          startedAt\n        )\n      }\n      if (isDisposed()) return\n      fetchCaches()\n    } catch (error) {\n      console.error('uploadQueue: the asset of a notification could not be settled', error)\n    } finally {\n      releaseWaiters(read)\n    }\n  }\n\n  // ---- reads asked for at once\n\n  // Of the reads of several configurations, the outcome first in this order that any of them had is told.\n  const OUTCOME_ORDER: UploadRefreshOutcome[] = ['error', 'originalUnread', 'missing', 'pending', 'settled']\n\n  /**\n   * What the one who asked is told of the read. What asking again may mend, by its cause: the read failed\n   * (`error`), the asset was not found (`missing`), or a row is left without the original of its duplicate\n   * (`originalUnread`). A target that names several configurations is read once for each, by a queue of it.\n   */\n  const readTargetNow = (target: UploadSettlementTarget, intent: UploadReadIntent): Promise<UploadRefreshOutcome> => {\n    const targets = settle.byConfiguration(target)\n    if (targets.length === 1) return readOneNow(target, intent)\n    return Promise.all(targets.map((one) => readOneNow(one, intent))).then(\n      (outcomes) => OUTCOME_ORDER.find((outcome) => outcomes.includes(outcome)) ?? 'settled'\n    )\n  }\n\n  const readOneNow = (target: UploadSettlementTarget, intent: UploadReadIntent): Promise<UploadRefreshOutcome> =>\n    enqueueRead(laneOfTarget(target), async (startedAt) => {\n      try {\n        if (isDisposed()) return 'error'\n        // The queue of the first row the read is for, noted before it is asked.\n        const queueKey = concernedRows(target.assetId, [{ fileId: target.fileId, intent }], target.configNames)[0]\n          ?.queueKey\n        // A configuration named that has no row of the asset (any longer): its DAM is not asked.\n        if (profile.configOf && target.configNames?.length && isUndefined(queueKey)) return 'settled'\n        // The user asked: every failure of it is reported.\n        const asset = await profile.readers.asset(target.assetId, { report: true, queueKey })\n        if (isDisposed()) return 'error'\n        laneOfTarget(target).failing = false\n        const concerned = concernedRows(target.assetId, [{ fileId: target.fileId, intent }], target.configNames)\n        if (asset === null) {\n          let givenUp = false\n          let askedOn = false\n          for (const { queueKey, row } of concerned) {\n            const state = settle.trackStateOf(row)\n            // Said by this read: the poll does not say it again.\n            if (state) state.reported = true\n            if (state ? countMiss({ queueKey, row, state }) : countMissOfLeft({ queueKey, row })) givenUp = true\n            else if (state || countsMissesOfLeft(row)) askedOn = true\n          }\n          // The miss that was one too many has settled its rows, as given up: there is nothing to ask again.\n          return givenUp && !askedOn ? 'settled' : 'missing'\n        }\n        readSucceeded(concerned)\n        const leftWithout = await settle.applyAssetRead(asset, target, intent, startedAt)\n        if (isDisposed()) return 'error'\n        fetchCaches()\n        if (leftWithout) return 'originalUnread'\n        // Otherwise by the state of the main file alone, whichever rows were written.\n        return isFinalFileStatus(asset.mainFile?.fileAttributes?.status) ? 'settled' : 'pending'\n      } catch {\n        return 'error'\n      }\n    })\n\n  const refreshAsset = (target: UploadSettlementTarget) =>\n    readTargetNow(target, { hint: null, metadata: true, early: false, seen: true })\n\n  const settleKnownProcessed = async (target: UploadSettlementTarget, options: { withMetadata: boolean }) => {\n    await readTargetNow(target, { hint: 'processed', metadata: options.withMetadata, early: false, seen: true })\n  }\n\n  const settleKnownFailed = (target: UploadSettlementTarget, failReason: AssetFileFailReasonType) => {\n    if (isDisposed()) return\n    settle.settleKnownFailed(target, failReason)\n  }\n\n  const settleKnownDuplicate = (\n    target: UploadSettlementTarget,\n    originFileId: DocIdNullable,\n    assetType: DamAssetTypeType | null\n  ) => (isDisposed() ? Promise.resolve() : settle.settleKnownDuplicate(target, originFileId, assetType))\n\n  const notify = (event: UploadSettlementEvent): Promise<void> => {\n    if (isDisposed()) return Promise.resolve()\n    const target = { assetId: event.assetId, fileId: event.fileId, configNames: event.configNames }\n    try {\n      switch (event.kind) {\n        case 'processed':\n          if (!anyRowMatches(target, 'decorate')) break\n          settle.settleProcessedByEvent(target)\n          settle.announceProcessed(target)\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: 'processed', metadata: false, early: false, seen: true },\n            UPLOAD_NOTIFY_FILE_DELAY_MS,\n            event.configNames\n          )\n        case 'copied':\n          if (!anyRowMatches(target, 'decorate')) break\n          // A copy gets no metadata notification: its metadata comes with this read.\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: 'processed', metadata: true, early: false, seen: true },\n            UPLOAD_NOTIFY_FILE_DELAY_MS,\n            event.configNames\n          )\n        case 'metadata':\n          if (!anyRowMatches(target, 'metadata')) break\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: null, metadata: true, early: true, seen: false },\n            UPLOAD_NOTIFY_METADATA_DELAY_MS,\n            event.configNames\n          )\n        case 'failed':\n          settle.settleKnownFailed(target, event.failReason ?? AssetFileFailReason.Unknown)\n          break\n        case 'duplicate':\n          if (!anyRowMatches(target, 'settle')) break\n          return settle.settleKnownDuplicate(target, event.originAssetFile ?? null, event.assetType ?? null)\n      }\n    } catch (error) {\n      console.error('uploadQueue: the notification could not be settled', error)\n    }\n    return Promise.resolve()\n  }\n\n  // ---- tracking\n\n  const subscribe = () => {\n    if (unsubscribe.length) return\n    unsubscribe = [\n      uploadSettlementRuntime.visibility.onChange(() => {\n        const visible = uploadSettlementRuntime.visibility.isVisible()\n        pollers.forEach((poller) => (visible ? poller.readNow('visible') : poller.reschedule()))\n      }),\n      // The notifications came alive or died: the rhythm of the other mode.\n      profile.connection.onChange(() => pollers.forEach((poller) => poller.reschedule())),\n    ]\n  }\n\n  const unsubscribeAll = () => {\n    unsubscribe.forEach((stop) => stop())\n    unsubscribe = []\n  }\n\n  const pollerOf = (queueKey: UploadQueueKey) => {\n    let poller = pollers.get(queueKey)\n    if (!poller) {\n      poller = createQueuePoller({\n        youngestAgeMs: () => youngestAgeMs(queueKey),\n        // The socket of the configuration of the queue: the queue of one without a socket polls densely.\n        mode: () => (profile.connection.isPushAlive(queueKey) ? 'sparse' : 'dense'),\n        read: () => {\n          const generation = generationOf(queueKey)\n          return enqueueRead(laneOfQueue(queueKey), (startedAt) => readQueue(queueKey, generation, startedAt))\n        },\n      })\n      pollers.set(queueKey, poller)\n      subscribe()\n    }\n    return poller\n  }\n\n  const queueOf = (queueKey: UploadQueueKey) => {\n    for (const [key, queue] of profile.queues()) {\n      if (key === queueKey) return queue\n    }\n    return null\n  }\n\n  const track = (queueKey: UploadQueueKey, row: UploadQueueItem, options: { clientFailed?: boolean } = {}) => {\n    if (isDisposed()) return\n    const raw = toRaw(row)\n    const queue = queueOf(queueKey)\n    if (!queue || !toRaw(queue.items).some((item) => toRaw(item) === raw)) return\n    // Nothing a tick could ask about.\n    if (row.status === UploadQueueItemStatus.Stop || isNull(row.assetId)) return\n    const reader = settle.policyOf(row).reader\n    if (reader === 'none' || (reader === 'slots' && !profile.readers.slotFiles)) return\n    memory.tracked.set(raw, {\n      queueKey,\n      eligibleSince: scheduler().now(),\n      clientFailed: options.clientFailed === true,\n      misses: 0,\n      readFailures: 0,\n      reported: false,\n    })\n    // Failed by the client, and the server may finish the file all the same.\n    settle.setRefreshMayHelp(queueKey, row, options.clientFailed === true)\n    pollerOf(queueKey).rowAdded()\n  }\n\n  // The rows a waiting read was asked for are leaving: a read no other row needs does not wait on.\n  const cancelUnneeded = (leaving: (entry: { queueKey: UploadQueueKey; row: UploadQueueItem }) => boolean) => {\n    for (const read of pending.values()) {\n      if (rowsOfRead(read).some((entry) => !leaving(entry))) continue\n      if (read.timer) scheduler().clearTimeout(read.timer.handle)\n      read.timer = null\n      pending.delete(read.key)\n      releaseWaiters(read)\n    }\n  }\n\n  // The store takes the row out: its ticks end here, and so do the reads notifications asked for on its behalf.\n  const untrack = (row: UploadQueueItem) => {\n    if (isDisposed()) return\n    const raw = toRaw(row)\n    const leaving = settle.rows().find((entry) => toRaw(entry.row) === raw)\n    if (leaving) settle.setRefreshMayHelp(leaving.queueKey, row, false)\n    settle.untrack(row)\n    cancelUnneeded((entry) => toRaw(entry.row) === raw)\n  }\n\n  const dropQueue = (queueKey: UploadQueueKey) => {\n    if (isDisposed()) return\n    const queue = queueOf(queueKey)\n    if (queue) {\n      for (const row of queue.items) {\n        settle.setRefreshMayHelp(queueKey, row, false)\n        if (memory.tracked.get(toRaw(row))?.queueKey === queueKey) memory.tracked.delete(toRaw(row))\n      }\n    }\n    generations.set(queueKey, generationOf(queueKey) + 1)\n    const lane = laneOfQueue(queueKey)\n    pollers.get(queueKey)?.stop()\n    pollers.delete(queueKey)\n    // Nothing is asked about any more, by the store or in the lane of the queue: what fails for the next rows is a\n    // streak of its own.\n    if (!pollers.size) {\n      unsubscribeAll()\n      lanes.forEach((one) => (one.failing = false))\n    } else if (![...pollers.keys()].some((key) => laneOfQueue(key) === lane)) {\n      lane.failing = false\n    }\n    cancelUnneeded((entry) => entry.queueKey === queueKey)\n  }\n\n  const hasTracked = () => !isDisposed() && trackedRows().length > 0\n  const isGivenUpMissing = (row: UploadQueueItem) => memory.givenUpMissing.has(toRaw(row))\n\n  const dispose = () => {\n    disposed = true\n    pollers.forEach((poller) => poller.stop())\n    pollers.clear()\n    pending.forEach((read) => {\n      if (read.timer) scheduler().clearTimeout(read.timer.handle)\n      read.timer = null\n      releaseWaiters(read)\n    })\n    pending.clear()\n    unsubscribeAll()\n  }\n\n  return {\n    track,\n    untrack,\n    dropQueue,\n    notify,\n    refreshAsset,\n    settleKnownProcessed,\n    settleKnownDuplicate,\n    settleKnownFailed,\n    isGivenUpMissing,\n    hasTracked,\n    dispose,\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"uploadSettlement.js","names":["TICK_INTENT","createUploadSettlement","memory","createUploadSettleMemory","pollers","pending","unsubscribe","disposed","generations","lanes","laneOf","key","profile","configName","lane","laneOfQueue","queueKey","laneOfTarget","target","failureReported","error","scheduler","uploadSettlementRuntime","isDisposed","generationOf","trackedRows","tracked","queue","row","state","toRaw","UploadQueueItemStatus","isNull","youngestAgeMs","now","youngest","age","settle","createUploadSettle","enqueueRead","result","run","fetchCaches","namesOfQueue","countMiss","missesOfLeft","countsMissesOfLeft","countMissOfLeft","raw","misses","concernedRows","all","targets","intent","anyRowMatches","purpose","readSucceeded","rows","untold","readUnitsOf","byLicence","bySlotAsset","reader","byAsset","units","licenceId","assetIds","asset","options","from","batch","assetId","assets","slotRows","slotFiles","applyAssets","goesOn","startedAt","present","unit","applySlotFile","file","candidate","configNames","AssetFileProcessStatus","scheduleNamed","applySlotFiles","readQueue","generation","answers","index","failed","reportedFailure","answer","told","report","notice","mergeTarget","fileId","known","read","armNamed","delay","fireNamed","releaseWaiters","waiters","resolve","names","scheduleRead","delayMs","name","isUndefined","waiting","readNamed","retryNamed","UPLOAD_POLL_ERROR_LADDER_MS","attempt","warnAboutRead","namesOfRead","rowsOfRead","askedFor","left","exhausted","warned","entry","concerned","untracked","OUTCOME_ORDER","readTargetNow","readOneNow","one","outcomes","outcome","givenUp","askedOn","leftWithout","isFinalFileStatus","refreshAsset","settleKnownProcessed","settleKnownFailed","failReason","settleKnownDuplicate","originFileId","assetType","notify","event","UPLOAD_NOTIFY_METADATA_DELAY_MS","AssetFileFailReason","subscribe","visible","poller","unsubscribeAll","stop","pollerOf","createQueuePoller","queueOf","track","item","cancelUnneeded","leaving"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadSettlement.ts"],"sourcesContent":["import { toRaw } from 'vue'\nimport type { DocId, DocIdNullable, IntegerId } from '@/shared/types/common'\nimport type { AssetDetailItemDto, DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport {\n  AssetFileFailReason,\n  type AssetFileFailReasonType,\n  type AssetFileNullable,\n  AssetFileProcessStatus,\n} from '@/domains/dam/types/AssetFile'\nimport {\n  type UploadQueue,\n  type UploadQueueItem,\n  UploadQueueItemStatus,\n  type UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport { createQueuePoller, type QueuePoller } from '@/domains/dam/uploadQueue/settlement/uploadPoller'\nimport {\n  UPLOAD_NOTIFY_FILE_DELAY_MS,\n  UPLOAD_NOTIFY_METADATA_DELAY_MS,\n  UPLOAD_POLL_ERROR_LADDER_MS,\n  UPLOAD_POLL_MISSING_LIMIT,\n  UPLOAD_POLL_READ_FAILURE_LIMIT,\n  UPLOAD_POLL_SLOW_TEXT_AFTER_MS,\n  UPLOAD_READ_BATCH_LIMIT,\n} from '@/domains/dam/uploadQueue/settlement/uploadPollSchedule'\nimport {\n  createUploadSettle,\n  createUploadSettleMemory,\n  isFinalFileStatus,\n  type UploadReadIntent,\n  type UploadTrackState,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettle'\nimport { uploadSettlementRuntime } from '@/domains/dam/uploadQueue/settlement/uploadSettlementRuntime'\nimport type {\n  UploadReadOptions,\n  UploadRefreshOutcome,\n  UploadSettlement,\n  UploadSettlementEvent,\n  UploadSettlementProfile,\n  UploadSettlementTarget,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\nimport { isNull, isUndefined } from '@/shared/utils/common'\n\ninterface TrackedRow {\n  queueKey: UploadQueueKey\n  queue: UploadQueue\n  row: UploadQueueItem\n  state: UploadTrackState\n  /** The asset the row is read by. It changes when a duplicate becomes its original. */\n  assetId: DocId\n}\n\n/** One request of a tick, and the tracked rows it asks about. */\ninterface ReadUnit {\n  rows: TrackedRow[]\n  /** `missing`: the single asset requested alone does not exist. Its reader may report that. */\n  read(\n    options: UploadReadOptions\n  ): Promise<{ assets: AssetDetailItemDto[]; missing?: boolean } | { slotFiles: AssetFileNullable[] }>\n}\n\n/** Sequential reads of one DAM, and whether a streak of their failures is being reported. */\ninterface ReadLane {\n  chain: Promise<void>\n  failing: boolean\n}\n\n/** A read of one asset requested by an event, waiting for its time. */\ninterface PendingNamedRead {\n  /** Key in `pending`: the asset and the configuration the read is for. */\n  key: string\n  assetId: DocId\n  /** The configuration whose rows the read is for (`configOf` of the profile). All queues when omitted. */\n  configName?: string\n  // Keyed by `fileId ?? ''`.\n  targets: Map<string, { fileId: DocIdNullable; intent: UploadReadIntent }>\n  dueAt: number\n  /** Consecutive failed tries. */\n  failures: number\n  /** Consecutive tries that found no asset. */\n  misses: number\n  /** A failure of these tries was reported. Further ones are not. */\n  told: boolean\n  timer: { handle: unknown } | null\n  waiters: Array<() => void>\n}\n\nconst TICK_INTENT: UploadReadIntent = { hint: null, metadata: true, early: false, seen: true }\n\n/**\n * Settlement for the rows of one store: tracks rows waiting for the server and coordinates all reads.\n * Reads start from a queue tick, a notification or a row refresh.\n */\nexport function createUploadSettlement(profile: UploadSettlementProfile): UploadSettlement {\n  const memory = createUploadSettleMemory()\n  const pollers = new Map<UploadQueueKey, QueuePoller>()\n  // At most one pending read per asset, or one per configuration when queues have configurations.\n  const pending = new Map<string, PendingNamedRead>()\n  let unsubscribe: Array<() => void> = []\n  let disposed = false\n  // Incremented when a queue is dropped. A tick that waited meanwhile must not run for the queue that now has the key.\n  const generations = new Map<UploadQueueKey, number>()\n  // The poll and notifications retry while a row waits. A reader reports only the first failure that is written down.\n  // `failing` of the lane holds from such a failure until a read answers.\n  // `reported` of each tracked row holds until a read brings its asset.\n  // A failure that was not written down (timeout, 401, 403) starts\n  // no streak. One read at a time per lane keeps reads in order.\n  // With `configOf`, each configuration has its own lane and streak, plus one lane for\n  // reads naming none, so a slow DAM blocks no other. Without it, one lane for the store.\n  const lanes = new Map<string | undefined, ReadLane>()\n  const laneOf = (configName?: string) => {\n    const key = profile.configOf ? configName : undefined\n    let lane = lanes.get(key)\n    if (!lane) {\n      lane = { chain: Promise.resolve(), failing: false }\n      lanes.set(key, lane)\n    }\n    return lane\n  }\n  const laneOfQueue = (queueKey: UploadQueueKey) => laneOf(profile.configOf?.(queueKey))\n  /** Only a target that names exactly one configuration gets that configuration's lane. */\n  const laneOfTarget = (target: UploadSettlementTarget) =>\n    laneOf(target.configNames?.length === 1 ? target.configNames[0] : undefined)\n  const failureReported = (error: unknown) => profile.readers.failureReported?.(error) ?? true\n\n  const scheduler = () => uploadSettlementRuntime.scheduler\n  // Checked after every wait: a disposed settlement writes, calls and schedules nothing.\n  const isDisposed = () => disposed\n  const generationOf = (queueKey: UploadQueueKey) => generations.get(queueKey) ?? 0\n\n  const trackedRows = (queueKey?: UploadQueueKey): TrackedRow[] => {\n    const tracked: TrackedRow[] = []\n    for (const [key, queue] of profile.queues()) {\n      if (queueKey !== undefined && key !== queueKey) continue\n      for (const row of queue.items) {\n        const state = memory.tracked.get(toRaw(row))\n        if (!state || state.queueKey !== key) continue\n        if (row.status === UploadQueueItemStatus.Stop || isNull(row.assetId)) continue\n        tracked.push({ queueKey: key, queue, row, state, assetId: row.assetId })\n      }\n    }\n    return tracked\n  }\n\n  const youngestAgeMs = (queueKey: UploadQueueKey) => {\n    const now = scheduler().now()\n    let youngest: number | null = null\n    for (const { state } of trackedRows(queueKey)) {\n      const age = now - state.eligibleSince\n      if (youngest === null || age < youngest) youngest = age\n    }\n    return youngest\n  }\n\n  const settle = createUploadSettle(profile, memory, {\n    // A queue that tracks nothing any more holds no timer.\n    onUntrack: (queueKey) => {\n      if (youngestAgeMs(queueKey) === null) pollers.get(queueKey)?.reschedule()\n    },\n    isDisposed,\n  })\n\n  const enqueueRead = <T>(lane: ReadLane, run: (startedAt: number) => Promise<T>): Promise<T> => {\n    const result = lane.chain.then(() => run(settle.startRead()))\n    lane.chain = result.then(\n      () => undefined,\n      () => undefined\n    )\n    return result\n  }\n\n  const fetchCaches = () => settle.fetchNames()\n\n  /** `undefined` for a profile without `configOf`. */\n  const namesOfQueue = (queueKey: UploadQueueKey) => (profile.configOf ? [profile.configOf(queueKey)] : undefined)\n\n  /** Returns true when this miss reaches the limit and the row is given up. */\n  const countMiss = (tracked: Pick<TrackedRow, 'queueKey' | 'row' | 'state'>) => {\n    tracked.state.misses++\n    if (tracked.state.misses < UPLOAD_POLL_MISSING_LIMIT) return false\n    settle.giveUpOnMissing(tracked)\n    return true\n  }\n\n  // Untracked rows that a refresh may still help: failed without\n  // the duplicate's original, or uploaded without metadata.\n  // Misses are counted across all reads until one answers. At\n  // the limit the uploaded row fails. Returns like `countMiss`.\n  const missesOfLeft = new WeakMap<UploadQueueItem, number>()\n  const countsMissesOfLeft = (row: UploadQueueItem) =>\n    memory.refreshMayHelp.has(toRaw(row)) || settle.awaitsMetadata(row)\n  const countMissOfLeft = ({ queueKey, row }: { queueKey: UploadQueueKey; row: UploadQueueItem }) => {\n    const raw = toRaw(row)\n    if (!countsMissesOfLeft(row)) return false\n    const misses = (missesOfLeft.get(raw) ?? 0) + 1\n    if (misses < UPLOAD_POLL_MISSING_LIMIT) {\n      missesOfLeft.set(raw, misses)\n      return false\n    }\n    missesOfLeft.delete(raw)\n    settle.giveUpOnMissing({ queueKey, row })\n    return true\n  }\n\n  /** Live rows a read of the asset would write into, for any of the targets, limited to the named configurations. */\n  const concernedRows = (\n    assetId: DocId,\n    targets: Iterable<{ fileId: DocIdNullable; intent: Pick<UploadReadIntent, 'early'> }>,\n    configNames?: string[]\n  ) => {\n    const all = [...targets]\n    return settle.rows().filter(({ queueKey, row }) => {\n      if (row.status === UploadQueueItemStatus.Stop) return false\n      return all.some(({ fileId, intent }) => {\n        const target = { assetId, fileId, configNames }\n        return (\n          settle.concerns(queueKey, row, target, 'decorate') ||\n          (intent.early && settle.concerns(queueKey, row, target, 'metadata'))\n        )\n      })\n    })\n  }\n\n  const anyRowMatches = (target: UploadSettlementTarget, purpose: 'settle' | 'decorate' | 'metadata') =>\n    settle\n      .rows()\n      .some(\n        ({ queueKey, row }) =>\n          row.status !== UploadQueueItemStatus.Stop && settle.concerns(queueKey, row, target, purpose)\n      )\n\n  // A read found the asset: reset the miss counts of tracked rows and clear their warning.\n  const readSucceeded = (rows: Array<{ row: UploadQueueItem }>) => {\n    for (const { row } of rows) {\n      missesOfLeft.delete(toRaw(row))\n      const state = settle.trackStateOf(row)\n      if (!state) continue\n      state.misses = 0\n      state.readFailures = 0\n      state.reported = false\n      settle.noticeOf(row).readWarning = false\n      settle.syncNotice(row)\n    }\n  }\n\n  const untold = (rows: Array<{ row: UploadQueueItem }>) =>\n    rows.every(({ row }) => settle.trackStateOf(row)?.reported !== true)\n\n  const readUnitsOf = (rows: TrackedRow[]): ReadUnit[] => {\n    const byLicence = new Map<IntegerId, Map<DocId, TrackedRow[]>>()\n    const bySlotAsset = new Map<DocId, TrackedRow[]>()\n    for (const tracked of rows) {\n      const reader = settle.policyOf(tracked.row).reader\n      if (reader === 'none') continue\n      let byAsset = bySlotAsset\n      if (reader === 'asset') {\n        byAsset = byLicence.get(tracked.row.licenceId) ?? new Map<DocId, TrackedRow[]>()\n        byLicence.set(tracked.row.licenceId, byAsset)\n      }\n      byAsset.set(tracked.assetId, [...(byAsset.get(tracked.assetId) ?? []), tracked])\n    }\n\n    const units: ReadUnit[] = []\n    for (const [licenceId, byAsset] of byLicence) {\n      const assetIds = [...byAsset.keys()]\n      // A single asset uses the same single read as a notification.\n      if (assetIds.length === 1) {\n        units.push({\n          rows: byAsset.get(assetIds[0]!)!,\n          read: async (options) => {\n            const asset = await profile.readers.asset(assetIds[0]!, options)\n            return { assets: asset ? [asset] : [], missing: asset === null }\n          },\n        })\n        continue\n      }\n      for (let from = 0; from < assetIds.length; from += UPLOAD_READ_BATCH_LIMIT) {\n        const batch = assetIds.slice(from, from + UPLOAD_READ_BATCH_LIMIT)\n        units.push({\n          rows: batch.flatMap((assetId) => byAsset.get(assetId)!),\n          read: async (options) => {\n            const assets = await profile.readers.assets(licenceId, batch, options)\n            // A non-list answer must not be taken as \"every asset is missing\".\n            if (!Array.isArray(assets)) throw new Error('uploadSettlement: unexpected asset list')\n            return { assets }\n          },\n        })\n      }\n    }\n    for (const [assetId, slotRows] of bySlotAsset) {\n      units.push({\n        rows: slotRows,\n        read: async (options) => {\n          if (!profile.readers.slotFiles) throw new Error('uploadSettlement: no reader of the slots')\n          const slotFiles = await profile.readers.slotFiles(assetId, options)\n          if (!Array.isArray(slotFiles)) throw new Error('uploadSettlement: unexpected slot list')\n          return { slotFiles }\n        },\n      })\n    }\n    return units\n  }\n\n  const applyAssets = async (\n    unit: ReadUnit,\n    assets: AssetDetailItemDto[],\n    startedAt: number,\n    goesOn: () => boolean,\n    configNames: string[] | undefined\n  ) => {\n    for (const asset of assets) {\n      if (!goesOn()) return\n      try {\n        await settle.applyAssetRead(\n          asset,\n          { assetId: asset.id, fileId: asset.mainFile?.id ?? null, configNames },\n          TICK_INTENT,\n          startedAt\n        )\n      } catch (error) {\n        // One asset that fails to write does not end the tick. Other\n        // assets and the counts and texts of every row continue.\n        console.error('uploadQueue: a read asset could not be written', error)\n      }\n    }\n    if (!goesOn()) return\n    const present = new Set(assets.map((asset) => asset.id))\n    for (const { state, assetId } of unit.rows) {\n      if (present.has(assetId)) {\n        state.misses = 0\n        state.reported = false\n      } else {\n        state.misses++\n      }\n    }\n  }\n\n  const applySlotFile = async (tracked: TrackedRow, slotFiles: AssetFileNullable[], startedAt: number) => {\n    const { row, state, assetId } = tracked\n    if (!settle.isLive(row) || row.status === UploadQueueItemStatus.Stop || settle.isStale(row, startedAt)) return\n    const file = slotFiles.find((candidate) => candidate?.id === row.fileId)\n    if (!file) {\n      state.misses++\n      return\n    }\n    state.misses = 0\n    state.reported = false\n    const configNames = namesOfQueue(tracked.queueKey)\n    const target = { assetId, fileId: row.fileId, configNames }\n    switch (file.fileAttributes?.status) {\n      case AssetFileProcessStatus.Processed:\n        settle.settleProcessedByEvent(target)\n        // Not awaited: it waits for this read to end.\n        void scheduleNamed(\n          assetId,\n          row.fileId,\n          { hint: 'processed', metadata: false, early: false, seen: true },\n          0,\n          configNames\n        )\n        break\n      case AssetFileProcessStatus.Failed:\n        settle.settleFailed(tracked, file.fileAttributes.failReason)\n        break\n      case AssetFileProcessStatus.Duplicate:\n        await settle.settleDuplicate(target, file.originAssetFile, row.assetType, (candidate) => {\n          return !settle.isStale(candidate, startedAt)\n        })\n        break\n    }\n  }\n\n  // The bulk read carries only the main file of an asset, so a slot row is read from the list of its asset's slots.\n  const applySlotFiles = async (\n    unit: ReadUnit,\n    slotFiles: AssetFileNullable[],\n    startedAt: number,\n    goesOn: () => boolean\n  ) => {\n    for (const tracked of unit.rows) {\n      if (!goesOn()) return\n      try {\n        await applySlotFile(tracked, slotFiles, startedAt)\n      } catch (error) {\n        console.error('uploadQueue: a read slot file could not be written', error)\n      }\n    }\n  }\n\n  const readQueue = async (queueKey: UploadQueueKey, generation: number, startedAt: number) => {\n    // Checked when the tick gets its turn and after every wait. It may have queued behind\n    // another read, and its queue may have been dropped and replaced under the same key.\n    const goesOn = () => !isDisposed() && generationOf(queueKey) === generation\n    if (!goesOn()) return\n    const lane = laneOfQueue(queueKey)\n    const units = readUnitsOf(trackedRows(queueKey))\n    if (!units.length) return\n    // The requests of a tick go out together, so each one that could start a streak may report its failure.\n    const options = units.map((unit) => ({\n      report: !lane.failing && unit.rows.every(({ state }) => !state.reported),\n      queueKey,\n    }))\n    // Requests go out in parallel; results are applied sequentially.\n    const answers = await Promise.allSettled(units.map((unit, index) => unit.read(options[index]!)))\n    if (!goesOn()) return\n    let failed = 0\n    let reportedFailure = false\n    for (const [index, unit] of units.entries()) {\n      const answer = answers[index]!\n      const { report } = options[index]!\n      if (answer.status === 'rejected') {\n        failed++\n        const told = report && failureReported(answer.reason)\n        if (told) reportedFailure = true\n        unit.rows.forEach(({ state }) => {\n          state.readFailures++\n          if (told) state.reported = true\n        })\n        continue\n      }\n      unit.rows.forEach(({ state }) => (state.readFailures = 0))\n      if ('assets' in answer.value) {\n        // Only into rows of the queue's configuration: another DAM may have an asset with the same id.\n        await applyAssets(unit, answer.value.assets, startedAt, goesOn, namesOfQueue(queueKey))\n        // The reader already reported the missing asset, so these rows do not report it again.\n        if (answer.value.missing && report) unit.rows.forEach(({ state }) => (state.reported = true))\n      } else {\n        await applySlotFiles(unit, answer.value.slotFiles, startedAt, goesOn)\n      }\n      if (!goesOn()) return\n    }\n    // Any answered request ends the streak. A failure that was written down starts it.\n    if (failed < units.length) lane.failing = false\n    else if (reportedFailure) lane.failing = true\n    fetchCaches()\n\n    const now = scheduler().now()\n    for (const tracked of trackedRows(queueKey)) {\n      const { row, state } = tracked\n      if (state.misses >= UPLOAD_POLL_MISSING_LIMIT) {\n        settle.giveUpOnMissing(tracked)\n        continue\n      }\n      const notice = settle.noticeOf(row)\n      if (state.readFailures >= UPLOAD_POLL_READ_FAILURE_LIMIT) notice.readWarning = true\n      else if (state.readFailures === 0) notice.readWarning = false\n      const waitsForServer = row.status === UploadQueueItemStatus.Processing && !state.clientFailed\n      if (waitsForServer && now - state.eligibleSince >= UPLOAD_POLL_SLOW_TEXT_AFTER_MS) notice.slow = true\n      settle.syncNotice(row)\n    }\n\n    // The poller treats this as a failed read and backs off by its error ladder.\n    if (failed === units.length) throw new Error('uploadSettlement: the read of the queue failed')\n  }\n\n  const mergeTarget = (read: PendingNamedRead, fileId: DocIdNullable, intent: UploadReadIntent) => {\n    const key = fileId ?? ''\n    const known = read.targets.get(key)?.intent\n    read.targets.set(key, {\n      fileId,\n      intent: known\n        ? {\n            hint: known.hint ?? intent.hint,\n            metadata: known.metadata || intent.metadata,\n            early: known.early || intent.early,\n            seen: known.seen || intent.seen,\n          }\n        : { ...intent },\n    })\n  }\n\n  const armNamed = (read: PendingNamedRead) => {\n    if (read.timer) scheduler().clearTimeout(read.timer.handle)\n    const delay = Math.max(0, read.dueAt - scheduler().now())\n    read.timer = { handle: scheduler().setTimeout(() => fireNamed(read), delay) }\n  }\n\n  const releaseWaiters = (read: PendingNamedRead) => {\n    const waiters = read.waiters\n    read.waiters = []\n    waiters.forEach((resolve) => resolve())\n  }\n\n  /**\n   * Schedules a read of the asset in `delayMs`, joining a read of it that already waits.\n   * Each named configuration gets its own read for its queues' rows. Without names, one read covers every queue.\n   */\n  const scheduleNamed = (\n    assetId: DocId,\n    fileId: DocIdNullable,\n    intent: UploadReadIntent,\n    delayMs: number,\n    configNames?: string[]\n  ) => {\n    const names = profile.configOf && configNames?.length ? [...new Set(configNames)] : [undefined]\n    return Promise.all(names.map((name) => scheduleRead(assetId, fileId, intent, delayMs, name))).then(() => undefined)\n  }\n\n  const scheduleRead = (\n    assetId: DocId,\n    fileId: DocIdNullable,\n    intent: UploadReadIntent,\n    delayMs: number,\n    configName: string | undefined\n  ) => {\n    const key = isUndefined(configName) ? assetId : `${configName}\\u0000${assetId}`\n    let read = pending.get(key)\n    if (!read) {\n      read = {\n        key,\n        assetId,\n        configName,\n        targets: new Map(),\n        dueAt: Infinity,\n        failures: 0,\n        misses: 0,\n        told: false,\n        timer: null,\n        waiters: [],\n      }\n      pending.set(key, read)\n    }\n    mergeTarget(read, fileId, intent)\n    read.dueAt = Math.min(read.dueAt, scheduler().now() + delayMs)\n    armNamed(read)\n    const waiting = read\n    return new Promise<void>((resolve) => waiting.waiters.push(resolve))\n  }\n\n  const fireNamed = (read: PendingNamedRead) => {\n    read.timer = null\n    if (pending.get(read.key) === read) pending.delete(read.key)\n    void enqueueRead(laneOf(read.configName), (startedAt) => readNamed(read, startedAt))\n  }\n\n  const retryNamed = (read: PendingNamedRead, attempt: number) => {\n    const delay = UPLOAD_POLL_ERROR_LADDER_MS[Math.min(attempt, UPLOAD_POLL_ERROR_LADDER_MS.length) - 1]!\n    const waiting = pending.get(read.key)\n    if (!waiting) {\n      read.dueAt = scheduler().now() + delay\n      pending.set(read.key, read)\n      armNamed(read)\n      return\n    }\n    // An event arrived during this read and waits in its own read. The retry joins it.\n    read.targets.forEach(({ fileId, intent }) => mergeTarget(waiting, fileId, intent))\n    waiting.failures = Math.max(waiting.failures, read.failures)\n    waiting.misses = Math.max(waiting.misses, read.misses)\n    waiting.told ||= read.told\n  }\n\n  const warnAboutRead = (rows: Array<{ row: UploadQueueItem }>) => {\n    for (const { row } of rows) {\n      settle.noticeOf(row).readWarning = true\n      settle.syncNotice(row)\n    }\n  }\n\n  const namesOfRead = (read: PendingNamedRead) => (isUndefined(read.configName) ? undefined : [read.configName])\n  /** Evaluated anew each time, since rows may have left meanwhile. */\n  const rowsOfRead = (read: PendingNamedRead) => concernedRows(read.assetId, read.targets.values(), namesOfRead(read))\n\n  const readNamed = async (read: PendingNamedRead, startedAt: number) => {\n    try {\n      // Its rows have left their queues meanwhile.\n      const askedFor = rowsOfRead(read)\n      if (isDisposed() || !askedFor.length) return\n      const lane = laneOf(read.configName)\n      // Reports until one of its tries was written down, while no streak runs and none of its rows was reported.\n      const report = !lane.failing && !read.told && read.misses === 0 && untold(askedFor)\n      let asset: AssetDetailItemDto | null\n      try {\n        asset = await profile.readers.asset(read.assetId, { report, queueKey: askedFor[0]!.queueKey })\n      } catch (error) {\n        if (isDisposed()) return\n        // Its rows left while it was in flight: no retry and no streak.\n        const left = rowsOfRead(read)\n        if (!left.length) return\n        read.failures++\n        const told = report && failureReported(error)\n        if (told) {\n          read.told = true\n          lane.failing = true\n        }\n        // The read's own count paces its retries and warns for untracked rows.\n        // A tracked row warns by its own count, because ticks fail and succeed for it between these retries.\n        const exhausted = read.failures >= UPLOAD_POLL_READ_FAILURE_LIMIT\n        const warned: Array<{ row: UploadQueueItem }> = []\n        for (const entry of left) {\n          const state = settle.trackStateOf(entry.row)\n          if (state) {\n            state.readFailures++\n            if (told) state.reported = true\n          }\n          if (state ? state.readFailures >= UPLOAD_POLL_READ_FAILURE_LIMIT : exhausted) warned.push(entry)\n        }\n        // Once exhausted, only a manual refresh of the row reads again.\n        if (!exhausted) retryNamed(read, read.failures)\n        warnAboutRead(warned)\n        return\n      }\n      if (isDisposed()) return\n      read.failures = 0\n      lane.failing = false\n      if (asset === null) {\n        read.misses++\n        const concerned = rowsOfRead(read)\n        const untracked = concerned.filter(({ row }) => !settle.trackStateOf(row))\n        for (const { queueKey, row } of concerned) {\n          const state = settle.trackStateOf(row)\n          if (!state) {\n            countMissOfLeft({ queueKey, row })\n            continue\n          }\n          if (report) state.reported = true\n          countMiss({ queueKey, row, state })\n        }\n        if (!concerned.length) return\n        if (read.misses < UPLOAD_POLL_MISSING_LIMIT) retryNamed(read, read.misses)\n        // A row an event has settled is not flipped to failed. It only warns that its data could not be read.\n        // A row still without metadata already failed by its count above.\n        else warnAboutRead(untracked)\n        return\n      }\n      readSucceeded(rowsOfRead(read))\n      for (const { fileId, intent } of read.targets.values()) {\n        if (isDisposed()) return\n        await settle.applyAssetRead(\n          asset,\n          { assetId: read.assetId, fileId, configNames: namesOfRead(read) },\n          intent,\n          startedAt\n        )\n      }\n      if (isDisposed()) return\n      fetchCaches()\n    } catch (error) {\n      console.error('uploadQueue: the asset of a notification could not be settled', error)\n    } finally {\n      releaseWaiters(read)\n    }\n  }\n\n  // With reads of several configurations, the first outcome in this order that any of them had is returned.\n  const OUTCOME_ORDER: UploadRefreshOutcome[] = ['error', 'originalUnread', 'missing', 'pending', 'settled']\n\n  /**\n   * Outcome of the read for the caller. Retryable causes: `error` (read failed),\n   * `missing` (asset not found), `originalUnread` (duplicate's original not read).\n   * A target naming several configurations is read once per configuration, through one of its queues.\n   */\n  const readTargetNow = (target: UploadSettlementTarget, intent: UploadReadIntent): Promise<UploadRefreshOutcome> => {\n    const targets = settle.byConfiguration(target)\n    if (targets.length === 1) return readOneNow(target, intent)\n    return Promise.all(targets.map((one) => readOneNow(one, intent))).then(\n      (outcomes) => OUTCOME_ORDER.find((outcome) => outcomes.includes(outcome)) ?? 'settled'\n    )\n  }\n\n  const readOneNow = (target: UploadSettlementTarget, intent: UploadReadIntent): Promise<UploadRefreshOutcome> =>\n    enqueueRead(laneOfTarget(target), async (startedAt) => {\n      try {\n        if (isDisposed()) return 'error'\n        // Queue of the first concerned row, taken before the read.\n        const queueKey = concernedRows(target.assetId, [{ fileId: target.fileId, intent }], target.configNames)[0]\n          ?.queueKey\n        // A named configuration with no row of the asset left: its DAM is not asked.\n        if (profile.configOf && target.configNames?.length && isUndefined(queueKey)) return 'settled'\n        // A user-requested read reports every failure.\n        const asset = await profile.readers.asset(target.assetId, { report: true, queueKey })\n        if (isDisposed()) return 'error'\n        laneOfTarget(target).failing = false\n        const concerned = concernedRows(target.assetId, [{ fileId: target.fileId, intent }], target.configNames)\n        if (asset === null) {\n          let givenUp = false\n          let askedOn = false\n          for (const { queueKey, row } of concerned) {\n            const state = settle.trackStateOf(row)\n            // Reported by this read, so the poll does not report it again.\n            if (state) state.reported = true\n            if (state ? countMiss({ queueKey, row, state }) : countMissOfLeft({ queueKey, row })) givenUp = true\n            else if (state || countsMissesOfLeft(row)) askedOn = true\n          }\n          // The final miss gave up and settled its rows, so there is nothing to retry.\n          return givenUp && !askedOn ? 'settled' : 'missing'\n        }\n        readSucceeded(concerned)\n        const leftWithout = await settle.applyAssetRead(asset, target, intent, startedAt)\n        if (isDisposed()) return 'error'\n        fetchCaches()\n        if (leftWithout) return 'originalUnread'\n        // Otherwise decided by the main file status alone, regardless of which rows were written.\n        return isFinalFileStatus(asset.mainFile?.fileAttributes?.status) ? 'settled' : 'pending'\n      } catch {\n        return 'error'\n      }\n    })\n\n  const refreshAsset = (target: UploadSettlementTarget) =>\n    readTargetNow(target, { hint: null, metadata: true, early: false, seen: true })\n\n  const settleKnownProcessed = async (target: UploadSettlementTarget, options: { withMetadata: boolean }) => {\n    await readTargetNow(target, { hint: 'processed', metadata: options.withMetadata, early: false, seen: true })\n  }\n\n  const settleKnownFailed = (target: UploadSettlementTarget, failReason: AssetFileFailReasonType) => {\n    if (isDisposed()) return\n    settle.settleKnownFailed(target, failReason)\n  }\n\n  const settleKnownDuplicate = (\n    target: UploadSettlementTarget,\n    originFileId: DocIdNullable,\n    assetType: DamAssetTypeType | null\n  ) => (isDisposed() ? Promise.resolve() : settle.settleKnownDuplicate(target, originFileId, assetType))\n\n  const notify = (event: UploadSettlementEvent): Promise<void> => {\n    if (isDisposed()) return Promise.resolve()\n    const target = { assetId: event.assetId, fileId: event.fileId, configNames: event.configNames }\n    try {\n      switch (event.kind) {\n        case 'processed':\n          if (!anyRowMatches(target, 'decorate')) break\n          settle.settleProcessedByEvent(target)\n          settle.announceProcessed(target)\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: 'processed', metadata: false, early: false, seen: true },\n            UPLOAD_NOTIFY_FILE_DELAY_MS,\n            event.configNames\n          )\n        case 'copied':\n          if (!anyRowMatches(target, 'decorate')) break\n          // A copy gets no metadata notification: its metadata comes with this read.\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: 'processed', metadata: true, early: false, seen: true },\n            UPLOAD_NOTIFY_FILE_DELAY_MS,\n            event.configNames\n          )\n        case 'metadata':\n          if (!anyRowMatches(target, 'metadata')) break\n          return scheduleNamed(\n            event.assetId,\n            event.fileId,\n            { hint: null, metadata: true, early: true, seen: false },\n            UPLOAD_NOTIFY_METADATA_DELAY_MS,\n            event.configNames\n          )\n        case 'failed':\n          settle.settleKnownFailed(target, event.failReason ?? AssetFileFailReason.Unknown)\n          break\n        case 'duplicate':\n          if (!anyRowMatches(target, 'settle')) break\n          return settle.settleKnownDuplicate(target, event.originAssetFile ?? null, event.assetType ?? null)\n      }\n    } catch (error) {\n      console.error('uploadQueue: the notification could not be settled', error)\n    }\n    return Promise.resolve()\n  }\n\n  const subscribe = () => {\n    if (unsubscribe.length) return\n    unsubscribe = [\n      uploadSettlementRuntime.visibility.onChange(() => {\n        const visible = uploadSettlementRuntime.visibility.isVisible()\n        pollers.forEach((poller) => (visible ? poller.readNow('visible') : poller.reschedule()))\n      }),\n      // Notifications connected or dropped: switch pollers to the other rhythm.\n      profile.connection.onChange(() => pollers.forEach((poller) => poller.reschedule())),\n    ]\n  }\n\n  const unsubscribeAll = () => {\n    unsubscribe.forEach((stop) => stop())\n    unsubscribe = []\n  }\n\n  const pollerOf = (queueKey: UploadQueueKey) => {\n    let poller = pollers.get(queueKey)\n    if (!poller) {\n      poller = createQueuePoller({\n        youngestAgeMs: () => youngestAgeMs(queueKey),\n        // Uses the socket of the queue's configuration. A queue without a live socket polls densely.\n        mode: () => (profile.connection.isPushAlive(queueKey) ? 'sparse' : 'dense'),\n        read: () => {\n          const generation = generationOf(queueKey)\n          return enqueueRead(laneOfQueue(queueKey), (startedAt) => readQueue(queueKey, generation, startedAt))\n        },\n      })\n      pollers.set(queueKey, poller)\n      subscribe()\n    }\n    return poller\n  }\n\n  const queueOf = (queueKey: UploadQueueKey) => {\n    for (const [key, queue] of profile.queues()) {\n      if (key === queueKey) return queue\n    }\n    return null\n  }\n\n  const track = (queueKey: UploadQueueKey, row: UploadQueueItem, options: { clientFailed?: boolean } = {}) => {\n    if (isDisposed()) return\n    const raw = toRaw(row)\n    const queue = queueOf(queueKey)\n    if (!queue || !toRaw(queue.items).some((item) => toRaw(item) === raw)) return\n    if (row.status === UploadQueueItemStatus.Stop || isNull(row.assetId)) return\n    const reader = settle.policyOf(row).reader\n    if (reader === 'none' || (reader === 'slots' && !profile.readers.slotFiles)) return\n    memory.tracked.set(raw, {\n      queueKey,\n      eligibleSince: scheduler().now(),\n      clientFailed: options.clientFailed === true,\n      misses: 0,\n      readFailures: 0,\n      reported: false,\n    })\n    // The client failed it, but the server may still finish the file.\n    settle.setRefreshMayHelp(queueKey, row, options.clientFailed === true)\n    pollerOf(queueKey).rowAdded()\n  }\n\n  // Its rows are leaving: cancel a waiting read that no other row needs.\n  const cancelUnneeded = (leaving: (entry: { queueKey: UploadQueueKey; row: UploadQueueItem }) => boolean) => {\n    for (const read of pending.values()) {\n      if (rowsOfRead(read).some((entry) => !leaving(entry))) continue\n      if (read.timer) scheduler().clearTimeout(read.timer.handle)\n      read.timer = null\n      pending.delete(read.key)\n      releaseWaiters(read)\n    }\n  }\n\n  // The store removed the row: its ticks end, and so do notification reads made for it.\n  const untrack = (row: UploadQueueItem) => {\n    if (isDisposed()) return\n    const raw = toRaw(row)\n    const leaving = settle.rows().find((entry) => toRaw(entry.row) === raw)\n    if (leaving) settle.setRefreshMayHelp(leaving.queueKey, row, false)\n    settle.untrack(row)\n    cancelUnneeded((entry) => toRaw(entry.row) === raw)\n  }\n\n  const dropQueue = (queueKey: UploadQueueKey) => {\n    if (isDisposed()) return\n    const queue = queueOf(queueKey)\n    if (queue) {\n      for (const row of queue.items) {\n        settle.setRefreshMayHelp(queueKey, row, false)\n        if (memory.tracked.get(toRaw(row))?.queueKey === queueKey) memory.tracked.delete(toRaw(row))\n      }\n    }\n    generations.set(queueKey, generationOf(queueKey) + 1)\n    const lane = laneOfQueue(queueKey)\n    pollers.get(queueKey)?.stop()\n    pollers.delete(queueKey)\n    // Nothing is tracked any more, so failures of later rows start a new streak.\n    if (!pollers.size) {\n      unsubscribeAll()\n      lanes.forEach((one) => (one.failing = false))\n    } else if (![...pollers.keys()].some((key) => laneOfQueue(key) === lane)) {\n      lane.failing = false\n    }\n    cancelUnneeded((entry) => entry.queueKey === queueKey)\n  }\n\n  const hasTracked = () => !isDisposed() && trackedRows().length > 0\n  const isGivenUpMissing = (row: UploadQueueItem) => memory.givenUpMissing.has(toRaw(row))\n\n  const dispose = () => {\n    disposed = true\n    pollers.forEach((poller) => poller.stop())\n    pollers.clear()\n    pending.forEach((read) => {\n      if (read.timer) scheduler().clearTimeout(read.timer.handle)\n      read.timer = null\n      releaseWaiters(read)\n    })\n    pending.clear()\n    unsubscribeAll()\n  }\n\n  return {\n    track,\n    untrack,\n    dropQueue,\n    notify,\n    refreshAsset,\n    settleKnownProcessed,\n    settleKnownDuplicate,\n    settleKnownFailed,\n    isGivenUpMissing,\n    hasTracked,\n    dispose,\n  }\n}\n"],"mappings":"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"}

package/dist/domains/dam/uploadQueue/settlement/uploadSettlementRuntime.d.ts

@@ -8,8 +8,8 @@ export interface UploadSettlementVisibility {
     onChange(callback: () => void): () => void;
 }
 /**
- * An object with writable fields: a test replaces a field, not the binding. Production code never writes here.
- * The settlement reads the fields at each use, not once when it is created.
+ * Writable fields so a test can replace a field, not the binding. Production code never writes here.
+ * The settlement reads the fields at each use, not once at creation.
  */
 export declare const uploadSettlementRuntime: {
     scheduler: UploadSettlementScheduler;

package/dist/domains/dam/uploadQueue/settlement/uploadSettlementRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadSettlementRuntime.js","names":["uploadSettlementRuntime","callback","ms","handle"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadSettlementRuntime.ts"],"sourcesContent":["export interface UploadSettlementScheduler {\n  now(): number\n  setTimeout(callback: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\n\nexport interface UploadSettlementVisibility {\n  isVisible(): boolean\n  onChange(callback: () => void): () => void\n}\n\n/**\n * An object with writable fields: a test replaces a field, not the binding. Production code never writes here.\n * The settlement reads the fields at each use, not once when it is created.\n */\nexport const uploadSettlementRuntime: {\n  scheduler: UploadSettlementScheduler\n  visibility: UploadSettlementVisibility\n} = {\n  scheduler: {\n    now: () => Date.now(),\n    setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n    clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n  },\n  visibility: {\n    isVisible: () => typeof document === 'undefined' || document.visibilityState !== 'hidden',\n    onChange: (callback) => {\n      if (typeof document === 'undefined') return () => {}\n      document.addEventListener('visibilitychange', callback)\n      return () => document.removeEventListener('visibilitychange', callback)\n    },\n  },\n}\n"],"mappings":";AAeA,IAAaA,IAGT;CACF,WAAW;EACT,WAAW,KAAK,IAAI;EACpB,aAAa,GAAU,MAAO,WAAW,WAAWC,GAAUC,CAAE;EAChE,eAAe,MAAW,WAAW,aAAaC,CAAuC;CAC3F;CACA,YAAY;EACV,iBAAiB,OAAO,WAAa,OAAe,SAAS,oBAAoB;EACjF,WAAW,MACL,OAAO,WAAa,YAA0B,CAAC,KACnD,SAAS,iBAAiB,oBAAoBF,CAAQ,SACzC,SAAS,oBAAoB,oBAAoBA,CAAQ;CAE1E;AACF"}
+{"version":3,"file":"uploadSettlementRuntime.js","names":["uploadSettlementRuntime","callback","ms","handle"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadSettlementRuntime.ts"],"sourcesContent":["export interface UploadSettlementScheduler {\n  now(): number\n  setTimeout(callback: () => void, ms: number): unknown\n  clearTimeout(handle: unknown): void\n}\n\nexport interface UploadSettlementVisibility {\n  isVisible(): boolean\n  onChange(callback: () => void): () => void\n}\n\n/**\n * Writable fields so a test can replace a field, not the binding. Production code never writes here.\n * The settlement reads the fields at each use, not once at creation.\n */\nexport const uploadSettlementRuntime: {\n  scheduler: UploadSettlementScheduler\n  visibility: UploadSettlementVisibility\n} = {\n  scheduler: {\n    now: () => Date.now(),\n    setTimeout: (callback, ms) => globalThis.setTimeout(callback, ms),\n    clearTimeout: (handle) => globalThis.clearTimeout(handle as ReturnType<typeof setTimeout>),\n  },\n  visibility: {\n    isVisible: () => typeof document === 'undefined' || document.visibilityState !== 'hidden',\n    onChange: (callback) => {\n      if (typeof document === 'undefined') return () => {}\n      document.addEventListener('visibilitychange', callback)\n      return () => document.removeEventListener('visibilitychange', callback)\n    },\n  },\n}\n"],"mappings":";AAeA,IAAaA,IAGT;CACF,WAAW;EACT,WAAW,KAAK,IAAI;EACpB,aAAa,GAAU,MAAO,WAAW,WAAWC,GAAUC,CAAE;EAChE,eAAe,MAAW,WAAW,aAAaC,CAAuC;CAC3F;CACA,YAAY;EACV,iBAAiB,OAAO,WAAa,OAAe,SAAS,oBAAoB;EACjF,WAAW,MACL,OAAO,WAAa,YAA0B,CAAC,KACnD,SAAS,iBAAiB,oBAAoBF,CAAQ,SACzC,SAAS,oBAAoB,oBAAoBA,CAAQ;CAE1E;AACF"}

package/dist/domains/dam/uploadQueue/settlement/uploadSettlementTypes.d.ts

@@ -11,71 +11,66 @@ export declare const UploadRowRole: {
 };
 export type UploadRowRoleType = (typeof UploadRowRole)[keyof typeof UploadRowRole];
 export interface UploadSettlePolicy {
-    /** What a tick reads the state of the row's file with. `none`: the row is never tracked. */
+    /** How a tick reads the state of the row's file. `none`: the row is never tracked. */
     reader: 'asset' | 'slots' | 'none';
     /**
-     * For the `processed` state ONLY.
-     * `read`: uploaded only from a read, the event merely starts that read.
-     * `event`: the state of the event is written at once, the read completes the row.
-     * `never`: `processed` does not change the state of the row (mass edit), it only completes it.
-     * `failed` and `duplicate` are written to every row that passes `matches(…, 'settle')`.
+     * Applies to the `processed` state only.
+     * `read`: uploaded only after a read; the event just starts the read.
+     * `event`: the event state is written at once; the read completes the row.
+     * `never`: `processed` does not change the row state (mass edit), it only completes
+     * it. `failed` and `duplicate` apply to every row matching `matches(…, 'settle')`.
      */
     settleOn: 'read' | 'event' | 'never';
     duplicate: 'becomeOriginal' | 'markDuplicate';
-    /** `load`: the row is to have a form, and its metadata is loaded into it. */
+    /** `load`: the row gets a form, and its metadata is loaded into it. */
     metadata: 'load' | 'none';
 }
 export interface UploadSettlementTarget {
     assetId: DocId;
-    /** The file the event or the read speaks of; `null` when the caller does not know it. */
+    /** `null` when the caller does not know the file. */
     fileId: DocIdNullable;
     /**
-     * The DAM configurations the target is of: with `configOf` of the profile, a row in a queue of another configuration
-     * is not concerned. Left out or empty: the rows of every queue. Two DAMs may give one asset id.
+     * DAM configurations of the target. With `configOf`, rows in queues of other configurations are not concerned.
+     * Omitted or empty: rows of every queue. Two DAMs may share an asset id.
      */
     configNames?: string[];
 }
-/** What the settlement says of one request it asks a reader for. A reader that ignores it behaves as before. */
+/** Per-request options a reader may honour. A reader that ignores them keeps its old behaviour. */
 export interface UploadReadOptions {
     /**
-     * Whether a failure of this request is to be reported to whoever collects the errors of the application.
-     *
-     * The poll and the notifications ask again and again for as long as a row waits, so of their requests only
-     * the first that fails in a streak is `true`; a read that answers ends the streak (with `configOf` of the profile,
-     * a streak is of one configuration, and only a read of that configuration ends it). The streak begins with a
-     * failure that was written down (`readers.failureReported`): after one that was not, the next request is
-     * `true` again. An asset that does not exist (404) counts as such a failure: it is `true` once per row at most.
-     * A read the user asked for (the refresh) is always `true`.
+     * Whether a failure of this request should be reported to the app error collector.
+     * Polls and notifications retry while a row waits, so only the first failure of a streak is
+     * `true`. An answered read ends the streak; with `configOf`, streaks are per configuration.
+     * A streak starts only with a failure that was written down (`readers.failureReported`).
+     * A 404 counts as such, so it is `true` at most once per row.
+     * A user-requested refresh is always `true`.
      */
     report: boolean;
     /**
-     * The queue the read is for: of the poll its own queue; of a read a notification or the refresh asked for, the
-     * queue of the first row it concerns. For a reader that asks under the configuration of the queue. Not given when
-     * the read concerns no row.
+     * The queue the read is for: the polled queue, or for notification
+     * and refresh reads the queue of the first concerned row.
+     * Lets a reader use the queue's configuration. Omitted when the read concerns no row.
      */
     queueKey?: UploadQueueKey;
 }
-/** What a store hands its settlement. */
 export interface UploadSettlementProfile {
-    /** A live view of the queues of the store. The settlement keeps no rows, it always asks. */
+    /** Live view of the store's queues. The settlement keeps no rows and always asks. */
     queues(): Iterable<[UploadQueueKey, UploadQueue]>;
     /**
-     * The DAM configuration the queue `queueKey` is of. With it, a target or an event that names configurations
-     * concerns only the rows of their queues: the poll of a queue names that of the queue, and every read made for a
-     * target or an event (one a notification asks for, the refresh, a known processed file, the original of a duplicate)
-     * is made once for each configuration it names, by the queue of its first concerned row of that configuration, and
-     * written into its rows alone; a configuration named whose queues have no row of the asset is not read. The reads of
-     * a configuration go one after another, beside those of the others (and those that name none in a lane of their
-     * own), each configuration with its own streak of failures. The caches are told the queue of the rows whose names
-     * they get. Without it, every row of the asset is concerned, all reads go one after another with one streak, and the
-     * caches are called without a queue, as before.
+     * DAM configuration of the queue. With it, named targets and
+     * events concern only rows of their configurations' queues.
+     * Each such read runs once per named configuration, through the queue of its first concerned
+     * row, and writes only into those rows. A configuration with no row of the asset is not read.
+     * Reads run sequentially per configuration, in parallel across configurations (unnamed reads get
+     * their own lane), each with its own failure streak. Caches get the queue of the named rows.
+     * Without it, every row of the asset is concerned, all reads share one lane and streak, and caches get no queue.
      */
     configOf?(queueKey: UploadQueueKey): string;
     roleOf(row: UploadQueueItem): UploadRowRoleType;
     policyFor(role: UploadRowRoleType): UploadSettlePolicy;
     /**
-     * `settle`: the row may be given a state. `decorate`: it may be completed without a change of state.
-     * `metadata`: it may be given its metadata from the metadata notification.
+     * `settle`: the row may get a new state. `decorate`: it may be completed without a state change.
+     * `metadata`: it may get metadata from the metadata notification.
      */
     matches(row: UploadQueueItem, target: UploadSettlementTarget, purpose: 'settle' | 'decorate' | 'metadata'): boolean;
     readers: {
@@ -85,23 +80,25 @@ export interface UploadSettlementProfile {
         assets(licenceId: IntegerId, assetIds: DocId[], options?: UploadReadOptions): Promise<AssetDetailItemDto[]>;
         /** DAM: the files of all the slots of an asset. An answer that is no list throws. */
         slotFiles?(assetId: DocId, options?: UploadReadOptions): Promise<AssetFileNullable[]>;
-        /** LIB: the asset the original file of a duplicate belongs to. `queueKey`: of the first row that is to become it. */
+        /**
+         * LIB: the asset the original file of a duplicate belongs to. `queueKey`: of the first row that is to become it.
+         */
         duplicateOriginAsset?(originFileId: DocId, options?: Pick<UploadReadOptions, 'queueKey'>): Promise<AssetDetailItemDto>;
         /** DAM: the original file of a duplicate, by its type. */
         duplicateOriginFile?(originFileId: DocId, assetType: DamAssetTypeType): Promise<AssetFileNullable>;
         /**
-         * Whether a failure of a read that was let report (`report: true`) was written down, by what the read threw:
-         * `apiErrorIsReported` for readers that report through the api error logger. One that was not (a timeout, a
-         * 401, a 403) has told nobody, and the next read is let report again. Without it, every such failure was.
+         * Whether a failure of a read with `report: true` was written
+         * down, judged by the thrown error, e.g. `apiErrorIsReported`.
+         * If not (timeout, 401, 403), nobody was told and the next read may
+         * report again. Without this, every failure counts as written down.
          */
         failureReported?(error: unknown): boolean;
     };
     /**
-     * `queueKey`: the queue of the rows whose names are added, and the one whose names are to be fetched, given only to
-     * a profile with `configOf`, as the second argument (an `add` of `defineCached`, which takes every argument as an
-     * id, is to be wrapped). Such a profile is asked to fetch, where the fetch was asked for before (after a read,
-     * after a duplicate became its original), for each queue whose rows were given names since its last fetch. A
-     * profile without it is called without a queue, as before.
+     * `queueKey` is passed as the second argument only to a profile with `configOf`.
+     * Wrap a `defineCached` `add`, which treats every argument as an id.
+     * Such a profile is asked to fetch once per queue whose rows got
+     * names since its last fetch. Without `configOf`, calls get no queue.
      */
     caches: {
         addAuthors(ids: DocId[], queueKey?: UploadQueueKey): void;
@@ -114,14 +111,14 @@ export interface UploadSettlementProfile {
         readFailed(row: UploadQueueItem): string;
         assetMissing(row: UploadQueueItem): string;
         /**
-         * The text of an uploaded row still without its metadata whose asset was missing from as many reads as it
-         * takes: it fails with it. Without it, `assetMissing`.
+         * Fail text for an uploaded row without metadata whose asset
+         * was missing from too many reads. Defaults to `assetMissing`.
          */
         assetGone?(row: UploadQueueItem): string;
     };
     /**
-     * `'load'`: this row may be given its metadata from the notification although it has failed. `undefined`: the
-     * default rules. DAM: a mass-edit row its batch load left out.
+     * `'load'`: the row may get metadata from the notification although it failed. `undefined`: default rules.
+     * DAM: a mass-edit row its batch load left out.
      */
     metadataGate?(queueKey: UploadQueueKey, row: UploadQueueItem): 'load' | undefined;
     hooks: {
@@ -131,24 +128,21 @@ export interface UploadSettlementProfile {
         onAssetRead?(asset: AssetDetailItemDto): void;
         /** A row with `settleOn: 'never'` has learnt its file is processed (an event, a tick or a manual read). */
         onProcessedSeen?(queueKey: UploadQueueKey, row: UploadQueueItem): void;
-        /** The row was given its metadata. */
         afterMetadataLoaded?(queueKey: UploadQueueKey, row: UploadQueueItem): void;
         /**
-         * Whether a refresh may still change a failed row, told whenever that changes. For a store that offers
-         * refresh on a failed row only where it can help.
-         *
-         * `true`: the row is asked about although the client gave it up (`track(…, { clientFailed: true })`), or its
-         * file is a duplicate whose original could not be read. `false`: the server has said what became of the file
-         * (processed, failed, a duplicate that was settled), its asset is gone from as many reads as it takes, or the
-         * store took the row out (`untrack`, `dropQueue`). A row never told `true` is never told `false`. Not called
-         * by `dispose()`.
+         * Whether a refresh may still change a failed row; called when
+         * that changes, for stores that offer refresh only where it helps.
+         * `true`: tracked despite `clientFailed: true`, or a duplicate whose original could not be read.
+         * `false`: the server settled the file, the asset was missing too
+         * often, or the store removed the row (`untrack`, `dropQueue`).
+         * Never `false` without a prior `true`. Not called by `dispose()`.
          */
         onRefreshMayHelp?(queueKey: UploadQueueKey, row: UploadQueueItem, mayHelp: boolean): void;
     };
     connection: {
         /**
-         * Whether notifications come for the rows of the queue `queueKey`: its poll is then only a backup. A profile
-         * that keeps one state for all its queues may leave the queue unread.
+         * Whether notifications arrive for the queue's rows; the poll is then
+         * only a backup. A profile with one shared state may ignore `queueKey`.
          */
         isPushAlive(queueKey?: UploadQueueKey): boolean;
         /** Called whenever that may have changed, for any queue. */
@@ -163,18 +157,17 @@ export interface UploadSettlementEvent {
     failReason?: AssetFileFailReasonType;
     originAssetFile?: DocIdNullable;
     assetType?: DamAssetTypeType | null;
-    /** The DAM configurations the event is of, as on `UploadSettlementTarget`. Left out: every queue. */
+    /** DAM configurations of the event, as on `UploadSettlementTarget`. Omitted: every queue. */
     configNames?: string[];
 }
 /**
- * `settled`: the main file is in a final state, or its asset was missing once too often and its rows were given
- * up. `pending`: not yet. And what asking again may mend: `error`, the read failed; `missing`, the asset was not
- * found; `originalUnread`, a row is left without the original of its duplicate, which could not be read.
+ * `settled`: the main file is final, or the asset was missing too often and its rows were given up. `pending`: not yet.
+ * Retryable: `error` (read failed), `missing` (asset not found),
+ * `originalUnread` (duplicate's original could not be read).
  */
 export type UploadRefreshOutcome = 'settled' | 'pending' | 'error' | 'missing' | 'originalUnread';
-/** What a store uses. */
 export interface UploadSettlement {
-    /** The row began to wait for the server. A row that is not in the queue `queueKey` is ignored. */
+    /** The row starts waiting for the server. Ignored if the row is not in `queueKey`. */
     track(queueKey: UploadQueueKey, row: UploadQueueItem, options?: {
         clientFailed?: boolean;
     }): void;
@@ -184,23 +177,20 @@ export interface UploadSettlement {
     /** A notification. Resolves after the write (a delayed read included) or after a failed read; never rejects. */
     notify(event: UploadSettlementEvent): Promise<void>;
     /**
-     * The manual refresh: a read at once, with the metadata, without a hint. With `configOf` of the profile, a
-     * configuration the target names whose queues have no row of the asset is not read (`settled`); of several, the
-     * outcome first of `error`, `originalUnread`, `missing`, `pending`, `settled` that any of their reads had.
+     * Manual refresh: an immediate read with metadata and no hint.
+     * With `configOf`, a named configuration with no row of the asset is not read (`settled`). With several,
+     * returns the first of `error`, `originalUnread`, `missing`, `pending`, `settled` any read had.
      */
     refreshAsset(target: UploadSettlementTarget): Promise<UploadRefreshOutcome>;
     /** The caller knows the file is processed: a read at once, with the hint `processed`. */
     settleKnownProcessed(target: UploadSettlementTarget, options: {
         withMetadata: boolean;
     }): Promise<void>;
-    /** A known duplicate without a read of the asset: the `duplicate` event, and a copy the licence already has. */
+    /** Settles a known duplicate without reading the asset: the `duplicate` event, or a copy the licence already has. */
     settleKnownDuplicate(target: UploadSettlementTarget, originFileId: DocIdNullable, assetType: DamAssetTypeType | null): Promise<void>;
     /** A known failure, without a read. Synchronous. */
     settleKnownFailed(target: UploadSettlementTarget, failReason: AssetFileFailReasonType): void;
-    /**
-     * The row failed by the read that was one too many to find no asset of it (the poll's, a notification's, a
-     * refresh's), and the server has settled it by nothing else since.
-     */
+    /** The row failed because too many reads found no asset, and the server has not settled it otherwise since. */
     isGivenUpMissing(row: UploadQueueItem): boolean;
     hasTracked(): boolean;
     dispose(): void;