@openforis/arena-core 2.3.33 → 2.3.35

package/dist/esm/geo/points/bearing.js

@@ -2,13 +2,24 @@ import { bearing as bearingTurf } from '@turf/bearing';
 import { DEFAULT_SRS_INDEX } from '../../srs';
 import { toLatLong } from './toLatLong';
 import { Numbers } from '../../utils';
+/**
+ * Calculates the angle (bearing) in degrees from pointFrom to pointTo.
+ * Returns the clockwise angle from north (0° = north, 90° = east, 180° = south, 270° = west).
+ *
+ * @param {!object} pointFrom - Start point.
+ * @param {!object} pointTo - End point.
+ * @param {!SRSIndex} srsIndex - SRSs indexed by SRS code.
+ * @returns {number} - Bearing angle in degrees [0-360).
+ */
 export const bearing = (pointFrom, pointTo, srsIndex = DEFAULT_SRS_INDEX) => {
     const point1LatLong = toLatLong(pointFrom, srsIndex);
     const point2LatLong = toLatLong(pointTo, srsIndex);
     if (!point1LatLong || !point2LatLong)
         return null;
+    // Turf expects [longitude, latitude] format
     const from = [point1LatLong.x, point1LatLong.y];
     const to = [point2LatLong.x, point2LatLong.y];
+    // Turf returns bearings in the range [-180, 180]; normalize to [0, 360)
     const rawBearing = bearingTurf(from, to);
     return Numbers.absMod(360)(rawBearing);
 };

package/dist/esm/geo/points/bearing.js.map

@@ -1 +1 @@
-{"version":3,"file":"bearing.js","sourceRoot":"","sources":["../../../../src/geo/points/bearing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAWrC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,SAAgB,EAAE,OAAc,EAAE,WAAqB,iBAAiB,EAAiB,EAAE;IACjH,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACpD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAElD,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAGjD,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAG7C,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAA;AACxC,CAAC,CAAA"}
+{"version":3,"file":"bearing.js","sourceRoot":"","sources":["../../../../src/geo/points/bearing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,SAAgB,EAAE,OAAc,EAAE,WAAqB,iBAAiB,EAAiB,EAAE;IACjH,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACpD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAElD,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAEjD,4CAA4C;IAC5C,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAE7C,wEAAwE;IACxE,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAA;AACxC,CAAC,CAAA","sourcesContent":["import { bearing as bearingTurf } from '@turf/bearing'\n\nimport { Point } from '../point'\nimport { DEFAULT_SRS_INDEX, SRSIndex } from '../../srs'\nimport { toLatLong } from './toLatLong'\nimport { Numbers } from '../../utils'\n\n/**\n * Calculates the angle (bearing) in degrees from pointFrom to pointTo.\n * Returns the clockwise angle from north (0° = north, 90° = east, 180° = south, 270° = west).\n *\n * @param {!object} pointFrom - Start point.\n * @param {!object} pointTo - End point.\n * @param {!SRSIndex} srsIndex - SRSs indexed by SRS code.\n * @returns {number} - Bearing angle in degrees [0-360).\n */\nexport const bearing = (pointFrom: Point, pointTo: Point, srsIndex: SRSIndex = DEFAULT_SRS_INDEX): number | null => {\n  const point1LatLong = toLatLong(pointFrom, srsIndex)\n  const point2LatLong = toLatLong(pointTo, srsIndex)\n\n  if (!point1LatLong || !point2LatLong) return null\n\n  // Turf expects [longitude, latitude] format\n  const from = [point1LatLong.x, point1LatLong.y]\n  const to = [point2LatLong.x, point2LatLong.y]\n\n  // Turf returns bearings in the range [-180, 180]; normalize to [0, 360)\n  const rawBearing = bearingTurf(from, to)\n  return Numbers.absMod(360)(rawBearing)\n}\n"]}

package/dist/esm/geo/points/distance.js

@@ -1,11 +1,20 @@
 import { distance as turfDistance } from '@turf/distance';
 import { DEFAULT_SRS_INDEX } from '../../srs';
 import { toLatLong } from './toLatLong';
+/**
+ * Takes two points and returns the distance between them as the crow flies (in meters).
+ *
+ * @param {!object} pointFrom - Start point.
+ * @param {!object} pointTo - End point.
+ * @param {!SRSIndex} srsIndex - SRSs indexed by SRS code.
+ * @returns {number} - Distance between the specified points in meters.
+ */
 export const distance = (pointFrom, pointTo, srsIndex = DEFAULT_SRS_INDEX) => {
     const point1LatLong = toLatLong(pointFrom, srsIndex);
     const point2LatLong = toLatLong(pointTo, srsIndex);
     if (!point1LatLong || !point2LatLong)
         return null;
+    // Turf expects [longitude, latitude] format
     const from = [point1LatLong.x, point1LatLong.y];
     const to = [point2LatLong.x, point2LatLong.y];
     return turfDistance(from, to, { units: 'meters' });

package/dist/esm/geo/points/distance.js.map

@@ -1 +1 @@
-{"version":3,"file":"distance.js","sourceRoot":"","sources":["../../../../src/geo/points/distance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAUvC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAgB,EAAE,OAAc,EAAE,WAAqB,iBAAiB,EAAiB,EAAE;IAClH,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACpD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAElD,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAGjD,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAE7C,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;AACpD,CAAC,CAAA"}
+{"version":3,"file":"distance.js","sourceRoot":"","sources":["../../../../src/geo/points/distance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,SAAgB,EAAE,OAAc,EAAE,WAAqB,iBAAiB,EAAiB,EAAE;IAClH,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACpD,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAElD,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAEjD,4CAA4C;IAC5C,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC/C,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAE7C,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;AACpD,CAAC,CAAA","sourcesContent":["import { distance as turfDistance } from '@turf/distance'\nimport { DEFAULT_SRS_INDEX, SRSIndex } from '../../srs'\nimport { Point } from '../point'\nimport { toLatLong } from './toLatLong'\n\n/**\n * Takes two points and returns the distance between them as the crow flies (in meters).\n *\n * @param {!object} pointFrom - Start point.\n * @param {!object} pointTo - End point.\n * @param {!SRSIndex} srsIndex - SRSs indexed by SRS code.\n * @returns {number} - Distance between the specified points in meters.\n */\nexport const distance = (pointFrom: Point, pointTo: Point, srsIndex: SRSIndex = DEFAULT_SRS_INDEX): number | null => {\n  const point1LatLong = toLatLong(pointFrom, srsIndex)\n  const point2LatLong = toLatLong(pointTo, srsIndex)\n\n  if (!point1LatLong || !point2LatLong) return null\n\n  // Turf expects [longitude, latitude] format\n  const from = [point1LatLong.x, point1LatLong.y]\n  const to = [point2LatLong.x, point2LatLong.y]\n\n  return turfDistance(from, to, { units: 'meters' })\n}\n"]}

package/dist/esm/geo/points/equals.js.map

@@ -1 +1 @@
-{"version":3,"file":"equals.js","sourceRoot":"","sources":["../../../../src/geo/points/equals.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAa,EAAE,MAAa,EAAW,EAAE;IAC9D,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAA;AACpF,CAAC,CAAA"}
+{"version":3,"file":"equals.js","sourceRoot":"","sources":["../../../../src/geo/points/equals.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAa,EAAE,MAAa,EAAW,EAAE;IAC9D,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAClC,OAAO,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAA;AACpF,CAAC,CAAA","sourcesContent":["import { Point } from '../point'\n\nexport const equals = (point1: Point, point2: Point): boolean => {\n  if (point1 === point2) return true\n  return point1.srs === point2.srs && point1.x === point2.x && point1.y === point2.y\n}\n"]}

package/dist/esm/geo/points/getSrs.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSrs.js","sourceRoot":"","sources":["../../../../src/geo/points/getSrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,WAAW,CAAA;AAEtD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAA4C,EAAmB,EAAE;IACtF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IACjC,IAAI,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAA;IACpB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC,CAAA"}
+{"version":3,"file":"getSrs.js","sourceRoot":"","sources":["../../../../src/geo/points/getSrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,WAAW,CAAA;AAEtD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAA4C,EAAmB,EAAE;IACtF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IACjC,IAAI,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAA;IACpB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC,CAAA","sourcesContent":["import { DEFAULT_SRS, SRS, SRSIndex } from '../../srs'\n\nexport const getSrs = (params: { code: string; srsIndex: SRSIndex }): SRS | undefined => {\n  const { code, srsIndex } = params\n  if (code === DEFAULT_SRS.code) {\n    return DEFAULT_SRS\n  }\n  return srsIndex[code]\n}\n"]}

package/dist/esm/geo/points/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/geo/points/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,eAAe;IACf,KAAK;IACL,SAAS;IACT,QAAQ;IACR,SAAS;CACV,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/geo/points/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,eAAe;IACf,KAAK;IACL,SAAS;IACT,QAAQ;IACR,SAAS;CACV,CAAA","sourcesContent":["import { bearing } from './bearing'\nimport { distance } from './distance'\nimport { equals } from './equals'\nimport { isValid } from './isValid'\nimport { pointAtDistance } from './pointAtDistance'\nimport { parse } from './parse'\nimport { toLatLong } from './toLatLong'\nimport { toString } from './toString'\nimport { transform } from './transform'\n\nexport const Points = {\n  bearing,\n  distance,\n  equals,\n  isValid,\n  pointAtDistance,\n  parse,\n  toLatLong,\n  toString,\n  transform,\n}\n"]}

package/dist/esm/geo/points/isFilled.js.map

@@ -1 +1 @@
-{"version":3,"file":"isFilled.js","sourceRoot":"","sources":["../../../../src/geo/points/isFilled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGrC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAW,EAAE,CAChD,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"isFilled.js","sourceRoot":"","sources":["../../../../src/geo/points/isFilled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGrC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAW,EAAE,CAChD,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA","sourcesContent":["import { Objects } from '../../utils'\nimport { Point } from '../point'\n\nexport const isFilled = (point: Point): boolean =>\n  !Objects.isEmpty(point) && !Objects.isEmpty(point.srs) && !Objects.isEmpty(point.x) && !Objects.isEmpty(point.y)\n"]}

package/dist/esm/geo/points/isValid.js

@@ -5,7 +5,7 @@ import { equals } from './equals';
 import { getSrs } from './getSrs';
 import { isFilled } from './isFilled';
 import { toLatLong } from './toLatLong';
-const INVALID_LAT_LONG_POINT = PointFactory.createInstance({ x: 0, y: 90 });
+const INVALID_LAT_LONG_POINT = PointFactory.createInstance({ x: 0, y: 90 }); // Proj4 returns [0,90] when a wrong coordinate is projected into lat-lon
 export const isValid = (point, srsIndex = DEFAULT_SRS_INDEX) => {
     if (!point || !isFilled(point))
         return false;

package/dist/esm/geo/points/isValid.js.map

@@ -1 +1 @@
-{"version":3,"file":"isValid.js","sourceRoot":"","sources":["../../../../src/geo/points/isValid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,sBAAsB,GAAU,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,WAAqB,iBAAiB,EAAW,EAAE;IACvF,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAE5C,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAExD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC/C,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC;QAAE,OAAO,KAAK,CAAA;IAE/E,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AAC/F,CAAC,CAAA"}
+{"version":3,"file":"isValid.js","sourceRoot":"","sources":["../../../../src/geo/points/isValid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,sBAAsB,GAAU,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA,CAAC,yEAAyE;AAE5J,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,WAAqB,iBAAiB,EAAW,EAAE;IACvF,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAE5C,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAExD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC/C,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC;QAAE,OAAO,KAAK,CAAA;IAE/E,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AAC/F,CAAC,CAAA","sourcesContent":["import { DEFAULT_SRS_INDEX, SRSIndex } from '../../srs'\nimport { Numbers } from '../../utils'\nimport { Point } from '../point'\nimport { PointFactory } from '../pointFactory'\nimport { equals } from './equals'\nimport { getSrs } from './getSrs'\nimport { isFilled } from './isFilled'\nimport { toLatLong } from './toLatLong'\n\nconst INVALID_LAT_LONG_POINT: Point = PointFactory.createInstance({ x: 0, y: 90 }) // Proj4 returns [0,90] when a wrong coordinate is projected into lat-lon\n\nexport const isValid = (point: Point, srsIndex: SRSIndex = DEFAULT_SRS_INDEX): boolean => {\n  if (!point || !isFilled(point)) return false\n\n  if (!getSrs({ code: point.srs, srsIndex })) return false\n\n  const pointLatLong = toLatLong(point, srsIndex)\n  if (!pointLatLong || equals(pointLatLong, INVALID_LAT_LONG_POINT)) return false\n\n  return Numbers.between(pointLatLong.x, -180, 180) && Numbers.between(pointLatLong.y, -90, 90)\n}\n"]}

package/dist/esm/geo/points/parse.js

@@ -1,5 +1,14 @@
 import { PointFactory } from '../pointFactory';
 const POINT_REGEX = /SRID=((EPSG:)?(\w+));POINT\((-?\d+(\.\d+)?) (-?\d+(\.\d+)?)\)/;
+/**
+ * Parses a point in the format: SRID=SRS_CODE;POINT(X Y)
+ * (X and Y separated by a space). Valid examples are:
+ * - SRID=EPSG:4326;POINT(12.489060 41.882788)
+ * - SRID=4326;POINT(12 41).
+ *
+ * @param {!(string | object)} value - The point to parse. It can be a string or an object.
+ * @returns {Point} - The parsed Point object.
+ */
 export const parse = (value) => {
     if (!value)
         return null;

package/dist/esm/geo/points/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/geo/points/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,WAAW,GAAG,+DAA+D,CAAA;AAWnF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAsB,EAAgB,EAAE;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAc,CAAA;IAEpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAEvB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,YAAY,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../src/geo/points/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,WAAW,GAAG,+DAA+D,CAAA;AAEnF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAsB,EAAgB,EAAE;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAEvB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAc,CAAA;IAEpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAEvB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1B,OAAO,YAAY,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACnD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA","sourcesContent":["import { Point } from '../point'\nimport { PointFactory } from '../pointFactory'\n\nconst POINT_REGEX = /SRID=((EPSG:)?(\\w+));POINT\\((-?\\d+(\\.\\d+)?) (-?\\d+(\\.\\d+)?)\\)/\n\n/**\n * Parses a point in the format: SRID=SRS_CODE;POINT(X Y)\n * (X and Y separated by a space). Valid examples are:\n * - SRID=EPSG:4326;POINT(12.489060 41.882788)\n * - SRID=4326;POINT(12 41).\n *\n * @param {!(string | object)} value - The point to parse. It can be a string or an object.\n * @returns {Point} - The parsed Point object.\n */\nexport const parse = (value: string | object): Point | null => {\n  if (!value) return null\n\n  if (typeof value === 'object') return value as Point\n\n  if (typeof value === 'string') {\n    const match = POINT_REGEX.exec(value)\n    if (!match) return null\n\n    const srs = match[3]\n    const x = Number(match[4])\n    const y = Number(match[6])\n    return PointFactory.createInstance({ srs, x, y })\n  }\n  return null\n}\n"]}

package/dist/esm/geo/points/pointAtDistance.js

@@ -4,8 +4,18 @@ import { PointFactory } from '../pointFactory';
 import { toLatLong } from './toLatLong';
 import { transform } from './transform';
 import { isValid } from './isValid';
+/**
+ * Takes a point, a distance in meters, and a bearing in degrees, and returns the location of the point at the specified distance and bearing from the original point.
+ * @param params
+ * @param params.origin - The original point from which to calculate the new location.
+ * @param params.distanceMeters - The distance in meters from the original point to the new location.
+ * @param params.bearingDeg - The bearing in degrees from the original point to the new location.
+ * @param params.srsIndex - SRSs indexed by SRS code.
+ * @returns The new point at the specified distance and bearing from the original point, or null if the calculation fails.
+ */
 export const pointAtDistance = ({ origin, distanceMeters, bearingDeg, srsIndex = DEFAULT_SRS_INDEX, }) => {
     const originLatLong = toLatLong(origin, srsIndex);
+    // Validate numeric inputs and lat/long bounds before calling turfDestination
     if (!originLatLong || !isValid(originLatLong, srsIndex)) {
         return null;
     }

package/dist/esm/geo/points/pointAtDistance.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointAtDistance.js","sourceRoot":"","sources":["../../../../src/geo/points/pointAtDistance.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWnC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,MAAM,EACN,cAAc,EACd,UAAU,EACV,QAAQ,GAAG,iBAAiB,GAM7B,EAAgB,EAAE;IACjB,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAGjD,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACnH,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,CAAC;QACrD,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QACjC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;KAClC,CAAC,CAAA;IACF,OAAO,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAC5D,CAAC,CAAA"}
+{"version":3,"file":"pointAtDistance.js","sourceRoot":"","sources":["../../../../src/geo/points/pointAtDistance.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,MAAM,EACN,cAAc,EACd,UAAU,EACV,QAAQ,GAAG,iBAAiB,GAM7B,EAAgB,EAAE;IACjB,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAEjD,6EAA6E;IAC7E,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACnH,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,CAAC;QACrD,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QACjC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;KAClC,CAAC,CAAA;IACF,OAAO,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAC5D,CAAC,CAAA","sourcesContent":["import turfDestination from '@turf/destination'\n\nimport { DEFAULT_SRS_INDEX, SRSIndex } from '../../srs'\nimport { Point } from '../point'\nimport { PointFactory } from '../pointFactory'\nimport { toLatLong } from './toLatLong'\nimport { transform } from './transform'\nimport { isValid } from './isValid'\n\n/**\n * Takes a point, a distance in meters, and a bearing in degrees, and returns the location of the point at the specified distance and bearing from the original point.\n * @param params\n * @param params.origin - The original point from which to calculate the new location.\n * @param params.distanceMeters - The distance in meters from the original point to the new location.\n * @param params.bearingDeg - The bearing in degrees from the original point to the new location.\n * @param params.srsIndex - SRSs indexed by SRS code.\n * @returns The new point at the specified distance and bearing from the original point, or null if the calculation fails.\n */\nexport const pointAtDistance = ({\n  origin,\n  distanceMeters,\n  bearingDeg,\n  srsIndex = DEFAULT_SRS_INDEX,\n}: {\n  origin: Point\n  distanceMeters: number\n  bearingDeg: number\n  srsIndex?: SRSIndex\n}): Point | null => {\n  const originLatLong = toLatLong(origin, srsIndex)\n\n  // Validate numeric inputs and lat/long bounds before calling turfDestination\n  if (!originLatLong || !isValid(originLatLong, srsIndex)) {\n    return null\n  }\n  if (!Number.isFinite(distanceMeters) || distanceMeters < 0) {\n    return null\n  }\n  if (!Number.isFinite(bearingDeg)) {\n    return null\n  }\n  const target = turfDestination([originLatLong.x, originLatLong.y], distanceMeters, bearingDeg, { units: 'meters' })\n  const targetPointLatLong = PointFactory.createInstance({\n    x: target.geometry.coordinates[0],\n    y: target.geometry.coordinates[1],\n  })\n  return transform(targetPointLatLong, origin.srs, srsIndex)\n}\n"]}

package/dist/esm/geo/points/toLatLong.js.map

@@ -1 +1 @@
-{"version":3,"file":"toLatLong.js","sourceRoot":"","sources":["../../../../src/geo/points/toLatLong.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAY,MAAM,WAAW,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,QAAkB,EAAgB,EAAE,CAC1E,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"toLatLong.js","sourceRoot":"","sources":["../../../../src/geo/points/toLatLong.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAY,MAAM,WAAW,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,QAAkB,EAAgB,EAAE,CAC1E,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA","sourcesContent":["import { DEFAULT_SRS, SRSIndex } from '../../srs'\nimport { Point } from '../point'\nimport { transform } from './transform'\n\nexport const toLatLong = (point: Point, srsIndex: SRSIndex): Point | null =>\n  transform(point, DEFAULT_SRS.code, srsIndex)\n"]}

package/dist/esm/geo/points/toString.js.map

@@ -1 +1 @@
-{"version":3,"file":"toString.js","sourceRoot":"","sources":["../../../../src/geo/points/toString.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAU,EAAE,CAAC,QAAQ,KAAK,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAA"}
+{"version":3,"file":"toString.js","sourceRoot":"","sources":["../../../../src/geo/points/toString.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAU,EAAE,CAAC,QAAQ,KAAK,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAA","sourcesContent":["import { Point } from '../point'\n\nexport const toString = (point: Point): string => `SRID=${point.srs};POINT(${point.x} ${point.y})`\n"]}

package/dist/esm/geo/points/transform.js

@@ -3,6 +3,7 @@ import { DEFAULT_SRS_INDEX } from '../../srs';
 import { PointFactory } from '../pointFactory';
 import { isFilled } from './isFilled';
 import { getSrs } from './getSrs';
+// proj4 parses both WKT strings every time it is called with them: cache the converters by WKT pair
 const convertersCache = new Map();
 const getConverter = (wktFrom, wktTo) => {
     const key = `${wktFrom}\n${wktTo}`;
@@ -13,19 +14,30 @@ const getConverter = (wktFrom, wktTo) => {
     }
     return converter;
 };
+/**
+ * Trasforms the specified point from one SRS into another.
+ *
+ * @param {!Point} point - The point to transform.
+ * @param {!string} srsCodeTo - The SRS code to transform the coordinate into.
+ * @param {SRSIndex} srsIndex - SRSs indexed by SRS code.
+ * @returns {Point|null} - The transformed Point object, null if an error occurred.
+ */
 export const transform = (point, srsCodeTo, srsIndex = DEFAULT_SRS_INDEX) => {
     if (!isFilled(point))
         return null;
     const { srs: srsCodeFrom } = point;
     if (srsCodeFrom === srsCodeTo) {
+        // projection is not needed
         return point;
     }
     const srsFrom = getSrs({ code: srsCodeFrom, srsIndex });
     if (!srsFrom) {
+        // invalid srs specified in point
         return null;
     }
     const srsTo = getSrs({ code: srsCodeTo, srsIndex });
     if (!srsTo) {
+        // invalid target srs code
         return null;
     }
     try {

package/dist/esm/geo/points/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../../src/geo/points/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC,MAAM,eAAe,GAAG,IAAI,GAAG,EAA2B,CAAA;AAE1D,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,KAAa,EAAmB,EAAE;IACvE,MAAM,GAAG,GAAG,GAAG,OAAO,KAAK,KAAK,EAAE,CAAA;IAClC,IAAI,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACjC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAUD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,SAAiB,EAAE,WAAqB,iBAAiB,EAAgB,EAAE;IACjH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEjC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,CAAA;IAElC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAE9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAA;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QAEb,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QAEX,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAA;QACtB,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAExF,OAAO,YAAY,CAAC,cAAc,iCAAM,KAAK,KAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAG,CAAA;IACnF,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../../src/geo/points/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAE,iBAAiB,EAAY,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,oGAAoG;AACpG,MAAM,eAAe,GAAG,IAAI,GAAG,EAA2B,CAAA;AAE1D,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,KAAa,EAAmB,EAAE;IACvE,MAAM,GAAG,GAAG,GAAG,OAAO,KAAK,KAAK,EAAE,CAAA;IAClC,IAAI,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACjC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,SAAiB,EAAE,WAAqB,iBAAiB,EAAgB,EAAE;IACjH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEjC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,CAAA;IAElC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,2BAA2B;QAC3B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAA;IACvD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,iCAAiC;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAA;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,0BAA0B;QAC1B,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAA;QACtB,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAExF,OAAO,YAAY,CAAC,cAAc,iCAAM,KAAK,KAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAG,CAAA;IACnF,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC,CAAA","sourcesContent":["import proj4 from 'proj4'\n\nimport { DEFAULT_SRS_INDEX, SRSIndex } from '../../srs'\nimport { Point } from '../point'\nimport { PointFactory } from '../pointFactory'\nimport { isFilled } from './isFilled'\nimport { getSrs } from './getSrs'\n\n// proj4 parses both WKT strings every time it is called with them: cache the converters by WKT pair\nconst convertersCache = new Map<string, proj4.Converter>()\n\nconst getConverter = (wktFrom: string, wktTo: string): proj4.Converter => {\n  const key = `${wktFrom}\\n${wktTo}`\n  let converter = convertersCache.get(key)\n  if (!converter) {\n    converter = proj4(wktFrom, wktTo)\n    convertersCache.set(key, converter)\n  }\n  return converter\n}\n\n/**\n * Trasforms the specified point from one SRS into another.\n *\n * @param {!Point} point - The point to transform.\n * @param {!string} srsCodeTo - The SRS code to transform the coordinate into.\n * @param {SRSIndex} srsIndex - SRSs indexed by SRS code.\n * @returns {Point|null} - The transformed Point object, null if an error occurred.\n */\nexport const transform = (point: Point, srsCodeTo: string, srsIndex: SRSIndex = DEFAULT_SRS_INDEX): Point | null => {\n  if (!isFilled(point)) return null\n\n  const { srs: srsCodeFrom } = point\n\n  if (srsCodeFrom === srsCodeTo) {\n    // projection is not needed\n    return point\n  }\n  const srsFrom = getSrs({ code: srsCodeFrom, srsIndex })\n  if (!srsFrom) {\n    // invalid srs specified in point\n    return null\n  }\n\n  const srsTo = getSrs({ code: srsCodeTo, srsIndex })\n  if (!srsTo) {\n    // invalid target srs code\n    return null\n  }\n  try {\n    const { x, y } = point\n    const [long, lat] = getConverter(srsFrom.wkt, srsTo.wkt).forward([Number(x), Number(y)])\n\n    return PointFactory.createInstance({ ...point, srs: srsCodeTo, x: long, y: lat })\n  } catch {\n    return null\n  }\n}\n"]}

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export type { AppInfo } from './app'\n\nexport { Authorizer, AuthGroupName, UserStatus, Permission, UserTitle, UserFactory, Users } from './auth'\nexport type {\n  AuthGroup,\n  User,\n  UserAuthGroup,\n  UserAuthGroupProps,\n  AuthToken,\n  UserAuthTokenPayload,\n  UserAuthTokenService,\n  UserPrefs,\n  UserPrefSurveys,\n  UserProps,\n  UserAuthRefreshToken,\n  UserAuthRefreshTokenProps,\n  UserAuthRefreshTokenPayload,\n  UserService,\n  UserTokenPayload,\n  DownloadAuthTokenPayload,\n  UserGroup,\n  UserGroupProps,\n  UserGroupQualifier,\n  UserInvitation,\n} from './auth'\n\nexport { CategoryFactory, CategoryImportColumnType, CategoryItemFactory, CategoryLevelFactory } from './category'\nexport type {\n  CategoryItemProps,\n  Category,\n  CategoryItem,\n  CategoryLevel,\n  CategoryLevelProps,\n  CategoryImportSummary,\n  CategoryImportSummaryColumn,\n  CategoryItemService,\n  CategoryLevelService,\n  CategoryProps,\n  CategoryService,\n} from './category'\n\nexport { Categories, CategoryItems } from './category'\n\nexport { ChainFactory, ChainStatusExec, ChainNodeDefFactory } from './chain'\nexport type {\n  Chain,\n  ChainProps,\n  ChainService,\n  ChainNodeDef,\n  ChainNodeDefProps,\n  ChainNodeDefService,\n  ChainNodeDefAggregate,\n  ChainNodeDefAggregateProps,\n} from './chain'\n\nexport { TraverseMethod } from './common'\nexport type { ArenaObject, ArenaService, Dictionary, Factory, I18n } from './common'\n\nexport type { FlatDataExportOptions, ArenaExportInfoFactoryParams, ArenaExportInfo } from './dataExport'\nexport {\n  FlatDataExportDefaultOptions,\n  FlatDataExportOption,\n  FlatDataFiles,\n  FlatDataExportModel,\n  FlatDataExportColumnDataType,\n  ArenaExportInfoFactory,\n  UniqueFileNamesGenerator,\n} from './dataExport'\n\nexport { DataQueryMode, DataQuerySummaries } from './dataQuery'\nexport type { DataQuery, DataQuerySummary, DataQuerySummaryProps } from './dataQuery'\n\nexport { SystemError } from './error'\n\nexport {\n  ExpressionNodeType,\n  ExpressionNodeEvaluator,\n  ExpressionVariable,\n  JavascriptExpressionEvaluator,\n  JavascriptExpressionParser,\n} from './expression'\nexport type {\n  ArrayExpression,\n  BinaryExpression,\n  CallExpression,\n  CompoundExpression,\n  ConditionalExpression,\n  ExpressionContext,\n  ExpressionEvaluator,\n  ExpressionFunction,\n  ExpressionFunctions,\n  ExpressionNode,\n  ExpressionNodeEvaluatorConstructor,\n  MemberExpression,\n  IdentifierExpression,\n  LiteralExpression,\n  SequenceExpression,\n  ThisExpression,\n  UnaryExpression,\n} from './expression'\n\nexport { ExtraPropDataType, ExtraPropsDataGenerator } from './extraProp'\nexport type { ExtraPropDef, ExtraPropDefs } from './extraProp'\n\nexport { PointFactory, Points } from './geo'\nexport type { Point } from './geo'\n\nexport { JobBase, JobEventType, JobStatus } from './job'\nexport type { Job, JobContext, JobEvent, JobSerialized } from './job'\n\nexport { LanguageCode, Languages, LanguagesISO639part2 } from './language'\nexport type { Labels } from './language'\n\nexport type { Logger } from './logger'\n\nexport type { Message } from './message'\nexport { MessageNotificationType, MessagePropsKey, MessageStatus, MessageTargetUserType, Messages } from './message'\n\nexport { NodeFactory, NodeKeys, NodeMetaKeys, Nodes, NodeValueFormatter, NodeValues } from './node'\nexport type {\n  Node,\n  Node as ArenaRecordNode,\n  NodeMeta,\n  NodePointer,\n  NodeRefData,\n  NodeService,\n  NodesMap,\n  NodeValueCode,\n  NodeValueCoordinate,\n  NodeValueFile,\n  NodeValueTaxon,\n} from './node'\n\nexport {\n  NodeDefCountType,\n  NodeDefType,\n  NodeDefFactory,\n  NodeDefs,\n  NodeDefEntityRenderType,\n  NodeDefFileType,\n  NodeDefTextInputType,\n  NodeDefTextRenderType,\n  FormHeaderColor,\n} from './nodeDef'\n\nexport { NodeDefExpressionEvaluator, NodeDefExpressionValidator } from './nodeDefExpressionEvaluator'\nexport type { CategoryItemProvider, TaxonProvider } from './nodeDefExpressionEvaluator'\n\nexport type {\n  NodeDef,\n  NodeDefLayout,\n  NodeDefMeta,\n  NodeDefProps,\n  NodeDefPropsWithLayout,\n  NodeDefBoolean,\n  NodeDefBooleanProps,\n  NodeDefCode,\n  NodeDefCodeLayout,\n  NodeDefCodeProps,\n  NodeDefCoordinate,\n  NodeDefCoordinateProps,\n  NodeDefDate,\n  NodeDefDecimal,\n  NodeDefDecimalProps,\n  NodeDefEntity,\n  NodeDefEntityChildPosition,\n  NodeDefEntityLayout,\n  NodeDefEntityProps,\n  NodeDefPrintOrientation,\n  NodeDefFile,\n  NodeDefFileProps,\n  NodeDefFormHeader,\n  NodeDefFormHeaderProps,\n  NodeDefInteger,\n  NodeDefPropsAdvanced,\n  NodeDefTaxon,\n  NodeDefTaxonProps,\n  NodeDefText,\n  NodeDefTextProps,\n  NodeDefTextLayout,\n  NodeDefTime,\n  NodeDefTimeProps,\n  NodeDefExpression,\n  NodeDefMap,\n  NodeDefService,\n  NodeDefValidations,\n} from './nodeDef'\n\nexport {\n  NodePointers,\n  RecordCloner,\n  RecordFactory,\n  RecordFixer,\n  Records,\n  RECORD_STEP_DEFAULT,\n  RecordExpressionEvaluator,\n  RecordNodesUpdater,\n  RecordPrettyPrinter,\n  RecordUpdater,\n  RecordUpdateResult,\n  RecordValidator,\n  RecordValidations,\n} from './record'\nexport type {\n  AttributeValidatorParams,\n  AttributesValidatorParams,\n  NodeCreateParams,\n  NodesUpdateParams,\n  Record,\n  Record as ArenaRecord,\n  RecordExpressionContext,\n  RecordExpressionEvaluationContext,\n  RecordService,\n  RecordUpdateOptions,\n  RecordValidatorParams,\n  SortedAttributesValidatorParams,\n} from './record'\n\nexport { ServiceRegistry, ServiceType } from './registry'\n\nexport { DEFAULT_SRS, DEFAULT_SRS_INDEX, SRSFactory } from './srs'\nexport type { SRS, SRSIndex } from './srs'\n\nexport {\n  NodeDefsFixer,\n  SurveyDocImages,\n  SurveyDocImageFactory,\n  SurveyDocPlace,\n  SurveyDependencyType,\n  SurveyFactory,\n  SurveyFileFactory,\n  SurveyFileType,\n  SurveyRefDataFactory,\n  SurveySecurityProp,\n  Surveys,\n  surveyDocImagePropKeys,\n  surveySecurityDefaults,\n  defaultCycle,\n} from './survey'\nexport type {\n  Survey,\n  SurveyCycle,\n  SurveyDependency,\n  SurveyDependencyGraph,\n  SurveyDocImage,\n  SurveyDocImageFactoryParams,\n  SurveyDocImageProps,\n  SurveyFile,\n  SurveyFileFactoryParams,\n  SurveyFileProps,\n  SurveyProps,\n  SurveyRefData,\n  SurveySecurity,\n  SurveyService,\n} from './survey'\n\nexport { Taxa, Taxonomies, TaxonomyFactory, TaxonFactory, TaxonGenerator, VernacularNameFactory } from './taxonomy'\nexport type {\n  VernacularNameParams,\n  TaxonomyFactoryParams,\n  TaxonFactoryParams,\n  Taxonomy,\n  TaxonomyService,\n  VernacularNameProps,\n  VernacularName,\n  TaxonProps,\n  Taxon,\n  TaxonomyProps,\n  TaxonService,\n} from './taxonomy'\n\nexport { SurveyBuilder, SurveyObjectBuilders } from './tests/builder/surveyBuilder'\nexport { RecordBuilder, RecordNodeBuilders } from './tests/builder/recordBuilder'\n\nexport {\n  Arrays,\n  DateFormats,\n  Dates,\n  FileNames,\n  FileProcessor,\n  Numbers,\n  Objects,\n  Promises,\n  Queue,\n  RetryProcessor,\n  Strings,\n  UnitOfTime,\n  UUIDs,\n  Versions,\n} from './utils'\n\nexport type { FileProcessorConstructorArgs, ParsedVersion } from './utils'\n\nexport {\n  FieldValidators,\n  ValidationFactory,\n  ValidationResultFactory,\n  ValidationResults,\n  Validations,\n  ValidationSeverity,\n  Validator,\n  ValidatorErrorKeys,\n} from './validation'\nexport type { FieldValidator, Validation, ValidationFields, ValidationResult, ValidationCounts } from './validation'\n"]}

package/dist/esm/job/JobBase.js

@@ -12,6 +12,27 @@ import { UUIDs } from '../utils';
 import { JobEventType } from './jobEvent';
 import { JobStatus } from './status';
 const PROGRESS_NOTIFICATION_THROTTLE_MILLIS = 1000;
+/**
+ * Asynchronous task handler.
+ *
+ * Status workflow:
+ * - pending
+ * - running
+ * - (end)
+ * -- succeeded
+ * -- failed
+ * -- canceled
+ *
+ * Methods that can be overwritten by subclasses:
+ * - shouldExecute (in tx)
+ * - onStart (in tx)
+ * - execute (in tx)
+ * - beforeSuccess (in tx)
+ * - generateResult (in tx)
+ * - beforeEnd (in tx)
+ * - onEnd (out of tx)
+ * - getErrorInfo
+ */
 export class JobBase {
     constructor(context, innerJobs = []) {
         var _a;
@@ -24,14 +45,18 @@ export class JobBase {
         this.progressThrottleTimeoutId = undefined;
         this.progressThrottleLastRunTime = 0;
         this._stopOnInnerJobFailure = true;
+        // set as soon as cancel() is called (the canceled status is set only after beforeEnd has run)
         this.cancelRequested = false;
         this.beforeEndCalled = false;
+        // inner job events are handled in sequence; executeJobs waits for them before going on
         this.innerJobEventsQueue = Promise.resolve();
         this.context = Object.assign({}, context);
         this.innerJobs = innerJobs;
         this.uuid = UUIDs.v4();
         this.type = (_a = this.context.type) !== null && _a !== void 0 ? _a : this.constructor.name;
         this.total = innerJobs.length > 0 ? innerJobs.length : 1;
+        // Created last, so that createLogger() overrides can safely build the logger name out of
+        // the job identity (e.g. arena's `Job <ClassName> (<uuid>)` log correlation id).
         this.logger = this.createLogger();
     }
     get processed() {
@@ -72,6 +97,10 @@ export class JobBase {
             delete this.context[propName];
         });
     }
+    /**
+     * Registers the listener notified of job events (status changes and progress).
+     * Only one listener can be registered at a time; registering a new one replaces the previous one.
+     */
     onEvent(listener) {
         this.eventListener = listener;
         return this;
@@ -118,10 +147,13 @@ export class JobBase {
             this.cancelRequested = true;
             const currentInnerJob = this.getCurrentInnerJob();
             if (currentInnerJob === null || currentInnerJob === void 0 ? void 0 : currentInnerJob.isRunning()) {
+                // the parent job status will be set to canceled when handling the canceled event of the inner job
                 yield currentInnerJob.cancel({ canceledByAdmin });
                 return;
             }
+            // no inner job running (job without inner jobs, or between two inner jobs)
             this.canceledByAdmin = canceledByAdmin;
+            // release the resources (temp files/directories, streams) allocated before the cancellation
             yield this.runBeforeEnd();
             yield this.setStatus(JobStatus.canceled);
         });
@@ -129,6 +161,9 @@ export class JobBase {
     isCancelRequestedOrNotRunning() {
         return this.cancelRequested || !this.isRunning();
     }
+    /**
+     * Runs beforeEnd only once (it can be called by cancel() and when the job execution ends).
+     */
     runBeforeEnd() {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.beforeEndCalled)
@@ -186,6 +221,7 @@ export class JobBase {
                 }
             }
             finally {
+                // runs only if not already run by cancel()
                 yield this.runBeforeEnd();
                 this.context.tx = undefined;
             }
@@ -194,6 +230,9 @@ export class JobBase {
             }
         });
     }
+    /**
+     * Generates a plain JSON-serializable representation of the job, including its inner jobs.
+     */
     toJSON() {
         const { errors, processed, result, status, total, type, userUuid, uuid } = this;
         return {
@@ -230,13 +269,20 @@ export class JobBase {
                 }
                 currentInnerJob.context = this.context;
                 currentInnerJob.onEvent((event) => {
+                    // handle the inner job events in sequence; errors are logged (they would be unhandled rejections otherwise)
                     this.innerJobEventsQueue = this.innerJobEventsQueue
                         .then(() => this.onInnerJobEvent(event))
                         .catch((error) => { var _a; return this.logError((_a = error === null || error === void 0 ? void 0 : error.stack) !== null && _a !== void 0 ? _a : error); });
                 });
+                // The inner job shares this very context object, and its own start()/executeInTransaction()
+                // clear `context.tx` when they terminate: without saving and restoring it here, the first
+                // inner job would wipe the parent's transaction handle, leaving every following inner job
+                // (and the parent's own beforeSuccess()/beforeEnd()) running outside of the transaction.
+                // start() never throws (it swallows/records errors internally), so a plain restore is enough.
                 const parentTx = this.context.tx;
                 yield currentInnerJob.start(parentTx);
                 this.context.tx = parentTx;
+                // the inner job events (e.g. canceled, failed) update the status of this job
                 yield this.innerJobEventsQueue;
                 if (this.cancelRequested || this.isCanceled() || currentInnerJob.isCanceled()) {
                     break;
@@ -251,10 +297,24 @@ export class JobBase {
             this.logDebug(`- ${this.processed} inner jobs processed successfully`);
         });
     }
+    /**
+     * Runs the job's own work when it has no inner jobs. Default implementation is a no-op, so
+     * subclasses that only supply inner jobs (and never override this) don't need to. It also means
+     * a subclass can safely call `super.execute()` defensively without knowing whether any ancestor
+     * overrides it - if this were `abstract` instead, TypeScript would compile away any runtime
+     * property for it entirely, so `super.execute()` would throw the moment no ancestor overrides it
+     * (confirmed in production: a subclass whose immediate parent didn't override `execute()` crashed
+     * with "(intermediate value).execute is not a function" the instant it called `super.execute()`).
+     */
     execute() {
         return __awaiter(this, void 0, void 0, function* () {
+            // to be extended by subclasses
         });
     }
+    /**
+     * Determines whether the job should actually run.
+     * When it returns false, "execute" (or the inner jobs) will be skipped, but the job will still succeed.
+     */
     shouldExecute() {
         return Promise.resolve(true);
     }
@@ -277,6 +337,9 @@ export class JobBase {
             this.notifyEvent(event);
         });
     }
+    /**
+     * Inner job event handler.
+     */
     onInnerJobEvent(event) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
@@ -286,6 +349,7 @@ export class JobBase {
                 return this.setStatus(status);
             }
             if (status === JobStatus.failed) {
+                // report the errors of the failed inner job in the failed event (and in the errors) of this job
                 Object.assign(this.errors, (_d = (_c = this.getCurrentInnerJob()) === null || _c === void 0 ? void 0 : _c.errors) !== null && _d !== void 0 ? _d : {});
                 return this.setStatus(status);
             }
@@ -301,20 +365,39 @@ export class JobBase {
             this.logDebug(`Unknown inner job status: ${status}`);
         });
     }
+    /**
+     * Called when the job just has been started.
+     */
     onStart() {
         return __awaiter(this, void 0, void 0, function* () {
             this.startTime = new Date();
             yield this.setStatus(JobStatus.running);
         });
     }
+    /**
+     * Called before beforeEnd only if the status will change to 'success'.
+     * Default implementation stores the value returned by generateResult() via setResult().
+     * It runs INSIDE the current db transaction.
+     */
     beforeSuccess() {
         return __awaiter(this, void 0, void 0, function* () {
             this.setResult(yield this.generateResult());
         });
     }
+    /**
+     * Computes the value beforeSuccess() will store as this job's result.
+     * Default implementation returns whatever is already in `this.result`
+     * (e.g. accumulated via earlier setResult() calls during execute()).
+     */
     generateResult() {
         return Promise.resolve(this.result);
     }
+    /**
+     * Updates this job's result. When both the current and incoming values are plain objects,
+     * they are merged (Object.assign); otherwise the incoming value replaces the current one.
+     * This keeps it safe for subclasses whose result is a primitive (e.g. a plain number) as
+     * well as ones that build an object result incrementally across multiple setResult() calls.
+     */
     setResult(result) {
         if (result && typeof result === 'object' && this.result && typeof this.result === 'object') {
             Object.assign(this.result, result);
@@ -323,10 +406,18 @@ export class JobBase {
             this.result = result;
         }
     }
+    /**
+     * Called before onEnd. Useful for flushing resources used by the job before it terminates completely.
+     * It runs INSIDE the current db transaction.
+     */
     beforeEnd() {
         this.logDebug('Cleanup');
         return Promise.resolve();
     }
+    /**
+     * Called when the job status changes to success, failed or canceled
+     * (it runs OUTSIDE of the current db transaction)
+     */
     onEnd() {
         this.endTime = new Date();
         this.cancelNotifyProgress();
@@ -337,6 +428,7 @@ export class JobBase {
         this.errors[key] = error;
     }
     throwError(errorKey, params) {
+        // SystemError: getErrorInfo will report the translatable key instead of a generic error
         throw new SystemError(errorKey, params);
     }
     getErrorInfo(error) {
@@ -388,6 +480,10 @@ export class JobBase {
             return 0;
         return ((_a = this.endTime) !== null && _a !== void 0 ? _a : new Date()).getTime() - this.startTime.getTime();
     }
+    /**
+     * Notifies a progress event to the registered listener, throttled so that fast-changing
+     * progress does not flood consumers (e.g. web socket clients).
+     */
     notifyProgress() {
         const run = () => {
             this.progressThrottleTimeoutId = undefined;
@@ -409,6 +505,9 @@ export class JobBase {
             this.progressThrottleTimeoutId = setTimeout(run, PROGRESS_NOTIFICATION_THROTTLE_MILLIS - elapsed);
         }
     }
+    /**
+     * Cancels any pending throttled progress notification and resets the throttle state.
+     */
     cancelNotifyProgress() {
         if (this.progressThrottleTimeoutId) {
             clearTimeout(this.progressThrottleTimeoutId);