@openforis/arena-core 2.18.12 → 2.18.14

package/dist/esm/record/_records/recordCompletion.js

@@ -34,16 +34,13 @@ const getChildEntityCompletionStats = (params) => {
     }
     const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef });
     const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0);
-    // entities added beyond the min count are still expected to be complete
-    const expectedCount = Math.max(minCount, childEntities.length);
-    if (expectedCount === 0)
-        return emptyStats();
     const stats = emptyStats();
-    for (let index = 0; index < expectedCount; index++) {
-        const childEntity = childEntities[index];
-        // a missing repetition (below the min count) counts as a single incomplete unit
-        addStats(stats, childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : { total: 1, filled: 0 });
+    // entities added beyond the min count are still expected to be complete
+    for (const childEntity of childEntities) {
+        addStats(stats, getEntityCompletionStats({ survey, record, entity: childEntity }));
     }
+    // a missing repetition (below the min count) counts as a single incomplete unit
+    stats.total += Math.max(minCount - childEntities.length, 0);
     return stats;
 };
 export const getEntityCompletionStats = (params) => {

package/dist/esm/record/_records/recordCompletion.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getCycle, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst isAttributeRequired = (entity: ArenaRecordNode, nodeDef: NodeDef<NodeDefType, NodeDefProps>): boolean =>\n  NodeDefs.isKey(nodeDef) ||\n  NodeDefs.isRequired(nodeDef) ||\n  (NodeDefs.isRequiredIfDefined(nodeDef) && Nodes.isChildRequired(entity, nodeDef.uuid))\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!isAttributeRequired(entity, nodeDef)) return emptyStats()\n\n  const node = getChildren(entity, nodeDef.uuid)(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren(parentEntity, nodeDef.uuid)(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n  // entities added beyond the min count are still expected to be complete\n  const expectedCount = Math.max(minCount, childEntities.length)\n  if (expectedCount === 0) return emptyStats()\n\n  const stats = emptyStats()\n  for (let index = 0; index < expectedCount; index++) {\n    const childEntity = childEntities[index]\n    // a missing repetition (below the min count) counts as a single incomplete unit\n    addStats(\n      stats,\n      childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : { total: 1, filled: 0 }\n    )\n  }\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef }).filter(\n    NodeDefs.isInCycle(getCycle(record))\n  )\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}
+{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getCycle, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst isAttributeRequired = (entity: ArenaRecordNode, nodeDef: NodeDef<NodeDefType, NodeDefProps>): boolean =>\n  NodeDefs.isKey(nodeDef) ||\n  NodeDefs.isRequired(nodeDef) ||\n  (NodeDefs.isRequiredIfDefined(nodeDef) && Nodes.isChildRequired(entity, nodeDef.uuid))\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!isAttributeRequired(entity, nodeDef)) return emptyStats()\n\n  const node = getChildren(entity, nodeDef.uuid)(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren(parentEntity, nodeDef.uuid)(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n\n  const stats = emptyStats()\n  // entities added beyond the min count are still expected to be complete\n  for (const childEntity of childEntities) {\n    addStats(stats, getEntityCompletionStats({ survey, record, entity: childEntity }))\n  }\n  // a missing repetition (below the min count) counts as a single incomplete unit\n  stats.total += Math.max(minCount - childEntities.length, 0)\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef }).filter(\n    NodeDefs.isInCycle(getCycle(record))\n  )\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}

package/dist/esm/utils/fileProcessor.js

@@ -115,6 +115,7 @@ export class FileProcessor {
         this.currentChunkNumber = startFromChunk;
         this.calculateFileSize()
             .then((fileSize) => {
+            var _a;
             if (runId !== this.runId)
                 return;
             this.totalFileSize = fileSize;
@@ -122,6 +123,12 @@ export class FileProcessor {
             if (this.totalChunks > 0) {
                 this.processNextChunk();
             }
+            else {
+                // empty file: nothing to process, complete immediately (callers wait for onComplete)
+                this.running = false;
+                this.completed = true;
+                (_a = this.onComplete) === null || _a === void 0 ? void 0 : _a.call(this);
+            }
         })
             .catch((error) => {
             if (runId !== this.runId)

package/dist/esm/utils/fileProcessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../../src/utils/fileProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { RetryProcessor } from './retryProcessor'\n\ntype ChunkProcessor = (args: {\n  chunk: number\n  content: Blob | string | Uint8Array\n  totalChunks: number\n  totalFileSize: number\n}) => Promise<any>\n\nexport type FileProcessorConstructorArgs = {\n  file?: File\n  filePath?: string\n  chunkProcessor: ChunkProcessor\n  onError?: (error: Error) => void\n  onComplete?: (result: any) => void\n  chunkSize?: number\n  maxTryings?: number\n  /**\n   * Delay (in milliseconds) before retrying a failed chunk, doubled at every further retry.\n   */\n  retryDelay?: number\n}\n\nexport class FileProcessor {\n  static readonly defaultChunkSize = 1024 * 1024 * 10 // 10MB\n  static readonly defaultMaxTryings = 5\n  static readonly defaultRetryDelay = 1000 // 1s, then 2s, 4s...\n\n  private readonly file?: File\n  private readonly filePath?: string\n  private readonly chunkProcessor: ChunkProcessor\n  private readonly chunkSize: number\n  private readonly maxTryings: number\n  private readonly retryDelay: number\n  private readonly onError?: (error: Error) => void\n  private readonly onComplete?: (result?: any) => void\n\n  // State properties\n  protected totalFileSize: number = 0\n  protected running: boolean = false\n  protected totalChunks: number = 0\n  protected currentChunkNumber: number = 0\n  // true while a chunk is being processed (resume must not start a second processing chain)\n  protected processingChunk: boolean = false\n  protected completed: boolean = false\n  // incremented when a processing run is stopped: callbacks of the chunks of previous runs are ignored\n  private runId: number = 0\n  private retryProcessor?: RetryProcessor<any>\n\n  constructor({\n    file,\n    filePath,\n    chunkProcessor,\n    onError,\n    onComplete,\n    chunkSize = FileProcessor.defaultChunkSize,\n    maxTryings = FileProcessor.defaultMaxTryings,\n    retryDelay = FileProcessor.defaultRetryDelay,\n  }: FileProcessorConstructorArgs) {\n    this.file = file\n    this.filePath = filePath\n    this.chunkProcessor = chunkProcessor\n    this.chunkSize = chunkSize\n    this.maxTryings = maxTryings\n    this.retryDelay = retryDelay\n    this.onError = onError\n    this.onComplete = onComplete\n\n    if (!this.file && !this.filePath) {\n      throw new Error('File or filePath not specified')\n    }\n\n    this.reset()\n  }\n\n  private cancelCurrentRun(): void {\n    this.runId += 1\n    this.retryProcessor?.stop()\n    this.retryProcessor = undefined\n  }\n\n  protected reset(): void {\n    this.cancelCurrentRun()\n    this.running = false\n    this.totalChunks = 0\n    this.currentChunkNumber = 0\n    this.totalFileSize = 0\n    this.processingChunk = false\n    this.completed = false\n  }\n\n  protected calculateFileSize(): Promise<number> {\n    return Promise.resolve(this.file?.size ?? 0)\n  }\n\n  protected onFail(error: Error): void {\n    this.onError?.(error)\n  }\n\n  protected extractCurrentFileChunk(): Promise<Blob | string | Uint8Array> {\n    const { file, currentChunkNumber, totalChunks, chunkSize } = this\n    if (!file) {\n      return Promise.reject(new Error('File property not initialized'))\n    }\n    return Promise.resolve(\n      file.slice(\n        (currentChunkNumber - 1) * chunkSize,\n        currentChunkNumber === totalChunks ? undefined : currentChunkNumber * chunkSize\n      )\n    )\n  }\n\n  protected processNextChunk(): void {\n    const { chunkProcessor, currentChunkNumber, totalFileSize, totalChunks, maxTryings, retryDelay, runId } = this\n    const isStale = () => runId !== this.runId\n\n    this.processingChunk = true\n    this.extractCurrentFileChunk()\n      .then((content) => {\n        if (isStale()) return\n        const retryProcessor = new RetryProcessor<any>({\n          processor: () => chunkProcessor({ chunk: currentChunkNumber, totalFileSize, totalChunks, content }),\n          onSuccess: (chunkResult) => {\n            if (isStale()) return\n            this.processingChunk = false\n            if (this.currentChunkNumber < totalChunks) {\n              // move to the next chunk also when paused: resume will continue from it\n              this.currentChunkNumber += 1\n              if (this.running) {\n                this.processNextChunk()\n              }\n            } else {\n              this.running = false\n              this.completed = true\n              // called outside the retried processor: if it throws, the last chunk is not processed again\n              this.onComplete?.(chunkResult)\n            }\n          },\n          onFail: (error: Error) => {\n            if (isStale()) return\n            this.processingChunk = false\n            this.onFail(error)\n            this.running = false\n          },\n          maxTryings,\n          retryDelay,\n        })\n        this.retryProcessor = retryProcessor\n        retryProcessor.start()\n      })\n      .catch((error) => {\n        if (isStale()) return\n        this.processingChunk = false\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  start(startFromChunk: number = 1): void {\n    // a previous run still in progress must not continue in parallel\n    this.cancelCurrentRun()\n    const { runId } = this\n    this.processingChunk = false\n    this.running = true\n    this.completed = false\n    this.currentChunkNumber = startFromChunk\n    this.calculateFileSize()\n      .then((fileSize) => {\n        if (runId !== this.runId) return\n        this.totalFileSize = fileSize\n        this.totalChunks = Math.ceil(fileSize / this.chunkSize)\n        if (this.totalChunks > 0) {\n          this.processNextChunk()\n        }\n      })\n      .catch((error) => {\n        if (runId !== this.runId) return\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  stop(): void {\n    this.reset()\n  }\n\n  pause(): void {\n    this.running = false\n  }\n\n  resume(): void {\n    if (this.running || this.completed) return\n    this.running = true\n    // if a chunk is still being processed, processing continues when it completes\n    if (!this.processingChunk && this.totalChunks > 0) {\n      this.processNextChunk()\n    }\n  }\n}\n"]}
+{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../../src/utils/fileProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { RetryProcessor } from './retryProcessor'\n\ntype ChunkProcessor = (args: {\n  chunk: number\n  content: Blob | string | Uint8Array\n  totalChunks: number\n  totalFileSize: number\n}) => Promise<any>\n\nexport type FileProcessorConstructorArgs = {\n  file?: File\n  filePath?: string\n  chunkProcessor: ChunkProcessor\n  onError?: (error: Error) => void\n  onComplete?: (result: any) => void\n  chunkSize?: number\n  maxTryings?: number\n  /**\n   * Delay (in milliseconds) before retrying a failed chunk, doubled at every further retry.\n   */\n  retryDelay?: number\n}\n\nexport class FileProcessor {\n  static readonly defaultChunkSize = 1024 * 1024 * 10 // 10MB\n  static readonly defaultMaxTryings = 5\n  static readonly defaultRetryDelay = 1000 // 1s, then 2s, 4s...\n\n  private readonly file?: File\n  private readonly filePath?: string\n  private readonly chunkProcessor: ChunkProcessor\n  private readonly chunkSize: number\n  private readonly maxTryings: number\n  private readonly retryDelay: number\n  private readonly onError?: (error: Error) => void\n  private readonly onComplete?: (result?: any) => void\n\n  // State properties\n  protected totalFileSize: number = 0\n  protected running: boolean = false\n  protected totalChunks: number = 0\n  protected currentChunkNumber: number = 0\n  // true while a chunk is being processed (resume must not start a second processing chain)\n  protected processingChunk: boolean = false\n  protected completed: boolean = false\n  // incremented when a processing run is stopped: callbacks of the chunks of previous runs are ignored\n  private runId: number = 0\n  private retryProcessor?: RetryProcessor<any>\n\n  constructor({\n    file,\n    filePath,\n    chunkProcessor,\n    onError,\n    onComplete,\n    chunkSize = FileProcessor.defaultChunkSize,\n    maxTryings = FileProcessor.defaultMaxTryings,\n    retryDelay = FileProcessor.defaultRetryDelay,\n  }: FileProcessorConstructorArgs) {\n    this.file = file\n    this.filePath = filePath\n    this.chunkProcessor = chunkProcessor\n    this.chunkSize = chunkSize\n    this.maxTryings = maxTryings\n    this.retryDelay = retryDelay\n    this.onError = onError\n    this.onComplete = onComplete\n\n    if (!this.file && !this.filePath) {\n      throw new Error('File or filePath not specified')\n    }\n\n    this.reset()\n  }\n\n  private cancelCurrentRun(): void {\n    this.runId += 1\n    this.retryProcessor?.stop()\n    this.retryProcessor = undefined\n  }\n\n  protected reset(): void {\n    this.cancelCurrentRun()\n    this.running = false\n    this.totalChunks = 0\n    this.currentChunkNumber = 0\n    this.totalFileSize = 0\n    this.processingChunk = false\n    this.completed = false\n  }\n\n  protected calculateFileSize(): Promise<number> {\n    return Promise.resolve(this.file?.size ?? 0)\n  }\n\n  protected onFail(error: Error): void {\n    this.onError?.(error)\n  }\n\n  protected extractCurrentFileChunk(): Promise<Blob | string | Uint8Array> {\n    const { file, currentChunkNumber, totalChunks, chunkSize } = this\n    if (!file) {\n      return Promise.reject(new Error('File property not initialized'))\n    }\n    return Promise.resolve(\n      file.slice(\n        (currentChunkNumber - 1) * chunkSize,\n        currentChunkNumber === totalChunks ? undefined : currentChunkNumber * chunkSize\n      )\n    )\n  }\n\n  protected processNextChunk(): void {\n    const { chunkProcessor, currentChunkNumber, totalFileSize, totalChunks, maxTryings, retryDelay, runId } = this\n    const isStale = () => runId !== this.runId\n\n    this.processingChunk = true\n    this.extractCurrentFileChunk()\n      .then((content) => {\n        if (isStale()) return\n        const retryProcessor = new RetryProcessor<any>({\n          processor: () => chunkProcessor({ chunk: currentChunkNumber, totalFileSize, totalChunks, content }),\n          onSuccess: (chunkResult) => {\n            if (isStale()) return\n            this.processingChunk = false\n            if (this.currentChunkNumber < totalChunks) {\n              // move to the next chunk also when paused: resume will continue from it\n              this.currentChunkNumber += 1\n              if (this.running) {\n                this.processNextChunk()\n              }\n            } else {\n              this.running = false\n              this.completed = true\n              // called outside the retried processor: if it throws, the last chunk is not processed again\n              this.onComplete?.(chunkResult)\n            }\n          },\n          onFail: (error: Error) => {\n            if (isStale()) return\n            this.processingChunk = false\n            this.onFail(error)\n            this.running = false\n          },\n          maxTryings,\n          retryDelay,\n        })\n        this.retryProcessor = retryProcessor\n        retryProcessor.start()\n      })\n      .catch((error) => {\n        if (isStale()) return\n        this.processingChunk = false\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  start(startFromChunk: number = 1): void {\n    // a previous run still in progress must not continue in parallel\n    this.cancelCurrentRun()\n    const { runId } = this\n    this.processingChunk = false\n    this.running = true\n    this.completed = false\n    this.currentChunkNumber = startFromChunk\n    this.calculateFileSize()\n      .then((fileSize) => {\n        if (runId !== this.runId) return\n        this.totalFileSize = fileSize\n        this.totalChunks = Math.ceil(fileSize / this.chunkSize)\n        if (this.totalChunks > 0) {\n          this.processNextChunk()\n        } else {\n          // empty file: nothing to process, complete immediately (callers wait for onComplete)\n          this.running = false\n          this.completed = true\n          this.onComplete?.()\n        }\n      })\n      .catch((error) => {\n        if (runId !== this.runId) return\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  stop(): void {\n    this.reset()\n  }\n\n  pause(): void {\n    this.running = false\n  }\n\n  resume(): void {\n    if (this.running || this.completed) return\n    this.running = true\n    // if a chunk is still being processed, processing continues when it completes\n    if (!this.processingChunk && this.totalChunks > 0) {\n      this.processNextChunk()\n    }\n  }\n}\n"]}

package/dist/record/_records/recordCompletion.js

@@ -37,16 +37,13 @@ const getChildEntityCompletionStats = (params) => {
     }
     const minCountRaw = node_1.Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef });
     const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0);
-    // entities added beyond the min count are still expected to be complete
-    const expectedCount = Math.max(minCount, childEntities.length);
-    if (expectedCount === 0)
-        return emptyStats();
     const stats = emptyStats();
-    for (let index = 0; index < expectedCount; index++) {
-        const childEntity = childEntities[index];
-        // a missing repetition (below the min count) counts as a single incomplete unit
-        addStats(stats, childEntity ? (0, exports.getEntityCompletionStats)({ survey, record, entity: childEntity }) : { total: 1, filled: 0 });
+    // entities added beyond the min count are still expected to be complete
+    for (const childEntity of childEntities) {
+        addStats(stats, (0, exports.getEntityCompletionStats)({ survey, record, entity: childEntity }));
     }
+    // a missing repetition (below the min count) counts as a single incomplete unit
+    stats.total += Math.max(minCount - childEntities.length, 0);
     return stats;
 };
 const getEntityCompletionStats = (params) => {

package/dist/record/_records/recordCompletion.js.map

@@ -1 +1 @@
-{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":";;;AAAA,qCAAmD;AACnD,2CAA4E;AAC5E,yCAA8C;AAC9C,uCAAqC;AAErC,mDAAgE;AAOhE,MAAM,UAAU,GAAG,GAA0B,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;AAEzE,MAAM,QAAQ,GAAG,CAAC,QAA+B,EAAE,UAAiC,EAAQ,EAAE;IAC5F,QAAQ,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAA;IAClC,QAAQ,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,CAAA;AACtC,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,MAAuB,EAAE,OAA2C,EAAW,EAAE,CAC5G,kBAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IACvB,kBAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;IAC5B,CAAC,kBAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,YAAK,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAExF,MAAM,2BAA2B,GAAG,CAAC,MAIpC,EAAyB,EAAE;IAC1B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAE1C,IAAI,kBAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,YAAK,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;QAC3E,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC;YAAE,OAAO,UAAU,EAAE,CAAA;QAEhE,MAAM,gBAAgB,GAAG,IAAA,2BAAW,EAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAA;QAEvG,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EAAE,CAAA;IAC1E,CAAC;IAED,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC;QAAE,OAAO,UAAU,EAAE,CAAA;IAE9D,MAAM,IAAI,GAAG,IAAA,2BAAW,EAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACzD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,IAAI,YAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC1E,CAAC,CAAA;AAED,MAAM,6BAA6B,GAAG,CAAC,MAKtC,EAAyB,EAAE;IAC1B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IACxD,MAAM,aAAa,GAAG,IAAA,2BAAW,EAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;IAErE,IAAI,kBAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;QACpC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAA,QAAA,wBAAwB,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;IACvG,CAAC;IAED,MAAM,WAAW,GAAG,YAAK,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAA;IACpF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IACzE,wEAAwE;IACxE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9D,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,UAAU,EAAE,CAAA;IAE5C,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACxC,gFAAgF;QAChF,QAAQ,CACN,KAAK,EACL,WAAW,CAAC,CAAC,CAAC,IAAA,QAAA,wBAAwB,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAC1G,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAEM,MAAM,wBAAwB,GAAG,CAAC,MAKxC,EAAyB,EAAE;IAC1B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IACvE,MAAM,SAAS,GAAG,gBAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IAChF,MAAM,SAAS,GAAG,gBAAO,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CACjF,kBAAQ,CAAC,SAAS,CAAC,IAAA,wBAAQ,EAAC,MAAM,CAAC,CAAC,CACrC,CAAA;IAED,MAAM,KAAK,GAAG,UAAU,EAAE,CAAA;IAC1B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,YAAK,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QAE7D,IAAI,kBAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,qBAAqB;gBAAE,SAAQ;YACpC,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;QAC7G,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAxBY,QAAA,wBAAwB,GAAxB,wBAAwB,CAwBpC;AAED,MAAM,mBAAmB,GAAG,CAAC,KAA4B,EAAU,EAAE;IACnE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAC/B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,GAAG,CAAA;IAC1B,OAAO,eAAO,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAA;AAED;;;;GAIG;AACI,MAAM,0BAA0B,GAAG,CAAC,MAI1C,EAAU,EAAE,CAAC,mBAAmB,CAAC,IAAA,QAAA,wBAAwB,EAAC,MAAM,CAAC,CAAC,CAAA;AAJtD,QAAA,0BAA0B,GAA1B,0BAA0B,CAI4B;AAEnE;;;GAGG;AACI,MAAM,6BAA6B,GAAG,CAAC,MAI7C,EAAU,EAAE,CAAC,mBAAmB,CAAC,IAAA,QAAA,wBAAwB,kCAAM,MAAM,KAAE,qBAAqB,EAAE,KAAK,IAAG,CAAC,CAAA;AAJ3F,QAAA,6BAA6B,GAA7B,6BAA6B,CAI8D;AAExG;;GAEG;AACI,MAAM,0BAA0B,GAAG,CAAC,MAA+C,EAAU,EAAE;IACpG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACjC,MAAM,UAAU,GAAG,IAAA,uBAAO,EAAC,MAAM,CAAC,CAAA;IAClC,OAAO,UAAU,CAAC,CAAC,CAAC,IAAA,QAAA,0BAA0B,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5F,CAAC,CAAA;AAJY,QAAA,0BAA0B,GAA1B,0BAA0B,CAItC","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getCycle, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst isAttributeRequired = (entity: ArenaRecordNode, nodeDef: NodeDef<NodeDefType, NodeDefProps>): boolean =>\n  NodeDefs.isKey(nodeDef) ||\n  NodeDefs.isRequired(nodeDef) ||\n  (NodeDefs.isRequiredIfDefined(nodeDef) && Nodes.isChildRequired(entity, nodeDef.uuid))\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!isAttributeRequired(entity, nodeDef)) return emptyStats()\n\n  const node = getChildren(entity, nodeDef.uuid)(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren(parentEntity, nodeDef.uuid)(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n  // entities added beyond the min count are still expected to be complete\n  const expectedCount = Math.max(minCount, childEntities.length)\n  if (expectedCount === 0) return emptyStats()\n\n  const stats = emptyStats()\n  for (let index = 0; index < expectedCount; index++) {\n    const childEntity = childEntities[index]\n    // a missing repetition (below the min count) counts as a single incomplete unit\n    addStats(\n      stats,\n      childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : { total: 1, filled: 0 }\n    )\n  }\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef }).filter(\n    NodeDefs.isInCycle(getCycle(record))\n  )\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}
+{"version":3,"file":"recordCompletion.js","sourceRoot":"","sources":["../../../src/record/_records/recordCompletion.ts"],"names":[],"mappings":"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","sourcesContent":["import { ArenaRecordNode, Nodes } from '../../node'\nimport { NodeDef, NodeDefProps, NodeDefs, NodeDefType } from '../../nodeDef'\nimport { Survey, Surveys } from '../../survey'\nimport { Numbers } from '../../utils'\nimport { ArenaRecord } from '../record'\nimport { getChildren, getCycle, getRoot } from './recordGetters'\n\nexport interface EntityCompletionStats {\n  total: number\n  filled: number\n}\n\nconst emptyStats = (): EntityCompletionStats => ({ total: 0, filled: 0 })\n\nconst addStats = (statsAcc: EntityCompletionStats, statsToAdd: EntityCompletionStats): void => {\n  statsAcc.total += statsToAdd.total\n  statsAcc.filled += statsToAdd.filled\n}\n\nconst isAttributeRequired = (entity: ArenaRecordNode, nodeDef: NodeDef<NodeDefType, NodeDefProps>): boolean =>\n  NodeDefs.isKey(nodeDef) ||\n  NodeDefs.isRequired(nodeDef) ||\n  (NodeDefs.isRequiredIfDefined(nodeDef) && Nodes.isChildRequired(entity, nodeDef.uuid))\n\nconst getAttributeCompletionStats = (params: {\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { record, entity, nodeDef } = params\n\n  if (NodeDefs.isMultiple(nodeDef)) {\n    const minCount = Nodes.getChildrenMinCount({ parentNode: entity, nodeDef })\n    if (Number.isNaN(minCount) || minCount <= 0) return emptyStats()\n\n    const filledNodesCount = getChildren(entity, nodeDef.uuid)(record).filter(Nodes.isValueNotBlank).length\n\n    return { total: minCount, filled: Math.min(filledNodesCount, minCount) }\n  }\n\n  if (!isAttributeRequired(entity, nodeDef)) return emptyStats()\n\n  const node = getChildren(entity, nodeDef.uuid)(record)[0]\n  return { total: 1, filled: node && Nodes.isValueNotBlank(node) ? 1 : 0 }\n}\n\nconst getChildEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  parentEntity: ArenaRecordNode\n  nodeDef: NodeDef<NodeDefType, NodeDefProps>\n}): EntityCompletionStats => {\n  const { survey, record, parentEntity, nodeDef } = params\n  const childEntities = getChildren(parentEntity, nodeDef.uuid)(record)\n\n  if (NodeDefs.isSingle(nodeDef)) {\n    const childEntity = childEntities[0]\n    return childEntity ? getEntityCompletionStats({ survey, record, entity: childEntity }) : emptyStats()\n  }\n\n  const minCountRaw = Nodes.getChildrenMinCount({ parentNode: parentEntity, nodeDef })\n  const minCount = Number.isNaN(minCountRaw) ? 0 : Math.max(minCountRaw, 0)\n\n  const stats = emptyStats()\n  // entities added beyond the min count are still expected to be complete\n  for (const childEntity of childEntities) {\n    addStats(stats, getEntityCompletionStats({ survey, record, entity: childEntity }))\n  }\n  // a missing repetition (below the min count) counts as a single incomplete unit\n  stats.total += Math.max(minCount - childEntities.length, 0)\n  return stats\n}\n\nexport const getEntityCompletionStats = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n  includeNestedEntities?: boolean\n}): EntityCompletionStats => {\n  const { survey, record, entity, includeNestedEntities = true } = params\n  const entityDef = Surveys.getNodeDefByUuid({ survey, uuid: entity.nodeDefUuid })\n  const childDefs = Surveys.getNodeDefChildren({ survey, nodeDef: entityDef }).filter(\n    NodeDefs.isInCycle(getCycle(record))\n  )\n\n  const stats = emptyStats()\n  for (const childDef of childDefs) {\n    if (!Nodes.isChildApplicable(entity, childDef.uuid)) continue\n\n    if (NodeDefs.isEntity(childDef)) {\n      if (!includeNestedEntities) continue\n      addStats(stats, getChildEntityCompletionStats({ survey, record, parentEntity: entity, nodeDef: childDef }))\n    } else {\n      addStats(stats, getAttributeCompletionStats({ record, entity, nodeDef: childDef }))\n    }\n  }\n  return stats\n}\n\nconst toCompletionPercent = (stats: EntityCompletionStats): number => {\n  const { total, filled } = stats\n  if (total <= 0) return 100\n  return Numbers.roundToPrecision((filled / total) * 100, 2)\n}\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering every descendant recursively.\n * A required or key attribute is considered filled when it has a non empty value; multiple attributes and\n * entities are considered filled based on their min count (see Nodes.getChildrenMinCount).\n */\nexport const getEntityCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats(params))\n\n/**\n * Returns the percentage of completion of the given entity (0-100), considering only its own attributes\n * (nested entities are ignored).\n */\nexport const getEntityOwnCompletionPercent = (params: {\n  survey: Survey\n  record: ArenaRecord\n  entity: ArenaRecordNode\n}): number => toCompletionPercent(getEntityCompletionStats({ ...params, includeNestedEntities: false }))\n\n/**\n * Returns the percentage of completion of the given record (0-100), i.e. the completion of its root entity.\n */\nexport const getRecordCompletionPercent = (params: { survey: Survey; record: ArenaRecord }): number => {\n  const { survey, record } = params\n  const rootEntity = getRoot(record)\n  return rootEntity ? getEntityCompletionPercent({ survey, record, entity: rootEntity }) : 0\n}\n"]}

package/dist/utils/fileProcessor.js

@@ -118,6 +118,7 @@ class FileProcessor {
         this.currentChunkNumber = startFromChunk;
         this.calculateFileSize()
             .then((fileSize) => {
+            var _a;
             if (runId !== this.runId)
                 return;
             this.totalFileSize = fileSize;
@@ -125,6 +126,12 @@ class FileProcessor {
             if (this.totalChunks > 0) {
                 this.processNextChunk();
             }
+            else {
+                // empty file: nothing to process, complete immediately (callers wait for onComplete)
+                this.running = false;
+                this.completed = true;
+                (_a = this.onComplete) === null || _a === void 0 ? void 0 : _a.call(this);
+            }
         })
             .catch((error) => {
             if (runId !== this.runId)

package/dist/utils/fileProcessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../src/utils/fileProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { RetryProcessor } from './retryProcessor'\n\ntype ChunkProcessor = (args: {\n  chunk: number\n  content: Blob | string | Uint8Array\n  totalChunks: number\n  totalFileSize: number\n}) => Promise<any>\n\nexport type FileProcessorConstructorArgs = {\n  file?: File\n  filePath?: string\n  chunkProcessor: ChunkProcessor\n  onError?: (error: Error) => void\n  onComplete?: (result: any) => void\n  chunkSize?: number\n  maxTryings?: number\n  /**\n   * Delay (in milliseconds) before retrying a failed chunk, doubled at every further retry.\n   */\n  retryDelay?: number\n}\n\nexport class FileProcessor {\n  static readonly defaultChunkSize = 1024 * 1024 * 10 // 10MB\n  static readonly defaultMaxTryings = 5\n  static readonly defaultRetryDelay = 1000 // 1s, then 2s, 4s...\n\n  private readonly file?: File\n  private readonly filePath?: string\n  private readonly chunkProcessor: ChunkProcessor\n  private readonly chunkSize: number\n  private readonly maxTryings: number\n  private readonly retryDelay: number\n  private readonly onError?: (error: Error) => void\n  private readonly onComplete?: (result?: any) => void\n\n  // State properties\n  protected totalFileSize: number = 0\n  protected running: boolean = false\n  protected totalChunks: number = 0\n  protected currentChunkNumber: number = 0\n  // true while a chunk is being processed (resume must not start a second processing chain)\n  protected processingChunk: boolean = false\n  protected completed: boolean = false\n  // incremented when a processing run is stopped: callbacks of the chunks of previous runs are ignored\n  private runId: number = 0\n  private retryProcessor?: RetryProcessor<any>\n\n  constructor({\n    file,\n    filePath,\n    chunkProcessor,\n    onError,\n    onComplete,\n    chunkSize = FileProcessor.defaultChunkSize,\n    maxTryings = FileProcessor.defaultMaxTryings,\n    retryDelay = FileProcessor.defaultRetryDelay,\n  }: FileProcessorConstructorArgs) {\n    this.file = file\n    this.filePath = filePath\n    this.chunkProcessor = chunkProcessor\n    this.chunkSize = chunkSize\n    this.maxTryings = maxTryings\n    this.retryDelay = retryDelay\n    this.onError = onError\n    this.onComplete = onComplete\n\n    if (!this.file && !this.filePath) {\n      throw new Error('File or filePath not specified')\n    }\n\n    this.reset()\n  }\n\n  private cancelCurrentRun(): void {\n    this.runId += 1\n    this.retryProcessor?.stop()\n    this.retryProcessor = undefined\n  }\n\n  protected reset(): void {\n    this.cancelCurrentRun()\n    this.running = false\n    this.totalChunks = 0\n    this.currentChunkNumber = 0\n    this.totalFileSize = 0\n    this.processingChunk = false\n    this.completed = false\n  }\n\n  protected calculateFileSize(): Promise<number> {\n    return Promise.resolve(this.file?.size ?? 0)\n  }\n\n  protected onFail(error: Error): void {\n    this.onError?.(error)\n  }\n\n  protected extractCurrentFileChunk(): Promise<Blob | string | Uint8Array> {\n    const { file, currentChunkNumber, totalChunks, chunkSize } = this\n    if (!file) {\n      return Promise.reject(new Error('File property not initialized'))\n    }\n    return Promise.resolve(\n      file.slice(\n        (currentChunkNumber - 1) * chunkSize,\n        currentChunkNumber === totalChunks ? undefined : currentChunkNumber * chunkSize\n      )\n    )\n  }\n\n  protected processNextChunk(): void {\n    const { chunkProcessor, currentChunkNumber, totalFileSize, totalChunks, maxTryings, retryDelay, runId } = this\n    const isStale = () => runId !== this.runId\n\n    this.processingChunk = true\n    this.extractCurrentFileChunk()\n      .then((content) => {\n        if (isStale()) return\n        const retryProcessor = new RetryProcessor<any>({\n          processor: () => chunkProcessor({ chunk: currentChunkNumber, totalFileSize, totalChunks, content }),\n          onSuccess: (chunkResult) => {\n            if (isStale()) return\n            this.processingChunk = false\n            if (this.currentChunkNumber < totalChunks) {\n              // move to the next chunk also when paused: resume will continue from it\n              this.currentChunkNumber += 1\n              if (this.running) {\n                this.processNextChunk()\n              }\n            } else {\n              this.running = false\n              this.completed = true\n              // called outside the retried processor: if it throws, the last chunk is not processed again\n              this.onComplete?.(chunkResult)\n            }\n          },\n          onFail: (error: Error) => {\n            if (isStale()) return\n            this.processingChunk = false\n            this.onFail(error)\n            this.running = false\n          },\n          maxTryings,\n          retryDelay,\n        })\n        this.retryProcessor = retryProcessor\n        retryProcessor.start()\n      })\n      .catch((error) => {\n        if (isStale()) return\n        this.processingChunk = false\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  start(startFromChunk: number = 1): void {\n    // a previous run still in progress must not continue in parallel\n    this.cancelCurrentRun()\n    const { runId } = this\n    this.processingChunk = false\n    this.running = true\n    this.completed = false\n    this.currentChunkNumber = startFromChunk\n    this.calculateFileSize()\n      .then((fileSize) => {\n        if (runId !== this.runId) return\n        this.totalFileSize = fileSize\n        this.totalChunks = Math.ceil(fileSize / this.chunkSize)\n        if (this.totalChunks > 0) {\n          this.processNextChunk()\n        }\n      })\n      .catch((error) => {\n        if (runId !== this.runId) return\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  stop(): void {\n    this.reset()\n  }\n\n  pause(): void {\n    this.running = false\n  }\n\n  resume(): void {\n    if (this.running || this.completed) return\n    this.running = true\n    // if a chunk is still being processed, processing continues when it completes\n    if (!this.processingChunk && this.totalChunks > 0) {\n      this.processNextChunk()\n    }\n  }\n}\n"]}
+{"version":3,"file":"fileProcessor.js","sourceRoot":"","sources":["../../src/utils/fileProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { RetryProcessor } from './retryProcessor'\n\ntype ChunkProcessor = (args: {\n  chunk: number\n  content: Blob | string | Uint8Array\n  totalChunks: number\n  totalFileSize: number\n}) => Promise<any>\n\nexport type FileProcessorConstructorArgs = {\n  file?: File\n  filePath?: string\n  chunkProcessor: ChunkProcessor\n  onError?: (error: Error) => void\n  onComplete?: (result: any) => void\n  chunkSize?: number\n  maxTryings?: number\n  /**\n   * Delay (in milliseconds) before retrying a failed chunk, doubled at every further retry.\n   */\n  retryDelay?: number\n}\n\nexport class FileProcessor {\n  static readonly defaultChunkSize = 1024 * 1024 * 10 // 10MB\n  static readonly defaultMaxTryings = 5\n  static readonly defaultRetryDelay = 1000 // 1s, then 2s, 4s...\n\n  private readonly file?: File\n  private readonly filePath?: string\n  private readonly chunkProcessor: ChunkProcessor\n  private readonly chunkSize: number\n  private readonly maxTryings: number\n  private readonly retryDelay: number\n  private readonly onError?: (error: Error) => void\n  private readonly onComplete?: (result?: any) => void\n\n  // State properties\n  protected totalFileSize: number = 0\n  protected running: boolean = false\n  protected totalChunks: number = 0\n  protected currentChunkNumber: number = 0\n  // true while a chunk is being processed (resume must not start a second processing chain)\n  protected processingChunk: boolean = false\n  protected completed: boolean = false\n  // incremented when a processing run is stopped: callbacks of the chunks of previous runs are ignored\n  private runId: number = 0\n  private retryProcessor?: RetryProcessor<any>\n\n  constructor({\n    file,\n    filePath,\n    chunkProcessor,\n    onError,\n    onComplete,\n    chunkSize = FileProcessor.defaultChunkSize,\n    maxTryings = FileProcessor.defaultMaxTryings,\n    retryDelay = FileProcessor.defaultRetryDelay,\n  }: FileProcessorConstructorArgs) {\n    this.file = file\n    this.filePath = filePath\n    this.chunkProcessor = chunkProcessor\n    this.chunkSize = chunkSize\n    this.maxTryings = maxTryings\n    this.retryDelay = retryDelay\n    this.onError = onError\n    this.onComplete = onComplete\n\n    if (!this.file && !this.filePath) {\n      throw new Error('File or filePath not specified')\n    }\n\n    this.reset()\n  }\n\n  private cancelCurrentRun(): void {\n    this.runId += 1\n    this.retryProcessor?.stop()\n    this.retryProcessor = undefined\n  }\n\n  protected reset(): void {\n    this.cancelCurrentRun()\n    this.running = false\n    this.totalChunks = 0\n    this.currentChunkNumber = 0\n    this.totalFileSize = 0\n    this.processingChunk = false\n    this.completed = false\n  }\n\n  protected calculateFileSize(): Promise<number> {\n    return Promise.resolve(this.file?.size ?? 0)\n  }\n\n  protected onFail(error: Error): void {\n    this.onError?.(error)\n  }\n\n  protected extractCurrentFileChunk(): Promise<Blob | string | Uint8Array> {\n    const { file, currentChunkNumber, totalChunks, chunkSize } = this\n    if (!file) {\n      return Promise.reject(new Error('File property not initialized'))\n    }\n    return Promise.resolve(\n      file.slice(\n        (currentChunkNumber - 1) * chunkSize,\n        currentChunkNumber === totalChunks ? undefined : currentChunkNumber * chunkSize\n      )\n    )\n  }\n\n  protected processNextChunk(): void {\n    const { chunkProcessor, currentChunkNumber, totalFileSize, totalChunks, maxTryings, retryDelay, runId } = this\n    const isStale = () => runId !== this.runId\n\n    this.processingChunk = true\n    this.extractCurrentFileChunk()\n      .then((content) => {\n        if (isStale()) return\n        const retryProcessor = new RetryProcessor<any>({\n          processor: () => chunkProcessor({ chunk: currentChunkNumber, totalFileSize, totalChunks, content }),\n          onSuccess: (chunkResult) => {\n            if (isStale()) return\n            this.processingChunk = false\n            if (this.currentChunkNumber < totalChunks) {\n              // move to the next chunk also when paused: resume will continue from it\n              this.currentChunkNumber += 1\n              if (this.running) {\n                this.processNextChunk()\n              }\n            } else {\n              this.running = false\n              this.completed = true\n              // called outside the retried processor: if it throws, the last chunk is not processed again\n              this.onComplete?.(chunkResult)\n            }\n          },\n          onFail: (error: Error) => {\n            if (isStale()) return\n            this.processingChunk = false\n            this.onFail(error)\n            this.running = false\n          },\n          maxTryings,\n          retryDelay,\n        })\n        this.retryProcessor = retryProcessor\n        retryProcessor.start()\n      })\n      .catch((error) => {\n        if (isStale()) return\n        this.processingChunk = false\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  start(startFromChunk: number = 1): void {\n    // a previous run still in progress must not continue in parallel\n    this.cancelCurrentRun()\n    const { runId } = this\n    this.processingChunk = false\n    this.running = true\n    this.completed = false\n    this.currentChunkNumber = startFromChunk\n    this.calculateFileSize()\n      .then((fileSize) => {\n        if (runId !== this.runId) return\n        this.totalFileSize = fileSize\n        this.totalChunks = Math.ceil(fileSize / this.chunkSize)\n        if (this.totalChunks > 0) {\n          this.processNextChunk()\n        } else {\n          // empty file: nothing to process, complete immediately (callers wait for onComplete)\n          this.running = false\n          this.completed = true\n          this.onComplete?.()\n        }\n      })\n      .catch((error) => {\n        if (runId !== this.runId) return\n        this.onFail(error)\n        this.running = false\n      })\n  }\n\n  stop(): void {\n    this.reset()\n  }\n\n  pause(): void {\n    this.running = false\n  }\n\n  resume(): void {\n    if (this.running || this.completed) return\n    this.running = true\n    // if a chunk is still being processed, processing continues when it completes\n    if (!this.processingChunk && this.totalChunks > 0) {\n      this.processNextChunk()\n    }\n  }\n}\n"]}

package/package.json

@@ -4,7 +4,7 @@
     "name": "OpenForis",
     "email": "openforis.arena@gmail.com"
   },
-  "version": "2.18.12",
+  "version": "2.18.14",
   "description": "Arena core module",
   "repository": {
     "type": "git",