@anzusystems/common-admin 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/domains/dam/uploadQueue/core/uploadQueueCoreTypes.d.ts

@@ -3,17 +3,20 @@ import { UploadQueue, UploadQueueItem, UploadQueueItemStatusType, UploadQueueKey
 import { uploadSide, UploadProgressCallback, UploadRun, UploadSide } from '../presets/uploadPresets';
 import { UploadRowRoleType, UploadSettlement, UploadSettlementProfile } from '../settlement/uploadSettlementTypes';
 export declare const uploadQueuePresetMembers: unique symbol;
-/** The settlement profile of a store (step 2). The core adds `queues` and, after `hooks.onRowFinal`, counts the queue and starts the next row. */
+/**
+ * Settlement profile of a store (step 2). The core adds `queues`, and
+ * after `hooks.onRowFinal` it counts the queue and starts the next row.
+ */
 export type UploadQueueSettlementProfile = Omit<UploadSettlementProfile, 'queues' | 'hooks'> & {
     hooks?: Partial<UploadSettlementProfile['hooks']>;
 };
-/** The queues of a store as the core reads and writes them, from the state of the store at that moment. */
+/** Queue access for the core, read from the store state at call time. */
 export interface UploadQueueContainer {
     get(queueKey: UploadQueueKey): UploadQueue | undefined;
     set(queueKey: UploadQueueKey, queue: UploadQueue): void;
     entries(): Iterable<[UploadQueueKey, UploadQueue]>;
 }
-/** What a failed run writes into its row, and the alert sent once the row is marked. */
+/** What a failed run writes into its row, and the alert sent after the row is marked. */
 export interface UploadQueueClientFailure {
     message: string;
     alert(): void;
@@ -21,7 +24,7 @@ export interface UploadQueueClientFailure {
 interface UploadQueuePresetMembers<S extends UploadSide> {
     queues: UploadQueueContainer;
     settlement: UploadQueueSettlementProfile;
-    /** What sends the row: an upload, or in admin-dam the import of a row of an external provider. */
+    /** Creates the row's run: an upload, or in admin-dam an external provider import. */
     runnerFor(item: UploadQueueItem, queueKey: UploadQueueKey): (item: UploadQueueItem, onProgress: UploadProgressCallback) => UploadRun<S>;
     /** Read before the core writes anything into the failed row. */
     onClientFailure?(queueKey: UploadQueueKey, item: UploadQueueItem, error: unknown): UploadQueueClientFailure;
@@ -45,7 +48,7 @@ export interface UploadQueueCore {
     getQueueProcessedCount(queueKey: UploadQueueKey): number;
     getQueueFileInputKey(queueKey: UploadQueueKey): number;
     getQueueItemsTypes(queueKey: UploadQueueKey): DamAssetTypeType[];
-    /** `prefix` and a number no other row of this page has. */
+    /** `prefix` plus a number unique on this page. */
     uniqueKey(prefix: string): string;
     createQueue(queueKey: UploadQueueKey): void;
     addQueueItem(queueKey: UploadQueueKey, item: UploadQueueItem): void;

package/dist/domains/dam/uploadQueue/core/uploadQueueCoreTypes.js

@@ -1,6 +1,5 @@
-//#region src/domains/dam/uploadQueue/core/uploadQueueCoreTypes.ts
+// src/domains/dam/uploadQueue/core/uploadQueueCoreTypes.ts
 var e = Symbol("uploadQueuePresetMembers");
-//#endregion
 export { e as uploadQueuePresetMembers };
 
 //# sourceMappingURL=uploadQueueCoreTypes.js.map

package/dist/domains/dam/uploadQueue/core/uploadQueueCoreTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadQueueCoreTypes.js","names":["uploadQueuePresetMembers"],"sources":["../../../../../src/domains/dam/uploadQueue/core/uploadQueueCoreTypes.ts"],"sourcesContent":["import type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type {\n  UploadQueue,\n  UploadQueueItem,\n  UploadQueueItemStatusType,\n  UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport type {\n  uploadSide,\n  UploadProgressCallback,\n  UploadRun,\n  UploadSide,\n} from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport type {\n  UploadRowRoleType,\n  UploadSettlement,\n  UploadSettlementProfile,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\n\n// Not exported from the library: only its own functions put the members on a set of the core.\nexport const uploadQueuePresetMembers = Symbol('uploadQueuePresetMembers')\n\n/** The settlement profile of a store (step 2). The core adds `queues` and, after `hooks.onRowFinal`, counts the queue and starts the next row. */\nexport type UploadQueueSettlementProfile = Omit<UploadSettlementProfile, 'queues' | 'hooks'> & {\n  hooks?: Partial<UploadSettlementProfile['hooks']>\n}\n\n/** The queues of a store as the core reads and writes them, from the state of the store at that moment. */\nexport interface UploadQueueContainer {\n  get(queueKey: UploadQueueKey): UploadQueue | undefined\n  set(queueKey: UploadQueueKey, queue: UploadQueue): void\n  entries(): Iterable<[UploadQueueKey, UploadQueue]>\n}\n\n/** What a failed run writes into its row, and the alert sent once the row is marked. */\nexport interface UploadQueueClientFailure {\n  message: string\n  alert(): void\n}\n\ninterface UploadQueuePresetMembers<S extends UploadSide> {\n  queues: UploadQueueContainer\n  settlement: UploadQueueSettlementProfile\n  /** What sends the row: an upload, or in admin-dam the import of a row of an external provider. */\n  runnerFor(\n    item: UploadQueueItem,\n    queueKey: UploadQueueKey\n  ): (item: UploadQueueItem, onProgress: UploadProgressCallback) => UploadRun<S>\n  /** Read before the core writes anything into the failed row. */\n  onClientFailure?(queueKey: UploadQueueKey, item: UploadQueueItem, error: unknown): UploadQueueClientFailure\n  rowTracked?(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  rowRemoved?(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** Whether the core keeps the failed rows a refresh may still change. */\n  refreshable: boolean\n}\n\n/** What a store hands its core. Made only by `libraryQueuePreset()` and `adminDamQueuePreset()`. */\nexport interface UploadQueuePreset<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  readonly [uploadQueuePresetMembers]: UploadQueuePresetMembers<S>\n}\n\nexport interface UploadQueueCore {\n  settlement: UploadSettlement\n  roleOf(item: UploadQueueItem): UploadRowRoleType\n\n  getQueue(queueKey: UploadQueueKey): UploadQueue | null\n  getQueueItems(queueKey: UploadQueueKey): UploadQueueItem[]\n  getQueueItemsByStatus(queueKey: UploadQueueKey, status: UploadQueueItemStatusType): UploadQueueItem[]\n  getQueueTotalCount(queueKey: UploadQueueKey): number\n  getQueueProcessedCount(queueKey: UploadQueueKey): number\n  getQueueFileInputKey(queueKey: UploadQueueKey): number\n  getQueueItemsTypes(queueKey: UploadQueueKey): DamAssetTypeType[]\n\n  /** `prefix` and a number no other row of this page has. */\n  uniqueKey(prefix: string): string\n  createQueue(queueKey: UploadQueueKey): void\n  addQueueItem(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** Makes the queue if need be, adds the row, counts, starts what may start. */\n  addRow(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  recalculateQueueCounts(queueKey: UploadQueueKey): void\n  setUploadSpeed(item: UploadQueueItem, progress: number, speed: number, estimate: number): void\n  forceReloadFileInput(queueKey: UploadQueueKey): void\n\n  processUpload(queueKey: UploadQueueKey): void\n  queueItemUploadStart(item: UploadQueueItem, queueKey: UploadQueueKey): Promise<void>\n  track(queueKey: UploadQueueKey, item: UploadQueueItem, options?: { clientFailed?: boolean }): void\n\n  removeByIndex(queueKey: UploadQueueKey, index: number): void\n  stopItemUpload(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  stopUpload(queueKey: UploadQueueKey): void\n  clearQueue(queueKey: UploadQueueKey): void\n\n  /** Whether a refresh may still change a failed row. Filled only with the library's preset. */\n  refreshMayHelp(item: UploadQueueItem): boolean\n}\n"],"mappings":";AAoBA,IAAaA,IAA2B,OAAO,0BAA0B"}
+{"version":3,"file":"uploadQueueCoreTypes.js","names":["uploadQueuePresetMembers"],"sources":["../../../../../src/domains/dam/uploadQueue/core/uploadQueueCoreTypes.ts"],"sourcesContent":["import type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type {\n  UploadQueue,\n  UploadQueueItem,\n  UploadQueueItemStatusType,\n  UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport type {\n  uploadSide,\n  UploadProgressCallback,\n  UploadRun,\n  UploadSide,\n} from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport type {\n  UploadRowRoleType,\n  UploadSettlement,\n  UploadSettlementProfile,\n} from '@/domains/dam/uploadQueue/settlement/uploadSettlementTypes'\n\n// Not exported from the library, so only its own functions can set these members.\nexport const uploadQueuePresetMembers = Symbol('uploadQueuePresetMembers')\n\n/**\n * Settlement profile of a store (step 2). The core adds `queues`, and\n * after `hooks.onRowFinal` it counts the queue and starts the next row.\n */\nexport type UploadQueueSettlementProfile = Omit<UploadSettlementProfile, 'queues' | 'hooks'> & {\n  hooks?: Partial<UploadSettlementProfile['hooks']>\n}\n\n/** Queue access for the core, read from the store state at call time. */\nexport interface UploadQueueContainer {\n  get(queueKey: UploadQueueKey): UploadQueue | undefined\n  set(queueKey: UploadQueueKey, queue: UploadQueue): void\n  entries(): Iterable<[UploadQueueKey, UploadQueue]>\n}\n\n/** What a failed run writes into its row, and the alert sent after the row is marked. */\nexport interface UploadQueueClientFailure {\n  message: string\n  alert(): void\n}\n\ninterface UploadQueuePresetMembers<S extends UploadSide> {\n  queues: UploadQueueContainer\n  settlement: UploadQueueSettlementProfile\n  /** Creates the row's run: an upload, or in admin-dam an external provider import. */\n  runnerFor(\n    item: UploadQueueItem,\n    queueKey: UploadQueueKey\n  ): (item: UploadQueueItem, onProgress: UploadProgressCallback) => UploadRun<S>\n  /** Read before the core writes anything into the failed row. */\n  onClientFailure?(queueKey: UploadQueueKey, item: UploadQueueItem, error: unknown): UploadQueueClientFailure\n  rowTracked?(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  rowRemoved?(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** Whether the core keeps the failed rows a refresh may still change. */\n  refreshable: boolean\n}\n\n/** What a store hands its core. Made only by `libraryQueuePreset()` and `adminDamQueuePreset()`. */\nexport interface UploadQueuePreset<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  readonly [uploadQueuePresetMembers]: UploadQueuePresetMembers<S>\n}\n\nexport interface UploadQueueCore {\n  settlement: UploadSettlement\n  roleOf(item: UploadQueueItem): UploadRowRoleType\n\n  getQueue(queueKey: UploadQueueKey): UploadQueue | null\n  getQueueItems(queueKey: UploadQueueKey): UploadQueueItem[]\n  getQueueItemsByStatus(queueKey: UploadQueueKey, status: UploadQueueItemStatusType): UploadQueueItem[]\n  getQueueTotalCount(queueKey: UploadQueueKey): number\n  getQueueProcessedCount(queueKey: UploadQueueKey): number\n  getQueueFileInputKey(queueKey: UploadQueueKey): number\n  getQueueItemsTypes(queueKey: UploadQueueKey): DamAssetTypeType[]\n\n  /** `prefix` plus a number unique on this page. */\n  uniqueKey(prefix: string): string\n  createQueue(queueKey: UploadQueueKey): void\n  addQueueItem(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** Makes the queue if need be, adds the row, counts, starts what may start. */\n  addRow(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  recalculateQueueCounts(queueKey: UploadQueueKey): void\n  setUploadSpeed(item: UploadQueueItem, progress: number, speed: number, estimate: number): void\n  forceReloadFileInput(queueKey: UploadQueueKey): void\n\n  processUpload(queueKey: UploadQueueKey): void\n  queueItemUploadStart(item: UploadQueueItem, queueKey: UploadQueueKey): Promise<void>\n  track(queueKey: UploadQueueKey, item: UploadQueueItem, options?: { clientFailed?: boolean }): void\n\n  removeByIndex(queueKey: UploadQueueKey, index: number): void\n  stopItemUpload(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  stopUpload(queueKey: UploadQueueKey): void\n  clearQueue(queueKey: UploadQueueKey): void\n\n  /** Whether a refresh may still change a failed row. Filled only with the library's preset. */\n  refreshMayHelp(item: UploadQueueItem): boolean\n}\n"],"mappings":";AAoBA,IAAaA,IAA2B,OAAO,0BAA0B"}

package/dist/domains/dam/uploadQueue/core/uploadQueueFill.d.ts

@@ -2,13 +2,13 @@ import { CustomDataValue } from '../../../customDataForm/types/CustomDataForm';
 import { DamAssetTypeType } from '../../types/Asset';
 import { UploadQueueItem } from '../../types/UploadQueue';
 import { DocId } from '../../../../shared/types/common';
-/** Only into the rows of the asset type of the field. */
+/** Fills only rows of the field's asset type. */
 export declare function fillCustomDataValue(items: UploadQueueItem[], data: {
     assetType: DamAssetTypeType;
     elementProperty: string;
     value: CustomDataValue;
 }, forceReplace?: boolean): void;
-/** `accepts`: the rows that may take them; without it, every row. */
+/** `accepts`: rows that may take them. Without it, every row. */
 export declare function fillKeywords(items: UploadQueueItem[], value: DocId[], forceReplace?: boolean, accepts?: (item: UploadQueueItem) => boolean): void;
-/** `accepts`: the rows that may take them; without it, every row. */
+/** `accepts`: rows that may take them. Without it, every row. */
 export declare function fillAuthors(items: UploadQueueItem[], value: DocId[], forceReplace?: boolean, accepts?: (item: UploadQueueItem) => boolean): void;

package/dist/domains/dam/uploadQueue/core/uploadQueueFill.js

@@ -1,5 +1,5 @@
 import { isArray as e, isNull as t, isUndefined as n } from "../../../../shared/utils/common.js";
-//#region src/domains/dam/uploadQueue/core/uploadQueueFill.ts
+// src/domains/dam/uploadQueue/core/uploadQueueFill.ts
 function r(r, i, a = !1) {
 	for (let o of r) {
 		if (o.assetType !== i.assetType) continue;
@@ -13,7 +13,6 @@ function i(e, t, r = !1, i) {
 function a(e, t, r = !1, i) {
 	for (let a of e) (!i || i(a)) && (r || n(a.authors) || a.authors.length === 0) && (a.authors = [...t]);
 }
-//#endregion
 export { a as fillAuthors, r as fillCustomDataValue, i as fillKeywords };
 
 //# sourceMappingURL=uploadQueueFill.js.map

package/dist/domains/dam/uploadQueue/core/uploadQueueFill.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadQueueFill.js","names":["fillCustomDataValue","item","items","data","current","empty","isUndefined","isNull","isArray","forceReplace","fillKeywords","accepts","value","fillAuthors"],"sources":["../../../../../src/domains/dam/uploadQueue/core/uploadQueueFill.ts"],"sourcesContent":["import type { CustomDataValue } from '@/domains/customDataForm/types/CustomDataForm'\nimport type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type { UploadQueueItem } from '@/domains/dam/types/UploadQueue'\nimport type { DocId } from '@/shared/types/common'\nimport { isArray, isNull, isUndefined } from '@/shared/utils/common'\n\n// The mass operations of an upload queue, over the rows they are given. They read only `assetType`, `customData`,\n// `keywords` and `authors` of a row. Public as `uploadQueueFillCustomDataValue`, `…Keywords`, `…Authors`.\n// Each filled row gets a list of its own (Z24): one list shared by the rows, and by the form it came from, would\n// change in all of them with an edit of any.\n\n/** Only into the rows of the asset type of the field. */\nexport function fillCustomDataValue(\n  items: UploadQueueItem[],\n  data: { assetType: DamAssetTypeType; elementProperty: string; value: CustomDataValue },\n  forceReplace = false\n) {\n  for (const item of items) {\n    if (item.assetType !== data.assetType) continue\n    const current = item.customData[data.elementProperty]\n    // `null` is how a value saved empty comes back; a field of several values is empty as an empty list.\n    const empty = isUndefined(current) || isNull(current) || current === '' || (isArray(current) && !current.length)\n    if (forceReplace || empty) {\n      item.customData[data.elementProperty] = isArray(data.value) ? data.value.slice() : data.value\n    }\n  }\n}\n\n/** `accepts`: the rows that may take them; without it, every row. */\nexport function fillKeywords(\n  items: UploadQueueItem[],\n  value: DocId[],\n  forceReplace = false,\n  accepts?: (item: UploadQueueItem) => boolean\n) {\n  for (const item of items) {\n    if (accepts && !accepts(item)) continue\n    if (forceReplace || isUndefined(item.keywords) || item.keywords.length === 0) {\n      item.keywords = [...value]\n    }\n  }\n}\n\n/** `accepts`: the rows that may take them; without it, every row. */\nexport function fillAuthors(\n  items: UploadQueueItem[],\n  value: DocId[],\n  forceReplace = false,\n  accepts?: (item: UploadQueueItem) => boolean\n) {\n  for (const item of items) {\n    if (accepts && !accepts(item)) continue\n    if (forceReplace || isUndefined(item.authors) || item.authors.length === 0) {\n      item.authors = [...value]\n    }\n  }\n}\n"],"mappings":";;AAYA,SAAgBA,EACd,GACA,GACA,IAAe,IACf;CACA,KAAK,IAAMC,KAAQC,GAAO;EACxB,IAAID,EAAK,cAAcE,EAAK,WAAW;EACvC,IAAMC,IAAUH,EAAK,WAAWE,EAAK,kBAE/BE,IAAQC,EAAYF,CAAO,KAAKG,EAAOH,CAAO,KAAKA,MAAY,MAAOI,EAAQJ,CAAO,KAAK,CAACA,EAAQ;EACzG,CAAIK,KAAgBJ,OAClB,EAAK,WAAWF,EAAK,mBAAmBK,EAAQL,EAAK,KAAK,IAAIA,EAAK,MAAM,MAAM,IAAIA,EAAK;CAE5F;AACF;AAGA,SAAgBO,EACd,GACA,GACA,IAAe,IACf,GACA;CACA,KAAK,IAAMT,KAAQC,GACjB,CAAI,MAAYS,EAAQV,CAAI,OACxBQ,KAAgBH,EAAYL,EAAK,QAAQ,KAAKA,EAAK,SAAS,WAAW,OACzE,EAAK,WAAW,CAAC,GAAGW,CAAK;AAG/B;AAGA,SAAgBC,EACd,GACA,GACA,IAAe,IACf,GACA;CACA,KAAK,IAAMZ,KAAQC,GACjB,CAAI,MAAYS,EAAQV,CAAI,OACxBQ,KAAgBH,EAAYL,EAAK,OAAO,KAAKA,EAAK,QAAQ,WAAW,OACvE,EAAK,UAAU,CAAC,GAAGW,CAAK;AAG9B"}
+{"version":3,"file":"uploadQueueFill.js","names":["fillCustomDataValue","item","items","data","current","empty","isUndefined","isNull","isArray","forceReplace","fillKeywords","accepts","value","fillAuthors"],"sources":["../../../../../src/domains/dam/uploadQueue/core/uploadQueueFill.ts"],"sourcesContent":["import type { CustomDataValue } from '@/domains/customDataForm/types/CustomDataForm'\nimport type { DamAssetTypeType } from '@/domains/dam/types/Asset'\nimport type { UploadQueueItem } from '@/domains/dam/types/UploadQueue'\nimport type { DocId } from '@/shared/types/common'\nimport { isArray, isNull, isUndefined } from '@/shared/utils/common'\n\n// Bulk operations of an upload queue over the given rows. They\n// read only `assetType`, `customData`, `keywords` and `authors`.\n// Public as `uploadQueueFillCustomDataValue`, `…Keywords`, `…Authors`.\n// Each filled row gets its own list (Z24). A list shared by rows\n// and the source form would change in all of them on any edit.\n\n/** Fills only rows of the field's asset type. */\nexport function fillCustomDataValue(\n  items: UploadQueueItem[],\n  data: { assetType: DamAssetTypeType; elementProperty: string; value: CustomDataValue },\n  forceReplace = false\n) {\n  for (const item of items) {\n    if (item.assetType !== data.assetType) continue\n    const current = item.customData[data.elementProperty]\n    // A value saved empty comes back as `null`. A multi-value field is empty as an empty list.\n    const empty = isUndefined(current) || isNull(current) || current === '' || (isArray(current) && !current.length)\n    if (forceReplace || empty) {\n      item.customData[data.elementProperty] = isArray(data.value) ? data.value.slice() : data.value\n    }\n  }\n}\n\n/** `accepts`: rows that may take them. Without it, every row. */\nexport function fillKeywords(\n  items: UploadQueueItem[],\n  value: DocId[],\n  forceReplace = false,\n  accepts?: (item: UploadQueueItem) => boolean\n) {\n  for (const item of items) {\n    if (accepts && !accepts(item)) continue\n    if (forceReplace || isUndefined(item.keywords) || item.keywords.length === 0) {\n      item.keywords = [...value]\n    }\n  }\n}\n\n/** `accepts`: rows that may take them. Without it, every row. */\nexport function fillAuthors(\n  items: UploadQueueItem[],\n  value: DocId[],\n  forceReplace = false,\n  accepts?: (item: UploadQueueItem) => boolean\n) {\n  for (const item of items) {\n    if (accepts && !accepts(item)) continue\n    if (forceReplace || isUndefined(item.authors) || item.authors.length === 0) {\n      item.authors = [...value]\n    }\n  }\n}\n"],"mappings":";;AAaA,SAAgBA,EACd,GACA,GACA,IAAe,IACf;CACA,KAAK,IAAMC,KAAQC,GAAO;EACxB,IAAID,EAAK,cAAcE,EAAK,WAAW;EACvC,IAAMC,IAAUH,EAAK,WAAWE,EAAK,kBAE/BE,IAAQC,EAAYF,CAAO,KAAKG,EAAOH,CAAO,KAAKA,MAAY,MAAOI,EAAQJ,CAAO,KAAK,CAACA,EAAQ;EACzG,CAAIK,KAAgBJ,OAClB,EAAK,WAAWF,EAAK,mBAAmBK,EAAQL,EAAK,KAAK,IAAIA,EAAK,MAAM,MAAM,IAAIA,EAAK;CAE5F;AACF;AAGA,SAAgBO,EACd,GACA,GACA,IAAe,IACf,GACA;CACA,KAAK,IAAMT,KAAQC,GACjB,CAAI,MAAYS,EAAQV,CAAI,OACxBQ,KAAgBH,EAAYL,EAAK,QAAQ,KAAKA,EAAK,SAAS,WAAW,OACzE,EAAK,WAAW,CAAC,GAAGW,CAAK;AAG/B;AAGA,SAAgBC,EACd,GACA,GACA,IAAe,IACf,GACA;CACA,KAAK,IAAMZ,KAAQC,GACjB,CAAI,MAAYS,EAAQV,CAAI,OACxBQ,KAAgBH,EAAYL,EAAK,OAAO,KAAKA,EAAK,QAAQ,WAAW,OACvE,EAAK,UAAU,CAAC,GAAGW,CAAK;AAG9B"}

package/dist/domains/dam/uploadQueue/factory/UploadQueueItemFactory.js

@@ -1,6 +1,6 @@
 import { DamAssetStatusDefault as e } from "../../types/Asset.js";
 import { AssetFileFailReasonDefault as t } from "../../types/AssetFile.js";
-//#region src/domains/dam/uploadQueue/factory/UploadQueueItemFactory.ts
+// src/domains/dam/uploadQueue/factory/UploadQueueItemFactory.ts
 function n() {
 	return { createDefault: (n, r, i, a, o, s) => ({
 		key: n,
@@ -47,7 +47,6 @@ function n() {
 		mainFileInternal: null
 	}) };
 }
-//#endregion
 export { n as useUploadQueueItemFactory };
 
 //# sourceMappingURL=UploadQueueItemFactory.js.map

package/dist/domains/dam/uploadQueue/presets/queuePresets.d.ts

@@ -2,14 +2,17 @@ import { Ref } from 'vue';
 import { UploadQueue, UploadQueueItem, UploadQueueKey } from '../../types/UploadQueue';
 import { UploadProgressCallback, UploadRun } from './uploadPresets';
 import { UploadQueuePreset, UploadQueueSettlementProfile } from '../core/uploadQueueCoreTypes';
-/** Not exported from `src/lib.ts`: only the library store uses it. Every row is uploaded, under the configuration of its queue. */
+/**
+ * Not exported from `src/lib.ts`. Only the library store uses
+ * it. Every row is uploaded under its queue's configuration.
+ */
 export declare function libraryQueuePreset(store: {
     queues: Ref<Map<UploadQueueKey, UploadQueue>>;
     settlement: UploadQueueSettlementProfile;
-    /** The DAM configuration the queue was made under, `default` for one the store does not know. */
+    /** DAM configuration the queue was created under, `default` for a queue the store does not know. */
     configOf(queueKey: UploadQueueKey): string;
 }): UploadQueuePreset<'library'>;
-/** admin-dam's queue: what it shows and does that the library does not. The store hands in what is its own. */
+/** admin-dam's queue behavior beyond the library. The store passes in its own parts. */
 export declare function adminDamQueuePreset(store: {
     queues: Ref<Record<UploadQueueKey, UploadQueue>>;
     settlement: UploadQueueSettlementProfile;
@@ -17,7 +20,7 @@ export declare function adminDamQueuePreset(store: {
     upload(item: UploadQueueItem, onProgress: UploadProgressCallback): UploadRun<'adminDam'>;
     /** The run of an `ExternalProviderAsset` row: `adminDamImportRun(externalProviderImport(item).importInit)`. */
     importRun(item: UploadQueueItem): UploadRun<'adminDam'>;
-    /** `resolveUploadErrorMessage`: the text of a failed upload. */
+    /** `resolveUploadErrorMessage`. */
     failureMessage(error: unknown): string;
     /** `showError` of the store's `useAlerts()`: one alert per reason. */
     alert(message: string): void;
@@ -26,5 +29,5 @@ export declare function adminDamQueuePreset(store: {
     /** `metadataFailures.delete(metadataFailureKey(queueKey, item))`. */
     rowRemoved(queueKey: UploadQueueKey, item: UploadQueueItem): void;
 }): UploadQueuePreset<'adminDam'>;
-/** The run of an import: its request is all there is; `upload` and `stop` do nothing, never `finishAttempted`. */
+/** Run of an import: only its request. `upload` and `stop` do nothing, and `finishAttempted` is always false. */
 export declare function adminDamImportRun(uploadInit: () => Promise<unknown>): UploadRun<'adminDam'>;

package/dist/domains/dam/uploadQueue/presets/queuePresets.js

@@ -1,8 +1,8 @@
 import { UploadQueueItemStatus as e, UploadQueueItemType as t } from "../../types/UploadQueue.js";
-import { uploadQueuePresetMembers as n } from "../core/uploadQueueCoreTypes.js";
+import { useUpload as n } from "../composables/uploadService.js";
 import { libraryUploadPreset as r, uploadSide as i } from "./uploadPresets.js";
-import { useUpload as a } from "../composables/uploadService.js";
-//#region src/domains/dam/uploadQueue/presets/queuePresets.ts
+import { uploadQueuePresetMembers as a } from "../core/uploadQueueCoreTypes.js";
+// src/domains/dam/uploadQueue/presets/queuePresets.ts
 var o = (e) => ({
 	get: (t) => e.value.get(t),
 	set: (t, n) => {
@@ -19,33 +19,33 @@ var o = (e) => ({
 function c(e) {
 	return {
 		[i]: "library",
-		[n]: {
+		[a]: {
 			queues: o(e.queues),
 			settlement: e.settlement,
-			runnerFor: (t, n) => (t, i) => a(t, i, r(e.configOf(n))),
+			runnerFor: (t, i) => (t, a) => n(t, a, r(e.configOf(i))),
 			refreshable: !0
 		}
 	};
 }
-function l(r) {
-	let a = s(r.queues);
+function l(n) {
+	let r = s(n.queues);
 	return {
 		[i]: "adminDam",
-		[n]: {
-			queues: a,
-			settlement: r.settlement,
-			runnerFor: (e) => e.type === t.ExternalProviderAsset ? (e) => r.importRun(e) : (e, t) => r.upload(e, t),
-			onClientFailure: (t, n, i) => {
-				let o = r.failureMessage(i), s = (a.get(t)?.items ?? []).some((t) => t.status === e.Failed && t.error.message === o);
+		[a]: {
+			queues: r,
+			settlement: n.settlement,
+			runnerFor: (e) => e.type === t.ExternalProviderAsset ? (e) => n.importRun(e) : (e, t) => n.upload(e, t),
+			onClientFailure: (t, i, a) => {
+				let o = n.failureMessage(a), s = (r.get(t)?.items ?? []).some((t) => t.status === e.Failed && t.error.message === o);
 				return {
 					message: o,
 					alert: () => {
-						s || r.alert(o);
+						s || n.alert(o);
 					}
 				};
 			},
-			rowTracked: (e, t) => r.rowTracked(e, t),
-			rowRemoved: (e, t) => r.rowRemoved(e, t),
+			rowTracked: (e, t) => n.rowTracked(e, t),
+			rowRemoved: (e, t) => n.rowRemoved(e, t),
 			refreshable: !1
 		}
 	};
@@ -59,7 +59,6 @@ function u(e) {
 		finishAttempted: () => !1
 	};
 }
-//#endregion
 export { u as adminDamImportRun, l as adminDamQueuePreset, c as libraryQueuePreset };
 
 //# sourceMappingURL=queuePresets.js.map

package/dist/domains/dam/uploadQueue/presets/queuePresets.js.map

@@ -1 +1 @@
-{"version":3,"file":"queuePresets.js","names":["mapQueues","queues","queueKey","queue","objectQueues","libraryQueuePreset","uploadSide","uploadQueuePresetMembers","store","useUpload","item","onProgress","libraryUploadPreset","adminDamQueuePreset","UploadQueueItemType","row","message","error","alreadyReported","failedItem","UploadQueueItemStatus","adminDamImportRun"],"sources":["../../../../../src/domains/dam/uploadQueue/presets/queuePresets.ts"],"sourcesContent":["import type { Ref } from 'vue'\nimport {\n  type UploadQueue,\n  type UploadQueueItem,\n  UploadQueueItemStatus,\n  UploadQueueItemType,\n  type UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport { useUpload } from '@/domains/dam/uploadQueue/composables/uploadService'\nimport {\n  libraryUploadPreset,\n  type UploadProgressCallback,\n  type UploadRun,\n  uploadSide,\n} from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport {\n  type UploadQueueContainer,\n  type UploadQueuePreset,\n  uploadQueuePresetMembers,\n  type UploadQueueSettlementProfile,\n} from '@/domains/dam/uploadQueue/core/uploadQueueCoreTypes'\n\nconst mapQueues = (queues: Ref<Map<UploadQueueKey, UploadQueue>>): UploadQueueContainer => ({\n  get: (queueKey) => queues.value.get(queueKey),\n  set: (queueKey, queue) => {\n    queues.value.set(queueKey, queue)\n  },\n  entries: () => queues.value.entries(),\n})\n\n// By `in`, as the store has always looked: a key named after a member of `Object.prototype` finds that member.\nconst objectQueues = (queues: Ref<Record<UploadQueueKey, UploadQueue>>): UploadQueueContainer => ({\n  get: (queueKey) => (queueKey in queues.value ? queues.value[queueKey] : undefined),\n  set: (queueKey, queue) => {\n    queues.value[queueKey] = queue\n  },\n  entries: () => Object.entries(queues.value),\n})\n\n/** Not exported from `src/lib.ts`: only the library store uses it. Every row is uploaded, under the configuration of its queue. */\nexport function libraryQueuePreset(store: {\n  queues: Ref<Map<UploadQueueKey, UploadQueue>>\n  settlement: UploadQueueSettlementProfile\n  /** The DAM configuration the queue was made under, `default` for one the store does not know. */\n  configOf(queueKey: UploadQueueKey): string\n}): UploadQueuePreset<'library'> {\n  return {\n    [uploadSide]: 'library',\n    [uploadQueuePresetMembers]: {\n      queues: mapQueues(store.queues),\n      settlement: store.settlement,\n      runnerFor: (_item, queueKey) => (item, onProgress) =>\n        useUpload(item, onProgress, libraryUploadPreset(store.configOf(queueKey))),\n      refreshable: true,\n    },\n  }\n}\n\n/** admin-dam's queue: what it shows and does that the library does not. The store hands in what is its own. */\nexport function adminDamQueuePreset(store: {\n  queues: Ref<Record<UploadQueueKey, UploadQueue>>\n  settlement: UploadQueueSettlementProfile\n  /** `useUpload` of admin-dam's `uploadService.ts`. */\n  upload(item: UploadQueueItem, onProgress: UploadProgressCallback): UploadRun<'adminDam'>\n  /** The run of an `ExternalProviderAsset` row: `adminDamImportRun(externalProviderImport(item).importInit)`. */\n  importRun(item: UploadQueueItem): UploadRun<'adminDam'>\n  /** `resolveUploadErrorMessage`: the text of a failed upload. */\n  failureMessage(error: unknown): string\n  /** `showError` of the store's `useAlerts()`: one alert per reason. */\n  alert(message: string): void\n  /** `handedOver.add(toRaw(item))`. */\n  rowTracked(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** `metadataFailures.delete(metadataFailureKey(queueKey, item))`. */\n  rowRemoved(queueKey: UploadQueueKey, item: UploadQueueItem): void\n}): UploadQueuePreset<'adminDam'> {\n  const queues = objectQueues(store.queues)\n  return {\n    [uploadSide]: 'adminDam',\n    [uploadQueuePresetMembers]: {\n      queues,\n      settlement: store.settlement,\n      runnerFor: (item) =>\n        item.type === UploadQueueItemType.ExternalProviderAsset\n          ? (row) => store.importRun(row)\n          : (row, onProgress) => store.upload(row, onProgress),\n      onClientFailure: (queueKey, _item, error) => {\n        const message = store.failureMessage(error)\n        // One alert per reason: a licence that refuses uploads fails every file in the batch.\n        const alreadyReported = (queues.get(queueKey)?.items ?? []).some(\n          (failedItem) => failedItem.status === UploadQueueItemStatus.Failed && failedItem.error.message === message\n        )\n        return {\n          message,\n          alert: () => {\n            if (!alreadyReported) store.alert(message)\n          },\n        }\n      },\n      rowTracked: (queueKey, item) => store.rowTracked(queueKey, item),\n      rowRemoved: (queueKey, item) => store.rowRemoved(queueKey, item),\n      refreshable: false,\n    },\n  }\n}\n\n/** The run of an import: its request is all there is; `upload` and `stop` do nothing, never `finishAttempted`. */\nexport function adminDamImportRun(uploadInit: () => Promise<unknown>): UploadRun<'adminDam'> {\n  return {\n    [uploadSide]: 'adminDam',\n    uploadInit,\n    upload: () => Promise.resolve(),\n    stop: () => {},\n    finishAttempted: () => false,\n  }\n}\n"],"mappings":";;;;;AAsBA,IAAMA,KAAa,OAAyE;CAC1F,MAAM,MAAaC,EAAO,MAAM,IAAIC,CAAQ;CAC5C,MAAM,GAAU,MAAU;EACxB,EAAO,MAAM,IAAIA,GAAUC,CAAK;CAClC;CACA,eAAeF,EAAO,MAAM,QAAQ;AACtC,IAGMG,KAAgB,OAA4E;CAChG,MAAM,MAAcF,KAAYD,EAAO,QAAQA,EAAO,MAAMC,KAAY,KAAA;CACxE,MAAM,GAAU,MAAU;EACxB,EAAO,MAAMA,KAAYC;CAC3B;CACA,eAAe,OAAO,QAAQF,EAAO,KAAK;AAC5C;AAGA,SAAgBI,EAAmB,GAKF;CAC/B,OAAO;GACJC,IAAa;GACbC,IAA2B;GAC1B,QAAQP,EAAUQ,EAAM,MAAM;GAC9B,YAAYA,EAAM;GAClB,YAAY,GAAO,OAAc,GAAM,MACrCC,EAAUC,GAAMC,GAAYC,EAAoBJ,EAAM,SAASN,CAAQ,CAAC,CAAC;GAC3E,aAAa;EACf;CACF;AACF;AAGA,SAAgBW,EAAoB,GAeF;CAChC,IAAMZ,IAASG,EAAaI,EAAM,MAAM;CACxC,OAAO;GACJF,IAAa;GACbC,IAA2B;GAC1B;GACA,YAAYC,EAAM;GAClB,YAAY,MACVE,EAAK,SAASI,EAAoB,yBAC7B,MAAQN,EAAM,UAAUO,CAAG,KAC3B,GAAK,MAAeP,EAAM,OAAOO,GAAKJ,CAAU;GACvD,kBAAkB,GAAU,GAAO,MAAU;IAC3C,IAAMK,IAAUR,EAAM,eAAeS,CAAK,GAEpCC,KAAmBjB,EAAO,IAAIC,CAAQ,CAAC,EAAE,SAAS,CAAC,EAAA,CAAG,MACzD,MAAeiB,EAAW,WAAWC,EAAsB,UAAUD,EAAW,MAAM,YAAYH,CACrG;IACA,OAAO;KACL;KACA,aAAa;MACX,AAAKE,KAAiBV,EAAM,MAAMQ,CAAO;KAC3C;IACF;GACF;GACA,aAAa,GAAU,MAASR,EAAM,WAAWN,GAAUQ,CAAI;GAC/D,aAAa,GAAU,MAASF,EAAM,WAAWN,GAAUQ,CAAI;GAC/D,aAAa;EACf;CACF;AACF;AAGA,SAAgBW,EAAkB,GAA2D;CAC3F,OAAO;GACJf,IAAa;EACd;EACA,cAAc,QAAQ,QAAQ;EAC9B,YAAY,CAAC;EACb,uBAAuB;CACzB;AACF"}
+{"version":3,"file":"queuePresets.js","names":["mapQueues","queues","queueKey","queue","objectQueues","libraryQueuePreset","uploadSide","uploadQueuePresetMembers","store","useUpload","item","onProgress","libraryUploadPreset","adminDamQueuePreset","UploadQueueItemType","row","message","error","alreadyReported","failedItem","UploadQueueItemStatus","adminDamImportRun"],"sources":["../../../../../src/domains/dam/uploadQueue/presets/queuePresets.ts"],"sourcesContent":["import type { Ref } from 'vue'\nimport {\n  type UploadQueue,\n  type UploadQueueItem,\n  UploadQueueItemStatus,\n  UploadQueueItemType,\n  type UploadQueueKey,\n} from '@/domains/dam/types/UploadQueue'\nimport { useUpload } from '@/domains/dam/uploadQueue/composables/uploadService'\nimport {\n  libraryUploadPreset,\n  type UploadProgressCallback,\n  type UploadRun,\n  uploadSide,\n} from '@/domains/dam/uploadQueue/presets/uploadPresets'\nimport {\n  type UploadQueueContainer,\n  type UploadQueuePreset,\n  uploadQueuePresetMembers,\n  type UploadQueueSettlementProfile,\n} from '@/domains/dam/uploadQueue/core/uploadQueueCoreTypes'\n\nconst mapQueues = (queues: Ref<Map<UploadQueueKey, UploadQueue>>): UploadQueueContainer => ({\n  get: (queueKey) => queues.value.get(queueKey),\n  set: (queueKey, queue) => {\n    queues.value.set(queueKey, queue)\n  },\n  entries: () => queues.value.entries(),\n})\n\n// Uses `in` as the store always did, so a key named after an `Object.prototype` member finds that member.\nconst objectQueues = (queues: Ref<Record<UploadQueueKey, UploadQueue>>): UploadQueueContainer => ({\n  get: (queueKey) => (queueKey in queues.value ? queues.value[queueKey] : undefined),\n  set: (queueKey, queue) => {\n    queues.value[queueKey] = queue\n  },\n  entries: () => Object.entries(queues.value),\n})\n\n/**\n * Not exported from `src/lib.ts`. Only the library store uses\n * it. Every row is uploaded under its queue's configuration.\n */\nexport function libraryQueuePreset(store: {\n  queues: Ref<Map<UploadQueueKey, UploadQueue>>\n  settlement: UploadQueueSettlementProfile\n  /** DAM configuration the queue was created under, `default` for a queue the store does not know. */\n  configOf(queueKey: UploadQueueKey): string\n}): UploadQueuePreset<'library'> {\n  return {\n    [uploadSide]: 'library',\n    [uploadQueuePresetMembers]: {\n      queues: mapQueues(store.queues),\n      settlement: store.settlement,\n      runnerFor: (_item, queueKey) => (item, onProgress) =>\n        useUpload(item, onProgress, libraryUploadPreset(store.configOf(queueKey))),\n      refreshable: true,\n    },\n  }\n}\n\n/** admin-dam's queue behavior beyond the library. The store passes in its own parts. */\nexport function adminDamQueuePreset(store: {\n  queues: Ref<Record<UploadQueueKey, UploadQueue>>\n  settlement: UploadQueueSettlementProfile\n  /** `useUpload` of admin-dam's `uploadService.ts`. */\n  upload(item: UploadQueueItem, onProgress: UploadProgressCallback): UploadRun<'adminDam'>\n  /** The run of an `ExternalProviderAsset` row: `adminDamImportRun(externalProviderImport(item).importInit)`. */\n  importRun(item: UploadQueueItem): UploadRun<'adminDam'>\n  /** `resolveUploadErrorMessage`. */\n  failureMessage(error: unknown): string\n  /** `showError` of the store's `useAlerts()`: one alert per reason. */\n  alert(message: string): void\n  /** `handedOver.add(toRaw(item))`. */\n  rowTracked(queueKey: UploadQueueKey, item: UploadQueueItem): void\n  /** `metadataFailures.delete(metadataFailureKey(queueKey, item))`. */\n  rowRemoved(queueKey: UploadQueueKey, item: UploadQueueItem): void\n}): UploadQueuePreset<'adminDam'> {\n  const queues = objectQueues(store.queues)\n  return {\n    [uploadSide]: 'adminDam',\n    [uploadQueuePresetMembers]: {\n      queues,\n      settlement: store.settlement,\n      runnerFor: (item) =>\n        item.type === UploadQueueItemType.ExternalProviderAsset\n          ? (row) => store.importRun(row)\n          : (row, onProgress) => store.upload(row, onProgress),\n      onClientFailure: (queueKey, _item, error) => {\n        const message = store.failureMessage(error)\n        // One alert per reason: a licence that refuses uploads fails every file in the batch.\n        const alreadyReported = (queues.get(queueKey)?.items ?? []).some(\n          (failedItem) => failedItem.status === UploadQueueItemStatus.Failed && failedItem.error.message === message\n        )\n        return {\n          message,\n          alert: () => {\n            if (!alreadyReported) store.alert(message)\n          },\n        }\n      },\n      rowTracked: (queueKey, item) => store.rowTracked(queueKey, item),\n      rowRemoved: (queueKey, item) => store.rowRemoved(queueKey, item),\n      refreshable: false,\n    },\n  }\n}\n\n/** Run of an import: only its request. `upload` and `stop` do nothing, and `finishAttempted` is always false. */\nexport function adminDamImportRun(uploadInit: () => Promise<unknown>): UploadRun<'adminDam'> {\n  return {\n    [uploadSide]: 'adminDam',\n    uploadInit,\n    upload: () => Promise.resolve(),\n    stop: () => {},\n    finishAttempted: () => false,\n  }\n}\n"],"mappings":";;;;;AAsBA,IAAMA,KAAa,OAAyE;CAC1F,MAAM,MAAaC,EAAO,MAAM,IAAIC,CAAQ;CAC5C,MAAM,GAAU,MAAU;EACxB,EAAO,MAAM,IAAIA,GAAUC,CAAK;CAClC;CACA,eAAeF,EAAO,MAAM,QAAQ;AACtC,IAGMG,KAAgB,OAA4E;CAChG,MAAM,MAAcF,KAAYD,EAAO,QAAQA,EAAO,MAAMC,KAAY,KAAA;CACxE,MAAM,GAAU,MAAU;EACxB,EAAO,MAAMA,KAAYC;CAC3B;CACA,eAAe,OAAO,QAAQF,EAAO,KAAK;AAC5C;AAMA,SAAgBI,EAAmB,GAKF;CAC/B,OAAO;GACJC,IAAa;GACbC,IAA2B;GAC1B,QAAQP,EAAUQ,EAAM,MAAM;GAC9B,YAAYA,EAAM;GAClB,YAAY,GAAO,OAAc,GAAM,MACrCC,EAAUC,GAAMC,GAAYC,EAAoBJ,EAAM,SAASN,CAAQ,CAAC,CAAC;GAC3E,aAAa;EACf;CACF;AACF;AAGA,SAAgBW,EAAoB,GAeF;CAChC,IAAMZ,IAASG,EAAaI,EAAM,MAAM;CACxC,OAAO;GACJF,IAAa;GACbC,IAA2B;GAC1B;GACA,YAAYC,EAAM;GAClB,YAAY,MACVE,EAAK,SAASI,EAAoB,yBAC7B,MAAQN,EAAM,UAAUO,CAAG,KAC3B,GAAK,MAAeP,EAAM,OAAOO,GAAKJ,CAAU;GACvD,kBAAkB,GAAU,GAAO,MAAU;IAC3C,IAAMK,IAAUR,EAAM,eAAeS,CAAK,GAEpCC,KAAmBjB,EAAO,IAAIC,CAAQ,CAAC,EAAE,SAAS,CAAC,EAAA,CAAG,MACzD,MAAeiB,EAAW,WAAWC,EAAsB,UAAUD,EAAW,MAAM,YAAYH,CACrG;IACA,OAAO;KACL;KACA,aAAa;MACX,AAAKE,KAAiBV,EAAM,MAAMQ,CAAO;KAC3C;IACF;GACF;GACA,aAAa,GAAU,MAASR,EAAM,WAAWN,GAAUQ,CAAI;GAC/D,aAAa,GAAU,MAASF,EAAM,WAAWN,GAAUQ,CAAI;GAC/D,aAAa;EACf;CACF;AACF;AAGA,SAAgBW,EAAkB,GAA2D;CAC3F,OAAO;GACJf,IAAa;EACd;EACA,cAAc,QAAQ,QAAQ;EAC9B,YAAY,CAAC;EACb,uBAAuB;CACzB;AACF"}

package/dist/domains/dam/uploadQueue/presets/uploadPresets.d.ts

@@ -4,20 +4,19 @@ import { DocId } from '../../../../shared/types/common';
 export type UploadSide = 'library' | 'adminDam';
 export declare const uploadSide: unique symbol;
 export declare const uploadPresetMembers: unique symbol;
-/** What a run asks the server. */
 export interface UploadRunRequests {
     start(item: UploadQueueItem): Promise<DamUploadStartResponse>;
     chunk(item: UploadQueueItem, fileId: DocId, chunk: File, size: number, offset: number, onUploadProgress: (event: AxiosProgressEvent) => void): Promise<unknown>;
     finish(item: UploadQueueItem, sha: string): Promise<unknown>;
 }
-/** The texts a run writes into its row. Each side keeps its own. */
+/** Texts a run writes into its row. Each side has its own. */
 export interface UploadMessages {
     unknownError(): string;
-    /** A field the server refused, by its name. */
+    /** Text for a field the server refused, by field name. */
     size(): string;
     offset(): string;
     mimeType(): string;
-    /** Put before the name of a refused field there is no text for. */
+    /** Prefix for a refused field that has no text of its own. */
     systemError(): string;
     /** HTTP 400 on the last try of a chunk. */
     chunkValidationFailed(): string;
@@ -31,12 +30,15 @@ interface UploadPresetMembers {
     messages: UploadMessages;
     apiTimeout: number | null | undefined;
     loadHash(): Promise<UploadHash>;
-    /** Whether a file of no bytes is started and finished, or refused before anything is asked. */
+    /** Whether an empty file is started and finished, or refused before any request. */
     emptyFile: 'send' | 'reject';
-    /** The DAM configuration whose prv configuration bounds the chunks, and whose last chunk size the upload starts from. */
+    /** DAM configuration whose prv configuration bounds the chunks and whose last chunk size the upload starts from. */
     configName: string;
 }
-/** How one side uploads. Made only by `libraryUploadPreset()` and `adminDamUploadPreset()`; what it holds is not public. */
+/**
+ * How one side uploads. Created only by `libraryUploadPreset()`
+ * and `adminDamUploadPreset()`. Its contents are not public.
+ */
 export interface UploadPreset<S extends UploadSide = UploadSide> {
     readonly [uploadSide]: S;
     readonly [uploadPresetMembers]: UploadPresetMembers;
@@ -46,21 +48,21 @@ export interface UploadRun<S extends UploadSide = UploadSide> {
     readonly [uploadSide]: S;
     uploadInit(): Promise<unknown>;
     upload(): Promise<unknown>;
-    /** Stops the run wherever it is, and cancels the chunk on the wire. */
+    /** Stops the run wherever it is and cancels the chunk in flight. */
     stop(): void;
-    /** Whether the finish request went out: the server may complete the file whatever became of the answer. */
+    /** Whether the finish request was sent. The server may complete the file whatever the response. */
     finishAttempted(): boolean;
 }
 /**
- * Not exported from `src/lib.ts`; the default of `useUpload` (under `default`). The library's API, texts and choices,
- * under the DAM configuration `configName`.
+ * Not exported from `src/lib.ts`. Default of `useUpload` (under `default`).
+ * The library's API, texts and choices under DAM configuration `configName`.
  */
 export declare function libraryUploadPreset(configName: string): UploadPreset<'library'>;
-/** admin-dam's API, texts and choices. What is the application's own, the application hands in. */
+/** admin-dam's API, texts and choices. The application passes in its own parts. */
 export declare function adminDamUploadPreset(app: {
     /** `uploadStart`, `uploadChunk`, `uploadFinish` of `fileApi.ts`: four asset types, admin-dam's addresses. */
     requests: UploadRunRequests;
-    /** `system.uploadErrors.*`; as `chunkValidationFailed` its `unknownError`, which its store writes today. */
+    /** `system.uploadErrors.*`. `chunkValidationFailed` uses its `unknownError`, which its store writes today. */
     messages: UploadMessages;
     /** `envConfig.dam.apiTimeout`. */
     apiTimeout: number | null | undefined;

package/dist/domains/dam/uploadQueue/presets/uploadPresets.js

@@ -1,19 +1,19 @@
 import { __toESM as e } from "../../../../_virtual/_rolldown/runtime.js";
 import { commonT as t } from "../../../../plugins/i18n.js";
-import { useCommonAdminCoreDamOptions as n } from "../../composables/commonAdminCoreDamOptions.js";
-import { withTimeout as r } from "../../../listEditor/utils/listEditorLoader.js";
-import { damUploadChunk as i, damUploadFinish as a, damUploadStart as o } from "../../api/uploadApi.js";
-//#region src/domains/dam/uploadQueue/presets/uploadPresets.ts
+import { damUploadChunk as n, damUploadFinish as r, damUploadStart as i } from "../../api/uploadApi.js";
+import { useCommonAdminCoreDamOptions as a } from "../../composables/commonAdminCoreDamOptions.js";
+import { withTimeout as o } from "../../../listEditor/utils/listEditorLoader.js";
+// src/domains/dam/uploadQueue/presets/uploadPresets.ts
 var s = 15e3, c = Symbol("uploadSide"), l = Symbol("uploadPresetMembers");
 function u(u) {
-	let { damClient: d, endPointImage: f, apiTimeout: p } = n(u);
+	let { damClient: d, endPointImage: f, apiTimeout: p } = a(u);
 	return {
 		[c]: "library",
 		[l]: {
 			requests: {
-				start: (e) => o(d, f, e),
-				chunk: (e, t, n, r, a, o) => i(d, f, e, t, n, r, a, o),
-				finish: (e, t) => a(d, f, e, t)
+				start: (e) => i(d, f, e),
+				chunk: (e, t, r, i, a, o) => n(d, f, e, t, r, i, a, o),
+				finish: (e, t) => r(d, f, e, t)
 			},
 			messages: {
 				unknownError: () => t("common.damImage.uploadErrors.unknownError"),
@@ -24,7 +24,7 @@ function u(u) {
 				chunkValidationFailed: () => t("common.damImage.uploadErrors.chunkValidationFailed")
 			},
 			apiTimeout: p,
-			loadHash: () => r(import("../../../../vendor/rusha/dist/rusha.js").then((t) => /* @__PURE__ */ e(t.default)), s, `rusha did not load within ${s} ms.`).then((e) => e.default.createHash()),
+			loadHash: () => o(import("../../../../vendor/rusha/dist/rusha.js").then((t) => /* @__PURE__ */ e(t.default)), s, `rusha did not load within ${s} ms.`).then((e) => e.default.createHash()),
 			emptyFile: "reject",
 			configName: u
 		}
@@ -43,7 +43,6 @@ function d(e) {
 		}
 	};
 }
-//#endregion
 export { d as adminDamUploadPreset, u as libraryUploadPreset, l as uploadPresetMembers, c as uploadSide };
 
 //# sourceMappingURL=uploadPresets.js.map

package/dist/domains/dam/uploadQueue/presets/uploadPresets.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploadPresets.js","names":["HASH_LOAD_TIMEOUT","uploadSide","uploadPresetMembers","libraryUploadPreset","useCommonAdminCoreDamOptions","configName","damUploadStart","damClient","endPointImage","item","damUploadChunk","fileId","chunk","size","offset","onUploadProgress","damUploadFinish","sha","commonT","withTimeout","m","rusha","adminDamUploadPreset","app"],"sources":["../../../../../src/domains/dam/uploadQueue/presets/uploadPresets.ts"],"sourcesContent":["import type { AxiosProgressEvent } from 'axios'\nimport { commonT } from '@/plugins/i18n'\nimport type { DamUploadStartResponse, UploadQueueItem } from '@/domains/dam/types/UploadQueue'\nimport type { DocId } from '@/shared/types/common'\nimport { damUploadChunk, damUploadFinish, damUploadStart } from '@/domains/dam/api/uploadApi'\nimport { useCommonAdminCoreDamOptions } from '@/domains/dam/composables/commonAdminCoreDamOptions'\nimport { withTimeout } from '@/domains/listEditor/utils/listEditorLoader'\n\nconst HASH_LOAD_TIMEOUT = 15_000\n\nexport type UploadSide = 'library' | 'adminDam'\n// Not exported from the library: only its own functions put them on a set or a run. Nothing reads the side at\n// runtime; a set holds its members under the other one.\nexport const uploadSide = Symbol('uploadSide')\nexport const uploadPresetMembers = Symbol('uploadPresetMembers')\n\n/** What a run asks the server. */\nexport interface UploadRunRequests {\n  start(item: UploadQueueItem): Promise<DamUploadStartResponse>\n  chunk(\n    item: UploadQueueItem,\n    fileId: DocId,\n    chunk: File,\n    size: number,\n    offset: number,\n    onUploadProgress: (event: AxiosProgressEvent) => void\n  ): Promise<unknown>\n  finish(item: UploadQueueItem, sha: string): Promise<unknown>\n}\n\n/** The texts a run writes into its row. Each side keeps its own. */\nexport interface UploadMessages {\n  unknownError(): string\n  /** A field the server refused, by its name. */\n  size(): string\n  offset(): string\n  mimeType(): string\n  /** Put before the name of a refused field there is no text for. */\n  systemError(): string\n  /** HTTP 400 on the last try of a chunk. */\n  chunkValidationFailed(): string\n}\n\nexport interface UploadHash {\n  update(data: ArrayBuffer): unknown\n  digest(encoding: 'hex'): string\n}\n\ninterface UploadPresetMembers {\n  requests: UploadRunRequests\n  messages: UploadMessages\n  apiTimeout: number | null | undefined\n  loadHash(): Promise<UploadHash>\n  /** Whether a file of no bytes is started and finished, or refused before anything is asked. */\n  emptyFile: 'send' | 'reject'\n  /** The DAM configuration whose prv configuration bounds the chunks, and whose last chunk size the upload starts from. */\n  configName: string\n}\n\n/** How one side uploads. Made only by `libraryUploadPreset()` and `adminDamUploadPreset()`; what it holds is not public. */\nexport interface UploadPreset<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  readonly [uploadPresetMembers]: UploadPresetMembers\n}\n\nexport type UploadProgressCallback = (progress: number, speed: number, estimate: number) => void\n\nexport interface UploadRun<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  uploadInit(): Promise<unknown>\n  upload(): Promise<unknown>\n  /** Stops the run wherever it is, and cancels the chunk on the wire. */\n  stop(): void\n  /** Whether the finish request went out: the server may complete the file whatever became of the answer. */\n  finishAttempted(): boolean\n}\n\n/**\n * Not exported from `src/lib.ts`; the default of `useUpload` (under `default`). The library's API, texts and choices,\n * under the DAM configuration `configName`.\n */\nexport function libraryUploadPreset(configName: string): UploadPreset<'library'> {\n  // A chunk is sized against the timeout the application gives the DAM requests of the configuration, else its root\n  // one. One that gives none (`null` in a config file too) gets the default of the composable.\n  const { damClient, endPointImage, apiTimeout } = useCommonAdminCoreDamOptions(configName)\n\n  return {\n    [uploadSide]: 'library',\n    [uploadPresetMembers]: {\n      requests: {\n        start: (item) => damUploadStart(damClient, endPointImage, item),\n        chunk: (item, fileId, chunk, size, offset, onUploadProgress) =>\n          damUploadChunk(damClient, endPointImage, item, fileId, chunk, size, offset, onUploadProgress),\n        finish: (item, sha) => damUploadFinish(damClient, endPointImage, item, sha),\n      },\n      messages: {\n        unknownError: () => commonT('common.damImage.uploadErrors.unknownError'),\n        size: () => commonT('common.damImage.uploadErrors.size'),\n        offset: () => commonT('common.damImage.uploadErrors.offset'),\n        mimeType: () => commonT('common.damImage.uploadErrors.mimeType'),\n        systemError: () => commonT('common.damImage.uploadErrors.systemError'),\n        chunkValidationFailed: () => commonT('common.damImage.uploadErrors.chunkValidationFailed'),\n      },\n      apiTimeout,\n      // rusha is loaded when a file starts uploading, not with every page that shows the upload queue, and\n      // before the asset is created: a chunk that does not arrive fails the item without an empty asset.\n      loadHash: () =>\n        withTimeout(import('rusha'), HASH_LOAD_TIMEOUT, `rusha did not load within ${HASH_LOAD_TIMEOUT} ms.`).then(\n          (rusha) => rusha.default.createHash()\n        ),\n      emptyFile: 'reject',\n      configName,\n    },\n  }\n}\n\n/** admin-dam's API, texts and choices. What is the application's own, the application hands in. */\nexport function adminDamUploadPreset(app: {\n  /** `uploadStart`, `uploadChunk`, `uploadFinish` of `fileApi.ts`: four asset types, admin-dam's addresses. */\n  requests: UploadRunRequests\n  /** `system.uploadErrors.*`; as `chunkValidationFailed` its `unknownError`, which its store writes today. */\n  messages: UploadMessages\n  /** `envConfig.dam.apiTimeout`. */\n  apiTimeout: number | null | undefined\n  /** `() => Promise.resolve(rusha.createHash())`: rusha stays a static import of admin-dam. */\n  loadHash(): Promise<UploadHash>\n}): UploadPreset<'adminDam'> {\n  return {\n    [uploadSide]: 'adminDam',\n    [uploadPresetMembers]: {\n      requests: app.requests,\n      messages: app.messages,\n      apiTimeout: app.apiTimeout,\n      loadHash: () => app.loadHash(),\n      emptyFile: 'send',\n      configName: 'default',\n    },\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAMA,IAAoB,MAKbC,IAAa,OAAO,YAAY,GAChCC,IAAsB,OAAO,qBAAqB;AAmE/D,SAAgBC,EAAoB,GAA6C;CAG/E,IAAM,EAAE,cAAW,kBAAe,kBAAeC,EAA6BC,CAAU;CAExF,OAAO;GACJJ,IAAa;GACbC,IAAsB;GACrB,UAAU;IACR,QAAQ,MAASI,EAAeC,GAAWC,GAAeC,CAAI;IAC9D,QAAQ,GAAM,GAAQ,GAAO,GAAM,GAAQ,MACzCC,EAAeH,GAAWC,GAAeC,GAAME,GAAQC,GAAOC,GAAMC,GAAQC,CAAgB;IAC9F,SAAS,GAAM,MAAQC,EAAgBT,GAAWC,GAAeC,GAAMQ,CAAG;GAC5E;GACA,UAAU;IACR,oBAAoBC,EAAQ,2CAA2C;IACvE,YAAYA,EAAQ,mCAAmC;IACvD,cAAcA,EAAQ,qCAAqC;IAC3D,gBAAgBA,EAAQ,uCAAuC;IAC/D,mBAAmBA,EAAQ,0CAA0C;IACrE,6BAA6BA,EAAQ,oDAAoD;GAC3F;GACA;GAGA,gBACEC,EAAY,OAAO,yCAAA,CAAA,MAAA,MAAA,kBAAAC,EAAA,OAAA,CAAA,GAAUpB,GAAmB,6BAA6BA,EAAkB,KAAK,CAAC,CAAC,MACnG,MAAUqB,EAAM,QAAQ,WAAW,CACtC;GACF,WAAW;GACX;EACF;CACF;AACF;AAGA,SAAgBC,EAAqB,GASR;CAC3B,OAAO;GACJrB,IAAa;GACbC,IAAsB;GACrB,UAAUqB,EAAI;GACd,UAAUA,EAAI;GACd,YAAYA,EAAI;GAChB,gBAAgBA,EAAI,SAAS;GAC7B,WAAW;GACX,YAAY;EACd;CACF;AACF"}
+{"version":3,"file":"uploadPresets.js","names":["HASH_LOAD_TIMEOUT","uploadSide","uploadPresetMembers","libraryUploadPreset","useCommonAdminCoreDamOptions","configName","damUploadStart","damClient","endPointImage","item","damUploadChunk","fileId","chunk","size","offset","onUploadProgress","damUploadFinish","sha","commonT","withTimeout","m","rusha","adminDamUploadPreset","app"],"sources":["../../../../../src/domains/dam/uploadQueue/presets/uploadPresets.ts"],"sourcesContent":["import type { AxiosProgressEvent } from 'axios'\nimport { commonT } from '@/plugins/i18n'\nimport type { DamUploadStartResponse, UploadQueueItem } from '@/domains/dam/types/UploadQueue'\nimport type { DocId } from '@/shared/types/common'\nimport { damUploadChunk, damUploadFinish, damUploadStart } from '@/domains/dam/api/uploadApi'\nimport { useCommonAdminCoreDamOptions } from '@/domains/dam/composables/commonAdminCoreDamOptions'\nimport { withTimeout } from '@/domains/listEditor/utils/listEditorLoader'\n\nconst HASH_LOAD_TIMEOUT = 15_000\n\nexport type UploadSide = 'library' | 'adminDam'\n// Not exported from the library, so only its own functions set them.\n// Nothing reads the side at runtime. A preset holds its members under the other symbol.\nexport const uploadSide = Symbol('uploadSide')\nexport const uploadPresetMembers = Symbol('uploadPresetMembers')\n\nexport interface UploadRunRequests {\n  start(item: UploadQueueItem): Promise<DamUploadStartResponse>\n  chunk(\n    item: UploadQueueItem,\n    fileId: DocId,\n    chunk: File,\n    size: number,\n    offset: number,\n    onUploadProgress: (event: AxiosProgressEvent) => void\n  ): Promise<unknown>\n  finish(item: UploadQueueItem, sha: string): Promise<unknown>\n}\n\n/** Texts a run writes into its row. Each side has its own. */\nexport interface UploadMessages {\n  unknownError(): string\n  /** Text for a field the server refused, by field name. */\n  size(): string\n  offset(): string\n  mimeType(): string\n  /** Prefix for a refused field that has no text of its own. */\n  systemError(): string\n  /** HTTP 400 on the last try of a chunk. */\n  chunkValidationFailed(): string\n}\n\nexport interface UploadHash {\n  update(data: ArrayBuffer): unknown\n  digest(encoding: 'hex'): string\n}\n\ninterface UploadPresetMembers {\n  requests: UploadRunRequests\n  messages: UploadMessages\n  apiTimeout: number | null | undefined\n  loadHash(): Promise<UploadHash>\n  /** Whether an empty file is started and finished, or refused before any request. */\n  emptyFile: 'send' | 'reject'\n  /** DAM configuration whose prv configuration bounds the chunks and whose last chunk size the upload starts from. */\n  configName: string\n}\n\n/**\n * How one side uploads. Created only by `libraryUploadPreset()`\n * and `adminDamUploadPreset()`. Its contents are not public.\n */\nexport interface UploadPreset<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  readonly [uploadPresetMembers]: UploadPresetMembers\n}\n\nexport type UploadProgressCallback = (progress: number, speed: number, estimate: number) => void\n\nexport interface UploadRun<S extends UploadSide = UploadSide> {\n  readonly [uploadSide]: S\n  uploadInit(): Promise<unknown>\n  upload(): Promise<unknown>\n  /** Stops the run wherever it is and cancels the chunk in flight. */\n  stop(): void\n  /** Whether the finish request was sent. The server may complete the file whatever the response. */\n  finishAttempted(): boolean\n}\n\n/**\n * Not exported from `src/lib.ts`. Default of `useUpload` (under `default`).\n * The library's API, texts and choices under DAM configuration `configName`.\n */\nexport function libraryUploadPreset(configName: string): UploadPreset<'library'> {\n  // Chunks are sized against the app's DAM request timeout for this configuration, else the root one.\n  // Without one (also `null` in a config file) the composable's default applies.\n  const { damClient, endPointImage, apiTimeout } = useCommonAdminCoreDamOptions(configName)\n\n  return {\n    [uploadSide]: 'library',\n    [uploadPresetMembers]: {\n      requests: {\n        start: (item) => damUploadStart(damClient, endPointImage, item),\n        chunk: (item, fileId, chunk, size, offset, onUploadProgress) =>\n          damUploadChunk(damClient, endPointImage, item, fileId, chunk, size, offset, onUploadProgress),\n        finish: (item, sha) => damUploadFinish(damClient, endPointImage, item, sha),\n      },\n      messages: {\n        unknownError: () => commonT('common.damImage.uploadErrors.unknownError'),\n        size: () => commonT('common.damImage.uploadErrors.size'),\n        offset: () => commonT('common.damImage.uploadErrors.offset'),\n        mimeType: () => commonT('common.damImage.uploadErrors.mimeType'),\n        systemError: () => commonT('common.damImage.uploadErrors.systemError'),\n        chunkValidationFailed: () => commonT('common.damImage.uploadErrors.chunkValidationFailed'),\n      },\n      apiTimeout,\n      // rusha loads when a file starts uploading, not on every page with the upload queue.\n      // It loads before the asset is created, so a load failure fails the item without leaving an empty asset.\n      loadHash: () =>\n        withTimeout(import('rusha'), HASH_LOAD_TIMEOUT, `rusha did not load within ${HASH_LOAD_TIMEOUT} ms.`).then(\n          (rusha) => rusha.default.createHash()\n        ),\n      emptyFile: 'reject',\n      configName,\n    },\n  }\n}\n\n/** admin-dam's API, texts and choices. The application passes in its own parts. */\nexport function adminDamUploadPreset(app: {\n  /** `uploadStart`, `uploadChunk`, `uploadFinish` of `fileApi.ts`: four asset types, admin-dam's addresses. */\n  requests: UploadRunRequests\n  /** `system.uploadErrors.*`. `chunkValidationFailed` uses its `unknownError`, which its store writes today. */\n  messages: UploadMessages\n  /** `envConfig.dam.apiTimeout`. */\n  apiTimeout: number | null | undefined\n  /** `() => Promise.resolve(rusha.createHash())`: rusha stays a static import of admin-dam. */\n  loadHash(): Promise<UploadHash>\n}): UploadPreset<'adminDam'> {\n  return {\n    [uploadSide]: 'adminDam',\n    [uploadPresetMembers]: {\n      requests: app.requests,\n      messages: app.messages,\n      apiTimeout: app.apiTimeout,\n      loadHash: () => app.loadHash(),\n      emptyFile: 'send',\n      configName: 'default',\n    },\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAMA,IAAoB,MAKbC,IAAa,OAAO,YAAY,GAChCC,IAAsB,OAAO,qBAAqB;AAqE/D,SAAgBC,EAAoB,GAA6C;CAG/E,IAAM,EAAE,cAAW,kBAAe,kBAAeC,EAA6BC,CAAU;CAExF,OAAO;GACJJ,IAAa;GACbC,IAAsB;GACrB,UAAU;IACR,QAAQ,MAASI,EAAeC,GAAWC,GAAeC,CAAI;IAC9D,QAAQ,GAAM,GAAQ,GAAO,GAAM,GAAQ,MACzCC,EAAeH,GAAWC,GAAeC,GAAME,GAAQC,GAAOC,GAAMC,GAAQC,CAAgB;IAC9F,SAAS,GAAM,MAAQC,EAAgBT,GAAWC,GAAeC,GAAMQ,CAAG;GAC5E;GACA,UAAU;IACR,oBAAoBC,EAAQ,2CAA2C;IACvE,YAAYA,EAAQ,mCAAmC;IACvD,cAAcA,EAAQ,qCAAqC;IAC3D,gBAAgBA,EAAQ,uCAAuC;IAC/D,mBAAmBA,EAAQ,0CAA0C;IACrE,6BAA6BA,EAAQ,oDAAoD;GAC3F;GACA;GAGA,gBACEC,EAAY,OAAO,yCAAA,CAAA,MAAA,MAAA,kBAAAC,EAAA,OAAA,CAAA,GAAUpB,GAAmB,6BAA6BA,EAAkB,KAAK,CAAC,CAAC,MACnG,MAAUqB,EAAM,QAAQ,WAAW,CACtC;GACF,WAAW;GACX;EACF;CACF;AACF;AAGA,SAAgBC,EAAqB,GASR;CAC3B,OAAO;GACJrB,IAAa;GACbC,IAAsB;GACrB,UAAUqB,EAAI;GACd,UAAUA,EAAI;GACd,YAAYA,EAAI;GAChB,gBAAgBA,EAAI,SAAS;GAC7B,WAAW;GACX,YAAY;EACd;CACF;AACF"}

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

@@ -1,6 +1,6 @@
 export type UploadPollMode = 'dense' | 'sparse';
 export interface UploadPollModeSchedule {
-    /** The ages of the youngest row at which it is read. */
+    /** Ages of the youngest row at which the queue is read. */
     marksMs: number[];
     /** After the last mark: up to the age `untilMs`, every `everyMs`. */
     tiers: Array<{
@@ -10,17 +10,17 @@ export interface UploadPollModeSchedule {
     tailEveryMs: number;
 }
 export declare const UPLOAD_POLL_SCHEDULE: Record<UploadPollMode, UploadPollModeSchedule>;
-/** Between two automatic reads of one queue. */
+/** Minimum gap between two automatic reads of one queue. */
 export declare const UPLOAD_POLL_MIN_GAP_MS: number;
-/** The wait after the first, the second… failed read in a row; the last one for every further. */
+/** Wait after the 1st, 2nd, ... consecutive failed read. The last value applies to every further failure. */
 export declare const UPLOAD_POLL_ERROR_LADDER_MS: number[];
-/** The age of a row at which it says its processing takes too long. */
+/** Row age after which the row shows a "processing takes too long" text. */
 export declare const UPLOAD_POLL_SLOW_TEXT_AFTER_MS: number;
-/** Reads in a row without the asset of a row, after which the row fails. */
+/** Consecutive reads without the row's asset after which the row fails. */
 export declare const UPLOAD_POLL_MISSING_LIMIT = 3;
-/** Failed reads in a row, after which the row warns. */
+/** Consecutive failed reads after which the row shows a warning. */
 export declare const UPLOAD_POLL_READ_FAILURE_LIMIT = 3;
-/** Notifications about the file of one asset within this window are one read. */
+/** File notifications for one asset within this window are merged into one read. */
 export declare const UPLOAD_NOTIFY_FILE_DELAY_MS = 250;
 /** The backend can send the metadata notification before its transaction is committed. */
 export declare const UPLOAD_NOTIFY_METADATA_DELAY_MS: number;

package/dist/domains/dam/uploadQueue/settlement/uploadPollSchedule.js

@@ -1,4 +1,4 @@
-//#region src/domains/dam/uploadQueue/settlement/uploadPollSchedule.ts
+// src/domains/dam/uploadQueue/settlement/uploadPollSchedule.ts
 var e = 1e3, t = 60 * e, n = {
 	dense: {
 		marksMs: [
@@ -62,7 +62,6 @@ function c(e, t) {
 	let a = r.tiers.find((t) => t.untilMs > e);
 	return a ? a.everyMs : r.tailEveryMs;
 }
-//#endregion
 export { o as UPLOAD_NOTIFY_METADATA_DELAY_MS, i as UPLOAD_POLL_ERROR_LADDER_MS, r as UPLOAD_POLL_MIN_GAP_MS, n as UPLOAD_POLL_SCHEDULE, a as UPLOAD_POLL_SLOW_TEXT_AFTER_MS, c as delayAfterRead, s as firstDelay };
 
 //# sourceMappingURL=uploadPollSchedule.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"uploadPollSchedule.js","names":["S","MIN","UPLOAD_POLL_SCHEDULE","s","UPLOAD_POLL_MIN_GAP_MS","UPLOAD_POLL_ERROR_LADDER_MS","UPLOAD_POLL_SLOW_TEXT_AFTER_MS","UPLOAD_NOTIFY_METADATA_DELAY_MS","firstDelay","mode","delayAfterRead","schedule","mark","markMs","ageMs","tier","candidate"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadPollSchedule.ts"],"sourcesContent":["export type UploadPollMode = 'dense' | 'sparse'\n\nexport interface UploadPollModeSchedule {\n  /** The ages of the youngest row at which it is read. */\n  marksMs: number[]\n  /** After the last mark: up to the age `untilMs`, every `everyMs`. */\n  tiers: Array<{ untilMs: number; everyMs: number }>\n  tailEveryMs: number\n}\n\nconst S = 1000\nconst MIN = 60 * S\n\n// `dense`: the poll is the only channel. `sparse`: the notifications are alive, the poll is their backup.\nexport const UPLOAD_POLL_SCHEDULE: Record<UploadPollMode, UploadPollModeSchedule> = {\n  dense: {\n    marksMs: [5, 10, 16, 23, 31, 40, 50, 60].map((s) => s * S),\n    tiers: [\n      { untilMs: 5 * MIN, everyMs: 30 * S },\n      { untilMs: 20 * MIN, everyMs: 1 * MIN },\n      { untilMs: 60 * MIN, everyMs: 2 * MIN },\n    ],\n    tailEveryMs: 10 * MIN,\n  },\n  sparse: {\n    marksMs: [10, 30, 60].map((s) => s * S),\n    tiers: [\n      { untilMs: 5 * MIN, everyMs: 1 * MIN },\n      { untilMs: 20 * MIN, everyMs: 3 * MIN },\n      { untilMs: 60 * MIN, everyMs: 5 * MIN },\n    ],\n    tailEveryMs: 10 * MIN,\n  },\n}\n\n/** Between two automatic reads of one queue. */\nexport const UPLOAD_POLL_MIN_GAP_MS = 2 * S\n/** The wait after the first, the second… failed read in a row; the last one for every further. */\nexport const UPLOAD_POLL_ERROR_LADDER_MS = [15, 30, 60, 120, 300].map((s) => s * S)\n/** The age of a row at which it says its processing takes too long. */\nexport const UPLOAD_POLL_SLOW_TEXT_AFTER_MS = 20 * MIN\n/** Reads in a row without the asset of a row, after which the row fails. */\nexport const UPLOAD_POLL_MISSING_LIMIT = 3\n/** Failed reads in a row, after which the row warns. */\nexport const UPLOAD_POLL_READ_FAILURE_LIMIT = 3\n/** Notifications about the file of one asset within this window are one read. */\nexport const UPLOAD_NOTIFY_FILE_DELAY_MS = 250\n/** The backend can send the metadata notification before its transaction is committed. */\nexport const UPLOAD_NOTIFY_METADATA_DELAY_MS = 2 * S\nexport const UPLOAD_READ_BATCH_LIMIT = 50\n\nexport const firstDelay = (mode: UploadPollMode): number => UPLOAD_POLL_SCHEDULE[mode].marksMs[0]!\n\n/** The wait for the next read when the youngest row is `ageMs` old. */\nexport function delayAfterRead(ageMs: number, mode: UploadPollMode): number {\n  const schedule = UPLOAD_POLL_SCHEDULE[mode]\n  const mark = schedule.marksMs.find((markMs) => markMs > ageMs)\n  if (mark !== undefined) return mark - ageMs\n  const tier = schedule.tiers.find((candidate) => candidate.untilMs > ageMs)\n  return tier ? tier.everyMs : schedule.tailEveryMs\n}\n"],"mappings":";AAUA,IAAMA,IAAI,KACJC,IAAM,KAAKD,GAGJE,IAAuE;CAClF,OAAO;EACL,SAAS;GAAC;GAAG;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;EAAE,CAAC,CAAC,KAAK,MAAMC,IAAIH,CAAC;EACzD,OAAO;GACL;IAAE,SAAS,IAAIC;IAAK,SAAS,KAAKD;GAAE;GACpC;IAAE,SAAS,KAAKC;IAAK,SAAS,IAAIA;GAAI;GACtC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;EACxC;EACA,aAAa,KAAKA;CACpB;CACA,QAAQ;EACN,SAAS;GAAC;GAAI;GAAI;EAAE,CAAC,CAAC,KAAK,MAAME,IAAIH,CAAC;EACtC,OAAO;GACL;IAAE,SAAS,IAAIC;IAAK,SAAS,IAAIA;GAAI;GACrC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;GACtC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;EACxC;EACA,aAAa,KAAKA;CACpB;AACF,GAGaG,IAAyB,IAAIJ,GAE7BK,IAA8B;CAAC;CAAI;CAAI;CAAI;CAAK;AAAG,CAAC,CAAC,KAAK,MAAMF,IAAIH,CAAC,GAErEM,IAAiC,KAAKL,GAQtCM,IAAkC,IAAIP,GAGtCQ,KAAc,MAAiCN,EAAqBO,EAAK,CAAC,QAAQ;AAG/F,SAAgBC,EAAe,GAAe,GAA8B;CAC1E,IAAMC,IAAWT,EAAqBO,IAChCG,IAAOD,EAAS,QAAQ,MAAM,MAAWE,IAASC,CAAK;CAC7D,IAAIF,MAAS,KAAA,GAAW,OAAOA,IAAOE;CACtC,IAAMC,IAAOJ,EAAS,MAAM,MAAM,MAAcK,EAAU,UAAUF,CAAK;CACzE,OAAOC,IAAOA,EAAK,UAAUJ,EAAS;AACxC"}
+{"version":3,"file":"uploadPollSchedule.js","names":["S","MIN","UPLOAD_POLL_SCHEDULE","s","UPLOAD_POLL_MIN_GAP_MS","UPLOAD_POLL_ERROR_LADDER_MS","UPLOAD_POLL_SLOW_TEXT_AFTER_MS","UPLOAD_NOTIFY_METADATA_DELAY_MS","firstDelay","mode","delayAfterRead","schedule","mark","markMs","ageMs","tier","candidate"],"sources":["../../../../../src/domains/dam/uploadQueue/settlement/uploadPollSchedule.ts"],"sourcesContent":["export type UploadPollMode = 'dense' | 'sparse'\n\nexport interface UploadPollModeSchedule {\n  /** Ages of the youngest row at which the queue is read. */\n  marksMs: number[]\n  /** After the last mark: up to the age `untilMs`, every `everyMs`. */\n  tiers: Array<{ untilMs: number; everyMs: number }>\n  tailEveryMs: number\n}\n\nconst S = 1000\nconst MIN = 60 * S\n\n// `dense`: the poll is the only channel. `sparse`: the notifications are alive, the poll is their backup.\nexport const UPLOAD_POLL_SCHEDULE: Record<UploadPollMode, UploadPollModeSchedule> = {\n  dense: {\n    marksMs: [5, 10, 16, 23, 31, 40, 50, 60].map((s) => s * S),\n    tiers: [\n      { untilMs: 5 * MIN, everyMs: 30 * S },\n      { untilMs: 20 * MIN, everyMs: 1 * MIN },\n      { untilMs: 60 * MIN, everyMs: 2 * MIN },\n    ],\n    tailEveryMs: 10 * MIN,\n  },\n  sparse: {\n    marksMs: [10, 30, 60].map((s) => s * S),\n    tiers: [\n      { untilMs: 5 * MIN, everyMs: 1 * MIN },\n      { untilMs: 20 * MIN, everyMs: 3 * MIN },\n      { untilMs: 60 * MIN, everyMs: 5 * MIN },\n    ],\n    tailEveryMs: 10 * MIN,\n  },\n}\n\n/** Minimum gap between two automatic reads of one queue. */\nexport const UPLOAD_POLL_MIN_GAP_MS = 2 * S\n/** Wait after the 1st, 2nd, ... consecutive failed read. The last value applies to every further failure. */\nexport const UPLOAD_POLL_ERROR_LADDER_MS = [15, 30, 60, 120, 300].map((s) => s * S)\n/** Row age after which the row shows a \"processing takes too long\" text. */\nexport const UPLOAD_POLL_SLOW_TEXT_AFTER_MS = 20 * MIN\n/** Consecutive reads without the row's asset after which the row fails. */\nexport const UPLOAD_POLL_MISSING_LIMIT = 3\n/** Consecutive failed reads after which the row shows a warning. */\nexport const UPLOAD_POLL_READ_FAILURE_LIMIT = 3\n/** File notifications for one asset within this window are merged into one read. */\nexport const UPLOAD_NOTIFY_FILE_DELAY_MS = 250\n/** The backend can send the metadata notification before its transaction is committed. */\nexport const UPLOAD_NOTIFY_METADATA_DELAY_MS = 2 * S\nexport const UPLOAD_READ_BATCH_LIMIT = 50\n\nexport const firstDelay = (mode: UploadPollMode): number => UPLOAD_POLL_SCHEDULE[mode].marksMs[0]!\n\n/** The wait for the next read when the youngest row is `ageMs` old. */\nexport function delayAfterRead(ageMs: number, mode: UploadPollMode): number {\n  const schedule = UPLOAD_POLL_SCHEDULE[mode]\n  const mark = schedule.marksMs.find((markMs) => markMs > ageMs)\n  if (mark !== undefined) return mark - ageMs\n  const tier = schedule.tiers.find((candidate) => candidate.untilMs > ageMs)\n  return tier ? tier.everyMs : schedule.tailEveryMs\n}\n"],"mappings":";AAUA,IAAMA,IAAI,KACJC,IAAM,KAAKD,GAGJE,IAAuE;CAClF,OAAO;EACL,SAAS;GAAC;GAAG;GAAI;GAAI;GAAI;GAAI;GAAI;GAAI;EAAE,CAAC,CAAC,KAAK,MAAMC,IAAIH,CAAC;EACzD,OAAO;GACL;IAAE,SAAS,IAAIC;IAAK,SAAS,KAAKD;GAAE;GACpC;IAAE,SAAS,KAAKC;IAAK,SAAS,IAAIA;GAAI;GACtC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;EACxC;EACA,aAAa,KAAKA;CACpB;CACA,QAAQ;EACN,SAAS;GAAC;GAAI;GAAI;EAAE,CAAC,CAAC,KAAK,MAAME,IAAIH,CAAC;EACtC,OAAO;GACL;IAAE,SAAS,IAAIC;IAAK,SAAS,IAAIA;GAAI;GACrC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;GACtC;IAAE,SAAS,KAAKA;IAAK,SAAS,IAAIA;GAAI;EACxC;EACA,aAAa,KAAKA;CACpB;AACF,GAGaG,IAAyB,IAAIJ,GAE7BK,IAA8B;CAAC;CAAI;CAAI;CAAI;CAAK;AAAG,CAAC,CAAC,KAAK,MAAMF,IAAIH,CAAC,GAErEM,IAAiC,KAAKL,GAQtCM,IAAkC,IAAIP,GAGtCQ,KAAc,MAAiCN,EAAqBO,EAAK,CAAC,QAAQ;AAG/F,SAAgBC,EAAe,GAAe,GAA8B;CAC1E,IAAMC,IAAWT,EAAqBO,IAChCG,IAAOD,EAAS,QAAQ,MAAM,MAAWE,IAASC,CAAK;CAC7D,IAAIF,MAAS,KAAA,GAAW,OAAOA,IAAOE;CACtC,IAAMC,IAAOJ,EAAS,MAAM,MAAM,MAAcK,EAAU,UAAUF,CAAK;CACzE,OAAOC,IAAOA,EAAK,UAAUJ,EAAS;AACxC"}

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

@@ -7,13 +7,13 @@ export interface QueuePollerDeps {
     read(trigger: 'tick' | 'visible'): Promise<void>;
 }
 export interface QueuePoller {
-    /** A row began to be tracked: the next read comes no later than its first mark. */
+    /** A row started being tracked. The next read happens no later than its first mark. */
     rowAdded(): void;
-    /** The tab is visible again: a read at once. */
+    /** The tab is visible again. Read immediately. */
     readNow(trigger: 'visible'): void;
-    /** The tab was hidden, the mode changed or the queue tracks nothing any more: the timer is set anew. */
+    /** Re-arms the timer after the tab is hidden, the mode changes or the queue stops tracking rows. */
     reschedule(): void;
     stop(): void;
 }
-/** The timer of the ticks of one queue. What a tick reads is up to `deps.read`. */
+/** Tick timer of one queue. What a tick reads is decided by `deps.read`. */
 export declare function createQueuePoller(deps: QueuePollerDeps): QueuePoller;

package/dist/domains/dam/uploadQueue/settlement/uploadPoller.js

@@ -1,15 +1,15 @@
 import { UPLOAD_POLL_ERROR_LADDER_MS as e, UPLOAD_POLL_MIN_GAP_MS as t, delayAfterRead as n, firstDelay as r } from "./uploadPollSchedule.js";
 import { uploadSettlementRuntime as i } from "./uploadSettlementRuntime.js";
-//#region src/domains/dam/uploadQueue/settlement/uploadPoller.ts
+// src/domains/dam/uploadQueue/settlement/uploadPoller.ts
 function a(a) {
 	let o = null, s = null, c = !1, l = null, u = !1, d = null, f = 0, p = !1, m = () => i.scheduler, h = (e, t) => e === null ? t : Math.min(e, t), g = () => {
 		s &&= (m().clearTimeout(s.handle), null);
 	}, _ = () => {
 		g(), o = null, l = null, u = !1, f = 0;
 	}, v = () => {
-		g(), !(p || c || o === null) && i.visibility.isVisible() && (s = { handle: m().setTimeout(y, Math.max(0, o - m().now())) });
+		g(), p || c || o === null || i.visibility.isVisible() && (s = { handle: m().setTimeout(y, Math.max(0, o - m().now())) });
 	}, y = () => {
-		s = null, !p && (a.youngestAgeMs() === null ? _() : i.visibility.isVisible() && b("tick"));
+		s = null, p || (a.youngestAgeMs() === null ? _() : i.visibility.isVisible() && b("tick"));
 	}, b = async (r) => {
 		if (c) {
 			u = !0;
@@ -70,7 +70,6 @@ function a(a) {
 		}
 	};
 }
-//#endregion
 export { a as createQueuePoller };
 
 //# sourceMappingURL=uploadPoller.js.map