@gisatcz/ptr-be-core 0.0.1-dev.9 → 0.0.3

package/dist/globals/coding/code.dates.d.ts

@@ -4,6 +4,12 @@
  * @returns
  */
 export declare const nowTimestamp: (regime?: "milisecond" | "second") => number;
+/**
+ * Return now local timestamp plus number of seconds to add
+ * @param secondsToAdd Seconds to add from now (1 = now + 1 sec.)
+ * @returns Timestamp of the future (past) on seconds
+ */
+export declare const nowPlusTime: (secondsToAdd: number) => number;
 /**
  * Convert epoch time value into ISO format
  * @param epochValue Epoch value of the timestamp

package/dist/globals/coding/code.formating.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Check, if the string is url
+ * @param candidate Candidate input, to be checked
+ * @returns Is this string url?
+ */
+export declare const isUrl: (candidate: string) => boolean;
+/**
+ * Check, if the string array contain urls
+ * @param candidates Candidate input array, to be checked
+ * @returns Is this string array only from url?
+ */
+export declare const isArrayOfUrls: (candidates: string[]) => boolean;
 /**
  * Check if the value in included in enum posibilities.
  * @param value Value we need to check

package/dist/index.browser.d.ts

@@ -1,5 +1,5 @@
-export { enumCombineValuesToString, enumValuesToArray, enumValuesToString, flattenObject, isInEnum, notEmptyString, randomNumberBetween, removeDuplicitiesFromArray, sortStringArray } from "./globals/coding/code.formating.js";
-export { isoIntervalToTimestamps, nowTimestamp, nowTimestampIso, epochToIsoFormat, hasIsoFormat, isoDateToTimestamp } from "./globals/coding/code.dates.js";
+export { enumCombineValuesToString, enumValuesToArray, enumValuesToString, flattenObject, isInEnum, notEmptyString, randomNumberBetween, removeDuplicitiesFromArray, sortStringArray, isUrl, isArrayOfUrls } from "./globals/coding/code.formating.js";
+export { isoIntervalToTimestamps, nowTimestamp, nowTimestampIso, nowPlusTime, epochToIsoFormat, hasIsoFormat, isoDateToTimestamp } from "./globals/coding/code.dates.js";
 export { csvParseNumbers, csvParseStrings } from "./globals/coding/formats.csv.js";
 export { filterNodeByLabel, findEdgeByLabel, filterEdgeByLabel, findNodeByLabel } from "./globals/panther/utils.panther.js";
 export { type Nullable, type Nullish, type Unsure, type UsurePromise } from "./globals/coding/code.types.js";

package/dist/index.browser.js

@@ -1,5 +1,25 @@
 import { DateTime } from 'luxon';
 
+/**
+ * Check, if the string is url
+ * @param candidate Candidate input, to be checked
+ * @returns Is this string url?
+ */
+const isUrl = (candidate) => {
+    try {
+        new URL(candidate);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Check, if the string array contain urls
+ * @param candidates Candidate input array, to be checked
+ * @returns Is this string array only from url?
+ */
+const isArrayOfUrls = (candidates) => candidates.every(candidate => isUrl(candidate));
 /**
  * Check if the value in included in enum posibilities.
  * @param value Value we need to check
@@ -118,6 +138,14 @@ const nowTimestamp = (regime = "milisecond") => {
     const timestamp = DateTime.now().toMillis();
     return regime === "second" ? Math.round((timestamp / 1000)) : timestamp;
 };
+/**
+ * Return now local timestamp plus number of seconds to add
+ * @param secondsToAdd Seconds to add from now (1 = now + 1 sec.)
+ * @returns Timestamp of the future (past) on seconds
+ */
+const nowPlusTime = (secondsToAdd) => {
+    return Math.round(DateTime.now().plus({ seconds: secondsToAdd }).toSeconds());
+};
 /**
  * Convert epoch time value into ISO format
  * @param epochValue Epoch value of the timestamp
@@ -344,5 +372,5 @@ var UsedTimeseriesSteps;
     UsedTimeseriesSteps["Day"] = "day";
 })(UsedTimeseriesSteps || (UsedTimeseriesSteps = {}));
 
-export { UsedDatasourceLabels, UsedEdgeLabels, UsedNodeLabels, UsedTimeseriesSteps, csvParseNumbers, csvParseStrings, enumCombineValuesToString, enumValuesToArray, enumValuesToString, epochToIsoFormat, filterEdgeByLabel, filterNodeByLabel, findEdgeByLabel, findNodeByLabel, flattenObject, hasIsoFormat, isInEnum, isoDateToTimestamp, isoIntervalToTimestamps, notEmptyString, nowTimestamp, nowTimestampIso, randomNumberBetween, removeDuplicitiesFromArray, sortStringArray };
+export { UsedDatasourceLabels, UsedEdgeLabels, UsedNodeLabels, UsedTimeseriesSteps, csvParseNumbers, csvParseStrings, enumCombineValuesToString, enumValuesToArray, enumValuesToString, epochToIsoFormat, filterEdgeByLabel, filterNodeByLabel, findEdgeByLabel, findNodeByLabel, flattenObject, hasIsoFormat, isArrayOfUrls, isInEnum, isUrl, isoDateToTimestamp, isoIntervalToTimestamps, notEmptyString, nowPlusTime, nowTimestamp, nowTimestampIso, randomNumberBetween, removeDuplicitiesFromArray, sortStringArray };
 //# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","sources":["../src/globals/coding/code.formating.ts","../src/node/api/errors.api.ts","../src/globals/coding/code.dates.ts","../src/globals/coding/formats.csv.ts","../src/globals/panther/utils.panther.ts","../src/globals/panther/enums.panther.ts"],"sourcesContent":["/**\n * Check if the value in included in enum posibilities.\n * @param value Value we need to check\n * @param enumEntity Enum type we check againts the value\n * @returns Is the value in this enum?\n */\nexport const isInEnum = (value: any, enumEntity: any) => {\n    const allEnumValues = Object.values(enumEntity) as string[]\n    return allEnumValues.includes(value)\n  }\n\n/**\n * Sort array of string elements\n * @param rawArray Raw unsorted array of elements\n * @returns Sorted string array\n */\nexport const sortStringArray = (rawArray: string[]) => rawArray.sort()\n\n/**\n * Remove all duplicity string items from an array\n * @param arr Original array with duplicities\n * @returns Array of original values\n */\nexport const removeDuplicitiesFromArray = (arr: any[]) => [...new Set(arr)]\n\n\n/**\n * Check if the string value is not ` \"\" `\n * @param value Value to check\n * @returns Boolean result about the truth\n */\nexport const notEmptyString = (value: string) => value !== \"\"\n\n\n/**\n * Return enum values as array of string\n * @param enumType Type of the enum from code\n * @param separator Optional - separator character\n * @returns Array of enum possible values\n */\nexport const enumValuesToString = (enumType: any, separator = \", \") => Object.values(enumType).join(separator)\n\n/**\n * Return enum values as array of string\n * @param enumTypes Combination of enum types\n * @param separator Optional - separator character\n * @returns Array of enum possible values\n */\nexport const enumCombineValuesToString = (enumTypes: any[], separator = \", \") => enumTypes.map(enumType => enumValuesToString(enumType, separator)).join(separator)\n\n/**\n * Return all enum values as array\n * @param enumType What array we want to work with\n * @returns Array of enum values\n */\nexport const enumValuesToArray = (enumType: any) => Object.values(enumType) as string[]\n\n/**\n * Return random number (integer) between two values\n * @param min \n * @param max \n * @returns \n */\nexport const randomNumberBetween = (min: number, max: number) => {\n  const minAr = Math.ceil(min)\n  const maxAr = Math.floor(max)\n  return Math.floor(Math.random()*(maxAr - minAr + 1) + min)\n}\n\n/**\n * Recursively flattens a nested object. The keys of the resulting object\n * will be the paths to the original values in the nested object, joined by dots.\n *\n * @param obj - The object to flatten.\n * @param prefix - The prefix to use for the keys in the flattened object. Defaults to an empty string.\n * @returns A new object with flattened keys.\n *\n * @example\n * ```typescript\n * const nestedObj = {\n *   a: {\n *     b: {\n *       c: 1\n *     }\n *   },\n *   d: 2\n * };\n * const flatObj = flattenObject(nestedObj);\n * console.log(flatObj);\n * // Output: { 'a.b.c': 1, 'a.b.d': 2 }\n * ```\n */\nexport const flattenObject = (obj: any, prefix = ''): Record<string, any> => {\n    return Object.keys(obj).reduce((acc: Record<string, any>, key: string) => {\n        const propName = prefix ? `${prefix}.${key}` : key\n        if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {\n            Object.assign(acc, flattenObject(obj[key], propName))\n        } else {\n            acc[propName] = obj[key]\n        }\n        return acc\n    }, {})\n}","/**\n * Extract message from exception error (try-catch)\n * @param error error from catch block as any\n * @returns \n */\n export const messageFromError = (error: any) => error[\"message\"] as string\n\n/**\n * We miss a API parameter needed to process action\n */\nexport class InvalidRequestError extends Error{\n  constructor(message: string){\n    super(`Invalid Request: ${message}`)\n  }\n}\n\n/**\n * Where client has general authorization issue\n */\nexport class AuthorizationError extends Error{\n  constructor(){\n    super(`Authorization has failed.`)\n  }\n}","import { DateTime } from \"luxon\"\nimport { InvalidRequestError } from \"../../node/api/errors.api\"\n\n/**\n * Return epoch timestamp\n * @param regime Set if you want milisecond format or second format\n * @returns \n */\nexport const nowTimestamp = (regime: \"milisecond\" | \"second\" = \"milisecond\"): number => {\n  const timestamp = DateTime.now().toMillis()\n  return regime === \"second\" ? Math.round((timestamp / 1000)) : timestamp\n}\n\n/**\n * Convert epoch time value into ISO format\n * @param epochValue Epoch value of the timestamp\n * @returns ISO format of the date\n */\nexport const epochToIsoFormat = (epochValue: number) => DateTime.fromMillis(epochValue).toISO() as string\n\n/**\n * Return epoch timestamp\n * @param regime Set if you want milisecond format or second format\n * @returns \n */\nexport const nowTimestampIso = () => {\n  const timestamp = DateTime.now().toISO()\n  return timestamp as string\n}\n\n/**\n * Check if input date is valid for ISO format\n * @param dateToCheck \n * @returns \n */\n export const hasIsoFormat = (dateToCheck: string) => {\n  try{\n    const toDate = new Date(Date.parse(dateToCheck))\n    const isoCheck = toDate.toISOString().includes(dateToCheck) \n    return isoCheck\n  }\n  catch{\n    return false\n  }\n}\n\n/**\n * Convert date in ISO formtat to milisecond timestamp\n * @param isoDate Date in ISO 8601 format\n * @returns Timestamp representing the date in miliseconds\n */\nexport const isoDateToTimestamp = (isoDate: string) => DateTime.fromISO(isoDate).toMillis()\n\n/**\n * Format ISO 8601 interval to from-to values\n * @param interval Defined inteval in ISO format (from/to) of the UTC\n * @returns Tuple - from timestamp and to timestamp\n */\nexport const isoIntervalToTimestamps = (interval: string): [number, number] => {\n\n  // Split the interval into two parts\n  const intervals = interval.split(\"/\")\n\n  // interval as a single year has just one part\n  if (intervals.length == 1) {\n    const newIso = `${interval}-01-01/${interval}-12-31`\n    return isoIntervalToTimestamps(newIso)\n  }\n\n  // interval with two parts or less than one\n  else if (intervals.length > 2 || intervals.length < 1)\n    throw new InvalidRequestError(\"Interval can have only two parameters\")\n\n  // valid interval with two parts\n  else {\n    if (!intervals.every(interval => hasIsoFormat(interval)))\n      throw new InvalidRequestError(\"Parameter utcIntervalIso is not ISO 8601 time interval (date01/date02) or year\");\n\n    const [int1, int2] = intervals.map(intervalIso => {\n      const cleared = intervalIso.replace(\" \", \"\")\n      return isoDateToTimestamp(cleared)\n    })\n\n    return [int1, int2]\n  }\n}\n","// TODO: Cover by tests\n// TODO: mode to ptr-be-core as general CSV methods\n\n\n/**\n * Parses a single line of CSV-formatted strings into an array of trimmed string values.\n *\n * @param csvStingsLine - A string representing a single line of comma-separated values.\n * @returns An array of strings, each representing a trimmed value from the CSV line.\n */\nexport const csvParseStrings = (csvStingsLine: string): string[] => {\n  return csvStingsLine.split(\",\").map((value: string) => value.trim());\n}\n\n/**\n * Parses a comma-separated string of numbers into an array of numbers.\n *\n * @param csvNumbersLine - A string containing numbers separated by commas (e.g., \"1, 2, 3.5\").\n * @returns An array of numbers parsed from the input string.\n */\nexport const csvParseNumbers = (csvNumbersLine: string): number[] => {\n  return csvNumbersLine.split(\",\").map((value: string) => parseFloat(value.trim()));\n}","import { UsedDatasourceLabels, UsedEdgeLabels, UsedNodeLabels } from \"./enums.panther\"\nimport { GraphEdge } from \"./models.edges\"\nimport { FullPantherEntity } from \"./models.nodes\"\n\n/**\n * Finds the first node in the provided list that contains the specified label.\n *\n * Searches the given array of FullPantherEntity objects and returns the first entity\n * whose `labels` array includes the provided label.\n *\n * @param nodes - Array of FullPantherEntity objects to search through.\n * @param label - Label to match; may be a UsedDatasourceLabels or UsedNodeLabels.\n * @returns The first FullPantherEntity whose `labels` includes `label`, or `undefined`\n *          if no such entity is found.\n *\n * @remarks\n * - The search stops at the first match (uses `Array.prototype.find`).\n * - Label comparison is exact (uses `Array.prototype.includes`), so it is case-sensitive\n *   and requires the same string instance/value.\n *\n * @example\n * const result = findNodeByLabel(nodes, 'datasource-main');\n * if (result) {\n *   // found a node that has the 'datasource-main' label\n * }\n */\nexport const findNodeByLabel = (\n  nodes: FullPantherEntity[],\n  label: UsedDatasourceLabels | UsedNodeLabels): FullPantherEntity | undefined => {\n  return nodes.find(n => n.labels.includes(label))\n}\n\n/**\n * Filters an array of FullPantherEntity objects, returning only those that contain the specified label.\n *\n * The function performs a shallow, non-mutating filter: it returns a new array and does not modify the input.\n * Matching is done using Array.prototype.includes on each entity's `labels` array (strict equality).\n *\n * @param nodes - The array of entities to filter.\n * @param label - The label to match; can be a UsedDatasourceLabels or UsedNodeLabels value.\n * @returns A new array containing only the entities whose `labels` array includes the provided label.\n *\n * @remarks\n * Time complexity is O(n * m) where n is the number of entities and m is the average number of labels per entity.\n *\n * @example\n * ```ts\n * const matched = filterNodeByLabel(entities, 'MY_LABEL');\n * ```\n */\nexport const filterNodeByLabel = (\n  nodes: FullPantherEntity[],\n  label: UsedDatasourceLabels | UsedNodeLabels): FullPantherEntity[] => {\n  return nodes.filter(n => n.labels.includes(label))\n}\n\n/**\n * Finds the first edge in the provided array whose label strictly equals the given label.\n *\n * @param edges - Array of GraphEdge objects to search.\n * @param label - The UsedEdgeLabels value to match against each edge's `label` property.\n * @returns The first matching GraphEdge if found; otherwise `undefined`.\n *\n * @example\n * const edge = findEdgeByLabel(edges, 'dependency');\n * if (edge) {\n *   // handle found edge\n * }\n */\nexport const findEdgeByLabel = (\n  edges: GraphEdge[],\n  label: UsedEdgeLabels): GraphEdge | undefined => {\n  return edges.find(e => e.label === label)\n}\n\n/**\n * Filters a list of GraphEdge objects by a specific edge label.\n *\n * Returns a new array containing only those edges whose `label` property\n * strictly equals the provided `label` argument. The original `edges`\n * array is not mutated.\n *\n * @param edges - Array of GraphEdge objects to filter.\n * @param label - The label to match; comparison is performed using strict (`===`) equality.\n * @returns A new array of GraphEdge objects whose `label` matches the provided label. Returns an empty array if no edges match.\n *\n * @remarks\n * Time complexity: O(n), where n is the number of edges.\n *\n * @example\n * // const result = filterEdgeByLabel(edges, 'CONNECTS');\n */\nexport const filterEdgeByLabel = (\n  edges: GraphEdge[],\n  label: UsedEdgeLabels): GraphEdge[] => {\n  return edges.filter(e => e.label === label)\n}","/**\n * What types of graph nodes we use in metadata model\n */\nexport enum UsedNodeLabels {\n    Application = \"application\", // Application node (the root of the FE app)\n    Datasource = \"datasource\", // Datasource node for data including GIS information\n    Place = \"place\", // Place node for geographical information\n    Period = \"period\", // Period node for time information\n    AreaTree = \"areaTree\", // Area tree node for administrative division\n    AreaTreeLevel = \"areaTreeLevel\", // Area tree level node for administrative division\n    Layer = \"layer\", // Layer node for map layer (layer have a style and a datasource)\n    Style = \"style\", // Style node for map layer or a feature\n    Feature = \"feature\", // Feature node for map layer,\n    Attribute = \"attribute\" // Attribute node for properties of entities, like \"temperature\", \"population\", etc.\n}\n\n/**\n * What datasources we use in the system\n */\nexport enum UsedDatasourceLabels {\n    Attribute = \"attributeSource\",   // Column(s) with attribute values\n    Geojson = \"geojson\",      // Geojson for web map\n    WMS = \"wms\",              // WMS online source\n    COG = \"cloudOptimizedGeotiff\", // COG online source\n    MVT = \"mvt\",              // MVT (Mapbox Vector Tiles) source\n    XYZ = \"xyz\",              // XYZ tile source\n    CSV = \"csv\",              // CSV data source\n    GeoTIFF = \"geotiff\",      // GeoTIFF raster data\n    Shapefile = \"shapefile\",   // ESRI Shapefile format\n    PostGIS = \"postgis\",      // PostGIS database source\n    WMTS = \"wmts\",            // Web Map Tile Service\n    WFS = \"wfs\",              // Web Feature Service\n    GeoPackage = \"geopackage\", // OGC GeoPackage format\n    MapStyle = \"mapStyle\", // Map style datasource\n    Timeseries = \"timeseries\" // Timeseries datasource (with from-to and step)\n}\n\n/**\n * What types of edges we use in metadata model\n */\nexport enum UsedEdgeLabels {\n    RelatedTo = \"RELATED\", // Generic edge for any relation\n    Has = \"HAS\", // Edge for ownership relation\n    InPostgisLocation = \"IN_POSTGIS_LOCATION\" // Edge to connect datasource with PostGIS location (schema, table, geometry column)\n}\n\n/**\n * What time steps are used in timeseries data\n */\nexport enum UsedTimeseriesSteps{\n    Year = \"year\",\n    Quarter = \"quarter\",\n    Month = \"month\",\n    Week = \"week\",\n    Day = \"day\"\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.browser.js","sources":["../src/globals/coding/code.formating.ts","../src/node/api/errors.api.ts","../src/globals/coding/code.dates.ts","../src/globals/coding/formats.csv.ts","../src/globals/panther/utils.panther.ts","../src/globals/panther/enums.panther.ts"],"sourcesContent":["/**\n * Check, if the string is url\n * @param candidate Candidate input, to be checked\n * @returns Is this string url?\n */\nexport const isUrl = (candidate: string) => {\n  try {\n    new URL(candidate)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Check, if the string array contain urls\n * @param candidates Candidate input array, to be checked\n * @returns Is this string array only from url?\n */\nexport const isArrayOfUrls = (candidates: string[]) => candidates.every(candidate => isUrl(candidate))\n\n/**\n * Check if the value in included in enum posibilities.\n * @param value Value we need to check\n * @param enumEntity Enum type we check againts the value\n * @returns Is the value in this enum?\n */\nexport const isInEnum = (value: any, enumEntity: any) => {\n    const allEnumValues = Object.values(enumEntity) as string[]\n    return allEnumValues.includes(value)\n  }\n\n/**\n * Sort array of string elements\n * @param rawArray Raw unsorted array of elements\n * @returns Sorted string array\n */\nexport const sortStringArray = (rawArray: string[]) => rawArray.sort()\n\n/**\n * Remove all duplicity string items from an array\n * @param arr Original array with duplicities\n * @returns Array of original values\n */\nexport const removeDuplicitiesFromArray = (arr: any[]) => [...new Set(arr)]\n\n\n/**\n * Check if the string value is not ` \"\" `\n * @param value Value to check\n * @returns Boolean result about the truth\n */\nexport const notEmptyString = (value: string) => value !== \"\"\n\n\n/**\n * Return enum values as array of string\n * @param enumType Type of the enum from code\n * @param separator Optional - separator character\n * @returns Array of enum possible values\n */\nexport const enumValuesToString = (enumType: any, separator = \", \") => Object.values(enumType).join(separator)\n\n/**\n * Return enum values as array of string\n * @param enumTypes Combination of enum types\n * @param separator Optional - separator character\n * @returns Array of enum possible values\n */\nexport const enumCombineValuesToString = (enumTypes: any[], separator = \", \") => enumTypes.map(enumType => enumValuesToString(enumType, separator)).join(separator)\n\n/**\n * Return all enum values as array\n * @param enumType What array we want to work with\n * @returns Array of enum values\n */\nexport const enumValuesToArray = (enumType: any) => Object.values(enumType) as string[]\n\n/**\n * Return random number (integer) between two values\n * @param min \n * @param max \n * @returns \n */\nexport const randomNumberBetween = (min: number, max: number) => {\n  const minAr = Math.ceil(min)\n  const maxAr = Math.floor(max)\n  return Math.floor(Math.random()*(maxAr - minAr + 1) + min)\n}\n\n/**\n * Recursively flattens a nested object. The keys of the resulting object\n * will be the paths to the original values in the nested object, joined by dots.\n *\n * @param obj - The object to flatten.\n * @param prefix - The prefix to use for the keys in the flattened object. Defaults to an empty string.\n * @returns A new object with flattened keys.\n *\n * @example\n * ```typescript\n * const nestedObj = {\n *   a: {\n *     b: {\n *       c: 1\n *     }\n *   },\n *   d: 2\n * };\n * const flatObj = flattenObject(nestedObj);\n * console.log(flatObj);\n * // Output: { 'a.b.c': 1, 'a.b.d': 2 }\n * ```\n */\nexport const flattenObject = (obj: any, prefix = ''): Record<string, any> => {\n    return Object.keys(obj).reduce((acc: Record<string, any>, key: string) => {\n        const propName = prefix ? `${prefix}.${key}` : key\n        if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {\n            Object.assign(acc, flattenObject(obj[key], propName))\n        } else {\n            acc[propName] = obj[key]\n        }\n        return acc\n    }, {})\n}","/**\n * Extract message from exception error (try-catch)\n * @param error error from catch block as any\n * @returns \n */\n export const messageFromError = (error: any) => error[\"message\"] as string\n\n/**\n * We miss a API parameter needed to process action\n */\nexport class InvalidRequestError extends Error{\n  constructor(message: string){\n    super(`Invalid Request: ${message}`)\n  }\n}\n\n/**\n * Where client has general authorization issue\n */\nexport class AuthorizationError extends Error{\n  constructor(){\n    super(`Authorization has failed.`)\n  }\n}","import { DateTime } from \"luxon\"\nimport { InvalidRequestError } from \"../../node/api/errors.api\"\n\n/**\n * Return epoch timestamp\n * @param regime Set if you want milisecond format or second format\n * @returns \n */\nexport const nowTimestamp = (regime: \"milisecond\" | \"second\" = \"milisecond\"): number => {\n  const timestamp = DateTime.now().toMillis()\n  return regime === \"second\" ? Math.round((timestamp / 1000)) : timestamp\n}\n\n/**\n * Return now local timestamp plus number of seconds to add\n * @param secondsToAdd Seconds to add from now (1 = now + 1 sec.)\n * @returns Timestamp of the future (past) on seconds\n */\nexport const nowPlusTime = (secondsToAdd: number) => {\n  return Math.round(DateTime.now().plus({seconds: secondsToAdd}).toSeconds())\n}\n\n/**\n * Convert epoch time value into ISO format\n * @param epochValue Epoch value of the timestamp\n * @returns ISO format of the date\n */\nexport const epochToIsoFormat = (epochValue: number) => DateTime.fromMillis(epochValue).toISO() as string\n\n/**\n * Return epoch timestamp\n * @param regime Set if you want milisecond format or second format\n * @returns \n */\nexport const nowTimestampIso = () => {\n  const timestamp = DateTime.now().toISO()\n  return timestamp as string\n}\n\n/**\n * Check if input date is valid for ISO format\n * @param dateToCheck \n * @returns \n */\n export const hasIsoFormat = (dateToCheck: string) => {\n  try{\n    const toDate = new Date(Date.parse(dateToCheck))\n    const isoCheck = toDate.toISOString().includes(dateToCheck) \n    return isoCheck\n  }\n  catch{\n    return false\n  }\n}\n\n/**\n * Convert date in ISO formtat to milisecond timestamp\n * @param isoDate Date in ISO 8601 format\n * @returns Timestamp representing the date in miliseconds\n */\nexport const isoDateToTimestamp = (isoDate: string) => DateTime.fromISO(isoDate).toMillis()\n\n/**\n * Format ISO 8601 interval to from-to values\n * @param interval Defined inteval in ISO format (from/to) of the UTC\n * @returns Tuple - from timestamp and to timestamp\n */\nexport const isoIntervalToTimestamps = (interval: string): [number, number] => {\n\n  // Split the interval into two parts\n  const intervals = interval.split(\"/\")\n\n  // interval as a single year has just one part\n  if (intervals.length == 1) {\n    const newIso = `${interval}-01-01/${interval}-12-31`\n    return isoIntervalToTimestamps(newIso)\n  }\n\n  // interval with two parts or less than one\n  else if (intervals.length > 2 || intervals.length < 1)\n    throw new InvalidRequestError(\"Interval can have only two parameters\")\n\n  // valid interval with two parts\n  else {\n    if (!intervals.every(interval => hasIsoFormat(interval)))\n      throw new InvalidRequestError(\"Parameter utcIntervalIso is not ISO 8601 time interval (date01/date02) or year\");\n\n    const [int1, int2] = intervals.map(intervalIso => {\n      const cleared = intervalIso.replace(\" \", \"\")\n      return isoDateToTimestamp(cleared)\n    })\n\n    return [int1, int2]\n  }\n}\n","// TODO: Cover by tests\n// TODO: mode to ptr-be-core as general CSV methods\n\n\n/**\n * Parses a single line of CSV-formatted strings into an array of trimmed string values.\n *\n * @param csvStingsLine - A string representing a single line of comma-separated values.\n * @returns An array of strings, each representing a trimmed value from the CSV line.\n */\nexport const csvParseStrings = (csvStingsLine: string): string[] => {\n  return csvStingsLine.split(\",\").map((value: string) => value.trim());\n}\n\n/**\n * Parses a comma-separated string of numbers into an array of numbers.\n *\n * @param csvNumbersLine - A string containing numbers separated by commas (e.g., \"1, 2, 3.5\").\n * @returns An array of numbers parsed from the input string.\n */\nexport const csvParseNumbers = (csvNumbersLine: string): number[] => {\n  return csvNumbersLine.split(\",\").map((value: string) => parseFloat(value.trim()));\n}","import { UsedDatasourceLabels, UsedEdgeLabels, UsedNodeLabels } from \"./enums.panther\"\nimport { GraphEdge } from \"./models.edges\"\nimport { FullPantherEntity } from \"./models.nodes\"\n\n/**\n * Finds the first node in the provided list that contains the specified label.\n *\n * Searches the given array of FullPantherEntity objects and returns the first entity\n * whose `labels` array includes the provided label.\n *\n * @param nodes - Array of FullPantherEntity objects to search through.\n * @param label - Label to match; may be a UsedDatasourceLabels or UsedNodeLabels.\n * @returns The first FullPantherEntity whose `labels` includes `label`, or `undefined`\n *          if no such entity is found.\n *\n * @remarks\n * - The search stops at the first match (uses `Array.prototype.find`).\n * - Label comparison is exact (uses `Array.prototype.includes`), so it is case-sensitive\n *   and requires the same string instance/value.\n *\n * @example\n * const result = findNodeByLabel(nodes, 'datasource-main');\n * if (result) {\n *   // found a node that has the 'datasource-main' label\n * }\n */\nexport const findNodeByLabel = (\n  nodes: FullPantherEntity[],\n  label: UsedDatasourceLabels | UsedNodeLabels): FullPantherEntity | undefined => {\n  return nodes.find(n => n.labels.includes(label))\n}\n\n/**\n * Filters an array of FullPantherEntity objects, returning only those that contain the specified label.\n *\n * The function performs a shallow, non-mutating filter: it returns a new array and does not modify the input.\n * Matching is done using Array.prototype.includes on each entity's `labels` array (strict equality).\n *\n * @param nodes - The array of entities to filter.\n * @param label - The label to match; can be a UsedDatasourceLabels or UsedNodeLabels value.\n * @returns A new array containing only the entities whose `labels` array includes the provided label.\n *\n * @remarks\n * Time complexity is O(n * m) where n is the number of entities and m is the average number of labels per entity.\n *\n * @example\n * ```ts\n * const matched = filterNodeByLabel(entities, 'MY_LABEL');\n * ```\n */\nexport const filterNodeByLabel = (\n  nodes: FullPantherEntity[],\n  label: UsedDatasourceLabels | UsedNodeLabels): FullPantherEntity[] => {\n  return nodes.filter(n => n.labels.includes(label))\n}\n\n/**\n * Finds the first edge in the provided array whose label strictly equals the given label.\n *\n * @param edges - Array of GraphEdge objects to search.\n * @param label - The UsedEdgeLabels value to match against each edge's `label` property.\n * @returns The first matching GraphEdge if found; otherwise `undefined`.\n *\n * @example\n * const edge = findEdgeByLabel(edges, 'dependency');\n * if (edge) {\n *   // handle found edge\n * }\n */\nexport const findEdgeByLabel = (\n  edges: GraphEdge[],\n  label: UsedEdgeLabels): GraphEdge | undefined => {\n  return edges.find(e => e.label === label)\n}\n\n/**\n * Filters a list of GraphEdge objects by a specific edge label.\n *\n * Returns a new array containing only those edges whose `label` property\n * strictly equals the provided `label` argument. The original `edges`\n * array is not mutated.\n *\n * @param edges - Array of GraphEdge objects to filter.\n * @param label - The label to match; comparison is performed using strict (`===`) equality.\n * @returns A new array of GraphEdge objects whose `label` matches the provided label. Returns an empty array if no edges match.\n *\n * @remarks\n * Time complexity: O(n), where n is the number of edges.\n *\n * @example\n * // const result = filterEdgeByLabel(edges, 'CONNECTS');\n */\nexport const filterEdgeByLabel = (\n  edges: GraphEdge[],\n  label: UsedEdgeLabels): GraphEdge[] => {\n  return edges.filter(e => e.label === label)\n}","/**\n * What types of graph nodes we use in metadata model\n */\nexport enum UsedNodeLabels {\n    Application = \"application\", // Application node (the root of the FE app)\n    Datasource = \"datasource\", // Datasource node for data including GIS information\n    Place = \"place\", // Place node for geographical information\n    Period = \"period\", // Period node for time information\n    AreaTree = \"areaTree\", // Area tree node for administrative division\n    AreaTreeLevel = \"areaTreeLevel\", // Area tree level node for administrative division\n    Layer = \"layer\", // Layer node for map layer (layer have a style and a datasource)\n    Style = \"style\", // Style node for map layer or a feature\n    Feature = \"feature\", // Feature node for map layer,\n    Attribute = \"attribute\" // Attribute node for properties of entities, like \"temperature\", \"population\", etc.\n}\n\n/**\n * What datasources we use in the system\n */\nexport enum UsedDatasourceLabels {\n    Attribute = \"attributeSource\",   // Column(s) with attribute values\n    Geojson = \"geojson\",      // Geojson for web map\n    WMS = \"wms\",              // WMS online source\n    COG = \"cloudOptimizedGeotiff\", // COG online source\n    MVT = \"mvt\",              // MVT (Mapbox Vector Tiles) source\n    XYZ = \"xyz\",              // XYZ tile source\n    CSV = \"csv\",              // CSV data source\n    GeoTIFF = \"geotiff\",      // GeoTIFF raster data\n    Shapefile = \"shapefile\",   // ESRI Shapefile format\n    PostGIS = \"postgis\",      // PostGIS database source\n    WMTS = \"wmts\",            // Web Map Tile Service\n    WFS = \"wfs\",              // Web Feature Service\n    GeoPackage = \"geopackage\", // OGC GeoPackage format\n    MapStyle = \"mapStyle\", // Map style datasource\n    Timeseries = \"timeseries\" // Timeseries datasource (with from-to and step)\n}\n\n/**\n * What types of edges we use in metadata model\n */\nexport enum UsedEdgeLabels {\n    RelatedTo = \"RELATED\", // Generic edge for any relation\n    Has = \"HAS\", // Edge for ownership relation\n    InPostgisLocation = \"IN_POSTGIS_LOCATION\" // Edge to connect datasource with PostGIS location (schema, table, geometry column)\n}\n\n/**\n * What time steps are used in timeseries data\n */\nexport enum UsedTimeseriesSteps{\n    Year = \"year\",\n    Quarter = \"quarter\",\n    Month = \"month\",\n    Week = \"week\",\n    Day = \"day\"\n}"],"names":[],"mappings":"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"}

package/dist/index.node.cjs

@@ -2,10 +2,29 @@
 
 var luxon = require('luxon');
 var pino = require('pino');
-var pretty = require('pino-pretty');
 var crypto = require('crypto');
 var _ = require('lodash');
 
+/**
+ * Check, if the string is url
+ * @param candidate Candidate input, to be checked
+ * @returns Is this string url?
+ */
+const isUrl = (candidate) => {
+    try {
+        new URL(candidate);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * Check, if the string array contain urls
+ * @param candidates Candidate input array, to be checked
+ * @returns Is this string array only from url?
+ */
+const isArrayOfUrls = (candidates) => candidates.every(candidate => isUrl(candidate));
 /**
  * Check if the value in included in enum posibilities.
  * @param value Value we need to check
@@ -133,6 +152,14 @@ const nowTimestamp = (regime = "milisecond") => {
     const timestamp = luxon.DateTime.now().toMillis();
     return regime === "second" ? Math.round((timestamp / 1000)) : timestamp;
 };
+/**
+ * Return now local timestamp plus number of seconds to add
+ * @param secondsToAdd Seconds to add from now (1 = now + 1 sec.)
+ * @returns Timestamp of the future (past) on seconds
+ */
+const nowPlusTime = (secondsToAdd) => {
+    return Math.round(luxon.DateTime.now().plus({ seconds: secondsToAdd }).toSeconds());
+};
 /**
  * Convert epoch time value into ISO format
  * @param epochValue Epoch value of the timestamp
@@ -359,32 +386,117 @@ exports.UsedTimeseriesSteps = void 0;
     UsedTimeseriesSteps["Day"] = "day";
 })(exports.UsedTimeseriesSteps || (exports.UsedTimeseriesSteps = {}));
 
-// logger.ts
-const DEFAULT_LOG_OPTIONS = {
-    label: 'App'
-};
-// create the pretty‐printing stream once
-const prettyStream = pretty({
-    colorize: true,
-    levelFirst: true,
-    translateTime: 'yyyy-mm-dd HH:MM:ss'
-});
-// create your logger once and for all
-const baseLogger = pino({}, prettyStream);
-class AppLogger {
-    static info(message, options = DEFAULT_LOG_OPTIONS) {
-        baseLogger.info({ ...options, message });
-    }
-    static warn(message, options = DEFAULT_LOG_OPTIONS) {
-        baseLogger.warn({ ...options, message });
-    }
-    static error(message, options = DEFAULT_LOG_OPTIONS) {
-        baseLogger.error({ ...options, message });
-    }
-    static appStart(host, port, options = DEFAULT_LOG_OPTIONS) {
-        AppLogger.info(`Application started on ${host}:${port}`, options);
+/**
+ * Shared pino logger instance used by all logging functions.
+ *
+ * The logger uses ISO timestamps and a simple level formatter that exposes
+ * the textual level as the `level` property on emitted objects.
+ */
+const logger = pino({
+    timestamp: pino.stdTimeFunctions.isoTime,
+    formatters: {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        level(label, number) {
+            return { level: label };
+        }
     }
-}
+});
+/**
+ * Log an informational message.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {string} message - Human-readable log message.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyInfo = (label, message, options = {}) => {
+    logger.info({ ...options, label, message });
+};
+/**
+ * Log a debug-level message.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {string} message - Human-readable debug message.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyDebug = (label, message, options = {}) => {
+    logger.debug({ ...options, label, message });
+};
+/**
+ * Log a warning-level message.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {string} message - Human-readable warning message.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyWarn = (label, message, options = {}) => {
+    logger.warn({ ...options, label, message });
+};
+/**
+ * Log a trace-level message.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {string} message - Human-readable trace message.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyTrace = (label, message, options = {}) => {
+    logger.trace({ ...options, label, message });
+};
+/**
+ * Log a fatal message.
+ *
+ * Use for unrecoverable errors that will abort the process.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {string} message - Human-readable fatal message.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyFatal = (label, message, options = {}) => {
+    logger.fatal({ ...options, label, message });
+};
+/**
+ * Log an error. When an `Error` instance is provided, its stack is included
+ * in the logged metadata.
+ *
+ * @param {string} label - Short label or category for the log entry.
+ * @param {Error|string} err - The error object or an error message string.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyError = (label, err, options = {}) => {
+    const message = typeof err === 'string' ? err : err.message;
+    const extra = typeof err === 'string' ? options : { ...options, stack: err.stack };
+    logger.error({ ...extra, label, message });
+};
+/**
+ * Convenience logger for application start information.
+ *
+ * @param {string} host - Hostname or IP the app is bound to.
+ * @param {number} port - Port number the app is listening on.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include.
+ */
+const loggyAppStart = (host, port, options = {}) => {
+    loggyInfo("Application started", `Running on ${host}:${port}`, options);
+};
+/**
+ * Log that an HTTP request was received.
+ *
+ * @param {string} route - The route or URL path requested.
+ * @param {string} method - HTTP method (GET, POST, etc.).
+ * @param {Record<string, any>} [options={}] - Additional metadata to include (e.g., headers, id).
+ */
+const loggyRequestReceived = (route, method, options = {}) => {
+    loggyInfo("Request Received", `${method}: ${route}`, options);
+};
+/**
+ * Log that an HTTP response was sent.
+ *
+ * @param {string} route - The route or URL path the response corresponds to.
+ * @param {string} method - HTTP method (GET, POST, etc.).
+ * @param {number} status - HTTP status code returned.
+ * @param {Record<string, any>} [options={}] - Additional metadata to include (e.g., timings).
+ */
+const loggyResponseSent = (route, method, status, options = {}) => {
+    loggyInfo("Response Sent", `${status}: ${route}`, { ...options, method });
+};
 
 /**
  * Validates the provided labels to ensure they are an array of strings and that each label
@@ -903,7 +1015,6 @@ const parseEqualEdges = (body) => {
     return validatedGraphEdges;
 };
 
-exports.AppLogger = AppLogger;
 exports.AuthorizationError = AuthorizationError;
 exports.InvalidRequestError = InvalidRequestError;
 exports.csvParseNumbers = csvParseNumbers;
@@ -918,11 +1029,23 @@ exports.findEdgeByLabel = findEdgeByLabel;
 exports.findNodeByLabel = findNodeByLabel;
 exports.flattenObject = flattenObject;
 exports.hasIsoFormat = hasIsoFormat;
+exports.isArrayOfUrls = isArrayOfUrls;
 exports.isInEnum = isInEnum;
+exports.isUrl = isUrl;
 exports.isoDateToTimestamp = isoDateToTimestamp;
 exports.isoIntervalToTimestamps = isoIntervalToTimestamps;
+exports.loggyAppStart = loggyAppStart;
+exports.loggyDebug = loggyDebug;
+exports.loggyError = loggyError;
+exports.loggyFatal = loggyFatal;
+exports.loggyInfo = loggyInfo;
+exports.loggyRequestReceived = loggyRequestReceived;
+exports.loggyResponseSent = loggyResponseSent;
+exports.loggyTrace = loggyTrace;
+exports.loggyWarn = loggyWarn;
 exports.messageFromError = messageFromError;
 exports.notEmptyString = notEmptyString;
+exports.nowPlusTime = nowPlusTime;
 exports.nowTimestamp = nowTimestamp;
 exports.nowTimestampIso = nowTimestampIso;
 exports.parseArrowsJson = parseArrowsJson;